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
139 One of the historical aliases for certain
146 By giving one of the accent names,
147 the next key pressed will produce
148 an accented character
149 in accordance with that accent.
150 See the description of accents below.
151 The accent names are:
174 is a decimal number in the range from 1 to 96.
177 manual page for a list of predefined function keys.
182 utility to assign arbitrary strings to function keys.
184 Act as left shift key.
186 Act as right shift key.
188 Act as caps lock key.
192 Act as scroll lock key.
196 Act as backwards tab.
198 Act as left control key.
200 Act as right control key.
202 Act as right alt (altgr) key.
206 Act as alt shift key.
210 Act as left shift key / alt lock.
212 Act as right shift key / alt lock.
214 Act as left ctrl key / alt lock.
216 Act as right ctrl key / alt lock.
218 Act as left alt key / alt lock.
220 Act as right alt key / alt lock.
222 Act as switch to next screen.
224 Act as switch to previous screen.
237 and attempt to power it down.
241 Use APM to suspend power.
243 Activate screen saver
244 by toggling between splash/text screen.
250 .Va machdep.enable_panic_key
251 must be set to 1 to enable this feature.
253 Act as mouse buffer paste.
257 to complete the description of a key,
258 a flag which describes
259 the effect of caps lock and num lock
260 on that key is given.
263 to indicate that caps lock affects the key,
265 to indicate that num lock affects the key,
267 to indicate that both
268 caps lock and num lock affects the key,
271 to indicate that neither affects the key.
274 by modifying the behavior
275 of the next key pressed.
276 The description of an accent begins
277 with one of the accent names
280 by the symbol for the accent,
281 given in single quotes or
282 as a decimal or hexadecimal
285 This symbol will be produced
286 if the accent key is pressed and
287 then the space key is pressed.
289 The description of the accent key
290 continues with a list showing
291 how it modifies various symbols,
292 by giving pairs made up of the normal symbol and
294 enclosed in parentheses.
295 Both symbols in a pair can be given
296 in either single quotes or
303 consider the following extract from a
305 .Bd -literal -offset indent
306 041 dgra 172 nop nop '|' '|' nop nop O
307 dgra '`' ( 'a' 224 ) ( 'A' 192 ) ( 'e' 232 ) ( 'E' 200 )
308 ( 'i' 236 ) ( 'I' 204 ) ( 'o' 242 ) ( 'O' 210 )
309 ( 'u' 249 ) ( 'U' 217 )
312 configures the backtick key on a UK keyboard
313 to act as a grave accent key.
314 Pressing backtick followed by space
315 produces a backtick, and
316 pressing a backtick followed by a vowel
317 produces the ISO-8859-1 symbol
318 for that vowel with a grave accent.
320 .Bl -tag -width /usr/share/syscons/keymaps/* -compact
321 .It Pa /usr/share/syscons/keymaps/*
322 standard keyboard map files for syscons
323 .It Pa /usr/share/vt/keymaps/*
324 standard keyboard map files for vt
334 This manual page first appeared in