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