From ce236b57bee9a081d62db04bcc5be34e3ba6d217 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 18 Mar 2014 21:05:16 +0100 Subject: man: dcument sd_bus_negotiate_fds() and friends --- man/sd_bus_negotiate_fds.xml | 176 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 176 insertions(+) create mode 100644 man/sd_bus_negotiate_fds.xml (limited to 'man/sd_bus_negotiate_fds.xml') diff --git a/man/sd_bus_negotiate_fds.xml b/man/sd_bus_negotiate_fds.xml new file mode 100644 index 000000000..38e1fad68 --- /dev/null +++ b/man/sd_bus_negotiate_fds.xml @@ -0,0 +1,176 @@ + + + + + + + + + sd_bus_new + systemd + + + + Developer + Lennart + Poettering + lennart@poettering.net + + + + + + sd_bus_negotiate_fds + 3 + + + + sd_bus_negotiate_fds + sd_bus_negotiate_timestamps + sd_bus_negotiate_creds + + Control feature negotiation on bus connections + + + + + #include <systemd/sd-bus.h> + + + int sd_bus_negotiate_fds + sd_bus *bus + int b + + + + int sd_bus_negotiate_timestamp + sd_bus *bus + int b + + + + int sd_bus_negotiate_creds + sd_bus *bus + int b + + + + + + Description + + sd_bus_negotiate_fds() controls whether + file descriptor passing shall be negotiated for the specified bus + connection. Takes a bus object and a boolean, which when true + enables file descriptor passing, and when false disables it. Note + that not all transports and servers support file descriptor + passing. To find out whether file descriptor passing is available + after negotiation use + sd_bus_can_send3 + and pass SD_BUS_TYPE_UNIX_FD. Note that file + descriptor passing is always enabled for both sending and + receiving or for neither, but never only in one direction. By + default file descriptor passing is negotiated for all + connections. + + Note that when bus activation is used it is highly + recommended to set the + setting in the .busname unit file to the same + setting as negotiated by the program ultimately activated. By + default file descriptor passing is enabled for both. + + sd_bus_negotiate_timestamps() controls + whether implicit sender timestamps shall be attached automatically + to all incoming messages. Takes a bus object and a boolean, which + when true enables timestamping, and when false disables it. If + this is disabled, + sd_bus_message_get_monotonic_usec3, + sd_bus_message_get_realtime_usec3, + 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. + + 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. + + + + Return Value + + On success, these functions returns 0 or a + positive integer. On failure, it returns a negative errno-style + error code. + + + + Errors + + Returned errors may indicate the following problems: + + + + -EPERM + + The bus connection has already been started. + + + + + + Notes + + sd_bus_negotiate_fs() and the other + functions described here are available as a shared library, which + can be compiled and linked to with the + libsystemd pkg-config1 + file. + + + + See Also + + + systemd1, + sd-bus3, + sd_bus_start3, + sd_bus_message_can_send3, + sd_bus_message_get_monotonic_usec3, + sd_bus_message_get_creds3 + + + + -- cgit v1.2.3