summaryrefslogtreecommitdiff
path: root/man/sd_seat_get_active.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2015-09-04 09:05:52 +0200
committerLennart Poettering <lennart@poettering.net>2015-09-04 09:07:31 +0200
commit707b66c66381c899d7ef640e158ffdd5bcff4deb (patch)
tree904cc3ecb07281497e16a0097d89286f84067225 /man/sd_seat_get_active.xml
parent9da4cb2be260ed123f2676cb85cb350c527b1492 (diff)
downloadsystemd-707b66c66381c899d7ef640e158ffdd5bcff4deb.tar.gz
sd-login: rework error handling
Makre sure we always return sensible errors for the various, following the same rules, and document them in a comment in sd-login.c. Also, update all relevant man pages accordingly.
Diffstat (limited to 'man/sd_seat_get_active.xml')
-rw-r--r--man/sd_seat_get_active.xml37
1 files changed, 37 insertions, 0 deletions
diff --git a/man/sd_seat_get_active.xml b/man/sd_seat_get_active.xml
index 3c57ec9ea4..4d3e0822e0 100644
--- a/man/sd_seat_get_active.xml
+++ b/man/sd_seat_get_active.xml
@@ -149,6 +149,43 @@
</refsect1>
<refsect1>
+ <title>Errors</title>
+
+ <para>Returned errors may indicate the following problems:</para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><constant>-ENODATA</constant></term>
+
+ <listitem><para>Given field is not specified for the described
+ seat.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><constant>-ENXIO</constant></term>
+
+ <listitem><para>The specified seat is unknown.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><constant>-EINVAL</constant></term>
+
+ <listitem><para>An input parameter was invalid (out of range,
+ or NULL, where that's not accepted).</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><constant>-ENOMEM</constant></term>
+
+ <listitem><para>Memory allocation failed.</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
<title>Notes</title>
<para>The <function>sd_seat_get_active()</function>,