source: chapter06/udev.xml@ 227fe23

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 6.4 6.5 6.6 6.7 6.8 7.0 7.1 7.2 7.3 7.4 7.5 7.5-systemd 7.6 7.6-systemd 7.7 7.7-systemd 7.8 7.8-systemd 7.9 7.9-systemd 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since 227fe23 was 2791a8e, checked in by Matthew Burgess <matthew@…>, 17 years ago

Update the list of installed programs and libraries for several packages

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@8125 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 12.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-udev" role="wrap">
9 <?dbhtml filename="udev.html"?>
10
11 <title>Udev-&udev-version;</title>
12
13 <indexterm zone="ch-system-udev">
14 <primary sortas="a-Udev">Udev</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Udev package contains programs for dynamic creation of device
21 nodes.</para>
22
23 <segmentedlist>
24 <segtitle>&buildtime;</segtitle>
25 <segtitle>&diskspace;</segtitle>
26
27 <seglistitem>
28 <seg>&udev-ch6-sbu;</seg>
29 <seg>&udev-ch6-du;</seg>
30 </seglistitem>
31 </segmentedlist>
32
33 </sect2>
34
35 <sect2 role="installation">
36 <title>Installation of Udev</title>
37
38 <para>The udev-config tarball contains LFS-specific files used to configure
39 Udev. Unpack it into the Udev source directory:</para>
40
41<screen><userinput>tar -xvf ../&udev-config;.tar.bz2</userinput></screen>
42
43 <para>Create some devices and directories that Udev cannot handle due to
44 them being required very early in the boot process:</para>
45
46<screen><userinput>install -dv /lib/{firmware,udev/devices/{pts,shm}}
47mknod -m0666 /lib/udev/devices/null c 1 3
48ln -sv /proc/self/fd /lib/udev/devices/fd
49ln -sv /proc/self/fd/0 /lib/udev/devices/stdin
50ln -sv /proc/self/fd/1 /lib/udev/devices/stdout
51ln -sv /proc/self/fd/2 /lib/udev/devices/stderr
52ln -sv /proc/kcore /lib/udev/devices/core</userinput></screen>
53
54 <para>Compile the package:</para>
55
56<screen><userinput>make EXTRAS="`echo extras/*/`"</userinput></screen>
57
58 <variablelist>
59 <title>The meaning of the make option:</title>
60
61 <varlistentry>
62 <term><parameter>EXTRAS=...</parameter></term>
63 <listitem>
64 <para>This builds the helper binaries that can aid in writing custom
65 Udev rules.</para>
66 </listitem>
67 </varlistentry>
68
69 </variablelist>
70
71 <para>To test the results, issue:
72 <userinput>make test</userinput>.</para>
73
74 <para>Note that the Udev testsuite will produce numerous messages in
75 the host system's logs. These are harmless and can be ignored.</para>
76
77 <para>Install the package:</para>
78
79<screen><userinput>make DESTDIR=/ EXTRAS="`echo extras/*/`" install</userinput></screen>
80
81 <variablelist>
82 <title>The meaning of the make parameter:</title>
83
84 <varlistentry>
85 <term><parameter>DESTDIR=/</parameter></term>
86 <listitem>
87 <para>This prevents the Udev build process from killing any
88 <command>udevd</command> processes that may be running on the
89 host system.</para>
90 </listitem>
91 </varlistentry>
92
93 </variablelist>
94
95 <para>Udev has to be configured in order to work properly, as it only
96 installs a few configuration files by default. First install the
97 commonly-used rules files provided by Udev:</para>
98
99<screen><userinput>cp -v etc/udev/rules.d/[0-9]* /etc/udev/rules.d/</userinput></screen>
100
101 <para>Now install the LFS-specific rules files:</para>
102
103<screen><userinput>cd &udev-config;
104make install</userinput></screen>
105
106 <para>Install the documentation that explains the LFS-specific rules
107 files:</para>
108
109<screen><userinput>make install-doc</userinput></screen>
110
111 <para>Install the documentation that explains the commonly-used rules
112 files provided by Udev:</para>
113
114<screen><userinput>make install-extra-doc</userinput></screen>
115
116 <para>Install the documentation that explains how to create custom Udev
117 rules:</para>
118
119<screen><userinput>cd ..
120install -m644 -v docs/writing_udev_rules/index.html \
121 /usr/share/doc/udev-&udev-version;/index.html</userinput></screen>
122
123 </sect2>
124
125 <sect2 id="contents-udev" role="content">
126 <title>Contents of Udev</title>
127
128 <segmentedlist>
129 <segtitle>Installed programs</segtitle>
130 <segtitle>Installed libraries</segtitle>
131 <segtitle>Installed directory</segtitle>
132
133 <seglistitem>
134 <seg>ata_id, cdrom_id, create_floppy_devices, edd_id, firmware.sh,
135 path_id, scsi_id, udevcontrol, udevd, udevinfo, udevmonitor, udevsettle,
136 udevtest, udevtrigger, usb_id, vol_id, write_cd_rules, and
137 write_net_rules</seg>
138 <seg>libvolume_id</seg>
139 <seg>/etc/udev</seg>
140 </seglistitem>
141 </segmentedlist>
142
143 <variablelist>
144 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
145 <?dbfo list-presentation="list"?>
146 <?dbhtml list-presentation="table"?>
147
148 <varlistentry id="ata_id">
149 <term><command>ata_id</command></term>
150 <listitem>
151 <para>Provides Udev with a unique string and
152 additional information (uuid, label) for an ATA drive</para>
153 <indexterm zone="ch-system-udev ata_id">
154 <primary sortas="b-ata_id">ata_id</primary>
155 </indexterm>
156 </listitem>
157 </varlistentry>
158
159 <varlistentry id="cdrom_id">
160 <term><command>cdrom_id</command></term>
161 <listitem>
162 <para>Provides Udev with the capabilities of a
163 CD-ROM or DVD-ROM drive</para>
164 <indexterm zone="ch-system-udev cdrom_id">
165 <primary sortas="b-cdrom_id">cdrom_id</primary>
166 </indexterm>
167 </listitem>
168 </varlistentry>
169
170 <varlistentry id="create_floppy_devices">
171 <term><command>create_floppy_devices</command></term>
172 <listitem>
173 <para>Creates all possible floppy devices based on the CMOS type</para>
174 <indexterm zone="ch-system-udev create_floppy_devices">
175 <primary sortas="b-create_floppy_devices">create_floppy_devices</primary>
176 </indexterm>
177 </listitem>
178 </varlistentry>
179
180 <varlistentry id="edd_id">
181 <term><command>edd_id</command></term>
182 <listitem>
183 <para>Provides Udev with the EDD ID for a BIOS disk drive</para>
184 <indexterm zone="ch-system-udev edd_id">
185 <primary sortas="b-edd_id">edd_id</primary>
186 </indexterm>
187 </listitem>
188 </varlistentry>
189
190 <varlistentry id="firmware.sh">
191 <term><command>firmware.sh</command></term>
192 <listitem>
193 <para>Uploads firmware to devices</para>
194 <indexterm zone="ch-system-udev firmware.sh">
195 <primary sortas="b-firmware.sh">firmware.sh</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="path_id">
201 <term><command>path_id</command></term>
202 <listitem>
203 <para>Provide the shortest possible unique hardware path to a
204 device</para>
205 <indexterm zone="ch-system-udev path_id">
206 <primary sortas="b-path_id">path_id</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry id="scsi_id">
212 <term><command>scsi_id</command></term>
213 <listitem>
214 <para>Provides Udev with a unique SCSI identifier
215 based on the data returned from sending a SCSI INQUIRY command to
216 the specified device</para>
217 <indexterm zone="ch-system-udev scsi_id">
218 <primary sortas="b-scsi_id">scsi_id</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="udevcontrol">
224 <term><command>udevcontrol</command></term>
225 <listitem>
226 <para>Configures a number of options for the running
227 <command>udevd</command> daemon, such as the log level.</para>
228 <indexterm zone="ch-system-udev udevcontrol">
229 <primary sortas="b-udevcontrol">udevcontrol</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="udevd">
235 <term><command>udevd</command></term>
236 <listitem>
237 <para>A daemon that listens for uevents on the netlink socket,
238 creates devices and runs the configured external programs in
239 response to these uevents</para>
240 <indexterm zone="ch-system-udev udevd">
241 <primary sortas="b-udevd">udevd</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="udevinfo">
247 <term><command>udevinfo</command></term>
248 <listitem>
249 <para>Allows users to query the Udev database for
250 information on any device currently present on the system; it also
251 provides a way to query any device in the <systemitem
252 class="filesystem">sysfs</systemitem> tree to help create udev
253 rules</para>
254 <indexterm zone="ch-system-udev udevinfo">
255 <primary sortas="b-udevinfo">udevinfo</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="udevmonitor">
261 <term><command>udevmonitor</command></term>
262 <listitem>
263 <para>Prints the event received from the kernel and the environment
264 which Udev sends out after rule processing</para>
265 <indexterm zone="ch-system-udev udevmonitor">
266 <primary sortas="b-udevmonitor">udevmonitor</primary>
267 </indexterm>
268 </listitem>
269 </varlistentry>
270
271 <varlistentry id="udevsettle">
272 <term><command>udevsettle</command></term>
273 <listitem>
274 <para>Watches the Udev event queue and exits if all current uevents
275 have been handled</para>
276 <indexterm zone="ch-system-udev udevsettle">
277 <primary sortas="b-udevsettle">udevsettle</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 <varlistentry id="udevtest">
283 <term><command>udevtest</command></term>
284 <listitem>
285 <para>Simulates a uevent for the given device, and prints out the
286 name of the node the real <command>udevd</command> would have created,
287 or the name of the renamed network interface</para>
288 <indexterm zone="ch-system-udev udevtest">
289 <primary sortas="b-udevtest">udevtest</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="udevtrigger">
295 <term><command>udevtrigger</command></term>
296 <listitem>
297 <para>Triggers kernel device uevents to be replayed</para>
298 <indexterm zone="ch-system-udev udevtrigger">
299 <primary sortas="b-udevtrigger">udevtrigger</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="usb_id">
305 <term><command>usb_id</command></term>
306 <listitem>
307 <para>Provides Udev with information about USB
308 devices</para>
309 <indexterm zone="ch-system-udev usb_id">
310 <primary sortas="b-usb_id">usb_id</primary>
311 </indexterm>
312 </listitem>
313 </varlistentry>
314
315 <varlistentry id="vol_id">
316 <term><command>vol_id</command></term>
317 <listitem>
318 <para>Provides Udev with the label and uuid of a
319 filesystem</para>
320 <indexterm zone="ch-system-udev vol_id">
321 <primary sortas="b-vol_id">vol_id</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="write_cd_rules">
327 <term><command>write_cd_rules</command></term>
328 <listitem>
329 <para>A script which generates Udev rules to provide stable names for
330 optical drives (see also <xref linkend="ch-scripts-symlinks"/>)</para>
331 <indexterm zone="ch-system-udev write_cd_rules">
332 <primary sortas="b-write_cd_rules">write_cd_rules</primary>
333 </indexterm>
334 </listitem>
335 </varlistentry>
336
337 <varlistentry id="write_net_rules">
338 <term><command>write_net_rules</command></term>
339 <listitem>
340 <para>A script which generates rules to provide stable names for
341 network interfaces (see also <xref linkend="ch-scripts-network"/>)
342 </para>
343 <indexterm zone="ch-system-udev write_net_rules">
344 <primary sortas="b-write_net_rules">write_net_rules</primary>
345 </indexterm>
346 </listitem>
347 </varlistentry>
348
349 <varlistentry id="libvolume_id">
350 <term><command>libvolume_id</command></term>
351 <listitem>
352 <para></para>
353 <indexterm zone="ch-system-udev libvolume_id">
354 <primary sortas="c-libvolume_id">libvolume_id</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="etc-udev">
360 <term><filename class="directory">/etc/udev</filename></term>
361 <listitem>
362 <para>Contains Udev configuation files,
363 device permissions, and rules for device naming</para>
364 <indexterm zone="ch-system-udev etc-udev">
365 <primary sortas="e-/etc/udev">/etc/udev</primary>
366 </indexterm>
367 </listitem>
368 </varlistentry>
369
370 </variablelist>
371
372 </sect2>
373
374</sect1>
Note: See TracBrowser for help on using the repository browser.