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
25 .\" $FreeBSD: src/usr.sbin/kbdcontrol/kbdmap.5,v 1.1.2.4 2001/08/01 12:01:28 sheldonh Exp $
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 Suspend power (unsupported).
229 Activate screen saver
230 by toggling between splash/text screen.
236 to complete the description of a key,
237 a flag which describes
238 the effect of caps lock and num lock
239 on that key is given.
242 to indicate that caps lock affects the key,
244 to indicate that num lock affects the key,
246 to indicate that both
247 caps lock and num lock affects the key,
250 to indicate that neither affects the key.
253 by modifying the behavior
254 of the next key pressed.
255 The description of an accent begins
256 with one of the accent names
259 by the symbol for the accent,
260 given in single quotes or
261 as a decimal or hexadecimal
264 This symbol will be produced
265 if the accent key is pressed and
266 then the space key is pressed.
268 The description of the accent key
269 continues with a list showing
270 how it modifies various symbols,
271 by giving pairs made up of the normal symbol and
273 enclosed in parentheses.
274 Both symbols in a pair can be given
275 in either single quotes or
282 consider the following extract from a
284 .Bd -literal -offset indent
285 041 dgra 172 nop nop '|' '|' nop nop O
286 dgra '`' ( 'a' 224 ) ( 'A' 192 ) ( 'e' 232 ) ( 'E' 200 )
287 ( 'i' 236 ) ( 'I' 204 ) ( 'o' 242 ) ( 'O' 210 )
288 ( 'u' 249 ) ( 'U' 217 )
291 configures the backtick key on a UK keyboard
292 to act as a grave accent key.
293 Pressing backtick followed by space
294 produces a backtick, and
295 pressing a backtick followed by a vowel
296 produces the ISO-8859-1 symbol
297 for that vowel with a grave accent.
299 .Bl -tag -width /usr/share/syscons/keymaps/* -compact
300 .It Pa /usr/share/syscons/keymaps/*
301 standard keyboard map files
310 This manual page first appeared in