Extras DNF Plugins Documentation

This documents extras plugins of DNF:

DNF kickstart Plugin

Install packages according to Anaconda kickstart file.

Synopsis

dnf kickstart <ks-file>

Arguments

<ks-file>
Path to the kickstart file.

Examples

dnf kickstart mykickstart.ks
Install the packages defined in mykickstart.ks.

Extras DNF Plugins Release Notes

4.1.0 Release Notes

  • Move system-upgrade plugin to core (RhBug:2054235)

Bugs fixed in 4.1.0:

4.0.17 Release Notes

  • Translations update

Bugs fixed in 4.0.17:

4.0.15 Release Notes

  • Bug fixes: - system-upgrade: Handle empty transaction on download (RhBug:1917639)

Bugs fixed in 4.0.15:

4.0.14 Release Notes

  • [spec] Add dnf-command() provides for offline commands (RhBug:1917378)

Bugs fixed in 4.0.14:

4.0.13 Release Notes

  • system-upgrade: Use Transaction Store/Replay
  • system-upgrade: Pretty-print the state json

Bugs fixed in 4.0.13:

4.0.12 Release Notes

  • Update Cmake to pull translations from weblate
  • Drop Python 2 support
  • README: Add Installation, Contribution, etc.
  • New features: - Add the DNF_SYSTEM_UPGRADE_NO_REBOOT env variable to control system-upgrade reboot. - [system-upgrade] Upgrade groups and environments (RhBug:1845562,1860408)
  • Bug fixes: - Bugs fixed (RhBug:1863434)

Bugs fixed in 4.0.12:

4.0.10 Release Notes

  • Ensure plymouth progressbar is filled up only once (RhBug:1809096)

Bugs fixed in 4.0.10:

4.0.9 Release Notes

  • [doc] move manpages for plugins to “dnf-PLUGIN” (RhBug:1706386)
  • Add offline-upgrade and offline-distrosync commands
  • [doc] Add description for new offline command
  • Store reason for system-upgrade plugin
  • Do not show Operation aborted as an error (RhBug:1797427)

Bugs fixed in 4.0.9:

4.0.8 Release Notes

  • Set clean_requirements_on_remove=False during remove (RhBug:1764169)

Bugs fixed in 4.0.8:

4.0.7 Release Notes

  • Fix kickstart plugin
  • Enable kickstart tests for PY3

4.0.6 Release Notes

  • [system-upgrade] Use –system-upgrade plymouth mode (RhBug:1681584)
  • [system-upgrade] Fix traceback caused by setting gpgcheck options (RhBug:1751103,1746346)
  • Fix kickstart plugin (RhBug:1649093)
  • [system-upgrade] Ensure identical transaction in download and update steps (RhBug:1758588)
  • [system-upgrade] Provide distro specific url for help with system-upgrade

Bugs fixed in 4.0.6:

4.0.5 Release Notes

  • [system-upgrade] Save gpgcheck and repo_gpgcheck repo options (RhBug:1693677)
  • Add showvars plugin for showing what DNF vars are set for the dnf runtime

Bugs fixed in 4.0.5:

4.0.4 Release Notes

  • Use improved config parser that preserves order of data
  • [system-upgrade] Save module_platform_id option through system upgrade (RhBug:1656509)
  • [system-upgrade] On modular systems, system upgrade requires the next module_platform_id

Bugs fixed in 4.0.4:

4.0.2 Release Notes

Minor changes

2.0.0 Release Notes

  • Moved DEBUG plugin from dnf-plugins-extras to dnf-plugins-core
  • Moved LEAVES plugin from dnf-plugins-extras to dnf-plugins-core
  • Moved LOCAL plugin from dnf-plugins-extras to dnf-plugins-core
  • Moved MIGRATE plugin from dnf-plugins-extras to dnf-plugins-core
  • Moved NEEDS RESTARTING plugin from dnf-plugins-extras to dnf-plugins-core
  • Moved REPOCLOSURE plugin from dnf-plugins-extras to dnf-plugins-core
  • Moved REPOGRAPH plugin from dnf-plugins-extras to dnf-plugins-core
  • Moved REPOMANAGE plugin from dnf-plugins-extras to dnf-plugins-core
  • Moved SHOW LEAVES plugin from dnf-plugins-extras to dnf-plugins-core
  • Moved VERSIONLOCK plugin from dnf-plugins-extras to dnf-plugins-core

