aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_easy_setopt.3
AgeCommit message (Collapse)Author
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-22CURLOPT_MAIL_FROM: document the bracket situationDaniel Stenberg
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-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-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-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-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-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-05-16ftp wildcard: a new option CURLOPT_FNMATCH_DATAKamil Dudka
2010-05-12ftp wildcards: mention they're added in 7.21.0Daniel Stenberg
2010-05-12syntax: cleanupsDaniel Stenberg
2010-05-12FTP: WILDCARDMATCH/CHUNKING/FNMATCH addedPavel Raiskup
2010-04-26progress callback: can be called more than once per secDaniel Stenberg
2010-03-24Fix RTSP GET_PARAMETER empty and non-empty operation.Chris Conroy
Test coverage included. Thanks to Massimo Callegari for the bug report
2010-03-24remove the CVSish $Id$ linesDaniel Stenberg
2010-03-04Julien Chaffraix clarified CURLOPT_HEADERFUNCTION and madeDaniel Stenberg
CURLOPT_HEADERFUNCTION and CURLOPT_WRITEFUNCTION more consistent
2010-02-20- Fixed the SMTP compliance by making sure RCPT TO addresses are specifiedDaniel Stenberg
properly in angle brackets. Recipients provided with CURLOPT_MAIL_RCPT now get angle bracket wrapping automatically by libcurl unless the recipient starts with an angle bracket as then the app is assumed to deal with that properly on its own.
2010-02-14removed trailing whitespaceYang Tse
2010-01-28Chris Conroy's RTSP followup fixesYang Tse
2010-01-22s/RTPFUNCTION/INTERLEAVEFUNCTION/Daniel Stenberg
s/RTPDATA/INTERLEAVEDATA/
2010-01-22keep lines shorter than 80 columns, and reduce/remove the use of the wordDaniel Stenberg
'note' in most description as it is mostly useless.
2010-01-21Chris Conroy brought support for RTSP transfers, and with it comes 8(!) newDaniel Stenberg
libcurl options for controlling what to get and how to receive posssibly interleaved RTP data. Initial commit.
2010-01-06Julien Chaffraix fixed so that the fragment part in an URL is not sent to ↵Claes Jakobsson
the server anymore
2010-01-01update copyright year since we are in 2010 nowDaniel Stenberg
2010-01-01- Ingmar Runge enhanced libcurl's FTP engine to support the PRET command. ThisDaniel Stenberg
command is a special "hack" used by the drftpd server, but even though it is a custom extension I've deemed it fine to add to libcurl since this server seems to survive and people keep using it and want libcurl to support it. The new libcurl option is named CURLOPT_FTP_USE_PRET, and it is also usable from the curl tool with --ftp-pret. Using this option on a server that doesn't support this command will make libcurl fail.
2009-12-31added descriptions for CURLOPT_MAIL_FROM and CURLOPT_MAIL_RCPTDaniel Stenberg
2009-11-23fixed CURLOPT_TFTP_BLKSIZE typoDaniel Stenberg
2009-08-04RFC1867 was updated by RFC2388Daniel Stenberg
2009-07-22- Added CURLOPT_SSH_KNOWNHOSTS, CURLOPT_SSH_KEYFUNCTION, CURLOPT_SSH_KEYDATA.Daniel Stenberg
They introduce known_host support for SSH keys to libcurl. See docs for details.
2009-07-08Markus Koetter's man page updates for the FTPPORT rangesDaniel Stenberg
2009-06-30silly typo, pointed out by Fabian KeilDaniel Stenberg
2009-06-29- Markus Koetter made CURLOPT_FTPPORT (and curl's -P/--ftpport) support a portDaniel Stenberg
range if given colon-separated after the host name/address part. Like "192.168.0.1:2000-10000"
2009-06-10extended the CURLOPT_HEADERFUNCTION description with Aaron Oneal's helpDaniel Stenberg
2009-05-07- Man page *roff problems fixed thanks to input from Colin Watson. ProblemsDaniel Stenberg
reported in the Debian package.
2009-04-28- Bug report #2709004 (http://curl.haxx.se/bug/view.cgi?id=2709004) by TimDaniel Stenberg
Chen pointed out how curl couldn't upload with resume when reading from a pipe. This ended up with the introduction of a new return code for the CURLOPT_SEEKFUNCTION callback that basically says that the seek failed but that libcurl may try to resolve the situation anyway. In our case this means libcurl will attempt to instead read that much data from the stream instead of seeking and that way curl can now upload with resume when data is read from a stream!
2009-04-23CURLOPT_POSTQUOTE commands only run when no errorDaniel Stenberg
2009-04-06- I clarified in the docs that CURLOPT_SEEKFUNCTION should return 0 on successDaniel Stenberg
and 1 on fatal errors. Previously it only mentioned non-zero on fatal errors. This is a slight change in meaning, but it follows what we've done elsewhere before and it opens up for LOTS of more useful return codes whenever we can think of them...
2009-03-20Gary Maxwell helped us clarify that CURLOPT_SHARE specificly needs the lockingDaniel Stenberg
functions if the easy handles are used in multiple threads
2009-03-02- David Kierznowski notified us about a security flawDaniel Stenberg
(http://curl.haxx.se/docs/adv_20090303.html also known as CVE-2009-0037) in which previous libcurl versions (by design) can be tricked to access an arbitrary local/different file instead of a remote one when CURLOPT_FOLLOWLOCATION is enabled. This flaw is now fixed in this release together this the addition of two new setopt options for controlling this new behavior: o CURLOPT_REDIR_PROTOCOLS controls what protocols libcurl is allowed to follow to when CURLOPT_FOLLOWLOCATION is enabled. By default, this option excludes the FILE and SCP protocols and thus you nee to explicitly allow them in your app if you really want that behavior. o CURLOPT_PROTOCOLS controls what protocol(s) libcurl is allowed to fetch using the primary URL option. This is useful if you want to allow a user or other outsiders control what URL to pass to libcurl and yet not allow all protocols libcurl may have been built to support.
2009-02-23mention default port numberDaniel Stenberg
2009-02-17- CURLOPT_FTP_CREATE_MISSING_DIRS can now be set to 2 in addition to 1 forDaniel Stenberg
plain FTP connections, and it will then allow MKD to fail once and retry the CWD afterwards. This is especially useful if you're doing many simultanoes connections against the same server and they all have this option enabled, as then CWD may first fail but then another connection does MKD before this connection and thus MKD fails but trying CWD works! The numbers can (should?) now be set with the convenience enums now called CURLFTP_CREATE_DIR and CURLFTP_CREATE_DIR_RETRY. Tests has proven that if you're making an application that uploads a set of files to an ftp server, you will get a noticable gain in speed if you're using multiple connections and this option will be then be very useful.
2009-02-11- CURLINFO_CONDITION_UNMET was added to allow an application to get to know ifDaniel Stenberg
the condition in the previous request was unmet. This is typically a time condition set with CURLOPT_TIMECONDITION and was previously not possible to reliably figure out. From bug report #2565128 (http://curl.haxx.se/bug/view.cgi?id=2565128)