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.
232 Panic the system. The
235 .Va machdep.enable_panic_key
236 must be set to 1 to enable this feature.
238 Act as mouse buffer paste.
242 to complete the description of a key,
243 a flag which describes
244 the effect of caps lock and num lock
245 on that key is given.
248 to indicate that caps lock affects the key,
250 to indicate that num lock affects the key,
252 to indicate that both
253 caps lock and num lock affects the key,
256 to indicate that neither affects the key.
259 by modifying the behavior
260 of the next key pressed.
261 The description of an accent begins
262 with one of the accent names
265 by the symbol for the accent,
266 given in single quotes or
267 as a decimal or hexadecimal
270 This symbol will be produced
271 if the accent key is pressed and
272 then the space key is pressed.
274 The description of the accent key
275 continues with a list showing
276 how it modifies various symbols,
277 by giving pairs made up of the normal symbol and
279 enclosed in parentheses.
280 Both symbols in a pair can be given
281 in either single quotes or
288 consider the following extract from a
290 .Bd -literal -offset indent
291 041 dgra 172 nop nop '|' '|' nop nop O
292 dgra '`' ( 'a' 224 ) ( 'A' 192 ) ( 'e' 232 ) ( 'E' 200 )
293 ( 'i' 236 ) ( 'I' 204 ) ( 'o' 242 ) ( 'O' 210 )
294 ( 'u' 249 ) ( 'U' 217 )
297 configures the backtick key on a UK keyboard
298 to act as a grave accent key.
299 Pressing backtick followed by space
300 produces a backtick, and
301 pressing a backtick followed by a vowel
302 produces the ISO-8859-1 symbol
303 for that vowel with a grave accent.
305 .Bl -tag -width /usr/share/syscons/keymaps/* -compact
306 .It Pa /usr/share/syscons/keymaps/*
307 standard keyboard map files
316 This manual page first appeared in