docs: mention max-filesize options also apply to MQTT transfers

Also make it clearer that the caveat 'if the file size is unknown it
the option will have no effect' may apply to protocols other than FTP
and HTTP.

Reported-by: Josh Soref

Fixes https://github.com/curl/curl/issues/7453
This commit is contained in:
Jay Satiro 2021-07-21 01:00:44 -04:00
Родитель 9bd629bfad
Коммит ecf0225461
3 изменённых файлов: 11 добавлений и 11 удалений

Просмотреть файл

@ -12,6 +12,6 @@ A size modifier may be used. For example, Appending 'k' or 'K' will count the
number as kilobytes, 'm' or 'M' makes it megabytes, while 'g' or 'G' makes it
gigabytes. Examples: 200K, 3m and 1G. (Added in 7.58.0)
**NOTE**: The file size is not always known prior to download, and for such
files this option has no effect even if the file transfer ends up being larger
than this given limit. This concerns both FTP and HTTP transfers.
**NOTE**: For protocols where the size is not known in advance (including FTP
and HTTP) this option has no effect even if the file transfer ends up being
larger than the given limit.

Просмотреть файл

@ -33,15 +33,15 @@ Pass a long as parameter. This allows you to specify the maximum \fIsize\fP
this value, the transfer will not start and \fICURLE_FILESIZE_EXCEEDED\fP will
be returned.
The file size is not always known prior to download, and for such files this
option has no effect even if the file transfer ends up being larger than this
given limit. This concerns both FTP and HTTP transfers.
For protocols where the size is not known in advance (including FTP and HTTP)
this option has no effect even if the file transfer ends up being larger than
the given limit.
If you want a limit above 2GB, use \fICURLOPT_MAXFILESIZE_LARGE(3)\fP.
.SH DEFAULT
None
.SH PROTOCOLS
FTP and HTTP
FTP, HTTP and MQTT
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();

Просмотреть файл

@ -35,13 +35,13 @@ Pass a curl_off_t as parameter. This allows you to specify the maximum
larger than this value, the transfer will not start and
\fICURLE_FILESIZE_EXCEEDED\fP will be returned.
The file size is not always known prior to download, and for such files this
option has no effect even if the file transfer ends up being larger than this
given limit. This concerns both FTP and HTTP transfers.
For protocols where the size is not known in advance (including FTP and HTTP)
this option has no effect even if the file transfer ends up being larger than
the given limit.
.SH DEFAULT
None
.SH PROTOCOLS
FTP and HTTP
FTP, HTTP and MQTT
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();