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 x86_64 port of Fedora 39 into
       the directory ~/my-mirrors/fedora:

              rpmmirror --ports=x86_64 --releases=39 \
                  --layout="<release>/Everything/<port>" \
                  https://ftp-stud.hs-esslingen.de/pub/Mirrors/archive.fedoraproject.org/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=x86_64 --releases=39 \
                  --layout="<release>/Everything/<port>/os" \
                  https://ftp-stud.hs-esslingen.de/pub/Mirrors/archive.fedoraproject.org/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 ADE_APP_TOKEN_RELEASE_ID of rpmmir-
       ror.

SEE ALSO
       debmirror(1), rsync(1), wget(1), yum(8)

AUTHOR
       ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>

COPYRIGHT & DISTRIBUTION POLICY
       Copyright (C) 2013-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME

       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.



                        ADE_APP_TOKEN_RELEASE_DATE_MAN            RPMMIRROR(1)