👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

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

ftpcopy(1)									       ftpcopy(1)

NAME
       ftpcopy - mirror or copy files from a FTP server

SYNOPSIS
       ftpcopy ftp://host[:port]/directory [local-directory]

       or

       ftpcopy host[:port] /directory [local-directory]

DESCRIPTION
       ftpcopy	copies	a  FTP	site  recursivly.  It  afterwards  deletes all files in the local
       directory tree which were not found on the remote site.

       local-directory defaults to "." - the current working directory - if the -n  (--no-delete)
       option  is  used.  local-directory  is  not  needed  if	the --interactive option is used.
       Otherwise you must provide a local-directory argument.

OPTIONS
   Login options
       -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.

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

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

	      This option was added in version 0.3.0.

       --login-sleep=NUMBER
	      ftpcopy  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.

   Verbosity Options
       -l, --loglevel=NUMBER
	      this controls the amount of logging done:

       *

	   0: nothing except warnings and error messages

       *

	   1: downloads and deletes

       *

	   2: links/symlinks created, files we already got

       *

	   3: useless stuff

	  The default is 1.

       --bps
	  Log transfer rates.

	  This option was added in version 0.3.9.

   Options controlling file selection
       -m, --max-days=NUMBER
	      Download	only  files modified in the last NUMBER days.  Locally existing copies of
	      the not downloaded files will be kept.

       --max-size=BYTES
	      Download only files up to BYTES bytes length. Locally existing copies  of  overlong
	      files will be deleted during the clean-up step.

	      This option was added in version 0.5.1.

       -x, --exclude=WILDCARD
	      Exclude  files  and directories matching WILDCARD (note that this means shell style
	      wildcards, not regular expression like those of grep).
	      You can repeat this option as often as you want. You can intermix it  with  the  -i
	      option.
	      See IN/EXCLUDE, below, for more information.

	      This option was added in version 0.3.0.

       -i, --include=WILDCARD
	      Include  files  and  directories	matching  WILDCARD. You can repeat this option as
	      often as you want. You can intermix it with the -x option.
	      See IN/EXCLUDE, below, for more information.

	      This option was added in version 0.3.0.

       --ignore-size
	      Do not compare file sizes when checking the remote file has to be downloaded.

	      This option was added in version 0.4.4.

       --ignore-time
	      Do not compare file modification times when checking the	remote	file  has  to  be
	      downloaded.  This  option  may be combined with --ignore-size, in which case a file
	      will never be downloaded regardless of changes in file size or  modification  time.
	      In other words: ftpcopy will not download any updates.

	      This option was added in version 0.4.4.

       --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.   The
	      default is 2^32-1, meaning enter all.

	      This option was added in version 0.5.2.

   Deletion options
       -n, --no-delete
	      Do  not  delete  files.  This  influences the cleanup step at the end, when ftpcopy
	      removes files not found on the server. It doesn't stop ftpcopy from deleting  files
	      when it detects something in it's way during a download.

       -m, --max-deletes=COUNT
	      Do not delete more then COUNT files.  This option may be useful to limit the impact
	      of a tempoary loss of files on the server.  The default is  0,  meaning  unlimited.
	      This, too, only influences the cleanup step.

	      This option was added in version 0.4.5.

   Operational options
       -d, --directories-only
	      Only  create the directory hierarchie, do not download files.  Any file in the tree
	      will be deleted unless the -n option is also given. Note: if the -s option is  also
	      given  then  even  symbolic  links  to files will be created (without the files, of
	      course).

       --dry-run
	      Do not copy or delete files: Only show what would be done.

	      This option was added in version 0.3.6.

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

       --rate-limit BYTES_PER_SECOND
	      Limit the transfer rate of file downloads to about that many bytes per seconds. The
	      implementation is crude and simple, by sleeping up to one  second  between  network
	      reads, and therefore does not even try to limit the rate exactly to that number. On
	      the other hand it usually  works	and  is  unlikely  to  break  things  by  causing
	      timeouts.

	      This option was added in version 0.4.7.

       --interactive
	      This  option tells ftpcopy to ignore any directories given on the command line, and
	      to read commands from the standard input. Each command consists of two  lines,  the
	      first being a directory on the remote server, and the second a local directory.

	      ftpcopy will print an END-OF-COPY line after each operation.

	      This option was added in version 0.3.6.

   Workaround options
       or "things you may need in a less than perfect world":

       --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 (outside this manual page this usually comes on one
	      line):

		ftpcopy: fatal: received unwanted answer to LIST:
		426 Data connection: Illegal seek.

	      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
	      ftpcopy does not cope well with recursive directory listings.

	      This option was added in version 0.3.0.

       -s, --symlink-hack
	      Deal with symbolic links. This is only useful to mirror sites which create listings
	      through /bin/ls. This will fail if a file  name  in  a  link  contains  a  `  ->	'
	      sequence.

       --force-select
	      Do  not  use the poll() system call even if it's available, but use select().  This
	      allows ftpcopy 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.

       --mdtm
	      Use the MDTM FTP command to determine file modification time.

	      The  default is to take the times from the directory listings. This doesn't work if
	      the server implements an inferior listing format (most do) and  doesn't  send  time
	      stamps in universal coordinated time (UTC).

	      This  option  makes  ftpcopy  send  a  MDTM  command  for any file it might want to
	      download. The drawback is that this eats performance: ftpcopy  usually  sends  just
	      one  command  for a complete directory its traverses. With the --mdtm option it has
	      to send an additional command for any file.

	      This option was added in version 0.3.10.

       --tolower
	      Change all local file names to lower case.

	      Use this only if you are absolutely sure that the remote side doesn't  contain  any
	      files  or  directories  whose  names  collide with each other.  Otherwise this will
	      waste bandwidth.

	      This option was added in version 0.3.8.

REMOVED OPTIONS
       -R, --remove-dir

       --keep-dir
	      These options have been added in version 0.3.0 and removed  in  0.3.7.   --keep-dir
	      made  ftpcopy  keep  a local directory even if it had been replaced by a link to an
	      other directory or a file, --remove-dir did exactly the  opposite.  --keep-dir  was
	      the default for historical reasons.
	      The  current  behaviour is like that of --remove-dir: ftpcopy creates a copy of the
	      remote ftp site.

IN/EXCLUDE
       In- and exclude lists are internally mixed together, keeping the order in which they  were
       given. The list starts with an implicit `include *'.  ftpcopy honors the last match.

       The  wildcard  matching	is done against the full remote path of the file. The / character
       has no special meaning for the matching: it is treated like any other.

       Note: you have to include top level directories	of  files  or  directories  you  want  to
       include. Something like this will not work:

	   --exclude "*" --include "/w/h/e/r/e/file.c"

       You need to include /w, /w/h and so on.

EXAMPLES
   mirror cr.yp.to
	    ftpcopy  \
	    --exclude '*.cdb'  \
	    --exclude '*software/precompiled*' \
	    cr.yp.to / /private/file/0/mirror/cr.yp.to

       This means:

       *

	   i'm not interested in .cdb files.

       *

	   precompiled stuff is also not downloaded.

       *

	   the host to connect to is cr.yp.to.

       *

	   the remote directory is /.

       *

	   and /private/file/0/mirror/cr.yp.to is the local directory.

AUTHOR
       Uwe Ohse, uwe@ohse.de

SEE ALSO
       ftpls(1), ftpcp(1).

       The homepage may be more up-to-date, see
       http://www.ohse.de/uwe/ftpcopy.html.

ftpcopy 				      0.5.2				       ftpcopy(1)


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

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password