X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_session_is_active.xml;h=afdeed55d61f3d0301fb9523a3f903253158b893;hb=96b0cb1181afba513e547a9233b7acd4ff622a94;hp=82919f84fbb23abae6db876e5775a77aff546305;hpb=0b3b020a178cf3b957fed627de13c895773995ec;p=elogind.git
diff --git a/man/sd_session_is_active.xml b/man/sd_session_is_active.xml
index 82919f84f..afdeed55d 100644
--- a/man/sd_session_is_active.xml
+++ b/man/sd_session_is_active.xml
@@ -46,6 +46,10 @@
sd_session_is_active
sd_session_get_uid
sd_session_get_seat
+ sd_session_get_service
+ sd_session_get_type
+ sd_session_get_class
+ sd_session_get_display
Determine state of a specific session
@@ -69,6 +73,30 @@
const char* session
char** seat
+
+
+ int sd_session_get_service
+ const char* session
+ char** service
+
+
+
+ int sd_session_get_type
+ const char* session
+ char** type
+
+
+
+ int sd_session_get_class
+ const char* session
+ char** class
+
+
+
+ int sd_session_get_display
+ const char* session
+ char** display
+
@@ -94,6 +122,48 @@
returned string needs to be freed with the libc
free3
call after use.
+
+ sd_session_get_service()
+ may be used to determine the name of the service (as
+ passed during PAM session setup) that registered the
+ session identified by the specified session
+ identifier. The returned string needs to be freed with
+ the libc
+ free3
+ call after use.
+
+ sd_session_get_type() may
+ be used to determine the type of the session
+ identified by the specified session identifier. The
+ returned string is one of x11,
+ tty or
+ unspecified and needs to be freed
+ with the libc
+ free3
+ call after use.
+
+ sd_session_get_class() may
+ be used to determine the class of the session
+ identified by the specified session identifier. The
+ returned string is one of user,
+ greeter or
+ lock-screen and needs to be freed
+ with the libc
+ free3
+ call after use.
+
+ sd_session_get_display()
+ may be used to determine the X11 display of the
+ session identified by the specified session
+ identifier. The returned string is one of needs to be
+ freed with the libc
+ free3
+ call after use.
+
+ If the session parameter of
+ any of these functions is passed as NULL the operation
+ is executed for the session the calling process is a
+ member of, if there is any.
@@ -102,7 +172,8 @@
If the test succeeds
sd_session_is_active() returns a
positive integer, if it fails 0. On success
- sd_session_get_uid() and
+ sd_session_get_uid(),
+ sd_session_get_service() and
sd_session_get_seat() return 0 or
a positive integer. On failure, these calls return a
negative errno-style error code.
@@ -112,7 +183,8 @@
Notes
The sd_session_is_active(),
- sd_session_get_uid(), and
+ sd_session_get_uid(),
+ sd_session_get_service() and
sd_session_get_seat() interfaces
are available as shared library, which can be compiled
and linked to with the
@@ -127,7 +199,7 @@
systemd1,
sd-login7,
- sd_pid_get_session3,
+ sd_pid_get_session3