.\" $HeadURL$ $LastChangedRevision$
.\" vim: filetype=nroff
.\"
.TH RPMMIRROR 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.SH NAME
rpmmirror - partial mirror script for RPM repositories with \%http://, \%rsync:// and \%file:// support
.br
.ne 5
.SH SYNOPSIS
.B rpmirror
\*[ade_standard_synopsis_component]
.B --ports=\fIport\fR[\fB,\fR...]
.B --releases=\fIrelease\fR[\fB,\fR...]
.B --layout=\fIlayout
.I src-url
.I dst-dir
.br
.ne 5
.SH DESCRIPTION
.B Rpmmirror
is a simple tool to mirror sections of RPM repositories. It takes two arguments: the URL of the source from which to download
(e.g.
.B \%http://ftp.tu-chemnitz.de/pub/linux/fedora-epel/\fR)
and the directory into which to download to (e.g.
.B ~/my-mirrors/epel/\fR). 
Note that the three options
.B --ports\fR,
.B --releases
and
.B --layout
are not optional.
.br
.ne 5
.SH CONFIGURATION
None.
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.TP
.B --ports=\fIport\fB,\fR...
Specifies a comma-separated list of ports (i.e. CPU architectures) to download.
.TP
.B --releases=\fIreleases\fB,\fR...
Specifies a comma-separated list of releases to download.
.TP
.B --layout=\fIlayout\fR
Specifies the internal structure of the repository, i.e. how to get from 
.I src-url
to the directory containing the release- and architecture-specific files. Normally, this is one or two levels above where the 
.B repoview
(see 
.B yum\fR(8))
directory is to be found.
.I layout
may contain 
.B <port>
or 
.B <release>\fR, 
which will be replaced by the values specified in the 
.B --ports
and 
.B --releases
options respectively. Different repositories have different internal structures; see \[oq]EXAMPLES\[cq]
below.
.br
.ne 5
.SH EXIT STATUS
On success
.B rpmmirror
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
None.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
None.
.br
.ne 5
.SH EXAMPLES
The following command would mirror the i386 and x86_64 ports of Fedora 17 into the directory ~/my-mirrors/fedora:
.IP
.nf
.fam C
.B rpmmirror --ports=i386,x86_64 --releases=17 \[rs]
.B \ \ \ \ --layout=\[dq]<release>/Fedora/<port>\[dq] \[rs]
.B \ \ \ \ http://ftp.crc.dk/fedora/linux/releases/ ~/my-mirrors/fedora
.fam T
.fi
.br
.PP
If you want to mirror only the packages and not debug-enabled packages and ISOs, then you can extend the layout a little deeper into the directory hierarchy to where the
.B repoview
directory can be found):
.IP
.nf
.fam C
.B rpmmirror --ports=i386,x86_64 --releases=17 \[rs]
.B \ \ \ \ --layout=\[dq]<release>/Fedora/<port>/os\[dq] \[rs]
.B \ \ \ \ http://ftp.crc.dk/fedora/linux/releases/ ~/my-mirrors/fedora
.fam T
.fi
.br
.PP
The following command would mirror the i386 and x86_64 ports of Centos 6, 6.1, 6.2 and 6.3 into the directory ~/my-mirrors/centos:
.IP
.nf
.fam C
.B rpmmirror --ports=i386,x86_64 --releases=6,6.1,6.2,6.3 \[rs]
.B \ \ \ \ --layout=\[dq]<release>/os/<port>\[dq] \[rs]
.B \ \ \ \ http://mirror.euserv.net/linux/centos/ ~/my-mirrors/centos
.fam T
.fi
.PP
The following command would mirror the i386 and x86_64 ports of ScientificLinux 6, 6.1, 6.2 and 6.3 into the directory ~/my-mirrors/sl:
.IP
.nf
.fam C
.B rpmmirror --ports=i386,x86_64 --releases=6,6.1,6.2,6.3 \[rs]
.B \ \ \ \ --layout=\[dq]<release>/<port>/os\[dq] \[rs]
.B \ \ \ \ http://ftp.scientificlinux.org/linux/scientific/ ~/my-mirrors/sl
.fam T
.fi
.br
.PP
The following command would mirror the i386 and x86_64 ports of EPEL 4, 5 and 6 into the directory ~/my-mirrors/epel:
.IP
.nf
.fam C
.B rpmmirror --ports=i386,x86_64 --releases=4,5,6 \[rs]
.B \ \ \ \ --layout=\[dq]<release>/<port>\[dq] \[rs]
.B \ \ \ \ http://mirrors.n-ix.net/fedora-epel/ ~/my-mirrors/epel
.fam T
.fi
.ne 5
.SH CAVEATS
The term \[oq]port\[cq] is what Debian calls architectures.
.PP
Since 
.I layout 
normally contains the characters \[oq]<\[cq] and \[oq]>\[cq], it should be quoted to prevent the 
shell from interpreting these characters, as in the examples above.
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B rpmmirror\fR.
.br
.ne 5
.SH SEE ALSO
debmirror(1), rsync(1), wget(1), yum(8)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2013-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
\*[ade_standard_copyright_component]