NAME¶
ftpmirror - Mirroring directory hierarchy using FTP protocol
SYNOPSIS¶
ftpmirror [
package]
DESCRIPTION¶
ftpmirror is an utility to copy directory hierarchy (usually called
'mirror') using FTP protocol.
A similar perl script exists, whose name is 'mirror', but ftpmirror requires
less memory than mirror.
OPTIONS¶
Please, note that the original documentation about
ftpmirror was written
originally in japanese. (README.jis and RELEASE.jis)
If you can contribute by translating any aspect of these files, please contact
Dario Minnucci <debian@midworld.net>. I'll be glad to include your
contributions here to improve this manual.
Formerly ftpmirror operatio mode was MASTER->SLAVE but seems that since
version 1.96 the SLAVE->MASTER (reverse mirror) is supported.
This behaviour can be controlled for each package section in the main
configuration file (/etc/ftpmirror/ftpmirror.cf).
MASTER->SLAVE --> get-mode = yes (default)
SLAVE->MASTER --> put-mode = yes
Other configuration flags extracted from original documentation are: (Sorry but
most of them are still undocummented.)
- todo:
- (string, default: full-mirror)
- verbose:
- (boolean, default: no)
- log-mask:
- (comma separated list)
- test-mode:
- (boolean, default: no)
- ftp-server:
- (string)
- ftp-gateway:
- (string)
- ftp-port:
- (service, default: ftp)
- ftp-bindaddr:
- (ip address)
- ftp-user:
- (string, default: anonymous)
- ftp-pass:
- (string, default: `whoami`@`hostname`)
- ftp-group:
- (string)
- ftp-gpass:
- (string)
- ftp-passive:
- (boolean, default: no) To enable passive file transfer set
ftp-passive to yes.
- ftp-idle:
- (numeric, default: 0)
- ftp-max-idle:
- (boolean, default: 0)
- ftp-list-method:
- (LIST or STAT or STAT-A or STAT-AT, default: STAT)
- ftp-timeout:
- (numeric, default: 300)
- ftp-login-retry:
- (numeric)
- ftp-login-delay:
- (numeric, default: 60)
- ftp-stats:
- (boolean, default: no)
- remote-timezone:
- (timezone string, default: undef)
- http-proxy:
- (string)
- server:
- (string)
- package:
- (string)
- put-mode:
- (boolean, default: no)
- unlink:
- (boolean or 'rename', default: yes)
- unlink-limit:
- (size value, default: 0)
- ftp-force-mtime:
- (boolean, default: no)
- ignore-mtime:
- (boolean, default: no)
- temp-directory:
- (pathname, default: $TMPDIR || /tmp)
- lock-directory:
- (pathname, default: temp-directory)
- create-directory:
- (boolean, default: yes)
- remote-directory:
- (string)
- local-directory:
- (pathname)
- master-db-directory:
- (pathname)
- remote-db-directory:
- (pathname)
- local-db-directory:
- (pathname)
- lslR-file:
- (string)
- lslR-copy:
- (pathname)
- transfer-file-regexp:
- (regexp)
- transfer-directory-regexp:
- (regexp)
- override-file-regexp:
- (regexp)
- override-directory-regexp:
- (regexp)
- load-local-dirinfo:
- (boolean, default: no)
- store-local-dirinfo:
- (boolean, default: no)
- load-remote-dirinfo:
- (boolean, default: no)
- override-file-uid:
- (uid, default: 0)
- override-file-gid:
- (uid, default: 0)
- override-file-mode:
- (octal value, default: 0644)
- override-directory-mode:
- (octal value, default: 0755)
- default-file-uid:
- (uid, default: 0)
- default-file-gid:
- (gid, default: 0)
- default-file-mode:
- (octal value, default: 0644)
- default-directory-mode:
- (octal value, default: 0755)
EXAMPLES¶
ftpmirror provides a 'ready-to-use' sample package for testing porpouses.
In order to run the provided test package you need to issue the following
commands (both commands must be run by the same user):
mkdir -p /tmp/upstream
/usr/bin/ftpmirror upstream
This package should copy directory hierarchy from the original author's FTP
location (
ftp://ftp.intec.co.jp/pub/utils/ftpmirror) to your local hard drive
(/tmp/upstream).
IMPORTANT CONSIDERATION¶
The inclusion of this configuration is intended to be used ocassionally. Please
don't abuse this site.
SEE ALSO¶
For other supported configuration options see /etc/ftpmirror/ftpmirror.cf where
you will find commented examples.
AUTHOR¶
ftpmirror was originally written by Ikuo Nakagawa
<ikuo@intec.co.jp>
This manual page was written by Dario Minnucci <debian@midworld.net>, for
the Debian project (but may be used by others).