moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2024-12-22 16:18:48 -05:00
Code Issues Releases Wiki Activity

CURLOPT_DIRLISTONLY.3: Added information about the usage in POP3

Browse Source
This commit is contained in:
Steve Holme 2014-10-30 12:30:11 +00:00
parent 697aa67d18
commit 89cc9988c9
1 changed files with 14 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/libcurl/opts/CURLOPT_DIRLISTONLY.3
View File

@ -28,13 +28,18 @@ CURLOPT_DIRLISTONLY \- ask for names only in a directory listing
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DIRLISTONLY, long listonly); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DIRLISTONLY, long listonly);
.SH DESCRIPTION .SH DESCRIPTION
A parameter set to 1 tells the library to just list the names of files in a For FTP and SFTP based URLs a parameter set to 1 tells the library to list the
directory, instead of doing a full directory listing that would include file names of files in a directory, rather than performing a full directory listing
sizes, dates etc. This works for FTP and SFTP URLs. that would normally include file sizes, dates etc.
This causes an FTP NLST command to be sent on an FTP server. Beware that some For POP3 a parameter of 1 tells the library to list the email message or
FTP servers list only files in their response to NLST; they might not include messages on the POP3 server. This can be used to change the default behaviour
subdirectories and symbolic links. of libcurl, when combined with a URL that contains a message ID, to perform a
"scan listing" which can then be used to determine the size of an email.
Note: For FTP this causes a NLST command to be sent to the FTP server. Beware
that some FTP servers list only files in their response to NLST; they might not
include subdirectories and symbolic links.
Setting this option to 1 also implies a directory listing even if the URL Setting this option to 1 also implies a directory listing even if the URL
doesn't end with a slash, which otherwise is necessary. doesn't end with a slash, which otherwise is necessary.
@ -44,11 +49,12 @@ will effectively break that feature then.
.SH DEFAULT .SH DEFAULT
0, disabled 0, disabled
.SH PROTOCOLS .SH PROTOCOLS
FTP and SFTP FTP, SFTP and POP3
.SH EXAMPLE .SH EXAMPLE
TODO TODO
.SH AVAILABILITY .SH AVAILABILITY
This option was known as CURLOPT_FTPLISTONLY up to 7.16.4 This option was known as CURLOPT_FTPLISTONLY up to 7.16.4. POP3 is supported
since 7.21.5.
.SH RETURN VALUE .SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO" .SH "SEE ALSO"