NAME

       repopush - safely rsync a package repository to another location

SYNOPSIS

       repopush [-Nv] /path/to/local/repo remote

       repopush [-Nv] [-f configfile] -s section

DESCRIPTION

       The repopush tool is yet another program that helps with copying the various package files and repository
       metadata from one OS package repository to another, taking care to copy and remove files in such a way as
       to  never  have the remote repository present an inconsistent view. This is done by first copying the new
       package files, then copying the new metadata files, then removing the outdated metadata files,  and  only
       then removing the outdated package files.

       The  repopush tool supports APT and YUM repositories and figures out which one to handle by analyzing the
       contents of the local repository. This is one of the reasons why the latter must indeed be a directory on
       a locally-mounted filesystem.

       The repopush tool accepts the following command-line options:

       •   -f configfile
             If   the   -s   option   is   specified,   the   config   file   to   read.    The    default    is
           $XDG_CONFIG_HOME/repopush.conf (with a $HOME/.config default for $XDG_CONFIG_HOME).

       •   -N
             No-operation mode; display what would have been done.

       •   -s section
             The config file section to read the local and remote variables from.

       •   -v
             Verbose mode; display diagnostic output.

       There  are two ways to specify the local and remote parameters: directly on the command line or in a INI-
       style configuration file. If the -s option is specified, repopush will use the confget tool to  read  the
       configuration  file  (either  the  one  specified  by  the  -f option or a default one in the user's home
       directory), look for the specified section, and use the "local" and "remote" values from that section.

       As noted above, the local parameter should be a path to a directory. The remote parameter can be  in  any
       format that the rsync tool accepts.

FILES

       If  the local and remote parameters are specified on the command line, the operation of the repopush tool
       is not affected by any files.

       If a configuration section is specified via the -s option, repopush will look for  a  configuration  file
       (either one specified via the -f option or a default one in the user's home directory) and treat it as an
       INI-style  file  containing  one  or  more  sections.  See the documentation of the confget tool for more
       information about the supported format of the INI-style files.

EXAMPLES

       Test-run a repository update:

           repopush -Nv /var/lib/repos/infra www:/var/www/repo/infra

       Perform the actual update, a bit quieter:

           repopush /var/lib/repos/infra www:/var/www/repo/infra

       The same, but with the "to-www-infra" section specified in the $HOME/.config/repopush.conf file:

           repopush -s to-www-infra

       To achieve the above result, the repopush.conf file should contain a section like this:

           [to-www-infra]
           local=/var/lib/repos/infra
           remote=www:/var/www/repo/infra

HISTORY

       The repopush tool was first written by Peter Pentchev in 2020. This manual page was created in 2021.

AUTHORS

       Peter Pentchev <roam@ringlet.net>

                                                   2021-04-04                                        repopush(1)