From ee56fdb6910f6bf215eecede9e2e9bfc83cb5f29 Mon Sep 17 00:00:00 2001 From: Patrick Monnerat Date: Fri, 22 Sep 2017 01:08:29 +0100 Subject: 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). --- docs/libcurl/curl_mime_name.3 | 17 ++++++----------- 1 file changed, 6 insertions(+), 11 deletions(-) (limited to 'docs/libcurl/curl_mime_name.3') 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 .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)" -- cgit v1.2.3