From fad1dbdbf3aa70e641b7c2195dc4909c6ac85447 Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Fri, 11 Mar 2011 23:56:34 +0100
Subject: [PATCH] spec: document systemd transport

This adds a short section about the systemd transport to the
specification.
---
 doc/dbus-specification.xml |   29 +++++++++++++++++++++++++----
 1 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index c5be9af..fa6c1e6 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -2558,9 +2558,9 @@
     <title>Transports</title>
     <para>
       [FIXME we need to specify in detail each transport and its possible arguments]
-    
-      Current transports include: unix domain sockets (including 
-      abstract namespace on linux), launchd, TCP/IP, an executed
+
+      Current transports include: unix domain sockets (including
+      abstract namespace on linux), launchd, systemd, TCP/IP, an executed
       subprocess and a debug/testing transport using in-process
       pipes. Future possible transports include one that tunnels over
       X11 protocol.
@@ -2624,7 +2624,7 @@
     <sect2 id="transports-launchd">
       <title>launchd</title>
       <para>
-        launchd is a open-source server management system that replaces init, inetd
+        launchd is an open-source server management system that replaces init, inetd
         and cron on Apple Mac OS X versions 10.4 and above. It provides a common session
         bus address for each user and deprecates the X11-enabled D-Bus launcher on OSX.
       </para>
@@ -2668,6 +2668,27 @@
        </informaltable>
       </sect3>
     </sect2>
+    <sect2 id="transports-systemd">
+      <title>systemd</title>
+      <para>
+        systemd is an open-source server management system that
+        replaces init and inetd on newer Linux systems. It supports
+        socket activation. The D-Bus systemd transport is used to acquire
+        socket activation file descriptors from systemd and use them
+        as D-Bus transport when the current process is spawned by
+        socket activation from it.
+      </para>
+      <para>
+        The systemd transport accepts only one or more Unix domain or
+        TCP streams sockets passed in via socket activation.
+      </para>
+      <para>
+        The systemd transport is not available on non-Linux operating systems.
+      </para>
+      <para>
+        The systemd transport defines no parameter keys.
+      </para>
+    </sect2>
     <sect2 id="transports-tcp-sockets">
       <title>TCP Sockets</title>
       <para>
-- 
1.7.6