ftpls(1)

ftpls - generate a ftp directory listing

SYNOPSIS
ftpls ftp://host[:port]/directory or ftpls host[:post] /directory

DESCRIPTION
ftpls generates a listing of files and directories in a FTP directory. ftpls by default prints a human readable ascii output, but may also create HTML and machine parsable output.

OPTIONS
Use NAME to login on the ftp server. Note that this option overrides an user name given in an URL.
The default is `anonymous'. Use an empty name to force to not log in. Use PASS as password to login on the ftp server. Note that this option overrides a password given in an URL.
The default is `anonymous@invalid.example'. Use an empty password to enforce not sending any password. Send ACCOUNT as the account name using the ACCT ftp command if the ftp servers asks for one. ACCOUNT in ftp speak is some kind of sub account in some other terminologies. If you don't understand what it means you have a good chance to never need this option anyway. If you think you need it please try the -u option first. Number of tries to connect and log in. The default is 1, meaning that ftpls will give up after the first error. ftpls will sleep for NUMBER seconds after a try to connect or login has failed. The default is 5, a zero is treated as one, and abuse (especially together with --tries) is likely to annoy the server administrator. This option was added in version 0.4.5. Create HTML index containing all files together with modification time and size. Note: The links in this index will contain username and password if you include them into an URL given to ftpls on the command line (either as argument or through the --urlprefix option). They will not be included otherwise, for security and privacy reasons. Create machine parsable output. Title text to use on the HTML output. URL-Prefix to use in listings. If this option is not given then an URL given on the command line will be used instead, and if this has not been given an URL will be created from host, port and directory given on the command line. Print the name of a sub directory before printing it's content. Do not print the name of the top level directory of the listing.
Use this option together with --raw. Do not use it together with --html. sort alphabetical. sort reverse alphabetical. sort youngest first. sort oldest first. sort shortest first. sort longest first. Add OPTS to LIST command. This allows to pass arbitrary options to the FTP servers LIST command. Note that ftpls does not cope well with recursive directory listings. ftpls will read the directories to be listed from the standard input. Any remote directory given on the command line will be ignored. Each directory listing is terminated by a END-OF-LISTING line. Do not use this together with the --html option. This option was added in version 0.3.6. Do a recursive directory listing by first printing one directory, including sub directory names, and then traversing into sub directories. Output directory listings in the original format and sort order. Timeout to use for network read/write and connect operations. The default is 30 seconds and is usually sufficient. This option was added in version 0.3.8. Do not use the poll() system call even if it's available, but use select(). This allows ftpls to be used together with the runsocks program from the socks5 reference implementation. Please note that you'll need a directly reachable name server anyway, as the DNS library in use does not support SOCKS (you can always use IP addresses). This option was added in version 0.3.8.

EXAMPLES
  ftpls \
  --html --title "CVS tree index by date" \
  --urlprefix ftp://ftp.ohse.de/uwe/cvs-trees/  \
  --newest \
  ftp://serak.ohse.de/uwe/cvs-trees \
  > SOMEWHERE/cvs-trees/index-by-date.html

AUTHOR
Uwe Ohse, uwe@ohse.de

SEE ALSO
The homepage may be more up-to-date, see
http://www.ohse.de/uwe/ftpcopy.html.