chiark / gitweb /
treewide: more log_*_errno + return simplifications
[elogind.git] / man / sd_bus_message_get_cookie.xml
index 0e3c4ba723a4eaf1ebee3ec7acc9ae2775569a7d..3e3f9bd7be8acdb33ec9fcd5ef1b7a4521360959 100644 (file)
@@ -21,7 +21,7 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd_bus_message_get_cookie">
+<refentry id="sd_bus_message_get_cookie" conditional="ENABLE_KDBUS">
 
         <refentryinfo>
                 <title>sd_bus_message_get_cookie</title>
 
                         <funcprototype>
                                 <funcdef>int <function>sd_bus_message_get_cookie</function></funcdef>
-                                <paramdef>sd_bus_message<parameter>message</parameter></paramdef>
-                                <paramdef>uint64_t<parameter>cookie</parameter></paramdef>
+                                <paramdef>sd_bus_message *<parameter>message</parameter></paramdef>
+                                <paramdef>uint64_t *<parameter>cookie</parameter></paramdef>
                         </funcprototype>
 
                         <funcprototype>
                                 <funcdef>int <function>sd_bus_message_get_reply_cookie</function></funcdef>
-                                <paramdef>sd_bus_message<parameter>message</parameter></paramdef>
-                                <paramdef>uint64_t<parameter>cookie</parameter></paramdef>
+                                <paramdef>sd_bus_message *<parameter>message</parameter></paramdef>
+                                <paramdef>uint64_t *<parameter>cookie</parameter></paramdef>
                         </funcprototype>
                 </funcsynopsis>
         </refsynopsisdiv>
@@ -85,7 +85,7 @@
                 field.</para>
 
                 <para>Both functions take a message object as first
-                parameter and a place to store the 64bit cookie
+                parameter and a place to store the 64-bit cookie
                 in.</para>
         </refsect1>
 
@@ -97,7 +97,7 @@
                 errno-style error code.</para>
 
                 <para>On success, the cookie/reply cookie is returned
-                in the specified 64bit unsigned integer variable.</para>
+                in the specified 64-bit unsigned integer variable.</para>
         </refsect1>
 
         <refsect1>
 
                 <variablelist>
                         <varlistentry>
-                                <term><varname>-EINVAL</varname></term>
+                                <term><constant>-EINVAL</constant></term>
 
                                 <listitem><para>A specified parameter
                                 is invalid.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>
-                                <term><varname>-ENODATA</varname></term>
+                                <term><constant>-ENODATA</constant></term>
 
                                 <listitem><para>No cookie has been
                                 assigned to this message. This either
                                 been sent yet and hence has no cookie
                                 assigned, or that the message is not a
                                 method response message and hence
-                                carries to reply cookie
+                                carries a reply cookie
                                 field.</para></listitem>
                         </varlistentry>
                 </variablelist>
                 and <function>sd_bus_message_get_reply_cookie()</function>
                 interfaces are available as a shared library, which can
                 be compiled and linked to with the
-                <constant>libsystemd-bus</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+                <constant>libsystemd</constant> <citerefentry project='die-net'><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
                 file.</para>
         </refsect1>