| 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 ([email protected]), 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 ([email protected]). |
| 97 |
.br |
| 98 |
Peter Maydell ([email protected]) wrote this manual page. |
| 99 |
.SH "SEE ALSO" |
| 100 |
.BR lilo (8), |
| 101 |
.BR keytables (5), |
| 102 |
.BR gzip (1) |