RPMMIRROR(1) General Commands Manual RPMMIRROR(1)
NAME
rpmmirror - partial mirror script for RPM repositories with http://,
rsync:// and file:// support
SYNOPSIS
rpmirror [ -V | --version ] [ -v | --verbose | -d level | --debug=level
] [ -h | --help ] [ -p | --paths ] [ -n | --simulate ]
--ports=port[,...] --releases=release[,...] --layout=layout src-url
dst-dir
DESCRIPTION
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.
http://ftp.tu-chemnitz.de/pub/linux/fedora-epel/) and the directory
into which to download to (e.g. ~/my-mirrors/epel/). Note that the
three options --ports, --releases and --layout are not optional.
CONFIGURATION
None.
OPTIONS
-d level, --debug=level Determines how verbose this program will be.
The message types displayed for the different
values of level are as follows: 0 displays no
messages; 1 displays only errors, 2 displays
errors and warnings; 3 displays errors, warn-
ings and informational messages; higher values
display errors, warnings, informational mes-
sages and various messages intended for debug-
ging. The default is 2.
-h, --help Displays a brief usage message.
-p, --paths Lists the compiled-in paths of various files
and directories that this program uses. -n,
--simulate Some external commands that this
program runs may be displayed rather than ac-
tually executed. BEWARE: different programs
implement different levels of simulation; so
this option may work perfectly; on the other
hand it may do nothing at all!
-v, --verbose Equivalent to -d 3.
-V, --version Prints the program's version number and exits.
--ports=port,... Specifies a comma-separated list of ports
(i.e. CPU architectures) to download.
--releases=releases,... Specifies a comma-separated list of releases
to download.
--layout=layout Specifies the internal structure of the repos-
itory, i.e. how to get from src-url to the di-
rectory containing the release- and architec-
ture-specific files. Normally, this is one or
two levels above where the repoview (see
yum(8)) directory is to be found. layout may
contain <port> or <release>, which will be re-
placed by the values specified in the --ports
and --releases options respectively. Different
repositories have different internal struc-
tures; see 'EXAMPLES' below.
EXIT STATUS
On success rpmmirror returns zero. On failure it returns non-zero and
displays a diagnostic message.
FILES
None.
ENVIRONMENT VARIABLES
None.
EXAMPLES
The following command would mirror the i386 and x86_64 ports of Fedora
17 into the directory ~/my-mirrors/fedora:
rpmmirror --ports=i386,x86_64 --releases=17 \
--layout="<release>/Fedora/<port>" \
http://ftp.crc.dk/fedora/linux/releases/ ~/my-mirrors/fedora
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 di-
rectory hierarchy to where the repoview directory can be found):
rpmmirror --ports=i386,x86_64 --releases=17 \
--layout="<release>/Fedora/<port>/os" \
http://ftp.crc.dk/fedora/linux/releases/ ~/my-mirrors/fedora
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:
rpmmirror --ports=i386,x86_64 --releases=6,6.1,6.2,6.3 \
--layout="<release>/os/<port>" \
http://mirror.euserv.net/linux/centos/ ~/my-mirrors/centos
The following command would mirror the i386 and x86_64 ports of Scien-
tificLinux 6, 6.1, 6.2 and 6.3 into the directory ~/my-mirrors/sl:
rpmmirror --ports=i386,x86_64 --releases=6,6.1,6.2,6.3 \
--layout="<release>/<port>/os" \
http://ftp.scientificlinux.org/linux/scientific/ ~/my-mirrors/sl
The following command would mirror the i386 and x86_64 ports of EPEL 4,
5 and 6 into the directory ~/my-mirrors/epel:
rpmmirror --ports=i386,x86_64 --releases=4,5,6 \
--layout="<release>/<port>" \
http://mirrors.n-ix.net/fedora-epel/ ~/my-mirrors/epel
CAVEATS
The term 'port' is what Debian calls architectures.
Since layout normally contains the characters '<' and '>', it should be
quoted to prevent the shell from interpreting these characters, as in
the examples above.
STANDARDS
This manual page documents version 4.0.1 of rpmmirror.
SEE ALSO
debmirror(1), rsync(1), wget(1), yum(8)
AUTHOR
Alexis Huxley <alexishuxley@gmail.com>
COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2013-2024 Alexis Huxley
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
27 Aug 2024 RPMMIRROR(1)
