- Igor Novoseltsev brought a patch that introduced two new options to

                                  Changelog

Daniel Stenberg (8 Oct 2008)

- Igor Novoseltsev brought a patch that introduced two new options to

  curl_easy_setopt: CURLOPT_USERNAME and CURLOPT_PASSWORD that sort of

  deprecates the good old CURLOPT_USERPWD since they allow applications to set

  the user name and password independently and perhaps more importantly allow

  both to contain colon(s) which CURLOPT_USERPWD doesn't fully support.

Daniel Fandrich (7 Oct 2008)

- Changed the handling of read/write errors in Curl_perform() to allow a

  a fresh connection to be made in such cases and the request retransmitted.

 Public curl releases:         107

 Command line options:         128

 curl_easy_setopt() options:   154

 curl_easy_setopt() options:   156

 Public functions in libcurl:  58

 Known libcurl bindings:       37

 Contributors:                 672

 o Added CURLOPT_POSTREDIR

 o Better detect HTTP 1.0 servers and don't do HTTP 1.1 requests on them

 o configure --disable-proxy disables proxy

 o Added CURLOPT_USERNAME and CURLOPT_PASSWORD

This release includes the following bugfixes:

 Keith Mok, Yang Tse, Daniel Fandrich, Guenter Knauf, Dmitriy Sergeyev,

 Linus Nielsen Feltzing, Martin Drasar, Stefan Krause, Dmitry Kurochkin,

 Mike Revi, Andres Garcia, Michael Goffioul, Markus Moeller, Rob Crittenden,

 Jamie Lokier, Emanuele Bovisio, Maxim Ivanov, Ian Lynagh, Daniel Egger

 Jamie Lokier, Emanuele Bovisio, Maxim Ivanov, Ian Lynagh, Daniel Egger,

 Igor Novoseltsev

        Thanks! (and sorry if I forgot to mention someone)

  doesn't do a HEAD first to get the initial size. This needs to be done

  manually for HTTP PUT resume to work, and then '-C [index]'.

7. CURLOPT_USERPWD and CURLOPT_PROXYUSERPWD have no way of providing user names

  that contain a colon. This can't be fixed easily in a backwards compatible

  way without adding new options (and then, they should most probably allow

  setting user name and password separately).

7. CURLOPT_PROXYUSERPWD has no way of providing user names that contain a

  colon. This can't be fixed easily in a backwards compatible way without

  adding new options. CURLOPT_USERPWD was split into CURLOPT_USERNAME and

  CURLOPT_PASSWORD for this reason.

6. libcurl ignores empty path parts in FTP URLs, whereas RFC1738 states that

  such parts should be sent to the server as 'CWD ' (without an argument).

Pass a char * as parameter, which should be [user name]:[password] to use for

the connection to the HTTP proxy.  Use \fICURLOPT_PROXYAUTH\fP to decide

authentication method.

.IP CURLOPT_USERNAME

Pass a char * as parameter, which should be pointing to the zero terminated

user name to use for the transfer.

The CURLOPT_USERNAME option should be used in same way as the

\fICURLOPT_USERPWD\fP is used.  In comparison to \fICURLOPT_USERPWD\fP the

CURLOPT_USERNAME allows the username to contain colon, like in following

example: "sip:user@example.com".  Note the CURLOPT_USERNAME option is an

alternative way to set the user name.  There is no meaning to use it together

with the \fICURLOPT_USERPWD\fP option.

In order to specify the password to be used in conjunction with the user name

use the \fICURLOPT_PASSWORD\fP option.  (Added in 7.19.1)

.IP CURLOPT_PASSWORD

Pass a char * as parameter, which should be pointing to the zero terminated

password to use for the transfer.

The CURLOPT_PASSWORD option should be used in conjunction with

as the \fICURLOPT_USERNAME\fP option. (Added in 7.19.1)

.IP CURLOPT_HTTPAUTH

Pass a long as parameter, which is set to a bitmask, to tell libcurl what

authentication method(s) you want it to use. The available bits are listed

below. If more than one bit is set, libcurl will first query the site to see

what authentication methods it supports and then pick the best one you allow

it to use. For some methods, this will induce an extra network round-trip. Set

the actual name and password with the \fICURLOPT_USERPWD\fP option. (Added in

7.10.6)

the actual name and password with the \fICURLOPT_USERPWD\fP option or

with the \fICURLOPT_USERNAME\fP and the \fICURLOPT_USERPASSWORD\fP options.

(Added in 7.10.6)

.RS

.IP CURLAUTH_BASIC

HTTP Basic authentication. This is the default choice, and the only method

     working with OpenSSL-powered builds. */

  CINIT(CERTINFO, LONG, 172),

  /* "name" and "pwd" to use when fetching. */

  CINIT(USERNAME, OBJECTPOINT, 173),

  CINIT(PASSWORD, OBJECTPOINT, 174),

  CURLOPT_LASTENTRY /* the last unused */

} CURLoption;