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).
Dario Minnucci <debian@midworld.nJu>ne 1, 2007