0.0.12 Release Notes

Bugfixes in local plugin. Fixes in packaging.

0.0.11 Release Notes

Bugfix in DNF kickstart Plugin packaging plugin.

0.0.7 Release Notes

Renamed orphans to leaves. Fixed some crashes in DNF tracer Plugin, migrate and local. Renamed --repoid to --repo in repoclosure and repograph. Old option saved for compatibility.

Bugs fixed in 0.0.7:

0.0.6 Release Notes

Provides migrate and orphans.

Bugs fixed in 0.0.6:

0.0.4 Release Notes

Fixes in packaging, include man pages for plugins.

0.0.3 Release Notes

Trivial fixes in packaging, few improvements for plugins, tests for plugins. Provides: local, repograph and repoclosure.

Bugs fixed in 0.0.3:

DNF rpmconf Plugin

Handles .rpmnew, .rpmsave and .rpmorig after transactions.

Configuration

/etc/dnf/plugins/rpmconf.conf

The minimal plugin configuration file should consists of [main] section with enabled parameter.:

[main]
enabled = 1

[main] section optional parameters

frontend

string, default: env

Defines which frontend should be used for merging. For list of valid frontends see rpmconf(8). When set to env, the command to use is taken from the environment variable $MERGE.

diff

boolean, default: False

Defines whether plugin should only display file differences.

See Also

rpmconf(8).

DNF showvars Plugin

Display any defined DNF variables in sorted order. This plugin takes no arguments.

Synopsis

dnf showvars

Examples

$[FrostyX  ~]-> dnf showvars
basearch=x86_64
releasever=29
$[FrostyX  ~]->

DNF snapper Plugin

Creates a pair of snapshots of root filesystem. One snapshot is created just before the transaction run (Pre). This means after a successful transaction check and successful transaction test. And another snapshot is created when the transaction has finished (Post). The user is not supposed to interact with the plugin in any way.

Warning

There is no mechanism to ensure data consistency during creating a snapshot. Files which are written at the same time as snapshot is created (eg. database files) can be corrupted or partially written in snapshot. Restoring such files will cause problems. Moreover, some system files must never be restored. Recommended is to only restore files that belong to the action you want to revert.

DNF torproxy Plugin

Description

Automatically pass all traffic in the tor network, and abort if tor is not running or blocked, to avoid any kind of identity leak.

However, if there is a specific proxy settings in the configuration, the plugin will not overwrite it, assuming that the user did set it on purpose.

Configuration

/etc/dnf/plugins/torproxy.conf

The minimal content of conf file should contain main sections with parameters enabled and strict, otherwise plugin will not work. If the strict parameter is set to True, torproxy plugin will halt DNF in the case of Tor network unavailability.:

[main]
enabled = true
strict = false

If you do not want to use the default setup of tor, ie running it on the localhost, you can also specify the port and host of the tor client in a torproxy section like this:

[torproxy]
port = 9050
host = tor.example.org

DNF tracer Plugin

Plugin

Calls tracer after every successful transaction. It finds running applications which are outdated by transaction’s packages.

There you can see DNF output with dnf-plugins-extras-tracer installed:

$[FrostyX  ~]-> sudo dnf update vim-X11
...
Running transaction
  Upgrading    : vim-common-2:7.4.179-1.fc20.i686                           1/6
  Upgrading    : vim-X11-2:7.4.179-1.fc20.i686                              2/6
  Upgrading    : vim-enhanced-2:7.4.179-1.fc20.i686                         3/6
  ...

Upgraded:
  vim-X11.i686 2:7.4.179-1.fc20           vim-common.i686 2:7.4.179-1.fc20
  vim-enhanced.i686 2:7.4.179-1.fc20

You should restart:
  gvim

Done!

It is a good idea to restart those applications, because they can be potentially dangerous. They can contain old security issues, which are fixed in new version.

Indices and tables