144 lines
4.7 KiB
Groff
144 lines
4.7 KiB
Groff
.\" $NetBSD: wsconscfg.8,v 1.14 2003/02/25 10:36:22 wiz Exp $
|
|
.\"
|
|
.\" Copyright (c) 1999
|
|
.\" Matthias Drochner. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.Dd January 12, 1999
|
|
.Os
|
|
.Dt WSCONSCFG 8
|
|
.Sh NAME
|
|
.Nm wsconscfg
|
|
.Nd configure virtual terminals on a wscons display
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl f Ar ctldev
|
|
.Op Fl t Ar type
|
|
.Op Fl e Ar emul
|
|
.Ar index
|
|
.Nm
|
|
.Op Fl f Ar ctldev
|
|
.Fl d
|
|
.Op Fl F
|
|
.Ar index
|
|
.Nm
|
|
.Op Fl f Ar ctldev
|
|
.Fl k | m
|
|
.Op Fl d
|
|
.Op Ar index
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
tool allows to create and delete virtual terminals on display devices
|
|
controlled by the wscons terminal framework if the underlying display hardware
|
|
driver supports multiple screens. Further it controls the assignment of
|
|
keyboards to displays.
|
|
The
|
|
.Ar 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
|
|
.Xr wskbd 4
|
|
device to attach or detach.
|
|
Without further option arguments, a virtual terminal is created with
|
|
implementation specific properties and a default terminal emulation variant
|
|
selected at kernel compile time.
|
|
.Pp
|
|
The options are:
|
|
.Bl -tag -width xxxxxxxxx
|
|
.It Fl f Ar ctldev
|
|
Specify the control device of the wscons display to operate on.
|
|
Default is
|
|
.Pa /dev/ttyEcfg .
|
|
.It Fl d
|
|
Delete the specified terminal. A terminal opened by a program will not be
|
|
deleted unless the
|
|
.Fl F
|
|
option is applied. Terminals used by the operating system console or a
|
|
graphics program (X server) cannot be deleted. With the
|
|
.Fl k
|
|
flag, the keyboard specified by
|
|
.Ar index
|
|
will be detached from the wscons display.
|
|
With the
|
|
.Fl m
|
|
flag, the multiplexor specified by
|
|
.Ar index
|
|
will be detached from the wscons display.
|
|
.It Fl F
|
|
Force deleting of a terminal even if it is in use by a user space program.
|
|
.It Fl k
|
|
Do keyboard related operations instead of virtual screen configuration.
|
|
Without other flags, a keyboard will be attached to the display device. The
|
|
.Ar index
|
|
argument can be omitted, in this case the first free keyboard will be used.
|
|
.It Fl m
|
|
Do multiplexor related operations instead of virtual screen configuration.
|
|
Without other flags, a multiplexor will be attached to the display device.
|
|
.It Fl t Ar type
|
|
Specify a screen type to use. Screen types refer to display format, colour
|
|
depth and other low-level display properties. Valid
|
|
.Ar type
|
|
arguments are defined by the underlying display device driver.
|
|
.It Fl e Ar emul
|
|
Specify the terminal emulation to use for the virtual terminal. The set of
|
|
available terminal emulations is determined at kernel compile time. See
|
|
.Xr wscons 4
|
|
for details.
|
|
.El
|
|
.Pp
|
|
Typically, the
|
|
.Nm
|
|
utility will be invoked in system startup by the
|
|
.Pa /etc/rc.d/wscons
|
|
script, controlled by the
|
|
.Pa /etc/wscons.conf
|
|
configuration file.
|
|
.Sh FILES
|
|
.Pa /etc/wscons.conf
|
|
.Sh EXAMPLES
|
|
.Dl wsconscfg -t 80x50 -e vt100 1
|
|
.Pp
|
|
Configure screen 1 (i.e. the second), it will get the type
|
|
.Ql 80x50
|
|
and use the VT100 terminal emulation. (Note:
|
|
.Ql 80x50
|
|
is a screen type offered by the
|
|
.Xr vga 4
|
|
display driver. In this particular case, an 8\(mu8-font must be loaded
|
|
before to make the screen useful. See
|
|
.Xr wsfontload 8 . )
|
|
.Pp
|
|
.Dl wsconscfg -k
|
|
.Pp
|
|
Connect the first unconnected keyboard to the display.
|
|
.Sh SEE ALSO
|
|
.Xr wscons 4 ,
|
|
.Xr wskbd 4 ,
|
|
.Xr wsconsctl 8 ,
|
|
.Xr wsfontload 8
|
|
.Sh 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.
|