1CKBCOMP(1) Console-setup User's Manual CKBCOMP(1)
2
3
4
6 ckbcomp - compile a XKB keyboard description to a keymap suitable for
7 loadkeys or kbdcontrol
8
9
11 ckbcomp [OPTION...] [XKBLAYOUT [XKBVARIANT [XKBOPTIONS]...]]
12
13
15 The ckbcomp keymap compiler converts a description of an XKB keyboard
16 layout into a console keymap that can be read directly by loadkeys(1)
17 or kbdcontrol(1).
18
19 On its standard output ckbcomp dumps the generated keyboard definition.
20 The most important difference between the arguments of setxkbmap(1) and
21 the arguments of ckbcomp is the additional parameter -charmap when non-
22 Unicode keyboard map is wanted. Without -charmap ckbcomp will generate
23 Unicode keyboard.
24
25
26
28 General options
29 -?,-help
30 Print a usage message and exit.
31
32 -charmap charmap
33 The encoding to use for the output keymap. There should be an
34 character mapping table defining this encoding in
35 /usr/share/consoletrans. Definitions of the following charmaps
36 are provided: ARMSCII-8, CP1251, CP1255, CP1256, GEORGIAN-
37 ACADEMY, GEORGIAN-PS, IBM1133, ISIRI-3342, ISO-8859-1,
38 ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6,
39 ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-10, ISO-8859-11,
40 ISO-8859-13, ISO-8859-14, ISO-8859-15, ISO-8859-16, KOI8-R,
41 KOI8-U, TIS-620 and VISCII.
42
43
44 -Idir Look in the top-level directory dir for files included by the
45 keymap description. This option may be used multiple times. If
46 a file can not be found in any of the specified directories, it
47 will be searched also in some other standard locations, such as
48 /etc/console-setup/ckb, /usr/local/share/X11/xkb,
49 /usr/share/X11/xkb and /etc/X11/xkb
50
51
52 -v level
53 Set level of detail for listing. The argument level must be a
54 number from 1 to 10.
55
56 -compact
57 Generate a compact keymap with at most two xkb groups and two
58 levels in each or only one xkb-group and up to four levels.
59
60 -freebsd
61 Generate a keymap for FreeBSD.
62
63 -backspace [bs|del]
64 Specifies the behaviour of the <BackSpace> and <Delete> keys.
65 Value bs specifies VT100-conformant behaviour: <BackSpace> will
66 generate ^H (ASCII BS) and <Delete> will generate ^? (ASCII
67 DEL). Value del specifies VT220-conformant behavior:
68 <BackSpace> will generate ^? (ASCII DEL) and <Delete> will gen‐
69 erate a special function sequence.
70
71
72 XKB Keyboard Description
73 The keyboard layout, variant and options components can be also speci‐
74 fied directly on the command line. See the synopsis of the command.
75
76 -symbols name
77 Specifies the symbols component name of the XKB keyboard de‐
78 scription.
79
80 -keycodes name
81 Specifies the keycodes component name of the XKB keyboard de‐
82 scription.
83
84 -rules name
85 The name of the rules file to use.
86
87 -model name
88 Specifies the keyboard model used to choose the component names.
89
90 -layout name
91 Specifies the layout used to choose the component names.
92
93 -variant name
94 Specifies the layout variant used to choose the component names.
95
96 -option name
97 Adds an option used to choose component names.
98
99
101 /usr/share/consoletrans
102 /etc/console-setup/ckb
103 /usr/share/X11/xkb
104 /etc/X11/xkb
105
106
108 If the option -freebsd is used together with -backspace del, then the
109 key <Delete> will generate the special code fkey70. It is your respon‐
110 sibility to assign the appropriate sequence to this special code by
111 using the following command:
112
113 kbdcontrol -f 70 "`printf '\033[3~'`"
114
115
116
118 keyboard(5), setxkbmap(1)
119
120
121
122console-setup 2011-03-17 CKBCOMP(1)