Skip to content

Commit

Permalink
curl_easy_setopt.3: CURLOPT_POSTFIELDS is the exception
Browse files Browse the repository at this point in the history
... to the always-copy-char *-argument.

And fix some minor mistakes.
  • Loading branch information
bagder committed Jun 21, 2014
1 parent ecacdb3 commit ac5b6f8
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions docs/libcurl/curl_easy_setopt.3
Expand Up @@ -45,8 +45,10 @@ options back to internal default with \fIcurl_easy_reset(3)\fP.

Strings passed to libcurl as 'char *' arguments, are copied by the library;
thus the string storage associated to the pointer argument may be overwritten
after curl_easy_setopt() returns. Exceptions to this rule are described in
the option details below.
after curl_easy_setopt() returns. The only exception to this rule is really
\fICURLOPT_POSTFIELDS\fP, but the alternative that copies the string
\fICURLOPT_COPYPOSTFIELDS\fP has some usage characteristics you need to read
up on.

Before version 7.17.0, strings were not copied. Instead the user was forced
keep them available until libcurl no longer needed them.
Expand Down Expand Up @@ -272,7 +274,7 @@ Do a HTTP GET request. See \fICURLOPT_HTTPGET(3)\fP
.IP CURLOPT_HTTP_VERSION
HTTP version to use. \fICURLOPT_HTTP_VERSION(3)\fP
.IP CURLOPT_IGNORE_CONTENT_LENGTH
Ignore Content-Length. See \fIURLOPT_IGNORE_CONTENT_LENGTH(3)\fP
Ignore Content-Length. See \fICURLOPT_IGNORE_CONTENT_LENGTH(3)\fP
.IP CURLOPT_HTTP_CONTENT_DECODING
Disable Content decoding. See \fICURLOPT_HTTP_CONTENT_DECODING(3)\fP
.IP CURLOPT_HTTP_TRANSFER_DECODING
Expand Down Expand Up @@ -333,8 +335,6 @@ RTSP session-id. See \fICURLOPT_RTSP_SESSION_ID(3)\fP
RTSP stream URI. See \fICURLOPT_RTSP_STREAM_URI(3)\fP
.IP CURLOPT_RTSP_TRANSPORT
RTSP Transport: header. See \fICURLOPT_RTSP_TRANSPORT(3)\fP
.IP CURLOPT_RTSP_HEADER
RTSP custom headers. See \fICURLOPT_RTSP_HEADER(3)\fP
.IP CURLOPT_RTSP_CLIENT_CSEQ
Clent CSEQ number. See \fICURLOPT_RTSP_CLIENT_CSEQ(3)\fP
.IP CURLOPT_RTSP_SERVER_CSEQ
Expand Down

0 comments on commit ac5b6f8

Please sign in to comment.