Section: sd_bus_wait (3)
sd_bus_wait - Wait for I/O on a bus connection
int sd_bus_wait(sd_bus *bus, uint64_t timeout_usec);
synchronously waits for I/O on the specified bus connection object. This function is supposed to be called whenever
returns zero, indicating that no work is pending on the connection. Internally, this call invokes
ppoll(2), to wait for I/O on the bus connection. If the
parameter is specified, the call will block at most for the specified amount of time in µs. Pass
to permit it to sleep indefinitely.
After each invocation of
call should be invoked in order to process any now pending I/O work.
is suitable only for simple programs as it does not permit waiting for other I/O events. For more complex programs either connect the bus connection object to an external event loop using
or to an
event loop using
If any I/O was seen, a positive value is returned, zero otherwise. If an error occurs, a negative
errno-style error code is returned.
Returned errors may indicate the following problems:
An invalid bus object was passed.
The bus connection was allocated in a parent process and is being reused in a child process after
The bus connection has been terminated already.
These APIs are implemented as a shared library, which can be compiled and linked to with the