diff options
author | Daniel Stenberg <daniel@haxx.se> | 2016-11-15 23:44:58 +0100 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2016-11-16 10:42:51 +0100 |
commit | 41b1f649bf63e3663fcf3d4a678fef37688e32b7 (patch) | |
tree | 4fe54a49307d30025a67a5c83807d857f4bcbeba /docs/cmdline-opts/list-only.d | |
parent | 81e61cda396da7eefb15dcf20b9e8be7ada37283 (diff) |
cmdline-docs: more options converted over
Diffstat (limited to 'docs/cmdline-opts/list-only.d')
-rw-r--r-- | docs/cmdline-opts/list-only.d | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/cmdline-opts/list-only.d b/docs/cmdline-opts/list-only.d new file mode 100644 index 000000000..4c56304a0 --- /dev/null +++ b/docs/cmdline-opts/list-only.d @@ -0,0 +1,24 @@ +Long: list-only +Short: l +Protocols: FTP POP3 +Help: List only mode +Added: 7.21.5 +--- +(FTP) +When listing an FTP directory, this switch forces a name-only view. This is +especially useful if the user wants to machine-parse the contents of an FTP +directory since the normal directory view doesn't use a standard look or +format. When used like this, the option causes a NLST command to be sent to +the server instead of LIST. + +Note: Some FTP servers list only files in their response to NLST; they do not +include sub-directories and symbolic links. + +(POP3) +When retrieving a specific email from POP3, this switch forces a LIST command +to be performed instead of RETR. This is particularly useful if the user wants +to see if a specific message id exists on the server and what size it is. + +Note: When combined with --request, this option can be used to send an UIDL +command instead, so the user may use the email's unique identifier rather than +it's message id to make the request. |