unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (NetBSD-2.0)
Page:
Section:
Apropos / Subsearch:
optional field

WSCONSCFG(8)              BSD 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
     option arguments, a virtual terminal is created with implementation spe-
     cific 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
                attached 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
                device 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.

BSD                            January 12, 1999                            BSD