Blame doc/reposync.rst

Packit 3a9065
..
Packit 3a9065
  Copyright (C) 2014  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 reposync Plugin
Packit 3a9065
====================
Packit 3a9065
Packit 3a9065
Synchronize packages of a remote DNF repository to a local directory.
Packit 3a9065
Packit 3a9065
--------
Packit 3a9065
Synopsis
Packit 3a9065
--------
Packit 3a9065
Packit 3a9065
``dnf reposync [options]``
Packit 3a9065
Packit 3a9065
-----------
Packit 3a9065
Description
Packit 3a9065
-----------
Packit 3a9065
Packit 3a9065
`reposync` makes local copies of remote repositories. Packages that are already present in the local directory are not downloaded again.
Packit 3a9065
Packit 3a9065
-------
Packit 3a9065
Options
Packit 3a9065
-------
Packit 3a9065
Packit 3a9065
All general DNF options are accepted. Namely, the ``--repoid`` option can be used to specify the repositories to synchronize. See `Options` in :manpage:`dnf(8)` for details.
Packit 3a9065
Packit Service ac1dc2
``-a <architecture>, --arch=<architecture>``
Packit Service ac1dc2
    Download only packages of given architectures (default is all architectures). Can be used multiple times.
Packit Service ac1dc2
Packit Service ac1dc2
``--delete``
Packit Service ac1dc2
    Delete local packages no longer present in repository.
Packit 3a9065
Packit 3a9065
``--download-metadata``
Packit 3a9065
    Download all repository metadata. Downloaded copy is instantly usable as a repository, no need to run createrepo_c on it.
Packit 3a9065
Packit Service ac1dc2
``-g, --gpgcheck``
Packit Service ac1dc2
    Remove packages that fail GPG signature checking after downloading. Exit code is ``1`` if at least one package was removed.
Packit Service ac1dc2
    Note that for repositories with ``gpgcheck=0`` set in their configuration the GPG signature is not checked even with this option used.
Packit 3a9065
Packit 3a9065
``-m, --downloadcomps``
Packit 3a9065
    Also download and uncompress comps.xml. Consider using ``--download-metadata`` option which will download all available repository metadata.
Packit 3a9065
Packit Service ac1dc2
``--metadata-path``
Packit Service ac1dc2
    Root path under which the downloaded metadata are stored. It defaults to ``--download-path`` value if not given.
Packit Service ac1dc2
Packit 3a9065
``-n, --newest-only``
Packit 3a9065
    Download only newest packages per-repo.
Packit 3a9065
Packit Service ac1dc2
``--norepopath``
Packit Service ac1dc2
    Don't add the reponame to the download path. Can only be used when syncing a single repository (default is to add the reponame).
Packit 3a9065
Packit Service ac1dc2
``-p <download-path>, --download-path=<download-path>``
Packit Service ac1dc2
    Root path under which the downloaded repositories are stored, relative to the current working directory. Defaults to the current working directory. Every downloaded repository has a subdirectory named after its ID under this path.
Packit 3a9065
Packit 3a9065
``--remote-time``
Packit 3a9065
    Try to set the timestamps of the downloaded files to those on the remote side.
Packit 3a9065
Packit Service ac1dc2
``--source``
Packit Service ac1dc2
    Operate on source packages.
Packit Service ac1dc2
Packit 3a9065
``-u, --urls``
Packit 3a9065
    Just print urls of what would be downloaded, don't download.
Packit 3a9065
Packit 3a9065
Packit 3a9065
--------
Packit 3a9065
Examples
Packit 3a9065
--------
Packit 3a9065
Packit 3a9065
``dnf reposync --repoid=the_repo``
Packit 3a9065
    Synchronize all packages from the repository with id "the_repo". The synchronized copy is saved in "the_repo" subdirectory of the current working directory.
Packit 3a9065
Packit 3a9065
``dnf reposync -p /my/repos/path --repoid=the_repo``
Packit 3a9065
    Synchronize all packages from the repository with id "the_repo". In this case files are saved in "/my/repos/path/the_repo" directory.
Packit 3a9065
Packit 3a9065
``dnf reposync --repoid=the_repo --download-metadata``
Packit 3a9065
    Synchronize all packages and metadata from "the_repo" repository.
Packit 3a9065
Packit 3a9065
Repository synchronized with ``--download-metadata`` option can be directly used in DNF for example by using ``--repofrompath`` option:
Packit 3a9065
Packit 3a9065
``dnf --repofrompath=syncedrepo,the_repo --repoid=syncedrepo list --available``
Packit 3a9065
Packit 3a9065
Packit 3a9065
--------
Packit 3a9065
See Also
Packit 3a9065
--------
Packit 3a9065
Packit 3a9065
* :manpage:`dnf(8)`, DNF Command Reference