WSCONSCFG(8)            OpenBSD System Manager's Manual           WSCONSCFG(8)

NAME
     wsconscfg - configure virtual terminals on a wscons display

SYNOPSIS
     wsconscfg [-f <ctldev>] [-d [-F]] [-k] [-m] [-t <type>] [-e <emul>] index

DESCRIPTION
     The wsconscfg tool allows the creation and removal of virtual terminals
     on display devices controlled by the wscons terminal framework, as long
     as 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 im-
     plementation specific properties and a default terminal emulation variant
     selected at kernel compile time.

     The options are as follows:

     -f ctldev
             Specify the control device of the wscons display to operate on.
             Default is /dev/ttyCcfg.

     -d      Delete the specified terminal.  Any specified terminal that is
             currently open by a program will not be deleted unless the -F op-
             tion is also given.  Terminals used by the operating system con-
             sole 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 spec-
             ified 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 configu-
             ration.  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 con-
             figuration.  Without other flags, a multiplexor will be attached
             to the display device.

     -t type
             Specify a screen type to use.  Screen types refer to display for-
             mat, color depth, and other low-level display properties.  Valid
             type arguments are defined by the underlying display device driv-
             er.

     -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.

     Typically, the wsconscfg utility will be invoked in system startup by the
     /etc/rc.wscons script, controlled by the /etc/wscons.conf configuration
     file.

EXAMPLES
     wsconscfg -t 80x50 -e vt100 1

     Configure screen 1 (i.e., the second) for type ``80x50'' and VT100 termi-
     nal emulation.  (Note: ``80x50'' is a screen type offered by the vga(4)
     display driver.  In this particular case, an 8x8-font must be loaded be-
     forehand 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)

HISTORY
     The wsconscfg program appeared in OpenBSD 2.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.

OpenBSD 3.0                    January 12, 1999                              2
