X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_uid_get_state.xml;h=e1b345c2779a1774bb94d72445ba43e2207a8c9f;hb=c34255bdb217c2a1d3ac6348252437ab8be9ca46;hp=d4d23f4f1d703d813a3cc99178252070ca18f3a1;hpb=79640424059328268b9fb6c5fa8eb777b27a177e;p=elogind.git
diff --git a/man/sd_uid_get_state.xml b/man/sd_uid_get_state.xml
index d4d23f4f1..e1b345c27 100644
--- a/man/sd_uid_get_state.xml
+++ b/man/sd_uid_get_state.xml
@@ -47,6 +47,7 @@
sd_uid_is_on_seat
sd_uid_get_sessions
sd_uid_get_seats
+ sd_uid_get_display
Determine login state of a specific Unix user ID
@@ -57,28 +58,34 @@
int sd_uid_get_state
uid_t uid
- char** state
+ char **state
int sd_uid_is_on_seat
uid_t uid
int require_active
- const char* seat
+ const char *seat
int sd_uid_get_sessions
uid_t uid
int require_active
- char*** sessions
+ char ***sessions
int sd_uid_get_seats
uid_t uid
int require_active
- char*** seats
+ char ***seats
+
+
+
+ int sd_uid_get_display
+ uid_t uid
+ char **session
@@ -103,7 +110,7 @@
in regards to additional state strings being
returned. The returned string needs to be freed with
the libc
- free3
+ free3
call after use.
sd_uid_is_on_seat() may be
@@ -130,7 +137,7 @@
NULL terminated string array of session identifiers in
sessions which needs to be
freed by the caller with the libc
- free3
+ free3
call after use, including all the strings
referenced. If the string array parameter is passed as
NULL, the array will not be filled in, but the return
@@ -139,7 +146,7 @@
be returned and should be considered equivalent to an
empty array.
- Similar, sd_uid_get_seats()
+ Similarly, sd_uid_get_seats()
may be used to determine the list of seats on which
the user currently has sessions. Similar semantics
apply, however note that the user may have
@@ -147,19 +154,27 @@
with no attached seat and hence the number of entries
in the returned array may differ from the one returned
by sd_uid_get_sessions().
+
+ sd_uid_get_display()
+ returns the name of the "primary" session of a user.
+ If the user has graphical sessions, it will be the
+ oldest graphical session. Otherwise, it will be the
+ oldest open session.
Return Value
- On success
+ On success,
sd_uid_get_state() returns 0 or a
positive integer. If the test succeeds,
sd_uid_is_on_seat() returns a
- positive integer, if it fails
+ positive integer; if it fails,
0. sd_uid_get_sessions() and
sd_uid_get_seats() return the
- number of entries in the returned arrays. On failure,
+ number of entries in the returned arrays.
+ sd_uid_get_display() returns
+ a non-negative code on success. On failure,
these calls return a negative errno-style error
code.
@@ -167,13 +182,24 @@
Notes
- The sd_uid_get_state(),
+ Functions described here are available as a
+ shared library, and can be compiled and linked to
+ using the
+ libsystemd pkg-config1
+ entry.
+
+
+
+ History
+
+ sd_uid_get_state(),
sd_uid_is_on_seat(),
- sd_uid_get_sessions(), and
- sd_uid_get_seats() interfaces are
- available as shared library, which can be compiled and
- linked to with the libsystemd-login pkg-config1
- file.
+ sd_uid_get_sessions(),
+ and sd_uid_get_seats() functions
+ were added in systemd-31.
+
+ sd_uid_get_display() was
+ added in systemd-213.