sd_bus_set_exit_on_disconnect(3) — Linux manual page



NAME         top

       sd_bus_set_exit_on_disconnect, sd_bus_get_exit_on_disconnect -
       Control the exit behavior when the bus object disconnects

SYNOPSIS         top

       #include <systemd/sd-bus.h>

       int sd_bus_set_exit_on_disconnect(sd_bus *bus, int b);

       int sd_bus_get_exit_on_disconnect(sd_bus *bus);

DESCRIPTION         top

       sd_bus_set_exit_on_disconnect() may be used to configure the exit
       behavior when the given bus object disconnects. If b is zero, no
       special logic is executed when the bus object disconnects. If b is
       non-zero, the behavior on disconnect depends on whether the bus
       object is attached to an event loop or not. If the bus object is
       attached to an event loop (see sd_bus_attach_event(3)), the event
       loop is closed when the bus object disconnects (as if calling
       sd_event_exit(3)). Otherwise, exit(3) is called. The exit code passed
       to sd_event_exit() and exit() is EXIT_FAILURE. If the bus object has
       already disconnected when enabling the exit behavior, the exit
       behavior is executed immediately. By default, the exit behavior is

       sd_bus_get_exit_on_disconnect() returns whether the exit on
       disconnect behavior is enabled for the given bus object.

RETURN VALUE         top

       On success, sd_bus_set_exit_on_disconnect() returns a non-negative
       integer. On failure, it returns a negative errno-style error code.

       sd_bus_get_exit_on_disconnect() returns a positive integer if the
       exit on disconnect behavior is enabled. Otherwise, it returns zero.

       Returned errors may indicate the following problems:

           A required parameter was NULL.

           The bus object could not be resolved.

           The bus connection was created in a different process.

NOTES         top

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

SEE ALSO         top

       systemd(1), sd-bus(3), sd_bus_attach_event(3), sd-event(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 2020-09-18.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-09-18.)  If you discover 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

systemd 246                                 SD_BUS_SET_EXIT_ON_DISCONNECT(3)

Pages that refer to this page: sd-bus(3)30-systemd-environment-d-generator(7)systemd.directives(7)systemd.index(7)