diff options
author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2022-04-12 11:51:52 +0200 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2022-04-12 12:35:44 +0200 |
commit | 2a1a7910f9af6ec1ce0e5e6e8f271e3ea89b9d8b (patch) | |
tree | f142026abf0e49ac097ca03d19a3f3ff613b4dd8 /man/sd_bus_new.xml | |
parent | man: say libudev should not be used for new projects (diff) | |
download | systemd-2a1a7910f9af6ec1ce0e5e6e8f271e3ea89b9d8b.tar.xz systemd-2a1a7910f9af6ec1ce0e5e6e8f271e3ea89b9d8b.zip |
man: add page for sd_device_{ref,unref,unrefp}
Gotta start somewhere.
Diffstat (limited to 'man/sd_bus_new.xml')
-rw-r--r-- | man/sd_bus_new.xml | 12 |
1 files changed, 5 insertions, 7 deletions
diff --git a/man/sd_bus_new.xml b/man/sd_bus_new.xml index 355b34bad8..41964640b6 100644 --- a/man/sd_bus_new.xml +++ b/man/sd_bus_new.xml @@ -109,7 +109,7 @@ pointer to an <type>sd_bus</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 + Variable Attribute</ulink>. Note that this function is defined as an inline function. Use a declaration like the following, in order to allocate a bus object that is freed automatically as the code block is left:</para> @@ -124,12 +124,10 @@ … }</programlisting> - <para><function>sd_bus_ref()</function> and <function>sd_bus_unref()</function> - execute no operation if the passed in bus object address is - <constant>NULL</constant>. <function>sd_bus_unrefp()</function> will first - dereference its argument, which must not be <constant>NULL</constant>, and will - execute no operation if <emphasis>that</emphasis> is <constant>NULL</constant>. - </para> + <para><function>sd_bus_ref()</function> and <function>sd_bus_unref()</function> execute no operation if + the argument is <constant>NULL</constant>. <function>sd_bus_unrefp()</function> will first dereference + its argument, which must not be <constant>NULL</constant>, and will execute no operation if + <emphasis>that</emphasis> is <constant>NULL</constant>.</para> <para><function>sd_bus_close_unref()</function> is similar to <function>sd_bus_unref()</function>, but first executes |