Home | History | Annotate | Download | only in cmdline-opts
      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.
     25