Linux From Scratch - Version 7.2

Chapter 6. Installing Basic System Software

6.51. Kbd-1.15.3

The Kbd package contains key-table files, console fonts, and keyboard utilities.

Approximate build time: 0.1 SBU
Required disk space: 20 MB

6.51.1. Installation of Kbd

The behaviour of loadkeys when run without a filename was broken in this release. The following patch fixes this: 

patch -Np1 -i ../kbd-1.15.3-upstream_fixes-1.patch

The behaviour of the Backspace and Delete keys is not consistent across the keymaps in the Kbd package. The following patch fixes this issue for i386 keymaps: 

patch -Np1 -i ../kbd-1.15.3-backspace-1.patch

After patching, the Backspace key generates the character with code 127, and the Delete key generates a well-known escape sequence.

Fix a bug in the Spanish message translations which prevents kbd from building with gettext-0.18.1.1: 

sed -i '/guardado\ el/s/\(^.*en\ %\)\(.*\)/\14\$\2/' po/es.po

Remove the redundant resizecons program (32-bit x86 only, needs the defunct svgalib, which predates linux-2.6 and is incompatible with modern KMS, to provide the video mode files - for normal use setfont sizes the console appropriately) and its manpage.

The shipped version of configure.ac is newer than aclocal.m4, so autotools will be run by make which will overwrite the change to configure. Alter the date and time of configure.ac - this uses the system timezone, so we pick a time that is sufficiently old in all timezones. 

sed -i 's/\(RESIZECONS_PROGS=\)yes/\1no/' configure &&
sed -i 's/resizecons.8 //' man/man8/Makefile.in &&
touch -d '2011-05-07 08:30' configure.ac

Prepare Kbd for compilation: 

./configure --prefix=/usr --datadir=/lib/kbd

The meaning of the configure options:

--datadir=/lib/kbd

This option puts keyboard layout data in a directory that will always be on the root partition instead of the default /usr/share/kbd.

Compile the package: 

make

This package does not come with a test suite.

Install the package: 

make install
[Note]

Note

For some languages (e.g., Belarusian) the Kbd package doesn't provide a useful keymap where the stock “by” keymap assumes the ISO-8859-5 encoding, and the CP1251 keymap is normally used. Users of such languages have to download working keymaps separately.

Some of the scripts in the LFS-Bootscripts package depend on kbd_mode, loadkeys, openvt, and setfont. As /usr may not be available during the early stages of booting, those binaries need to be on the root partition: 

mv -v /usr/bin/{kbd_mode,loadkeys,openvt,setfont} /bin

If desired, install the documentation: 

mkdir -v /usr/share/doc/kbd-1.15.3
cp -R -v doc/* \
         /usr/share/doc/kbd-1.15.3

6.51.2. Contents of Kbd

Installed programs: chvt, deallocvt, dumpkeys, fgconsole, getkeycodes, kbd_mode, kbdrate, loadkeys, loadunimap, mapscrn, openvt, psfaddtable (link to psfxtable), psfgettable (link to psfxtable), psfstriptable (link to psfxtable), psfxtable, setfont, setkeycodes, setleds, setmetamode, showconsolefont, showkey, unicode_start, and unicode_stop
Installed directory: /lib/kbd

Short Descriptions

chvt

Changes the foreground virtual terminal

deallocvt

Deallocates unused virtual terminals

dumpkeys

Dumps the keyboard translation tables

fgconsole

Prints the number of the active virtual terminal

getkeycodes

Prints the kernel scancode-to-keycode mapping table

kbd_mode

Reports or sets the keyboard mode

kbdrate

Sets the keyboard repeat and delay rates

loadkeys

Loads the keyboard translation tables

loadunimap

Loads the kernel unicode-to-font mapping table

mapscrn

An obsolete program that used to load a user-defined output character mapping table into the console driver; this is now done by setfont

openvt

Starts a program on a new virtual terminal (VT)

psfaddtable

A link to psfxtable

psfgettable

A link to psfxtable

psfstriptable

A link to psfxtable

psfxtable

Handle Unicode character tables for console fonts

setfont

Changes the Enhanced Graphic Adapter (EGA) and Video Graphics Array (VGA) fonts on the console

setkeycodes

Loads kernel scancode-to-keycode mapping table entries; this is useful if there are unusual keys on the keyboard

setleds

Sets the keyboard flags and Light Emitting Diodes (LEDs)

setmetamode

Defines the keyboard meta-key handling

showconsolefont

Shows the current EGA/VGA console screen font

showkey

Reports the scancodes, keycodes, and ASCII codes of the keys pressed on the keyboard

unicode_start

Puts the keyboard and console in UNICODE mode. Don't use this program unless your keymap file is in the ISO-8859-1 encoding. For other encodings, this utility produces incorrect results.

unicode_stop

Reverts keyboard and console from UNICODE mode