GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MIRROR-MASTER (1)

NAME

mm - mirror master

CONTENTS

Synopsis
Description
Options
Configuration File
Examples
Author

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
max
  Maximum
mirror
  This $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
cmdin Run
skip Skip
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>.
Search for    or go to Top of page |  Section 1 |  Main Index


--> MM (1L) 21 April 1993

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.