system/systemd
system/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd synced 2024-10-04 15:21:01 +00:00
Code Issues Packages Projects Releases Wiki Activity

man: make separate "Errors" sections subsection of "Return value"

Browse source 
Logically, this is better, because we're describing a subset of possible
return values. Visually this also looks quite good because groff renders
refsect2 much less prominently.

Also rewrap things, add <constant> in various places, fix some typos.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2019-03-21 14:53:00 +01:00
parent 6d99c5d1d9
commit b1de39dec8
74 changed files with 1572 additions and 1650 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
man/sd_bus_attach_event.xml
View file

@ -84,20 +84,20 @@
0 or a positive integer. On failure, they return a negative errno-style error code.</para> 0 or a positive integer. On failure, they return a negative errno-style error code.</para>
<para><function>sd_bus_get_event()</function> returns an event loop object or <constant>NULL</constant>.</para> <para><function>sd_bus_get_event()</function> returns an event loop object or <constant>NULL</constant>.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection has been created in a different process.</para></listitem> <listitem><para>The bus connection has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

20
man/sd_bus_close.xml
View file

@ -66,20 +66,20 @@
<para>On success, <function>sd_bus_flush()</function> returns 0 or a positive integer. On failure, it returns a <para>On success, <function>sd_bus_flush()</function> returns 0 or a positive integer. On failure, it returns a
negative errno-style error code.</para> negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection has been created in a different process.</para></listitem> <listitem><para>The bus connection has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

83
man/sd_bus_creds_get_pid.xml
View file

@ -455,62 +455,53 @@
<para>On success, these calls return 0 or a positive integer. On <para>On success, these calls return 0 or a positive integer. On
failure, these calls return a negative errno-style error code. failure, these calls return a negative errno-style error code.
</para> </para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENODATA</constant></term> <term><constant>-ENODATA</constant></term>
<listitem><para>The given field is not available in the <listitem><para>The given field is not available in the credentials object
credentials object <parameter>c</parameter>.</para> <parameter>c</parameter>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>The given field is not specified for the described <listitem><para>The given field is not specified for the described process or peer. This will be
process or peer. This will be returned by returned by <function>sd_bus_creds_get_unit()</function>,
<function>sd_bus_creds_get_unit()</function>, <function>sd_bus_creds_get_slice()</function>, <function>sd_bus_creds_get_user_unit()</function>,
<function>sd_bus_creds_get_slice()</function>, <function>sd_bus_creds_get_user_slice()</function>, and
<function>sd_bus_creds_get_user_unit()</function>, <function>sd_bus_creds_get_session()</function> if the process is not part of a systemd system
<function>sd_bus_creds_get_user_slice()</function>, and unit, systemd user unit, systemd slice, or logind session. It will be returned by
<function>sd_bus_creds_get_session()</function> if the process is <function>sd_bus_creds_get_owner_uid()</function> if the process is not part of a systemd user unit
not part of a systemd system unit, systemd user unit, systemd or logind session. It will also be returned by <function>sd_bus_creds_get_exe()</function> and
slice, or logind session. It will be returned by <function>sd_bus_creds_get_cmdline()</function> for kernel threads (since these are not started
<function>sd_bus_creds_get_owner_uid()</function> if the process is from an executable binary, nor have a command line), and by
not part of a systemd user unit or logind session. It will also be <function>sd_bus_creds_get_audit_session_id()</function> and
returned by <function>sd_bus_creds_get_exe()</function> and <function>sd_bus_creds_get_audit_login_uid()</function> when the process is not part of an audit
<function>sd_bus_creds_get_cmdline()</function> for kernel session, and <function>sd_bus_creds_get_tty()</function> if the process has no controlling
threads (since these are not started from an executable binary, TTY.</para></listitem>
nor have a command line), and by </varlistentry>
<function>sd_bus_creds_get_audit_session_id()</function> and
<function>sd_bus_creds_get_audit_login_uid()</function> when
the process is not part of an audit session, and
<function>sd_bus_creds_get_tty()</function> if the process has
no controlling TTY.
</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>Specified pointer parameter is <constant>NULL</constant>. <listitem><para>Specified pointer parameter is <constant>NULL</constant>.</para></listitem>
</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

48
man/sd_bus_creds_new_from_pid.xml
View file

@ -261,42 +261,40 @@
not needed anymore, this reference should be destroyed with not needed anymore, this reference should be destroyed with
<citerefentry><refentrytitle>sd_bus_creds_unref</refentrytitle><manvolnum>3</manvolnum></citerefentry>. <citerefentry><refentrytitle>sd_bus_creds_unref</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
</para> </para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ESRCH</constant></term> <term><constant>-ESRCH</constant></term>
<listitem><para>Specified <parameter>pid</parameter> could not <listitem><para>Specified <parameter>pid</parameter> could not be found.</para></listitem>
be found.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>Specified parameter is invalid <listitem><para>Specified parameter is invalid (<constant>NULL</constant> in case of output
(<constant>NULL</constant> in case of output parameters).</para></listitem>
parameters).</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EOPNOTSUPP</constant></term> <term><constant>-EOPNOTSUPP</constant></term>
<listitem><para>One of the requested fields is unknown to the local system.</para></listitem> <listitem><para>One of the requested fields is unknown to the local system.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

41
man/sd_bus_default.xml
View file

@ -269,36 +269,37 @@
<para>On success, these calls return 0 or a positive <para>On success, these calls return 0 or a positive
integer. On failure, these calls return a negative integer. On failure, these calls return a negative
errno-style error code.</para> errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The specified parameters are invalid.</para></listitem> <listitem><para>The specified parameters are invalid.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESOCKTNOSUPPORT</constant></term> <term><constant>-ESOCKTNOSUPPORT</constant></term>
<listitem><para>The protocol version required to connect to the selected bus is not supported.</para></listitem> <listitem><para>The protocol version required to connect to the selected bus is not
</varlistentry> supported.</para></listitem>
</variablelist> </varlistentry>
</variablelist>
<para>In addition, any further connection-related errors may be <para>In addition, any further connection-related errors may be by returned. See
by returned. See <citerefentry><refentrytitle>sd_bus_send</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para> <citerefentry><refentrytitle>sd_bus_send</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

31
man/sd_bus_error.xml
View file

@ -325,29 +325,28 @@
project='man-pages'><refentrytitle>free</refentrytitle><manvolnum>3</manvolnum></citerefentry> project='man-pages'><refentrytitle>free</refentrytitle><manvolnum>3</manvolnum></citerefentry>
the memory held by the structure itself after freeing its contents the memory held by the structure itself after freeing its contents
with <function>sd_bus_error_free()</function>.</para> with <function>sd_bus_error_free()</function>.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>Error was already set in <listitem><para>Error was already set in <structname>sd_bus_error</structname> structure when one
<structname>sd_bus_error</structname> structure when one the the error-setting functions was called.</para></listitem>
error-setting functions was called.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

28
man/sd_bus_error_add_map.xml
View file

@ -98,27 +98,27 @@
tables. It returns zero when the same array was already added tables. It returns zero when the same array was already added
before. On error, a negative <varname>errno</varname>-style error before. On error, a negative <varname>errno</varname>-style error
code is returned. See below for known error codes.</para> code is returned. See below for known error codes.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The specified mapping array is invalid.</para></listitem> <listitem><para>The specified mapping array is invalid.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

50
man/sd_bus_get_fd.xml
View file

@ -104,41 +104,41 @@
<para><function>sd_bus_get_timeout()</function> returns zero or positive on success, or a negative <para><function>sd_bus_get_timeout()</function> returns zero or positive on success, or a negative
<varname>errno</varname>-style error code on error.</para> <varname>errno</varname>-style error code on error.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid bus object was passed.</para></listitem> <listitem><para>An invalid bus object was passed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection was allocated in a parent process and is being reused in a child process <listitem><para>The bus connection was allocated in a parent process and is being reused in a child
after <function>fork()</function>.</para></listitem> process after <function>fork()</function>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOTCONN</constant></term> <term><constant>-ENOTCONN</constant></term>
<listitem><para>The bus connection has been terminated.</para></listitem> <listitem><para>The bus connection has been terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>Two distinct file descriptors were passed for input and output using <listitem><para>Two distinct file descriptors were passed for input and output using
<function>sd_bus_set_fd()</function>, which <function>sd_bus_get_fd()</function> cannot <function>sd_bus_set_fd()</function>, which <function>sd_bus_get_fd()</function> cannot
return.</para></listitem> return.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

20
man/sd_bus_get_n_queued_read.xml
View file

