NAME
wskbd —
generic keyboard support in
wscons
SYNOPSIS
wskbd* at ...
DESCRIPTION
The wskbd driver handles common tasks for
keyboards within the wscons(4) framework. It is attached to the hardware specific
keyboard drivers and provides their connection to “wsdisplay”
devices and a character device interface.
The common keyboard support consists of:
- Mapping from keycodes (defined by the specific keyboard driver) to keysyms (hardware independent, defined in /usr/include/dev/wscons/wsksymdef.h).
- Handling of “compose” sequences. Characters commonly not present as separate keys on keyboards can be generated after either a special “compose” key is pressed or a “dead accent” character is used.
- Certain translations, like turning an “ALT” modifier into an “ESC” prefix.
- Automatic key repetition (“typematic”).
- Parameter handling for “keyboard bells”.
- Generation of “keyboard events” for use by X servers.
The wskbd driver provides a number of
ioctl functions to control key maps and other parameters. These functions
are accessible through the associated “wsdisplay” device as
well. A complete list is in
/usr/include/dev/wscons/wsconsio.h. The
wsconsctl(8) utility allows access to key maps and other
variables.
The
console locator
in the configuration line refers to the device's use as input part of the
operating system console. A device specification containing a positive value
here will only match if the device is in use as system console. (The console
device selection in early system startup is not influenced.) This way, the
console device can be connected to a known wskbd
device instance.
The wskbd driver traps certain key
sequences intended to perform special functions. The
Ctrl+Alt+Esc sequence will initiate the
ddb(4) kernel
debugger if the “ddb.console”
sysctl(8)
variable is set. When attached to a
wsdisplay(4) device, Ctrl+Alt+Fx switches
virtual terminals and the Shift+PgUp and
Shift+PgDn combinations provide scrollback
functionality if the underlying hardware driver supports it. When audio
devices are supported, keys Mute,
VolumeUp and VolumeDown
tweak mixer settings.
FILES
- /dev/wskbd*
- /usr/include/dev/wscons/wsksymdef.h
- /usr/include/dev/wscons/wsconsio.h
SEE ALSO
akbd(4), comkbd(4), hilkbd(4), intro(4), pckbd(4), ukbd(4), wscons(4), wsmux(4), zskbd(4), wsconsctl(8)