diff options
Diffstat (limited to 'man/sd_event_source_unref.xml')
| -rw-r--r-- | man/sd_event_source_unref.xml | 21 |
1 files changed, 19 insertions, 2 deletions
diff --git a/man/sd_event_source_unref.xml b/man/sd_event_source_unref.xml index 579ec47e8e..2c4d450763 100644 --- a/man/sd_event_source_unref.xml +++ b/man/sd_event_source_unref.xml @@ -44,6 +44,7 @@ <refnamediv> <refname>sd_event_source_unref</refname> + <refname>sd_event_source_unrefp</refname> <refname>sd_event_source_ref</refname> <refpurpose>Increase or decrease event source reference counters</refpurpose> @@ -59,6 +60,11 @@ </funcprototype> <funcprototype> + <funcdef>void <function>sd_event_source_unrefp</function></funcdef> + <paramdef>sd_event_source **<parameter>source</parameter></paramdef> + </funcprototype> + + <funcprototype> <funcdef>sd_event_source* <function>sd_event_source_ref</function></funcdef> <paramdef>sd_event_source *<parameter>source</parameter></paramdef> </funcprototype> @@ -80,12 +86,23 @@ the reference counter reaches zero it is removed from its event loop object and destroyed.</para> + <para><function>sd_event_source_unrefp()</function> is similar to + <function>sd_event_source_unref()</function> but takes a pointer to a + pointer to an <type>sd_event_source</type> object. This call is useful in + conjunction with GCC's and LLVM's <ulink + url="https://gcc.gnu.org/onlinedocs/gcc/Common-Variable-Attributes.html">Clean-up + Variable Attribute</ulink>. Note that this function is defined as + inline function.</para> + <para><function>sd_event_source_ref()</function> may be used to increase by one the reference counter of the event source object specified as <parameter>source</parameter>.</para> - <para>Both functions execute no operation if the passed event - source object is <constant>NULL</constant>.</para> + <para><function>sd_event_source_unref()</function>, + <function>sd_bus_creds_unrefp()</function> and + <function>sd_bus_creds_ref()</function> execute no operation if + the passed event source object is + <constant>NULL</constant>.</para> <para>Note that event source objects stay alive and may be dispatched as long as they have a reference counter greater than |