fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2026-05-04 12:58:02 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

spec: recommend searching for system-services in /etc/ and /run/

Browse source 
This is useful when an asset manager wants to install a system
service while /usr/ is read-only (e.g.: portable services running
on a different namespaced image). Also recommend searching in /run/
following the now-standard pattern, for ephemeral services.

Signed-off-by: Luca Boccassi <bluca@debian.org>
This commit is contained in:
Luca Boccassi 2024-09-13 19:41:32 +02:00
parent 776e6e0b04
commit 25a0890023
1 changed files with 11 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
doc/dbus-specification.xml
View file

@ -5373,8 +5373,10 @@
If two .service files in different directories offer the same
service name, the one in the higher-priority directory is used:
for instance, on the system bus, .service files in
/usr/local/share/dbus-1/system-services take precedence over those
in /usr/share/dbus-1/system-services.
/etc/dbus-1/system-services takes precedence over those in
/run/dbus-1/system-services, which in turn take precedence over
those in /usr/local/share/dbus-1/system-services, which in turn take
precedence over those in /usr/share/dbus-1/system-services.
</para>
<para>
The executable launched will have the environment variable
@ -5829,12 +5831,19 @@
<para>
On Unix systems, the system bus should default to searching
for .service files in
<literal>/etc/dbus-1/system-services</literal>,
<literal>/run/dbus-1/system-services</literal>,
<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.
The directory in <literal>/etc/</literal> is reserved for use by
either the local system administrator,
or an asset manager deploying services that are not part of the OS.
The directory in <literal>/run/</literal> is reserved for ephemeral
services that will disappear after a reboot.
<footnote>
<para>
The system bus is security-sensitive and is typically executed