diff options
| author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2012-02-08 16:11:35 +0000 |
|---|---|---|
| committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2012-02-08 16:11:35 +0000 |
| commit | fccb5a0fe11a2293ba5bfc09e0f3fe296d724eb2 (patch) | |
| tree | be4e98d92272324e8c1c06536b04b6ca56795f16 /doc | |
| parent | 6b01c6cdfdaae6d6847c5f5f8333867f53f0463e (diff) | |
| download | dbus-fccb5a0fe11a2293ba5bfc09e0f3fe296d724eb2.tar.gz | |
Explicitly don't search XDG_DATA_DIRS for system services, and document it
In practice, it never works, because the activation helper doesn't
respect environment variables for security reasons.
If you want to vary the search path, alter system.conf instead, to
replace or augment <standard_system_servicedirs/> with your preferred
search path.
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=21620
Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/dbus-specification.xml | 27 |
1 files changed, 26 insertions, 1 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index c051a33b..134a0e30 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -4545,7 +4545,32 @@ </footnote> </para> <para> - [FIXME specify location of system bus .service files] + On Unix systems, the system bus should default to searching + for .service files in + <literal>/usr/local/share/dbus-1/system-services</literal>, + <literal>/usr/share/dbus-1/system-services</literal> and + <literal>/lib/dbus-1/system-services</literal>, with that order + of precedence. It may also search other implementation-specific + locations, but should not vary these locations based on environment + variables. + <footnote> + <para> + The system bus is security-sensitive and is typically executed + by an init system with a clean environment. Its launch helper + process is particularly security-sensitive, and specifically + clears its own environment. + </para> + </footnote> + </para> + <para> + Software packages should install their system .service + files to their configured + <literal>${datadir}/dbus-1/system-services</literal>, + where <literal>${datadir}</literal> is as defined by the GNU + coding standards. System administrators can arrange + for these service files to be read by editing the system bus' + configuration file or by symlinking them into the default + locations. </para> </sect3> </sect2> |