WSCONSCFG(8) BSD System Manager's Manual WSCONSCFG(8)NAMEwsconscfg — configure and switch between virtual terminals on a wscons
display
SYNOPSISwsconscfg [-e emul] [-f ctldev] [-t type] index
wsconscfg-d [-F] [-f ctldev] index
wsconscfg-g [-f ctldev]
wsconscfg-k | -m [-d] [-f ctldev] [index]
wsconscfg-s [-f ctldev] index
DESCRIPTION
The wsconscfg tool allows to create, delete and switch between virtual
terminals on display devices controlled by the wscons terminal framework
if the underlying display hardware driver supports multiple screens.
Further it controls the assignment of keyboards to displays. The index
argument specifies which virtual terminal is to be configured; the
allowed numbers are from 0 to an implementation-specified value (cur‐
rently 7, allowing for 8 virtual terminals on a display). In keyboard
configuration mode, it specifies the wskbd(4) device to attach or detach.
Without further option arguments, a virtual terminal is created with
implementation specific properties and a default terminal emulation vari‐
ant selected at kernel compile time.
The options are:
-d Delete the specified terminal. A terminal opened by a program
will not be deleted unless the -F option is applied. Termi‐
nals used by the operating system console or a graphics pro‐
gram (X server) cannot be deleted. With the -k flag, the key‐
board specified by index will be detached from the wscons dis‐
play. With the -m flag, the multiplexor specified by index
will be detached from the wscons display.
-e emul Specify the terminal emulation to use for the virtual termi‐
nal. The set of available terminal emulations is determined
at kernel compile time. See wscons(4) for details.
-F Force deleting of a terminal even if it is in use by a user
space program.
-f ctldev Specify the control device of the wscons display to operate
on. Default is /dev/ttyEcfg.
-g Print the index of the current virtual terminal.
-k Do keyboard related operations instead of virtual screen con‐
figuration. Without other flags, a keyboard will be attached
to the display device. The index argument can be omitted, in
this case the first free keyboard will be used.
-m Do multiplexor related operations instead of virtual screen
configuration. Without other flags, a multiplexor will be
attached to the display device.
-s Switch to the specified virtual terminal.
-t type Specify a screen type to use. Screen types refer to display
format, colour depth and other low-level display properties.
Valid type arguments are defined by the underlying display
device driver.
Typically, the wsconscfg utility will be invoked in system startup by the
/etc/rc.d/wscons script, controlled by the /etc/wscons.conf configuration
file.
FILES
/etc/wscons.conf
EXAMPLESwsconscfg-t 80x50 -e vt100 1
Configure screen 1 (i.e., the second), it will get the type ‘80x50’ and
use the VT100 terminal emulation. (Note: ‘80x50’ is a screen type
offered by the vga(4) display driver. In this particular case, an
8×8-font must be loaded before to make the screen useful. See
wsfontload(8).)
wsconscfg-k
Connect the first unconnected keyboard to the display.
wsconscfg 3
Create screen 3.
wsconscfg-d 3
Delete screen 3.
wsconscfg-s 2
Switch to screen 2.
SEE ALSOwscons(4), wskbd(4), wsconsctl(8), wsfontload(8)BUGS
There should be an easy way to get a list of the screen types available
on a display, and of the emulations supported by the kernel.
BSD June 24, 2006 BSD
