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)

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

home | help