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
Login options
--tries=NUMBER
Number of tries to connect and log in. The default
is 1, meaning that ftpls will give up after the
first error.
--account=ACCOUNT
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.
-p, --pass=PASSWORD
Use PASS as password to login on the ftp server.
The default is `anonymous@invalid.example'. Use an
empty password to enforce not sending any password.
-u, --user=NAME
Use NAME to login on the ftp server.
The default is `anonymous'. Use an empty name to
force to not log in.
Output mode options
-h, --html
Create HTML index.
Create machine parsable output.
-t, --title=TEXT
Title text to use on the HTML output.
-U, --urlprefix=URL
URL-Prefix to use in listings.
SORTING
-a, --alpha
sort alphabetical.
-z, --omega
sort reverse alphabetical.
-n, --newest
sort youngest first.
-o, --oldest
sort oldest first.
-s, --shortest
sort shortest first.
-l, --longest
sort longest first.
Other options
-L, --list-options=OPTS
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.
--interactive
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.
-R, --recursive
Do a recursive directory listing by first printing
one directory, including sub directory names, and
then traversing into sub directories.
-T, --timeout=SECONDS
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.
--force-select
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
Generate a HTML index page
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
ftpcopy(1).
The homepage may be more up-to-date, see
http://www.ohse.de/uwe/ftpcopy.html.
Man(1) output converted with
man2html