Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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/sun-
       site.org.uk  will  be  all  the	package	 details  for  the  host  sun-
       site.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 de-
	      tails.

       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	paral-
		      lel 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 automati-
       cally   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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mirror-master&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help