.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "FTPSYNC-CRON" "1" "ftpsync Manual" "" ""
.hy
.SH NAME
.PP
ftpsync-cron - Wrapper around ftpsync for use in cron(8)
.SH SYNOPSIS
.PP
\f[B]ftpsync-cron\f[R] [\f[I]ARCHIVE\f[R]]
.SH DESCRIPTION
.PP
\f[B]ftpsync-cron\f[R] is part of the ftpsync suite for mirroring Debian
and Debian-like repositories of packages.
As there are way too many mirrors of Debian to populate them all from
the machine that generates the archive (\[lq]ftp-master\[rq]), mirrors
are organized in a tree-shaped hierarchy.
Thus, every mirror has exactly one upstream from which it syncs, and
each mirror can have any number of downstreams which in turn sync from
it.
.PP
\f[B]ftpsync-cron\f[R] is a wrapper around \f[B]ftpsync\f[R] itself,
intended to be run out of cron at regular, frequent intervals, such as
hourly.
When started, it reads the corresponding \f[B]ftpsync.conf\f[R]
configuration file for the archive in question and determines this
mirror\[cq]s upstream.
It then fetches the upstream\[cq]s trace file via HTTP and compares it
to the version on disk from the last mirror run, thus learning whether
the upstream mirror has updated.
If it has, \f[B]ftpsync\f[R] is triggered.
.SH EXAMPLE
.PP
Example use in a user crontab:
.PP
SHELL=/bin/bash 31 * * * * sleep $(( RANDOM %% 1800 )) &&
\&./bin/ftpsync-cron
.SH SEE ALSO
.PP
\f[B]ftpsync\f[R](1) +
.SH AUTHORS
Debian mirror team.