@ -68,21 +68,21 @@
<para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style <para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style
error code.</para> error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection was created in a different process.</para></listitem> <listitem><para>The bus connection was created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<refsect1> <refsect1>

20
man/sd_bus_is_open.xml
View file

@ -70,20 +70,20 @@
<para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style <para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style
error code.</para> error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection has been created in a different process.</para></listitem> <listitem><para>The bus connection has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

7
man/sd_bus_message_append.xml
View file

@ -227,12 +227,11 @@ sd_bus_message_append(m, "ynqiuxtd", y, n, q, i, u, x, t, d);</programlisting>
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these functions return 0 or a positive <para>On success, these functions return 0 or a positive integer. On failure, they return a negative
integer. On failure, these functions return a negative
errno-style error code.</para> errno-style error code.</para>
</refsect1>
<xi:include href="sd_bus_message_append_basic.xml" xpointer="errors" /> <xi:include href="sd_bus_message_append_basic.xml" xpointer="errors" />
</refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

8
man/sd_bus_message_append_array.xml
View file

@ -154,11 +154,11 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these calls return 0 or a positive integer. On <para>On success, these calls return 0 or a positive integer. On failure, they return a negative
failure, they return a negative errno-style error code.</para> errno-style error code.</para>
</refsect1>
<xi:include href="sd_bus_message_append_basic.xml" xpointer="errors" /> <xi:include href="sd_bus_message_append_basic.xml" xpointer="errors" />
</refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

60
man/sd_bus_message_append_basic.xml
View file

@ -199,49 +199,49 @@
<para>On success, this call returns 0 or a positive integer. On <para>On success, this call returns 0 or a positive integer. On
failure, it returns a negative errno-style error code.</para> failure, it returns a negative errno-style error code.</para>
</refsect1>
<refsect1 id='errors'> <refsect2 id='errors'>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>Specified parameter is invalid. <listitem><para>Specified parameter is invalid.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>Message has been sealed. <listitem><para>Message has been sealed.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>Message is in invalid state. <listitem><para>Message is in invalid state.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>Message cannot be appended to. <listitem><para>Message cannot be appended to.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

8
man/sd_bus_message_append_string_memfd.xml
View file

@ -97,11 +97,11 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, those calls return 0 or a positive integer. On <para>On success, those calls return 0 or a positive integer. On failure, they return a negative
failure, they returns a negative errno-style error code.</para> errno-style error code.</para>
</refsect1>
<xi:include href="sd_bus_message_append_basic.xml" xpointer="errors" /> <xi:include href="sd_bus_message_append_basic.xml" xpointer="errors" />
</refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

8
man/sd_bus_message_append_strv.xml
View file

@ -58,11 +58,11 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, this call returns 0 or a positive integer. On <para>On success, this call returns 0 or a positive integer. On failure, a negative errno-style error
failure, a negative errno-style error code is returned.</para> code is returned.</para>
</refsect1>
<xi:include href="sd_bus_message_append_basic.xml" xpointer="errors" /> <xi:include href="sd_bus_message_append_basic.xml" xpointer="errors" />
</refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

61
man/sd_bus_message_copy.xml
View file

@ -51,50 +51,49 @@
<para>On success, this call returns true if anything was copied, and false if <para>On success, this call returns true if anything was copied, and false if
there was nothing to copy. On failure, it returns a negative errno-style error there was nothing to copy. On failure, it returns a negative errno-style error
code.</para> code.</para>
</refsect1>
<refsect1 id='errors'> <refsect2 id='errors'>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para><parameter>source</parameter> or <parameter>m</parameter> are <listitem><para><parameter>source</parameter> or <parameter>m</parameter> are
<constant>NULL</constant>.</para></listitem> <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>Message <parameter>m</parameter> has been sealed or <listitem><para>Message <parameter>m</parameter> has been sealed or <parameter>source</parameter>
<parameter>source</parameter> has <emphasis>not</emphasis> been sealed. has <emphasis>not</emphasis> been sealed. </para></listitem>
</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>Destination message is in invalid state. <listitem><para>Destination message is in invalid state.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>Destination message cannot be appended to. <listitem><para>Destination message cannot be appended to.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

44
man/sd_bus_message_get_cookie.xml
View file

@ -63,37 +63,33 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these calls return 0 or a positive integer. On <para>On success, these calls return 0 or a positive integer. On failure, they return a negative
failure, these calls return a negative errno-style error errno-style error code.</para>
code.</para>
<para>On success, the cookie/reply cookie is returned in the <para>On success, the cookie/reply cookie is returned in the specified 64-bit unsigned integer
specified 64-bit unsigned integer variable.</para> variable.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>A specified parameter <listitem><para>A specified parameter is invalid.</para></listitem>
is invalid.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENODATA</constant></term> <term><constant>-ENODATA</constant></term>
<listitem><para>No cookie has been assigned to this message. <listitem><para>No cookie has been assigned to this message. This either indicates that the
This either indicates that the message has not been sent yet message has not been sent yet and hence has no cookie assigned, or that the message is not a method
and hence has no cookie assigned, or that the message is not a response message and hence carries a reply cookie field.</para></listitem>
method response message and hence carries a reply cookie </varlistentry>
field.</para></listitem> </variablelist>
</varlistentry> </refsect2>
</variablelist>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

37
man/sd_bus_message_get_monotonic_usec.xml
View file

@ -98,32 +98,29 @@
<para>On success, the timestamp or sequence number is returned in <para>On success, the timestamp or sequence number is returned in
the specified 64-bit unsigned integer variable.</para> the specified 64-bit unsigned integer variable.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>A specified parameter is <listitem><para>A specified parameter is invalid.</para></listitem>
invalid.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENODATA</constant></term> <term><constant>-ENODATA</constant></term>
<listitem><para>No timestamp or sequence number information is <listitem><para>No timestamp or sequence number information is attached to the passed message. This
attached to the passed message. This error is returned if the error is returned if the underlying transport does not support timestamping or assigning of
underlying transport does not support timestamping or sequence numbers, or if this feature has not been negotiated with
assigning of sequence numbers, or if this feature has not been <citerefentry><refentrytitle>sd_bus_negotiate_timestamp</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para></listitem>
negotiated with </varlistentry>
<citerefentry><refentrytitle>sd_bus_negotiate_timestamp</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para></listitem> </variablelist>
</varlistentry> </refsect2>
</variablelist>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

32
man/sd_bus_message_get_signature.xml
View file

@ -72,28 +72,28 @@
<para>The other functions return 0 or a positive integer on success. On failure, they return a <para>The other functions return 0 or a positive integer on success. On failure, they return a
negative errno-style error code.</para> negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>message</parameter> parameter is <constant>NULL</constant>. <listitem><para>The <parameter>message</parameter> parameter is <constant>NULL</constant>.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>NULL</constant></term> <term><constant>NULL</constant></term>
<listitem><para>The <parameter>message</parameter> parameter is <constant>NULL</constant>. <listitem><para>The <parameter>message</parameter> parameter is <constant>NULL</constant>.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

22
man/sd_bus_message_get_type.xml
View file

@ -96,21 +96,21 @@
<para>On success, those functions return 0 or a positive <para>On success, those functions return 0 or a positive
integer. On failure, it returns a negative errno-style error code.</para> integer. On failure, it returns a negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>message</parameter> parameter or the output parameter are <listitem><para>The <parameter>message</parameter> parameter or the output parameter are
<constant>NULL</constant>.</para></listitem> <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

38
man/sd_bus_message_new.xml
View file

@ -141,33 +141,33 @@
<constant>NULL</constant>.</para> <constant>NULL</constant>.</para>
<para><function>sd_bus_message_get_bus()</function> always returns the bus object.</para> <para><function>sd_bus_message_get_bus()</function> always returns the bus object.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>Specified <parameter>type</parameter> is invalid.</para></listitem> <listitem><para>Specified <parameter>type</parameter> is invalid.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOTCONN</constant></term> <term><constant>-ENOTCONN</constant></term>
<listitem><para>The bus parameter <parameter>bus</parameter> is <constant>NULL</constant> or <listitem><para>The bus parameter <parameter>bus</parameter> is <constant>NULL</constant> or
the bus is not connected.</para></listitem> the bus is not connected.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

80
man/sd_bus_message_new_method_call.xml
View file

