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
committerSven Eden <yamakuzure@gmx.net>2017-03-14 10:19:06 +0100
commitabbb87ffdecf445d2bba18e1638f80c96098339e (patch)
treeed6aeed11090753128077935fae61e27534b8652 /man/sd_seat_get_active.xml
parent28233624dfc4ee549eaaacacf4e4f100026ba09b (diff)
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 793bbc8c9..6dda53512 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>,