Blame doc/download.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 download Plugin
Packit 3a9065
=====================
Packit 3a9065
Packit 3a9065
Download binary or source packages.
Packit 3a9065
Packit 3a9065
--------
Packit 3a9065
Synopsis
Packit 3a9065
--------
Packit 3a9065
Packit 3a9065
``dnf download [options] <pkg-spec>...``
Packit 3a9065
Packit 3a9065
---------
Packit 3a9065
Arguments
Packit 3a9065
---------
Packit 3a9065
Packit 3a9065
``<pkg-spec>``
Packit 3a9065
    Package specification for the package to download.
Packit 3a9065
    Local RPMs can be specified as well. This is useful with the ``--source``
Packit 3a9065
    option or if you want to download the same RPM again.
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
``--help-cmd``
Packit 3a9065
    Show this help.
Packit 3a9065
Packit 3a9065
``--arch <arch>[,<arch>...]``
Packit 3a9065
    Limit the query to packages of given architectures (default is all compatible architectures with
Packit 3a9065
    your system). To download packages with arch incompatible with your system use
Packit 3a9065
    ``--forcearch=<arch>`` option to change basearch.
Packit 3a9065
Packit 3a9065
``--source``
Packit 3a9065
    Download the source rpm. Enables source repositories of all enabled binary repositories.
Packit 3a9065
Packit 3a9065
``--debuginfo``
Packit 3a9065
    Download the debuginfo rpm. Enables debuginfo repositories of all enabled binary repositories.
Packit 3a9065
Packit 3a9065
``--downloaddir``
Packit 3a9065
    Download directory, default is the current directory (the directory must exist).
Packit 3a9065
Packit 3a9065
``--url``
Packit 3a9065
    Instead of downloading, print list of urls where the rpms can be downloaded.
Packit 3a9065
Packit 3a9065
``--urlprotocol``
Packit 3a9065
    Limit the protocol of the urls output by the --url option. Options are http, https, rsync, ftp.
Packit 3a9065
Packit 3a9065
``--resolve``
Packit 3a9065
    Resolves dependencies of specified packages and downloads missing dependencies in the system.
Packit 3a9065
Packit 3a9065
--------
Packit 3a9065
Examples
Packit 3a9065
--------
Packit 3a9065
``dnf download dnf``
Packit 3a9065
    Download the latest dnf package to the current directory.
Packit 3a9065
Packit 3a9065
``dnf download --url dnf``
Packit 3a9065
    Just print the remote location url where the dnf rpm can be downloaded from.
Packit 3a9065
Packit 3a9065
``dnf download --url --urlprotocols=https --urlprotocols=rsync dnf``
Packit 3a9065
    Same as above, but limit urls to https or rsync urls.
Packit 3a9065
Packit 3a9065
``dnf download dnf --destdir /tmp/dnl``
Packit 3a9065
    Download the latest dnf package to the /tmp/dnl directory (the directory must exist).
Packit 3a9065
Packit 3a9065
``dnf download dnf --source``
Packit 3a9065
    Download the latest dnf source package to the current directory.
Packit 3a9065
Packit 3a9065
``dnf download rpm --debuginfo``
Packit 3a9065
    Download the latest rpm-debuginfo package to the current directory.
Packit 3a9065
Packit 3a9065
``dnf download btanks --resolve``
Packit 3a9065
    Download the latest btanks package and the uninstalled dependencies to the current directory.