romenskiy2012/curl
1
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2026-07-29 04:33:06 +03:00
Code Issues Projects Releases Packages Wiki Activity

curl_easy_setopt.md: mention it here as well

Browse source
This commit is contained in:
Daniel Stenberg 2025-07-08 10:12:53 +02:00
parent 0dc2d829a0
commit 22187a0471
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
1 changed files with 18 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

28
docs/libcurl/curl_easy_setopt.md
View file

@ -41,28 +41,36 @@ manual carefully as bad input values may cause libcurl to behave badly. You
can only set one option in each function call. A typical application uses many
curl_easy_setopt(3) calls in the setup phase.
Options set with this function call are valid for all forthcoming transfers
performed using this *handle*. The options are not in any way reset between
transfers, so if you want subsequent transfers with different options, you
must change them between the transfers. You can optionally reset all options
back to internal default with curl_easy_reset(3).
The *handle* argument is the return code from a curl_easy_init(3) or
curl_easy_duphandle(3) call.
Options set with this function call are sticky. They remain set for all
forthcoming transfers performed using this *handle*. The options are not in
any way reset between transfers, so if you want subsequent transfers with
different options, you must change them between the transfers. You can
optionally reset all options back to internal default with curl_easy_reset(3).
The order in which the options are set does not matter.
# STRINGS
Strings passed to libcurl as 'char *' arguments, are copied by the library;
the string storage associated to the pointer argument may be discarded or
reused after curl_easy_setopt(3) returns. The only exception to this rule is
really CURLOPT_POSTFIELDS(3), but the alternative that copies the string
CURLOPT_COPYPOSTFIELDS(3) has some usage characteristics you need to read up
on. This function does not accept input strings longer than
on.
This function does not accept input strings longer than
**CURL_MAX_INPUT_LENGTH** (8 MB).
The order in which the options are set does not matter.
libcurl does little to no verification of the contents of provided strings.
Passing in "creative octets" like newlines where they are not expected might
trigger unexpected results.
Before version 7.17.0, strings were not copied. Instead the user was forced
keep them available until libcurl no longer needed them.
The *handle* is the return code from a curl_easy_init(3) or
curl_easy_duphandle(3) call.
# OPTIONS
## CURLOPT_ABSTRACT_UNIX_SOCKET