From: Daniel Stenberg <daniel@haxx.se>
Date: Fri, 29 Aug 2014 06:10:38 +0000 (+0200)
Subject: curl_formadd.3: setting CURLFORM_CONTENTSLENGTH 0 zero means strlen
X-Git-Tag: curl-7_38_0~40
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=367b78473897b6eb72593cd55191077951a69487;p=thirdparty%2Fcurl.git

curl_formadd.3: setting CURLFORM_CONTENTSLENGTH 0 zero means strlen
---

diff --git a/docs/libcurl/curl_formadd.3 b/docs/libcurl/curl_formadd.3
index b27e61ddf5..3e48149ef3 100644
--- a/docs/libcurl/curl_formadd.3
+++ b/docs/libcurl/curl_formadd.3
@@ -86,6 +86,10 @@ you must set its length  with \fBCURLFORM_CONTENTSLENGTH\fP.
 .IP CURLFORM_CONTENTSLENGTH
 followed by a long giving the length of the contents. Note that for
 \fICURLFORM_STREAM\fP contents, this option is mandatory.
+
+If you pass a 0 (zero) for this option, libcurl will instead do a strlen() on
+the contents to figure out the size. If you really want to send a zero byte
+content then you must make sure strlen() on the data pointer returns zero.
 .IP CURLFORM_FILECONTENT
 followed by a filename, causes that file to be read and its contents used
 as data in this part. This part does \fInot\fP automatically become a file