diff --git a/Makefile-man.am b/Makefile-man.am
index 6d57b75132..03adc7ca26 100644
--- a/Makefile-man.am
+++ b/Makefile-man.am
@@ -1288,6 +1288,7 @@ MANPAGES_ALIAS += \
man/sd_session_get_uid.3 \
man/sd_session_get_vt.3 \
man/sd_session_is_remote.3 \
+ man/sd_uid_get_display.3 \
man/sd_uid_get_seats.3 \
man/sd_uid_get_sessions.3 \
man/sd_uid_is_on_seat.3 \
@@ -1328,6 +1329,7 @@ man/sd_session_get_type.3: man/sd_session_is_active.3
man/sd_session_get_uid.3: man/sd_session_is_active.3
man/sd_session_get_vt.3: man/sd_session_is_active.3
man/sd_session_is_remote.3: man/sd_session_is_active.3
+man/sd_uid_get_display.3: man/sd_uid_get_state.3
man/sd_uid_get_seats.3: man/sd_uid_get_state.3
man/sd_uid_get_sessions.3: man/sd_uid_get_state.3
man/sd_uid_is_on_seat.3: man/sd_uid_get_state.3
@@ -1440,6 +1442,9 @@ man/sd_session_get_vt.html: man/sd_session_is_active.html
man/sd_session_is_remote.html: man/sd_session_is_active.html
$(html-alias)
+man/sd_uid_get_display.html: man/sd_uid_get_state.html
+ $(html-alias)
+
man/sd_uid_get_seats.html: man/sd_uid_get_state.html
$(html-alias)
diff --git a/man/sd_uid_get_state.xml b/man/sd_uid_get_state.xml
index 01ad0abfce..1007a7917b 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
@@ -80,6 +81,12 @@
int require_active
char ***seats
+
+
+ int sd_uid_get_display
+ uid_t uid
+ char **session
+
@@ -147,6 +154,12 @@
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.
@@ -159,7 +172,9 @@
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 a shared library, which can be compiled and
- linked to with the libsystemd 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.