@ -82,60 +82,60 @@
<para>This function returns 0 if the message object was successfully created, and a negative <para>This function returns 0 if the message object was successfully created, and a negative
errno-style error code otherwise.</para> errno-style error code otherwise.</para>
</refsect1>
<refsect1 id='errors'> <refsect2 id='errors'>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The output parameter <parameter>m</parameter> is <listitem><para>The output parameter <parameter>m</parameter> is
<constant>NULL</constant>.</para> <constant>NULL</constant>.</para>
<para>The <parameter>destination</parameter> parameter is non-null and is not a valid D-Bus <para>The <parameter>destination</parameter> parameter is non-null and is not a valid D-Bus
service name (<literal>org.somewhere.Something</literal>), the <parameter>path</parameter> service name (<literal>org.somewhere.Something</literal>), the <parameter>path</parameter>
parameter is not a valid D-Bus path (<literal>/an/object/path</literal>), the parameter is not a valid D-Bus path (<literal>/an/object/path</literal>), the
<parameter>interface</parameter> parameter is non-null and is not a valid D-Bus interface <parameter>interface</parameter> parameter is non-null and is not a valid D-Bus interface
name (<literal>an.interface.name</literal>), or the <parameter>member</parameter> parameter name (<literal>an.interface.name</literal>), or the <parameter>member</parameter> parameter
is not a valid D-Bus member (<literal>Name</literal>).</para> is not a valid D-Bus member (<literal>Name</literal>).</para>
<para>The <parameter>call</parameter> parameter is not a method call object.</para> <para>The <parameter>call</parameter> parameter is not a method call object.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOTCONN</constant></term> <term><constant>-ENOTCONN</constant></term>
<listitem><para>The bus parameter <parameter>bus</parameter> is <constant>NULL</constant> or <listitem><para>The bus parameter <parameter>bus</parameter> is <constant>NULL</constant> or
the bus is not connected.</para></listitem> the bus is not connected.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem> <listitem>
<para>The <parameter>call</parameter> parameter is not sealed.</para> <para>The <parameter>call</parameter> parameter is not sealed.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EOPNOTSUPP</constant></term> <term><constant>-EOPNOTSUPP</constant></term>
<listitem> <listitem>
<para>The <parameter>call</parameter> message does not have a cookie.</para> <para>The <parameter>call</parameter> message does not have a cookie.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

64
man/sd_bus_message_new_method_error.xml
View file

@ -127,50 +127,50 @@
<para>These functions return 0 if the error reply was successfully created, and a <para>These functions return 0 if the error reply was successfully created, and a
negative errno-style error code otherwise.</para> negative errno-style error code otherwise.</para>
</refsect1>
<refsect1 id='errors'> <refsect2 id='errors'>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The call message <parameter>call</parameter> or the output <listitem><para>The call message <parameter>call</parameter> or the output
parameter <parameter>m</parameter> are <constant>NULL</constant>.</para> parameter <parameter>m</parameter> are <constant>NULL</constant>.</para>
<para>Message <parameter>call</parameter> is not a method call <para>Message <parameter>call</parameter> is not a method call
message.</para> message.</para>
<para>The error <parameter>error</parameter> parameter to <para>The error <parameter>error</parameter> parameter to
<function>sd_bus_message_new_method_error</function> is not set, see <function>sd_bus_message_new_method_error</function> is not set, see
<citerefentry><refentrytitle>sd_bus_error_is_set</refentrytitle><manvolnum>3</manvolnum></citerefentry>. <citerefentry><refentrytitle>sd_bus_error_is_set</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>Message <parameter>call</parameter> has been sealed. <listitem><para>Message <parameter>call</parameter> has been sealed.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOTCONN</constant></term> <term><constant>-ENOTCONN</constant></term>
<listitem><para>The bus to which message <parameter>call</parameter> is <listitem><para>The bus to which message <parameter>call</parameter> is
attached is not connected.</para></listitem> attached is not connected.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

50
man/sd_bus_message_new_signal.xml
View file

@ -56,40 +56,40 @@
<para>This function returns 0 if the message object was successfully created, and a negative <para>This function returns 0 if the message object was successfully created, and a negative
errno-style error code otherwise.</para> errno-style error code otherwise.</para>
</refsect1>
<refsect1 id='errors'> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The output parameter <parameter>m</parameter> is <listitem><para>The output parameter <parameter>m</parameter> is
<constant>NULL</constant>.</para> <constant>NULL</constant>.</para>
<para>The <parameter>path</parameter> parameter is not a valid D-Bus path <para>The <parameter>path</parameter> parameter is not a valid D-Bus path
(<literal>/an/object/path</literal>), the <parameter>interface</parameter> parameter is not (<literal>/an/object/path</literal>), the <parameter>interface</parameter> parameter is not
a valid D-Bus interface name (<literal>an.interface.name</literal>), or the a valid D-Bus interface name (<literal>an.interface.name</literal>), or the
<parameter>member</parameter> parameter is not a valid D-Bus member <parameter>member</parameter> parameter is not a valid D-Bus member
(<literal>Name</literal>).</para></listitem> (<literal>Name</literal>).</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOTCONN</constant></term> <term><constant>-ENOTCONN</constant></term>
<listitem><para>The bus parameter <parameter>bus</parameter> is <constant>NULL</constant> or <listitem><para>The bus parameter <parameter>bus</parameter> is <constant>NULL</constant> or
the bus is not connected.</para></listitem> the bus is not connected.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

12
man/sd_bus_message_read.xml
View file

@ -154,14 +154,12 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para> <para>On success, <function>sd_bus_message_read()</function> and
On success, <function>sd_bus_message_read()</function> and <function>sd_bus_message_readv()</function> return 0 or a positive integer. On failure, they return a
<function>sd_bus_message_readv()</function> return 0 or a positive integer. On negative errno-style error code.</para>
failure, they return a negative errno-style error code.
</para>
</refsect1>
<xi:include href="sd_bus_message_read_basic.xml" xpointer="errors" /> <xi:include href="sd_bus_message_read_basic.xml" xpointer="errors" />
</refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

48
man/sd_bus_message_read_array.xml
View file

@ -58,41 +58,41 @@
a positive integer. On failure, it returns a negative errno-style error a positive integer. On failure, it returns a negative errno-style error
code. code.
</para> </para>
</refsect1>
<refsect1 id='errors'> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>Specified type is invalid or the message parameter or one of the output <listitem><para>Specified type is invalid or the message parameter or one of the output
parameters are <constant>NULL</constant>.</para></listitem> parameters are <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EOPNOTSUPP</constant></term> <term><constant>-EOPNOTSUPP</constant></term>
<listitem><para>The byte order in the message is different than native byte <listitem><para>The byte order in the message is different than native byte
order.</para></listitem> order.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>The message is not sealed.</para></listitem> <listitem><para>The message is not sealed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EBADMSG</constant></term> <term><constant>-EBADMSG</constant></term>
<listitem><para>The message cannot be parsed.</para></listitem> <listitem><para>The message cannot be parsed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<refsect1> <refsect1>

40
man/sd_bus_message_read_basic.xml
View file

@ -190,34 +190,34 @@
a positive integer. On failure, it returns a negative errno-style error a positive integer. On failure, it returns a negative errno-style error
code. code.
</para> </para>
</refsect1>
<refsect1 id='errors'> <refsect2 id='errors'>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>Specified type string is invalid or the message parameter is <listitem><para>Specified type string is invalid or the message parameter is
<constant>NULL</constant>.</para></listitem> <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>The message does not contain the specified type at current <listitem><para>The message does not contain the specified type at current position.
position.</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EBADMSG</constant></term> <term><constant>-EBADMSG</constant></term>
<listitem><para>The message cannot be parsed.</para></listitem> <listitem><para>The message cannot be parsed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<refsect1> <refsect1>

40
man/sd_bus_message_rewind.xml
View file

@ -51,30 +51,30 @@
container or whole message in case no container is open is empty, and positive otherwise. On container or whole message in case no container is open is empty, and positive otherwise. On
failure, it returns a negative errno-style error code. failure, it returns a negative errno-style error code.
</para> </para>
<refsect2>
<title>Errors</title>
<para>Returned errors may indicate the following problems:</para>
<variablelist>
<varlistentry>
<term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>m</parameter> parameter is <constant>NULL</constant>.</para></listitem>
</varlistentry>
<varlistentry>
<term><constant>-EPERM</constant></term>
<listitem><para>The message <parameter>m</parameter> has not been sealed.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />
<refsect1>
<title>Errors</title>
<para>Returned errors may indicate the following problems:</para>
<variablelist>
<varlistentry>
<term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>m</parameter> parameter is <constant>NULL</constant>.</para></listitem>
</varlistentry>
<varlistentry>
<term><constant>-EPERM</constant></term>
<listitem><para>The message <parameter>m</parameter> has not been sealed.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>See Also</title> <title>See Also</title>

42
man/sd_bus_message_set_destination.xml
View file

