.TH mirror 1 "2024-01-01"
.SH NAME
mirror \- copies remote git repositories in bulk
.SH SYNOPSIS
.SY mirror
.RB [ -n ]
.RI [ repositories ]
.SY mirror\ -v
.YS
.SH DESCRIPTION
This script will read
.I repositories
file for paths or addresses to git repositories and clone them in a bare mirror mode or update existing mirrors as
necessary. If not provided
.I repositories
will default to
.B repositories.mirror
in the current working directory.
.P
With
.B -n
option the script will only print actions it would perform and not attempt any updates.
.P
With
.B -v
option the script will print version information to standard output and terminate immediately after.
.SH EXIT STATUS
Exit status is zero if all repositories in the list have been mirrored successfully or if
.B -v
option was used. If one or more mirrors fail or an unknown command-line option is provided, a non-zero status is
returned.
.SH SEE ALSO
.BR mirror (5),
.BR git (1)