1.\" $OpenBSD: wsconscfg.8,v 1.20 2010/07/01 02:46:06 maja Exp $ 2.\" $NetBSD: wsconscfg.8,v 1.5 1999/05/15 14:45:06 drochner Exp $ 3.\" 4.\" Copyright (c) 1999 5.\" Matthias Drochner. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.Dd $Mdocdate: July 1 2010 $ 29.Dt WSCONSCFG 8 30.Os 31.Sh NAME 32.Nm wsconscfg 33.Nd configure virtual terminals on a wscons display 34.Sh SYNOPSIS 35.Nm wsconscfg 36.Op Fl dFkm 37.Op Fl e Ar emul 38.Op Fl f Ar ctldev 39.Op Fl t Ar type 40.Ar index 41.Sh DESCRIPTION 42The 43.Nm 44tool allows for the creation and removal of virtual terminals 45on display devices controlled by the wscons terminal framework, 46as long as the underlying display hardware driver supports multiple screens. 47Furthermore, it controls the assignment of keyboards to displays. 48.Pp 49The 50.Ar index 51argument specifies which virtual terminal is to be configured. 52Valid numbers range from 0 to an implementation-specified value 53(currently 11, allowing for 12 virtual terminals on a display). 54In keyboard configuration mode 55(see 56.Fl k , 57below), 58it specifies the 59.Xr wskbd 4 60device to attach or detach. 61Without further option arguments, a virtual terminal is created with 62implementation specific properties and a default terminal emulation variant 63selected at kernel compile time. 64.Pp 65The options are as follows: 66.Bl -tag -width Ds 67.It Fl d 68Delete the specified terminal. 69Any specified terminal that is currently open by a program will not be deleted 70unless the 71.Fl F 72option is also given. 73Terminals used by the operating system console or a graphics program (X server) 74cannot be deleted. 75With the 76.Fl k 77flag, the keyboard specified by 78.Ar index 79will be detached from the wscons display. 80With the 81.Fl m 82flag, the multiplexor specified by 83.Ar index 84will be detached from the wscons display. 85.It Fl e Ar emul 86Specify the terminal emulation to use for the virtual terminal. 87The set of available terminal emulations is determined at kernel compile time. 88See 89.Xr wscons 4 90for details. 91.It Fl F 92Force deletion of a terminal, keyboard, or multiplexor, 93even if it is in use by a userspace program. 94.It Fl f Ar ctldev 95Specify the control device of the wscons display to operate on. 96The default is 97.Pa /dev/ttyCcfg . 98.It Fl k 99Do keyboard related operations instead of virtual screen configuration. 100Without other flags, a keyboard will be attached to the display device. 101The 102.Ar index 103argument can be omitted: in that case the first free keyboard will be used. 104.It Fl m 105Do multiplexor related operations instead of virtual screen configuration. 106Without other flags, a multiplexor will be attached to the display device. 107.It Fl t Ar type 108Specify a screen type to use. 109Screen types refer to display format, color depth, and other low-level 110display properties. 111Valid 112.Ar type 113arguments are defined by the underlying display device driver. 114.El 115.\" .Pp 116.\" Typically, the 117.\" .Nm 118.\" utility will be invoked in system startup by the 119.\" .Pa /etc/rc.wscons 120.\" script, controlled by the 121.\" .Pa /etc/wscons.conf 122.\" configuration file. 123.Sh EXAMPLES 124Configure screen 1 (i.e., the second) for type 125.Dq 80x50 126and VT100 terminal emulation. 127(Note: 128.Dq 80x50 129is a screen type offered by the 130.Xr vga 4 131display driver. 132In this particular case, an 8x8-font must be loaded beforehand to make the 133screen useful. 134See 135.Xr wsfontload 8 . ) 136.Pp 137.D1 # wsconscfg -t 80x50 -e vt100 1 138.Pp 139Connect the first unconnected keyboard to the display: 140.Pp 141.Dl # wsconscfg -k 142.\" .Sh FILES 143.\" .Bl -tag -width /etc/wscons.conf -compact 144.\" .It Pa /etc/wscons.conf 145.\" wscons configuration file 146.\" .El 147.Sh SEE ALSO 148.Xr wscons 4 , 149.Xr wskbd 4 , 150.Xr wsconsctl 8 , 151.Xr wsfontload 8 152.Sh HISTORY 153The 154.Nm 155program first appeared in 156.Ox 2.8 . 157