@ -106,35 +106,35 @@
<para>On success, these calls return 0 or a positive integer. On failure, these calls return a <para>On success, these calls return 0 or a positive integer. On failure, these calls return a
negative errno-style error code.</para> negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>message</parameter> parameter or the output parameter are <listitem><para>The <parameter>message</parameter> parameter or the output parameter are
<constant>NULL</constant>.</para></listitem> <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>For <function>sd_bus_message_set_destination</function> or <listitem><para>For <function>sd_bus_message_set_destination</function> or
<function>sd_bus_message_set_sender</function>, the message is already <function>sd_bus_message_set_sender</function>, the message is already
sealed.</para></listitem> sealed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EEXIST</constant></term> <term><constant>-EEXIST</constant></term>
<listitem><para>The message already has a destination or sender field set.</para></listitem> <listitem><para>The message already has a destination or sender field set.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

38
man/sd_bus_message_set_expect_reply.xml
View file

@ -84,32 +84,32 @@
<para>On success, these functions return 0 or a positive integer. On failure, they return a <para>On success, these functions return 0 or a positive integer. On failure, they return a
negative errno-style error code.</para> negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>message</parameter> parameter is <listitem><para>The <parameter>message</parameter> parameter is
<constant>NULL</constant>.</para></listitem> <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>The message <parameter>message</parameter> is sealed <listitem><para>The message <parameter>message</parameter> is sealed
when trying to set a flag.</para> when trying to set a flag.</para>
<para>The message <parameter>message</parameter> has wrong <para>The message <parameter>message</parameter> has wrong
type.</para> type.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

56
man/sd_bus_message_skip.xml
View file

@ -50,46 +50,46 @@
<para>On success, <function>sd_bus_message_skip()</function> returns 0 or a positive integer. On <para>On success, <function>sd_bus_message_skip()</function> returns 0 or a positive integer. On
failure, it returns a negative errno-style error code.</para> failure, it returns a negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>m</parameter> parameter is <listitem><para>The <parameter>m</parameter> parameter is
<constant>NULL</constant>.</para></listitem> <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EBADMSG</constant></term> <term><constant>-EBADMSG</constant></term>
<listitem><para>The message cannot be parsed.</para></listitem> <listitem><para>The message cannot be parsed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>The message is not sealed.</para></listitem> <listitem><para>The message is not sealed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>The message end has been reached and the requested elements cannot be read. <listitem><para>The message end has been reached and the requested elements cannot be read.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

36
man/sd_bus_message_verify_type.xml
View file

@ -56,32 +56,32 @@
<para>On success, this call returns true if the type matches and zero if not (the message <para>On success, this call returns true if the type matches and zero if not (the message
<parameter>m</parameter> contains different data or the end of the message has been reached). On <parameter>m</parameter> contains different data or the end of the message has been reached). On
failure, it returns a negative errno-style error code.</para> failure, it returns a negative errno-style error code.</para>
</refsect1>
<refsect1 id='errors'> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para><parameter>m</parameter> or both <parameter>type</parameter> and <listitem><para><parameter>m</parameter> or both <parameter>type</parameter> and
<parameter>contents</parameter> are <constant>NULL</constant>.</para> <parameter>contents</parameter> are <constant>NULL</constant>.</para>
<para>Arguments do not satisfy other contraints listed above.</para> <para>Arguments do not satisfy other contraints listed above.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>Message <parameter>m</parameter> is not sealed. <listitem><para>Message <parameter>m</parameter> is not sealed.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

20
man/sd_bus_negotiate_fds.xml
View file

@ -108,20 +108,20 @@
<para>On success, these functions return 0 or a <para>On success, these functions return 0 or a
positive integer. On failure, they return a negative errno-style positive integer. On failure, they return a negative errno-style
error code.</para> error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>The bus connection has already been started.</para></listitem> <listitem><para>The bus connection has already been started.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

20
man/sd_bus_new.xml
View file

@ -166,20 +166,20 @@
<para><function>sd_bus_unref()</function> and <function>sd_bus_flush_close_unref()</function> always return <para><function>sd_bus_unref()</function> and <function>sd_bus_flush_close_unref()</function> always return
<constant>NULL</constant>.</para> <constant>NULL</constant>.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

62
man/sd_bus_process.xml
View file

@ -69,49 +69,49 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>If progress was made, a positive integer is returned. If no progress was made, 0 is returned. If an error <para>If progress was made, a positive integer is returned. If no progress was made, 0 is returned. If an
occurs, a negative <varname>errno</varname>-style error code is returned.</para> error occurs, a negative <varname>errno</varname>-style error code is returned.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid bus object was passed.</para></listitem> <listitem><para>An invalid bus object was passed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection was allocated in a parent process and is being reused in a child process <listitem><para>The bus connection was allocated in a parent process and is being reused in a child
after <function>fork()</function>.</para></listitem> process after <function>fork()</function>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOTCONN</constant></term> <term><constant>-ENOTCONN</constant></term>
<listitem><para>The bus connection has been terminated already.</para></listitem> <listitem><para>The bus connection has been terminated already.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECONNRESET</constant></term> <term><constant>-ECONNRESET</constant></term>
<listitem><para>The bus connection has been terminated just now.</para></listitem> <listitem><para>The bus connection has been terminated just now.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EBUSY</constant></term> <term><constant>-EBUSY</constant></term>
<listitem><para>This function is already being called, i.e. <function>sd_bus_process()</function> has been <listitem><para>This function is already being called, i.e. <function>sd_bus_process()</function>
called from a callback function that itself was called by has been called from a callback function that itself was called by
<function>sd_bus_process()</function>.</para></listitem> <function>sd_bus_process()</function>.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

72
man/sd_bus_reply_method_error.xml
View file

@ -91,56 +91,56 @@
<para>These functions return 0 if the error reply was successfully sent or if <para>These functions return 0 if the error reply was successfully sent or if
none was expected, and a negative errno-style error code otherwise.</para> none was expected, and a negative errno-style error code otherwise.</para>
</refsect1>
<refsect1 id='errors'> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The call message <parameter>call</parameter> is <listitem><para>The call message <parameter>call</parameter> is
<constant>NULL</constant>.</para> <constant>NULL</constant>.</para>
<para>Message <parameter>call</parameter> is not a method call message. <para>Message <parameter>call</parameter> is not a method call message.
</para> </para>
<para>Message <parameter>call</parameter> is not attached to a bus.</para> <para>Message <parameter>call</parameter> is not attached to a bus.</para>
<para>The error <parameter>error</parameter> parameter to <para>The error <parameter>error</parameter> parameter to
<function>sd_bus_reply_method_error</function> is not set, see <function>sd_bus_reply_method_error</function> is not set, see
<citerefentry><refentrytitle>sd_bus_error_is_set</refentrytitle><manvolnum>3</manvolnum></citerefentry>. <citerefentry><refentrytitle>sd_bus_error_is_set</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>Message <parameter>call</parameter> has been sealed. <listitem><para>Message <parameter>call</parameter> has been sealed.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOTCONN</constant></term> <term><constant>-ENOTCONN</constant></term>
<listitem><para>The bus to which message <parameter>call</parameter> is <listitem><para>The bus to which message <parameter>call</parameter> is attached is not
attached is not connected.</para></listitem> connected.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>In addition, any error message returned by <para>In addition, any error message returned by
<citerefentry><refentrytitle>sd_bus_send</refentrytitle><manvolnum>1</manvolnum></citerefentry> <citerefentry><refentrytitle>sd_bus_send</refentrytitle><manvolnum>1</manvolnum></citerefentry>
may be returned.</para> may be returned.</para>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

82
man/sd_bus_request_name.xml
View file

