Attachment 127879 Details for Bug 98666 – Spec: document systemd activation

[patch] Spec: document systemd activation

0007-Spec-document-systemd-activation.patch (text/plain), 2.32 KB, created by Simon McVittie on 2016-11-09 19:45:38 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2016-11-09 19:45:38 UTC

Size: 2.32 KB

patch

obsolete

>From fb7c426c6a67825d720f3a0a8d61dcb8de20860d Mon Sep 17 00:00:00 2001
>From: Simon McVittie <simon.mcvittie@collabora.co.uk>
>Date: Wed, 9 Nov 2016 17:52:48 +0000
>Subject: [PATCH 7/9] Spec: document systemd activation
>
>We didn't say that SystemdService existed. Now we do, together with
>enough context to make it make sense.
>
>Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
>---
> doc/dbus-specification.xml | 33 +++++++++++++++++++++++++++++++++
> 1 file changed, 33 insertions(+)
>
>diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
>index f50d47f..39795fe 100644
>--- a/doc/dbus-specification.xml
>+++ b/doc/dbus-specification.xml
>@@ -5148,6 +5148,39 @@
>           property on screen 0 of the display, pointing to this bus.
>         </para>
>       </sect3>
>+
>+      <sect3 id="message-bus-starting-services-systemd">
>+        <title>systemd Activation</title>
>+
>+        <para>
>+          Service description files may contain a
>+          <literal>SystemdService</literal> key. Its value is the name of a
>+          <ulink
>+            url="https://www.freedesktop.org/wiki/Software/systemd/">systemd</ulink>
>+          service, for example
>+          <literal>dbus-com.example.MyDaemon.service</literal>.
>+        </para>
>+
>+        <para>
>+          If this key is present, the bus daemon may carry out activation for
>+          this D-Bus service by sending a request to systemd asking it to
>+          start the systemd service whose name is the value of
>+          <literal>SystemdService</literal>. For example, the reference
>+          <literal>dbus-daemon</literal> has a
>+          <literal>--systemd-activation</literal> option that enables this
>+          feature, and that option is given when it is started by systemd.
>+        </para>
>+
>+        <para>
>+          On the well-known system bus, it is a common practice to set
>+          <literal>SystemdService</literal> to <literal>dbus-</literal>,
>+          followed by the well-known bus name, followed by
>+          <literal>.service</literal>, then register that name as an alias
>+          for the real systemd service. This allows D-Bus activation of a
>+          service to be enabled or disabled independently of whether the
>+          service is started by systemd during boot.
>+        </para>
>+      </sect3>
>     </sect2>
> 
>     <sect2 id="message-bus-types">
>-- 
>2.10.2
>

Actions: View | Splinter Review

Attachments on bug 98666: 127875 | 127876 | 127877 | 127878 | 127879 | 127880 | 127881 | 128111 | 128112 | 128113 | 128114 | 128115 | 128142 | 128243 | 128259

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.