Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31170 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SD_SESSION_IS_ACTIVE(3)	     sd_session_is_active      SD_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);

DESCRIPTION
       sd_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 ALSO
       systemd(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)

Vote for polarhome