@ -132,63 +132,63 @@
case, the caller can subscribe to <literal>NameOwnerChanged</literal> signals to be notified when the name is case, the caller can subscribe to <literal>NameOwnerChanged</literal> signals to be notified when the name is
successfully acquired. <function>sd_bus_request_name()</function> returns &gt; 0 when the name has immediately successfully acquired. <function>sd_bus_request_name()</function> returns &gt; 0 when the name has immediately
been acquired successfully.</para> been acquired successfully.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EALREADY</constant></term> <term><constant>-EALREADY</constant></term>
<listitem><para>The caller already is the owner of the specified name.</para></listitem> <listitem><para>The caller already is the owner of the specified name.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EEXIST</constant></term> <term><constant>-EEXIST</constant></term>
<listitem><para>The name has already been acquired by a different peer, and SD_BUS_NAME_REPLACE_EXISTING was <listitem><para>The name has already been acquired by a different peer, and SD_BUS_NAME_REPLACE_EXISTING was
not specified or the other peer did not specify SD_BUS_NAME_ALLOW_REPLACEMENT while acquiring the not specified or the other peer did not specify SD_BUS_NAME_ALLOW_REPLACEMENT while acquiring the
name.</para></listitem> name.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESRCH</constant></term> <term><constant>-ESRCH</constant></term>
<listitem><para>It was attempted to release a name that is currently not registered on the <listitem><para>It was attempted to release a name that is currently not registered on the
bus.</para></listitem> bus.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EADDRINUSE</constant></term> <term><constant>-EADDRINUSE</constant></term>
<listitem><para>It was attempted to release a name that is owned by a different peer on the <listitem><para>It was attempted to release a name that is owned by a different peer on the
bus.</para></listitem> bus.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>A specified parameter is invalid. This is also generated when the requested name is a special <listitem><para>A specified parameter is invalid. This is also generated when the requested name is
service name reserved by the D-Bus specification, or when the operation is requested on a connection that does a special service name reserved by the D-Bus specification, or when the operation is requested on a
not refer to a bus.</para></listitem> connection that does not refer to a bus.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOTCONN</constant></term> <term><constant>-ENOTCONN</constant></term>
<listitem><para>The bus connection has been disconnected.</para></listitem> <listitem><para>The bus connection has been disconnected.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection has been created in a different process than the current <listitem><para>The bus connection has been created in a different process than the current
one.</para></listitem> one.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

20
man/sd_bus_set_close_on_exit.xml
View file

@ -68,20 +68,20 @@
<para><function>sd_bus_get_close_on_exit()</function> returns 0 if the feature is currently turned off or a <para><function>sd_bus_get_close_on_exit()</function> returns 0 if the feature is currently turned off or a
positive integer if it is on. On failure, it returns a negative errno-style error code.</para> positive integer if it is on. On failure, it returns a negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection has been created in a different process.</para></listitem> <listitem><para>The bus connection has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

24
man/sd_bus_set_connected_signal.xml
View file

@ -74,22 +74,22 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style <para>On success, these functions return 0 or a positive integer. On failure, they return a negative
error code.</para> errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection has been created in a different process.</para></listitem> <listitem><para>The bus connection has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

72
man/sd_bus_set_description.xml
View file

@ -116,55 +116,55 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these functions return 0 or a positive integer. On failure, <para>On success, these functions return 0 or a positive integer. On failure, they return a negative
they return a negative errno-style error code.</para> errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An argument is invalid.</para></listitem> <listitem><para>An argument is invalid.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOPKG</constant></term> <term><constant>-ENOPKG</constant></term>
<listitem><para>The bus cannot be resolved.</para></listitem> <listitem><para>The bus cannot be resolved.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>The bus has already been started.</para></listitem> <listitem><para>The bus has already been started.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus was created in a different process.</para></listitem> <listitem><para>The bus was created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

33
man/sd_bus_set_sender.xml
View file

@ -63,28 +63,29 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style <para>On success, these functions return 0 or a positive integer. On failure, they return a negative
error code.</para> errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection has been created in a different process.</para></listitem> <listitem><para>The bus connection has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EPERM</constant></term> <term><constant>-EPERM</constant></term>
<listitem><para>The specified bus connection object is a not a direct but a brokered connection.</para></listitem> <listitem><para>The specified bus connection object is a not a direct but a brokered
</varlistentry> connection.</para></listitem>
</variablelist> </varlistentry>
</variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

24
man/sd_bus_set_watch_bind.xml
View file

@ -80,22 +80,22 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style <para>On success, these functions return 0 or a positive integer. On failure, they return a negative
error code.</para> errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection has been created in a different process.</para></listitem> <listitem><para>The bus connection has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

44
man/sd_bus_slot_set_description.xml
View file

@ -60,37 +60,37 @@
<para>On success, these functions return 0 or a positive integer. On failure, <para>On success, these functions return 0 or a positive integer. On failure,
they return a negative errno-style error code.</para> they return a negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An required argument is <constant>NULL</constant>.</para></listitem> <listitem><para>An required argument is <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>The bus slot object has no description.</para></listitem> <listitem><para>The bus slot object has no description.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

30
man/sd_bus_slot_set_destroy_callback.xml
View file

@ -88,27 +88,27 @@
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_bus_slot_set_destroy_callback()</function> and <para>On success, <function>sd_bus_slot_set_destroy_callback()</function> and
<function>sd_bus_track_set_destroy_callback()</function> return 0 or a positive integer. On failure, they return a <function>sd_bus_track_set_destroy_callback()</function> return 0 or a positive integer. On failure, they
negative errno-style error code.</para> return a negative errno-style error code.</para>
<para><function>sd_bus_slot_get_destroy_callback()</function> and <para><function>sd_bus_slot_get_destroy_callback()</function> and
<function>sd_bus_track_get_destroy_callback()</function> return positive if the destroy callback function is set, 0 <function>sd_bus_track_get_destroy_callback()</function> return positive if the destroy callback function
if not. On failure, they return a negative errno-style error code.</para> is set, 0 if not. On failure, they return a negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>slot</parameter> or <parameter>track</parameter> parameter is <listitem><para>The <parameter>slot</parameter> or <parameter>track</parameter> parameter is
<constant>NULL</constant>.</para></listitem> <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

42
man/sd_bus_slot_set_floating.xml
View file

@ -70,35 +70,35 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style <para>On success, these functions return 0 or a positive integer. On failure, they return a negative
error code.</para> errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>slot</parameter> parameter is <constant>NULL</constant>.</para></listitem> <listitem><para>The <parameter>slot</parameter> parameter is <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection has been created in a different process.</para></listitem> <listitem><para>The bus connection has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The bus object the specified bus slot object is associated with has already been freed, and <listitem><para>The bus object the specified bus slot object is associated with has already been
hence no change in the floating state can be made anymore.</para></listitem> freed, and hence no change in the floating state can be made anymore.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

40
man/sd_bus_track_add_name.xml
View file

@ -181,36 +181,36 @@
<para><function>sd_bus_track_first()</function> and <function>sd_bus_track_next()</function> return the first/next <para><function>sd_bus_track_first()</function> and <function>sd_bus_track_next()</function> return the first/next
name contained in the bus peer tracking object, and <constant>NULL</constant> if the end of the enumeration is name contained in the bus peer tracking object, and <constant>NULL</constant> if the end of the enumeration is
reached and on error.</para> reached and on error.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EUNATCH</constant></term> <term><constant>-EUNATCH</constant></term>
<listitem><para><function>sd_bus_track_remove_name()</function> or <listitem><para><function>sd_bus_track_remove_name()</function> or
<function>sd_bus_track_remove_sender()</function> have been invoked for a name not previously added to the bus <function>sd_bus_track_remove_sender()</function> have been invoked for a name not previously added
peer object.</para></listitem> to the bus peer object.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>Specified parameter is invalid.</para></listitem> <listitem><para>Specified parameter is invalid.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

43
man/sd_bus_track_new.xml
View file

@ -182,37 +182,38 @@
reference. When not needed anymore, this reference should be destroyed with reference. When not needed anymore, this reference should be destroyed with
<function>sd_bus_track_unref()</function>. <function>sd_bus_track_unref()</function>.
</para> </para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EBUSY</constant></term> <term><constant>-EBUSY</constant></term>
<listitem><para>Bus peers have already been added to the bus peer tracking object and <listitem><para>Bus peers have already been added to the bus peer tracking object and
<function>sd_bus_track_set_recursive()</function> was called to change tracking mode.</para></listitem> <function>sd_bus_track_set_recursive()</function> was called to change tracking mode.
</varlistentry> </para></listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>Specified parameter is invalid <listitem><para>Specified parameter is invalid
(<constant>NULL</constant> in case of output (<constant>NULL</constant> in case of output
parameters).</para></listitem> parameters).</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

38
man/sd_bus_wait.xml
View file

@ -66,33 +66,33 @@
<para>If any I/O was seen, a positive value is returned, zero otherwise. If an error occurs, a negative <para>If any I/O was seen, a positive value is returned, zero otherwise. If an error occurs, a negative
<varname>errno</varname>-style error code is returned.</para> <varname>errno</varname>-style error code is returned.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid bus object was passed.</para></listitem> <listitem><para>An invalid bus object was passed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The bus connection was allocated in a parent process and is being reused in a child process <listitem><para>The bus connection was allocated in a parent process and is being reused in a child
after <function>fork()</function>.</para></listitem> process after <function>fork()</function>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOTCONN</constant></term> <term><constant>-ENOTCONN</constant></term>
<listitem><para>The bus connection has been terminated already.</para></listitem> <listitem><para>The bus connection has been terminated already.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

72
man/sd_event_add_child.xml
View file

