Annotation of embedaddon/curl/docs/cmdline-opts/list-only.d, revision 1.1.1.1

1.1       misho       1: Long: list-only
                      2: Short: l
                      3: Protocols: FTP POP3
                      4: Help: List only mode
                      5: Added: 7.21.5
                      6: ---
                      7: (FTP)
                      8: When listing an FTP directory, this switch forces a name-only view. This is
                      9: especially useful if the user wants to machine-parse the contents of an FTP
                     10: directory since the normal directory view doesn't use a standard look or
                     11: format. When used like this, the option causes a NLST command to be sent to
                     12: the server instead of LIST.
                     13: 
                     14: Note: Some FTP servers list only files in their response to NLST; they do not
                     15: include sub-directories and symbolic links.
                     16: 
                     17: (POP3)
                     18: When retrieving a specific email from POP3, this switch forces a LIST command
                     19: to be performed instead of RETR. This is particularly useful if the user wants
                     20: to see if a specific message id exists on the server and what size it is.
                     21: 
                     22: Note: When combined with --request, this option can be used to send an UIDL
                     23: command instead, so the user may use the email's unique identifier rather than
                     24: it's message id to make the request.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>