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