source: chapter06/udev.xml@ cf7ba91

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.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 cf7ba91 was 0e038d1b, checked in by Matthew Burgess <matthew@…>, 14 years ago

Don't try to install documentation that was removed in udev-config-20090126.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@9170 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 13.5 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 <sect1info condition="script">
12 <productname>udev</productname>
13 <productnumber>&udev-version;</productnumber>
14 <address>&udev-url;</address>
15 </sect1info>
16
17 <title>Udev-&udev-version;</title>
18
19 <indexterm zone="ch-system-udev">
20 <primary sortas="a-Udev">Udev</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Udev package contains programs for dynamic creation of device
27 nodes.</para>
28
29 <segmentedlist>
30 <segtitle>&buildtime;</segtitle>
31 <segtitle>&diskspace;</segtitle>
32
33 <seglistitem>
34 <seg>&udev-ch6-sbu;</seg>
35 <seg>&udev-ch6-du;</seg>
36 </seglistitem>
37 </segmentedlist>
38
39 </sect2>
40
41 <sect2 role="installation">
42 <title>Installation of Udev</title>
43
44 <para>The udev-config tarball contains LFS-specific files used to configure
45 Udev. Unpack it into the Udev source directory:</para>
46
47<screen><userinput remap="pre">tar -xvf ../&udev-config;.tar.bz2</userinput></screen>
48
49 <para>Create some devices and directories that Udev cannot handle due to
50 them being required very early in the boot process, or by Udev itself:</para>
51
52<screen><userinput remap="install">install -dv /lib/{firmware,udev/devices/{pts,shm}}
53mknod -m0666 /lib/udev/devices/null c 1 3
54ln -sv /proc/self/fd /lib/udev/devices/fd
55ln -sv /proc/self/fd/0 /lib/udev/devices/stdin
56ln -sv /proc/self/fd/1 /lib/udev/devices/stdout
57ln -sv /proc/self/fd/2 /lib/udev/devices/stderr
58ln -sv /proc/kcore /lib/udev/devices/core</userinput></screen>
59
60 <para>Prepare the package for compilation:</para>
61
62<!-- Note that "libdir=/usr/lib64" would be required for multilib. -->
63<screen><userinput remap="configure">./configure --prefix=/usr \
64 --sysconfdir=/etc --sbindir=/sbin \
65 --with-rootlibdir=/lib --libexecdir=/lib/udev \
66 --docdir=/usr/share/doc/udev-&udev-version; \
67 --disable-extras --disable-introspection</userinput></screen>
68
69 <variablelist>
70 <title>The meaning of the new configure options</title>
71
72 <varlistentry>
73 <term><parameter>--with-rootlibdir=/lib</parameter></term>
74 <listitem>
75 <para>This controls where the <filename
76 class="libraryfile">libudev</filename> library is installed. The
77 library needs to be in <filename class="directory">/lib</filename>
78 because it's used by Udev at boot time, before <filename
79 class="directory">/usr</filename> might be available, and the default
80 --rootlibdir is <filename class="directory">/usr/lib</filename>.</para>
81 </listitem>
82 </varlistentry>
83
84 <!-- Note that libexecdir *MUST* stay /lib/udev, even on a 64-bit
85 / multilib system where udev is compiled for 64-bit. Other
86 packages require this exact path; the udev maintainers have
87 said this is part of the udev API. -->
88 <varlistentry>
89 <term><parameter>--libexecdir=/lib/udev</parameter></term>
90 <listitem>
91 <para>This controls where Udev-internal rules and helper programs
92 are installed.</para>
93 </listitem>
94 </varlistentry>
95
96 <varlistentry>
97 <term><parameter>--docdir=/usr/share/doc/udev-&udev-version;</parameter></term>
98 <listitem>
99 <para>This option installs the Udev documentation in the
100 proper location with the naming convention consistent with
101 other packages.</para>
102 </listitem>
103 </varlistentry>
104
105 <varlistentry>
106 <term><parameter>--disable-extras</parameter></term>
107 <listitem>
108 <para>This option prevents Udev from installing helper programs and
109 other extras which require more external libraries. These libraries
110 are not part of the base LFS system. See the Udev
111 <filename>README</filename> file for more information.</para>
112 </listitem>
113 </varlistentry>
114
115 <varlistentry>
116 <term><parameter>--disable-introspection</parameter></term>
117 <listitem>
118 <para>This option prevents Udev's instrospection feature, which
119 requires packages not installed as part of the base LFS system. See
120 the Udev <filename>README</filename> file for more information.</para>
121 </listitem>
122 </varlistentry>
123 </variablelist>
124
125 <para>Compile the package:</para>
126
127<screen><userinput remap="make">make</userinput></screen>
128
129 <para>This package does not come with a test suite.</para>
130
131 <para>Install the package:</para>
132
133<screen><userinput remap="install">make install</userinput></screen>
134
135 <para>Udev has to be configured in order to work properly, as its default
136 configuration does not cover all devices. First install two extra rules
137 files from Udev to help support device-mapper and RAID setups:</para>
138
139<screen><userinput remap="install">install -m644 -v rules/packages/64-*.rules \
140 /lib/udev/rules.d/</userinput></screen>
141
142 <para>Now install a file to create symlinks for certain hand-held devices:</para>
143
144<screen><userinput remap="install">install -m644 -v rules/packages/40-pilot-links.rules \
145 /lib/udev/rules.d/</userinput></screen>
146
147 <para>Now install a file to handle ISDN devices:</para>
148
149<screen><userinput remap="install">install -m644 -v rules/packages/40-isdn.rules \
150 /lib/udev/rules.d/</userinput></screen>
151
152 <!-- There are more files available in the packages/ directory, if we want
153 to consider using them. Most are probably irrelevant to LFS though.
154 "alsa" isn't, but we already have those rules, using a better set of
155 matches. Most of the files in packages/ are for other architectures. -->
156
157 <para>Now install the LFS-specific custom rules files:</para>
158
159<screen><userinput remap="install">cd &udev-config;
160make install</userinput></screen>
161
162 <para>Install the documentation that explains the LFS-specific rules
163 files:</para>
164
165<screen><userinput remap="install">make install-doc</userinput></screen>
166
167 </sect2>
168
169 <sect2 id="contents-udev" role="content">
170 <title>Contents of Udev</title>
171
172 <segmentedlist>
173 <segtitle>Installed programs</segtitle>
174 <segtitle>Installed libraries</segtitle>
175 <segtitle>Installed directory</segtitle>
176
177 <seglistitem>
178 <seg>ata_id, cdrom_id, collect, create_floppy_devices, edd_id,
179 firmware.sh, fstab_import, path_id, scsi_id, udevadm, udevd,
180 usb_id, write_cd_rules, and write_net_rules</seg>
181 <seg>libudev.{a,so}</seg>
182 <seg>/etc/udev</seg>
183 </seglistitem>
184 </segmentedlist>
185
186 <variablelist>
187 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
188 <?dbfo list-presentation="list"?>
189 <?dbhtml list-presentation="table"?>
190
191 <varlistentry id="ata_id">
192 <term><command>ata_id</command></term>
193 <listitem>
194 <para>Provides Udev with a unique string and
195 additional information (uuid, label) for an ATA drive</para>
196 <indexterm zone="ch-system-udev ata_id">
197 <primary sortas="b-ata_id">ata_id</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 <varlistentry id="cdrom_id">
203 <term><command>cdrom_id</command></term>
204 <listitem>
205 <para>Provides Udev with the capabilities of a
206 CD-ROM or DVD-ROM drive</para>
207 <indexterm zone="ch-system-udev cdrom_id">
208 <primary sortas="b-cdrom_id">cdrom_id</primary>
209 </indexterm>
210 </listitem>
211 </varlistentry>
212
213 <varlistentry id="collect">
214 <term><command>collect</command></term>
215 <listitem>
216 <para>Given an ID for the current uevent and a list of
217 IDs (for all target uevents), registers the current ID
218 and indicates whether all target IDs have been registered</para>
219 <indexterm zone="ch-system-udev collect">
220 <primary sortas="b-collect">collect</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="create_floppy_devices">
226 <term><command>create_floppy_devices</command></term>
227 <listitem>
228 <para>Creates all possible floppy devices based on the CMOS type</para>
229 <indexterm zone="ch-system-udev create_floppy_devices">
230 <primary sortas="b-create_floppy_devices">create_floppy_devices</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="edd_id">
236 <term><command>edd_id</command></term>
237 <listitem>
238 <para>Provides Udev with the EDD ID for a BIOS disk drive</para>
239 <indexterm zone="ch-system-udev edd_id">
240 <primary sortas="b-edd_id">edd_id</primary>
241 </indexterm>
242 </listitem>
243 </varlistentry>
244
245 <varlistentry id="firmware.sh">
246 <term><command>firmware.sh</command></term>
247 <listitem>
248 <para>Uploads firmware to devices</para>
249 <indexterm zone="ch-system-udev firmware.sh">
250 <primary sortas="b-firmware.sh">firmware.sh</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 <varlistentry id="fstab_import">
256 <term><command>fstab_import</command></term>
257 <listitem>
258 <para>Finds an entry in <filename>/etc/fstab</filename> that
259 matches the current device, and provides its information to
260 Udev</para>
261 <indexterm zone="ch-system-udev fstab_import">
262 <primary sortas="b-fstab_import">fstab_import</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="path_id">
268 <term><command>path_id</command></term>
269 <listitem>
270 <para>Provides the shortest possible unique hardware path to a
271 device</para>
272 <indexterm zone="ch-system-udev path_id">
273 <primary sortas="b-path_id">path_id</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="scsi_id">
279 <term><command>scsi_id</command></term>
280 <listitem>
281 <para>Provides Udev with a unique SCSI identifier
282 based on the data returned from sending a SCSI INQUIRY command to
283 the specified device</para>
284 <indexterm zone="ch-system-udev scsi_id">
285 <primary sortas="b-scsi_id">scsi_id</primary>
286 </indexterm>
287 </listitem>
288 </varlistentry>
289
290 <varlistentry id="udevadm">
291 <term><command>udevadm</command></term>
292 <listitem>
293 <para>Generic udev administration tool: controls the udevd daemon,
294 provides info from the Udev database, monitors uevents, waits for
295 uevents to finish, tests Udev configuration, and triggers uevents
296 for a given device</para>
297 <indexterm zone="ch-system-udev udevadm">
298 <primary sortas="b-udevadm">udevadm</primary>
299 </indexterm>
300 </listitem>
301 </varlistentry>
302
303 <varlistentry id="udevd">
304 <term><command>udevd</command></term>
305 <listitem>
306 <para>A daemon that listens for uevents on the netlink socket,
307 creates devices and runs the configured external programs in
308 response to these uevents</para>
309 <indexterm zone="ch-system-udev udevd">
310 <primary sortas="b-udevd">udevd</primary>
311 </indexterm>
312 </listitem>
313 </varlistentry>
314
315 <varlistentry id="usb_id">
316 <term><command>usb_id</command></term>
317 <listitem>
318 <para>Provides Udev with information about USB
319 devices</para>
320 <indexterm zone="ch-system-udev usb_id">
321 <primary sortas="b-usb_id">usb_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="libudev">
350 <term><filename class="libraryfile">libudev</filename></term>
351 <listitem>
352 <para>A library interface to udev device information</para>
353 <indexterm zone="ch-system-udev libudev">
354 <primary sortas="c-libudev">libudev</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 configuration 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.