PCKBD(4)                  OpenBSD Programmer's Manual                 PCKBD(4)

NAME
     pckbd - PC keyboard driver for wscons

SYNOPSIS
     pckbc* at isa?
     pckbd* at pckbc?
     wskbd* at pckbd? console ?
     option PCKBD_LAYOUT=XXX

DESCRIPTION
     This driver supports PC/AT keyboards within the wscons(4) console frame-
     work.  It doesn't provide direct device driver entry points but makes its
     functions available via the internal wskbd(4) interface.

     The pckbd driver supports a number of different key mappings which can be
     chosen from with the kernel option ``PCKBD_LAYOUT'' at compile time or
     with the utility wsconsctl(8) (variable: ``keyboard.encoding'' ) at run-
     time.  Other mappings can be used if the whole keymap is replaced by
     means of wsconsctl(8). The built-in mappings are at this time:

     KB_DE   ( ``de'' ) German with ``dead accents''.

     KB_DK   ( ``dk'' ) Danish with ``dead accents''.

     KB_FR   ( ``fr'' ) French.

     KB_IT   ( ``it'' ) Italian.

     KB_JP   ( ``jp'' ) Japanese.

     KB_RU   ( ``ru'' ) Russian in ``KOI8''.

     KB_SF   ( ``sf'' ) Swiss French with ``dead accents''.

     KB_SG   ( ``sg'' ) Swiss German with ``dead accents''.

     KB_SV   ( ``sv'' ) Swedish with ``dead accents''.

     KB_PT   ( ``pt'' ) Portuguese with ``dead accents''.

     KB_UA   ( ``ua'' ) Ukrainian in ``KOI8''.

     KB_UK   ( ``uk'' ) British.

     KB_US   (for wsconsctl: ``us'' ) English / US keyboard mapping (default).

     KB_US | KB_DECLK ( ``us.declk'' ) English / US mapping for DEC
             LK400-style keyboards with PC keyboard interface (eg LK461).

     KB_US | KB_DVORAK ( ``us.dvorak'' ) English / US keyboard with ``Dvorak''
             layout.

     The KB_DE, KB_DK and KB_SV mappings can be used in the KB_NODEAD (
     ``.nodead'' ) variant.  This switches off the ``dead accents''.

     The KB_US, KB_JP and KB_US | KB_DVORAK mappings can be modified to swap
     the left CNTL and the CAPS LOCK keys by the KB_SWAPCTRLCAPS variant bit
     or the ``.swapctrlcaps'' suffix.

     The KB_METAESC ( ``.metaesc'' ) option can be applied to any layout.  If
     set, keys pressed together with the ALT modifier are prefixed by an ESC
     character.  (Standard behaviour is to add 128 to the ASCII value.)

     Because PC keyboard hardware doesn't contain a beeper, requests for
     ``keyboard beeps'' cannot be handled directly.  On alpha and i386 a
     helper device attached to the pcppi(4) driver allows to use the standard
     ISA speaker for this purpose.

EXAMPLES
     To set a german keyboard layout without ``dead accents'' and sending an
     ESC character before the key symbol if the ALT key is pressed simultane-
     ously, use wsconsctl -w keyboard.encoding=de.nodead.metaesc. To set it at
     kernel build time, add option PCKBD_LAYOUT="(KB_DE|KB_NODEAD|KB_METAESC)"
     to the kernel configuration file.

SEE ALSO
     isa(4), pckbc(4), pcppi(4), wskbd(4), wsconsctl(8)

BUGS
     The list of built-in mappings doesn't follow any logics.  It grew as peo-
     ple submitted what they needed.

OpenBSD 3.0                     March 20, 1999                               2
