Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

move man pages into share/man.

Browse Source
This commit is contained in:
mrg 1997-06-23 03:30:19 +00:00
parent 1c91d7d00f
commit 90a52da37a
37 changed files with 72 additions and 2670 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
distrib/sets/lists/man/md_share
View File

@ -1,10 +1,20 @@
./usr/share/man/cat1/atari/edahdi.0
./usr/share/man/cat1/atari/msconfig.0
./usr/share/man/cat1/i386/cursor.0
./usr/share/man/cat1/i386/fed.0
./usr/share/man/cat1/i386/fontedit.0
./usr/share/man/cat1/i386/kcon.0
./usr/share/man/cat1/i386/loadfont.0
./usr/share/man/cat1/i386/mcon.0
./usr/share/man/cat1/i386/scon.0
./usr/share/man/cat1/i386/vt220keys.0
./usr/share/man/cat1/i386/vttest.0
./usr/share/man/cat1/x68k/bellctrl.0
./usr/share/man/cat1/x68k/loadfont.0
./usr/share/man/cat1/x68k/loadkmap.0
./usr/share/man/cat1/x68k/palette.0
./usr/share/man/cat1/x68k/tvctrl.0
./usr/share/man/cat3/i386/keycap.0
./usr/share/man/cat4/amiga/afsc.0
./usr/share/man/cat4/amiga/ahsc.0
./usr/share/man/cat4/amiga/atzsc.0
@ -86,6 +96,7 @@
./usr/share/man/cat4/i386/mem.0
./usr/share/man/cat4/i386/mms.0
./usr/share/man/cat4/i386/npx.0
./usr/share/man/cat4/i386/pcvt.0
./usr/share/man/cat4/i386/pms.0
./usr/share/man/cat4/i386/speaker.0
./usr/share/man/cat4/i386/wd.0
@ -181,6 +192,7 @@
./usr/share/man/cat4/vax/vp.0
./usr/share/man/cat4/vax/vv.0
./usr/share/man/cat4/x68k/pow.0
./usr/share/man/cat5/i386/keycap.0
./usr/share/man/cat8/alpha/installboot.0
./usr/share/man/cat8/alpha/installboot_cd9660.0
./usr/share/man/cat8/alpha/setnetbootinfo.0
@ -205,7 +217,10 @@
./usr/share/man/cat8/i386/MAKEDEV.0
./usr/share/man/cat8/i386/boot.0
./usr/share/man/cat8/i386/installboot.0
./usr/share/man/cat8/i386/ispcvt.0
./usr/share/man/cat8/i386/kbdio.0
./usr/share/man/cat8/i386/makedev.0
./usr/share/man/cat8/i386/vgaio.0
./usr/share/man/cat8/mac68k/boot.0
./usr/share/man/cat8/mvme68k/installboot.0
./usr/share/man/cat8/pmax/boot.0

4
share/man/man1/Makefile
View File

@ -1,8 +1,8 @@
# $NetBSD: Makefile,v 1.6 1997/06/22 07:02:27 mrg Exp $
# $NetBSD: Makefile,v 1.7 1997/06/23 03:35:40 mrg Exp $
# @(#)Makefile 8.1 (Berkeley) 6/5/93
MAN= cd.1 intro.1 wait.1
SUBDIR= man1.atari man1.x68k
SUBDIR= man1.atari man1.i386 man1.x68k
.include <bsd.prog.mk>

7
share/man/man1/man1.i386/Makefile Normal file
View File

@ -0,0 +1,7 @@
# $NetBSD: Makefile,v 1.1 1997/06/23 03:35:43 mrg Exp $
MAN= cursor.1 fed.1 fontedit.1 kcon.1 loadfont.1 mcon.1 scon.1 \
vt220keys.1 vttest.1
MANSUBDIR=/i386
.include <bsd.prog.mk>

4
share/man/man3/Makefile
View File

@ -1,4 +1,4 @@
# $NetBSD: Makefile,v 1.10 1995/10/06 07:21:58 thorpej Exp $
# $NetBSD: Makefile,v 1.11 1997/06/23 03:35:44 mrg Exp $
# @(#)Makefile 8.2 (Berkeley) 12/13/93
MAN= assert.3 bitstring.3 dlfcn.3 end.3 intro.3 queue.3 stdarg.3
@ -20,3 +20,5 @@ MLINKS+=dlfcn.3 dlopen.3 dlfcn.3 dlclose.3 dlfcn.3 dlsym.3 dlfcn.3 dlctl.3 \
dlfcn.3 dlerror.3
.include <bsd.prog.mk>
SUBDIR= man3.i386

6
share/man/man3/man3.i386/Makefile Normal file
View File

@ -0,0 +1,6 @@
# $NetBSD: Makefile,v 1.1 1997/06/23 03:35:46 mrg Exp $
MAN= keycap.3
MANSUBDIR=/i386
.include <bsd.prog.mk>

4
share/man/man4/man4.i386/Makefile
View File

@ -1,9 +1,9 @@
# $NetBSD: Makefile,v 1.29 1997/02/23 22:22:58 jonathan Exp $
# $NetBSD: Makefile,v 1.30 1997/06/23 03:35:48 mrg Exp $
# from: @(#)Makefile 5.1 (Berkeley) 2/12/91
MAN= apm.4 autoconf.4 busmouse.4 com.4 ed.4 fdc.4 \
ie.4 intro.4 joy.4 le.4 lms.4 lpt.4 mem.4 mms.4 npx.4 \
pms.4 speaker.4 wd.4
pms.4 pcvt.4 speaker.4 wd.4
MLINKS= mem.4 kmem.4
MANSUBDIR=/i386

4
share/man/man5/Makefile
View File

@ -1,4 +1,4 @@
# $NetBSD: Makefile,v 1.19 1997/01/30 09:37:20 matthias Exp $
# $NetBSD: Makefile,v 1.20 1997/06/23 03:35:50 mrg Exp $
# @(#)Makefile 8.1 (Berkeley) 6/5/93
# missing: dump.5 plot.5
@ -11,4 +11,6 @@ MAN= a.out.5 acct.5 core.5 daily.conf.5 dir.5 disktab.5 ethers.5 fs.5 \
utmp.5 weekly.conf.5
MLINKS= dir.5 dirent.5 fs.5 inode.5 utmp.5 wtmp.5 utmp.5 lastlog.5
SUBDIR= man5.i386
.include <bsd.prog.mk>

6
share/man/man5/man5.i386/Makefile Normal file
View File

@ -0,0 +1,6 @@
# $NetBSD: Makefile,v 1.1 1997/06/23 03:35:53 mrg Exp $
MAN= keycap.5
MANSUBDIR=/i386
.include <bsd.prog.mk>

4
share/man/man8/man8.i386/Makefile
View File

@ -1,7 +1,7 @@
# @(#)Makefile 5.1 (Berkeley) 3/22/91
# $NetBSD: Makefile,v 1.7 1997/06/22 05:58:25 mrg Exp $
# $NetBSD: Makefile,v 1.8 1997/06/23 03:35:55 mrg Exp $
MAN= MAKEDEV.8 boot.8 installboot.8
MAN= MAKEDEV.8 boot.8 installboot.8 ispcvt.8 kbdio.8 vgaio.8
MLINKS= MAKEDEV.8 makedev.8
MANSUBDIR=/i386

2
sys/arch/i386/isa/pcvt/Util/cursor/Makefile
View File

@ -1,3 +1,5 @@
PROG= cursor
NOMAN= yes
.include <bsd.prog.mk>

76
sys/arch/i386/isa/pcvt/Util/cursor/cursor.1
View File

@ -1,76 +0,0 @@
.\" Copyright (c) 1992, 1995 Hellmuth Michaelis
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Hellmuth Michaelis
.\" 4. The name authors may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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.
.\"
.\" @(#)cursor.1, 3.30, Last Edit-Date: [Fri Jun 30 20:06:58 1995]
.\"
.Dd December 19, 1994
.Dt CURSOR 1
.Sh NAME
.Nm cursor
.Nd set cursor shape for the pcvt VT220 video driver
.Sh SYNOPSIS
.Nm cursor
.Op Fl d Ar device
.Op Fl n Ar screenno
.Op Fl s Ar lineno
.Op Fl e Ar lineno
.Sh DESCRIPTION
The
.Nm cursor
utility allows the user to set the cursor shape in a given virtual screen
of the above mentioned driver.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl d
Specifies a device for which the cursor shape is set.
.It Fl n
Sets the virtual screen number to apply the following parameters to. Not
specifying this parameter implies the current virtual screen or the screen
referenced by the -d parameter.
.It Fl s
Specifies the starting (top) scanline the cursor should have.
.It Fl e
Specifies the last (bottom) scanline the cursor should have.
.El
.Pp
Be aware of the fact that the parameters need to be adjusted for the current
size of the characterfont in use, on EGA and VGA boards sizes of 8, 14 and
16 scanlines are currently supported.
.Sh EXAMPLES
The command
.Dq Li cursor -s3 -e10
sets the cursor on the current virtual screen to a rectangular shape on a
14 line VGA screen.
.Sh BUGS
No known bugs
.Sh SEE ALSO
.Xr loadfont 1 ,
.Xr scon 1 ,
.Xr pcvt 4

2
sys/arch/i386/isa/pcvt/Util/fed/Makefile
View File

@ -3,4 +3,6 @@ SRCS= fed.c select.c edit.c misc.c
LDADD= -lncurses
BINDIR= /usr/local/bin
NOMAN= yes
.include <bsd.prog.mk>

52
sys/arch/i386/isa/pcvt/Util/fed/fed.1
View File

