1SD_BUS_PROCESS(3) sd_bus_process SD_BUS_PROCESS(3)
2
3
4
6 sd_bus_process - Drive the connection
7
9 #include <systemd/sd-bus.h>
10
11 int sd_bus_process(sd_bus *bus, sd_bus_message **r);
12
14 sd_bus_process() drives the connection between the message bus and the
15 client. That is, it handles connecting, authentication, and message
16 processing. It should be called in a loop until no further progress can
17 be made or an error occurs.
18
19 Once no further progress can be made, sd_bus_wait(3) should be called.
20 Alternatively the user can wait for incoming data on the file
21 descriptor returned by sd_bus_get_fd(3).
22
23 sd_bus_process processes at most one incoming message per call. If the
24 parameter r is not NULL and the call processed a message, *r is set to
25 this message. The caller owns a reference to this message and should
26 call sd_bus_message_unref(3) when the message is no longer needed. If r
27 is not NULL, progress was made, but no message was processed, *r is set
28 to NULL.
29
31 If progress was made, a positive integer is returned. If no progress
32 was made, 0 is returned. If an error occurs, a negative errno-style
33 error code is returned.
34
36 systemd(1), sd-bus(3),
37
38
39
40systemd 239 SD_BUS_PROCESS(3)