Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ck-list-sessions (1)

Name

ck-list-sessions - Show ConsoleKit Session Information

Synopsis

ck-list-sessions [--all] [--sid=sid] [--format=format] [--help] [--ver-
sion]

Description

ck-list-sessions(1)         General Commands Manual        ck-list-sessions(1)



NAME
       ck-list-sessions - Show ConsoleKit Session Information

SYNOPSIS
       ck-list-sessions [--all] [--sid=sid] [--format=format] [--help] [--ver-
       sion]

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.

       -s, --sid=sid       Show one ConsoleKit session with session id sid.

       -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 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 speci-
                           fied by the "Type" key in  the  ConsoleKit  session
                           configuration file associated with this session.

       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.

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

FILES
       The following files are used by this application:

       /usr/bin/ck-list-sessions
                           Executable for Show ConsoleKit Session Information.

       /etc/ConsoleKit/session.d
                           ConsoleKit session configuration files.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------------+
       |ATTRIBUTE TYPE |    ATTRIBUTE VALUE     |
       +---------------+------------------------+
       |Availability   | library/xdg/consolekit |
       +---------------+------------------------+
       |Stability      | Uncommitted            |
       +---------------+------------------------+

SEE ALSO
       ck-history(1),  ck-launch-session(1), ck-seat-tool(8), console-kit-dae-
       mon(8), gdm(8), attributes(7)




NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was  downloaded  from   http://www.freedesktop.org/software/Con-
       soleKit/dist/ConsoleKit-0.4.1.tar.bz2.

       Further information about this software can be found on the open source
       community website at http://www.freedesktop.org/software/ConsoleKit.



                                  12 Sep 2016              ck-list-sessions(1)