From d3ad6bf3a64b4f13cb9a780c833e763afcff6085 Mon Sep 17 00:00:00 2001 From: Andy Wingo Date: Wed, 8 Apr 2015 08:11:45 +0200 Subject: remove non-login things from man --- man/sd_bus_negotiate_fds.xml | 187 ------------------------------------------- 1 file changed, 187 deletions(-) delete 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 deleted file mode 100644 index 26a599e7d..000000000 --- a/man/sd_bus_negotiate_fds.xml +++ /dev/null @@ -1,187 +0,0 @@ - - - - - - - - - sd_bus_negotiate_fds - 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 - uint64_t flags - - - - - - Description - - sd_bus_negotiate_fds() controls whether - file descriptor passing shall be negotiated for the specified bus - connection. It 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_seqnum3 - 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. 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, 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. - - - - Return Value - - On success, these functions returns 0 or a - positive integer. On failure, they return 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, - systemd.busname5 - - - - -- cgit v1.2.3