diff options
| author | Patrick Monnerat <patrick@monnerat.net> | 2017-09-22 01:08:29 +0100 | 
|---|---|---|
| committer | Patrick Monnerat <patrick@monnerat.net> | 2017-09-22 01:08:29 +0100 | 
| commit | ee56fdb6910f6bf215eecede9e2e9bfc83cb5f29 (patch) | |
| tree | bfdbf1f3f2f5cd9f051f6b8d0b2469c51b2660ef /docs/libcurl/curl_mime_name.3 | |
| parent | fa9482ab0907dfacd0fb619add2dbf41de2d8c9c (diff) | |
form/mime: field names are not allowed to contain zero-valued bytes.
Also suppress length argument of curl_mime_name() (names are always
zero-terminated).
Diffstat (limited to 'docs/libcurl/curl_mime_name.3')
| -rw-r--r-- | docs/libcurl/curl_mime_name.3 | 17 | 
1 files changed, 6 insertions, 11 deletions
| diff --git a/docs/libcurl/curl_mime_name.3 b/docs/libcurl/curl_mime_name.3 index 369598012..f821d9082 100644 --- a/docs/libcurl/curl_mime_name.3 +++ b/docs/libcurl/curl_mime_name.3 @@ -25,21 +25,16 @@ curl_mime_name - set a mime part's name  .SH SYNOPSIS  .B #include <curl/curl.h>  .sp -.BI "CURLcode curl_mime_name(curl_mimepart * " part ", const char * " name -.BI ", size_t " namesize ");" +.BI "CURLcode curl_mime_name(curl_mimepart * " part ", const char * " name ");"  .ad  .SH DESCRIPTION  \fIcurl_mime_name(3)\fP sets a mime part's name. This is the way HTTP form  fields are named. -\fIname\fP points to the name byte string; the string may contain nul bytes -unless \fInamesize\fP is -1. - -\fInamesize\fP is the name length: it can be set to \fICURL_ZERO_TERMINATED\fP -to indicate \fIname\fP is a nul-terminated string. -  \fIpart\fP is the part's handle to assign a name to. +\fIname\fP points to the zero-terminated name string. +  The name string is copied into the part, thus the associated storage may  safely be released or reused after call. Setting a part's name twice is valid:  only the value set by the last call is retained. It is possible to "unname" a @@ -60,9 +55,9 @@ CURLE_OK or a CURL error code upon failure.   part = curl_mime_addpart(mime);   /* give the part a name */ - curl_mime_name(part, "shoe_size", CURL_ZERO_TERMINATED); + curl_mime_name(part, "shoe_size");  .fi  .SH "SEE ALSO" -.BR curl_mime_addpart "(3)" -.BR curl_mime_data "(3)" +.BR curl_mime_addpart "(3)," +.BR curl_mime_data "(3),"  .BR curl_mime_type "(3)" | 
