wsconscfg(8) [netbsd man page]
WSCONSCFG(8) BSD System Manager's Manual WSCONSCFG(8) NAME
wsconscfg -- configure and switch between virtual terminals on a wscons display SYNOPSIS
wsconscfg [-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 frame- work 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 (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 option arguments, a virtual terminal is created with implementation specific properties and a default terminal emu- lation variant 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. 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. -e emul 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 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 configuration. 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 config- uration 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. wsconscfg 3 Create screen 3. wsconscfg -d 3 Delete screen 3. wsconscfg -s 2 Switch to screen 2. 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. BSD
June 24, 2006 BSD
Check Out this Related Man Page
WSCONS(4) BSD Kernel Interfaces Manual WSCONS(4) NAME
wscons -- workstation console access SYNOPSIS
options WSEMUL_SUN options WSEMUL_VT100 options WSEMUL_NO_DUMB options WSEMUL_DEFAULT="xxx" options WS_DEFAULT_FG=WSCOL_XXX options WS_DEFAULT_BG=WSCOL_XXX options WS_DEFAULT_COLATTR="(WSATTR_XXX | WSATTR_YYY)" options WS_DEFAULT_MONOATTR="(WSATTR_XXX | WSATTR_YYY)" options WS_KERNEL_FG=WSCOL_XXX options WS_KERNEL_BG=WSCOL_XXX options WS_KERNEL_COLATTR="(WSATTR_XXX | WSATTR_YYY)" options WS_KERNEL_MONOATTR="(WSATTR_XXX | WSATTR_YYY)" options WSCOMPAT_USL_SYNCTIMEOUT=nnn options WSDISPLAY_COMPAT_PCVT options WSDISPLAY_COMPAT_SYSCONS options WSDISPLAY_COMPAT_USL options WSDISPLAY_COMPAT_RAWKBD options WSKBD_EVENT_AUTOREPEAT options WSKBD_USONLY wsdisplay* at ... wskbd* at ... mux N wsmouse* at ... mux N pseudo-device wsmux N DESCRIPTION
The wscons driver provides support for machine independent access to the console. wscons is made of a number of cooperating modules, in particular o hardware support for display adapters, keyboards and mice, see wsdisplay(4), wskbd(4), and wsmouse(4) o input event multiplexor, see wsmux(4) o terminal emulation modules (see below), and o compatibility options to support control operations and other low-level behaviour of existing terminal drivers (see below) Terminal emulations wscons does not define its own set of terminal control sequences and special keyboard codes in terms of termcap(5). Instead a ``terminal emulation'' is assigned to each virtual screen when the screen is created. (See wsconscfg(8).) Different terminal emulations can be active at the same time on one display. The following choices are available: dumb This minimal terminal support is available unless the kernel option options WSEMUL_NO_DUMB was specified at build time. No control sequences are supported besides the ASCII control characters. The cursor is not addressable. Only ASCII keyboard codes will be delivered, cursor and functions keys do not work. sun The ``sun'' console emulation is available if options WSEMUL_SUN was specified at kernel build time. It supports the control sequences of SUN machine consoles and delivers its keyboard codes for function and keypad keys in use. This emulation is sufficient for full-screen applications. vt100 is available with the kernel compile option options WSEMUL_VT100. It provides the most commonly used functions of DEC VT100 termi- nals with some extensions introduced by the DEC VT220 and DEC VT320 models. The features of the original VT100 which are not or not completely implemented are: o VT52 support, 132-column-mode, smooth scroll, light background, keyboard autorepeat control, external printer support, keyboard locking, newline/linefeed switching: Escape sequences related to these features are ignored or answered with standard replies. (DECANM, DECCOLM, DECSCLM, DECSCNM, DECARM, DECPFF, DECPEX, KAM, LNM) o Function keys are not reprogrammable and fonts can not be downloaded. DECUDK and DECDLD sequences will be ignored. o Neither C1 control set characters will be recognized nor will 8-bit keyboard codes be delivered. o The ``DEC supplemental graphic'' font is approximated by the ISO-latin-1 font, though there are subtle differences. o The actual rendering quality depends on the underlying graphics hardware driver. Characters might be missing in the available fonts and be substituted by more or less fitting replacements. Depending on the keyboard used, not all function keys might be available. In addition to the plain VT100 functions are supported: o ANSI colors. o Some VT220 -like presentation state settings and -reports (DECRSPS), especially tabulator settings. In most applications, wscons will work sufficiently as a VT220 emulator. The WSEMUL_DEFAULT kernel option is used to select one of the described terminal options as the default choice. The default takes effect at kernel startup, i.e. for the operating system console or additional screens allocated through the WSDISPLAY_DEFAULTSCREENS option (see wsdisplay(4)), or if no emulation type was passed to the wsconscfg(8) utility. Compatibility options these options allow X servers and other programs using low-level console driver functions usually written specifically for other console drivers to run on NetBSD systems. The options are in particular: WSDISPLAY_COMPAT_USL Support the protocol for switches between multiple virtual screens on one display as used by most PC-UNIX variants. This is used by the NetBSD wsconscfg(8) utility. WSDISPLAY_COMPAT_RAWKBD Allows to get raw XT keyboard scancodes from PC keyboards as needed by i386 X servers. WSDISPLAY_COMPAT_PCVT Emulates enough of the NetBSD/i386 ``pcvt'' driver to make X servers work. WSDISPLAY_COMPAT_SYSCONS Emulates enough of the FreeBSD ``syscons'' driver to make X servers work. Useful with FreeBSD binary emulation. Linux/i386 X servers usually run successfully if the first two options are enabled together with the NetBSD Linux binary emulation. (To have programs looking for device special files of other console drivers find the wscons driver entry points, symlinks are a helpful mea- sure.) Other options options WS_DEFAULT_FG=WSCOL_XXX, options WS_DEFAULT_BG=WSCOL_XXX, options WS_DEFAULT_COLATTR="(WSATTR_XXX | WSATTR_YYY)" and options WS_DEFAULT_MONOATTR="(WSATTR_XXX | WSATTR_YYY)" allow to make default console output appear in specific colors and attributes. ``WS_DEFAULT_FG'' and ``WS_DEFAULT_BG'' set the foreground / background used on color displays. The ``WSCOL_XXX'' arguments are colors as defined in src/sys/dev/wscons/wsdisplayvar.h. ``WS_DEFAULT_COLATTR'' and ``WS_DEFAULT_MONOATTR'' are additional attribute flags used on color or monochrome displays, respectively. The arguments are defined in the same header file. Whether the attributes are supported or not depends on the actually used graphics adapter. These options are ignored by the ``dumb'' terminal emulation. options WS_KERNEL_FG=WSCOL_XXX, options WS_KERNEL_BG=WSCOL_XXX, options WS_KERNEL_COLATTR="(WSATTR_XXX | WSATTR_YYY)" and options WS_KERNEL_MONOATTR="(WSATTR_XXX | WSATTR_YYY)" allow to make console output originating from the kernel appear differently than output from user level programs (via /dev/console or the specific tty device like /dev/ttyE0). Their meaning is the same as their 'WS_DEFAULT_*' counterparts. options WSCOMPAT_USL_SYNCTIMEOUT=nnn The virtual screen switching protocol enabled by ``WSDISPLAY_COMPAT_USL'' uses a somewhat complex handshake protocol to pass con- trol to user programs such as X servers controlling a virtual screen. In order to prevent a non-responsive application from lock- ing the whole console system, a screen switch will be rolled back after a 5 second timeout if the application does not respond. This option can be used to specify in seconds a different timeout value. options WSKBD_EVENT_AUTOREPEAT If set, this option enables auto repeat even in event mode. The auto repeat will generate key down events while the key is pressed. options WSKBD_USONLY In order to strip down the space usage of wscons, all keymaps except the US english one can be removed from the kernel with this option, which results in a space gain of about 10kB. SEE ALSO
wsdisplay(4), wskbd(4), wsmouse(4), wsmux(4), wsconscfg(8), wsconsctl(8), wsfontload(8), wscons(9) BSD
June 5, 2012 BSD