Uwe Ohse homepage

The ftpcopy package


NAME

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

--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

-h, --html
Create HTML index.

-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.

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 ftpcopy does not cope well with recursive directory listings.


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)