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

curl_easy_setopt.3: CURLOPT_POSTFIELDS is the exception

... to the always-copy-char *-argument.

And fix some minor mistakes.
This commit is contained in:
Daniel Stenberg 2014-06-21 19:46:45 +02:00
parent ecacdb3430
commit ac5b6f8082

View File

@ -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; Strings passed to libcurl as 'char *' arguments, are copied by the library;
thus the string storage associated to the pointer argument may be overwritten thus the string storage associated to the pointer argument may be overwritten
after curl_easy_setopt() returns. Exceptions to this rule are described in after curl_easy_setopt() returns. The only exception to this rule is really
the option details below. \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 Before version 7.17.0, strings were not copied. Instead the user was forced
keep them available until libcurl no longer needed them. keep them available until libcurl no longer needed them.
@ -272,7 +274,7 @@ Do a HTTP GET request. See \fICURLOPT_HTTPGET(3)\fP
.IP CURLOPT_HTTP_VERSION .IP CURLOPT_HTTP_VERSION
HTTP version to use. \fICURLOPT_HTTP_VERSION(3)\fP HTTP version to use. \fICURLOPT_HTTP_VERSION(3)\fP
.IP CURLOPT_IGNORE_CONTENT_LENGTH .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 .IP CURLOPT_HTTP_CONTENT_DECODING
Disable Content decoding. See \fICURLOPT_HTTP_CONTENT_DECODING(3)\fP Disable Content decoding. See \fICURLOPT_HTTP_CONTENT_DECODING(3)\fP
.IP CURLOPT_HTTP_TRANSFER_DECODING .IP CURLOPT_HTTP_TRANSFER_DECODING
@ -333,8 +335,6 @@ RTSP session-id. See \fICURLOPT_RTSP_SESSION_ID(3)\fP
RTSP stream URI. See \fICURLOPT_RTSP_STREAM_URI(3)\fP RTSP stream URI. See \fICURLOPT_RTSP_STREAM_URI(3)\fP
.IP CURLOPT_RTSP_TRANSPORT .IP CURLOPT_RTSP_TRANSPORT
RTSP Transport: header. See \fICURLOPT_RTSP_TRANSPORT(3)\fP 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 .IP CURLOPT_RTSP_CLIENT_CSEQ
Clent CSEQ number. See \fICURLOPT_RTSP_CLIENT_CSEQ(3)\fP Clent CSEQ number. See \fICURLOPT_RTSP_CLIENT_CSEQ(3)\fP
.IP CURLOPT_RTSP_SERVER_CSEQ .IP CURLOPT_RTSP_SERVER_CSEQ