SD_BUS_PROCESS(3)              sd_bus_process              SD_BUS_PROCESS(3)

NAME         top

       sd_bus_process - Drive the connection

SYNOPSIS         top

       #include <systemd/sd-bus.h>

       int sd_bus_process(sd_bus *bus, sd_bus_message **r);

DESCRIPTION         top

       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.

RETURN VALUE         top

       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         top

       systemd(1), sd-bus(3),

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug
       report for this manual page, see 
       ⟨⟩.  This
       page was obtained from the project's upstream Git repository 
       ⟨⟩ on 2017-03-13.  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

systemd 233                                                SD_BUS_PROCESS(3)