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 ['6']

       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)