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.

-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

Software by Uwe Ohse

The ftpcopy package