source: clfs-sysroot/BOOK/final-system/arm/kbd.xml@ 6e439f9

Last change on this file since 6e439f9 was c3b61cb, checked in by Joe Ciccone <jciccone@…>, 18 years ago

Moved the kbd page from common into arm now that one of the commands is arch specific.
  • Property mode set to 100644
File size: 11.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-kbd" role="wrap">
9 <?dbhtml filename="kbd.html"?>
10
11 <title>Kbd-&kbd-version;</title>
12
13 <indexterm zone="ch-system-kbd">
14 <primary sortas="a-Kbd">Kbd</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Kbd package contains key-table files and keyboard
21 utilities.</para>
22
23 </sect2>
24
25 <sect2 role="installation">
26 <title>Installation of Kbd</title>
27
28 <para os="p1">The following patch fixes build issues with GCC &gcc-version;:</para>
29
30<screen os="p2"><userinput>patch -Np1 -i ../&kbd-gcc4_fixes-patch;</userinput></screen>
31
32 <para os="s1">The following sed disables running the built conftests while
33 running configure:</para>
34
35<screen os="s2"><userinput>cp configure{,.orig}
36sed -e "s@&amp;&amp; ./conftest@@" configure.orig &gt; configure</userinput></screen>
37
38 <para os="s3">The following sed removes -s from the install command which
39 will try to strip the installed files:</para>
40
41<screen os="s4"><userinput>cp src/Makefile.in{,.orig}
42sed -e "s/install -s/install/" src/Makefile.in.orig &gt; src/Makefile.in</userinput></screen>
43
44 <para os="a">Prepare Kbd for compilation:</para>
45
46<screen os="b"><userinput>./configure --datadir=/lib/kbd</userinput></screen>
47
48 <para os="s5">Configure detects the architecture of the host system. The
49 following sed changes this value to your target architecture.</para>
50
51<screen os="s6"><userinput>cp make_include{,.orig}
52sed "/^ARCH/s/=.*/=arm/" make_include.orig &gt; make_include</userinput></screen>
53
54 <para os="c">Compile the package:</para>
55
56<screen os="d"><userinput>make CC="${CC}"</userinput></screen>
57
58 <para os="e">Install the package:</para>
59
60<screen os="f"><userinput>make DESTDIR=${CLFS} install</userinput></screen>
61
62 <para os="g">Some of the Programs from Kbd are used by some of the scripts
63 in the CLFS-Bootscripts package. As <filename
64 class="directory">/usr</filename> may not be available during the early
65 stages of booting, those binaries need to be on the root partition:</para>
66
67<screen os="h"><userinput>mv -v ${CLFS}/usr/bin/{kbd_mode,openvt,setfont} ${CLFS}/bin</userinput></screen>
68
69 </sect2>
70
71 <sect2 id="contents-kbd" role="content">
72 <title>Contents of Kbd</title>
73
74 <segmentedlist>
75 <segtitle>Installed programs</segtitle>
76
77 <seglistitem>
78 <seg>chvt, deallocvt, dumpkeys, fgconsole, getkeycodes, kbd_mode,
79 kbdrate, loadkeys, loadunimap, mapscrn, openvt, psfaddtable
80 (link to psfxtable), psfgettable (link to psfxtable), psfstriptable
81 (link to psfxtable), psfxtable, resizecons, setfont, setkeycodes,
82 setleds, setmetamode, showconsolefont, showkey, unicode_start, and
83 unicode_stop</seg>
84 </seglistitem>
85 </segmentedlist>
86
87 <variablelist>
88 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
89 <?dbfo list-presentation="list"?>
90 <?dbhtml list-presentation="table"?>
91
92 <varlistentry id="chvt">
93 <term><command>chvt</command></term>
94 <listitem>
95 <para>Changes the foreground virtual terminal</para>
96 <indexterm zone="ch-system-kbd chvt">
97 <primary sortas="b-chvt">chvt</primary>
98 </indexterm>
99 </listitem>
100 </varlistentry>
101
102 <varlistentry id="deallocvt">
103 <term><command>deallocvt</command></term>
104 <listitem>
105 <para>Deallocates unused virtual terminals</para>
106 <indexterm zone="ch-system-kbd deallocvt">
107 <primary sortas="b-deallocvt">deallocvt</primary>
108 </indexterm>
109 </listitem>
110 </varlistentry>
111
112 <varlistentry id="dumpkeys">
113 <term><command>dumpkeys</command></term>
114 <listitem>
115 <para>Dumps the keyboard translation tables</para>
116 <indexterm zone="ch-system-kbd dumpkeys">
117 <primary sortas="b-dumpkeys">dumpkeys</primary>
118 </indexterm>
119 </listitem>
120 </varlistentry>
121
122 <varlistentry id="fgconsole">
123 <term><command>fgconsole</command></term>
124 <listitem>
125 <para>Prints the number of the active virtual terminal</para>
126 <indexterm zone="ch-system-kbd fgconsole">
127 <primary sortas="b-fgconsole">fgconsole</primary>
128 </indexterm>
129 </listitem>
130 </varlistentry>
131
132 <varlistentry id="getkeycodes">
133 <term><command>getkeycodes</command></term>
134 <listitem>
135 <para>Prints the kernel scancode-to-keycode mapping table</para>
136 <indexterm zone="ch-system-kbd getkeycodes">
137 <primary sortas="b-getkeycodes">getkeycodes</primary>
138 </indexterm>
139 </listitem>
140 </varlistentry>
141
142 <varlistentry id="kbd_mode">
143 <term><command>kbd_mode</command></term>
144 <listitem>
145 <para>Reports or sets the keyboard mode</para>
146 <indexterm zone="ch-system-kbd kbd_mode">
147 <primary sortas="b-kbd_mode">kbd_mode</primary>
148 </indexterm>
149 </listitem>
150 </varlistentry>
151
152 <varlistentry id="kbdrate">
153 <term><command>kbdrate</command></term>
154 <listitem>
155 <para>Sets the keyboard repeat and delay rates</para>
156 <indexterm zone="ch-system-kbd kbdrate">
157 <primary sortas="b-kbdrate">kbdrate</primary>
158 </indexterm>
159 </listitem>
160 </varlistentry>
161
162 <varlistentry id="loadkeys">
163 <term><command>loadkeys</command></term>
164 <listitem>
165 <para>Loads the keyboard translation tables</para>
166 <indexterm zone="ch-system-kbd loadkeys">
167 <primary sortas="b-loadkeys">loadkeys</primary>
168 </indexterm>
169 </listitem>
170 </varlistentry>
171
172 <varlistentry id="loadunimap">
173 <term><command>loadunimap</command></term>
174 <listitem>
175 <para>Loads the kernel unicode-to-font mapping table</para>
176 <indexterm zone="ch-system-kbd loadunimap">
177 <primary sortas="b-loadunimap">loadunimap</primary>
178 </indexterm>
179 </listitem>
180 </varlistentry>
181
182 <varlistentry id="mapscrn">
183 <term><command>mapscrn</command></term>
184 <listitem>
185 <para>An obsolete program that used to load a user-defined output
186 character mapping table into the console driver; this is now done
187 by <command>setfont</command></para>
188 <indexterm zone="ch-system-kbd mapscrn">
189 <primary sortas="b-mapscrn">mapscrn</primary>
190 </indexterm>
191 </listitem>
192 </varlistentry>
193
194 <varlistentry id="openvt">
195 <term><command>openvt</command></term>
196 <listitem>
197 <para>Starts a program on a new virtual terminal (VT)</para>
198 <indexterm zone="ch-system-kbd openvt">
199 <primary sortas="b-openvt">openvt</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="psfaddtable">
205 <term><command>psfaddtable</command></term>
206 <listitem>
207 <para>A link to <command>psfxtable</command></para>
208 <indexterm zone="ch-system-kbd psfaddtable">
209 <primary sortas="b-psfaddtable">psfaddtable</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="psfgettable">
215 <term><command>psfgettable</command></term>
216 <listitem>
217 <para>A link to <command>psfxtable</command></para>
218 <indexterm zone="ch-system-kbd psfgettable">
219 <primary sortas="b-psfgettable">psfgettable</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="psfstriptable">
225 <term><command>psfstriptable</command></term>
226 <listitem>
227 <para>A link to <command>psfxtable</command></para>
228 <indexterm zone="ch-system-kbd psfstriptable">
229 <primary sortas="b-psfstriptable">psfstriptable</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="psfxtable">
235 <term><command>psfxtable</command></term>
236 <listitem>
237 <para>Handle Unicode character tables for console fonts</para>
238 <indexterm zone="ch-system-kbd psfxtable">
239 <primary sortas="b-psfxtable">psfxtable</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="resizecons">
245 <term><command>resizecons</command></term>
246 <listitem>
247 <para>Changes the kernel idea of the console size</para>
248 <indexterm zone="ch-system-kbd resizecons">
249 <primary sortas="b-resizecons">resizecons</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="setfont">
255 <term><command>setfont</command></term>
256 <listitem>
257 <para>Changes the Enhanced Graphic Adapter (EGA) and Video Graphics
258 Array (VGA) fonts on the console</para>
259 <indexterm zone="ch-system-kbd setfont">
260 <primary sortas="b-setfont">setfont</primary>
261 </indexterm>
262 </listitem>
263 </varlistentry>
264
265 <varlistentry id="setkeycodes">
266 <term><command>setkeycodes</command></term>
267 <listitem>
268 <para>Loads kernel scancode-to-keycode mapping table entries; this is
269 useful if there are unusual keys on the keyboard</para>
270 <indexterm zone="ch-system-kbd setkeycodes">
271 <primary sortas="b-setkeycodes">setkeycodes</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="setleds">
277 <term><command>setleds</command></term>
278 <listitem>
279 <para>Sets the keyboard flags and Light Emitting Diodes (LEDs)</para>
280 <indexterm zone="ch-system-kbd setleds">
281 <primary sortas="b-setleds">setleds</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="setmetamode">
287 <term><command>setmetamode</command></term>
288 <listitem>
289 <para>Defines the keyboard meta-key handling</para>
290 <indexterm zone="ch-system-kbd setmetamode">
291 <primary sortas="b-setmetamode">setmetamode</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="showconsolefont">
297 <term><command>showconsolefont</command></term>
298 <listitem>
299 <para>Shows the current EGA/VGA console screen font</para>
300 <indexterm zone="ch-system-kbd showconsolefont">
301 <primary sortas="b-showconsolefont">showconsolefont</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="showkey">
307 <term><command>showkey</command></term>
308 <listitem>
309 <para>Reports the scancodes, keycodes, and ASCII codes of the keys
310 pressed on the keyboard</para>
311 <indexterm zone="ch-system-kbd showkey">
312 <primary sortas="b-showkey">showkey</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316
317 <varlistentry id="unicode_start">
318 <term><command>unicode_start</command></term>
319 <listitem>
320 <para>Puts the keyboard and console in UNICODE mode. Never use it on
321 LFS, because applications are not configured to support UNICODE.</para>
322 <indexterm zone="ch-system-kbd unicode_start">
323 <primary sortas="b-unicode_start">unicode_start</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="unicode_stop">
329 <term><command>unicode_stop</command></term>
330 <listitem>
331 <para>Reverts keyboard and console from UNICODE mode</para>
332 <indexterm zone="ch-system-kbd unicode_stop">
333 <primary sortas="b-unicode_stop">unicode_stop</primary>
334 </indexterm>
335 </listitem>
336 </varlistentry>
337
338 </variablelist>
339
340 </sect2>
341
342</sect1>
Note: See TracBrowser for help on using the repository browser.