ftpls
ftpls(1) 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
Login options
-u, --user=NAME
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.
-p, --pass=PASSWORD
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.
--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.
--tries=NUMBER
Number of tries to connect and log in. The default is 1, meaning
that ftpls will give up after the first error.
--login-sleep=NUMBER
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.
-4, --v4
Only use IPv4, even is IPv6 is available. This option
effectively disallows the use of IPv6, except for DNS queries.
This option was added in version 0.6.0.
-6, --v6
Only use IPv6, even is IPv4 is available. This option
effectively disallows the use of IPv4, except for DNS queries.
This option was added in version 0.6.0.
Output mode options
-h, --html
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.
-m, --machine
Create machine parsable output.
-t, --title=TEXT
Title text to use on the HTML output.
-U, --urlprefix=URL
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-dir
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.
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
--ascii-listings
Do directory listings in ASCII mode instead of binary mode. Use
this option if the FTP server is unable to correctly list
directories in binary mode, for example, if you see a message
like this:
ftpls: failed to read directory listing: protocol error
This option was added in version 0.5.2.
-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.
This option was added in version 0.3.6.
-R, --recursive
Do a recursive directory listing by first printing one
directory, including sub directory names, and then traversing
into sub directories.
--allow-pasv-ip
Allow data connections to the address IP4.
Normally ftpcopy only accepts data connections to the addresses
of the host it connected to. The list of addresses contains the
IP addresses of the host, as returned by the DNS query, or the
IPv4 address of the host, in case an IPv4 address was given on
the commandline.
This option allows to add one or more IP addresses, separated by
commas, to the internal list. It may be given more than once.
You may want to use this option if you are behind some kind of
machine (gateway) doing NAT (network address translation) or
maquerading and ftpcopy prints an error message containing
"illegal redirect by FTP server".
Note: If you are not behind a NAT gateway, then do not use this
option without thinking: FTP redirects may be used to launch
denial of service attacks against innocent targets.
The environment variable FTPCOPY_ALLOW_PASV_IP has the same
function.
This option was added in version 0.6.1.
--raw
Output directory listings in the original format and sort order.
-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.
--max-depth
Descend at most LEVEL directories deep. 0 means do not enter
sub directories at all, 1 means enter sub-directories, but not
their sub-directories, and so on. This option enables the
--recursive option, too. The default is 2^32-1, meaning enter
all.
This option was added in version 0.5.2.
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.
ftpcopy 0.6.2 ftpls(1)
Man(1) output converted with
man2html