aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_easy_setopt.3
AgeCommit message (Collapse)Author
2014-12-04libcurl: add UNIX domain sockets supportPeter Wu
The ability to do HTTP requests over a UNIX domain socket has been requested before, in Apr 2008 [0][1] and Sep 2010 [2]. While a discussion happened, no patch seems to get through. I decided to give it a go since I need to test a nginx HTTP server which listens on a UNIX domain socket. One patch [3] seems to make it possible to use the CURLOPT_OPENSOCKETFUNCTION function to gain a UNIX domain socket. Another person wrote a Go program which can do HTTP over a UNIX socket for Docker[4] which uses a special URL scheme (though the name contains cURL, it has no relation to the cURL library). This patch considers support for UNIX domain sockets at the same level as HTTP proxies / IPv6, it acts as an intermediate socket provider and not as a separate protocol. Since this feature affects network operations, a new feature flag was added ("unix-sockets") with a corresponding CURL_VERSION_UNIX_SOCKETS macro. A new CURLOPT_UNIX_SOCKET_PATH option is added and documented. This option enables UNIX domain sockets support for all requests on the handle (replacing IP sockets and skipping proxies). A new configure option (--enable-unix-sockets) and CMake option (ENABLE_UNIX_SOCKETS) can disable this optional feature. Note that I deliberately did not mark this feature as advanced, this is a feature/component that should easily be available. [0]: http://curl.haxx.se/mail/lib-2008-04/0279.html [1]: http://daniel.haxx.se/blog/2008/04/14/http-over-unix-domain-sockets/ [2]: http://sourceforge.net/p/curl/feature-requests/53/ [3]: http://curl.haxx.se/mail/lib-2008-04/0361.html [4]: https://github.com/Soulou/curl-unix-socket Signed-off-by: Peter Wu <peter@lekensteyn.nl>
2014-11-25curl*3: added small examplesDaniel Stenberg
and some minor edits
2014-11-06curl_easy_setopt.3: add CURLOPT_PINNEDPUBLICKEYDaniel Stenberg
Reported-by: Christian Hägele Bug: http://curl.haxx.se/mail/lib-2014-11/0078.html
2014-11-02CURLOPT_MAXCONNECTS.3: Reworked the description to be less confusingSteve Holme
...and corrected a related typo in curl_easy_setopt.3.
2014-10-30curl_easy_setopt.3: Fixed lots of typosSteve Holme
2014-10-30curl_easy_setopt.3: Moved CURLOPT_DIRLISTONLY into PROTOCOL OPTIONSSteve Holme
...as this option affects more that just FTP.
2014-10-21docs: edited lots of libcurl docs for clarityDaniel Stenberg
2014-06-25curl_easy_setopt.3: fixed the error code for an unsupported optionDan Fandrich
2014-06-21curl_easy_setopt.3: fixed some typosDan Fandrich
2014-06-21lib man pages: update easy setopt option referencesDaniel Stenberg
... by using the "\fIopt(3)\fP" syntax they will be linked properly when the web version of the page is generated.
2014-06-21curl_easy_setopt.3: CURLOPT_POSTFIELDS is the exceptionDaniel Stenberg
... to the always-copy-char *-argument. And fix some minor mistakes.
2014-06-21curl_easy_setopt.3: refer to the individual man pagesDaniel Stenberg
With all the new individual option man pages created, this now refers to each separate one instead of duplicaing the info. Also makes this page easier to overview.
2014-06-21curl_easy_setopt.3: shortenDaniel Stenberg
shorten descriptions, mostly refer to the separate descriptions
2014-05-16curl_easy_setopt.3: prefer XFERINFOFUNCTION to PROGRESSFUNCTIONDaniel Stenberg
2014-05-05curl_easy_setopt.3: added the proto for CURLOPT_SSH_KNOWNHOSTSDaniel Stenberg
2014-04-18curl_easy_setopt: Updated CURLOPT_URL to include IMAP PARTIAL FETCH exampleSteve Holme
2014-04-18curl_easy_setopt: Updated CURLOPT_URL to include IMAP query string examplesSteve Holme
2014-04-04curl_easy_setopt: fix wrong version number referencesDaniel Stenberg
2014-04-04PROXYHEADER: send these headers in "normal" proxy requests tooDaniel Stenberg
Updated the docs to clarify and the code accordingly, with test 1528 to verify: When CURLHEADER_SEPARATE is set and libcurl is asked to send a request to a proxy but it isn't CONNECT, then _both_ header lists (CURLOPT_HTTPHEADER and CURLOPT_PROXYHEADER) will be used since the single request is then made for both the proxy and the server.
2014-04-04CURLOPT_HEADEROPT: addedDaniel Stenberg
Modified the logic so that CURLOPT_HEADEROPT now controls if PROXYHEADER is actually used or not.
2014-04-04CURLOPT_PROXYHEADER: set headers for proxy-onlyDaniel Stenberg
Includes docs and new test cases: 1525, 1526 and 1527 Co-written-by: Vijay Panghal
2014-02-16curl_easy_setopt.3: Add another non-matching hostnameColin Hogben
For the avoidance of doubt, show a domain which contains the no-proxy pattern but not at the top level.
2014-02-16url_easy_setopt.3: Add undocumented values of curl_infotypeYehezkel Horowitz
... for debug function
2014-02-14curl_easy_setopt.3: Fix word order of CURLOPT_PROXY sectionColin Hogben
The word CURLOPT_PROXYPORT became detached from its sentence when the note about the default was added.
2014-02-13transfer: make Expect: 100-continue timeout configurable.Tiit Pikma
Replaced the #define CURL_TIMEOUT_EXPECT_100 in transfer.c with the CURLOPT_EXPECT_100_TIMEOUT_MS option to make the timeout configurable.
2014-02-11curl_easy_setopt.3: add CURL_HTTP_VERSION_2_0Fabian Frank
2014-02-11curl_easy_setopt.3: add CURLOPT_SSL_ENABLE_ALPN/NPNDaniel Stenberg
2014-01-23curl_easy_setopt.3: remove what auth types that work for CURLOPT_PROXYAUTHDaniel Stenberg
The list was out of date and the paragraph already refers to the CURLOPT_HTTPAUTH explanation. All the auth bits are explained properly there. It also removes the ambiguity for what the "added" phrase refers to. This change based on pull request #85 on github URL: https://github.com/bagder/curl/pull/85 Reported-by: gnawhleinad
2014-01-14curl_easy_setopt.3: mention how to unset CURLOPT_INFILESIZE*Daniel Stenberg
2014-01-02Updated copyright year for recent changesSteve Holme
2014-01-03curl_easy_setopt.3: fix formatting mistakesChristian Weisgerber
This fixes two markup typos I noticed in curl_easy_setopt.3. (The use of bold vs. italics seems a bit inconsistent in that page, but it should at least be valid man syntax.)
2013-12-29curl_easy_setopt.3: Added SMTP information to CURLOPT_INFILESIZE_LARGESteve Holme
Although added to CURLOPT_INFILESIZE in commit ee3d3adc6fe155 it was never added to CURLOPT_INFILESIZE_LARGE.
2013-12-22docs: mention CURLOPT_MAX_RECV/SEND_SPEED_LARGE don't work for FILE://Daniel Stenberg
2013-12-19curl_easy_setopt: Fixed OAuth 2.0 Bearer option nameSteve Holme
Bug: http://curl.haxx.se/bug/view.cgi?id=1313 Reported-by: Viktor Szakáts
2013-12-14curl_easy_setopt: clarify some USERPWD and PROXYUSERPWD detailsDaniel Stenberg
2013-12-14login options: remove the ;[options] support from CURLOPT_USERPWDDaniel Stenberg
To avoid the regression when users pass in passwords containing semi- colons, we now drop the ability to set the login options with the same options. Support for login options in CURLOPT_USERPWD was added in 7.31.0. Test case 83 was modified to verify that colons and semi-colons can be used as part of the password when using -u (CURLOPT_USERPWD). Bug: http://curl.haxx.se/bug/view.cgi?id=1311 Reported-by: Petr Bahula Assisted-by: Steve Holme Signed-off-by: Daniel Stenberg <daniel@haxx.se>
2013-11-17smtp: Changed the default command to HELP when no options are specifiedSteve Holme
Otherwise a NOOP operation would be performed which a) only returns a single line response and not a multiline response where -I needs to be used, and b) provides an inconsistent user experience compared to that of the POP3 and IMAP protocols.
2013-11-15DOCS: Updated curl_easy_setopt.3 following recent SMTP changesSteve Holme
* Added information about the verify and expand commands to CURLOPT_MAIL_RCPT. * Reworked CURLOPT_CUSTOMREQUEST section, adding information about IMAP and SMTP custom commands.
2013-11-12darwinssl: PKCS#12 import feature now requires Lion or laterNick Zitzmann
It turns out that some of the constants necessary to make this feature work are missing from Snow Leopard's Security framework even though they are defined in the headers. Bug: http://curl.haxx.se/mail/lib-2013-11/0076.html Reported by: myriachan
2013-11-12curl_easy_setopt: Added the ability to set the login options separatelySteve Holme
Rather than set the authentication options as part of the login details specified in the URL, or via the older CURLOPT_USERPWD option, added a new libcurl option to allow the login options to be set separately.
2013-11-12curl_easy_setopt.3: clarify CURLOPT_SSL_VERIFYHOST documentationTomas Hoger
- better describe what happens when 1 is specified as parameter - clarify what "is ignored" means for NSS builds
2013-10-30NSS: support for CERTINFO featurePatrick Monnerat
2013-10-23CURLOPT_RESOLVE: mention they don't time-outDaniel Stenberg
Clarify in the documentation that DNS entries added with CURLOPT_RESOLVE won't time-out. Bug: http://curl.haxx.se/mail/lib-2013-10/0062.html Reported-by: Romulo Ceccon
2013-10-16DOCS: Added libcurl version number to CURLOPT_SSLVERSIONSteve Holme
2013-10-15SSL: protocol version can be specified more preciselyGergely Nagy
CURL_SSLVERSION_TLSv1_0, CURL_SSLVERSION_TLSv1_1, CURL_SSLVERSION_TLSv1_2 enum values are added to force exact TLS version (CURL_SSLVERSION_TLSv1 means TLS 1.x). axTLS: axTLS only supports TLS 1.0 and 1.1 but it cannot be set that only one of these should be used, so we don't allow the new enum values. darwinssl: Added support for the new enum values. SChannel: Added support for the new enum values. CyaSSL: Added support for the new enum values. Bug: The original CURL_SSLVERSION_TLSv1 value enables only TLS 1.0 (it did the same before this commit), because CyaSSL cannot be configured to use TLS 1.0-1.2. GSKit: GSKit doesn't seem to support TLS 1.1 and TLS 1.2, so we do not allow those values. Bugfix: There was a typo that caused wrong SSL versions to be passed to GSKit. NSS: TLS minor version cannot be set, so we don't allow the new enum values. QsoSSL: TLS minor version cannot be set, so we don't allow the new enum values. OpenSSL: Added support for the new enum values. Bugfix: The original CURL_SSLVERSION_TLSv1 value enabled only TLS 1.0, now it enables 1.0-1.2. Command-line tool: Added command line options for the new values.
2013-09-30curl_easy_setopt.3: slight clarification of SEEKFUNCTIONDaniel Stenberg
2013-09-20curl_easy_setopt.3: clarify that TIMEOUT and TIMEOUT_MS set the same valueDaniel Stenberg
2013-09-20pop3: Added basic SASL XOAUTH2 supportSteve Holme
Added the ability to use an XOAUTH2 bearer token [RFC6750] with POP3 for authentication using RFC6749 "OAuth 2.0 Authorization Framework". The bearer token is expected to be valid for the user specified in conn->user. If CURLOPT_XOAUTH2_BEARER is defined and the connection has an advertised auth mechanism of "XOAUTH2", the user and access token are formatted as a base64 encoded string and sent to the server as "AUTH XOAUTH2 <bearer token>".
2013-09-13curl_easy_setopt.3: mention RTMP URL quirksDaniel Stenberg
URL: http://curl.haxx.se/bug/view.cgi?id=1278 Reported-by: Gorilla Maguila
2013-09-12libcurl: New options to bind DNS to local interfaces or IP addressesKim Vandry