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.
234 Act as mouse buffer paste.
238 to complete the description of a key,
239 a flag which describes
240 the effect of caps lock and num lock
241 on that key is given.
244 to indicate that caps lock affects the key,
246 to indicate that num lock affects the key,
248 to indicate that both
249 caps lock and num lock affects the key,
252 to indicate that neither affects the key.
255 by modifying the behavior
256 of the next key pressed.
257 The description of an accent begins
258 with one of the accent names
261 by the symbol for the accent,
262 given in single quotes or
263 as a decimal or hexadecimal
266 This symbol will be produced
267 if the accent key is pressed and
268 then the space key is pressed.
270 The description of the accent key
271 continues with a list showing
272 how it modifies various symbols,
273 by giving pairs made up of the normal symbol and
275 enclosed in parentheses.
276 Both symbols in a pair can be given
277 in either single quotes or
284 consider the following extract from a
286 .Bd -literal -offset indent
287 041 dgra 172 nop nop '|' '|' nop nop O
288 dgra '`' ( 'a' 224 ) ( 'A' 192 ) ( 'e' 232 ) ( 'E' 200 )
289 ( 'i' 236 ) ( 'I' 204 ) ( 'o' 242 ) ( 'O' 210 )
290 ( 'u' 249 ) ( 'U' 217 )
293 configures the backtick key on a UK keyboard
294 to act as a grave accent key.
295 Pressing backtick followed by space
296 produces a backtick, and
297 pressing a backtick followed by a vowel
298 produces the ISO-8859-1 symbol
299 for that vowel with a grave accent.
301 .Bl -tag -width /usr/share/syscons/keymaps/* -compact
302 .It Pa /usr/share/syscons/keymaps/*
303 standard keyboard map files
312 This manual page first appeared in