From: Steve Holme Date: Mon, 22 Apr 2013 18:12:46 +0000 (+0100) Subject: DOCS: Added information about login options in the URL X-Git-Tag: curl-7_31_0~128 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e3aca1b2ce1511aae5a4cc0b87e8746a7f312c98;p=thirdparty%2Fcurl.git DOCS: Added information about login options in the URL --- diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index 3297f83914..fd58b14c56 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -640,17 +640,23 @@ http://192.168.0.1/ http://[2001:1890:1112:1::20]/ -It is also possible to specify the user name and password as part of the -host, for some protocols, when connecting to servers that require -authentication. - -For example the following types of authentication support this: +It is also possible to specify the user name, password and any supported login +options as part of the host, for the following protocols, when connecting to +servers that require authentication: http://user:password@www.example.com ftp://user:password@ftp.example.com -pop3://user:password@mail.example.com +imap://user:password;options@mail.example.com + +pop3://user:password;options@mail.example.com + +smtp://user:password;options@mail.example.com + +At present only IMAP, POP3 and SMTP support login options as part of the host. +For more information about the login options in URL syntax please see RFC2384 +and RFC5092 (Added in 7.30.1). The port is optional and when not specified libcurl will use the default port based on the determined or specified protocol: 80 for HTTP, 21 for FTP and 25