bus: optionally call a callbacks for cleanup
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Wed, 6 Jun 2018 09:07:02 +0000 (11:07 +0200)
committerŁukasz Stelmach <l.stelmach@samsung.com>
Thu, 25 Jan 2024 12:22:10 +0000 (13:22 +0100)
commitcd1b03739b2b79a4867c7f62a6b217ce08543e47
treeacdb092e3ca41a946589a5b361c02cf3cbbc3530
parent64dab9bb056685e59af5407577dd24c9b611bf48
bus: optionally call a callbacks for cleanup

This adds a function sd_bus_slot_set_destroy_callback() to set a function
which can free userdata or perform other cleanups.

sd_bus_slot_get_destory_callback() queries the callback, and is included
for completeness.

Without something like this, for floating asynchronous callbacks, which might
be called or not, depending on the sequence of events, it's hard to perform
resource cleanup. The alternative would be to always perform the cleanup from
the caller too, but that requires more coordination and keeping of some shared
state. It's nicer to keep the cleanup contained between the callback and the
function that requests the callback.
man/rules/meson.build
man/sd_bus_slot_set_destroy_callback.xml [new file with mode: 0644]
src/libsystemd/libsystemd.sym
src/libsystemd/sd-bus/bus-internal.h
src/libsystemd/sd-bus/bus-slot.c
src/systemd/sd-bus.h