From b4c81a2a05631338cb0481e40cc7a93407f638b9 Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@collabora.com>
Date: Mon, 11 Dec 2017 17:39:31 +0000
Subject: [PATCH 5/9] spec: Document NEGOTIATE_UNIX_FD, AGREE_UNIX_FD in state
 machines

Signed-off-by: Simon McVittie <smcv@collabora.com>
---
 doc/dbus-specification.xml | 50 ++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 48 insertions(+), 2 deletions(-)

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index dc3e2492..a01b45b7 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -2728,8 +2728,19 @@
             <itemizedlist>
               <listitem>
                 <para>
-                  Receive OK &rarr; send BEGIN, terminate auth
-                  conversation, <emphasis>authenticated</emphasis>
+                  Receive OK &rarr; <emphasis>authenticated</emphasis>,
+                  choose one:
+
+                  <simplelist>
+                    <member>
+                      send NEGOTIATE_UNIX_FD, goto
+                      <emphasis>WaitingForAgreeUnixFD</emphasis>
+                    </member>
+
+                    <member>
+                      send BEGIN, terminate auth conversation
+                    </member>
+                  </simplelist>
                 </para>
               </listitem>
               <listitem>
@@ -2786,6 +2797,34 @@
           </para>
         </formalpara>
 
+        <formalpara>
+          <title><emphasis>WaitingForAgreeUnixFD</emphasis></title>
+          <para>
+            <itemizedlist>
+              <listitem>
+                <para>
+                  Receive AGREE_UNIX_FD &rarr; enable Unix fd passing,
+                  send BEGIN, terminate auth conversation
+                </para>
+              </listitem>
+
+              <listitem>
+                <para>
+                  Receive ERROR &rarr; disable Unix fd passing,
+                  send BEGIN, terminate auth conversation
+                </para>
+              </listitem>
+
+              <listitem>
+                <para>
+                  Receive anything else &rarr; terminate auth
+                  conversation, disconnect
+                </para>
+              </listitem>
+            </itemizedlist>
+          </para>
+        </formalpara>
+
       </sect3>
 
       <sect3 id="auth-states-server">
@@ -2963,6 +3002,13 @@
                 </para>
               </listitem>
 
+              <listitem>
+                <para>
+                  Receive NEGOTIATE_UNIX_FD &rarr; send AGREE_UNIX_FD
+                  or ERROR, goto <emphasis>WaitingForBegin</emphasis>
+                </para>
+              </listitem>
+
               <listitem>
                 <para>
                   Receive CANCEL &rarr; send REJECTED [mechs], goto
-- 
2.15.1