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