From a4471045bba8fc83a64221edc9a126796cb2c820 Mon Sep 17 00:00:00 2001 From: Steve Holme Date: Fri, 21 Oct 2011 22:59:50 +0100 Subject: [PATCH] curl_easy_setopt: Added pop3 to CURLOPT_URL. Added pop3 username and password example as well as an explanation of how path part of the URL is used under pop3. Additionally have corrected a couple of typos. --- docs/libcurl/curl_easy_setopt.3 | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index b888e40277..f4f0c80e3d 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -615,10 +615,11 @@ 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. -HTTP and FTP support this type of authentication as follows: +For exammple the following types of authentication support this: -http://name:password@www.domain.com -ftp://name:password@ftp.domain.com +http://user:password@www.domain.com +ftp://user:password@ftp.domain.com +pop3://user:password@mail.domain.com 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 @@ -693,6 +694,15 @@ sends your local computer's host name in the HELO / EHLO command. smtp://mail.domain.com/client.domain.com - This will send client.domain.com in the HELO / EHLO command to the mail server at domain.com. +.B POP3 + +The path part of a POP3 request specifies the mailbox (message) to retrieve. +If the mailbox is not specified then a list of waiting messages is returned +instead. + +pop3://user:password@mail.domain.com - This lists the available messages +pop3://user:password@mail.domain.com/1 - This retrieves the first message + .B SCP The path part of an SCP request specifies the file to retrieve and from what @@ -717,7 +727,8 @@ the directory listing for the root / home directory will be returned. If the user name is not embedded in the URL, it can be set with the \fICURLOPT_USERPWD\fP or \fBCURLOPT_USERNAME\fP option. -sftp://user:pass@example.com/etc/issue - This specifies the file /etc/issue +sftp://user:password@example.com/etc/issue - This specifies the file +/etc/issue sftp://user@example.com/~/my-file - This specifies the file my-file in the user's home directory