1.\" $OpenBSD: pckbd.4,v 1.8 2001/06/23 07:03:58 pjanzen Exp $ 2.\" $NetBSD: pckbd.4,v 1.3 1999/12/21 11:31:07 drochner Exp $ 3.\" 4.Dd March 20, 1999 5.Dt PCKBD 4 6.Os 7.Sh NAME 8.Nm pckbd 9.Nd PC keyboard driver for wscons 10.Sh SYNOPSIS 11.Cd pckbc* at isa? 12.Cd pckbd* at pckbc? 13.Cd wskbd* at pckbd? console ? 14.Cd option PCKBD_LAYOUT=XXX 15.Sh DESCRIPTION 16This driver supports PC/AT keyboards within the 17.Xr wscons 4 18console framework. 19It doesn't provide direct device driver entry points but makes its 20functions available via the internal 21.Xr wskbd 4 22interface. 23.Pp 24The 25.Nm 26driver supports a number of different key mappings which 27can be chosen from with the kernel option 28.Dq PCKBD_LAYOUT 29at compile time or with the utility 30.Xr wsconsctl 8 31(variable: 32.Dq encoding 33) at runtime. 34Other mappings can be used if the whole keymap is replaced by means of 35.Xr wsconsctl 8 . 36The built-in mappings are at this time: 37.Bl -hang 38.It KB_DE 39( 40.Dq de 41) German with 42.Dq dead accents . 43.It KB_DK 44( 45.Dq dk 46) Danish with 47.Dq dead accents . 48.It KB_FR 49( 50.Dq fr 51) French. 52.It KB_IT 53( 54.Dq it 55) Italian. 56.It KB_JP 57( 58.Dq jp 59) Japanese. 60.It KB_RU 61( 62.Dq ru 63) Russian in 64.Dq KOI8 . 65.It KB_SF 66( 67.Dq sf 68) Swiss French with 69.Dq dead accents . 70.It KB_SG 71( 72.Dq sg 73) Swiss German with 74.Dq dead accents . 75.It KB_SV 76( 77.Dq sv 78) Swedish with 79.Dq dead accents . 80.It KB_PT 81( 82.Dq pt 83) Portuguese with 84.Dq dead accents . 85.It KB_UK 86( 87.Dq uk 88) British. 89.It KB_US 90(for wsconsctl: 91.Dq us 92) English / US keyboard mapping (default). 93.It KB_US | KB_DECLK 94( 95.Dq us.declk 96) English / US mapping for 97.Tn DEC 98LK400-style keyboards with PC keyboard interface (eg LK461). 99.It KB_US | KB_DVORAK 100( 101.Dq us.dvorak 102) English / US keyboard with 103.Dq Dvorak 104layout. 105.El 106.Pp 107The KB_DE, KB_DK and KB_SV mappings can be used in the KB_NODEAD ( 108.Dq .nodead 109) variant. 110This switches off the 111.Dq dead accents . 112.Pp 113The KB_US, KB_JP and KB_US | KB_DVORAK mappings can be modified 114to swap the left CNTL and the CAPS LOCK keys by the 115KB_SWAPCTRLCAPS variant bit or the 116.Dq .swapctrlcaps 117suffix. 118.Pp 119The KB_METAESC ( 120.Dq .metaesc 121) option can be applied to any layout. 122If set, keys pressed together 123with the ALT modifier are prefixed by an ESC character. 124(Standard behaviour is to add 128 to the ASCII value.) 125.Pp 126Because PC keyboard hardware doesn't contain a beeper, requests for 127.Dq keyboard beeps 128cannot be handled directly. 129On alpha and i386 a helper device attached to the 130.Xr pcppi 4 131driver allows to use the standard ISA speaker for this purpose. 132.Sh EXAMPLES 133To set a german keyboard layout without 134.Dq dead accents 135and sending an ESC character before the key symbol if the ALT 136key is pressed simultaneously, use 137.Ic wsconsctl -w encoding=de.nodead.metaesc . 138To set it at kernel build time, add 139.Em option PCKBD_LAYOUT="(KB_DE|KB_NODEAD|KB_METAESC)" 140to the kernel configuration file. 141.Sh SEE ALSO 142.Xr isa 4 , 143.Xr pckbc 4 , 144.Xr pcppi 4 , 145.Xr wskbd 4 , 146.Xr wsconsctl 8 147.Sh BUGS 148The list of built-in mappings doesn't follow any logics. 149It grew as people submitted what they needed. 150