SD_BUS_CLOSE

sd_bus_flush() synchronously writes out all outgoing queued message on a bus connection if there are any. This function call may block if the peer is not processing bus messages quickly.

Before a program exits it is usually a good idea to flush any pending messages with sd_bus_flush() and then close connections with sd_bus_close() to ensure that no unwritten messages are lost, no further messages may be queued and all incoming but unprocessed messages are released. After both operations have been done, it is a good idea to also drop any remaining references to the bus object so that it may be freed. Since these three operations are frequently done together a helper call sd_bus_flush_close_unref(3) is provided that combines them into one.  

RETURN VALUE

On success, sd_bus_flush() returns 0 or a positive integer. On failure, it returns a negative errno-style error code.  

Errors

Returned errors may indicate the following problems:

-ECHILD

The bus connection has been created in a different process.

NOTES

These APIs are implemented as a shared library, which can be compiled and linked to with the libsystemd pkg-config(1) file.  

SEE ALSO

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

Index

NAME

SYNOPSIS

DESCRIPTION

RETURN VALUE

Errors

NOTES

SEE ALSO