fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2026-01-06 10:40:14 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Officially deprecate package-supplied dbus-daemon policy in ${sysconfdir}

Browse source 
Now that dbus 1.10 has become widely available, we should start to
treat ${sysconfdir} as reserved for the sysadmin, and encourage
third-party software packages to install their integration files into
${datadir}.

Signed-off-by: Simon McVittie <smcv@collabora.com>
This commit is contained in:
Simon McVittie 2018-12-19 17:27:15 +00:00
parent e1752785f3
commit dee0f55111
2 changed files with 31 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
NEWS
View file

@ -1,6 +1,21 @@
dbus 1.13.10 (UNRELEASED)
=========================
Deprecations:
• Third-party software should install default dbus policies for the system
bus into ${datadir}/dbus-1/system.d (this has been supported since dbus
1.10, released in August 2015). Installing default dbus policies in
${sysconfdir}/dbus-1/system.d is now considered to be deprecated. Policy
files in ${sysconfdir}/dbus-1/system.d continue to be read, but this
directory should only be used by system administrators wishing to
override the default policies.
The ${datadir} applicable to dbus is usually /usr/share and the
${sysconfdir} is usually /etc.
• A similar pattern applies to the session bus policies in session.d.
Fixes:
• Avoid possible memory corruption in certain DBusHashTableIter use

19
doc/dbus-daemon.1.xml.in
View file

@ -223,6 +223,21 @@ configured in the files "@EXPANDED_DATADIR@/dbus-1/system.conf" and
overrides in those files to avoid modifying the primary configuration
files.</para>
<para>The standard system bus normally reads additional XML files from
<filename>@EXPANDED_DATADIR@/dbus-1/system.d</filename>. Third-party
packages should install the default policies necessary for correct
operation into that directory, which has been supported since dbus 1.10
(released in 2015).</para>
<para>The standard system bus normally also reads XML files from
<filename>@EXPANDED_SYSCONFDIR@/dbus-1/system.d</filename>, which
should be used by system administrators if they wish to override
default policies.</para>
<para>Third-party packages would historically install XML files into
<filename>@EXPANDED_SYSCONFDIR@/dbus-1/system.d</filename>, but this
practice is now considered to be deprecated: that directory should
be treated as reserved for the system administrator.</para>
<para>The configuration file is an XML document. It must have the following
doctype declaration:</para>
@ -302,12 +317,10 @@ to be absent.</para>
point. Files in the directory are included in undefined order.
Only files ending in ".conf" are included.</para>
<para>This is intended to allow extension of the system bus by particular
packages. For example, if CUPS wants to be able to send out
notification of printer queue changes, it could install a file to
@EXPANDED_DATADIR@/dbus-1/system.d or
@EXPANDED_SYSCONFDIR@/dbus-1/system.d that allowed all apps to receive
@EXPANDED_DATADIR@/dbus-1/system.d that allowed all apps to receive
this message and allowed the printer daemon user to send it.</para>
<itemizedlist remap='TP'>