414a35e60a
track.
The Id line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;
.\" $Id$
.\"
If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.
Approved by: bde
191 lines
4.8 KiB
Groff
191 lines
4.8 KiB
Groff
.\"
|
||
.\" kbdcontrol - a utility for manipulating the syscons keyboard driver section
|
||
.\"
|
||
.\" 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.
|
||
.\"
|
||
.\" @(#)kbdcontrol.1
|
||
.\" $Id$
|
||
.\"
|
||
.Dd June 30, 1999
|
||
.Dt KBDCONTROL 1
|
||
.Os FreeBSD
|
||
.Sh NAME
|
||
.Nm kbdcontrol
|
||
.Nd a utility for manipulating the syscons console driver
|
||
.Sh SYNOPSIS
|
||
.Nm
|
||
.Op Fl dFx
|
||
.Op Fl b Ar duration.pitch | Ar belltype
|
||
.Op Fl r Ar delay.repeat | Ar speed
|
||
.Op Fl l Ar keymap_file
|
||
.Op Fl f Ar # Ar string
|
||
.Op Fl h Ar size
|
||
.Op Fl L Ar keymap_file
|
||
.Sh DESCRIPTION
|
||
The
|
||
.Nm
|
||
command is used to set various keyboard related options for the
|
||
.Xr syscons 4
|
||
console driver and the keyboard drivers,
|
||
such as key map, keyboard repeat and delay rates, bell
|
||
characteristics etc.
|
||
.Pp
|
||
Keyboard options may be automatically configured at system boot time by
|
||
setting variables in
|
||
.Pa /etc/rc.conf .
|
||
See
|
||
.Sx Boot Time Configuration
|
||
below.
|
||
.Pp
|
||
The following command line options are supported:
|
||
.Bl -tag -width indent
|
||
.It Fl b Ar duration.pitch | Ar belltype
|
||
Set the bell duration in milliseconds and pitch in hertz.
|
||
If a
|
||
.Ar belltype
|
||
argument is specified, it may be one of
|
||
.Cm normal
|
||
which set sound parameters back to normal values, or
|
||
.Cm visual
|
||
which set the bell to visual mode, i.e. flashes the screen instead.
|
||
If
|
||
.Ar belltype
|
||
is preceded by the word
|
||
.Cm quiet. ,
|
||
the bell will not be rung when the ringing process is in the background vty.
|
||
.It Fl r Ar delay.repeat | Ar speed
|
||
Set keyboard
|
||
.Ar delay (250, 500, 750, 1000)
|
||
and
|
||
.Ar repeat (34, 38, 42, 46, 50, 55, 59, 63, 68, 76, 84, 92, 100, 110, 118, 126,
|
||
136, 152, 168, 184, 200, 220, 236, 252, 272, 304, 336, 368, 400, 440,
|
||
472, 504)
|
||
rates, or if a
|
||
.Ar speed
|
||
argument is specified, it may be one of
|
||
.Cm slow
|
||
(1000.504),
|
||
.Cm fast
|
||
(250.34)
|
||
or
|
||
.Cm normal
|
||
(500.126).
|
||
.It Fl l Ar keymap_file
|
||
Install keyboard map file from
|
||
.Ar keymap_file .
|
||
You may load the keyboard map file from a menu-driven command,
|
||
.Xr kbdmap 1 .
|
||
.It Fl d
|
||
Dump the current keyboard map onto stdout.
|
||
The output may be redirected to a file and can be loaded
|
||
back to the kernel later by the
|
||
.Fl l
|
||
option above.
|
||
.It Fl f Ar # Ar string
|
||
.\".BI "\-f\ " #\ string
|
||
Set function key number
|
||
.Ar #
|
||
to send
|
||
.Ar string .
|
||
Refer to the man page for the keyboard driver
|
||
.Pq e.g. Xr atkbd 4
|
||
for available function keys and their numbers.
|
||
.It Fl F
|
||
Set function keys back to the standard definitions.
|
||
.It Fl x
|
||
Use hexadecimal numbers in keyboard map dump.
|
||
.It Fl h Ar size
|
||
Set history buffer size to
|
||
.Ar size
|
||
lines.
|
||
.It Fl L Ar keymap_file
|
||
Load keyboard map file from
|
||
.Ar keymap_file
|
||
and write the
|
||
.Ft "struct keymap"
|
||
compiled from it to stdout.
|
||
This option is primarily intended for programmers and is probably
|
||
of little use under normal circumstances.
|
||
.El
|
||
.Sh KEYBOARD CONFIGURATION
|
||
.Ss Boot Time Configuration
|
||
You may set variables in
|
||
.Pa /etc/rc.conf
|
||
or
|
||
.Pa /etc/rc.conf.local
|
||
in order to configure the keyboard at boot time.
|
||
The following is the list of relevant variables.
|
||
.Pp
|
||
.Bl -tag -width foo_bar_var -compact
|
||
.It Ar keymap
|
||
Specifies a keyboard map file for the
|
||
.Fl l
|
||
option.
|
||
.It Ar keyrate
|
||
Sets the keyboard repeat rate for the
|
||
.Fl r
|
||
option.
|
||
.It Ar keychange
|
||
Lists function key strings for the
|
||
.Fl f
|
||
option.
|
||
.El
|
||
.Pp
|
||
See
|
||
.Xr rc.conf 5
|
||
for details.
|
||
.Ss Driver Configuration
|
||
The keyboard device driver may let you change default configuration
|
||
options, such as the default keyboard map, so that you do not need to set up
|
||
the options at boot time.
|
||
See keyboard driver manuals
|
||
.Pq e.g. Xr atkbd 4 , Xr ukbd 4
|
||
for details.
|
||
.Sh FILES
|
||
.Bl -tag -width /usr/share/syscons/keymaps/foo_bar -compact
|
||
.It Pa /usr/share/syscons/keymaps/*
|
||
keyboard map files.
|
||
.Sh EXAMPLE
|
||
The following command will load the keyboard map file
|
||
.Pa /usr/share/syscons/keymaps/ru.koi8-r.kbd .
|
||
.Pp
|
||
.Dl kbdcontrol -l /usr/share/syscons/keymaps/ru.koi8-r.kbd
|
||
.Pp
|
||
So long as the keyboard map file resides in
|
||
.Pa /usr/share/syscons/keymaps ,
|
||
you may abbreviate the file name as
|
||
.Pa ru.koi8-r .
|
||
.Pp
|
||
.Dl kbdcontrol -l ru.koi8-r
|
||
.Pp
|
||
The following command will make the function key 10 emit "telnet myhost".
|
||
.Pp
|
||
.Dl kbdcontrol -f 10 \&"telnet myhost\&"
|
||
.Pp
|
||
In order to get the visual effect for bell, but prevent the screen
|
||
from flushing if the bell is to ring in the background screen,
|
||
run the following command.
|
||
.Pp
|
||
.Dl kbdcontrol -b quiet.visual
|
||
.Pp
|
||
.Sh BUGS
|
||
Report when found.
|
||
.Sh SEE ALSO
|
||
.Xr kbdmap 1 ,
|
||
.Xr vidcontrol 1 ,
|
||
.Xr atkbd 4 ,
|
||
.Xr keyboard 4 ,
|
||
.Xr screen 4 ,
|
||
.Xr syscons 4 ,
|
||
.Xr ukbd 4 ,
|
||
.Xr rc.conf 5 .
|
||
.Sh AUTHORS
|
||
.An S<EFBFBD>ren Schmidt Aq sos@FreeBSD.org
|