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