Commit dee0f551 authored by Simon McVittie's avatar Simon McVittie

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

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's avatarSimon McVittie <smcv@collabora.com>
parent e1752785
dbus 1.13.10 (UNRELEASED) 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: Fixes:
Avoid possible memory corruption in certain DBusHashTableIter use Avoid possible memory corruption in certain DBusHashTableIter use
......
...@@ -223,6 +223,21 @@ configured in the files "@EXPANDED_DATADIR@/dbus-1/system.conf" and ...@@ -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 overrides in those files to avoid modifying the primary configuration
files.</para> 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 <para>The configuration file is an XML document. It must have the following
doctype declaration:</para> doctype declaration:</para>
...@@ -302,12 +317,10 @@ to be absent.</para> ...@@ -302,12 +317,10 @@ to be absent.</para>
point. Files in the directory are included in undefined order. point. Files in the directory are included in undefined order.
Only files ending in ".conf" are included.</para> Only files ending in ".conf" are included.</para>
<para>This is intended to allow extension of the system bus by particular <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 packages. For example, if CUPS wants to be able to send out
notification of printer queue changes, it could install a file to notification of printer queue changes, it could install a file to
@EXPANDED_DATADIR@/dbus-1/system.d or @EXPANDED_DATADIR@/dbus-1/system.d that allowed all apps to receive
@EXPANDED_SYSCONFDIR@/dbus-1/system.d that allowed all apps to receive
this message and allowed the printer daemon user to send it.</para> this message and allowed the printer daemon user to send it.</para>
<itemizedlist remap='TP'> <itemizedlist remap='TP'>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment