summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2013-09-16 14:36:21 +0100
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2013-10-08 11:06:19 +0100
commitc2d6824232e8dbb182c9a57ec382ed8da8be5fa2 (patch)
tree7d9049c5f6966d1a624a81d35157fd166e128795 /doc
parentbe2d249f71c8469c2e6a9af425fc4192b291f341 (diff)
downloaddbus-c2d6824232e8dbb182c9a57ec382ed8da8be5fa2.tar.gz
spec: briefly describe Name, Exec and User keys
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608 Reviewed-by: Chengwei Yang <chengwei.yang@intel.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/dbus-specification.xml13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index e6e75fde..51d6cb6f 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -4662,6 +4662,11 @@
<listitem><para>Comment format</para></listitem>
</itemizedlist>
+ Service description files must contain a
+ <literal>D-BUS Service</literal> group with at least the keys
+ <literal>Name</literal> (the well-known name of the service)
+ and <literal>Exec</literal> (the command to be executed).
+
<figure>
<title>Example service description file</title>
<programlisting>
@@ -4672,6 +4677,14 @@
</programlisting>
</figure>
</para>
+
+ <para>
+ Additionally, service description files for the well-known system
+ bus on Unix must contain a <literal>User</literal> key, whose value
+ is the name of a user account (e.g. <literal>root</literal>).
+ The system service will be run as that user.
+ </para>
+
<para>
When an application asks to start a service by name, the bus daemon tries to
find a service that will own that name. It then tries to spawn the