Maintenance Commands ck-seat-tool(1m) NAME ck-seat-tool - ConsoleKit seat tool SYNOPSIS ck-seat-tool --add --display-type=_t_y_p_e [--seat-id=_i_d] [-- session-type=_t_y_p_e] [_v_a_r_i_a_b_l_e,_v_a_r_i_a_b_l_e...] ck-seat-tool --delete --session-id=_i_d 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=_i_d is provided and this seat exists, then a new session will be added to that seat. +o If --seat-id=_i_d is provided, but this seat does not exist, then a new seat with the specified seat. _i_d is created, and a new session added to that seat. +o If --seat-id=_i_d is not given, a new seat _i_d (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=_t_y_p_e This option is only available when adding a session. Specifies the display _t_y_p_e in the ConsoleKit display configuration that will be associated with the session. -h, --help Display detailed usage message. --seat-id=_i_d This option is only available when adding a session. Specifies the seat _i_d that will be associated with the session. --session-id=_i_d This option is only available when deleting a session. Specifies the session _i_d associated with session that will be deleted. --session-type=_t_y_p_e This option is only available when adding a session. Specifies the session _t_y_p_e 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: _v_a_r_i_a_b_l_e The _v_a_r_i_a_b_l_e 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/_d_i_s_p_l_a_y__t_y_p_e.display, where _d_i_s_p_l_a_y__t_y_p_e 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 _v_a_r_i_a_b_l_e 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