Other Alias
sd_event_source_unrefp, sd_event_source_refSYNOPSIS
#include <systemd/sd-event.h>
-
sd_event_source* sd_event_source_unref(sd_event_source *source);
- void sd_event_source_unrefp(sd_event_source **source);
- sd_event_source* sd_event_source_ref(sd_event_source *source);
- void sd_event_source_unrefp(sd_event_source **source);
DESCRIPTION
sd_event_source_unref()
sd_event_source_unrefp() is similar to sd_event_source_unref() but takes a pointer to a pointer to an sd_event_source object. This call is useful in conjunction with GCC's and LLVM's m[blue]Clean-up Variable Attributem[][1]. Note that this function is defined as inline function.
sd_event_source_ref() may be used to increase by one the reference counter of the event source object specified as source.
sd_event_source_unref(), sd_bus_creds_unrefp() and sd_bus_creds_ref() execute no operation if the passed event source object is NULL.
Note that event source objects stay alive and may be dispatched as long as they have a reference counter greater than zero. In order to drop a reference of an event source and make sure the associated event source handler function is not called anymore it is recommended to combine a call of sd_event_source_unref() with a prior call to sd_event_source_set_enabled() with SD_EVENT_OFF.
RETURN VALUE
sd_event_source_unref() always returns NULL. sd_event_source_ref() always returns the event source object passed in.
NOTES
These APIs are implemented as a shared library, which can be compiled and linked to with the libsystemd pkg-config(1) file.
NOTES
- 1.
-
Clean-up Variable Attribute