1
0
mirror of https://github.com/moparisthebest/curl synced 2024-08-13 17:03:50 -04:00

RFC1867 was updated by RFC2388

This commit is contained in:
Daniel Stenberg 2009-08-04 12:02:27 +00:00
parent 35eb9fc6ad
commit 37d509f04f
4 changed files with 11 additions and 10 deletions

View File

@ -480,7 +480,7 @@ waits for a reply from the server.
.IP "-F/--form <name=content>" .IP "-F/--form <name=content>"
(HTTP) This lets curl emulate a filled-in form in which a user has pressed the (HTTP) This lets curl emulate a filled-in form in which a user has pressed the
submit button. This causes curl to POST data using the Content-Type submit button. This causes curl to POST data using the Content-Type
multipart/form-data according to RFC1867. This enables uploading of binary multipart/form-data according to RFC2388. This enables uploading of binary
files etc. To force the 'content' part to be a file, prefix the file name files etc. To force the 'content' part to be a file, prefix the file name
with an @ sign. To just get the content part from a file, prefix the file name with an @ sign. To just get the content part from a file, prefix the file name
with the symbol <. The difference between @ and < is then that @ makes a file with the symbol <. The difference between @ and < is then that @ makes a file

View File

@ -870,7 +870,7 @@ data using the read callback!
Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header. Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header.
You can disable this header with \fICURLOPT_HTTPHEADER\fP as usual. You can disable this header with \fICURLOPT_HTTPHEADER\fP as usual.
To make multipart/formdata posts (aka rfc1867-posts), check out the To make multipart/formdata posts (aka RFC2388-posts), check out the
\fICURLOPT_HTTPPOST\fP option. \fICURLOPT_HTTPPOST\fP option.
.IP CURLOPT_POSTFIELDSIZE .IP CURLOPT_POSTFIELDSIZE
If you want to post data to the server without letting libcurl do a strlen() If you want to post data to the server without letting libcurl do a strlen()

View File

@ -13,7 +13,7 @@ curl_formadd - add a section to a multipart/formdata HTTP POST
.ad .ad
.SH DESCRIPTION .SH DESCRIPTION
curl_formadd() is used to append sections when building a multipart/formdata curl_formadd() is used to append sections when building a multipart/formdata
HTTP POST (sometimes referred to as rfc1867-style posts). Append one section at HTTP POST (sometimes referred to as RFC2388-style posts). Append one section at
a time until you've added all the sections you want included and then you pass a time until you've added all the sections you want included and then you pass
the \fIfirstitem\fP pointer as parameter to \fBCURLOPT_HTTPPOST\fP. the \fIfirstitem\fP pointer as parameter to \fBCURLOPT_HTTPPOST\fP.
\fIlastitem\fP is set after each call and on repeated invokes it should be \fIlastitem\fP is set after each call and on repeated invokes it should be

View File

@ -502,13 +502,14 @@ then passing that list to libcurl.
While the simple examples above cover the majority of all cases where HTTP While the simple examples above cover the majority of all cases where HTTP
POST operations are required, they don't do multi-part formposts. Multi-part POST operations are required, they don't do multi-part formposts. Multi-part
formposts were introduced as a better way to post (possibly large) binary data formposts were introduced as a better way to post (possibly large) binary data
and were first documented in the RFC1867. They're called multi-part because and were first documented in the RFC1867 (updated in RFC2388). They're called
they're built by a chain of parts, each being a single unit. Each part has its multi-part because they're built by a chain of parts, each part being a single
own name and contents. You can in fact create and post a multi-part formpost unit of data. Each part has its own name and contents. You can in fact create
with the regular libcurl POST support described above, but that would require and post a multi-part formpost with the regular libcurl POST support described
that you build a formpost yourself and provide to libcurl. To make that above, but that would require that you build a formpost yourself and provide
easier, libcurl provides \fIcurl_formadd(3)\fP. Using this function, you add to libcurl. To make that easier, libcurl provides \fIcurl_formadd(3)\fP. Using
parts to the form. When you're done adding parts, you post the whole form. this function, you add parts to the form. When you're done adding parts, you
post the whole form.
The following example sets two simple text parts with plain textual contents, The following example sets two simple text parts with plain textual contents,
and then a file with binary contents and uploads the whole thing. and then a file with binary contents and uploads the whole thing.