diff --git a/Makefile-man.am b/Makefile-man.am
index d5b328d267..cd7583bed7 100644
--- a/Makefile-man.am
+++ b/Makefile-man.am
@@ -31,11 +31,13 @@ MANPAGES += \
man/sd-id128.3 \
man/sd-journal.3 \
man/sd_booted.3 \
+ man/sd_bus_add_match.3 \
man/sd_bus_creds_get_pid.3 \
man/sd_bus_creds_new_from_pid.3 \
man/sd_bus_default.3 \
man/sd_bus_error.3 \
man/sd_bus_error_add_map.3 \
+ man/sd_bus_get_fd.3 \
man/sd_bus_message_append.3 \
man/sd_bus_message_append_array.3 \
man/sd_bus_message_append_basic.3 \
@@ -43,9 +45,11 @@ MANPAGES += \
man/sd_bus_message_append_strv.3 \
man/sd_bus_message_get_cookie.3 \
man/sd_bus_message_get_monotonic_usec.3 \
+ man/sd_bus_message_read_basic.3 \
man/sd_bus_negotiate_fds.3 \
man/sd_bus_new.3 \
man/sd_bus_path_encode.3 \
+ man/sd_bus_process.3 \
man/sd_bus_request_name.3 \
man/sd_event_add_child.3 \
man/sd_event_add_defer.3 \
@@ -2522,11 +2526,13 @@ EXTRA_DIST += \
man/sd-journal.xml \
man/sd-login.xml \
man/sd_booted.xml \
+ man/sd_bus_add_match.xml \
man/sd_bus_creds_get_pid.xml \
man/sd_bus_creds_new_from_pid.xml \
man/sd_bus_default.xml \
man/sd_bus_error.xml \
man/sd_bus_error_add_map.xml \
+ man/sd_bus_get_fd.xml \
man/sd_bus_message_append.xml \
man/sd_bus_message_append_array.xml \
man/sd_bus_message_append_basic.xml \
@@ -2534,9 +2540,11 @@ EXTRA_DIST += \
man/sd_bus_message_append_strv.xml \
man/sd_bus_message_get_cookie.xml \
man/sd_bus_message_get_monotonic_usec.xml \
+ man/sd_bus_message_read_basic.xml \
man/sd_bus_negotiate_fds.xml \
man/sd_bus_new.xml \
man/sd_bus_path_encode.xml \
+ man/sd_bus_process.xml \
man/sd_bus_request_name.xml \
man/sd_event_add_child.xml \
man/sd_event_add_defer.xml \
diff --git a/man/sd_bus_add_match.xml b/man/sd_bus_add_match.xml
new file mode 100644
index 0000000000..8bcf7164a0
--- /dev/null
+++ b/man/sd_bus_add_match.xml
@@ -0,0 +1,119 @@
+
+
+
+
+
+
+
+
+ sd_bus_add_match
+ systemd
+
+
+
+ Julian
+ Orth
+ ju.orth@gmail.com
+
+
+
+
+
+ sd_bus_add_match
+ 3
+
+
+
+ sd_bus_add_match
+
+ Add a match rule for message dispatching
+
+
+
+
+ #include <systemd/sd-bus.h>
+
+
+ int sd_bus_add_match
+ sd_bus *bus
+ sd_bus_slot **slot
+ const char *match
+ sd_bus_message_handler_t callback
+ void *userdata
+
+
+
+ typedef int (*sd_bus_message_handler_t)
+ sd_bus_message *m
+ void *userdata
+ sd_bus_error *ret_error
+
+
+
+
+
+ Description
+
+
+ sd_bus_add_match() adds a match rule used to dispatch
+ incoming messages. The syntax of the rule passed in
+ match is described in the
+ D-Bus Specification.
+
+
+
+ The message m passed to the callback is only
+ borrowed, that is, the callback should not call
+ sd_bus_message_unref3
+ on it. If the callback wants to hold on to the message beyond the lifetime
+ of the callback, it needs to call
+ sd_bus_message_ref3
+ to create a new reference.
+
+
+
+ If an error occurs during the callback invocation, the callback should
+ return a negative error number. If it wants other callbacks that match the
+ same rule to be called, it should return 0. Otherwise it should return a
+ positive integer.
+
+
+
+
+ Return Value
+
+
+ On success, sd_bus_add_match() returns 0 or a
+ positive integer. On failure, it returns a negative errno-style error
+ code.
+
+
+
+
+ See Also
+
+
+ systemd1,
+ sd-bus3,
+
+
+
+
diff --git a/man/sd_bus_get_fd.xml b/man/sd_bus_get_fd.xml
new file mode 100644
index 0000000000..49162a6e65
--- /dev/null
+++ b/man/sd_bus_get_fd.xml
@@ -0,0 +1,101 @@
+
+
+
+
+
+
+
+
+ sd_bus_get_fd
+ systemd
+
+
+
+ Julian
+ Orth
+ ju.orth@gmail.com
+
+
+
+
+
+ sd_bus_get_fd
+ 3
+
+
+
+ sd_bus_get_fd
+
+ Get the file descriptor connected to the message bus
+
+
+
+
+ #include <systemd/sd-bus.h>
+
+
+ int sd_bus_get_fd
+ sd_bus *bus
+
+
+
+
+
+ Description
+
+
+ sd_bus_get_fd() returns the file descriptor used to
+ communicate with the message bus. This descriptor can be used with
+ select3,
+ poll3,
+ or similar functions to wait for incmming messages.
+
+
+
+ If the bus was created with the
+ sd_bus_set_fd3
+ function, then the input_fd used in that call is
+ returned.
+
+
+
+
+ Return Value
+
+
+ Returns the file descriptor used for incoming messages from the message
+ bus.
+
+
+
+
+ See Also
+
+
+ systemd1,
+ sd-bus3,
+ sd_bus_set_fd3,
+
+
+
+
diff --git a/man/sd_bus_message_read_basic.xml b/man/sd_bus_message_read_basic.xml
new file mode 100644
index 0000000000..6a46403159
--- /dev/null
+++ b/man/sd_bus_message_read_basic.xml
@@ -0,0 +1,113 @@
+
+
+
+
+
+
+
+
+ sd_bus_message_read_basic
+ systemd
+
+
+
+ Julian
+ Orth
+ ju.orth@gmail.com
+
+
+
+
+
+ sd_bus_message_read_basic
+ 3
+
+
+
+ sd_bus_message_read_basic
+
+ Read a basic type from a message
+
+
+
+
+ #include <systemd/sd-bus.h>
+
+
+ int sd_bus_message_read_basic
+ sd_bus_message *m
+ char type
+ void *p
+
+
+
+
+
+ Description
+
+
+ sd_bus_message_read_basic() reads a basic type from a
+ message and advances the read position in the message. The set of basic
+ types and their ascii codes passed in type are
+ described in the D-Bus
+ Specification.
+
+
+
+ If p is not NULL, it should contain a pointer to an
+ appropriate object. For example, if type is
+ 'y', the object passed in p
+ should have type uint8_t *. If type
+ is 's', the object passed in p
+ should have type const char **. Note that, if the basic type
+ is a pointer (e.g., const char * in the case of a string),
+ the pointer is only borrowed and the contents must be copied if they are
+ to be used after the end of the messages lifetime. Similarly, during the
+ lifetime of such a pointer, the message must not be modified.
+
+
+
+ If there is no object of the specified type at the current position in the
+ message, an error is returned.
+
+
+
+
+ Return Value
+
+
+ On success, sd_bus_message_read_basic() returns 0 or
+ a positive integer. On failure, it returns a negative errno-style error
+ code.
+
+
+
+
+ See Also
+
+
+ systemd1,
+ sd-bus3,
+
+
+
+
diff --git a/man/sd_bus_process.xml b/man/sd_bus_process.xml
new file mode 100644
index 0000000000..4b9f52e52f
--- /dev/null
+++ b/man/sd_bus_process.xml
@@ -0,0 +1,111 @@
+
+
+
+
+
+
+
+
+ sd_bus_process
+ systemd
+
+
+
+ Julian
+ Orth
+ ju.orth@gmail.com
+
+
+
+
+
+ sd_bus_process
+ 3
+
+
+
+ sd_bus_process
+
+ Drive the connection
+
+
+
+
+ #include <systemd/sd-bus.h>
+
+
+ int sd_bus_process
+ sd_bus *bus
+ sd_bus_message **r
+
+
+
+
+
+ Description
+
+
+ sd_bus_process() drives the connection between the
+ message bus and the client. That is, it handles connecting,
+ authentication, and message processing. It should be called in a loop
+ until no further progress can be made or an error occurs.
+
+
+
+ Once no further progress can be made,
+ sd_bus_wait3
+ should be called. Alternatively the user can wait for incoming data on
+ the file descriptor returned by
+ sd_bus_get_fd3.
+
+
+
+ sd_bus_process processes at most one incoming
+ message per call. If the parameter r is not NULL
+ and the call processed a message, *r is set to this message.
+ The caller owns a reference to this message and should call
+ sd_bus_message_unref3
+ when the message is no longer needed. If r is not
+ NULL, progress was made, but no message was processed, *r is
+ set to NULL.
+
+
+
+
+ Return Value
+
+
+ If progress was made, a positive integer is returned. If no progress was
+ made, 0 is returned. If an error occurs, a negative errno-style error code
+ is returned.
+
+
+
+
+ See Also
+
+
+ systemd1,
+ sd-bus3,
+
+
+
+