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 ConsoleKit
     database.	 ck-list-sessions returns information about each ConsoleKit ses-
     sion.

     The following properties can be displayed for each session:

OPTIONS
     The following options are supported:

     -h, --help 	     Display detailed usage message.

     -V, --version	     Display the version of the ck-list-sessions  appli-
			     cation.

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 session.

     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 special purpose ses-
			     sions.

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

     display-type	     The  ConsoleKit display type.  This value is speci-
			     fied by the "DisplayTemplate" key in the ConsoleKit
			     session configuration  file  associated  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"  other-
			     wise.

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

     x11-display-device      The value of the display device that the  X11  dis-
			     play  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 underly-
			     ing  system  uses to enforce session boundaries. 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  responsibility  for  updating   this
			     value. Typically, the screensaver will set this.

			     However, for non-graphical sessions with a display-
			     device  set the Session object itself will periodi-
			     cally update this value based on the  activity  de-
			     tected on the display-device itself.

			     This should not be considered authoritative.

EXAMPLES
     Example : Show running sessions.

     example% ck-list-sessions

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

     Session2:
	  unix-user = '1000'
	  realname = 'John Doe'
	  seat = 'seat0'
	  session-type = 'x11'
	  session-class = 'user'
	  session-state = 'active'
	  session-service = 'gdm-password'
	  active = TRUE
	  x11-display = ':0'
	  x11-display-device = '/dev/ttyC4'
	  display-device = ''
	  remote-host-name = ''
	  is-local = TRUE
	  on-since = '2023-08-09T05:55:15.544361Z'
	  login-session-id = ''
	  XDG_RUNTIME_DIR = '/var/run/user/1000'
	  VTNr = '5'

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+15.1.quarterly>

home | help