1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3CR2//EN" "http://www.docbook.org/xml/4.3CR2/docbookx.dtd" [
3 <!ENTITY % kbd-entities SYSTEM "../ent/kbd.ent">
7 <title>Installing Kbd-&kbd-version;</title>
8 <?dbhtml filename="kbd.html"?>
10 <screen>Estimated build time: 0.1 SBU
11 Estimated required disk space: 12 MB</screen>
13 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/kbd-contents.xml"/>
17 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/kbd-deps.xml"/>
22 <title>Installation of Kbd</title>
24 <para>By default some of Kbd's utilities (<userinput>setlogcons</userinput>,
25 <userinput>setvesablank</userinput> and <userinput>getunimap</userinput>) are
26 not installed. First enable the compilation of these utilities:</para>
28 <screen><userinput>patch -Np1 -i ../kbd-&kbd-version;-more-programs-2.patch</userinput></screen>
30 <para>Now prepare Kbd for compilation:</para>
32 <screen><userinput>./configure</userinput></screen>
34 <para>Compile the package:</para>
36 <screen><userinput>make</userinput></screen>
38 <para>And install it:</para>
40 <screen><userinput>make install</userinput></screen>
44 <sect2><title>Configuring your keyboard</title>
46 <para>Few things are more annoying than using Linux while a wrong keymap
47 for your keyboard is loaded. If you have a standard US keyboard, however, you
48 can skip this section, as the US keymap is the default as long as you don't
51 <para>To change the default keymap, create the
52 <filename class="symlink">/usr/share/kbd/keymaps/defkeymap.map.gz</filename>
53 symlink by running the following command:</para>
55 <screen><userinput>ln -s path/to/keymap /usr/share/kbd/keymaps/defkeymap.map.gz</userinput></screen>
57 <para>Of course, replace <filename>path/to/keymap</filename> with the path and
58 name of your keyboard's map file. For example, if you have a Dutch keyboard,
59 you would use <filename>i386/qwerty/nl.map.gz</filename>.</para>
61 <para>Another way to set your keyboard's layout is to compile the keymap
62 into the kernel. This ensures that your keyboard will always work as expected,
63 even when you boot into maintenance mode (by passing `init=/bin/sh' to the
64 kernel), as then the bootscript that normally sets up your keymap isn't run.</para>
66 <para>Run the following command to patch the current default keymap into the
67 kernel source. You will have to repeat this command whenever you unpack a
70 <screen><userinput>loadkeys -m /usr/share/kbd/keymaps/defkeymap.map.gz > \
71 /usr/src/linux-2.4.24/drivers/char/defkeymap.c</userinput></screen>