|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON |
SD_BUS_PROCESS(3) sd_bus_process 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);
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_wait(3) should be
called. Alternatively the user can wait for incoming data on the file
descriptor returned by sd_bus_get_fd(3).
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_unref(3) 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.
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.
systemd(1), sd-bus(3),
This page is part of the systemd (systemd system and service manager)
project. Information about the project can be found at
⟨http://www.freedesktop.org/wiki/Software/systemd⟩. If you have a bug
report for this manual page, see
⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩. This
page was obtained from the project's upstream Git repository
⟨https://github.com/systemd/systemd.git⟩ on 2017-07-05. If you dis‐
cover any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page, or
you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a mail
to man-pages@man7.org
systemd 234 SD_BUS_PROCESS(3)
Pages that refer to this page: systemd.index(7)