aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl
AgeCommit message (Collapse)Author
2011-04-18transfer-encoding: document the optionsDaniel Stenberg
The new libcurl and command line options are now described.
2011-04-18transfer-encoding: added new option and cmdlineDaniel Stenberg
Added CURLOPT_TRANSFER_ENCODING as the option to set to request Transfer Encoding in HTTP requests (if built zlib enabled). I also renamed CURLOPT_ENCODING to CURLOPT_ACCEPT_ENCODING (while keeping the old name around) to reduce the confusion when we have to encoding options for HTTP. --tr-encoding is now the new command line option for curl to request this, and thus I updated the test cases accordingly.
2011-04-09curl_easy_setopt.3: CURLOPT_RESOLVE typo versionDaniel Stenberg
Reported by: Hongli Lai
2011-04-05return code cleanup: build, init and run-time errorsDaniel Stenberg
Stop the abuse of CURLE_FAILED_INIT as return code for things not being init related by introducing two new return codes: CURLE_NOT_BUILT_IN and CURLE_UNKNOWN_OPTION CURLE_NOT_BUILT_IN replaces return code 4 that has been obsoleted for several years. It is used for returning error when something is attempted to be used but the feature/option was not enabled or explictitly disabled at build-time. Getting this error mostly means that libcurl needs to be rebuilt. CURLE_FAILED_INIT is now saved and used strictly for init failures. Getting this problem means something went seriously wrong, like a resource shortage or similar. CURLE_UNKNOWN_OPTION is the option formerly known as CURLE_UNKNOWN_TELNET_OPTION (and the old name is still present, separately defined to be removed in a very distant future). This error code is meant to be used to return when an option is given to libcurl that isn't known. This problem would mostly indicate a problem in the program that uses libcurl.
2011-03-29curl_easy_setopt.3: mention TFTP read callback flawDaniel Stenberg
The read callback must return the exact requested amount of data when it is used for doing TFTP uploads. This is due to how it deals with data internally. This could/should be fixed but for now we document the existing behavior. Reported by: Colin Blair Bug: http://curl.haxx.se/mail/lib-2011-03/0319.html
2011-03-25TSL-SRP: enabled with OpenSSLPeter Sylvester
If a new enough OpenSSL version is used, configure detects the TLS-SRP support and enables it.
2011-03-24symbols-in-versions: make test 1119 happyDaniel Stenberg
2011-03-21libcurl.m4: Add missing quotes in AC_LINK_IFELSEDave Reisner
This avoids warnings generated by autoconf 2.68. Signed-off-by: Dave Reisner <d@falconindy.com>
2011-03-20symbols-in-versions: many correctionsDaniel Stenberg
Scanned with a tool that checked for mistakes and this is the subsequent cleanup.
2011-03-17symbols-in-versions: remove duplicatesDaniel Stenberg
2011-03-17symbols-in-versions: 2 correctionsDaniel Stenberg
CURLE_CHUNK_FAILED and CURLE_FTP_BAD_FILE_LIST were introduced in 7.21.0, not 7.20.1
2011-03-15nss: do not ignore value of CURLOPT_SSL_VERIFYPEERKamil Dudka
When NSS-powered libcurl connected to a SSL server with CURLOPT_SSL_VERIFYPEER equal to zero, NSS remembered that the peer certificate was accepted by libcurl and did not ask the second time when connecting to the same server with CURLOPT_SSL_VERIFYPEER equal to one. This patch turns off the SSL session cache for the particular SSL socket if peer verification is disabled. In order to avoid any performance impact, the peer verification is completely skipped in that case, which makes it even faster than before. Bug: https://bugzilla.redhat.com/678580
2011-03-12source header: added to more filesDaniel Stenberg
2011-02-21CURLOPT_SSH_KEYFUNCTION: requires *SSH_KNOWNHOSTSDaniel Stenberg
Extend the docs to clarify that CURLOPT_SSH_KEYFUNCTION is only called if the known hosts option is also correctly set!
2011-02-20curl_easy_setopt.3: Removed wrong reference to CURLOPT_USERPASSWORD.Julien Chaffraix
CURLOPT_HTTPAUTH was mentioning CURLOPT_USERPASSWORD instead of CURLOPT_PASSWORD. Reported by: Mike Henshaw
2011-02-17symbols-in-versions: sortedDaniel Stenberg
I forgot to sort it when I added the CURL_SOCKOPT_* symbols
2011-02-17SOCKOPTFUNCTION: documented new return codesDaniel Stenberg
2011-02-09CURLE_TLSAUTH_FAILED: removedQuinn Slack
On second thought, I think CURLE_TLSAUTH_FAILED should be eliminated. It was only being raised when an internal error occurred while allocating or setting the GnuTLS SRP client credentials struct. For TLS authentication failures, the general CURLE_SSL_CONNECT_ERROR seems appropriate; its error string already includes "passwords" as a possible cause. Having a separate TLS auth error code might also cause people to think that a TLS auth failure means the wrong username or password was entered, when it could also be a sign of a man-in-the-middle attack.
2011-02-09TLS-SRP: new options documentedQuinn Slack
2011-01-31file: add support for CURLOPT_TIMECONDITIONDave Reisner
2011-01-21Mention axTLS in some more documentationDan Fandrich
2011-01-19symbols-in-versions: add the new TLSAUTH-SRP symbolsDaniel Stenberg
2011-01-19CURLOPT_SSL_VERIFYPEER: more clarificationsDaniel Stenberg
The default value is 1. curl _uses_ a default CA bundle, it doesn't install one. Drop the references to 7.10 as that is now >8 years old!
2011-01-19curl_easy_setopt.3: clarify VERIFYHOST/PEERDaniel Stenberg
Extended the descriptions somewhat and made the options get listed next to each other.
2011-01-18nss: fix a bug in handling of CURLOPT_CAPATHKamil Dudka
... and update the curl.1 and curl_easy_setopt.3 man pages such that they do not suggest to use an OpenSSL utility if curl is not built against OpenSSL. Bug: https://bugzilla.redhat.com/669702
2011-01-04nss: avoid CURLE_OUT_OF_MEMORY given a file name without any slashKamil Dudka
Bug: https://bugzilla.redhat.com/623663
2010-12-30CURLINFO_FTP_ENTRY_PATH: sftp supportDaniel Stenberg
2010-12-22CURLOPT_MAIL_FROM: document the bracket situationDaniel Stenberg
2010-12-09symbols-in-versions: CURLOPT_KEYPASSWD fixedDaniel Stenberg
It was added in 7.17.0 and is not deprecated
2010-11-11HTTP Auth: Add CURLAUTH_ONLYDaniel Stenberg
This is a meta symbol. OR this value together with a single specific auth value to force libcurl to probe for un-restricted auth and if not, only that single auth algorithm is acceptable. For example you can use CURLAUTH_DIGEST|CURLAUTH_ONLY to make libcurl first probe for what method to use, but yet only consider Digest to be acceptable. Using _only_ CURLAUTH_DIGEST without the CURLAUTH_ONLY field, will make libcurl explicitly use Digest right away and not do any probing.
2010-11-09symbols-in-version: add CURL_SOCKET_BADDaniel Stenberg
I also documented the filtering logic in the symbol-scan.pl function to clarify why not all CURL_* symbols are included.
2010-11-08CURLOPT_RESOLVE: documentedDaniel Stenberg
2010-11-08CURLOPT_USE_SSL: move from FTP options to connection optionsDaniel Stenberg
2010-11-04CURLOPT_NOSIGNAL: add blurb about SIGPIPEDaniel Stenberg
2010-11-03symbols-in-versions: added 119 missing symbolsDaniel Stenberg
I've developed a script I call symbol-scan.pl that scans the curl.h and multi.h header files and compare the symbols it finds in there with the symbols symbols-in-versions documents and outputs a report on the differences. Using this I've dug through the history to fill up symbols-in-versions with all the symbols my script found mismatches for. I will commit symbol-scan.pl separatly and think of a way to put it to use in the build/tests so that we from now on will get this in-sync check automatically.
2010-11-02symbols-in-versions: added missing symbolsDaniel Stenberg
2010-11-02spellfix: CURLOPT_TFTP_BLKSIZE it isDaniel Stenberg
2010-10-19curl_easy_setopt.3: spellfixDaniel Stenberg
2010-10-19curl_easy_setopt.3: CURLOPT_USE_SSL is not just for FTPDaniel Stenberg
It is for FTP, SMTP, POP3, IMAP at least.
2010-10-14curl_easy_setopt.3: clarify CURLOPT_CRLFDaniel Stenberg
The option takes a parameter that should be 1 or 0 to enable or disable the feature. URL: http://curl.haxx.se/bug/view.cgi?id=3086428
2010-10-12Added section on server-supplied names to security considerationsDan Fandrich
2010-10-07libcurl.m4: AC_PATH_PROG fixesDan Locks
The invocation of autoconf's AC_PATH_PROG( ) is not quite right for finding curl-config. This fix corrects the negative case (where curl-config is not found).
2010-10-04libcurl.m4: mention argument is PREFIXDaniel Stenberg
The macro provides a --with-libcurl option that expects a PREFIX to be specified and not actually a "directory" in which libcurl will be found. This now spells that out more clearly. Reported by: Dan Locks Bug: http://curl.haxx.se/bug/view.cgi?id=3079891
2010-10-01curl_easy_setopt.3: CURLOPT_DIRLISTONLY implies dir listDaniel Stenberg
Make it explicit that setting CURLOPT_DIRLISTONLY to 1 will make libcurl to list the directory.
2010-08-28CURLOPT_DIRLISTONLY: don't use with CURLOPT_WILDCARDMATCHDaniel Stenberg
2010-08-23Mention PolarSSL in tutorial & add some URLs to INSTALLDan Fandrich
2010-08-23RESUME_FROM: clarify what ftp uploads doDaniel Stenberg
The numerical value passed to CURLOPT_RESUME_FROM for FTP uploads is interpreted and used as position where to resume the _reading_ of the local file and it will "blindly" append that data on the remote file. This was certainly not clear in the docs previously. Reported by: catalin Bug: http://curl.haxx.se/bug/view.cgi?id=3048174
2010-08-10multi_socket_action: clarify how to kickstart itDaniel Stenberg
The callbacks are called when curl_multi_socket_action() is called, not when handles are added. This is now mentioned in the "TYPICAL USAGE" section.
2010-08-07curl_easy_setopt.3: rename stream to userdataDaniel Stenberg
In some places where the name 'stream' has been used for naming a function argument that is in fact settable with a setopt() option we now call that argument 'userdata' to make it more obvious that it is in fact possible to set by the application. Suggested by: Jeff Pohlmeyer
2010-07-30KNOWN_BUG: The SOCKET type in Win64 is 64 bitsDaniel Stenberg
The SOCKET type in Win64 is 64 bits large (and thus so is curl_socket_t on that platform), and long is only 32 bits. It makes it impossible for curl_easy_getinfo() to return a socket properly with the CURLINFO_LASTSOCKET option as for all other operating systems.