@ -137,61 +137,61 @@
<para>On success, these functions return 0 or a positive <para>On success, these functions return 0 or a positive
integer. On failure, they return a negative errno-style error integer. On failure, they return a negative errno-style error
code.</para> code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory to allocate an object.</para></listitem> <listitem><para>Not enough memory to allocate an object.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid argument has been passed. This includes <listitem><para>An invalid argument has been passed. This includes
specifying an empty mask in <parameter>options</parameter> or a mask specifying an empty mask in <parameter>options</parameter> or a mask
which contains values different than a combination of which contains values different than a combination of
<constant>WEXITED</constant>, <constant>WSTOPPED</constant>, and <constant>WEXITED</constant>, <constant>WSTOPPED</constant>, and
<constant>WCONTINUED</constant>. <constant>WCONTINUED</constant>.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EBUSY</constant></term> <term><constant>-EBUSY</constant></term>
<listitem><para>A handler is already installed for this <listitem><para>A handler is already installed for this
child process.</para></listitem> child process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EDOM</constant></term> <term><constant>-EDOM</constant></term>
<listitem><para>The passed event source is not a child process event source.</para></listitem> <listitem><para>The passed event source is not a child process event source.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

44
man/sd_event_add_defer.xml
View file

@ -129,39 +129,39 @@
<para>On success, these functions return 0 or a positive <para>On success, these functions return 0 or a positive
integer. On failure, they return a negative errno-style error integer. On failure, they return a negative errno-style error
code.</para> code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory to allocate an object.</para></listitem> <listitem><para>Not enough memory to allocate an object.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid argument has been passed.</para></listitem> <listitem><para>An invalid argument has been passed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

54
man/sd_event_add_inotify.xml
View file

@ -110,48 +110,48 @@
<para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style <para>On success, these functions return 0 or a positive integer. On failure, they return a negative errno-style
error code.</para> error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory to allocate an object.</para></listitem> <listitem><para>Not enough memory to allocate an object.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid argument has been passed. This includes specifying a mask with <listitem><para>An invalid argument has been passed. This includes specifying a mask with
<constant>IN_MASK_ADD</constant> set.</para></listitem> <constant>IN_MASK_ADD</constant> set.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EDOM</constant></term> <term><constant>-EDOM</constant></term>
<listitem><para>The passed event source is not an inotify process event source.</para></listitem> <listitem><para>The passed event source is not an inotify process event source.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<refsect1> <refsect1>

52
man/sd_event_add_io.xml
View file

@ -228,46 +228,46 @@
<para>On success, these functions return 0 or a positive <para>On success, these functions return 0 or a positive
integer. On failure, they return a negative errno-style error integer. On failure, they return a negative errno-style error
code.</para> code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned values may indicate the following problems:</para> <para>Returned values may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory to allocate an object.</para></listitem> <listitem><para>Not enough memory to allocate an object.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid argument has been passed.</para></listitem> <listitem><para>An invalid argument has been passed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EDOM</constant></term> <term><constant>-EDOM</constant></term>
<listitem><para>The passed event source is not an I/O event source.</para></listitem> <listitem><para>The passed event source is not an I/O event source.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

62
man/sd_event_add_signal.xml
View file

@ -121,52 +121,52 @@
<para>On success, these functions return 0 or a positive <para>On success, these functions return 0 or a positive
integer. On failure, they return a negative errno-style error integer. On failure, they return a negative errno-style error
code.</para> code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory to allocate an object.</para></listitem> <listitem><para>Not enough memory to allocate an object.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid argument has been passed.</para></listitem> <listitem><para>An invalid argument has been passed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EBUSY</constant></term> <term><constant>-EBUSY</constant></term>
<listitem><para>A handler is already installed for this <listitem><para>A handler is already installed for this
signal or the signal was not blocked previously.</para></listitem> signal or the signal was not blocked previously.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EDOM</constant></term> <term><constant>-EDOM</constant></term>
<listitem><para>The passed event source is not a signal event source.</para></listitem> <listitem><para>The passed event source is not a signal event source.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

60
man/sd_event_add_time.xml
View file

@ -209,54 +209,54 @@
<para>On success, these functions return 0 or a positive <para>On success, these functions return 0 or a positive
integer. On failure, they return a negative errno-style error integer. On failure, they return a negative errno-style error
code. </para> code. </para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned values may indicate the following problems:</para> <para>Returned values may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory to allocate an object.</para></listitem> <listitem><para>Not enough memory to allocate an object.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid argument has been passed.</para></listitem> <listitem><para>An invalid argument has been passed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EOPNOTSUPP</constant></term> <term><constant>-EOPNOTSUPP</constant></term>
<listitem><para>The selected clock is not supported by the event loop implementation.</para></listitem> <listitem><para>The selected clock is not supported by the event loop implementation.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EDOM</constant></term> <term><constant>-EDOM</constant></term>
<listitem><para>The passed event source is not a timer event source.</para></listitem> <listitem><para>The passed event source is not a timer event source.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

51
man/sd_event_exit.xml
View file

@ -79,45 +79,44 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_event_exit()</function> and <para>On success, <function>sd_event_exit()</function> and <function>sd_event_get_exit_code()</function>
<function>sd_event_get_exit_code()</function> return 0 or a positive return 0 or a positive integer. On failure, they return a negative errno-style error code.</para>
integer. On failure, they return a negative errno-style error
code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The event loop object or error code pointer are invalid.</para></listitem> <listitem><para>The event loop object or error code pointer are invalid.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop was created in a different process.</para></listitem> <listitem><para>The event loop was created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop has exited already and all exit handlers are already processed.</para></listitem> <listitem><para>The event loop has exited already and all exit handlers are already processed.
</varlistentry> </para></listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENODATA</constant></term> <term><constant>-ENODATA</constant></term>
<listitem><para>The event loop has not been requested to exit yet.</para></listitem> <listitem><para>The event loop has not been requested to exit yet.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

36
man/sd_event_get_fd.xml
View file

@ -58,32 +58,30 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_event_get_fd()</function> returns a <para>On success, <function>sd_event_get_fd()</function> returns a non-negative file descriptor. On
non-negative file descriptor. On failure, it returns a negative failure, it returns a negative errno-style error code.</para>
errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para><parameter>event</parameter> is not a valid <listitem><para><parameter>event</parameter> is not a valid pointer to an
pointer to an <structname>sd_event</structname> structure. <structname>sd_event</structname> structure.</para></listitem>
</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<refsect1> <refsect1>

50
man/sd_event_new.xml
View file

@ -158,44 +158,40 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_event_new()</function>, <para>On success, <function>sd_event_new()</function>, <function>sd_event_default()</function> and
<function>sd_event_default()</function> and <function>sd_event_get_tid()</function> return 0 or a positive integer. On failure, they return a
<function>sd_event_get_tid()</function> return 0 or a positive negative errno-style error code. <function>sd_event_ref()</function> always returns a pointer to the
integer. On failure, they return a negative errno-style error event loop object passed in. <function>sd_event_unref()</function> always returns
code. <function>sd_event_ref()</function> always returns a pointer
to the event loop object passed
in. <function>sd_event_unref()</function> always returns
<constant>NULL</constant>.</para> <constant>NULL</constant>.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory to allocate the object.</para></listitem> <listitem><para>Not enough memory to allocate the object.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EMFILE</constant></term> <term><constant>-EMFILE</constant></term>
<listitem><para>The maximum number of event loops has been allocated.</para></listitem> <listitem><para>The maximum number of event loops has been allocated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para><function>sd_event_get_tid()</function> was <listitem><para><function>sd_event_get_tid()</function> was invoked on an event loop object that
invoked on an event loop object that was not allocated with was not allocated with <function>sd_event_default()</function>.</para></listitem>
<function>sd_event_default()</function>.</para></listitem> </varlistentry>
</varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

49
man/sd_event_now.xml
View file

@ -64,42 +64,37 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>If the first event loop iteration has not run yet <para>If the first event loop iteration has not run yet <function>sd_event_now()</function> writes
<function>sd_event_now()</function> writes current time to current time to <parameter>usec</parameter> and returns a positive return value. Otherwise, it will
<parameter>usec</parameter> and returns a positive return value. write the requested timestamp to <parameter>usec</parameter> and return 0. On failure, the call returns a
Otherwise, it will write the requested timestamp to <parameter>usec</parameter> negative errno-style error code.</para>
and return 0. On failure, the call returns a negative errno-style
error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned values may indicate the following problems:</para> <para>Returned values may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An invalid parameter was <listitem><para>An invalid parameter was passed.</para></listitem>
passed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EOPNOTSUPP</constant></term> <term><constant>-EOPNOTSUPP</constant></term>
<listitem><para>Unsupported clock type. <listitem><para>Unsupported clock type.</para></listitem>
</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop object was created in a <listitem><para>The event loop object was created in a different process.</para></listitem>
different process.</para></listitem> </varlistentry>
</varlistentry> </variablelist>
</variablelist> </refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

