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)