/*
* Remember the the reply associated with this queue entry, so we can
* move the reply entry's connection when a connection moves from an
- * activator to an implementor.
+ * activator to an implementer.
*/
entry->reply = kdbus_reply_ref(reply);
if (kmsg->res && kmsg->res->dst_name) {
/*
* Lock the destination name so it will not get dropped or
- * moved between activator/implementor while we try to queue a
+ * moved between activator/implementer while we try to queue a
* message. We also rely on this to read-lock the entire
* registry so kdbus_meta_add_current() will have a consistent
* view of all acquired names on both connections.
* name, 0 means no filtering.
*
* Move all messages from one connection to another. This is used when
- * an implementor connection is taking over/giving back a well-known name
+ * an implementer connection is taking over/giving back a well-known name
* from/to an activator connection.
*
* Return: 0 on success, negative errno on failure.
In 'return_flags', the kernel can return results of the command, in addition
to the actual return value. This is mostly to inform userspace about non-fatal
-conditions that occured during the execution of the command.
+conditions that occurred during the execution of the command.
4. Items
Items are also used for information stored in a connection's pool, such as
received messages, name lists or requested connection or bus owner information.
-Whenever tems are used as part of the kdbus kernel API, they are embedded in
+Whenever items are used as part of the kdbus kernel API, they are embedded in
structs that have an overall size of their own, so there can be multiple items
per ioctl.
domain internally. Operations performed on one domain do not affect any
other domain.
-The full kdbusfs hierarchy, any subdirectory, or file can be bind-mounted to an
-external mount point and will remain fully functional. The kdbus domain and any
-linked resources stay available until the original mount and all subsequent
+The full kdbusfs hierarchy, any sub-directory, or file can be bind-mounted to
+an external mount point and will remain fully functional. The kdbus domain and
+any linked resources stay available until the original mount and all subsequent
bind-mounts have been unmounted.
During creation, domains pin the user-namespace of the creator and use
------------------------------------------
An activator connection is a placeholder for a well-known name. Messages sent
-to such a connection can be used by userspace to start an implementor
+to such a connection can be used by userspace to start an implementer
connection, which will then get all the messages from the activator copied
over. An activator connection cannot be used to send any message.
KDBUS_CMD_SEND.
__u64 return_flags;
- Kernel-provided flags, returning non-fatal errors that occured during
+ Kernel-provided flags, returning non-fatal errors that occurred during
send. Currently unused.
__u64 msg_address;
KDBUS_MSG_NO_AUTO_START
By default, when a message is sent to an activator connection, the
- activator notified and will start an implementor. This flag inhibits
+ activator notified and will start an implementer. This flag inhibits
that behavior. With this bit set, and the remote being an activator,
-EADDRNOTAVAIL is returned from the ioctl.
Valid flags for this command, returned by the kernel upon each call.
__u64 return_flags;
- Kernel-provided flags, returning non-fatal errors that occured during
+ Kernel-provided flags, returning non-fatal errors that occurred during
send. Currently unused.
__s64 priority;
--------------------
A connection may release a name explicitly with the KDBUS_CMD_NAME_RELEASE
-ioctl. If the connection was an implementor of an activatable name, its
+ioctl. If the connection was an implementer of an activatable name, its
pending messages are moved back to the activator. If there are any connections
queued up as waiters for the name, the oldest one of them will become the new
owner. The same happens implicitly for all names once a connection terminates.
currently waiting for it to become available.
KDBUS_NAME_ACTIVATOR (list)
- An activator connection owns a name as a placeholder for an implementor,
+ An activator connection owns a name as a placeholder for an implementer,
which is started on demand as soon as the first message arrives. There's
some more information on this topic below. In contrast to
KDBUS_NAME_REPLACE_EXISTING, when a name is taken over from an activator
connection, all the messages that have been queued in the activator
connection will be moved over to the new owner. The activator connection
will still be tracked for the name and will take control again if the
- implementor connection terminates.
+ implementer connection terminates.
This flag can not be used when acquiring a name, but is implicitly set
through KDBUS_CMD_HELLO with KDBUS_HELLO_ACTIVATOR set in
kdbus_cmd_hello.conn_flags.
11.2 Wildcard names
-------------------
-Policy holder connections may upload names that contain the wildcard suffix
+Policy holder connections may upload names that contain the wild card suffix
(".*"). That way, a policy can be uploaded that is effective for every
well-known name that extends the provided name by exactly one more level.