ftpls(1)						      General Commands Manual							  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.

   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.

       --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.5.2								  ftpls(1)