wsconscfg - configure virtual terminals on a wscons display
wsconscfg [-dFkm] [-e emul] [-f ctldev] [-t type] index
The wsconscfg tool allows for the creation and removal of
on display devices controlled by the wscons terminal
long as the underlying display hardware driver supports multiple screens.
Furthermore, it controls the assignment of keyboards to displays.
The index argument specifies which virtual terminal is to be
Valid numbers range from 0 to an implementation-specified
7, allowing for 8 virtual terminals on a display). In
mode (see -k, below), it specifies the wskbd(4)
device to attach
or detach. Without further option arguments, a virtual
created with implementation specific properties and a default terminal
emulation variant selected at kernel compile time.
The options are as follows:
-d Delete the specified terminal. Any specified terminal that is
currently open by a program will not be deleted unless the -F option
is also given. Terminals used by the operating
or a graphics program (X server) cannot be
the -k flag, the keyboard specified by index will be
from the wscons display. With the -m flag, the multiplexor specified
by index will be detached from the wscons display.
Specify the terminal emulation to use for the virtual terminal.
The set of available terminal emulations is determined at kernel
compile time. See wscons(4) for details.
-F Force deletion of a terminal, keyboard, or multiplexor, even if
it is in use by a userspace program.
Specify the control device of the wscons display to
The default is /dev/ttyCcfg.
-k Do keyboard related operations instead of virtual
Without other flags, a keyboard will be attached to the
display device. The index argument can be omitted:
in that case
the first free keyboard will be used.
-m Do multiplexor related operations instead of virtual
Without other flags, a multiplexor will
to the display device.
Specify a screen type to use. Screen types refer to
color depth, and other low-level display properties. Valid
type arguments are defined by the underlying display
Configure screen 1 (i.e., the second) for type ``80x50'' and
emulation. (Note: ``80x50'' is a screen type offered by
display driver. In this particular case, an 8x8-font must
be loaded beforehand
to make the screen useful. See wsfontload(8).)
# wsconscfg -t 80x50 -e vt100 1
Connect the first unconnected keyboard to the display:
# wsconscfg -k
wscons(4), wskbd(4), wsconsctl(8), wsfontload(8)
The wsconscfg program first appeared in OpenBSD 2.8.
There should be an easy way to get a list of the screen
on a display, and of the emulations supported by the kernel.
OpenBSD 3.6 January 12, 1999
[ Back ]