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,