aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_easy_setopt.3
AgeCommit message (Collapse)Author
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)
2009-02-10mention when CURLOPT_ADDRESS_SCOPE was addedDaniel Stenberg
2009-02-06Mention the first release of CURLOPT_FTP_FILEMETHODDan Fandrich
2009-02-02- Craig A West brought us: libcurl now defaults to do CONNECT with HTTPDaniel Stenberg
version 1.1 instead of 1.0 like before. This change also introduces the new proxy type for libcurl called 'CURLPROXY_HTTP_1_0' that then allows apps to switch (back) to CONNECT 1.0 requests. The curl tool also got a --proxy1.0 option that works exactly like --proxy but sets CURLPROXY_HTTP_1_0. I updated all test cases cases that use CONNECT and I tried to do some using --proxy1.0 and some updated to do CONNECT 1.1 to get both versions run.
2009-01-28- Markus Moeller introduced two new options to libcurl:Daniel Stenberg
CURLOPT_SOCKS5_GSSAPI_SERVICE and CURLOPT_SOCKS5_GSSAPI_NEC to allow libcurl to do GSS-style authentication with SOCKS5 proxies. The curl tool got the options called --socks5-gssapi-service and --socks5-gssapi-nec to enable these.
2009-01-26- Chad Monroe provided the new CURLOPT_TFTP_BLKSIZE option that allows an appDaniel Stenberg
to set desired block size to use for TFTP transfers instead of the default 512 bytes.
2009-01-25- Craig A West brought CURLOPT_NOPROXY and the corresponding --noproxy option.Daniel Stenberg
They basically offer the same thing the NO_PROXY environment variable only offered previously: list a set of host names that shall not use the proxy even if one is specified.
2008-12-29further clarifcation based on input from Anthony BryanDaniel Stenberg
2008-12-28Anthony Bryan's man page cleanup in language and spellingDaniel Stenberg
2008-12-28The CURLOPT_KRBLEVEL description wasn't properly formatted and thus wasDaniel Stenberg
corrupted in ouputs. Another report from Anthony Bryan.
2008-12-28Anthony Bryan reported this outputs wrong in the PDF and I've now tried toDaniel Stenberg
escape these letters what I think is the correct way.
2008-12-19expand the CURLOPT_POSTREDIR explanationDaniel Stenberg
2008-12-10- Internet Explorer had a broken HTTP digest authentication before v7 andDaniel Stenberg
there are servers "out there" that relies on the client doing this broken Digest authentication. Apache even comes with an option to work with such broken clients. The difference is only for URLs that contain a query-part (a '?'-letter and text to the right of it). libcurl now supports this quirk, and you enable it by setting the CURLAUTH_DIGEST_IE bit in the bitmask you pass to the CURLOPT_HTTPAUTH or CURLOPT_PROXYAUTH options. They are thus individually controlled to server and proxy.
2008-12-09Documented CURLOPT_CONNECT_ONLY as being useful only on HTTP URLs.Dan Fandrich