kdbus.h revision 6ad4a4fc43e12c8c36f85abbb36e8791ec507519
* struct kdbus_caps - process capabilities * @last_cap: Highest currently known capability bit * @caps: Variable number of 32-bit capabilities flags * Contains a variable number of 32-bit capabilities flags. * struct kdbus_audit - audit information * @sessionid: The audit session ID * @loginuid: The audit login uid * @seqnum: Global per-domain message sequence number * @monotonic_ns: Monotonic timestamp, in nanoseconds * @realtime_ns: Realtime timestamp, in nanoseconds * struct kdbus_vec - I/O vector for kdbus payload items * @size: The size of the vector * @address: Memory address of data buffer * @offset: Offset in the in-message payload memory, * relative to the message head * KDBUS_ITEM_PAYLOAD_VEC, KDBUS_ITEM_PAYLOAD_OFF * struct kdbus_bloom_parameter - bus-wide bloom parameters * @size: Size of the bit field in bytes (m / 8) * @n_hash: Number of hash functions used (k) * struct kdbus_bloom_filter - bloom filter containing n elements * @generation: Generation of the element set in the filter * @data: Bit field, multiple of 8 bytes * struct kdbus_memfd - a kdbus memfd * @start: The offset into the memfd where the segment starts * @size: The size of the memfd segment * @fd: The file descriptor number * @__pad: Padding to ensure proper alignment and size * KDBUS_ITEM_PAYLOAD_MEMFD * struct kdbus_name - a registered well-known name with its flags * @flags: Flags from KDBUS_NAME_* * enum kdbus_policy_access_type - permissions of a policy record * @KDBUS_POLICY_ACCESS_USER: Grant access to a uid * @KDBUS_POLICY_ACCESS_GROUP: Grant access to gid * @KDBUS_POLICY_ACCESS_WORLD: World-accessible * enum kdbus_policy_access_flags - mode flags * @KDBUS_POLICY_OWN: Allow to own a well-known name * Implies KDBUS_POLICY_TALK and KDBUS_POLICY_SEE * @KDBUS_POLICY_TALK: Allow communication to a well-known name * Implies KDBUS_POLICY_SEE * @KDBUS_POLICY_SEE: Allow to see a well-known name * struct kdbus_policy_access - policy access item * @type: One of KDBUS_POLICY_ACCESS_* types * @access: Access to grant * @id: For KDBUS_POLICY_ACCESS_USER, the uid * For KDBUS_POLICY_ACCESS_GROUP, the gid * enum kdbus_attach_flags - flags for metadata attachments * @KDBUS_ATTACH_TIMESTAMP: Timestamp * @KDBUS_ATTACH_CREDS: Credentials * @KDBUS_ATTACH_PIDS: PIDs * @KDBUS_ATTACH_AUXGROUPS: Auxiliary groups * @KDBUS_ATTACH_NAMES: Well-known names * @KDBUS_ATTACH_TID_COMM: The "comm" process identifier of the TID * @KDBUS_ATTACH_PID_COMM: The "comm" process identifier of the PID * @KDBUS_ATTACH_EXE: The path of the executable * @KDBUS_ATTACH_CMDLINE: The process command line * @KDBUS_ATTACH_CGROUP: The croup membership * @KDBUS_ATTACH_CAPS: The process capabilities * @KDBUS_ATTACH_SECLABEL: The security label * @KDBUS_ATTACH_AUDIT: The audit IDs * @KDBUS_ATTACH_CONN_DESCRIPTION: The human-readable connection name * @_KDBUS_ATTACH_ALL: All of the above * @_KDBUS_ATTACH_ANY: Wildcard match to enable any kind of * enum kdbus_item_type - item types to chain data in a list * @_KDBUS_ITEM_USER_BASE: Start of user items * @KDBUS_ITEM_NEGOTIATE: Negotiate supported items * @KDBUS_ITEM_PAYLOAD_VEC: Vector to data * @KDBUS_ITEM_PAYLOAD_OFF: Data at returned offset to message head * @KDBUS_ITEM_PAYLOAD_MEMFD: Data as sealed memfd * @KDBUS_ITEM_FDS: Attached file descriptors * @KDBUS_ITEM_CANCEL_FD: FD used to cancel a synchronous * operation by writing to it from * @KDBUS_ITEM_BLOOM_PARAMETER: Bus-wide bloom parameters, used with * KDBUS_CMD_BUS_MAKE, carries a * struct kdbus_bloom_parameter * @KDBUS_ITEM_BLOOM_FILTER: Bloom filter carried with a message, * used to match against a bloom mask of a * connection, carries a struct * @KDBUS_ITEM_BLOOM_MASK: Bloom mask used to match against a * @KDBUS_ITEM_DST_NAME: Destination's well-known name * @KDBUS_ITEM_MAKE_NAME: Name of domain, bus, endpoint * @KDBUS_ITEM_ATTACH_FLAGS_SEND: Attach-flags, used for updating which * metadata a connection opts in to send * @KDBUS_ITEM_ATTACH_FLAGS_RECV: Attach-flags, used for updating which * metadata a connection requests to * receive for each reeceived message * @KDBUS_ITEM_ID: Connection ID * @KDBUS_ITEM_NAME: Well-know name with flags * @_KDBUS_ITEM_ATTACH_BASE: Start of metadata attach items * @KDBUS_ITEM_TIMESTAMP: Timestamp * @KDBUS_ITEM_CREDS: Process credentials * @KDBUS_ITEM_PIDS: Process identifiers * @KDBUS_ITEM_AUXGROUPS: Auxiliary process groups * @KDBUS_ITEM_OWNED_NAME: A name owned by the associated * @KDBUS_ITEM_TID_COMM: Thread ID "comm" identifier * (Don't trust this, see below.) * @KDBUS_ITEM_PID_COMM: Process ID "comm" identifier * (Don't trust this, see below.) * @KDBUS_ITEM_EXE: The path of the executable * (Don't trust this, see below.) * @KDBUS_ITEM_CMDLINE: The process command line * (Don't trust this, see below.) * @KDBUS_ITEM_CGROUP: The croup membership * @KDBUS_ITEM_CAPS: The process capabilities * @KDBUS_ITEM_SECLABEL: The security label * @KDBUS_ITEM_AUDIT: The audit IDs * @KDBUS_ITEM_CONN_DESCRIPTION: The connection's human-readable name * @_KDBUS_ITEM_POLICY_BASE: Start of policy items * @KDBUS_ITEM_POLICY_ACCESS: Policy access block * @_KDBUS_ITEM_KERNEL_BASE: Start of kernel-generated message items * @KDBUS_ITEM_NAME_ADD: Notification in kdbus_notify_name_change * @KDBUS_ITEM_NAME_REMOVE: Notification in kdbus_notify_name_change * @KDBUS_ITEM_NAME_CHANGE: Notification in kdbus_notify_name_change * @KDBUS_ITEM_ID_ADD: Notification in kdbus_notify_id_change * @KDBUS_ITEM_ID_REMOVE: Notification in kdbus_notify_id_change * @KDBUS_ITEM_REPLY_TIMEOUT: Timeout has been reached * @KDBUS_ITEM_REPLY_DEAD: Destination died * N.B: The process and thread COMM fields, as well as the CMDLINE and * EXE fields may be altered by unprivileged processes und should * hence *not* used for security decisions. Peers should make use of * these items only for informational purposes, such as generating log /* keep these item types in sync with KDBUS_ATTACH_* flags */ * struct kdbus_item - chain of data blocks * @size: Overall data record size * @type: Kdbus_item type of data * @data32: Generic 32 bit array * @data64: Generic 64 bit array * @vec: KDBUS_ITEM_PAYLOAD_VEC * @creds: KDBUS_ITEM_CREDS * @audit: KDBUS_ITEM_AUDIT * @timestamp: KDBUS_ITEM_TIMESTAMP * @bloom_parameter: KDBUS_ITEM_BLOOM_PARAMETER * @bloom_filter: KDBUS_ITEM_BLOOM_FILTER * @memfd: KDBUS_ITEM_PAYLOAD_MEMFD * @name_change: KDBUS_ITEM_NAME_ADD * @id_change: KDBUS_ITEM_ID_ADD * @policy: KDBUS_ITEM_POLICY_ACCESS * enum kdbus_msg_flags - type of message * @KDBUS_MSG_EXPECT_REPLY: Expect a reply message, used for * method calls. The userspace-supplied * cookie identifies the message and the * respective reply carries the cookie * @KDBUS_MSG_NO_AUTO_START: Do not start a service, if the addressed * name is not currently active * @KDBUS_MSG_SIGNAL: Treat this message as signal * enum kdbus_payload_type - type of payload carried by message * @KDBUS_PAYLOAD_KERNEL: Kernel-generated simple message * @KDBUS_PAYLOAD_DBUS: D-Bus marshalling "DBusDBus" * Any payload-type is accepted. Common types will get added here once * struct kdbus_msg - the representation of a kdbus message * @size: Total size of the message * @flags: Message flags (KDBUS_MSG_*), userspace → kernel * @priority: Message queue priority value * @dst_id: 64-bit ID of the destination connection * @src_id: 64-bit ID of the source connection * @payload_type: Payload type (KDBUS_PAYLOAD_*) * @cookie: Userspace-supplied cookie, for the connection * to identify its messages * @timeout_ns: The time to wait for a message reply from the peer. * If there is no reply, a kernel-generated message * with an attached KDBUS_ITEM_REPLY_TIMEOUT item * is sent to @src_id. The timeout is expected in * nanoseconds and as absolute CLOCK_MONOTONIC value. * @cookie_reply: A reply to the requesting message with the same * cookie. The requesting connection can match its * request and the reply with this value * @items: A list of kdbus_items containing the message payload * struct kdbus_msg_info - returned message container * @offset: Offset of kdbus_msg slice in pool * @return_flags: Command return flags, kernel → userspace * enum kdbus_send_flags - flags for sending messages * @KDBUS_SEND_SYNC_REPLY: Wait for destination connection to * reply to this message. The * KDBUS_CMD_SEND ioctl() will block * until the reply is received, and * offset_reply in struct kdbus_msg will * yield the offset in the sender's pool * where the reply can be found. * This flag is only valid if * @KDBUS_MSG_EXPECT_REPLY is set as well. * struct kdbus_cmd_send - send message * @size: Overall size of this structure * @flags: Flags to change send behavior (KDBUS_SEND_*) * @return_flags: Command return flags, kernel → userspace * @msg_address: Storage address of the kdbus_msg to send * @reply: Storage for message reply if KDBUS_SEND_SYNC_REPLY * @items: Additional items for this command * enum kdbus_recv_flags - flags for de-queuing messages * @KDBUS_RECV_PEEK: Return the next queued message without * actually de-queuing it, and without installing * any file descriptors or other resources. It is * usually used to determine the activating * connection of a bus name. * @KDBUS_RECV_DROP: Drop and free the next queued message and all * its resources without actually receiving it. * @KDBUS_RECV_USE_PRIORITY: Only de-queue messages with the specified or * higher priority (lowest values); if not set, * the priority value is ignored. * enum kdbus_recv_return_flags - return flags for message receive commands * @KDBUS_RECV_RETURN_INCOMPLETE_FDS: One or more file descriptors could not * be installed. These descriptors in * KDBUS_ITEM_FDS will carry the value -1. * @KDBUS_RECV_RETURN_DROPPED_MSGS: There have been dropped messages since * the last time a message was received. * The 'dropped_msgs' counter contains the * number of messages dropped pool * overflows or other missed broadcasts. * struct kdbus_cmd_recv - struct to de-queue a buffered message * @size: Overall size of this object * @flags: KDBUS_RECV_* flags, userspace → kernel * @return_flags: Command return flags, kernel → userspace * @priority: Minimum priority of the messages to de-queue. Lowest * values have the highest priority. * @dropped_msgs: In case there were any dropped messages since the last * time a message was received, this will be set to the * number of lost messages and * KDBUS_RECV_RETURN_DROPPED_MSGS will be set in * 'return_flags'. This can only happen if the ioctl * @msg: Return storage for received message. * @items: Additional items for this command. * This struct is used with the KDBUS_CMD_RECV ioctl. * struct kdbus_cmd_free - struct to free a slice of memory in the pool * @size: Overall size of this structure * @flags: Flags for the free command, userspace → kernel * @return_flags: Command return flags, kernel → userspace * @offset: The offset of the memory slice, as returned by other * @items: Additional items to modify the behavior * This struct is used with the KDBUS_CMD_FREE ioctl. * enum kdbus_hello_flags - flags for struct kdbus_cmd_hello * @KDBUS_HELLO_ACCEPT_FD: The connection allows the reception of * any passed file descriptors * @KDBUS_HELLO_ACTIVATOR: Special-purpose connection which registers * a well-know name for a process to be started * @KDBUS_HELLO_POLICY_HOLDER: Special-purpose connection which registers * policy entries for a name. The provided name * is not activated and not registered with the * name database, it only allows unprivileged * connections to acquire a name, talk or discover * @KDBUS_HELLO_MONITOR: Special-purpose connection to monitor * struct kdbus_cmd_hello - struct to say hello to kdbus * @size: The total size of the structure * @flags: Connection flags (KDBUS_HELLO_*), userspace → kernel * @return_flags: Command return flags, kernel → userspace * @attach_flags_send: Mask of metadata to attach to each message sent * off by this connection (KDBUS_ATTACH_*) * @attach_flags_recv: Mask of metadata to attach to each message receieved * by the new connection (KDBUS_ATTACH_*) * @bus_flags: The flags field copied verbatim from the original * KDBUS_CMD_BUS_MAKE ioctl. It's intended to be useful * to do negotiation of features of the payload that is * transferred (kernel → userspace) * @id: The ID of this connection (kernel → userspace) * @pool_size: Size of the connection's buffer where the received * @offset: Pool offset where items are returned to report * additional information about the bus and the newly * @items_size: Size of buffer returned in the pool slice at @offset. * @id128: Unique 128-bit ID of the bus (kernel → userspace) * @items: A list of items * This struct is used with the KDBUS_CMD_HELLO ioctl. * struct kdbus_info - connection information * @size: total size of the struct * @flags: object creation flags * Note that the user is responsible for freeing the allocated memory with * the KDBUS_CMD_FREE ioctl. * enum kdbus_list_flags - what to include into the returned list * @KDBUS_LIST_UNIQUE: active connections * @KDBUS_LIST_ACTIVATORS: activator connections * @KDBUS_LIST_NAMES: known well-known names * @KDBUS_LIST_QUEUED: queued-up names * struct kdbus_cmd_list - list connections * @size: overall size of this object * @flags: flags for the query (KDBUS_LIST_*), userspace → kernel * @return_flags: command return flags, kernel → userspace * @offset: Offset in the caller's pool buffer where an array of * kdbus_info objects is stored. * The user must use KDBUS_CMD_FREE to free the * @list_size: size of returned list in bytes * @items: Items for the command. Reserved for future use. * This structure is used with the KDBUS_CMD_LIST ioctl. * struct kdbus_cmd_info - struct used for KDBUS_CMD_CONN_INFO ioctl * @size: The total size of the struct * @flags: Flags for this ioctl, userspace → kernel * @return_flags: Command return flags, kernel → userspace * @id: The 64-bit ID of the connection. If set to zero, passing * @name is required. kdbus will look up the name to * determine the ID in this case. * @attach_flags: Set of attach flags to specify the set of information * to receive, userspace → kernel * @offset: Returned offset in the caller's pool buffer where the * kdbus_info struct result is stored. The user must * use KDBUS_CMD_FREE to free the allocated memory. * @info_size: Output buffer to report size of data at @offset. * @items: The optional item list, containing the * well-known name to look up as a KDBUS_ITEM_NAME. * Only needed in case @id is zero. * On success, the KDBUS_CMD_CONN_INFO ioctl will return 0 and @offset will * tell the user the offset in the connection pool buffer at which to find the * result in a struct kdbus_info. * enum kdbus_cmd_match_flags - flags to control the KDBUS_CMD_MATCH_ADD ioctl * @KDBUS_MATCH_REPLACE: If entries with the supplied cookie already * exists, remove them before installing the new * struct kdbus_cmd_match - struct to add or remove matches * @size: The total size of the struct * @flags: Flags for match command (KDBUS_MATCH_*), * @return_flags: Command return flags, kernel → userspace * @cookie: Userspace supplied cookie. When removing, the cookie * identifies the match to remove * @items: A list of items for additional information * This structure is used with the KDBUS_CMD_MATCH_ADD and * KDBUS_CMD_MATCH_REMOVE ioctl. * enum kdbus_make_flags - Flags for KDBUS_CMD_{BUS,ENDPOINT}_MAKE * @KDBUS_MAKE_ACCESS_GROUP: Make the bus or endpoint node group-accessible * @KDBUS_MAKE_ACCESS_WORLD: Make the bus or endpoint node world-accessible * enum kdbus_name_flags - flags for KDBUS_CMD_NAME_ACQUIRE * @KDBUS_NAME_REPLACE_EXISTING: Try to replace name of other connections * @KDBUS_NAME_ALLOW_REPLACEMENT: Allow the replacement of the name * @KDBUS_NAME_QUEUE: Name should be queued if busy * @KDBUS_NAME_IN_QUEUE: Name is queued * @KDBUS_NAME_ACTIVATOR: Name is owned by a activator connection * struct kdbus_cmd - generic ioctl payload * @size: Overall size of this structure * @flags: Flags for this ioctl, userspace → kernel * @return_flags: Ioctl return flags, kernel → userspace * @items: Additional items to modify the behavior * This is a generic ioctl payload object. It's used by all ioctls that only * take flags and items as input. * KDBUS_CMD_BUS_MAKE: After opening the "control" node, this command * creates a new bus with the specified * name. The bus is immediately shut down and * cleaned up when the opened file descriptor is * KDBUS_CMD_ENDPOINT_MAKE: Creates a new named special endpoint to talk to * the bus. Such endpoints usually carry a more * restrictive policy and grant restricted access * to specific applications. * KDBUS_CMD_ENDPOINT_UPDATE: Update the properties of a custom enpoint. Used * KDBUS_CMD_HELLO: By opening the bus node, a connection is * created. After a HELLO the opened connection * becomes an active peer on the bus. * KDBUS_CMD_UPDATE: Update the properties of a connection. Used to * update the metadata subscription mask and * KDBUS_CMD_BYEBYE: Disconnect a connection. If there are no * messages queued up in the connection's pool, * the call succeeds, and the handle is rendered * unusable. Otherwise, -EBUSY is returned without * any further side-effects. * KDBUS_CMD_FREE: Release the allocated memory in the receiver's * KDBUS_CMD_CONN_INFO: Retrieve credentials and properties of the * initial creator of the connection. The data was * stored at registration time and does not * necessarily represent the connected process or * the actual state of the process. * KDBUS_CMD_BUS_CREATOR_INFO: Retrieve information of the creator of the bus * a connection is attached to. * KDBUS_CMD_SEND: Send a message and pass data from userspace to * KDBUS_CMD_RECV: Receive a message from the kernel which is * placed in the receiver's pool. * KDBUS_CMD_NAME_ACQUIRE: Request a well-known bus name to associate with * the connection. Well-known names are used to * address a peer on the bus. * KDBUS_CMD_NAME_RELEASE: Release a well-known name the connection * KDBUS_CMD_LIST: Retrieve the list of all currently registered * well-known and unique names. * KDBUS_CMD_MATCH_ADD: Install a match which broadcast messages should * be delivered to the connection. * KDBUS_CMD_MATCH_REMOVE: Remove a current match for broadcast messages. /* endpoint owner (10-1f) */ /* connection owner (80-ff) */ #
endif /* _KDBUS_UAPI_H_ */