Manual Pages for UNIX Operating System command usage for man ck-seat-tool

Maintenance Commands                             ck-seat-tool(1m)



NAME
     ck-seat-tool - ConsoleKit seat tool

SYNOPSIS
     ck-seat-tool --add  --display-type=type  [--seat-id=id]  [--
     session-type=type] [variable,variable...]

     ck-seat-tool --delete --session-id=id

     ck-seat-tool [--help] [--version]

DESCRIPTION
     ck-seat-tool is a utility that causes ConsoleKit to  add  or
     delete  a  ConsoleKit  session  in  a dymanic fashion.  When
     adding a session, the --display-type option must  be  speci-
     fied.  When deleting a session, the --session-id option must
     be specified.

     To use ck-seat-tool, it must be run as the same  user  which
     is running the main ConsoleKit daemon, which is normally the
     root user.  Otherwise the request is ignored.

     When adding a session, the --seat-id option  works  as  fol-
     lows:

       +o  If --seat-id=id is provided and this seat exists,  then
          a new session will be added to that seat.

       +o  If --seat-id=id is provided, but  this  seat  does  not
          exist,  then a new seat with the specified seat.  id is
          created, and a new session added to that seat.

       +o  If --seat-id=id is not given, a  new  seat  id  (Seat#)
          will  be  generated,  and  a  new session added to that
          seat.


     Note that to delete a session which is running on a particu-
     lar    DISPLAY,   it   may   be   necessary   to   run   the
     ck-list-sessions(1) command to find the  corresponding  ses-
     sion ID for a given DISPLAY.

OPTIONS
     The following options are supported:

     -a, --add               Add the specified session.



     -d, --delete            Delete the specified session.





SunOS 5.11          Last change: 24 Oct 2009                    1






Maintenance Commands                             ck-seat-tool(1m)



     --display-type=type     This option is only  available  when
                             adding  a  session.   Specifies  the
                             display  type  in   the   ConsoleKit
                             display  configuration  that will be
                             associated with the session.



     -h, --help              Display detailed usage message.



     --seat-id=id            This option is only  available  when
                             adding a session. Specifies the seat
                             id that will be associated with  the
                             session.



     --session-id=id         This option is only  available  when
                             deleting  a  session.  Specifies the
                             session id associated  with  session
                             that will be deleted.



     --session-type=type     This option is only  available  when
                             adding  a  session.   Specifies  the
                             session type that will be associated
                             with the session.  The default value
                             is "LoginWindow".



     -V, --version           Display the version of the  ck-seat-
                             tool application.



OPERANDS
     The following operand is supported only when adding  a  ses-
     sion:

     variable

         The variable operand is only  available  when  adding  a
         sesssion.  The command to run when starting a session is
         specified in a  ConsoleKit  display  configuration  file
         named   /etc/ConsoleKit/displays.d/display_type.display,
         where display_type is specified  by  the  --display-type
         option.   This file is in standard INI format.  The com-
         mand is specified by the key "X11/Exec".  For example:



SunOS 5.11          Last change: 24 Oct 2009                    2






Maintenance Commands                             ck-seat-tool(1m)



         [X11]
         Exec=/usr/X11/bin/Xorg $display -br -verbose $vt

         Arguments that start with the "$"  sign  are  variables.
         The values for these variables can be specified with the
         variable  operand.   For  example,  if  this  value   is
         "display=:0,vt=vt9", this would set the "$display" argu-
         ment to ":0" and the "$vt" argument to "vt9".



EXAMPLES
     Example 1: To add a session to the next available seat  with
     a display type of "Local" and start it on display ":20"

     example% ck-seat-tool -a --display-type=Local display=:20

     Example 2: To add a session to Seat10 with a session type of
     "LoginWindow",  a  display  type of "Local", and start it on
     display ":20"

     example% ck-seat-tool -a --session-type=LoginWindow --display-type=Local --seat-id=Seat10 display=:20

     Example  3:  To  remove  the   session   with   session   ID
     "/org/freedesktop/ConsoleKit/Session2"

     example% ck-seat-tool --d --session-id=/org/freedesktop/ConsoleKit/Session2

FILES
     The following files are used by this application:

     /usr/sbin/ck-seat-tool

         Executable for ConsoleKit seat tool.



     /etc/ConsoleKit/displays.d

         ConsoleKit display configuration files.



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









SunOS 5.11          Last change: 24 Oct 2009                    3






Maintenance Commands                             ck-seat-tool(1m)



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


SEE ALSO
     ck-history(1),  ck-launch-session(1),   ck-list-sessions(1),
     gdmdynamic(1),   console-kit-daemon(1m),   gdm(1m),   attri-
     butes(5)

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






































SunOS 5.11          Last change: 24 Oct 2009                    4