X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=src%2Flibsystemd%2Fsd-bus%2Fkdbus.h;h=b060330cb61fdd10c106855f8d2ebc021acec2ea;hp=e9f7d44bcb1a3a2236dc5f85000abf3a9fa34a26;hb=b5af2aca120f1bf13cffc270803c2232918dd967;hpb=1d49b5aea98ad0ad3ccafc3f83943811219729e0

diff --git a/src/libsystemd/sd-bus/kdbus.h b/src/libsystemd/sd-bus/kdbus.h
index e9f7d44bc..b060330cb 100644
--- a/src/libsystemd/sd-bus/kdbus.h
+++ b/src/libsystemd/sd-bus/kdbus.h
@@ -223,6 +223,7 @@ struct kdbus_policy_access {
  * @KDBUS_ITEM_ID:		Connection ID
  * @KDBUS_ITEM_TIMESTAMP:	Timestamp
  * @KDBUS_ITEM_CREDS:		Process credential
+ * @KDBUS_ITEM_AUXGROUPS:	Auxiliary process groups
  * @KDBUS_ITEM_PID_COMM:	Process ID "comm" identifier
  * @KDBUS_ITEM_TID_COMM:	Thread ID "comm" identifier
  * @KDBUS_ITEM_EXE:		The path of the executable
@@ -263,6 +264,7 @@ enum kdbus_item_type {
 	KDBUS_ITEM_ID,
 	KDBUS_ITEM_TIMESTAMP,
 	KDBUS_ITEM_CREDS,
+	KDBUS_ITEM_AUXGROUPS,
 	KDBUS_ITEM_PID_COMM,
 	KDBUS_ITEM_TID_COMM,
 	KDBUS_ITEM_EXE,
@@ -481,9 +483,11 @@ enum kdbus_policy_type {
  *				a well-know name for a process to be started
  *				when traffic arrives
  * @KDBUS_HELLO_POLICY_HOLDER:	Special-purpose connection which registers
- *				policy entries for one or multiple names. The
- *				provided names are not activated, and are not
- *				registered with the name database
+ *				policy entries for a name. The provided name
+ *				is not activated and not registered with the
+ *				name database, it only allows unprivileged
+ *				connections to aquire a name, talk or discover
+ *				a service
  * @KDBUS_HELLO_MONITOR:	Special-purpose connection to monitor
  *				bus traffic
  */
@@ -498,6 +502,7 @@ enum kdbus_hello_flags {
  * enum kdbus_attach_flags - flags for metadata attachments
  * @KDBUS_ATTACH_TIMESTAMP:	Timestamp
  * @KDBUS_ATTACH_CREDS:		Credentials
+ * @KDBUS_ATTACH_AUXGROUPS:	Auxiliary groups
  * @KDBUS_ATTACH_NAMES:		Well-known names
  * @KDBUS_ATTACH_COMM:		The "comm" process identifier
  * @KDBUS_ATTACH_EXE:		The path of the executable
@@ -512,16 +517,17 @@ enum kdbus_hello_flags {
 enum kdbus_attach_flags {
 	KDBUS_ATTACH_TIMESTAMP		=  1 <<  0,
 	KDBUS_ATTACH_CREDS		=  1 <<  1,
-	KDBUS_ATTACH_NAMES		=  1 <<  2,
-	KDBUS_ATTACH_COMM		=  1 <<  3,
-	KDBUS_ATTACH_EXE		=  1 <<  4,
-	KDBUS_ATTACH_CMDLINE		=  1 <<  5,
-	KDBUS_ATTACH_CGROUP		=  1 <<  6,
-	KDBUS_ATTACH_CAPS		=  1 <<  7,
-	KDBUS_ATTACH_SECLABEL		=  1 <<  8,
-	KDBUS_ATTACH_AUDIT		=  1 <<  9,
-	KDBUS_ATTACH_CONN_NAME		=  1 << 10,
-	_KDBUS_ATTACH_ALL		=  (1 << 11) - 1,
+	KDBUS_ATTACH_AUXGROUPS		=  1 <<  2,
+	KDBUS_ATTACH_NAMES		=  1 <<  3,
+	KDBUS_ATTACH_COMM		=  1 <<  4,
+	KDBUS_ATTACH_EXE		=  1 <<  5,
+	KDBUS_ATTACH_CMDLINE		=  1 <<  6,
+	KDBUS_ATTACH_CGROUP		=  1 <<  7,
+	KDBUS_ATTACH_CAPS		=  1 <<  8,
+	KDBUS_ATTACH_SECLABEL		=  1 <<  9,
+	KDBUS_ATTACH_AUDIT		=  1 << 10,
+	KDBUS_ATTACH_CONN_NAME		=  1 << 11,
+	_KDBUS_ATTACH_ALL		=  (1 << 12) - 1,
 };
 
 /**
@@ -602,9 +608,7 @@ enum kdbus_name_flags {
  * struct kdbus_cmd_name - struct to describe a well-known name
  * @size:		The total size of the struct
  * @flags:		Flags for a name entry (KDBUS_NAME_*)
- * @owner_id:		The current owner of the name. For requests,
- *			privileged users may set this field to
- *			(de)register names on behalf of other connections.
+ * @owner_id:		The current owner of the name.
  * @conn_flags:		The flags of the owning connection (KDBUS_HELLO_*)
  * @name:		The well-known name
  *
@@ -899,8 +903,9 @@ enum kdbus_ioctl_type {
  * @EEXIST:		A requested domain, bus or endpoint with the same
  *			name already exists.  A specific data type, which is
  *			only expected once, is provided multiple times.
- * @EFAULT:		The supplied memory could not be accessed, or the data
- *			is not properly aligned.
+ * @EFAULT:		The supplied memory could not be accessed, the data
+ *			is not properly aligned, or the current task's memory
+ *			is inaccessible.
  * @EINVAL:		The provided data does not match its type or other
  *			expectations, like a string which is not NUL terminated,
  *			or a string length that points behind the first