Unix/Linux Go Back    

RedHat 9 (Linux i386) - man page for ftpls (redhat section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

ftpls(1)										 ftpls(1)

       ftpls - generate a ftp directory listing

       ftpls ftp://host[:port]/directory


       ftpls host[:post] /directory

       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

   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.

	      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.

	      Number  of  tries  to connect and log in. The default is 1, meaning that ftpls will
	      give up after the first error.

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

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

	      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.

	      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.

	      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.

	      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

	      This option was added in version 0.5.2.

   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

       Uwe Ohse, uwe@ohse.de


       The homepage may be more up-to-date, see

ftpcopy 				      0.5.2					 ftpls(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 07:16 AM.