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