From 8bc40995f8444d89ab8208337ba8581958d366eb Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Thu, 11 Jan 2018 18:18:07 +0000 Subject: [PATCH] spec: Add initiator credentials to container instance information Signed-off-by: Simon McVittie --- doc/dbus-specification.xml | 68 +++++++++++++++++++++++++++++++++++++++------- 1 file changed, 58 insertions(+), 10 deletions(-) diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index d7d2b629..373af74a 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -7241,6 +7241,7 @@ GetConnectionInstance (in STRING bus_name, out OBJECT_PATH container_instance, + out DICT<STRING,VARIANT> initiator, out STRING container_type, out STRING container_name, out DICT<STRING,VARIANT> metadata) @@ -7276,31 +7277,54 @@ 2 + DICT<STRING,VARIANT> + + The credentials of the connection that called the + AddServer method, encoded in the + same way as the result of the + GetConnectionCredentials method. + Unlike the container type, name and metadata, these + are supplied by the message bus, and can be trusted to + the same extent as GetConnectionCredentials. + + + + 3 STRING Reversed domain name identifying a container manager or container technology, as passed to the AddServer method, such as org.flatpak or - io.snapcraft. + io.snapcraft. This information + was provided by the initiator of the per-container + server, and should only be trusted by other processes + if they trust that initiator. - 3 + 4 STRING Some unique identifier for an application or container, whose meaning is defined by the maintainers of the - container type. + container type. Like the container type, this information + was provided by the initiator of the per-container + server, and should only be trusted by other processes + if they trust that initiator. - 4 + 5 DICT<STRING,VARIANT> Metadata describing the application or container, with the keys and values defined by the maintainers of the container - type. + type. Like the container type, this information + was provided by the initiator of the per-container + server, and should only be trusted by other processes + if they trust that initiator. @@ -7326,6 +7350,7 @@ As a method: GetInstanceInfo (in OBJECT_PATH container_instance, + out DICT<STRING,VARIANT> initiator, out STRING container_type, out STRING container_name, out DICT<STRING,VARIANT> metadata) @@ -7352,31 +7377,54 @@ 1 + DICT<STRING,VARIANT> + + The credentials of the connection that called the + AddServer method, encoded in the + same way as the result of the + GetConnectionCredentials method. + Unlike the container type, name and metadata, these + are supplied by the message bus, and can be trusted to + the same extent as GetConnectionCredentials. + + + + 2 STRING Reversed domain name identifying a container manager or container technology, as passed to the AddServer method, such as org.flatpak or - io.snapcraft. + io.snapcraft. This information + was provided by the initiator of the per-container + server, and should only be trusted by other processes + if they trust that initiator. - 2 + 3 STRING Some unique identifier for an application or container, whose meaning is defined by the maintainers of the - container type. + container type. Like the container type, this information + was provided by the initiator of the per-container + server, and should only be trusted by other processes + if they trust that initiator. - 3 + 4 DICT<STRING,VARIANT> Metadata describing the application or container, with the keys and values defined by the maintainers of the container - type. + type. Like the container type, this information + was provided by the initiator of the per-container + server, and should only be trusted by other processes + if they trust that initiator. -- 2.15.1