ck-seat-tool - ConsoleKit seat tool
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]
ck-seat-tool(8) System Manager's Manual ck-seat-tool(8)
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 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:
o If --seat-id=id is provided and this seat exists, then a new ses-
sion 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 ses-
sion added to that seat.
o If --seat-id=id is not given, a new seat id (Seat#) will be gener-
ated, and a new session added to that seat.
When adding a session, if session is successfully added, the session ID
is printed in the standard output.
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. Speci-
fies 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 session:
variable
The variable operand is only available when adding a session.
The command to run when starting a session is specified in a
ConsoleKit display configuration file named /etc/ConsoleKit/dis-
plays.d/display_type.display, where display_type is specified by
the --display-type option. This file is in standard INI format.
The command 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 val-
ues for these variables can be specified with the variable oper-
and. 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
EXIT STATUS
The following exit values are returned:
0 Application exited successfully
1 Application exited with failure
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(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-list-sessions(1), gdmdy-
namic(1), console-kit-daemon(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-seat-tool(8)