mirror-functions	rsync mirror() function in bash, uses gawk, lockfile, sed, stat
			Features:
			- can be run from cron or by hand,
			- locking,
			- mirrors of several packages can be defined in one script,
			- possible a saparate frequency limit for each package in the script,
			- dry run (-n option) to show the actual rsync command,
			- force running only nth mirror() in the script (e.g. -f 5), does not override locking,
			- remembers when the recent mirroring of a package took place and if it was successful (using .files in ~ directory),
			- uses ~ directory for creating an rsync filter.

linux-debian		sample rsync scripts; use -h option to see help
linux-archlinux
linux-centos

  rzm@sunsite3:/private/rzm/sunsite,1> /local/scripts/mirror/linux-debian -h
  /local/scripts/mirror/linux-debian [-h] [-f [NUM]] [-n]
  Script for mirroring rsync packages backed by mirror-functions library.
  -h              this help
  -f [NUM]        mirror even if the gap time set in the script have not passed.
                  With NUM converns only package number NUM (conting from 1)
  -n              dry run - do not execute rsync commans

  Syntax:
  # sourcing the function
  . /local/scripts/mirror/mirror-functions
  
  # before each call to the mirror() function one can set non-default
  # - rsync path (rsync=...),
  # - options (options=...),
  # - e-mail for error messages (email=...),
  # - time gap (gap=...) which limits frequency of mirroring - not sooner than gap after last successfull mirroring
  # default path is just rsync, default error messages e-mail is `whoami`, default time gap is 2 hours
  # if it is a first mirroring attempt mirror() assumes that the previous one was 100000 hours ago

  # example of "options" setting:
  options="-rtlvH --delete-after --delay-updates --safe-links --max-delete=1000 --timeout=3600"   # official? + timeout
  # changing time gap (can be done before each mirror() call
  gap=24 #h
  # actual call: mirror SOURCE_RSYNC_URL DESTINATION_DIRECTORY [FILTER...]
  # the $p variable contains our default path to all packages defined in mirror-functions file but it does not have to be used
  mirror	rsync://ftp5.gwdg.de/pub/linux/archlinux/	$p/linux-archlinux	"- **~tmp~**"

linux-debian.output	output of the script

mirrormail		simple script to use with crontab which sets a subject of the e-mail

# sample crontab entries:
51 */2		* * *	/local/scripts/mirror/linux-debian			2>&1 | ~/bin/mirrormail linux-debian
0 *		* * *	echo | awk 'END { t=55*60*rand(); system("sleep "t) }'; /local/scripts/mirror/linux-archlinux	2>&1 | ~/bin/mirrormail linux-archlinux

.