@ -1,52 +0,0 @@
.\" Copyright (c) 1992, 1995 Hellmuth Michaelis
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Hellmuth Michaelis
.\" 4. The name authors may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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.
.\"
.\" @(#)fed.1, 3.30, Last Edit-Date: [Wed Jul 5 19:25:39 1995]
.\"
.Dd July 3, 1995
.Dt FED 1
.Sh NAME
.Nm fed
.Nd font editor for pcvt's EGA/VGA download fonts
.Sh SYNOPSIS
.Nm fed
.Op filename
.Sh DESCRIPTION
The
.Nm fed
utility allows a user to edit or create EGA/VGA download fontfiles to be
used by the
.Nm pcvt
device driver.
.Pp
.Sh BUGS
No known bugs
.Sh SEE ALSO
.Xr pcvt 4
.Xr loadfont 1

2
sys/arch/i386/isa/pcvt/Util/fontedit/Makefile
View File

@ -1,5 +1,7 @@
PROG= fontedit
CLEANFILES+= core.fontedit fontedit.core
NOMAN= yes
.include <bsd.prog.mk>

58
sys/arch/i386/isa/pcvt/Util/fontedit/fontedit.1
View File

@ -1,58 +0,0 @@
.TH FONTEDIT 1 LOCAL
.SH NAME
fontedit \- Edit fonts.
.SH SYNOPSIS
.B fontedit file
.SH DESCRIPTION
.I Fontedit
is used to edit the down line reloadable character set (DRCS) of a VT220
terminal. The editor has two display areas, one for displaying the
entry currently being manipulated, and one for displaying the complete
DRCS. Commands to the editor take the form of function keys.
.PP
.I Fontedit
takes one command line parameter, a file name. This file is
used to save the character set. If the file exists when \fIfontedit\fP
is invoked, it is read in to initialize the DRCS. The file is written
to when \fIfontedit\fP exits.
.PP
Commands to fontedit take the form of function keys. The current
definitions are:
.IP \fBHELP\fP
Display a help screen.
.IP \fBF6\fP
Turn the pixel under the cursor on.
.IP \fBF7\fP
Turn the pixel under the cursor off.
.IP \fBF13\fP
Clear the display area.
.IP \fBFind\fP
Save the current font in the font table. Update the DRCS display.
.IP \fBSelect\fP
Extract the entry selected by the cursor in the DRCS display.
.IP \fBPrev\fP
Move the cursor to the previous entry in the DRCS display.
.IP \fBNext\fP
Move the cursor to the next entry in the DRCS display.
.IP \fBInsert\fP
Insert a blank line at the current cursor position. The bottom row is lost.
.IP \fBRemove\fP
Remove the row at the current cursor position. All rows below the
current one are shifted up.
.IP \fBCursors\fP
Move the cursor in the main display area.
.PP
If the screen gets garbled, press <control-L>.
.PP
To exit \fIfontedit\fP, press <control-D>. The DRCS will be saved in
\fIfile\fP. To exit without saving the DRCS, hit interrupt (usually
DEL).
.SH DIAGNOSTICS
.I Fontedit
will issue a warning when the entry being worked on is not saved, and
some potentially destructive command, like \fBSelect\fP is used. To
override the warning message, immediately reissue the command.
.SH AUTHOR
Greg Franks.

3
sys/arch/i386/isa/pcvt/Util/ispcvt/Makefile
View File

@ -1,5 +1,6 @@
PROG= ispcvt
MAN8= ispcvt.${MAN8EXT}
NOMAN= yes
.include <bsd.prog.mk>

91
sys/arch/i386/isa/pcvt/Util/ispcvt/ispcvt.8
View File

@ -1,91 +0,0 @@
.\" Copyright (c) 1992, 1995 Hellmuth Michaelis
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Hellmuth Michaelis
.\" 4. The name authors may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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.
.\"
.\" @(#)ispcvt.1, 3.30, Last Edit-Date: [Mon Jul 3 11:25:37 1995]
.\"
.Dd April 4, 1995
.Dt ISPCVT 1
.Sh NAME
.Nm ispcvt
.Nd verify if current video driver is pcvt driver
.Sh SYNOPSIS
.Nm ispcvt
.Op Fl c
.Op Fl d Ar device
.Op Fl v
.Sh DESCRIPTION
The
.Nm ispcvt
utility allows the user to check whether the current video driver compiled
into the kernel is a pcvt driver. The major and minor release numbers of
the driver are also checked.
Furthermore
.Nm ispcvt
is also able to print out the values of all the
.Dq Ar PCVT_XXXXXX
compile time options, the driver in the current running kernel was
compiled with.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl d
Specifies a device for which the check is done.
.It Fl v
Specifies being verbose. On success the name and revision is reported, on
failure which comparison failed.
.It Fl c
This options prints out the values of all
.Dq Ar PCVT_XXXXXX
#defines which were given to the compiler at the time the currently running
kernel was compiled. Specifying
.Fl v
with the
.Fl c
option gives a verbose listing of the compile-time options.
.Sh RETURN VALUE
.Bl -tag -width Ds
.Pp
.It Sy 0
driver is pcvt and major and minor numbers match
.It Sy 1
open or ioctl system call failed
.It Sy 2
driver name mismatch
.It Sy 3
name matched, release major number mismatch
.It Sy 4
name & major number matched, release minor number mismatch
.It Sy 5
usage error
.El
.Pp
.Sh BUGS
No known bugs
.Sh SEE ALSO
.Xr pcvt 4

2
sys/arch/i386/isa/pcvt/Util/kbdio/Makefile
View File

@ -18,6 +18,8 @@ CFLAGS+= -I. #-g
CLEANFILES+= y.tab.h
CLEANFILES+= y.output # comment file from bison
NOMAN= yes
.include <bsd.prog.mk>
lex.o: y.tab.h lex.l

330
sys/arch/i386/isa/pcvt/Util/kbdio/kbdio.8
View File

