source: clfs-sysroot/BOOK/final-system/common/kbd.xml@ 3d7a86a

Last change on this file since 3d7a86a was 32a0631, checked in by Joe Ciccone <jciccone@…>, 18 years ago

Fixes a possible issue with bootscripts if the /usr partition is not mounted during startup. Moved find to /bin and some kbd utilities to /bin.
  • Property mode set to 100644
File size: 11.6 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="c">Compile the package:</para>
49
50<screen os="d"><userinput>make CC="${CC}"</userinput></screen>
51
52 <para os="e">Install the package:</para>
53
54<screen os="f"><userinput>make DESTDIR=${CLFS} install</userinput></screen>
55
56 <para os="g">Some of the Programs from Kbd are used by some of the scripts
57 in the CLFS-Bootscripts package. As <filename
58 class="directory">/usr</filename> may not be available during the early
59 stages of booting, those binaries need to be on the root partition:</para>
60
61<screen os="h"><userinput>mv -v ${CLFS}/usr/bin/{kbd_mode,openvt,setfont} ${CLFS}/bin</userinput></screen>
62
63 </sect2>
64
65 <sect2 id="contents-kbd" role="content">
66 <title>Contents of Kbd</title>
67
68 <segmentedlist>
69 <segtitle>Installed programs</segtitle>
70
71 <seglistitem>
72 <seg>chvt, deallocvt, dumpkeys, fgconsole, getkeycodes, kbd_mode,
73 kbdrate, loadkeys, loadunimap, mapscrn, openvt, psfaddtable
74 (link to psfxtable), psfgettable (link to psfxtable), psfstriptable
75 (link to psfxtable), psfxtable, resizecons, setfont, setkeycodes,
76 setleds, setmetamode, showconsolefont, showkey, unicode_start, and
77 unicode_stop</seg>
78 </seglistitem>
79 </segmentedlist>
80
81 <variablelist>
82 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
83 <?dbfo list-presentation="list"?>
84 <?dbhtml list-presentation="table"?>
85
86 <varlistentry id="chvt">
87 <term><command>chvt</command></term>
88 <listitem>
89 <para>Changes the foreground virtual terminal</para>
90 <indexterm zone="ch-system-kbd chvt">
91 <primary sortas="b-chvt">chvt</primary>
92 </indexterm>
93 </listitem>
94 </varlistentry>
95
96 <varlistentry id="deallocvt">
97 <term><command>deallocvt</command></term>
98 <listitem>
99 <para>Deallocates unused virtual terminals</para>
100 <indexterm zone="ch-system-kbd deallocvt">
101 <primary sortas="b-deallocvt">deallocvt</primary>
102 </indexterm>
103 </listitem>
104 </varlistentry>
105
106 <varlistentry id="dumpkeys">
107 <term><command>dumpkeys</command></term>
108 <listitem>
109 <para>Dumps the keyboard translation tables</para>
110 <indexterm zone="ch-system-kbd dumpkeys">
111 <primary sortas="b-dumpkeys">dumpkeys</primary>
112 </indexterm>
113 </listitem>
114 </varlistentry>
115
116 <varlistentry id="fgconsole">
117 <term><command>fgconsole</command></term>
118 <listitem>
119 <para>Prints the number of the active virtual terminal</para>
120 <indexterm zone="ch-system-kbd fgconsole">
121 <primary sortas="b-fgconsole">fgconsole</primary>
122 </indexterm>
123 </listitem>
124 </varlistentry>
125
126 <varlistentry id="getkeycodes">
127 <term><command>getkeycodes</command></term>
128 <listitem>
129 <para>Prints the kernel scancode-to-keycode mapping table</para>
130 <indexterm zone="ch-system-kbd getkeycodes">
131 <primary sortas="b-getkeycodes">getkeycodes</primary>
132 </indexterm>
133 </listitem>
134 </varlistentry>
135
136 <varlistentry id="kbd_mode">
137 <term><command>kbd_mode</command></term>
138 <listitem>
139 <para>Reports or sets the keyboard mode</para>
140 <indexterm zone="ch-system-kbd kbd_mode">
141 <primary sortas="b-kbd_mode">kbd_mode</primary>
142 </indexterm>
143 </listitem>
144 </varlistentry>
145
146 <varlistentry id="kbdrate">
147 <term><command>kbdrate</command></term>
148 <listitem>
149 <para>Sets the keyboard repeat and delay rates</para>
150 <indexterm zone="ch-system-kbd kbdrate">
151 <primary sortas="b-kbdrate">kbdrate</primary>
152 </indexterm>
153 </listitem>
154 </varlistentry>
155
156 <varlistentry id="loadkeys">
157 <term><command>loadkeys</command></term>
158 <listitem>
159 <para>Loads the keyboard translation tables</para>
160 <indexterm zone="ch-system-kbd loadkeys">
161 <primary sortas="b-loadkeys">loadkeys</primary>
162 </indexterm>
163 </listitem>
164 </varlistentry>
165
166 <varlistentry id="loadunimap">
167 <term><command>loadunimap</command></term>
168 <listitem>
169 <para>Loads the kernel unicode-to-font mapping table</para>
170 <indexterm zone="ch-system-kbd loadunimap">
171 <primary sortas="b-loadunimap">loadunimap</primary>
172 </indexterm>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry id="mapscrn">
177 <term><command>mapscrn</command></term>
178 <listitem>
179 <para>An obsolete program that used to load a user-defined output
180 character mapping table into the console driver; this is now done
181 by <command>setfont</command></para>
182 <indexterm zone="ch-system-kbd mapscrn">
183 <primary sortas="b-mapscrn">mapscrn</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="openvt">
189 <term><command>openvt</command></term>
190 <listitem>
191 <para>Starts a program on a new virtual terminal (VT)</para>
192 <indexterm zone="ch-system-kbd openvt">
193 <primary sortas="b-openvt">openvt</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="psfaddtable">
199 <term><command>psfaddtable</command></term>
200 <listitem>
201 <para>A link to <command>psfxtable</command></para>
202 <indexterm zone="ch-system-kbd psfaddtable">
203 <primary sortas="b-psfaddtable">psfaddtable</primary>
204 </indexterm>
205 </listitem>
206 </varlistentry>
207
208 <varlistentry id="psfgettable">
209 <term><command>psfgettable</command></term>
210 <listitem>
211 <para>A link to <command>psfxtable</command></para>
212 <indexterm zone="ch-system-kbd psfgettable">
213 <primary sortas="b-psfgettable">psfgettable</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="psfstriptable">
219 <term><command>psfstriptable</command></term>
220 <listitem>
221 <para>A link to <command>psfxtable</command></para>
222 <indexterm zone="ch-system-kbd psfstriptable">
223 <primary sortas="b-psfstriptable">psfstriptable</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="psfxtable">
229 <term><command>psfxtable</command></term>
230 <listitem>
231 <para>Handle Unicode character tables for console fonts</para>
232 <indexterm zone="ch-system-kbd psfxtable">
233 <primary sortas="b-psfxtable">psfxtable</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="resizecons">
239 <term><command>resizecons</command></term>
240 <listitem>
241 <para>Changes the kernel idea of the console size</para>
242 <indexterm zone="ch-system-kbd resizecons">
243 <primary sortas="b-resizecons">resizecons</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="setfont">
249 <term><command>setfont</command></term>
250 <listitem>
251 <para>Changes the Enhanced Graphic Adapter (EGA) and Video Graphics
252 Array (VGA) fonts on the console</para>
253 <indexterm zone="ch-system-kbd setfont">
254 <primary sortas="b-setfont">setfont</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="setkeycodes">
260 <term><command>setkeycodes</command></term>
261 <listitem>
262 <para>Loads kernel scancode-to-keycode mapping table entries; this is
263 useful if there are unusual keys on the keyboard</para>
264 <indexterm zone="ch-system-kbd setkeycodes">
265 <primary sortas="b-setkeycodes">setkeycodes</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="setleds">
271 <term><command>setleds</command></term>
272 <listitem>
273 <para>Sets the keyboard flags and Light Emitting Diodes (LEDs)</para>
274 <indexterm zone="ch-system-kbd setleds">
275 <primary sortas="b-setleds">setleds</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="setmetamode">
281 <term><command>setmetamode</command></term>
282 <listitem>
283 <para>Defines the keyboard meta-key handling</para>
284 <indexterm zone="ch-system-kbd setmetamode">
285 <primary sortas="b-setmetamode">setmetamode</primary>
286 </indexterm>
287 </listitem>
288 </varlistentry>
289
290 <varlistentry id="showconsolefont">
291 <term><command>showconsolefont</command></term>
292 <listitem>
293 <para>Shows the current EGA/VGA console screen font</para>
294 <indexterm zone="ch-system-kbd showconsolefont">
295 <primary sortas="b-showconsolefont">showconsolefont</primary>
296 </indexterm>
297 </listitem>
298 </varlistentry>
299
300 <varlistentry id="showkey">
301 <term><command>showkey</command></term>
302 <listitem>
303 <para>Reports the scancodes, keycodes, and ASCII codes of the keys
304 pressed on the keyboard</para>
305 <indexterm zone="ch-system-kbd showkey">
306 <primary sortas="b-showkey">showkey</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="unicode_start">
312 <term><command>unicode_start</command></term>
313 <listitem>
314 <para>Puts the keyboard and console in UNICODE mode. Never use it on
315 LFS, because applications are not configured to support UNICODE.</para>
316 <indexterm zone="ch-system-kbd unicode_start">
317 <primary sortas="b-unicode_start">unicode_start</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="unicode_stop">
323 <term><command>unicode_stop</command></term>
324 <listitem>
325 <para>Reverts keyboard and console from UNICODE mode</para>
326 <indexterm zone="ch-system-kbd unicode_stop">
327 <primary sortas="b-unicode_stop">unicode_stop</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 </variablelist>
333
334 </sect2>
335
336</sect1>
Note: See TracBrowser for help on using the repository browser.