man/keytab-lilo.8

   1 .\" '\" t
   2 .\" This page is based on the lilo docs/source, which carry the following
   3 .\" COPYING condition:
   4 .\"
   5 .\" LILO program code, documentation and auxiliary programs are
   6 .\" Copyright 1992-1994 Werner Almesberger.
   7 .\" All rights reserved.
   8 .\"
   9 .\" Redistribution and use in source and binary forms of parts of or the
  10 .\" whole original or derived work are permitted provided that the
  11 .\" original work is properly attributed to the author. The name of the
  12 .\" author may not be used to endorse or promote products derived from
  13 .\" this software without specific prior written permission. This work
  14 .\" is provided "as is" and without any express or implied warranties.
  15 .\"
  16 .\" Original version of this manpage:
  17 .\" Peter Maydell (pmaydell@chiark.greenend.org.uk), 03/1998
  18 .\"
  19 .TH "KEYTAB-LILO.PL" "8" "April 1998" "" ""
  20 .SH "NAME"
  21 keytab\-lilo \- compile keytables files for use with LILO
  22 .SH "SYNOPSIS"
  23 .B /usr/sbin/keytab\-lilo
  24 .RB [ \-p
  25 .I R old_code = new_code ]
  26 .RB ...
  27 .RI [ default_layout ] " kbd_layout"
  28 .SH "DESCRIPTION"
  29 .LP
  30 .B keytab\-lilo
  31 is a program which compiles keytable definitions (in the format
  32 specified in
  33 .BR keytables(5) )
  34 into a format which can be used by
  35 .B lilo(8)
  36 to set the keyboard type when booting
  37 [using the
  38 .B keytable
  39 parameter in
  40 .BR /etc/lilo.conf ].
  41
  42 .I kbd_layout
  43 should be the name of a map file which specifies the desired
  44 keyboard layout. This file may be a
  45 .B gzip(1)
  46 compressed map. If no file extension is given,
  47 .B .map.gz
  48 is assumed. If the full pathname is not specified,
  49 .B /usr/share/keymaps/
  50 is assumed.
  51
  52 Since
  53 .B lilo
  54 essentially needs to know the differences between
  55 the BIOS keyboard mapping and the one you require, the
  56 .I default_layout
  57 file should contain a
  58 .B keytables(5)
  59 file for the BIOS default mapping. If no
  60 .I default_layout
  61 file is specified,
  62 .B us.map.gz
  63 is used.
  64
  65 .B keytab\-lilo
  66 writes the output translation table as a binary string to standard
  67 output, so you should redirect it to a suitable file.
  68 .B lilo
  69 has no particular restrictions on the name of keyboard translation
  70 files, but the suggested naming convention and location is
  71 .BI /boot/ mapping .ktl
  72 (where
  73 .B .ktl
  74 stands for "Keyboard Table for Lilo").
  75 .SH "OPTIONS"
  76 .TP
  77 .B \-p
  78 .I R old_code = new_code
  79 .br
  80 Specifies corrections ("patches") to the mapping obtained from the
  81 translation table files. E.g. if pressing the upper case "A" should
  82 yield an at sign, \-p 65=64 would be used. The  \-p  option can be
  83 repeated any number of times. The codes can also be given as
  84 hexadecimal or as octal numbers if they are prefixed with 0x or 0,
  85 respectively.
  86
  87 .SH "EXAMPLES"
  88 .TP
  89 .B keytab\-lilo dvorak >/boot/dvorak.ktl
  90
  91 This is the most common form of invocation; it simply compiles the
  92 given map file (in this case dvorak) and puts the result in
  93 .BR /boot/dvorak.ktl .
  94
  95 .SH "AUTHOR"
  96 Werner Almesberger (almesber@bernina.ethz.ch).
  97 .br
  98 Peter Maydell (pmaydell@chiark.greenend.org.uk) wrote this manual page.
  99 .SH "SEE ALSO"
 100 .BR lilo (8),
 101 .BR keytables (5),
 102 .BR gzip (1)