1.\" $NetBSD: wskbd.4,v 1.9 2002/09/18 11:56:29 uebayasi Exp $ 2.Dd March 20, 1999 3.Os 4.Dt WSKBD 4 5.Sh NAME 6.Nm wskbd 7.Nd generic keyboard support in wscons 8.Sh SYNOPSIS 9.Cd "wskbd* at pckbd? console ? mux 1" 10(standard PC keyboard) 11.Cd "wskbd* at ukbd? console ? mux 1" 12(USB keyboard) 13.Cd "wskbd* at lkkbd? console ? mux 1" 14(DEC LK200/400 serial keyboard) 15.Cd "wskbd0 at akbd? console ? mux 1" 16(Apple ADB keyboard) 17.Cd "wskbd0 at nextkbd? console ? mux 1" 18(NeXT keyboard) 19.Cd "wskbd* at vrkiu? console ? mux 1" 20(NEC VR4000 series HPC keyboard) 21.Cd "wskbd* at skbd? console ? mux 1" 22(keyboard of misc hpcmips handheld devices) 23.Sh DESCRIPTION 24The 25.Nm 26driver handles common tasks for keyboards within the 27.Xr wscons 4 28framework. It is attached to the hardware specific keyboard drivers and 29provides their connection to 30.Dq wsdisplay 31devices and a character device interface. 32.Pp 33The common keyboard support consists of: 34.Bl -bullet 35.It 36Mapping from keycodes (defined by the specific keyboard driver) to 37keysyms (hardware independent, defined in 38.Pa /usr/include/dev/wscons/wsksymdef.h ) . 39.It 40Handling of 41.Dq compose 42sequences. Characters commonly not present as separate key on keyboards 43can be generated after either a special 44.Dq compose 45key is pressed or a 46.Dq dead accent 47character is used. 48.It 49Certain translations, like turning an 50.Dq ALT 51modifier into an 52.Dq ESC 53prefix. 54.It 55Automatic key repetition 56.Pq Dq typematic . 57.It 58Parameter handling for 59.Dq keyboard bells . 60.It 61Generation of 62.Dq keyboard events 63for use by X servers. 64.El 65.Pp 66The 67.Nm 68driver provides a number of ioctl functions to control key maps 69and other parameters. These functions are accessible though the 70associated 71.Dq wsdisplay 72device as well. A complete list is in 73.Pa /usr/include/dev/wscons/wsconsio.h . 74The 75.Xr wsconsctl 8 76utility allows to access key maps and other variables. 77.Pp 78The 79.Em console 80locator in the configuration line refers to the device's use as input 81part of the operating system console. A device specification containing 82a positive value here will only match if the device is in use as system 83console. (The console device selection in early system startup is not 84influenced.) This way, the console device can be connected to a known 85wskbd device instance. 86.Sh FILES 87.Bl -item 88.It 89.Pa /dev/wskbd* 90.It 91.Pa /usr/include/dev/wscons/wsksymdef.h 92.It 93.Pa /usr/include/dev/wscons/wsconsio.h . 94.El 95.Sh SEE ALSO 96.Xr pckbd 4 , 97.Xr ukbd 4 , 98.Xr wscons 4 , 99.Xr wsmux 4 , 100.Xr wsconsctl 8 , 101.Xr wskbd 9 102