Blame doc/debuginfo-install.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 debuginfo-install Plugin
Packit 3a9065
============================
Packit 3a9065
Packit 3a9065
Install the associated debuginfo packages for a given package specification.
Packit 3a9065
Packit 3a9065
--------
Packit 3a9065
Synopsis
Packit 3a9065
--------
Packit 3a9065
Packit 3a9065
``dnf debuginfo-install <pkg-spec>...``
Packit 3a9065
Packit 3a9065
---------
Packit 3a9065
Arguments
Packit 3a9065
---------
Packit 3a9065
Packit 3a9065
``<pkg-spec>``
Packit 3a9065
    The package to install the associated debuginfo package for.
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
-------------
Packit 3a9065
Configuration
Packit 3a9065
-------------
Packit 3a9065
Packit 3a9065
``/etc/dnf/plugins/debuginfo-install.conf``
Packit 3a9065
Packit 3a9065
The minimal content of conf file should contain ``main`` sections with ``enabled`` and
Packit 3a9065
``autoupdate`` parameter.
Packit 3a9065
Packit 3a9065
``autoupdate``
Packit 3a9065
    A boolean option which controls updates of debuginfo packages. If options is enabled
Packit 3a9065
    and there are debuginfo packages installed it automatically enables all configured
Packit 3a9065
    debuginfo repositories.
Packit 3a9065
    (Disabled by default.)
Packit 3a9065
Packit 3a9065
--------
Packit 3a9065
Examples
Packit 3a9065
--------
Packit 3a9065
Packit 3a9065
``dnf debuginfo-install foobar``
Packit 3a9065
    Install the debuginfo packages for the foobar package.
Packit 3a9065
Packit 3a9065
``dnf upgrade --enablerepo=*-debuginfo <package-name>-debuginfo``
Packit 3a9065
    Upgrade debuginfo package of a <package-name>.
Packit 3a9065
Packit 3a9065
``dnf upgrade --enablerepo=*-debuginfo "*-debuginfo"``
Packit 3a9065
    Upgrade all debuginfo packages.