X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_bus_negotiate_fds.xml;h=4babae5e2b0dfdc99e5790746b5ad9f8fee350b9;hb=302fbdf29eb0ad4ca1fe8ee18755edad7db11b37;hp=fb313e34fb2013c0ae174b45cb875c699891b1b7;hpb=8474b70c3a3842cdf3d51f331dd117ab6421f6d0;p=elogind.git
diff --git a/man/sd_bus_negotiate_fds.xml b/man/sd_bus_negotiate_fds.xml
index fb313e34f..4babae5e2 100644
--- a/man/sd_bus_negotiate_fds.xml
+++ b/man/sd_bus_negotiate_fds.xml
@@ -1,4 +1,4 @@
-
+
@@ -70,6 +70,7 @@ along with systemd; If not, see .
int sd_bus_negotiate_creds
sd_bus *bus
int b
+ uint64_t flags
@@ -107,25 +108,34 @@ along with systemd; If not, see .
sd_bus_message_get_seqno3
fail with -ENODATA on incoming messages. Note
that not all transports support timestamping of messages. On local
- transports, the timestamping is applied by the kernel and cannot be
- manipulated by userspace.
+ transports, the timestamping is applied by the kernel and cannot
+ be manipulated by userspace. By default, message timestamping is
+ not negotiated for all connections.
sd_bus_negotiate_creds() controls
whether implicit sender credentials shall be attached
- automatically to all incoming messages. Takes a bus object and a
- bit mask value, which controls which credential parameters are
- attached. If this is not used,
- sd_bus_message_get_creds3
- fails with -ENODATA on incoming
- messages. Note that not all transports support attaching sender
- credentials to messages, or do not support all types of sender
- credential parameters. On local transports, the sender credentials
- are attached by the kernel and cannot be manipulated by
- userspace. By default, no sender credentials are attached.
-
- These functions may be called only before the connection has
- been started with
- sd_bus_start3.
+ automatically to all incoming messages. Takes a bus object, a
+ boolean indicating whether to enable or disable the credential
+ parts encoded in the bit mask value argument. Note that not all
+ transports support attaching sender credentials to messages, or do
+ not support all types of sender credential parameters, or might
+ suppress them under certain circumstances for individual
+ messages. On local transports, the sender credentials are attached
+ by the kernel and cannot be manipulated by userspace. By default,
+ no sender credentials are attached.
+
+ The sd_bus_negotiate_fds() function may
+ be called only before the connection has been started with
+ sd_bus_start3. Both
+ sd_bus_negotiate_timestamp() and
+ sd_bus_negotiate_creds() also may be called
+ after a connection has been set up. Note that when operating on a
+ connection that is shared between multiple components of the same
+ program (for example via
+ sd_bus_default3)
+ it is highly recommended to only enable additional per message
+ metadata fields, but never disable them again, in order not to
+ disable functionality needed by other components.
@@ -169,7 +179,8 @@ along with systemd; If not, see .
sd_bus_start3,
sd_bus_message_can_send3,
sd_bus_message_get_monotonic_usec3,
- sd_bus_message_get_creds3
+ sd_bus_message_get_creds3,
+ systemd.busname5