wsconscfg(8)
- NetBSD Manual Pages
WSCONSCFG(8) NetBSD System Manager's Manual WSCONSCFG(8)
NAME
wsconscfg - configure virtual terminals on a wscons display
SYNOPSIS
wsconscfg [-f ctldev] [-t type] [-e emul] index
wsconscfg [-f ctldev] -d [-F] index
wsconscfg [-f ctldev] -k | -m [-d] [index]
DESCRIPTION
The wsconscfg tool allows to create and delete virtual terminals on dis-
play devices controlled by the wscons terminal framework if the underly-
ing display hardware driver supports multiple screens. Further it con-
trols the assignment of keyboards to displays. The index argument speci-
fies which virtual terminal is to be configured; the allowed numbers are
from 0 to an implementation-specified value (currently 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 op-
tion arguments, a virtual terminal is created with implementation specif-
ic properties and a default terminal emulation variant selected at kernel
compile time.
The options are:
-f ctldev Specify the control device of the wscons display to operate
on. Default is /dev/ttyEcfg.
-d Delete the specified terminal. A terminal opened by a program
will not be deleted unless the -F option is applied. Terminals
used by the operating system console or a graphics program (X
server) cannot be deleted. With the -k flag, the keyboard
specified by index will be detached from the wscons display.
With the -m flag, the multiplexor specified by index will be
detached from the wscons display.
-F Force deleting of a terminal even if it is in use by a user
space program.
-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 at-
tached to the display device.
-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 de-
vice driver.
-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.
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
EXAMPLES
wsconscfg -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 8x8-font must
be loaded before to make the screen useful. See wsfontload(8).)
wsconscfg -k
Connect the first unconnected keyboard to the display.
SEE ALSO
wscons(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.
NetBSD 1.6.2 January 12, 1999 2
Powered by man-cgi (2024-03-20).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.