fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2026-05-06 08:08:05 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Document GetAdtAuditSessionData and GetConnectionSELinuxSecurityContext

Browse source 
These are only part of the DBus interface because dbus-daemon didn't
previously support multiple interfaces. I don't know enough about
either of these security frameworks to know what they return, but
perhaps one day someone who knows about Solaris or SELinux will tell
us...

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=54445
Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de>
This commit is contained in:
Simon McVittie 2013-02-27 19:22:30 +00:00
parent 4b63567c02
commit 82d37b93ec
1 changed files with 117 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

117
doc/dbus-specification.xml
View file

@ -5681,6 +5681,123 @@
</para>
</sect3>
<sect3 id="bus-messages-get-adt-audit-session-data">
<title><literal>org.freedesktop.DBus.GetAdtAuditSessionData</literal></title>
<para>
As a method:
<programlisting>
ARRAY of BYTE GetAdtAuditSessionData (in STRING bus_name)
</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>STRING</entry>
<entry>Unique or well-known bus name of the connection to
query, such as <literal>:12.34</literal> or
<literal>com.example.tea</literal></entry>
</row>
</tbody>
</tgroup>
</informaltable>
Reply 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 BYTE</entry>
<entry>auditing data as returned by
adt_export_session_data()</entry>
</row>
</tbody>
</tgroup>
</informaltable>
Returns auditing data used by Solaris ADT, in an unspecified
binary format. If you know what this means, please contribute
documentation via the D-Bus bug tracking system.
This method is on the core DBus interface for historical reasons;
the same information should be made available via
<xref linkend="bus-messages-get-connection-credentials"/>
in future.
</para>
</sect3>
<sect3 id="bus-messages-get-connection-selinux-security-context">
<title><literal>org.freedesktop.DBus.GetConnectionSELinuxSecurityContext</literal></title>
<para>
As a method:
<programlisting>
ARRAY of BYTE GetConnectionSELinuxSecurityContext (in STRING bus_name)
</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>STRING</entry>
<entry>Unique or well-known bus name of the connection to
query, such as <literal>:12.34</literal> or
<literal>com.example.tea</literal></entry>
</row>
</tbody>
</tgroup>
</informaltable>
Reply 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 BYTE</entry>
<entry>some sort of string of bytes, not necessarily UTF-8,
not including '\0'</entry>
</row>
</tbody>
</tgroup>
</informaltable>
Returns the security context used by SELinux, in an unspecified
format. If you know what this means, please contribute
documentation via the D-Bus bug tracking system.
This method is on the core DBus interface for historical reasons;
the same information should be made available via
<xref linkend="bus-messages-get-connection-credentials"/>
in future.
</para>
</sect3>
<sect3 id="bus-messages-add-match">
<title><literal>org.freedesktop.DBus.AddMatch</literal></title>
<para>