NAME¶
ckbcomp - compile a XKB keyboard description to a keymap suitable for loadkeys
or kbdcontrol
SYNOPSIS¶
ckbcomp
[
OPTION...] [
XKBLAYOUT [
XKBVARIANT [
XKBOPTIONS]...]]
DESCRIPTION¶
The
ckbcomp keymap compiler converts a description of an XKB keyboard
layout into a console keymap that can be read directly by
loadkeys(1)
or
kbdcontrol(1).
On its standard output
ckbcomp dumps the generated keyboard definition.
The most important difference between the arguments of
setxkbmap(1) and
the arguments of
ckbcomp is the additional parameter
-charmap
when non-Unicode keyboard map is wanted. Without
-charmap
ckbcomp will generate Unicode keyboard.
OPTIONS¶
General options¶
- -?,-help
- Print a usage message and exit.
- -charmap charmap
- The encoding to use for the output keymap. There should be an character
mapping table defining this encoding in /usr/share/consoletrans.
Definitions of the following charmaps are provided: ARMSCII-8,
CP1251, CP1255, CP1256, GEORGIAN-ACADEMY,
GEORGIAN-PS, IBM1133, ISIRI-3342, ISO-8859-1,
ISO-8859-2, ISO-8859-3, ISO-8859-4,
ISO-8859-5, ISO-8859-6, ISO-8859-7,
ISO-8859-8, ISO-8859-9, ISO-8859-10,
ISO-8859-11, ISO-8859-13, ISO-8859-14,
ISO-8859-15, ISO-8859-16, KOI8-R, KOI8-U,
TIS-620 and VISCII.
- -Idir
- Look in the top-level directory dir for files included by the
keymap description. This option may be used multiple times. If a file can
not be found in any of the specified directories, it will be searched also
in some other standard locations, such as /etc/console-setup/ckb,
/usr/share/X11/xkb and /etc/X11/xkb
- -v level
- Set level of detail for listing. The argument level must be a
number from 1 to 10.
- -compact
- Generate a compact keymap with at most two xkb groups and two levels in
each or only one xkb-group and up to four levels.
- -freebsd
- Generate a keymap for FreeBSD.
- -backspace [bs|del]
- Specifies the behaviour of the <BackSpace> and
<Delete> keys. Value bs specifies
VT100-conformant behaviour: <BackSpace> will generate
^H (ASCII BS) and <Delete> will
generate ^? (ASCII DEL). Value del specifies
VT220-conformant behavior: <BackSpace> will generate
^? (ASCII DEL) and <Delete>
will generate a special function sequence.
XKB Keyboard Description¶
The keyboard layout, variant and options components can be also specified
directly on the command line. See the synopsis of the command.
- -symbols name
- Specifies the symbols component name of the XKB keyboard description.
- -keycodes name
- Specifies the keycodes component name of the XKB keyboard
description.
- -rules name
- The name of the rules file to use.
- -model name
- Specifies the keyboard model used to choose the component names.
- -layout name
- Specifies the layout used to choose the component names.
- -variant name
- Specifies the layout variant used to choose the component names.
- -option name
- Adds an option used to choose component names.
FILES¶
/usr/share/consoletrans
/etc/console-setup/ckb
/usr/share/X11/xkb
/etc/X11/xkb
NOTES¶
If the option
-freebsd is used together with
-backspace del, then the key
<Delete> will
generate the special code
fkey70. It is your responsibility to assign
the appropriate sequence to this special code by using the following command:
kbdcontrol -f 70 "`printf '\033[3~'`"
SEE ALSO¶
keyboard(5),
setxkbmap(1)