Blame doc/debuginfo-install.rst

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