SD_SESSION_IS_ACTIVE(3)sd_session_is_activeSD_SESSION_IS_ACTIVE(3)NAME
sd_session_is_active, sd_session_get_uid, sd_session_get_seat -
Determine state of a specific session
SYNOPSIS
#include <systemd/sd-login.h>
int sd_session_is_active(const char* session);
int sd_session_get_uid(const char* session, uid_t* uid);
int sd_session_get_seat(const char* session, char** seat);
DESCRIPTIONsd_session_is_active() may be used to determine whether the session
identified by the specified session identifier is currently active
(i.e. currently in the foreground and available for user input) or not.
sd_session_get_uid() may be used to determine the user identifier of
the Unix user the session identified by the specified session
identifier belongs to.
sd_session_get_seat() may be used to determine the seat identifier of
the seat the session identified by the specified session identifier
belongs to. Note that not all sessions are attached to a seat, this
call will fail for them. The returned string needs to be freed with the
libc free(3) call after use.
RETURN VALUE
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_seat() return 0 or a positive integer. On failure, these
calls return a negative errno-style error code.
NOTES
The sd_session_is_active(), sd_session_get_uid(), and
sd_session_get_seat() interfaces are available as shared library, which
can be compiled and linked to with the libsystemd-login pkg-config(1)
file.
SEE ALSOsystemd(1), sd-login(7), sd_pid_get_session(3)AUTHOR
Lennart Poettering <lennart@poettering.net>
Developer
systemd 05/23/2012 SD_SESSION_IS_ACTIVE(3)