Blame doc/repodiff.rst

Packit 3a9065
..
Packit 3a9065
  Copyright (C) 2018 Red Hat, Inc.
Packit 3a9065
Packit 3a9065
  This copyrighted material is made available to anyone wishing to use,
Packit 3a9065
  modify, copy, or redistribute it subject to the terms and conditions of
Packit 3a9065
  the GNU General Public License v.2, or (at your option) any later version.
Packit 3a9065
  This program is distributed in the hope that it will be useful, but WITHOUT
Packit 3a9065
  ANY WARRANTY expressed or implied, including the implied warranties of
Packit 3a9065
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
Packit 3a9065
  Public License for more details.  You should have received a copy of the
Packit 3a9065
  GNU General Public License along with this program; if not, write to the
Packit 3a9065
  Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
Packit 3a9065
  02110-1301, USA.  Any Red Hat trademarks that are incorporated in the
Packit 3a9065
  source code or documentation are not subject to the GNU General Public
Packit 3a9065
  License and may only be used or replicated with the express permission of
Packit 3a9065
  Red Hat, Inc.
Packit 3a9065
Packit 3a9065
======================
Packit 3a9065
DNF repodiff Plugin
Packit 3a9065
======================
Packit 3a9065
Packit 3a9065
Display a list of differences between two or more repositories
Packit 3a9065
Packit 3a9065
--------
Packit 3a9065
Synopsis
Packit 3a9065
--------
Packit 3a9065
Packit 3a9065
``dnf repodiff [<options>]``
Packit 3a9065
Packit 3a9065
-----------
Packit 3a9065
Description
Packit 3a9065
-----------
Packit 3a9065
Packit 3a9065
`repodiff` is a program which will list differences between two sets of repositories.  Note that by default only source packages are compared.
Packit 3a9065
Packit 3a9065
Packit 3a9065
Options
Packit 3a9065
-------
Packit 3a9065
Packit 3a9065
All general DNF options are accepted, see `Options` in :manpage:`dnf(8)` for details.
Packit 3a9065
Packit 3a9065
``--repo-old=<repoid>, -o <repoid>``
Packit 3a9065
    Add a ``<repoid>`` as an old repository. It is possible to be used in conjunction with ``--repofrompath`` option. Can be specified multiple times. 
Packit 3a9065
Packit 3a9065
``--repo-new=<repoid>, -n <repoid>``
Packit 3a9065
    Add a ``<repoid>`` as a new repository. Can be specified multiple times.
Packit 3a9065
Packit 3a9065
``--archlist=<arch>, -a <arch>``
Packit 3a9065
    Add architectures to change the default from just comparing source packages. Note that you can use a wildcard "*" for all architectures. Can be specified multiple times.
Packit 3a9065
Packit 3a9065
``--size, -s``
Packit 3a9065
    Output additional data about the size of the changes.
Packit 3a9065
Packit 3a9065
``--compare-arch``
Packit 3a9065
    Normally packages are just compared based on their name, this flag makes the comparison also use the arch. So foo.noarch and foo.x86_64 are considered to be a different packages.
Packit 3a9065
Packit 3a9065
``--simple``
Packit 3a9065
    Output a simple one line message for modified packages.
Packit 3a9065
Packit 3a9065
``--downgrade``
Packit 3a9065
    Split the data for modified packages between upgraded and downgraded packages.
Packit 3a9065
Packit 3a9065
Packit 3a9065
--------
Packit 3a9065
Examples
Packit 3a9065
--------
Packit 3a9065
Packit 3a9065
Compare source pkgs in two local repos::
Packit 3a9065
Packit 3a9065
    dnf repodiff --repofrompath=o,/tmp/repo-old --repofrompath=n,/tmp/repo-new --repo-old=o --repo-new=n
Packit 3a9065
Packit 3a9065
Compare x86_64 compat. binary pkgs in two remote repos, and two local one::
Packit 3a9065
Packit 3a9065
    dnf repodiff --repofrompath=o,http://example.com/repo-old --repofrompath=n,http://example.com/repo-new --repo-old=o --repo-new=n --archlist=x86_64
Packit 3a9065
Packit 3a9065
Compare x86_64 compat. binary pkgs, but also compare architecture::
Packit 3a9065
Packit 3a9065
    dnf repodiff --repofrompath=o,http://example.com/repo-old --repofrompath=n,http://example.com/repo-new --repo-old=o --repo-new=n --archlist=x86_64 --compare-arch
Packit 3a9065
Packit 3a9065