From 868d8e68315f1d30d5a33c93f79022cd84632437 Mon Sep 17 00:00:00 2001 From: Steve Holme Date: Mon, 22 Apr 2013 19:21:07 +0100 Subject: DOCS: Added information about login options to CURLOPT_USERPWD --- docs/libcurl/curl_easy_setopt.3 | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) (limited to 'docs') diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index fd58b14c5..43d150290 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -1046,8 +1046,8 @@ the full path name to the file you want libcurl to use as .netrc file. If this option is omitted, and \fICURLOPT_NETRC\fP is set, libcurl will attempt to find a .netrc file in the current user's home directory. (Added in 7.10.9) .IP CURLOPT_USERPWD -Pass a char * as parameter, which should be [user name]:[password] to use for -the connection. Use \fICURLOPT_HTTPAUTH\fP to decide the authentication method. +Pass a char * as parameter, pointing to a zero terminated login details string +for the connection. The format of which is: [user name]:[password];[options]. When using NTLM, you can set the domain by prepending it to the user name and separating the domain and name with a forward (/) or backward slash (\\). Like @@ -1060,10 +1060,18 @@ and password information to hosts using the initial host name (unless \fICURLOPT_UNRESTRICTED_AUTH\fP is set), so if libcurl follows locations to other hosts it will not send the user and password to those. This is enforced to prevent accidental information leakage. + +At present only IMAP, POP3 and SMTP support login options as part of the +details string. For more information about the login options please see RFC2384 +and RFC5092 (Added in 7.30.1). + +Use \fICURLOPT_HTTPAUTH\fP to specify the authentication method for HTTP based +connections. .IP CURLOPT_PROXYUSERPWD 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 -the authentication method. +the connection to the HTTP proxy. + +Use \fICURLOPT_PROXYAUTH\fP to specify the 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. -- cgit v1.2.3