54
man/sd_event_run.xml
View file

@ -96,47 +96,47 @@
dispatched. <function>sd_event_loop()</function> returns the exit dispatched. <function>sd_event_loop()</function> returns the exit
code specified when invoking code specified when invoking
<function>sd_event_exit()</function>.</para> <function>sd_event_exit()</function>.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>event</parameter> parameter is <listitem><para>The <parameter>event</parameter> parameter is invalid or
invalid or <constant>NULL</constant>.</para></listitem> <constant>NULL</constant>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EBUSY</constant></term> <term><constant>-EBUSY</constant></term>
<listitem><para>The event loop object is not in the right <listitem><para>The event loop object is not in the right
state (see state (see
<citerefentry><refentrytitle>sd_event_prepare</refentrytitle><manvolnum>3</manvolnum></citerefentry> <citerefentry><refentrytitle>sd_event_prepare</refentrytitle><manvolnum>3</manvolnum></citerefentry>
for an explanation of possible states).</para></listitem> for an explanation of possible states).</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Other errors are possible, too.</para> <para>Other errors are possible, too.</para>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

40
man/sd_event_set_watchdog.xml
View file

@ -93,36 +93,32 @@
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_event_set_watchdog()</function> and <para>On success, <function>sd_event_set_watchdog()</function> and
<function>sd_event_get_watchdog()</function> return a non-zero <function>sd_event_get_watchdog()</function> return a non-zero positive integer if the service manager
positive integer if the service manager requested watchdog support requested watchdog support and watchdog support was successfully enabled. They return zero if the service
and watchdog support was successfully enabled. They return zero if manager did not request watchdog support, or if watchdog support was explicitly disabled with a false
the service manager did not request watchdog support, or if <parameter>b</parameter> parameter. On failure, they return a negative errno-style error code.</para>
watchdog support was explicitly disabled with a false
<parameter>b</parameter> parameter. On failure, they return a
negative errno-style error
code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The passed event loop object was invalid.</para></listitem> <listitem><para>The passed event loop object was invalid.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

66
man/sd_event_source_get_pending.xml
View file

@ -69,56 +69,52 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, <para>On success, <function>sd_event_source_get_pending()</function> returns an integer greater than zero
<function>sd_event_source_get_pending()</function> returns an when the event source is marked pending, and zero when the event source is not marked pending. On
integer greater than zero when the event source is marked pending, failure, it returns a negative errno-style error code.</para>
and zero when the event source is not marked pending. On failure,
it returns a negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para><parameter>source</parameter> is not a valid <listitem><para><parameter>source</parameter> is not a valid pointer to an
pointer to an <structname>sd_event_source</structname> <structname>sd_event_source</structname> object.</para></listitem>
object.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EDOM</constant></term> <term><constant>-EDOM</constant></term>
<listitem><para><parameter>source</parameter> refers to an <listitem><para><parameter>source</parameter> refers to an event source object created with
event source object created with <citerefentry><refentrytitle>sd_event_add_exit</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para></listitem>
<citerefentry><refentrytitle>sd_event_add_exit</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory.</para></listitem> <listitem><para>Not enough memory.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

58
man/sd_event_source_set_description.xml
View file

@ -79,49 +79,45 @@
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_event_source_set_description()</function> and <para>On success, <function>sd_event_source_set_description()</function> and
<function>sd_event_source_get_description()</function> return a <function>sd_event_source_get_description()</function> return a non-negative integer. On failure, they
non-negative integer. On failure, they return a negative return a negative errno-style error code.</para>
errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para><parameter>source</parameter> is not a valid <listitem><para><parameter>source</parameter> is not a valid pointer to an
pointer to an <structname>sd_event_source</structname> <structname>sd_event_source</structname> object or the <parameter>description</parameter> argument
object or the <parameter>description</parameter> argument for for <function>sd_event_source_get_description()</function> is <constant>NULL</constant>.
<function>sd_event_source_get_description()</function> is </para></listitem>
<constant>NULL</constant>.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory to copy the <listitem><para>Not enough memory to copy the name.</para></listitem>
name.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>No name was set for the event <listitem><para>No name was set for the event source.</para></listitem>
source.</para></listitem> </varlistentry>
</varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

29
man/sd_event_source_set_destroy_callback.xml
View file

@ -69,25 +69,26 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_event_source_set_destroy_callback()</function> returns 0 or a positive integer. On <para>On success, <function>sd_event_source_set_destroy_callback()</function> returns 0 or a positive
failure, it returns a negative errno-style error code.</para> integer. On failure, it returns a negative errno-style error code.</para>
<para><function>sd_event_source_get_destroy_callback()</function> returns positive if the destroy callback function <para><function>sd_event_source_get_destroy_callback()</function> returns positive if the destroy
is set, 0 if not. On failure, returns a negative errno-style error code.</para> callback function is set, 0 if not. On failure, returns a negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>source</parameter> parameter is <constant>NULL</constant>.</para></listitem> <listitem><para>The <parameter>source</parameter> parameter is <constant>NULL</constant>.
</varlistentry> </para></listitem>
</variablelist> </varlistentry>
</variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

45
man/sd_event_source_set_enabled.xml
View file

@ -100,39 +100,38 @@
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_event_source_set_enabled()</function> returns a non-negative <para>On success, <function>sd_event_source_set_enabled()</function> returns a non-negative
integer. <function>sd_event_source_get_enabled()</function> returns zero if the source is integer. <function>sd_event_source_get_enabled()</function> returns zero if the source is disabled
disabled (<constant>SD_EVENT_OFF</constant>) and a positive integer otherwise. On failure, they (<constant>SD_EVENT_OFF</constant>) and a positive integer otherwise. On failure, they return a negative
return a negative errno-style error code.</para> errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para><parameter>source</parameter> is not a valid <listitem><para><parameter>source</parameter> is not a valid pointer to an
pointer to an <structname>sd_event_source</structname> <structname>sd_event_source</structname> object.</para></listitem>
object.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory.</para></listitem> <listitem><para>Not enough memory.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

64
man/sd_event_source_set_prepare.xml
View file

@ -73,55 +73,51 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, <para>On success, <function>sd_event_source_set_prepare()</function> returns a non-negative integer. On
<function>sd_event_source_set_prepare()</function> returns a failure, it returns a negative errno-style error code.</para>
non-negative integer. On failure, it returns a negative
errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para><parameter>source</parameter> is not a valid <listitem><para><parameter>source</parameter> is not a valid pointer to an
pointer to an <structname>sd_event_source</structname> <structname>sd_event_source</structname> object.</para></listitem>
object.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory.</para></listitem> <listitem><para>Not enough memory.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EDOM</constant></term> <term><constant>-EDOM</constant></term>
<listitem><para>The specified event source has been created <listitem><para>The specified event source has been created with
with <citerefentry><refentrytitle>sd_event_add_exit</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para></listitem>
<citerefentry><refentrytitle>sd_event_add_exit</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

55
man/sd_event_source_set_priority.xml
View file

@ -106,48 +106,45 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, <para>On success, <function>sd_event_source_set_priority()</function> and
<function>sd_event_source_set_priority()</function> and <function>sd_event_source_get_priority()</function> return a non-negative integer. On failure, they
<function>sd_event_source_get_priority()</function> return a return a negative errno-style error code.</para>
non-negative integer. On failure, they return a negative
errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para><parameter>source</parameter> is not a valid <listitem><para><parameter>source</parameter> is not a valid pointer to an
pointer to an <structname>sd_event_source</structname> <structname>sd_event_source</structname> object.</para></listitem>
object.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Not enough memory.</para></listitem> <listitem><para>Not enough memory.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

67
man/sd_event_wait.xml
View file

