FTPMIRROR(8)

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