ck-seat-tool(1m) Maintenance Commands ck-seat-tool(1m)NAMEck-seat-tool - ConsoleKit seat tool
SYNOPSISck-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]
DESCRIPTIONck-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 specified. 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 follows:
· If --seat-id=id is provided and this seat exists, then a new ses‐
sion will be added to that seat.
· 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 ses‐
sion added to that seat.
· If --seat-id=id is not given, a new seat id (Seat#) will be gener‐
ated, and a new session added to that seat.
Note that to delete a session which is running on a particular DISPLAY,
it may be necessary to run the ck-list-sessions(1) command to find the
corresponding session ID for a given DISPLAY.
OPTIONS
The following options are supported:
-a, --add Add the specified session.
-d, --delete Delete the specified session.
--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 appli‐
cation.
OPERANDS
The following operand is supported only when adding a session:
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/dis‐
play_type.display, where display_type is specified by the --dis‐
play-type option. This file is in standard INI format. The com‐
mand is specified by the key "X11/Exec". For example:
[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" argument 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 "LoginWin‐
dow", 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/Con‐
soleKit/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 attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │library/xdg/consolekit │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOck-history(1), ck-launch-session(1), ck-list-sessions(1), gdmdy‐
namic(1), 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 24 Oct 2009 ck-seat-tool(1m)