4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 .Dd September 11, 2000
32 .Nd keyboard map file format for kbdcontrol
38 file describes how the keys on a keyboard should behave.
39 These files can be loaded
44 can be used to select one of the default
49 file can be specified in
53 The current keymap may also be printed using
57 can describe a key or an accent.
60 character begins a comment,
61 which extends to the end of the line.
63 The description of a key
64 begins with the scancode for that key.
65 Then the effect of the key
70 are listed in the following order:
78 alt and control and shift.
80 under each modifier can be:
82 .It ' Ns Ar symbol Ns No '
83 The symbol the key should produce,
92 For example, 32 for space.
97 as a hexadecimal number.
98 For example, 0x20 for space.
100 One of the standard names
140 By giving one of the accent names,
141 the next key pressed will produce
142 an accented character
143 in accordance with that accent.
144 See the description of accents below.
145 The accent names are:
170 Act as left shift key.
172 Act as right shift key.
174 Act as caps lock key.
178 Act as scroll lock key.
182 Act as backwards tab.
184 Act as left control key.
186 Act as right control key.
188 Act as right alt (altgr) key.
192 Act as alt shift key.
196 Act as left shift key / alt lock.
198 Act as right shift key / alt lock.
200 Act as left ctrl key / alt lock.
202 Act as right ctrl key / alt lock.
204 Act as left alt key / alt lock.
206 Act as right alt key / alt lock.
208 Act as switch to next screen.
210 Act as switch to previous screen.
223 and attempt to power it down.
227 Use APM to suspend power.
229 Activate screen saver
230 by toggling between splash/text screen.
236 .Va machdep.enable_panic_key
237 must be set to 1 to enable this feature.
239 Act as mouse buffer paste.
243 to complete the description of a key,
244 a flag which describes
245 the effect of caps lock and num lock
246 on that key is given.
249 to indicate that caps lock affects the key,
251 to indicate that num lock affects the key,
253 to indicate that both
254 caps lock and num lock affects the key,
257 to indicate that neither affects the key.
260 by modifying the behavior
261 of the next key pressed.
262 The description of an accent begins
263 with one of the accent names
266 by the symbol for the accent,
267 given in single quotes or
268 as a decimal or hexadecimal
271 This symbol will be produced
272 if the accent key is pressed and
273 then the space key is pressed.
275 The description of the accent key
276 continues with a list showing
277 how it modifies various symbols,
278 by giving pairs made up of the normal symbol and
280 enclosed in parentheses.
281 Both symbols in a pair can be given
282 in either single quotes or
289 consider the following extract from a
291 .Bd -literal -offset indent
292 041 dgra 172 nop nop '|' '|' nop nop O
293 dgra '`' ( 'a' 224 ) ( 'A' 192 ) ( 'e' 232 ) ( 'E' 200 )
294 ( 'i' 236 ) ( 'I' 204 ) ( 'o' 242 ) ( 'O' 210 )
295 ( 'u' 249 ) ( 'U' 217 )
298 configures the backtick key on a UK keyboard
299 to act as a grave accent key.
300 Pressing backtick followed by space
301 produces a backtick, and
302 pressing a backtick followed by a vowel
303 produces the ISO-8859-1 symbol
304 for that vowel with a grave accent.
306 .Bl -tag -width /usr/share/syscons/keymaps/* -compact
307 .It Pa /usr/share/syscons/keymaps/*
308 standard keyboard map files
317 This manual page first appeared in