Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ck-list-sessions(1)		 User Commands		   ck-list-sessions(1)

NAME
       ck-list-sessions	- Show ConsoleKit Session Information

SYNOPSIS
       ck-list-sessions	[--all]	[--format=format] [--help] [--version]

DESCRIPTION
       ck-list-sessions	 is  a utility that displays information from the Con-
       soleKit database.  By default, only open	sessions are shown.  The --all
       option can be used to display all existing sessions on the system.  ck-
       list-sessions returns information about each ConsoleKit session.	 Users
       can specify which properties to display via the --format	option.

       The following properties	can be displayed for each session:

OPTIONS
       The following options are supported:

       -a, --all	       Show  all  ConsoleKit sessions.	If this	option
			       is not provided,	only open sessions are shown.

       -f, --format=format     Display information using the specified format.
			       The  format  value  is  a list of properties to
			       display separated by commas.

       -h, --help	       Display detailed	usage message.

       -V, --version	       Display the version of the ck-list-sessions ap-
			       plication.

EXTENDED DESCRIPTION
   ConsoleKit session properties
       For each	session, the following session properties are displayed:

       unix-user	       The user	id value associated with the session.

       realname		       The  name  of the user associated with the ses-
			       sion.

       seat		       The ID for the ConsoleKit Seat associated  with
			       the session.

       session-type	       The ConsoleKit session type.  This value	is set
			       by the process that opens the session and  will
			       usually	be  set	 to the	display	protocol used,
			       i.e.  x11, wayland, tty,	mir, or	unspecified.

       session-class	       The ConsoleKit session class.   This  value  is
			       set  by	the process that opens the session and
			       will usually be set to user for normal sessions
			       or greeter, lock-screen,	or background for spe-
			       cial purpose sessions.

       session-state	       The current state of the	ConsoleKit session. It
			       is managed by ConsoleKit	and will either	return
			       online, active, or closing.

       display-type	       The ConsoleKit display  type.   This  value  is
			       specified  by  the "DisplayTemplate" key	in the
			       ConsoleKit session configuration	 file  associ-
			       ated with this session.

       open		       The value is "TRUE" if the session is open, and
			       "FALSE" otherwise.

       active		       The value is "TRUE" if the session is active on
			       the  seat  to which it is attached, and "FALSE"
			       otherwise.

       x11-display	       The value of the	X11 DISPLAY environment	 vari-
			       able for	this session if	one is present.

       x11-display-device      The  value  of  the display device that the X11
			       display for the session is  connected  to.   If
			       there is	no x11-display set, then this value is
			       undefined.

       display-device	       The display device associated with the session.

       remote-host	       If the session is not local, the	value  is  the
			       host  name associated with the session.	If the
			       session is local, the value is empty.

       VTNr		       The virtual terminal the	ConsoleKit session  is
			       on, if any.

       is-local		       The  value  is  "TRUE" if the session is	local,
			       and "FALSE" if remote.

       on-since		       An ISO 8601 date-time string  that  corresponds
			       to the time the session started.

       login-session-id	       The  value of the login session ID that the un-
			       derlying	system uses to enforce session	bound-
			       aries. If there is no login session ID set then
			       this value is an	empty string.

       idle-since-hint	       An ISO 8601 date-time string  that  corresponds
			       to  the	time  of  the last change of the idle-
			       hint.  This is a	hint used to indicate that the
			       session	may  be	 idle.	 For  sessions	with a
			       x11-display set (ie. graphical sessions), it is
			       up to each session to delegate the responsibil-
			       ity for updating	 this  value.  Typically,  the
			       screensaver will	set this.

			       However,	for non-graphical sessions with	a dis-
			       play-device set the Session object itself  will
			       periodically update this	value based on the ac-
			       tivity detected on the display-device itself.

			       This should not be considered authoritative.

EXAMPLES
       Example 1: Show running sessions.

       example%	ck-list-sessions

       This command would generate output like the following for each session:

       SessionSeat1Local:
	       unix-user = '50'
	       realname	= 'GDM Reserved	UID'
	       seat = 'Seat1'
	       session-type = 'LoginWindow'
	       display-type = 'Local'
	       open = 'TRUE'
	       active =	'TRUE'
	       x11-display = ':0'
	       x11-display-device = '/dev/console'
	       display-device =	'/dev/console'
	       remote-host-name	= ''
	       is-local	= 'TRUE'
	       on-since	= '2009-08-11T06:46:42.941134Z'
	       login-session-id	= ''
	       idle-since-hint = ''

       Example 2: Show only the	session-id, unix-user, and display-type	 prop-
       erties.

       example%	ck-list-sessions --format="session-id,unix-user,display-type"

       This command would generate output like the following for each session:

       SessionSeat1Local       50      Local

SEE ALSO
       ck-history(1), ck-launch-session(1), console-kit-daemon(1m)

NOTES
       Written	by  Brian Cameron, Sun Microsystems Inc., 2009.	 Copyright (c)
       2009 by Sun Microsystems, Inc.

SunOS 5.11			  22 Oct 2009		   ck-list-sessions(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXTENDED DESCRIPTION | EXAMPLES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ck-list-sessions&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help