fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2025-12-26 14:30:09 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

spec: Document NEGOTIATE_UNIX_FD, AGREE_UNIX_FD in state machines

Browse source 
Signed-off-by: Simon McVittie <smcv@collabora.com>
Reviewed-by: Philip Withnall <withnall@endlessm.com>
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=104224
This commit is contained in:
Simon McVittie 2017-12-11 17:39:31 +00:00
parent 2c19572f7a
commit e4283c76fa
1 changed files with 63 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

68
doc/dbus-specification.xml
View file

@ -2739,9 +2739,19 @@
</listitem>
<listitem>
<para>
Receive OK &rarr; send
BEGIN, terminate auth
conversation, authenticated
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 (successfully)
</member>
</simplelist>
</para>
</listitem>
<listitem>
@ -2761,8 +2771,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 (successfully)
</member>
</simplelist>
</para>
</listitem>
<listitem>
@ -2819,6 +2840,36 @@
</para>
</formalpara>
<formalpara>
<title><emphasis>WaitingForAgreeUnixFD</emphasis></title>
<para>
By the time this state is reached, the client has already
been authenticated.
<itemizedlist>
<listitem>
<para>
Receive AGREE_UNIX_FD &rarr; enable Unix fd passing,
send BEGIN, terminate auth conversation (successfully)
</para>
</listitem>
<listitem>
<para>
Receive ERROR &rarr; disable Unix fd passing,
send BEGIN, terminate auth conversation (successfully)
</para>
</listitem>
<listitem>
<para>
Receive anything else &rarr; terminate auth
conversation, disconnect
</para>
</listitem>
</itemizedlist>
</para>
</formalpara>
</sect3>
<sect3 id="auth-states-server">
@ -2996,6 +3047,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