summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRay Strode <rstrode@redhat.com>2008-07-10 13:19:44 -0400
committerRay Strode <rstrode@redhat.com>2008-07-12 13:38:00 -0400
commit37853b6dd04fa32a6f948438d2fbdcd08bd473e4 (patch)
tree8ca30d10bf41aa02eedef71531fe17af2b7ef778 /doc
parent91306ef938873fce8f2ae2d4a6b3282d0379c65a (diff)
Add new UpdateActivationEnvironment bus message
It adjusts the environment of activated bus clients. This is important for session managers that get started after the session bus daemon and want to influence the environment of desktop services that are started by the bus.
Diffstat (limited to 'doc')
-rw-r--r--doc/dbus-specification.xml34
1 files changed, 34 insertions, 0 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 932ba0a3..9b22c84a 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -3678,6 +3678,40 @@
</sect3>
+ <sect3 id="bus-messages-update-activation-environment">
+ <title><literal>org.freedesktop.DBus.UpdateActivationEnvironment</literal></title>
+ <para>
+ As a method:
+ <programlisting>
+ UpdateActivationEnvironment (in ARRAY of DICT&lt;STRING,STRING&gt; environment)
+ </programlisting>
+ Message arguments:
+ <informaltable>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Argument</entry>
+ <entry>Type</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>0</entry>
+ <entry>ARRAY of DICT&lt;STRING,STRING&gt;</entry>
+ <entry>Environment to add or update</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ Normally, session bus activated services inherit the environment of the bus daemon. This method adds to or modifies that environment when activating services.
+ </para>
+ <para>
+ Some bus instances, such as the standard system bus, may disable access to this method for some or all callers.
+ </para>
+
+ </sect3>
+
<sect3 id="bus-messages-get-name-owner">
<title><literal>org.freedesktop.DBus.GetNameOwner</literal></title>
<para>