Blame doc/rpm-plugin-systemd-inhibit.8

2ff057
.TH "RPM-SYSTEMD-INHIBIT" "8" "14 Apr 2016" "Red Hat, Inc."
2ff057
.SH NAME
2ff057
rpm-plugin-systemd-inhibit \- Plugin for the RPM Package Manager
2ff057
2ff057
.SH Description
2ff057
2ff057
This plugin for RPM prevents the system to enter shutdown, sleep or idle
2ff057
mode while there is a rpm transaction running to prevent system corruption
2ff057
that can occur if the transaction is interrupted by a reboot.
2ff057
2ff057
This is achieved by using the inhibit DBUS interface of systemd. The call is
2ff057
roughly equivalent to executing
2ff057
2ff057
\fBsystemd-inhibit --mode=block --what=idle:sleep:shutdown --who=RPM --why="Transaction running"\fR
2ff057
2ff057
See \fBsystemd-inhibit(1)\fR for the details of this mechanism.
2ff057
2ff057
It is strongly advised to have the plugin installed on all systemd
2ff057
based systems.
2ff057
2ff057
.SH Prerequisites
2ff057
2ff057
For the plugin to work systemd has to be used as init system and
2ff057
though the DBUS system bus must be available. If the plugin cannot access the
2ff057
interface it gives a warning but does not stop the transaction.
2ff057
2ff057
.SH Configuration
2ff057
2ff057
The plugin currently does not have any configuration option other than
2ff057
turning it on and off. It can be disabled by commenting out the
2ff057
\fI%__transaction_systemd_inhibit\fR macro in main macros file
2ff057
(typically located at \fI/usr/lib/rpm/macros\fR) or otherwise change
2ff057
the value of the macro.
2ff057
2ff057
Another option is to remove the plugin from the system if it is
2ff057
packaged in its own sub package.