romenskiy2012/curl
1
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2026-04-14 22:01:41 +03:00
Code Issues Projects Releases Packages Wiki Activity

docs: mention the as-is concept generically

Browse source 
for curl command line options and for curl_easy_setopt

Closes #17829
This commit is contained in:
Daniel Stenberg 2025-07-06 12:33:51 +02:00
parent a47695db33
commit 897633eb21
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
2 changed files with 21 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

3
docs/cmdline-opts/_OPTIONS.md
View file

@ -28,6 +28,9 @@ The first argument that is exactly two dashes (`--`), marks the end of
options; any argument after the end of options is interpreted as a URL
argument even if it starts with a dash.
curl does little to no verification of the contents of command line arguments.
Passing in "creative octets" like newlines might trigger unexpected results.
The following options are global: `%GLOBALS`.
# ALL OPTIONS

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