@ -1,330 +0,0 @@
.\"
.\" Copyright (c) 1995 Joerg Wunsch
.\"
.\" All rights reserved.
.\"
.\" This program is free software.
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Joerg Wunsch
.\" 4. The name of the developer may not be used to endorse or promote
.\" products derived from this software without specific prior written
.\" permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``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 DEVELOPERS 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.
.\"
.\" $Header: /cvsroot/src/sys/arch/i386/isa/pcvt/Util/kbdio/Attic/kbdio.8,v 1.2 1995/10/07 21:45:17 jtc Exp $
.\"
.Dd April 15, 1995
.Dt KBDIO 8
.Sh NAME
.Nm kbdio
.Nd perform input/output on a PC keyboard/keyboard controller
.Sh SYNOPSIS
.Nm kbdio
.Op Fl d
.Op Fl f Ar devname
.Sh DESCRIPTION
.Ss Purpose
.Nm Kbdio
is used to perform input/output on a PC keyboard or the
.Pq motherboard
keyboard controller.
.Nm Kbdio
cares for proper handshaking and necessary IO-ready conditions. It
allows the interpretion of some registers in symbolic form, as well as
to specify symbolic operands for the keyboard command byte. Simple
arithmetic expressions can be formed to set or reset some bits, which
is mostly applicable to the keyboard command byte, too.
.Ss Options
.Bl -tag -width 10n -offset indent -compact
.It Fl d
Turn on the grammar parser debugger.
.It Fl f Ar devname
Operate on device
.Ar devname
instead of the default
.Pa /dev/console .
.El
.Ss Command language
The command language of
.Nm
constitutes of some very simple tokens and rules. Commands are executed
line by line as they are entered. Each line may contain any number of
semicolon-separated statements.
The list of acceptable statements includes:
.Bl -tag -width "TYPEMATIC" -indent offset -compact
.It Li \&?
.It Li help
Give help on the general syntax.
.It Li help expr
Help on expression syntax.
.It Li status \&?
Report keyboard controller status.
.It Li what \&?
Determine
.Tn MCA
type 1 or type 2 keyboard controller.
.It Li data \&?
Fetch keyboard controller data port.
.It Li led \&= Ar number
Set keyboard LEDs.
.Ar Number
is a logical combination of
.Bl -hang -width "4" -compact
.It 1
scroll lock LED
.It 2
num lock LED
.It 4
caps lock LED.
.El
.It Li echo
Send keyboard
.Li ECHO
command.
.It Li scan \&= Ar number
Turn keyboard to generate scan codes according to code set
.Ar number .
Only supported on
.Tn PS/2
style keyboards.
.It Li scan \&?
Report code set keyboard is currently operating in.
.It Li \&id \&?
Ask keyboard to report its identification bytes
.It Xo
.Li typematic \&= Ar number1 Li \&, Ar number2
.Xc
Set keyboard typematic delay and repeat rate to
.Ar number1
milliseconds and
.Ar number2
repeats per second, respectively.
.It Li enable
Enable keyboard.
.It Li defaults
Return customizable parameters to defaults.
.It Li all typematic
Set all keys to
.Em typematic
behaviour. This command as well as the following ones are only
supported on
.Tn PS/2
style keyboards and only while operating in scan code set 3.
.It Li all make release
Turn all keys in generating
.Em make
and
.Em release
events only.
.It Li all make only
Turn all keys in generating
.Em make
codes only.
.It Li all typematic make release
Set all keys to generate
.Em make
and
.Em release
events, as well as perform
.Em typematic
behaviour. This is usually the default.
.It Ar number Li typematic
Set key
.Ar number
to
.Em typematic
behaviour.
.It Ar number Li make release
Turn a single key
.Ar number
to generate
.Em make
and
.Em release
events only.
.It Ar number Li make only
Set key
.Ar number
to return
.Em make
events only.
.It Li resend
Ask the keyboard to retransmit its last character.
.It Li reset
Perform a keyboard
.Li RESET
command.
.It Li cmd \&?
Get the keyboard command byte and interpret it symbolically.
.It Li cmd \&= Ar expr
Set the keyboard command byte to
.Ar expr .
See the next subsection for expression syntax.
.El
Returned data will be printed hexadecimal, but any queued keyboard
control responses will be printed first.
.Ss Expression syntax
Expressions can either consist of a number, possibly followed
by a
.Sq +
or
.Sq \-
sign and bit values in numeric or symbolic form.
Symbolic bit values are
.Pq with their meaning in the keyboard command byte :
.Bl -tag -width "ovrinh" -offset indent -compact
.It Li scconv
value
.Li 0x40 ,
enable PC scan code conversion at
.Em controller
level, as opposed to the different keyboard scan code sets;
.It Li ignpar
value
.Li 0x20 ,
ignore keyboard parity;
.It Li clklow
value
.Li 0x10 ,
hold keyboard clock line low
.Pq disables keyboard ;
.It Li ovrinh
value
.Li 0x08 ,
override keyboard inhibit function -- ignore the keyboard lockout switch,
intented to allow the keyboard self-test;
.It Li test
value
.Li 0x04 ,
controller self-test okay;
.It Li irq
value
.Li 0x01 ,
enable generation of
.Li IRQ1
if output buffer is full.
.El
The operators
.Sq +
and
.Sq \-
perform simple bit-set or bit-clear functionality, respectively. This
is roughly comparable with the operators
.Sq \&|
and
.Sq \&&~
in
.Em C .
Expressions are evaluated left to right and cannot be bracketed.
The special keyword
.Li cmd
is substituted by a read of the current keyboard command byte.
.Ss Access control
The caller must have uid 0 in order to gain the required access to
the IO registers.
.Sh EXAMPLES
.Dl led=3
Turn on num lock and scroll lock LEDs.
.Dl "cmd = cmd - irq; id?; cmd = cmd + irq"
Temporarily suspend keyboard interrupt generation, and ask the
keyboard to return its identification bytes.
.Sh FILES
.Pa /dev/console
is used as the default device to enable access to the IO registers.
.Sh HISTORY
This program is considered
.Dq hackware .
It has been developed in order to simplify the process of developing other
software that needs to handle the PC keyboard, and to give a very basic
aid in debugging keyboard-related problems.
.Sh AUTHOR
The program has been contributed by
.if n Joerg Wunsch,
.if t J\(:org Wunsch,
Dresden
.Aq joerg_wunsch@uriah.heep.sax.de .
.Sh BUGS
No useful diagnostics are printed in case of a syntax error.
Remember, to use this program, your kernel has to be compiled with XSERVER
being defined.
Use of this program might cause grievous harm to your system's sanity,
not only that it might hang your keyboard and/or keyboard controller
indefinitely, it might also hard-reset your system when accidentally
accessing the hardware reset facility of the keyboard controller
.Po
which does not actually belong there, but used to be
.Pc .
It is highly recommended to use this program only when logged into the
machine across a network or on a serial line.

2
sys/arch/i386/isa/pcvt/Util/kcon/Makefile
View File

@ -2,6 +2,8 @@ PROG= kcon
DEVICE= /dev/ttyv0
CFLAGS+= -I${.CURDIR}/../keycap -DKEYB_DEVICE=\"${DEVICE}\"
NOMAN= yes
# the -Lfoo could be omitted if libkeycap.a were installed before
# making those programs here

122
sys/arch/i386/isa/pcvt/Util/kcon/kcon.1
View File

@ -1,122 +0,0 @@
.\" Copyright (c) 1992, 1995 Hellmuth Michaelis
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Hellmuth Michaelis
.\" 4. The name authors may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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.
.\"
.\" @(#)kcon.1, 3.31, Last Edit-Date: [Thu Aug 24 10:46:12 1995]
.\"
.Dd August 24, 1995
.Dt KCON 1
.Sh NAME
.Nm kcon
.Nd keyboard control and remapping for the pcvt driver
.Sh SYNOPSIS
.Nm kcon
.Op Fl d Ar delay
.Op Fl l
.Op Fl m Ar map
.Op Fl o
.Op Fl p
.Op Fl R
.Op Fl r Ar rate
.Op Fl s
.Op Fl t Ns Ar +/-
.Op Fl x
.Sh DESCRIPTION
.Nm kcon
is used for controlling all aspects of keyboard configuration for the 'pcvt'
video driver.
.Pp
The available options are:
.Bl -tag -width flag
.It Fl d Ar delay
Specifies the delay after which the last key entered will be repeated by the
Keyboard. Valid values are 0..3 corresponding to delays of 250, 500, 750 and
1000 milliseconds.
.It Fl l
Displays the current keyboard map in use by the driver.
.It Fl m Ar map
Specifies the map entry to be searched in the keyboard capabilities database
.Nm keycap.
The database is searched for the entry and if found, the mapping
is loaded and is used in the driver from then on.
.It Fl o
Switches display of control codes to octal in the listing of the current map.
To be used in conjunction with the
.Fl l
option.
.It Fl p
Uses 'pure' output when listing - the Escape character is displayed in either
octal or hexadecimal and not as 'ESC'. To be used in conjunction with the
.Fl l
option.
.It Fl r Ar rate
Specifies the character repetition rate. Valid argument values are 0...31
corresponding to rates of 30 characters/second ... 2 characters/second.
.It Fl R
Reset the Keyboard.
.It Fl s
Displays the current settings of the rate and delay values.
.It Fl t Ar +/-
Specify this option to enable (
.Ar +
) or disable (
.Ar -
) the repetition of keys.
.It Fl x
Switches display of control codes to hexadecimal in the listing of the current map.
To be used in conjunction with the
.Fl l
option. This is the default behaviour.
.Sh FILES
.Bl -tag -width /usr/share/misc/keycap -compact
.It Pa /usr/share/misc/keycap
Keyboard capabilities data base file if nothing else was chosen during installation.
.It Pa /dev/console
Keyboard raw device.
.Sh SEE ALSO
.Xr keycap 3 ,
.Xr keycap 5
.Sh BUGS
.Nm kcon
detects several inconsistencies in the keycap database. In case of errors
.Nm kcon
exits with an error message. If this happens, the keyboard may remain in
an undefined state. To recover from such situation, execute
.Nm kcon -m default
.Sh EXAMPLES
The command
.Dq Li kcon -m gb
loads the entry 'gb' from the keycap file into the keyboard to switch to
a british keyboard behaviour.
The command
.Dq Li kcon -r 0 -d 0
switches the keyboard to emit characters at a rate of 30 characters per second
after a key has been held down for 250 milliseconds.

5
sys/arch/i386/isa/pcvt/Util/keycap/Makefile
View File

@ -4,9 +4,8 @@ CAPPATH = $(CAPDIR)/keycap.pcvt
KEYCAPSRC= keycap.src
CFLAGS += -DKEYCAP_PATH=\"$(CAPPATH)\"
SRCS = keycap.c
MAN3 = keycap.${MAN3EXT}
MAN5 = keycap.${MAN5EXT}
#CLEANFILES+= keycap.0 keycap.0
NOMAN= yes
beforeinstall:
@if [ ! -d ${DESTDIR}${CAPDIR} ]; then mkdir ${DESTDIR}${CAPDIR};fi

121
sys/arch/i386/isa/pcvt/Util/keycap/keycap.3
View File

@ -1,121 +0,0 @@
.\"
.\" Copyright (c) 1992,1993,1994 Hellmuth Michaelis
.\"
.\" Copyright (c) 1990 The Regents of the University of California.
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the University of
.\" California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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.
.\"
.\" @(#)keycap.3, 3.00, Last Edit-Date: [Sun Jan 2 13:46:43 1994]
.\"
.Dd January 3, 1993
.Dt KEYCAP 3
.Sh NAME
.Nm kgetent ,
.Nm kgetnum ,
.Nm kgetflag ,
.Nm kgetstr
.Nd routines for accessing the keycap database
.Sh SYNOPSIS
.Fn kgetent "char *bp" "char *name"
.Fn kgetnum "char *id"
.Fn kgetflag "char *id"
.Ft char *
.Fn kgetstr "char *id" "char *area"
.Sh DESCRIPTION
These functions extract and use capabilities from a keyboard capability data
base, usually
.Pa /usr/share/misc/keycap ,
the format of which is described in
.Xr keycap 5 .
.Pp
The
.Fn kgetent
function
extracts the entry for keyboard mapping
.Fa name
into the buffer at
.Fa bp .
The
.Fa bp
argument
should be a character buffer of size
1024 and must be retained through all subsequent calls to
.Fn kgetnum ,
.Fn kgetflag ,
and
.Fn kgetstr .
The
.Fn kgetent
function
returns \-1 if none of the
.Nm keycap
data base files could be opened,
0 if the map name given does not have an entry,
and 1 if all goes well.
.Pp
The
.Fn kgetnum
function
gets the numeric value of capability
.Fa id ,
returning \-1 if is not given for the map.
.Pp
The
.Fn kgetflag
function
returns 1 if the specified capability is present in
the map's entry, 0 if it is not.
.Pp
The
.Fn kgetstr
function
returns the string value of the capability
.Fa id ,
places it in the buffer at
.Fa area ,
and advances the
.Fa area
pointer.
The
.Fn kgetstr
function
returns
.Dv NULL
if the capability was not found.
.Pp
.Sh FILES
.Bl -tag -width /usr/share/misc/keycap -compact
.It Pa /usr/share/misc/keycap
Keyboard capabilities database (if nothing else chosen during installation).
.El
.Sh SEE ALSO
.Xr kcon 1 ,
.Xr keycap 5

133
sys/arch/i386/isa/pcvt/Util/keycap/keycap.5
View File

@ -1,133 +0,0 @@
.\"
.\" Copyright (c) 1992,1993,1994 Hellmuth Michaelis
.\"
.\" Copyright (c) 1990 The Regents of the University of California.
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the University of
.\" California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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.
.\"
.\" @(#)keycap.5, 3.00, Last Edit-Date: [Sun Jan 2 13:45:59 1994]
.\"
.Dd January 3, 1993
.Dt KEYCAP 5
.Sh NAME
.Nm keycap
.Nd keyboard mapping data base
.Sh SYNOPSIS
.Nm keycap
.Sh DESCRIPTION
The
.Nm keycap
file
is a data base describing keyboard mappings, used by
.Xr kcon 1 .
.Pp
Entries in
.Nm keycap
consist of a number of `:'-separated fields.
The first entry for each mapping gives the names that are known for the
mapping, separated by `|' characters.
All names but the first and last
should be in lower case and contain no blanks;
the last name may well contain
upper case and blanks for readability.
.Sh CAPABILITIES
.Pp
.Bl -column indent indent
.Sy Name Type Description
.It "de bool Resets Keyboard mapping to compiled-in default"
.It "D<n> bool Disables key <n> completely"
.It "m<n> num specify key numbers for ALT keys
.It "l<n> num specify key numbers for ALTGR keys
.It "h<n> num specify key numbers for SHIFT keys
.It "t<n> num specify key numbers for CONTROL keys
.It "ca<n> num specify key number for the CAPS LOCK key
.It "sh<n> num specify key number for the SHIFT LOCK key
.It "nl<n> num specify key number for the NUM LOCK key
.It "sc<n> num specify key number for the SCROLL LOCK key
.It "K<n> str bind a string to a unshifted (normal) key
.It "S<n> str bind a string to a shifted key
.It "C<n> str bind a string to a control key
.It "A<n> str bind a string to a altgr key
.It "tc str Entry of similar map \- must be last."
.El
Parameter <n> describing the key number can have values from 1 to 128.
A string parameter may have up to 15 characters.
.Pp
.Ss A Sample Entry
The following entry, which describes a test entry, is among the very
easy entries in the
.Nm keycap
file as of this writing.
.Pp
.Bd -literal
tt\||test\||Test entry which swaps y and z:\e
:K22=z:S22=Z:C22=\e032:\e
:K46=y:S46=Y:C46=\e031:
.Ed
.Pp
Entries may continue onto multiple lines by giving a \e as the last
character of a line. Comments may be included on lines beginning with
.Dq # .
.Sh FILES
.Bl -tag -width /usr/share/misc/keycap -compact
.It Pa /usr/share/misc/keycap
File containing keyboard mapping descriptions.
.El
.Sh SEE ALSO
.Xr kcon 1 ,
.Xr keycap 3 ,
.Sh EXAMPLES
The entry
.Dq Li l1#60
sets the keynumber for the ALTGR key to 60.
The entry
.Dq Li K100=hugo
binds the string 'hugo' to the key number 100.
The entry
.Dq Li K100=^D
binds the control character EOT (0x04) to the key number 100.
The entry
.Dq Li K100=\e000
binds the control character NUL (0x00) to the key number 100.

2
sys/arch/i386/isa/pcvt/Util/loadfont/Makefile
View File

@ -1,3 +1,5 @@
PROG= loadfont
NOMAN= yes
.include <bsd.prog.mk>

91
sys/arch/i386/isa/pcvt/Util/loadfont/loadfont.1
View File

@ -1,91 +0,0 @@
.\" Copyright (c) 1992, 1995 Hellmuth Michaelis
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Hellmuth Michaelis
.\" 4. The name authors may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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.
.\"
.\" @(#)loadfont.1, 3.31, Last Edit-Date: [Thu Aug 24 10:44:42 1995]
.\"
.Dd August 24, 1995
.Dt LOADFONT 1
.Sh NAME
.Nm loadfont
.Nd EGA/VGA fontloader for pcvt video driver.
.Sh SYNOPSIS
.Nm loadfont
.Op Fl c Ar charsetno
.Op Fl d Ar devicefile
.Op Fl f Ar fontfilename
.Op Fl i
.Op Fl s Ar scanlines
.Sh DESCRIPTION
The
.Nm loadfont
utility is used to load fonts needed for proper operation of the pcvt
VT220 driver on EGA and VGA boards into the font ram of this boards.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl c
Specifies the slot, the font is to load into. EGA boards have four
slots and VGA boards have eight slots available for downloading fonts.
.It Fl d
Specifies the devicefile to use.
.It Fl f
Specifies the file which contains the font to be downloaded.
.It Fl i
Gives information what type(s) of font do currently reside in which slot.
This is also the default behaviour if no options are specified on the commandline.
.It Fl s
Specifies the number of scanlines of the display.
.El
.Pp
This utility is used only on EGA and VGA boards, as MDA, HCG and CGA boards
do not have downloadable charactersets available.
.Sh FILES
The following fontfiles are available in the pcvt distribution:
.nf
/usr/share/misc/pcvtfonts/vt220l.808: 8x8 IBM II font
/usr/share/misc/pcvtfonts/vt220h.808: 8x8 Extension font
/usr/share/misc/pcvtfonts/vt220l.810: 8x10 IBM II font
/usr/share/misc/pcvtfonts/vt220h.810: 8x10 Extension font
/usr/share/misc/pcvtfonts/vt220l.814: 8x14 IBM II font
/usr/share/misc/pcvtfonts/vt220h.814: 8x14 Extension font
/usr/share/misc/pcvtfonts/vt220l.816: 8x16 IBM II font
/usr/share/misc/pcvtfonts/vt220h.816: 8x16 Extension font
.fi
.Sh EXAMPLES
The command
.Dq Li loadfont -c0 -f/usr/share/misc/pcvtfonts/vt220l.816
loads a 8x16 font containing the standard IBM characterset II into font slot
0 on a VGA or EGA board.
.Sh BUGS
No known bugs
.Sh SEE ALSO
.Xr cursor 1 ,
.Xr scon 1 ,
.Xr pcvt 8

2
sys/arch/i386/isa/pcvt/Util/mcon/Makefile
View File

@ -1,3 +1,5 @@
PROG= mcon
NOMAN= yes
.include <bsd.prog.mk>

166
sys/arch/i386/isa/pcvt/Util/mcon/mcon.1
View File

@ -1,166 +0,0 @@
.\" Copyright (c) 1994, 1995 Joerg Wunsch
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Joerg Wunsch
.\" 4. The name authors may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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.
.\"
.\" @(#)mcon.1, 3.30, Last Edit-Date: [Fri Jun 30 20:14:42 1995]
.\"
.Dd January 3, 1994
.Dt MCON 1
.Sh NAME
.Nm mcon
.Nd controls pcvt mouse emulator
.Sh SYNOPSIS
.Nm mcon
.Op Fl l Ar left-button-key
.Op Fl m Ar mid-button-key
.Op Fl r Ar right-button-key
.Op Fl a Ar accel-time
.Op Fl s Ar 0 | false | \&no
.Op Fl s Ar 1 | true | yes
.Ar device
.Sh DESCRIPTION
The
.Nm mcon
utility controls the configurable parameters for the mouse emulator of
.Xr pcvt 4 .
.br
.Em NB :
The mouse emulator is not configured in by default; the system's config
file needs to specify an option line
.Em options Dq PCVT_EMU_MOUSE
in order to get its functionality.
.Pp
Either way, the
.Nm
program must be called with an argument
.Ar device
that specifies the device node used for the mouse emulation. This is
usually the first device node of the
.Xr pcvt 4
driver not being used as a virtual terminal device. E.\ g., if you
have configured eight virtual terminals
.Pq the default value ,
named
.Pa /dev/ttyv0
through
.Pa /dev/ttyv7 ,
the mouse emulator would allocate
.Pa /dev/ttyv8 .
If
.Nm
is called without any option, it will print the actual values of the
configurable parameters.
If called with an option, the program attempts to set up the new value.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl l Ar left-button-key
.It Fl m Ar mid-button-key
.It Fl r Ar right-button-key
Maps the named
.Ar button key
to emulate either the left, middle, or right mouse button.
.Ar Button key
is the usual name for that key. Normal ASCII keys are denoted by the
character they're labeled with, function keys are named
.Em f1
through
.Em f10 .
Note that the AT function keys
.Em f11
and
.Em f12
are
.Em extended
keys that cannot be mapped to be used with the mouse emulator since
it only allows basic PC-scancode keys to be used.
.It Fl a Ar accel-time
Set the time limit for the internal accelerator to
.Ar accel-time
milliseconds. Key events occurring after a longer time than this limit
will move the mouse cursor in single steps. Key events arriving more
frequently will move the cursor accelerated by a factor of 6. Note that
despite of
.Em milliseconds
being the unit of choice here, the time resolution is restricted by the
timer tick distance of the underlying operating system, usually to a
granularity of 10 milliseconds.
.It Fl s Ar 0 | false | \&no
.It Fl s Ar 1 | true | yes
The first form disables, the second form enables the
.Em sticky
behaviour of the mouse buttons. Sticky mouse keys behave much like
toggle-buttons: on first press, they become active, on second press,
they're deactivated. Pressing another button will deactivate any
other sticky button anyway.
Sticky buttons might be more convenient since you don't need 20 fingers
at all; on the other hand, they make it virtually impossible to initiate
double or triple mouse clicks.
.El
.Sh EXAMPLES
The following example would install the default behaviour of the
mouse emulator:
.Nm mcon
.Fl l Ar f1
.Fl m Ar f2
.Fl r Ar f3
.Fl a Ar 250
.Fl s Ar \&no
.Pa /dev/ttyv8
.Sh BUGS
The key names used to map the button-emulating keys to scan codes
.Pq and vica verse
are based on the American keyboard layout. This would usually not
cause any trouble since the
.Dq button-of-choice
is certainly some function key that should be equal for any national
keyboard layout.
.Pp
The mouse emulator is a rude hack at all; its only purpose is to provide
a device to move the pointer within an X-windowing environment.
.Sh SEE ALSO
.Xr pcvt 4 ,
.Xr X 1x .
.Sh HISTORY
The
.Nm
utility appeared in
.Xr pcvt 4 ,
release 3.00.
.Sh AUTHOR
The mouse emulator has been contributed by
.if n Joerg Wunsch.
.if t J\(:org Wunsch.

904
sys/arch/i386/isa/pcvt/Util/pcvtdoc/pcvt.4
View File

@ -1,904 +0,0 @@
.\"
.\" Copyright (c) 1992, 1995 Hellmuth Michaelis, Brian Dunford-Shore,
.\" Joerg Wunsch and Holger Veit.
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Hellmuth Michaelis,
.\" Brian Dunford-Shore, Joerg Wunsch and Holger Veit.
.\" 4. The name authors may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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.
.\"
.\" @(#)pcvt.4, 3.30, Last Edit-Date: [Fri Jun 30 20:15:30 1995]
.\"
.\" Man page pcvt(4) created after pcvt_ioctl.h on 13-Jan-93
.\" by Joerg Wunsch
.\"
.\" updated for rel 2.10 (-hm)
.\" updated for rel 2.20 (-hm)
.\" updated for rel 3.00 (-jw)
.\" updated for final rel 3.00 (-hm)
.\" removed references to 386BSD (-hm)
.\"
.Dd February 27, 1994
.Dt PCVT 4
.Sh NAME
.Nm pcvt
.Nd PC console virtual screen system
.Sh SYNOPSIS
options
.Do
.Em PCVT_FREEBSD = version
|
.Em PCVT_NETBSD = version
.Dc
.br
.Op options Dq Em PCVT_NSCREENS = number
.br
.Op options Dq Em PCVT_XXXX
.Po
see
.Sx Configuration
below
.Pc
.Pp
device
.Em vt0
at
.Em isa?
port
.Dq Em IO_KBD
.Em tty
irq
.Em 1
vector
.Em pcrint
.Sh DESCRIPTION
.Ss Overview
The
.Nm pcvt
driver provides a virtual screen system with several additional
features not available in
.Xr pc 4
standard console device driver. Besides the ability of handling
multiple virtual screens,
the probably most important is an emulation of a wide range
of DEC VT-220
.if t \(tm
.if n (TM)
functionality. See
.Sx Features
for a detailed description.
.Ss Features
.Bl -bullet
.It
Almost full DEC VT220
.if t \(tm
.if n (TM)
functionality
.Po
moving towards VT320
.if t \(tm
.if n (TM)
.Pc
.It
Completely independent virtual terminals for MDA/HGC/CGA/EGA and VGA
.It
25, 28, 35, 40, 43 or 50x80 screen resolution for each virtual screen
.It
Fully remappable keyboard to support national keyboards
.It
All VT220 character sets plus ISO Latin-1 and DEC technical supported
.It
VT220 downloadable character set supported when run on EGA/VGA
.It
VT220 user defined keys for each virtual terminal
.It
Optional function key label support
.if t \('a
.if n 'a
la Hewlett-Packard
.It
Display function codes functionality
.It
Support for MDA, CGA, EGA and VGA display adaptors
.It
Support for 132 column operation on VGA chipsets
.It
X Window Support for XFree86 >= 1.2 using the pccons model, or
for XFree86 >= 2.0 using the syscons model
.Po
requires
.Em PCVT_USL_VT_COMPAT
to be configured
.Pc
.El
What it cannot:
.Bl -bullet
.It
No double wide/high characters
.It
No softscroll
.It
No inverse background
.It
No VT220 printer output support
.It
No VT52 support at all
.It
No 8-bit controls
.It
Only limited AT-keyboard
.Pq 84 keys
support
.Pq yet
.It
Help you to make money...
.El
.Ss Configuration
The
.Nm pcvt
console driver is currently available for the Intel-based BSD operating
systems
.Em NetBSD/i386 Pq release 0.9 or higher,
and
.Em FreeBSD Pq release 1.0-GAMMA or higher .
In order to get the appropriate system support, one of the options
.Em PCVT_NETBSD ,
or
.Em PCVT_FREEBSD
must be defined in the system's config file
.Pq see Xr config 8 .
In addition, for the
.Em FreeBSD
and
.Em NetBSD
operating systems, it is necessary to set this option to the operating
system's version number.
For
.Em FreeBSD
this version number must be expressed as a 3-digit number.
E.\& g., if you are running the 1.0 release
.Pq which is actually version 1.0.2 ,
you should define
.Em PCVT_FREEBSD = 102
For
.Em NetBSD
this version number must be expressed as 9 if you are running NetBSD 0.9
and anything greater than 9 for NetBSD-current (pre 1.0). It is recommended
to use (as with FreeBSD) 100 for NetBSD 1.0 and 999 for NetBSD-current.
E.\& g., if you are running the NetBSD 1.0 release, you should define
.Em PCVT_NETBSD = 100
The
.Nm pcvt
driver has been designed to be highly configurable in order to satisfy
everyone's needs. The preferred way for those configurations is to
provide appropriate
.Em options
lines within the config file, possibly overriding the built-in default
values. Therefore it is possible to compile several distinct kernels
with different driver behaviour on a single machine.
The following list gives a short overview of the available configuration
options. Refer to the file
.Pa i386/isa/pcvt/pcvt_hdr.h
in the kernel source tree for detailed documentation.
Note: the following conventions apply to all the Boolean options.
If an option is given with no value, a value of 1
.Pq activated
is substituted. If an option value is given as 0, this options is
deactivated. Any other value is substituted by 1, too. If an option
is omitted, a built-in default is assumed.
.Bl -tag -width indent -compact
.It Em PCVT_NSCREENS
Defines the number of virtual screens.
.br
Default: 8
.It Em PCVT_VT220KEYB
If activated, a keyboard layout resembling a DEC VT200 (TM) is generated.
If deactivated, a mixture between VT220 and HP is used. See the files
.Pa Keyboard.VT
and
.Pa Keyboard.HP
in the
.Nm pcvt
documentation directory for a full description.
.br
Default: off
.It Em PCVT_SCREENSAVER
Enables the builtin screensaver feature.
.br
Default: on
.It Em PCVT_PRETTYSCRNS
If enabled, a blinking-star screensaver is used. If disabled, the screen
is simply blanked
.Pq which might be useful for energy-saving monitors .
.br
Default: on
.It Em PCVT_CTRL_ALT_DEL
If enabled, the key combination
.Aq Em Ctrl
.Aq Em Alt
.Aq Em Del
invokes a CPU reset.
.br
Default: off
.It Em PCVT_USEKBDSEC
Do NOT override a security lock for the keyboard.
.br
Default: on
.It Em PCVT_24LINESDEF
If enabled, the 25-line modi
.Po
VT emulation with 25 lines, and HP emulation with 28 lines
.Pc
default to 24 lines only to provide a better compatibility to the
original DEV VT220 (TM). Thus it should be possible to use the
terminal information for those terminals without further changes.
Note that this is a startup option; it is possible to toggle between
the 24- and 25-lines' display by the
.Xr scon 1
utility.
.br
Default: off
.It Em PCVT_EMU_MOUSE
Emulate a three-button mouse via the keypad. Useful for notebooks when
running XFree86. See
.Sx Mouse emulation
below.
.br
Default: off
.It Em PCVT_META_ESC
If enabled, a sequence composed of
.Aq Em esc ,
followed by the normal key code is emitted if a key is pressed with the
.Aq Em Alt
key modifier. If disabled, then normal key code with the value
.Em 0x80
added is sent.
.br
Default: off
.El
Note that there are further options available which are mainly used for
debugging purposes or as a workaround for hardware problems. They are
found in
.Pa i386/isa/pcvt/pcvt_hdr.h
along with their documentation.
.Ss Internal Functions
The functionality described below may be accessed via
.Xr ioctl 2
system calls with a file descriptor opened on a device node
related to the
.Nm pcvt
driver.
To make use of them, a program should contain the following line:
.Dl #include <machine/pcvt_ioctl.h>
Any parameter definitions cited below can be found in that file.
.Em Keyboard related functions
Three functions are related to basic keyboard hardware:
.Bl -tag -width 20n -offset indent -compact
.It KBDRESET
reset keyboard, set defaults;
.It KBDGTPMAT
get current typematic value, parameter is a pointer to int where
the values is stored to;
.It KBDSTPMAT
set current typematic value, similar to above command.
.El
Symbolic values are available for the appropriate constants.
To specify the initial typematic delay time, they are
KBD_TPD250 for 250 ms through
KBD_TPD1000 for 1000 ms, in steps of 250 ms. The typematic repeat
rates are
KBD_TPM300, specifying 30.0 characters per second through
KBD_TPM20 for 2.0 characters per second. The intermediate values
are: 30.0, 26.7, 24.0, 21.8, 20.0, 18.5, 17.1, 16.0, 15.0, 13.3,
12.0, 10.9, 10.0, 9.2, 8.6, 8.0, 7.5, 6.7, 6.0, 5.5, 5.0, 4.6, 4.3,
4.0, 3.7, 3.3, 3.0, 2.7, 2.5, 2.3, 2.1, 2.0 characters per second.
.Bl -tag -width 20n -offset indent -compact
.It KBDGREPSW
get key repetition switch, and
.It KBDSREPSW
set key repetition switch
.El
again take a pointer to int as argument. They manipulate the
drivers internal keyboard repetition flag, possible values are:
KBD_REPEATOFF or KBD_REPEATON.
.Bl -tag -width 20n -offset indent -compact
.It KBDGLEDS
get LED state, and
.It KBDSLEDS
set LED state manipulate the keyboard indicators, but do not influence
the drivers idea of lock key state.
.El
The int where the argument points to
may have the values
KBD_SCROLLLOCK, KBD_NUMLOCK, KBD_CAPSLOCK, which may be used in any
conjunction.
.Bl -tag -width 20n -offset indent -compact
.It KBDGLOCK
gets state of SCROLL,NUM,CAPS, and
.It KBDSLOCK
sets state of SCROLL,NUM,CAPS + LEDs
.El
should be used in a same manner to get/set the drivers internal
LED flags.
.Em Keyboard remapping
One important feature of the
.Nm pcvt
driver is its ability to overload the built in key definition.
.Bl -tag -width 20n -offset indent -compact
.It KBDGCKEY
get current key values,
.It KBDSCKEY
set new key assignment values, and
.It KBDGOKEY
get original key assignment values
.El
arrange those functions. The take a pointer to a
.Em struct kbd_ovlkey
as argument as described below. In addition,
.Bl -tag -width 20n -offset indent -compact
.It KBDRMKEY
removes a key assignment, taking a pointer to an int as argument which
contains the affected key number;
.It KBDDEFAULT
removes all key assignments.
.El
.Bd -literal
struct kbd_ovlkey /* complete definition of a key */
{
u_short keynum; /* the key itself */
u_short type; /* type of key, see below */
u_char subu; /* subtype, ignored on write */
char unshift[KBDMAXOVLKEYSIZE+1]; /* emitted string, unshifted */
u_char subs; /* subtype, ignored on write */
char shift[KBDMAXOVLKEYSIZE+1]; /* emitted string, shifted */
u_char subc; /* subtype, ignored on write */
char ctrl[KBDMAXOVLKEYSIZE+1]; /* emitted string, control */
u_char suba; /* subtype, ignored on write */
char altgr[KBDMAXOVLKEYSIZE+1]; /* emitted string, altgr */
};
.Ed
The appropriate values for the
.Em type
field are:
.Bl -tag -width 20n -offset indent -compact
.It KBD_NONE
no function, key is disabled,
.It KBD_SHIFT
keyboard shift,
.It KBD_META
alternate shift, sets bit8 to ASCII code,
.It KBD_NUM
numeric shift, keypad numeric / application mode,
.It KBD_CTL
control code generation,
.It KBD_CAPS
caps shift - swaps case of letter,
.It KBD_ASCII
ASCII code generating key,
.It KBD_SCROLL
stop output,
.It KBD_FUNC
function key,
.It KBD_KP
keypad keys,
.It KBD_BREAK
ignored,
.It KBD_ALTGR
AltGr translation feature,
.It KBD_SHFTLOCK
shift lock,
.It KBD_CURSOR
cursor keys, and
.It KBD_RETURN
.Dq Return
or
.Dq Enter
keys.
.El
The
.Em subtype
field contains one of the values
.Bl -tag -width 20n -offset indent -compact
.It KBD_SUBT_STR
key is bound to a string, or
.It KBD_SUBT_FNC
key is bound to a function.
.El
.Em Mouse emulation
The mouse emulator
.Pq if configured in
fakes a three-button mouse using the Mouse Systems protocol. The first
.Nm pcvt
device node not used by a virtual screen is the mouse device. I.\& e.,
for the default value of 8 virtual screens,
.Pa /dev/ttyv0
through
.Pa /dev/ttyv7
would refer to the virtual screens, and
.Pa /dev/ttyv8
were the mouse emulator device. The mouse emulation is turned on by
pressing the
.Aq Em NumLock
key. The pointer is moved by the numerical keypad keys, into the
obvious directions. The pointer is initially moved in single steps,
and is accelerated after an adjustable time
.Pq default: 500 ms
by about 6 times. The mouse buttons are emulated by three normal
keys, by default the function keys
.Aq Em \&F1 ,
.Aq Em \&F2 ,
and
.Aq Em \&F3 .
There are two selectable flavors available: normal and
.Dq sticky
buttons. Normal buttons behave as expected.
.Dq Sticky
buttons are notified as button-press on the first keypress. They
.Dq stick
until the key is pressed again
.Pq or another button-emulating key instead .
Button presses and releases are notified to the user by a simple
.Dq pling ,
or
.Dq plong ,
respectively, generated from the PC's built-in speaker.
The following commands control the emulation.
.Bl -tag -width 20n -offset indent -compact
.It KBDMOUSEGET
get the current definitions, and
.It KBDMOUSESET
set new definitions.
.El
Both accept a
.Li struct mousedefs *
as the third argument to the ioctl call:
.Bd -literal
struct mousedefs {
int leftbutton; /* (PC) scan code for "left button" key */
int middlebutton; /* (PC) scan code for "mid button" key */
int rightbutton; /* (PC) scan code for "right button" key */
int stickybuttons; /* if true, the buttons are "sticky" */
int acceltime; /* timeout in microseconds to start pointer */
/* movement acceleration */
/* defaults to: scan(F1), scan(F2), scan(F3), false, 500000 */
};
.Ed
.Em Downloadable character set interface
EGA and VGA video adaptors provide the capability of downloadable
software fonts. Since the
.Sq native character set
of any IBM-compatible PC video board does not allow the full interpretation
of DEC multinational character set or ISO Latin-1
.Pq ISO 8859-1 ,
this might be very useful for a U**X environment.
.Bl -tag -width 20n -offset indent -compact
.It VGASETFONTATTR
set font attr, and
.It VGAGETFONTATTR
get font attr
.El
are used to manipulate the drivers information about a downloaded
font. The take a pointer to a
.Em struct vgafontattr
as argument:
.Bd -literal
struct vgafontattr {
int character_set; /* VGA character set */
int font_loaded; /* Mark font loaded or unloaded */
int screen_size; /* Character rows per screen */
int character_scanlines; /* Scanlines per character - 1 */
int screen_scanlines; /* Scanlines per screen - 1 byte */
};
.Ed
Each character of each font is to be downloaded with
.Bl -tag -width 20n -offset indent -compact
.It VGALOADCHAR
load vga char,
.El
taking a pointer to
.Em struct vgaloadchar
as its argument:
.Bd -literal
struct vgaloadchar {
int character_set; /* VGA character set to load into */
int character; /* Character to load */
int character_scanlines; /* Scanlines per character */
u_char char_table[32]; /* VGA character shape table */
};
.Ed
The field
.Em character_set
takes the values
CH_SET0, CH_SET1, CH_SET2, CH_SET3 on EGA's or VGA's. Since VGA's
might have up to eight simultaneously loaded fonts, they can take
CH_SET4, CH_SET5, CH_SET6, or CH_SET7, too.
Note that there's a dependence between the font size
and a possible screen height
.Pq in character rows ,
depending on the video adaptor used:
.Bd -literal
Screen size (rows) on: EGA VGA
Font size
8 x 8 43 50
8 x 10 35 40
8 x 14 25 28
8 x 16 not 25
applicable
.Ed
.Em General screen manipulation commands
.Bl -tag -width 20n -offset indent -compact
.It VGACURSOR
sets cursor shape,
.El
taking a pointer to the following structure as argument:
.Bd -literal
struct cursorshape {
int screen_no; /* screen number for which to set, */
/* or -1 to set on current active screen */
int start; /* top scanline, range 0... Character Height - 1 */
int end; /* end scanline, range 0... Character Height - 1 */
};
.Ed
.Bl -tag -width 20n -offset indent -compact
.It VGASETSCREEN
set screen info, and
.It VGAGETSCREEN
get screen info,
.El
provide an interface to some general driver internal variables
which might modify the behaviour of the screens,
or which might simply be used to force the driver to switch
to one certain screen. Their argument is a pointer to the structure:
.Bd -literal
struct screeninfo {
int adaptor_type; /* type of video adaptor installed */
/* read only, ignored on write (yet!) */
int totalfonts; /* no of downloadable fonts */
/* read only, ignored on write */
int totalscreens; /* no of virtual screens */
/* read only, ignored on write */
int screen_no; /* screen number, this was got from */
/* on write, if -1, apply pure_vt_mode */
/* and/or screen_size to current screen*/
/* else to screen_no supplied */
int current_screen; /* screen number, which is displayed. */
/* on write, if -1, make this screen */
/* the current screen, else set current*/
/* displayed screen to parameter */
int pure_vt_mode; /* flag, pure VT mode or HP/VT mode */
/* on write, if -1, no change */
int screen_size; /* screen size */
/* on write, if -1, no change */
int force_24lines; /* force 24 lines if 25 lines VT mode */
/* or 28 lines HP mode to get pure */
/* VT220 screen size */
/* on write, if -1, no change */
int vga_family; /* if adaptor_type = VGA, this reflects*/
/* the chipset family after a read */
/* nothing happenes on write ... */
int vga_type; /* if adaptor_type = VGA, this reflects*/
/* the chipset after a read */
/* nothing happenes on write ... */
int vga_132; /* set to 1 if driver has support for */
/* 132 column operation for chipset */
/* currently ignored on write */
};
.Ed
Its field
.Em pure_vt_mode
may take the values M_HPVT for a mixed VTxxx and HP Mode, with function
key labels and a status line, or M_PUREVT for only VTxxx sequences
recognized, with no labels.
.Bl -tag -width 20n -offset indent -compact
.It VGASETCOLMS
sets the number of columns for the current screen,
.El
its parameter is a pointer to an integer containing either a value of 80,
or a value of 132. Note that setting the number of columns to 132 is
only supported on VGA adaptors. Any unsupported numbers cause the ioctl
to fail with
.Em errno
.Pq see Xr intro 2
being set to
.Em EINVAL .
.Em VGA color palette interface
Only on VGA adaptors, there's a color palette register at the output.
It is responsible for the red, green and blue output voltage provided
for each of the 256 internal color codes, each lying in the range of
0 through 63 (with 63 representing the brightest value for a base color).
Thus, these adaptors map each color code to a color of a
.Dq palette
out of 262144 colors. The commands
.Bl -tag -width 20n -offset indent -compact
.It VGAREADPEL
read VGA palette entry, and
.It VGAWRITEPEL
write VGA palette entry
.El
establish an interface to these palette registers. Their argument is
a pointer to:
.Bd -literal
struct vgapel {
unsigned idx; /* index into palette, 0 .. 255 valid */
unsigned r, g, b; /* RGB values, masked by VGA_PMASK (63) */
};
.Ed
.Em Driver identification
.Bl -tag -width 20n -offset indent -compact
.It VGAPCVTID
returns information if the current compiled in driver is pcvt and it's
major and minor revision numbers. the call is taking a pointer to the
following structure as argument:
.El
.Bd -literal
struct pcvtid {
#define PCVTIDNAMELN 16 /* driver id - string length */
char name[PCVTIDNAMELN]; /* driver name, == PCVTIDSTR */
#define PCVTIDNAME "pcvt" /* driver id - string */
int rmajor; /* revision number, major */
#define PCVTIDMAJOR 3
int rminor; /* revision number, minor */
#define PCVTIDMINOR 00
};
.Ed
.Bl -tag -width 20n -offset indent -compact
.It VGAPCVTINFO
returns information if the current compiled in driver is pcvt and it's
compile time options. the call is taking a pointer to the following
structure as argument:
.El
.Bd -literal
struct pcvtinfo {
u_int opsys; /* PCVT_xxx(x)BSD */
#define CONF_UNKNOWNOPSYS 0
#define CONF_386BSD 1 /* unsupported !!! */
#define CONF_NETBSD 2
#define CONF_FREEBSD 3
u_int opsysrel; /* Release for NetBSD/FreeBSD */
u_int nscreens; /* PCVT_NSCREENS */
u_int scanset; /* PCVT_SCANSET */
u_int sysbeepf; /* PCVT_SYSBEEPF */
/* config booleans */
u_long compile_opts; /* PCVT_xxxxxxxxxxxxxxx */
};
.Ed
.Em Screen saver
Depending on the configuration of a
.Nm pcvt
driver, their might be a simple screen saver available. It is controlled
by the command
.Bl -tag -width 20n -offset indent -compact
.It VGASCREENSAVER
set timeout for screen saver in seconds; 0 turns it off,
.El
taking a pointer to an integer as argument. Despite of its command name,
this is available on
.Em any
kind of adaptor if configured in by the
.Xr config 8
option
.Dq PCVT_SCREENSAVER
.Em Compatibility commands for USL-style VT's
Release 3.00 of this
.Nm pcvt
driver supports a subset of the USL-style commands used to control
the virtual terminal interface. This feature is mainly intended to
allow
.Em XFree86 ,
release 2.0 or higher, to switch between virtual screens even when
running an X server. They are ugly with respect to the implied semantics
.Pq i.\& e., they break Berkeley semantics
and are therefore not recommended for common use. See the file
.Pa i386/include/pcvt_ioctl.h
for their documentation.
.Sh FILES
.Bl -tag -width /usr/include/machine/pcvt_ioctl.h
.It Pa /usr/include/machine/pcvt_ioctl.h
Definitions for
.Xr ioctl 2
function calls
.It Pa /dev/ttyv?
.It Pa /dev/console
Device nodes to access the
.Nm pcvt
driver
.It Pa i386/isa/pcvt/pcvt_hdr.h
.Pq relative to the kernel source tree
Documents the various compile-time options to tailor
.Nm pcvt .
.Sh HISTORY
The
.Nm pcvt
driver has been developed for and contributed to 386BSD release 0.1. Since
release 3.00 explicit support is provided for NetBSD 0.9. It is expected
that no further development on pcvt is done for 386BSD 0.1 after release 3.00,
in fact, 386BSD support was dropped with release 3.20.
.Sh AUTHORS
.Bl -tag -width 30n -offset indent
.It Written by :
Hellmuth Michaelis
.Pq hm@hcshh.hcs.de
.It With much help from :
Brian Dunford-Shore
.Pq brian@morpheus.wustl.edu
.br
.if n Joerg Wunsch
.if t J\(:org Wunsch
.Pq joerg_wunsch@uriah.sax.de
.br
.It This driver is based on several people's previous
.It work, notably by :
William Jolitz' and Don Ahn's
.Xr pc 4
implementation
.Pq ljolitz@cardio.ucsf.edu
.br
Holger Veit
.Pq veit@du9ds3.uni-duisburg.de, now veit@first.gmd.de
.Sh SEE ALSO
.Xr pc 4 ,
.Xr config 8 ,
.Xr intro 2 ,
.Xr ioctl 2 .
.Sh BUGS
Certainly existent. See the file
.Pa BugList
in the Documentation directory for an up-to-date list.
.Ss Tested Video Boards
.Bd -literal
Manufacturer Chipset Monitor
2theMax (?) ET4000 VGA Color
Video7 Inc. Video 7 VGA Color
Diamond Stealth VRAM S3 NEC 3FGx
Trident TVGA 8800CS NEC 3D
Data General C&T P82C604 VGA Color
NoName Hercules W86855AF Mono
Kyocera (Mainboard) WD90C11 Sony Color
unknown ET3000 NEC 3D
.Ed
.Ss Tested Keyboards
.Bd -literal
Manufacturer Type Layout
Cherry MF II US
Cherry/Tandon MF II German
Hewlett-Packard MF II US
Hewlett-Packard MF II German
Tatung AT German
.Ed
There is absolutely NO support for the ancient PC-keyboards
.Pq they had 83 keys .
There is only limited support for AT-keyboards
.Bo
they have 84 keys, and a separate numeric keypad,
they don't have F11/F12 keys
.Bc
because the emulator needs F9 through F12 for control functions, and due to
the current design of the keyboard driver there is no
.Pq full
support for national keyboards because
of the lack of an ALtGr key.
MF-keyboards are fully supported, 101- and 102-key versions.

2
sys/arch/i386/isa/pcvt/Util/scon/Makefile
View File

@ -1,3 +1,5 @@
PROG= scon
NOMAN= yes
.include <bsd.prog.mk>

214
sys/arch/i386/isa/pcvt/Util/scon/scon.1
View File

@ -1,214 +0,0 @@
.\" Copyright (c) 1992, 1995 Hellmuth Michaelis and Joerg Wunsch
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by
.\" Hellmuth Michaelis and Joerg Wunsch
.\" 4. The name authors may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``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 AUTHORS 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.
.\"
.\" @(#)scon.1, 3.30, Last Edit-Date: [Mon Jul 3 11:25:13 1995]
.\"
.Dd December 31, 1993
.Dt SCON 1
.Sh NAME
.Nm scon
.Nd controls screen modes for pcvt video driver
.Sh SYNOPSIS
.Nm scon
.Op Fl a
.Op Fl c Ar screenno
.Op Fl d Ar device
.Op Fl f Ar on|off
.Op Fl h
.Op Fl H
.Op Fl l
.Op Fl m
.Op Fl v
.Op Fl V
.Op Fl s Ar lines
.br
.Nm scon
.Op Fl v
.Op Fl d Ar device
.Fl p Ar entry,red,green,blue
.br
.Nm scon
.Op Fl v
.Op Fl d Ar device
.Fl p Ar default
.br
.Nm scon
.Op Fl v
.Op Fl d Ar device
.Fl p Ar list
.Nm scon
.Op Fl v
.Fl t Ar timeout
.Nm scon
.Op Fl v
.Fl 1 | Fl 8
.Sh DESCRIPTION
The
.Nm scon
utility controls several aspects of the runtime behaviour of the pcvt vt220
driver.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl a
Returns a string describing the video adaptor found by pcvt, the string
returned could be MDA, HGC, CGA, EGA, VGA or UNKNOWN.
.It Fl c
Specify the screen number the current (displayed) screen should be switched
to.
.It Fl d
Specify the device filename (i.e. /dev/ttyv2) further operations specified on
the command line should be applied to.
.It Fl f
Some programs which silently assume 24 lines when they run on a VT220 show
incorrect behaviour when the terminal has really 25 lines. To support full
VT220 behaviour, it is possible to force pcvt to select only 24 lines when
it is running in 25-lines pure VT mode and/or in 28-lines HP-mode. The
.Fl f
option requires one additional parameter, the string 'on' or 'off' to switch
this mode for a virtual screen on or off respectively. This mode has no effect
if any other vertical resolutions are selected than the two above mentioned.
.It Fl h
Prints a usage/help text.
.It Fl l
Lists the current configuration of runtime changeable options and fixed
parameters (such as the type of the adaptor, and in case of a VGA adaptor,
the Manufacturer, Chipset and 132 column support) of the output portion
of the pcvt driver.
.It Fl m
Returns a string describing the connected display monitor type found by pcvt,
the string returned can be MONO, COLOR or UNKNOWN.
.It Fl v
Specify verbose operation of the program.
.It Fl V
Switch the specified/current screen into a pure VT220 mode without recognizing
any HP escape sequences and without displaying function key labels.
.It Fl H
Switch the specified/current screen into a mixed HP/VT220 mode. That is, that
in addition to the full VT220 emulation, the HP function key labels and the
escape sequences for handling the labels are available to the user.
.It Fl s
Specify the number of character lines on the screen. Possible parameters are
25, 28, 35, 40, 43 or 50. To use all this screen sizes, the fonts required
for proper operation of a desired size have to be downloaded to the EGA/VGA
font ram. This option is available only for EGA and VGA boards.
.It Fl p
Modify VGA palette
.Pq DAC .
The
.Fl p
is mutually exclusive with
.Fl s ,
.Fl H ,
and
.Fl V .
Naturally, option
.Fl p
is available only for VGA boards. Three flavors are available.
If used with argument
.Dq Ar default ,
this flag will restore the default palette
.Po
as installed by VGA ROM BIOS after hardware reset
.Pc .
If used with argument
.Dq Ar list ,
the current VGA DAC palette entries are listed. Each entry contains
the table index, values for red, green, and blue, and if there's a
known name for this entry, the color name. Trailing empty table
slots (RGB values all zero) are omitted.
Otherwise, four comma-separated arguments are expected. The first
denotes the number of palette entry to be modified. This may be either
a number between 0 and 255, or the usual name of an associated color
.Pq case-insensitive .
The following values for red, green and blue are restricted to 0 through 63
due to VGA DAC conventions.
Note that the first delimiter within such an argument may be a colon
.Dq \&:
instead of a comma
.Dq \&,
for better readability, but this violates common command argument
conventions.
Multiple
.Fl p
options may be specified if unambiguous.
.It Fl t
Specifying
.Fl t
will activate the screen saver. The behaviour depends on
.Ar timeout :
if
.Ar timeout
is given as 0, the screen saver is turned off. Otherwise,
.Ar timeout
is taken as a number of seconds to wait until activating the
screen saver.
NOTE: the
.Fl t
option is only available if screen saver support has been compiled into
the driver !
.It Fl 1
Sets 132 columns mode
.Pq only available on VGA adaptors .
.It Fl 8
Sets 80 columns mode.
.El
.Pp
When switching between HP and VT mode, when switching the force 24 lines
mode on and off, or when switching between 80 and 132 columns operation,
the screen is cleared, the scrolling
region is reset and the cursor is placed in the home position.
.Sh EXAMPLES
The command
.Dq Li scon Fl H s Ar 28
places the current screen into HP mode and sets the screen size to 28x80.
Invoking
.Do
.Li scon Fl p
.Ar lightgray,0,15,0
.Fl p
.Ar 0:45,45,45
.Dc
will result in green on gray output for normal text.
Note that normal text color is light gray, and not white as one might expect.
.Sh BUGS
the
.Fl c
and
.Fl d
options collide somehow, this will change in a future release.
.Sh SEE ALSO
.Xr loadfont 1 ,
.Xr cursor 1 ,
.Xr pcvt 4

2
sys/arch/i386/isa/pcvt/Util/userkeys/Makefile
View File

@ -1,3 +1,5 @@
PROG= vt220keys
NOMAN= yes
.include <bsd.prog.mk>

131
sys/arch/i386/isa/pcvt/Util/userkeys/vt220keys.1
View File

@ -1,131 +0,0 @@
.TH VT220 1
.UC 4
.SH NAME
vt220 \- define SHIFTED function keys on VT220 terminal
.SH SYNTAX
.B vt220
[
.B \-cil
]
[ keyname keystring ] ...
.SH DESCRIPTION
.I Vt220
sets up a "vt220 terminal" in vt200 mode to allow user
definition of the SHIFTED function keys. Each
\f2keyname\f1 specified on the command line will be loaded with
the corresponding \f2keystring\f1.
A \f2keyname\f1 is one of the following "words":
F6 F7 F8 F9 F10 F11 ESC F12 BS F13 LF F14 HELP DO F17 F18 F19 F20.
\f2Keystrings\f1
must be quoted if spaces, tabs, or shell metacharacters are included.
.PP
.B Vt220
expects to receive some combination of option flags and/or
argument pair(s), otherwised an usage message
is printed.
.PP
The options are:
.TP
.B \-c
Clears all SHIFTED function key definitions before setting them to user
defined strings.
.TP
.B \-i
Read the initialization file
.I $HOME/.vt220rc
for SHIFTED function key definitions. This is done before any
argument pair specified on the command line is processed.
Each line in the file must consist of two fields (separated by spaces
or tabs) where the first field is the
\f2keyname\f1 and the second field is the \f2keystring\f1.
The second field extends to the end of the line, thus a
\f2keystring\f1
may include spaces or tabs. A newline (return) may be specified
within the string by using the C Language notation for newline (\\n).
.TP
.B \-l
Locks the function keys from further definition.
Locking occurs after processing the initialization file (if the "i"
option is specified) and any argument
pairs.
The only way
to unlock is by turning the power off.
.SH EXAMPLES
vt220 -ci
.br
vt220 F6 'nroff -ms '
.br
vt220 -i F20 'cc -O -c '
.br
vt220 -l HELP man
.SH "OTHER FEATURES"
Pressing the function keys without using the shift key, generates
a string of characters. With
\f2csh\f1(1) this string can be aliased to some command. For example:
.br
alias ^[[17~ "ls -CR | more"
.br
where ^[[17~ is what is generated by pressing the F6 key. Therefore
F6 can perform two commands, depending if pressed with/without the SHIFT
key.
.PP
.B Vt220
can be called from your .login or .profile file. Typically an user
will create a initialization file and include a line like
.br
vt220 -ci
.br
OR
.br
vt220 -cil
.br
in the above mentioned files. This way the SHIFTED function keys
will be set to your favorite commands when logging in.
.SH CAVEATS
If the SHIFTED function keys are unlocked, redefinition of a SHIFTED
function key will rewrite the old string.
.PP
There are 256 bytes available for the SHIFTED function keys. Space is
supplied on a first-come/first-serve basis. After the 256 bytes are
used, you can't define any more keys unless space is cleared. This
can be done by redefining a key to contain a string of fewer bytes.
.PP
All key definitions are stored in volatile RAM, and are lost when
terminal power is lost.
.PP
The ESC key (unshifted) no longer generates the proper escape character. This
is of particular importance since many editors require use of the
ESC key. Here are some available alternatives:
.sp
.in +.5i
The escape character can be generated by typing ^[ (control-[).
.sp
Use
.B vt220
as follows (note ^[ is control-[)
.br
.in +.5i
vt220 ESC '^['
.in
.br
This will require you
to press the SHIFT key and ESC to generate the escape sequence.
.sp
Some editors, allow other character(s) to be substituted for the
escape character. For example with
.B emacs
include this line in your .emacs_pro:
.br
(bind-to-key "ESC-prefix" "\\033[23~")
.br
Thus when the ESC key is pressed, emacs will allow the characters
generated (^[[23~) to perform the same function as the escape
character.
.in
.SH FILES
$HOME/.vt220rc \- initialization file
.SH "SEE ALSO"
VT220 Programmer Reference Manual
.br
VT220 Programmer Pocket Guide

2
sys/arch/i386/isa/pcvt/Util/vgaio/Makefile
View File

@ -16,4 +16,6 @@ CFLAGS+= -I. -g
CLEANFILES+= y.tab.h
CLEANFILES+= y.output # comment file from bison
NOMAN= yes
.include <bsd.prog.mk>

156
sys/arch/i386/isa/pcvt/Util/vgaio/vgaio.8
View File

@ -1,156 +0,0 @@
.\"
.\" Copyright (c) 1994,1995 Joerg Wunsch
.\"
.\" All rights reserved.
.\"
.\" This program is free software.
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Joerg Wunsch
.\" 4. The name of the developer may not be used to endorse or promote
.\" products derived from this software without specific prior written
.\" permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``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 DEVELOPERS 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.
.\"
.\" $Header: /cvsroot/src/sys/arch/i386/isa/pcvt/Util/vgaio/Attic/vgaio.8,v 1.3 1995/10/07 21:46:01 jtc Exp $
.\"
.Dd December 31, 1994
.Dt VGAIO 8
.Sh NAME
.Nm vgaio
.Nd perform input/output on a Video Graphics Array
.Sh SYNOPSIS
.Nm vgaio
.Op Fl d
.Op Fl f Ar devname
.Sh DESCRIPTION
.Ss Purpose
.Nm Vgaio
is used to perform register-level input/output on a Video Graphics Array.
Since some of the sequences required to access those registers are very
silly,
.Nm vgaio
cares of all the things necessary and allows the user to access the
registers of several register groups with their symbolic names.
.Ss Options
.Bl -tag -width 10n -offset indent -compact
.It Fl d
Turn on the grammar parser debugger.
.It Fl f Ar devname
Operate on device
.Ar devname
instead of the default
.Pa /dev/console .
.El
.Ss Command language
The command language of
.Nm
constitutes of some very simple tokens and rules. Commands are executed
line by line as they are entered. Each line may contain any number of
semicolon-separated input/output commands.
Symbolic register names look like:
.D1 Ao Em reggroup Ac Ao Em regnumber Ac
with
.Aq Em regnumber
being any hexadecimal number
.Pq without a leading Em 0x ,
and
.Aq Em reggroup
one of the strings
.Dq Em ar ,
.Dq Em cr ,
.Dq Em gr ,
.Dq Em mi ,
or
.Dq Em sr ,
standing for the
.Em Attribute controller ,
.Em CRT controller ,
.Em Graphics controller ,
.Em Miscellaneous Output Register ,
or
.Em Timing sequencer ,
respectively.
An input instruction has the form
.D1 Ao Em regname Ac ?
and will cause
.Nm
to output a line like
.Bd -ragged -offset indent
.Ao Em regname Ac \& = 0x Ns
.Aq Em number
.Ed
An output instruction looks like
.Bd -ragged -offset indent
.Ao Em regname Ac =
.Aq Em number
.Ed
Spaces or Tabs between the
.Aq Em reggroup ,
the
.Aq Em regnumber ,
or any of the other tokens are ignored. They are not required anyway.
The
.Dq Em mi
register does not require an argument
.Aq Em regnumber ;
it's actually being ignored.
.Ss Access control
The caller must have uid 0 in order to gain the required access to
the IO registers.
.Sh FILES
.Pa /dev/console
is used as the default device to enable access to the IO registers.
.Sh HISTORY
This program is considered
.Dq hackware .
It has been developed in order to simplify the process of developing other
software that needs to program the Video Graphics Array.
Remember, to use this program, your kernel has to be compiled with XSERVER
being defined.
.Sh AUTHOR
The program has been contributed by
.if n Joerg Wunsch,
.if t J\(:org Wunsch,
Dresden
.Aq joerg_wunsch@uriah.heep.sax.de .

2
sys/arch/i386/isa/pcvt/Util/vttest/Makefile
View File

@ -2,4 +2,6 @@ PROG= vttest
CFLAGS+= -traditional -DUSEMYSTTY
SRCS= main.c esc.c
NOMAN= yes
.include <bsd.prog.mk>

13
sys/arch/i386/isa/pcvt/Util/vttest/vttest.1
View File

@ -1,13 +0,0 @@
.TH VTTEST 1 "LOCAL"
.SH NAME
vttest \- test VT100-type terminal
.SH SYNOPSIS
.B vttest
.SH DESCRIPTION
.I Vttest
is a program designed to test the functionality of a VT100 terminal
(or emulator thereof).
It tests both display (escape sequence handling) and keyboard.
.PP
The program is menu\-driven and contains full on\-line operating
instructions.