@ -254,56 +254,51 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these functions return 0 or a positive integer. <para>On success, these functions return 0 or a positive integer. On failure, they return a negative
On failure, they return a negative errno-style error code. In case errno-style error code. In case of <function>sd_event_prepare()</function> and
of <function>sd_event_prepare()</function> and <function>sd_event_wait()</function>, a positive, non-zero return code indicates that events are ready to
<function>sd_event_wait()</function>, a positive, non-zero return be processed and zero indicates that no events are ready. In case of
code indicates that events are ready to be processed and zero <function>sd_event_dispatch()</function>, a positive, non-zero return code indicates that the event loop
indicates that no events are ready. In case of returned to its initial state and zero indicates the event loop has
<function>sd_event_dispatch()</function>, a positive, non-zero exited. <function>sd_event_get_state()</function> returns a positive or zero state on success.</para>
return code indicates that the event loop returned to its initial
state and zero indicates the event loop has
exited. <function>sd_event_get_state()</function> returns a
positive or zero state on success.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>The <parameter>event</parameter> parameter is <listitem><para>The <parameter>event</parameter> parameter is invalid or <constant>NULL</constant>.
invalid or <constant>NULL</constant>.</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EBUSY</constant></term> <term><constant>-EBUSY</constant></term>
<listitem><para>The event loop object is not in the right <listitem><para>The event loop object is not in the right state.</para></listitem>
state.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ESTALE</constant></term> <term><constant>-ESTALE</constant></term>
<listitem><para>The event loop is already terminated.</para></listitem> <listitem><para>The event loop is already terminated.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ECHILD</constant></term> <term><constant>-ECHILD</constant></term>
<listitem><para>The event loop has been created in a different process.</para></listitem> <listitem><para>The event loop has been created in a different process.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Other errors are possible, too.</para> <para>Other errors are possible, too.</para>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

29
man/sd_get_seats.xml
View file

@ -83,27 +83,24 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_get_seats()</function>, <para>On success, <function>sd_get_seats()</function>, <function>sd_get_sessions()</function>,
<function>sd_get_sessions()</function>, <function>sd_get_uids()</function> and <function>sd_get_machine_names()</function> return the number of
<function>sd_get_uids()</function> and entries in the arrays. On failure, these calls return a negative errno-style error code.</para>
<function>sd_get_machine_names()</function> return the number of
entries in the arrays. On failure, these calls return a negative
errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

31
man/sd_login_monitor_new.xml
View file

@ -206,29 +206,28 @@ else {
<para><function>sd_login_monitor_unref()</function> <para><function>sd_login_monitor_unref()</function>
always returns <constant>NULL</constant>.</para> always returns <constant>NULL</constant>.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An input parameter was invalid (out of range, <listitem><para>An input parameter was invalid (out of range, or <constant>NULL</constant>, where
or NULL, where that is not accepted). The specified category to that is not accepted). The specified category to watch is not known.</para></listitem>
watch is not known.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

45
man/sd_machine_get_class.xml
View file

@ -66,38 +66,37 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these calls return 0 or a positive integer. On <para>On success, these calls return 0 or a positive integer. On failure, these calls return a negative
failure, these calls return a negative errno-style error errno-style error code.</para>
code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>The specified machine does not exist or is currently not running.</para> <listitem><para>The specified machine does not exist or is currently not running.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An input parameter was invalid (out of range, <listitem><para>An input parameter was invalid (out of range, or <constant>NULL</constant>, where
or NULL, where that is not accepted).</para></listitem> that is not accepted).</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

66
man/sd_pid_get_owner_uid.xml
View file

@ -240,54 +240,50 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, these calls return 0 or a positive integer. On <para>On success, these calls return 0 or a positive integer. On failure, these calls return a negative
failure, these calls return a negative errno-style error errno-style error code.</para>
code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ESRCH</constant></term> <term><constant>-ESRCH</constant></term>
<listitem><para>The specified PID does not refer to a running <listitem><para>The specified PID does not refer to a running process.</para>
process.</para> </listitem>
</listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EBADF</constant></term> <term><constant>-EBADF</constant></term>
<listitem><para>The specified socket file descriptor was <listitem><para>The specified socket file descriptor was invalid.</para></listitem>
invalid.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENODATA</constant></term> <term><constant>-ENODATA</constant></term>
<listitem><para>The given field is not specified for the described <listitem><para>The given field is not specified for the described process or peer.</para>
process or peer.</para> </listitem>
</listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An input parameter was invalid (out of range, <listitem><para>An input parameter was invalid (out of range, or <constant>NULL</constant>, where
or NULL, where that is not accepted).</para></listitem> that is not accepted).</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<refsect1> <refsect1>

65
man/sd_seat_get_active.xml
View file

@ -112,52 +112,47 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para> On success, <function>sd_seat_get_active()</function> <para> On success, <function>sd_seat_get_active()</function> returns 0 or a positive integer. On success,
returns 0 or a positive integer. On success, <function>sd_seat_get_sessions()</function> returns the number of entries in the session identifier
<function>sd_seat_get_sessions()</function> returns the number of array. If the test succeeds, <function>sd_seat_can_multi_session</function>,
entries in the session identifier array. If the test succeeds, <function>sd_seat_can_tty</function> and <function>sd_seat_can_graphical</function> return a positive
<function>sd_seat_can_multi_session</function>, integer, if it fails 0. On failure, these calls return a negative errno-style error code.</para>
<function>sd_seat_can_tty</function> and
<function>sd_seat_can_graphical</function> return a positive
integer, if it fails 0. On failure, these calls return a negative
errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENODATA</constant></term> <term><constant>-ENODATA</constant></term>
<listitem><para>The given field is not specified for the described <listitem><para>The given field is not specified for the described seat.</para>
seat.</para> </listitem>
</listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>The specified seat is unknown.</para> <listitem><para>The specified seat is unknown.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An input parameter was invalid (out of range, <listitem><para>An input parameter was invalid (out of range, or <constant>NULL</constant>, where
or NULL, where that is not accepted).</para></listitem> that is not accepted).</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

51
man/sd_session_is_active.xml
View file

@ -262,43 +262,42 @@
<function>sd_session_get_tty()</function> return 0 or <function>sd_session_get_tty()</function> return 0 or
a positive integer. On failure, these calls return a a positive integer. On failure, these calls return a
negative errno-style error code.</para> negative errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>The specified session does not exist.</para> <listitem><para>The specified session does not exist.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENODATA</constant></term> <term><constant>-ENODATA</constant></term>
<listitem><para>The given field is not specified for the described <listitem><para>The given field is not specified for the described session.</para>
session.</para> </listitem>
</listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An input parameter was invalid (out of range, <listitem><para>An input parameter was invalid (out of range, or <constant>NULL</constant>, where
or NULL, where that is not accepted).</para></listitem> that is not accepted).</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />

69
man/sd_uid_get_state.xml
View file

@ -131,55 +131,48 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success, <function>sd_uid_get_state()</function> returns <para>On success, <function>sd_uid_get_state()</function> returns 0 or a positive integer. If the test
0 or a positive integer. If the test succeeds, succeeds, <function>sd_uid_is_on_seat()</function> returns a positive integer; if it fails, 0.
<function>sd_uid_is_on_seat()</function> returns a positive <function>sd_uid_get_sessions()</function> and <function>sd_uid_get_seats()</function> return the number
integer; if it fails, 0. of entries in the returned arrays. <function>sd_uid_get_display()</function> returns a non-negative code
<function>sd_uid_get_sessions()</function> and on success. On failure, these calls return a negative errno-style error code.</para>
<function>sd_uid_get_seats()</function> return the number of
entries in the returned arrays.
<function>sd_uid_get_display()</function> returns a non-negative
code on success. On failure, these calls return a negative
errno-style error code.</para>
</refsect1>
<refsect1> <refsect2>
<title>Errors</title> <title>Errors</title>
<para>Returned errors may indicate the following problems:</para> <para>Returned errors may indicate the following problems:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><constant>-ENODATA</constant></term> <term><constant>-ENODATA</constant></term>
<listitem><para>The given field is not specified for the described <listitem><para>The given field is not specified for the described user.</para>
user.</para> </listitem>
</listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENXIO</constant></term> <term><constant>-ENXIO</constant></term>
<listitem><para>The specified seat is unknown.</para> <listitem><para>The specified seat is unknown.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><constant>-EINVAL</constant></term> <term><constant>-EINVAL</constant></term>
<listitem><para>An input parameter was invalid (out of range, <listitem><para>An input parameter was invalid (out of range, or NULL, where that is not
or NULL, where that is not accepted). This is also returned if accepted). This is also returned if the passed user ID is <constant>0xFFFF</constant> or
the passed user ID is 0xFFFF or 0xFFFFFFFF, which are <constant>0xFFFFFFFF</constant>, which are undefined on Linux.</para></listitem>
undefined on Linux.</para></listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term><constant>-ENOMEM</constant></term> <term><constant>-ENOMEM</constant></term>
<listitem><para>Memory allocation failed.</para></listitem> <listitem><para>Memory allocation failed.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2>
</refsect1> </refsect1>
<xi:include href="libsystemd-pkgconfig.xml" /> <xi:include href="libsystemd-pkgconfig.xml" />