diff options
author | Sean Whitton <spwhitton@spwhitton.name> | 2019-07-21 19:15:53 +0100 |
---|---|---|
committer | Sean Whitton <spwhitton@spwhitton.name> | 2019-07-21 19:15:53 +0100 |
commit | 812d6bafde17704864b4df138710e7977a50b7d6 (patch) | |
tree | 8b81c270c198532b5d762face1f1e6b3f5f4c1bb | |
parent | 4f2f46a2482b81921f1248bae912a013fd0f691c (diff) |
Policy: Document /run/reboot-required mechanism
Wording: Karl O. Pinc <kop@meme.com>
Seconded: Sean Whitton <spwhitton@spwhitton.name>
Seconded: Holger Levsen <holger@layer-acht.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Simon McVittie <smcv@debian.org>
Closes: #919507
-rw-r--r-- | debian/changelog | 7 | ||||
-rw-r--r-- | policy/ch-opersys.rst | 30 |
2 files changed, 37 insertions, 0 deletions
diff --git a/debian/changelog b/debian/changelog index 60cddce..41b2e76 100644 --- a/debian/changelog +++ b/debian/changelog @@ -5,6 +5,13 @@ debian-policy (4.4.1.0) UNRELEASED; urgency=medium Seconded: Sean Whitton <spwhitton@spwhitton.name> Seconded: Guillem Jover <guillem@debian.org> Closes: #931975 + * Policy: Document /run/reboot-required mechanism + Wording: Karl O. Pinc <kop@meme.com> + Seconded: Sean Whitton <spwhitton@spwhitton.name> + Seconded: Holger Levsen <holger@layer-acht.org> + Seconded: Russ Allbery <rra@debian.org> + Seconded: Simon McVittie <smcv@debian.org> + Closes: #919507 -- Sean Whitton <spwhitton@spwhitton.name> Mon, 15 Jul 2019 19:02:20 +0100 diff --git a/policy/ch-opersys.rst b/policy/ch-opersys.rst index 6e0c020..15ed6dc 100644 --- a/policy/ch-opersys.rst +++ b/policy/ch-opersys.rst @@ -1040,3 +1040,33 @@ Debian, so this section has been removed. activate the trigger. In that case, it can be done by calling ``dpkg-trigger --no-await /usr/lib/mime/packages`` from the maintainer script after creating, modifying, or removing the file. + +.. index:: + pair: signaling; reboot + +.. _s-signalingreboot + +Signaling that a reboot is required +----------------------------------- + +.. index:: + single: reboot-required + single: reboot-required.pkgs + +Programs can signal that a reboot is required by ``touch``\ing +``/run/reboot-required``. It is conventional to add the name of the +package(s) requiring the reboot to +``/run/reboot-required.pkgs``. Programs should not add a package name +to ``/run/reboot-required.pkgs`` if it is already present there. + +.. index: + single: postinst + +The ``/run/reboot-required`` mechanism is used when a reboot is +needed to fully apply the changes introduced by package +installation or upgrade. Typically it is the ``postinst`` +maintainer script that touches ``/run/reboot-required``, at the end +of a successful configuration of the package. + +There are no guarantees provided by the ``/var/reboot-required`` +convention as to when or whether the requested reboot will occur. |