Blame doc/repomanage.rst

Packit Service 27f74b
..
Packit Service 27f74b
  Copyright (C) 2015 Igor Gnatenko
Packit Service 27f74b
Packit Service 27f74b
  This copyrighted material is made available to anyone wishing to use,
Packit Service 27f74b
  modify, copy, or redistribute it subject to the terms and conditions of
Packit Service 27f74b
  the GNU General Public License v.2, or (at your option) any later version.
Packit Service 27f74b
  This program is distributed in the hope that it will be useful, but WITHOUT
Packit Service 27f74b
  ANY WARRANTY expressed or implied, including the implied warranties of
Packit Service 27f74b
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
Packit Service 27f74b
  Public License for more details.  You should have received a copy of the
Packit Service 27f74b
  GNU General Public License along with this program; if not, write to the
Packit Service 27f74b
  Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
Packit Service 27f74b
  02110-1301, USA.  Any Red Hat trademarks that are incorporated in the
Packit Service 27f74b
  source code or documentation are not subject to the GNU General Public
Packit Service 27f74b
  License and may only be used or replicated with the express permission of
Packit Service 27f74b
  Red Hat, Inc.
Packit Service 27f74b
Packit Service 27f74b
=====================
Packit Service 27f74b
DNF repomanage Plugin
Packit Service 27f74b
=====================
Packit Service 27f74b
Packit Service 27f74b
Manage a repository or a simple directory of rpm packages.
Packit Service 27f74b
Packit Service 27f74b
--------
Packit Service 27f74b
Synopsis
Packit Service 27f74b
--------
Packit Service 27f74b
Packit Service 27f74b
``dnf repomanage [<optional-options>] [<options>] <path>``
Packit Service 27f74b
Packit Service 27f74b
-----------
Packit Service 27f74b
Description
Packit Service 27f74b
-----------
Packit Service 27f74b
Packit Service 27f74b
`repomanage` prints newest or oldest packages in a repository specified by <path> for easy piping to xargs or similar programs. In case <path> doesn't contain a valid repository it is searched for rpm packages which are then used instead.
Packit Service 27f74b
Packit Service 27f74b
In order to work correctly with modular packages <path> has to contain repodata with modular metadata. If modular content is present `repomanage` prints packages from newest or oldest versions of each stream in addition to newest or oldest non-modular packages.
Packit Service 27f74b
Packit Service 27f74b
Packit Service 27f74b
Options
Packit Service 27f74b
-------
Packit Service 27f74b
Packit Service 27f74b
All general DNF options are accepted, see `Options` in :manpage:`dnf(8)` for details.
Packit Service 27f74b
Packit Service 27f74b
The following options set what packages are displayed. These options are mutually exclusive, i.e. only one can be specified. If no option is specified, the newest packages are shown.
Packit Service 27f74b
Packit Service 27f74b
``--old``
Packit Service 27f74b
    Show older packages.
Packit Service 27f74b
Packit Service 27f74b
``--new``
Packit Service 27f74b
    Show newest packages.
Packit Service 27f74b
Packit Service 27f74b
The following options control how packages are displayed in the output:
Packit Service 27f74b
Packit Service 27f74b
``-s``, ``--space``
Packit Service 27f74b
    Print resulting set separated by space instead of newline.
Packit Service 27f74b
Packit Service 27f74b
``-k <keep-number>``, ``--keep <keep-number>``
Packit Service 27f74b
    Limit the resulting set to newest ``<keep-number>`` packages.
Packit Service 27f74b
Packit Service 27f74b
Packit Service 27f74b
--------
Packit Service 27f74b
Examples
Packit Service 27f74b
--------
Packit Service 27f74b
Packit Service 27f74b
Display newest packages in current repository (directory)::
Packit Service 27f74b
Packit Service 27f74b
    dnf repomanage --new .
Packit Service 27f74b
Packit Service 27f74b
Display 2 newest versions of each package in "home" directory::
Packit Service 27f74b
Packit Service 27f74b
    dnf repomanage --new --keep 2 ~/
Packit Service 27f74b
Packit Service 27f74b
Display oldest packages separated by space in current repository (directory)::
Packit Service 27f74b
Packit Service 27f74b
    dnf repomanage --old --space .