NetBSD/usr.sbin/wsconscfg/wsconscfg.8

120 lines
3.4 KiB
Groff
Raw Normal View History

2001-04-03 16:01:39 +04:00
.\" $NetBSD: wsconscfg.8,v 1.11 2001/04/03 12:01:39 wiz Exp $
.\"
.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
1999-05-15 18:45:06 +04:00
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).
1999-05-15 18:45:06 +04:00
In keyboard configuration mode, it specifies the
2001-04-03 16:01:39 +04:00
.Xr wskbd 4
1999-05-15 18:45:06 +04:00
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
1999-05-15 18:45:06 +04:00
graphics program (X server) cannot be deleted. With the
.Fl k
flag, the keyboard specified by
.Ar index
1999-07-29 22:24:09 +04:00
will be detached from the wscons display.
With the
.Fl m
flag, the multiplexor specified by
.Ar index
1999-07-29 22:24:09 +04:00
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.
1999-05-15 18:45:06 +04:00
.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
1999-05-15 18:45:06 +04:00
argument can be omitted, in this case the first free keyboard will be used.
1999-07-29 22:24:09 +04:00
.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
1999-03-31 19:37:47 +04:00
available terminal emulations is determined at kernel compile time. See
.Xr wscons 4
for details.
.El
1999-03-31 19:37:47 +04:00
.Pp
Typically, the
.Nm
utility will be invoked in system startup by the
.Pa /etc/rc.d/wscons
1999-03-31 19:37:47 +04:00
script, controlled by the
.Pa /etc/wscons.conf
configuration file.
.Sh EXAMPLES
.Dl wsconscfg -t 80x50 -e vt100 1
.Pp
Configure screen 1 (i.e. the second), it will get the type
.Ql 80x50
1999-03-31 19:37:47 +04:00
and use the VT100 terminal emulation. (Note:
.Ql 80x50
1999-03-31 19:37:47 +04:00
is a screen type offered by the
.Xr vga 4
display driver. In this particular case, an 8\(mu8-font must be loaded
1999-03-31 19:37:47 +04:00
before to make the screen useful. See
2001-04-03 16:01:39 +04:00
.Xr wsfontload 8 . )
1999-05-15 18:45:06 +04:00
.Pp
.Dl wsconscfg -k
.Pp
Connect the first unconnected keyboard to the display.
.Sh FILES
.Pa /etc/wscons.conf
.Sh SEE ALSO
1999-05-15 18:45:06 +04:00
.Xr wscons 4 ,
.Xr wskbd 4 ,
1999-02-03 23:59:20 +03:00
.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.