Bug#919507: Reboot required patch for Debian policy
- To: "Karl O. Pinc" <kop@meme.com>
- Cc: Sean Whitton <spwhitton@spwhitton.name>, 919507@bugs.debian.org
- Subject: Bug#919507: Reboot required patch for Debian policy
- From: Russ Allbery <rra@debian.org>
- Date: Sat, 20 Jul 2019 20:27:04 -0700
- Message-id: <[🔎] 8736j0f4on.fsf@hope.eyrie.org>
- Reply-to: Russ Allbery <rra@debian.org>, 919507@bugs.debian.org
- In-reply-to: <20190120170939.0195beaf@slate.meme.com> (Karl O. Pinc's message of "Sun, 20 Jan 2019 17:09:39 -0600")
- References: <CAAfdZj-9Z=HBifjXf8mb7BS=jtOZTBff4T9N9qaievEyZUbYVQ@mail.gmail.com> <154766338180.3996.1950586396888382490.reportbug@slate.meme.com> <20190118120459.5d8a9391@slate.meme.com> <87k1j0cyda.fsf@iris.silentflame.com> <20190119173352.632fcc66@slate.meme.com> <877eezc7j6.fsf@iris.silentflame.com> <154766338180.3996.1950586396888382490.reportbug@slate.meme.com> <20190120170939.0195beaf@slate.meme.com> <154766338180.3996.1950586396888382490.reportbug@slate.meme.com>
"Karl O. Pinc" <kop@meme.com> writes:
> diff --git a/policy/ch-opersys.rst b/policy/ch-opersys.rst
> index 59c92ec..8276bfe 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.
This looks good to me as well. Seconded.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: