DragonFly On-Line Manual Pages
MM(1L) MM(1L)
NAME
mm - mirror master
SYNOPSIS
mm [flags] [package-files]
DESCRIPTION
mm is the mirror master. It runs multiple calls to mirror in parallel
and handles locking and minimal retry times.
As with mirror, mm is a package written in Perl.
mm presumes that all the package details are stored in a directory
called packages. All the packages for a given site must be in a file
whose name is the same as that of the site. So in
packages/sunsite.org.uk will be all the package details for the host
sunsite.org.uk.
OPTIONS
-t Ignore the minimal retry timers.
-o site:package
Only mirror the given site:package.
-debug Enable debugging. If this argument is given more than once the
debugging level will increase. Currently the maximum useful
level is four.
-s Enable status debugging. This will print out the status of any
subprocess as it is spawned or as it exits.
CONFIGURATION FILE
The configuration file is parsed as a series of statements. Blank
lines and lines beginning with a hash are ignored. There are are two
kinds of statements, controls and site:package details.
Control statements are of the form:
keyword=value
You can add whitespace around the equals.
Here is a list of the keywords and their values, any defaults are given
inside square brackets:
home Directory that mm chdirs to before doing any work.
max Maximum number of mirrors that can be running in
parallel at any one time
mirror This is the way to call mirror. Any occurence of $args,
$package or $site is replace with the appropriate entry
from the package. Any $pkg is replaced with a version of
$package with all characters that cause problems in
filenames converted to underscore. The default is: exec
./mirror \$args -p'\$package' packages/\$site >
logs/\$site:\$pkg 2>&1
cmd Run the given command. This can occur multiple times.
cmdin Run the given command and use its output as mm input.
This can occur multiple times.
skip Skip the given site:package when it occurs.
In addition to control statements there are also package details. Each
package details statement is of the form:
site:package min-restart-last-ok min-restart-last-notok mirror-args
The site and package fields are matched against those in the packages.
A mirror will only be run to this site:package if the last mirror run
was more than min hours out. The min-restart-last-ok limit will be
used if the last call to mirror was successful. If the mirror call
failed then min-restart-last-notok will be used.
EXAMPLES
Here is a simple mm input file to manage mirroring two packages.
home=/public/mirror
ftp.cl.cam.ac.uk:JIPS-nrs 20 20
hcrl.open.ac.uk:hcrl-psion 20 20
More usually the auxilly program pkgs_to_mmin will be used to
automatically convert the contents of the packages directory into the
site:package statements.
home=/public/mirror
cmdin=./pkgs_to_mmin packages/*
AUTHOR
Written by Lee McLoughlin <lmjm@icparc.ic.ac.uk>.
21 April 1993 MM(1L)