6ee40bd5aa
Daniel Stenberg
2026-09-24
Subject
CURLOPT_POSTFIELDSIZE.md: improve wording
Binary
No binary (build failed)
Architecture & Compiler Flags
—
Build Log
(log yok)
Commit Diff GitHub →
docs/libcurl/opts/CURLOPT_POSTFIELDSIZE.md +6 -4docs/libcurl/opts/CURLOPT_POSTFIELDSIZE_LARGE.md +6 -4
docs/libcurl/opts/CURLOPT_POSTFIELDSIZE.md+6 -4
| @@ -28,12 +28,14 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTFIELDSIZE, long size); | |
| # DESCRIPTION | |
| - | If you want to post static data to the server without having libcurl do a |
| - | strlen() to measure the data size, this option must be used. When this option |
| - | is used you can post fully binary data, which otherwise is likely to fail. If |
| - | this size is set to -1, libcurl uses strlen() to get the size or relies on the |
| + | Set the *size* of the data buffer to POST to prevent libcurl from doing a |
| + | strlen() to figure out the data size. When this option is used you can post |
| + | fully binary data, which otherwise is likely to fail. If this size is set to |
| + | -1, libcurl uses strlen() to get the size or relies on the |
| CURLOPT_READFUNCTION(3) (if used) to signal the end of data. | |
| + | You *must* make sure that the set size is not larger than the provided buffer. |
| + | |
| If you post more than 2GB, use CURLOPT_POSTFIELDSIZE_LARGE(3). | |
| # DEFAULT | |
docs/libcurl/opts/CURLOPT_POSTFIELDSIZE_LARGE.md+6 -4
| @@ -30,12 +30,14 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTFIELDSIZE_LARGE, | |
| # DESCRIPTION | |
| - | If you want to post static data to the server without having libcurl do a |
| - | strlen() to measure the data size, this option must be used. When this option |
| - | is used you can post fully binary data, which otherwise is likely to fail. If |
| - | this size is set to -1, libcurl uses strlen() to get the size or relies on the |
| + | Set the *size* of the data buffer to POST to prevent libcurl from doing a |
| + | strlen() to figure out the data size. When this option is used you can post |
| + | fully binary data, which otherwise is likely to fail. If this size is set to |
| + | -1, libcurl uses strlen() to get the size or relies on the |
| CURLOPT_READFUNCTION(3) (if used) to signal the end of data. | |
| + | You *must* make sure that the set size is not larger than the provided buffer. |
| + | |
| # DEFAULT | |
| -1 | |