Manual Pages for UNIX Operating System command usage for man ck-list-sessions

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.  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 informa-
     tion 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 speci-
                             fied  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 application.



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

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






SunOS 5.11          Last change: 22 Oct 2009                    1






User Commands                                 ck-list-sessions(1)



     realname                The name of the user associated with
                             the session.



     seat                    The ID for the ConsoleKit Seat asso-
                             ciated with the session.



     session-type            The ConsoleKit session  type.   This
                             value is specified by the "Type" key
                             in the ConsoleKit session configura-
                             tion  file associated with this ses-
                             sion.



     display-type            The ConsoleKit display  type.   This
                             value  is specified by the "Display-
                             Template" key in the ConsoleKit ses-
                             sion  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" otherwise.



     x11-display             The  value  of   the   X11   DISPLAY
                             environment  variable  for this ses-
                             sion 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.







SunOS 5.11          Last change: 22 Oct 2009                    2






User Commands                                 ck-list-sessions(1)



     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  underlying 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 ses-
                             sion 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 Ses-
                             sion object itself will periodically
                             update   this  value  based  on  the
                             activity detected  on  the  display-
                             device itself.

                             This  should   not   be   considered
                             authoritative.




SunOS 5.11          Last change: 22 Oct 2009                    3






User Commands                                 ck-list-sessions(1)



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

     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




SunOS 5.11          Last change: 22 Oct 2009                    4






User Commands                                 ck-list-sessions(1)



     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | library/xdg/consolekit      |
    |_____________________________|_____________________________|
    | Interface stability         | Volatile                    |
    |_____________________________|_____________________________|


SEE ALSO
     ck-history(1),    ck-launch-session(1),    ck-seat-tool(1m),
     console-kit-daemon(1m), gdm(1m), attributes(5)

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




































SunOS 5.11          Last change: 22 Oct 2009                    5