aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_easy_setopt.3
AgeCommit message (Collapse)Author
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
2013-09-05darwinssl: add support for PKCS#12 files for client authenticationNick Zitzmann
I also documented the fact that the OpenSSL engine also supports them.
2013-08-30docs: Added documentation for CURLOPT_BEARERKyle L. Huff
2013-08-02Revert "DOCS: Added IMAP URL example for listing new messages"Steve Holme
This reverts commit 82ab5f1b0c7c3f as this was the wrong place to document the complexity of IMAP URLs and Custom Requests.
2013-08-02DOCS: Added IMAP URL example for listing new messagesSteve Holme
In addition to listing the folder contents, in the URL examples, added an example to list the new messages waiting in the user's inbox.
2013-07-18CURLOPT_XFERINFOFUNCTION: introducing a new progress callbackDaniel Stenberg
CURLOPT_XFERINFOFUNCTION is now the preferred progress callback function and CURLOPT_PROGRESSFUNCTION is considered deprecated. This new callback uses pure 'curl_off_t' arguments to pass on full resolution sizes. It otherwise retains the same characteristics: the same call rate, the same meanings for the arguments and the return code is used the same way. The progressfunc.c example is updated to show how to use the new callback for newer libcurls while supporting the older one if built with an older libcurl or even built with a newer libcurl while running with an older.
2013-06-14curl_easy_setopt.3: clarify CURLOPT_PROGRESSFUNCTION frequencyDaniel Stenberg
Make it clearer that the CURLOPT_PROGRESSFUNCTION callback will be called more frequently than once per second when things are happening.
2013-06-08curl_easy_setopt.3: HTTP header with no contentPeter Gal
Update the documentation on how to specify a HTTP header with no content.
2013-05-20curl_easy_setopt.3: expand the PROGRESSFUNCTION sectionDaniel Stenberg
Explain the callback and its arguments better and with more descriptive text.
2013-04-28DOCS: Corrected line length of recent Secure Transport changesSteve Holme
2013-04-27darwinssl: add TLS crypto authenticationNick Zitzmann
Users using the Secure Transport (darwinssl) back-end can now use a certificate and private key to authenticate with a site using TLS. Because Apple's security system is based around the keychain and does not have any non-public function to create a SecIdentityRef data structure from data loaded outside of the Keychain, the certificate and private key have to be loaded into the Keychain first (using the certtool command line tool or the Security framework's C API) before we can find it and use it.
2013-04-27Corrected version numbers after bumpSteve Holme
2013-04-27DOCS: Updated following the addition of CURLOPT_SASL_IRSteve Holme
Documented the the option in curl_easy_setopt() and added it to symbols-in-versions.
2013-04-25DOCS: Minor rewording / clarification of host name protocol detectionSteve Holme
2013-04-24DOCS: Added reference to IETF draft for SMTP URL InterfaceSteve Holme
...when mentioning login options. Additional minor clarification of "Windows builds" to be "Windows builds with SSPI"as a way of enabling NTLM as Windows builds may be built with OpenSSL to enable NTLM or without NTLM support altogether.
2013-04-23DOCS: Reworked the scheme calculation explanation under CURLOPT_URLSteve Holme
2013-04-22DOCS: Added information about login options to CURLOPT_USERPWDSteve Holme
2013-04-22DOCS: Added information about login options in the URLSteve Holme
2013-04-03curl_easy_setopt.3: CURLOPT_HTTPGET disables CURLOPT_UPLOADDaniel Stenberg
2013-03-07DOCS: Corrected the IMAP URL grammar of the UIDVALIDITY parameterSteve Holme
2013-03-07DOCS: Added the list command to the IMAP URL sectionSteve Holme
Added examples of the list command and clarified existing example URLs following recent changes.
2013-02-26DOCS: Added the IMAP UIDVALIDITY property to the CURLOPT_URL sectionSteve Holme
2013-02-25DOCS: Corrected IMAP URL examples according to RFC5092Steve Holme
URL examples that included the UID weren't technically correct although would pass the curl parser.
2013-02-24DOCS: Corrected layout of POP3 and IMAP URL examplesSteve Holme
Corrected layout issues with the POP3 and IMAP URL examples introduced in commit cb3ae6894fb2.
2013-02-23DOCS: Updated CURLOPT_URL section following recent POP3 and IMAP changesSteve Holme
Updated the POP3 sub-section to refer to message ID rather than mailbox. Added an IMAP sub-section with example URLs depicting the specification of mailbox, uid and section.
2013-02-22libcurl documentation: clarifications and typosAlexander Klauer
* Elaborates on default values of some curl_easy_setopt() options. * Reminds the user to cast variadic arguments to curl_easy_setopt() to 'void *' where curl internally interprets them as such. * Clarifies the working of the CURLOPT_SEEKFUNCTION option for curl_easy_setopt(). * Fixes typo 'forth' → 'fourth'. * Elaborates on CURL_SOCKET_TIMEOUT. * Adds some missing periods. * Notes that the return value of curl_version() must not be passed to free().
2013-02-17docs: refer to CURLOPT_ACCEPT_ENCODING instead of the old nameDaniel Stenberg
2013-01-28docs: update the comments about loading CA certs with NSSKamil Dudka
Bug: https://bugzilla.redhat.com/696783