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)
Check Out this Related Man Page
MADISON-LITE(1) Debian General Commands Manual MADISON-LITE(1)NAME
madison-lite -- display versions of Debian packages in an archive
SYNOPSIS
madison-lite [--config-file file] [--mirror directory] [--nocache] [--update] [-S] [-r] [-a architecture[,...]] [-c component[,...]]
[-s suite[,...]] package [...]
DESCRIPTION
madison-lite inspects a local Debian package archive and displays the versions of the given packages found in each suite (for example,
stable, testing, or unstable) in a brief but easily human-readable form. It aims to be a drop-in replacement for the madison utility (since
renamed to dak ls), from the dak archive management suite that runs on the central Debian archive systems, but one which can run without
access to the archive's SQL database.
The following options are available:
--config-file file
Read configuration from file, and ignore the system configuration file (see CONFIGURATION below).
--mirror directory
Quick configuration: use directory as the top level of the Debian mirror.
--nocache
Normally, parts of the Packages and Sources files in the archive are cached in ~/.madison-lite/cache for speed. This option disables
that behaviour.
--update
Force caches of Packages and Sources files to be updated.
-S, --source-and-binary
Interpret package as a source package name, and display versions of any associated binary packages as well as of the source package.
-r, --regex
Interpret package as a Perl regular expression anchored at the start of the package name rather than as an exact name. Make sure to
quote any shell metacharacters such as '*' or '?' if necessary.
-a, --architecture architecture[,...]
Display only entries for packages built for these architectures. Separate multiple architectures with commas or spaces.
-c, --component component[,...]
Display only entries in the given components. Separate multiple components with commas or spaces.
-s, --suite suite[,...]
Display only entries in the given suites. Separate multiple suites with commas or spaces.
CONFIGURATION
madison-lite reads configuration information from the file named by --config-file, or, if that is not supplied, from the first of
~/.madison-lite/config and /etc/madison-lite/config that exists.
The following configuration directives are recognized:
mirror directory
Set the top-level directory of the local Debian mirror. Relative directories in the suite directive are interpreted relative to this
directory. Defaults to the current directory.
suite name directory [component [...]]
Defines the suite name based at directory, containing the specified components (defaulting to all subdirectories of directory). Output
is displayed following the order of suite directives in the configuration file. If no suite directives are present, then every subdi-
rectory of the dists directory under mirror is treated as a suite, with all of their subdirectories as components.
The Debian archive is structured such that the subdirectories of each suite directory identify components (such as main). Each of
those in turn has subdirectories for each architecture (binary-i386, and so on), each of which contains any or all of Packages,
Packages.gz, and Packages.bz2 files listing binary packages; it also has a subdirectory called source which contains any or all of
Sources, Sources.gz, and Sources.bz2 files listing source packages.
The configuration file may contain comment lines, which start with a '#' character.
EXAMPLES
Show versions of the coreutils package:
$ madison-lite coreutils
Show versions of all binary packages on powerpc produced by the glibc source package:
$ madison-lite -S -a powerpc glibc
Show versions of all packages in the unstable suite whose names begin with 'man':
$ madison-lite -s unstable -r 'man.*'
An example configuration file for a simple local mirror:
mirror /mirror/debian
suite unstable dists/unstable main
suite unstable-non-US non-US/dists/unstable non-US/main
SEE ALSO dpkg-scanpackages(8), dpkg-scansources(8), apt-ftparchive(1)AUTHORS
madison-lite was written by Colin Watson <cjwatson@debian.org>. The interface mirrors that of madison (since renamed to dak ls), written by
James Troup.
Debian August 1, 2007 Debian