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
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:
168 is a decimal number in the range from 1 to 96.
171 manual page for a list of predefined function keys.
176 utility to assign arbitrary strings to function keys.
178 Act as left shift key.
180 Act as right shift key.
182 Act as caps lock key.
186 Act as scroll lock key.
190 Act as backwards tab.
192 Act as left control key.
194 Act as right control key.
196 Act as right alt (altgr) key.
200 Act as alt shift key.
204 Act as left shift key / alt lock.
206 Act as right shift key / alt lock.
208 Act as left ctrl key / alt lock.
210 Act as right ctrl key / alt lock.
212 Act as left alt key / alt lock.
214 Act as right alt key / alt lock.
216 Act as switch to next screen.
218 Act as switch to previous screen.
231 and attempt to power it down.
235 Use APM to suspend power.
237 Activate screen saver
238 by toggling between splash/text screen.
244 .Va machdep.enable_panic_key
245 must be set to 1 to enable this feature.
247 Act as mouse buffer paste.
251 to complete the description of a key,
252 a flag which describes
253 the effect of caps lock and num lock
254 on that key is given.
257 to indicate that caps lock affects the key,
259 to indicate that num lock affects the key,
261 to indicate that both
262 caps lock and num lock affects the key,
265 to indicate that neither affects the key.
268 by modifying the behavior
269 of the next key pressed.
270 The description of an accent begins
271 with one of the accent names
274 by the symbol for the accent,
275 given in single quotes or
276 as a decimal or hexadecimal
279 This symbol will be produced
280 if the accent key is pressed and
281 then the space key is pressed.
283 The description of the accent key
284 continues with a list showing
285 how it modifies various symbols,
286 by giving pairs made up of the normal symbol and
288 enclosed in parentheses.
289 Both symbols in a pair can be given
290 in either single quotes or
297 consider the following extract from a
299 .Bd -literal -offset indent
300 041 dgra 172 nop nop '|' '|' nop nop O
301 dgra '`' ( 'a' 224 ) ( 'A' 192 ) ( 'e' 232 ) ( 'E' 200 )
302 ( 'i' 236 ) ( 'I' 204 ) ( 'o' 242 ) ( 'O' 210 )
303 ( 'u' 249 ) ( 'U' 217 )
306 configures the backtick key on a UK keyboard
307 to act as a grave accent key.
308 Pressing backtick followed by space
309 produces a backtick, and
310 pressing a backtick followed by a vowel
311 produces the ISO-8859-1 symbol
312 for that vowel with a grave accent.
314 .Bl -tag -width /usr/share/syscons/keymaps/* -compact
315 .It Pa /usr/share/syscons/keymaps/*
316 standard keyboard map files for syscons
317 .It Pa /usr/share/vt/keymaps/*
318 standard keyboard map files for vt
328 This manual page first appeared in