Patrick Monnerat and I modified libcurl so that now it *copies* all strings

                                  Changelog

Daniel S (1 August 2007)

- Patrick Monnerat and I modified libcurl so that now it *copies* all strings

  passed to it with curl_easy_setopt()! Previously it has always just refered

  to the data, forcing the user to keep the data around until libcurl is done

  with it. That is now history and libcurl will instead clone the given

  strings and keep private copies. This is also part of Patrick Monnerat's

  OS/400 port.

  Due to this being a somewhat interesting change API wise, I've decided to

  bump the version of the upcoming release to 7.17.0. Older applications will

  of course not notice this change nor do they have to care, but new

  applications can be written to take advantage of this.

- Greg Morse reported a problem with POSTing using ANYAUTH to a server

  requiring NTLM, and he provided test code and a test server and we worked

  out a bug fix. We failed to count sent body data at times, which then caused

This release includes the following changes:

 o support for OS/400 Secure Sockets Layer library

 o curl_easy_setopt() now allocates strings passed to it

This release includes the following bugfixes:

.IP CURLINFO_PRIVATE

Pass a pointer to a 'char *' to receive the pointer to the private data

associated with the curl handle (set with the CURLOPT_PRIVATE option to

\fIcurl_easy_setopt(3)\fP). (Added in 7.10.3)

\fIcurl_easy_setopt(3)\fP). Please note that for internal reasons, the

value is returned as a 'char *', although effectively being a 'void *'.

(Added in 7.10.3)

.IP CURLINFO_HTTPAUTH_AVAIL

Pass a pointer to a long to receive a bitmask indicating the authentication

method(s) available. The meaning of the bits is explained in the

.\" * $Id$

.\" **************************************************************************

.\"

.TH curl_easy_setopt 3 "22 Feb 2007" "libcurl 7.16.2" "libcurl Manual"

.TH curl_easy_setopt 3 "1 Aug 2007" "libcurl 7.17.0" "libcurl Manual"

.SH NAME

curl_easy_setopt \- set options for a curl easy handle

.SH SYNOPSIS

you must change them between the transfers. You can optionally reset all

options back to internal default with \fIcurl_easy_reset(3)\fP.

Strings passed to libcurl as 'char *' arguments, will not be copied by the

library. Instead you should keep them available until libcurl no longer needs

them. Failing to do so will cause very odd behavior or even crashes. libcurl

will need them until you call \fIcurl_easy_cleanup(3)\fP or you set the same

option again to use a different pointer.

Strings passed to libcurl as 'char *' arguments, are copied by the library;

thus the string storage associated to the pointer argument may be overwritten

after curl_easy_setopt() returns. Exceptions to this rule are described in

the option details below.

NOTE: before 7.17.0 strings were not copied. Instead the user was forced keep

them available until libcurl no longer needed them.

The \fIhandle\fP is the return code from a \fIcurl_easy_init(3)\fP or

\fIcurl_easy_duphandle(3)\fP call.

Pass a char * to a buffer that the libcurl may store human readable error

messages in. This may be more helpful than just the return code from

\fIcurl_easy_perform\fP. The buffer must be at least CURL_ERROR_SIZE big.

Although this argument is a 'char *', it does not describe an input string.

Therefore the (probably undefined) contents of the buffer is NOT copied

by the library. You should keep the associated storage available until

libcurl no longer needs it. Failing to do so will cause very odd behavior

or even crashes. libcurl will need it until you call \fIcurl_easy_cleanup(3)\fP

or you set the same option again to use a different pointer. 

Use \fICURLOPT_VERBOSE\fP and \fICURLOPT_DEBUGFUNCTION\fP to better

debug/trace why errors happen.

(Added in 7.16.1)

.SH OTHER OPTIONS

.IP CURLOPT_PRIVATE

Pass a char * as parameter, pointing to data that should be associated with

Pass a void * as parameter, pointing to data that should be associated with

this curl handle.  The pointer can subsequently be retrieved using

\fIcurl_easy_getinfo(3)\fP with the CURLINFO_PRIVATE option. libcurl itself

does nothing with this data. (Added in 7.10.3)

/* This is the version number of the libcurl package from which this header

   file origins: */

#define LIBCURL_VERSION "7.16.5-CVS"

#define LIBCURL_VERSION "7.17.0-CVS"

/* The numeric version number is also available "in parts" by using these

   defines: */

#define LIBCURL_VERSION_MAJOR 7

#define LIBCURL_VERSION_MINOR 16

#define LIBCURL_VERSION_PATCH 5

#define LIBCURL_VERSION_MINOR 17

#define LIBCURL_VERSION_PATCH 0

/* This is the numeric version of the libcurl version number, meant for easier

   parsing and comparions by programs. The LIBCURL_VERSION_NUM define will

   and it is always a greater number in a more recent release. It makes

   comparisons with greater than and less than work.

*/

#define LIBCURL_VERSION_NUM 0x071005

#define LIBCURL_VERSION_NUM 0x071100

/*

 * This is the date and time when the full source package was created. The