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)
committerAdrian Szyndela <adrian.s@samsung.com>
Wed, 4 Mar 2020 09:40:38 +0000 (10:40 +0100)
commita08c7d252f1489366ca8d370cebda93290f47ffe
tree7e4fb9f3e61710993180ec74fd55ddc337ac0e25
parentaf46d5ed962bd515f718546d58d4f2535a4ccfad
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