source: chapter06/udev.xml@ 39ec01c

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 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 39ec01c was 6b13ebc6, checked in by Bruce Dubbs <bdubbs@…>, 12 years ago

Remove oblolete references to consolelog
Reformat udev configure command

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@9726 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 12.0 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 </sect2>
39
40 <sect2 role="installation">
41 <title>Installation of Udev</title>
42
43 <para>The udev-config tarball contains LFS-specific files used to configure
44 Udev. Unpack it into the Udev source directory:</para>
45
46<screen><userinput remap="pre">tar -xvf ../&udev-config;.tar.bz2</userinput></screen>
47
48 <para>Create some devices and directories that Udev cannot handle due to
49 them being required very early in the boot process, or by Udev itself:</para>
50
51<screen><userinput remap="install">install -dv /lib/{firmware,udev/devices/pts}
52mknod -m0666 /lib/udev/devices/null c 1 3</userinput></screen>
53
54 <para>Prepare the package for compilation:</para>
55
56<!-- Note that "libdir=/usr/lib64" would be required for multilib. -->
57<screen><userinput remap="configure">BLKID_CFLAGS="-I/usr/include/blkid" \
58BLKID_LIBS="-L/lib -lblkid" \
59KMOD_CFLAGS="-I/usr/include" \
60KMOD_LIBS="-L/lib -lkmod" \
61./configure --prefix=/usr \
62 --with-rootprefix='' \
63 --bindir=/sbin \
64 --sysconfdir=/etc \
65 --libexecdir=/lib \
66 --enable-rule_generator \
67 --disable-introspection \
68 --disable-keymap \
69 --disable-gudev \
70 --with-usb-ids-path=no \
71 --with-pci-ids-path=no \
72 --with-systemdsystemunitdir=no</userinput></screen>
73
74 <variablelist>
75 <title>The meaning of the new configure options</title>
76
77 <!-- Note that libexecdir *MUST* stay /lib, even on a 64-bit
78 / multilib system where udev is compiled for 64-bit. The udev
79 configure system automatically adds "udev" onto this path, and other
80 packages require /lib/udev; the udev maintainers have
81 said this is part of the udev API. -->
82 <varlistentry>
83 <term><parameter>--libexecdir=/lib</parameter></term>
84 <listitem>
85 <para>This controls where Udev-internal rules and helper programs
86 are installed.</para>
87 </listitem>
88 </varlistentry>
89
90 <varlistentry>
91 <term><parameter>--enable-rule_generator</parameter></term>
92 <listitem>
93 <para>This allows persistent rules to be generated for network and
94 optical media devices</para>
95 </listitem>
96 </varlistentry>
97
98 <varlistentry>
99 <term><parameter>--disable-* and --with-*</parameter></term>
100 <listitem>
101 <para>These options prevent Udev from installing helper programs and
102 other extras which require more external libraries. These libraries
103 are not part of the base LFS system. See the Udev
104 <filename>README</filename> file for more information.</para>
105 </listitem>
106 </varlistentry>
107 </variablelist>
108
109 <para>Compile the package:</para>
110
111<screen><userinput remap="make">make</userinput></screen>
112
113 <para>Test the package.</para>
114
115<screen><userinput remap="test">make check</userinput></screen>
116
117 <para>Install the package:</para>
118
119<screen><userinput remap="install">make install</userinput></screen>
120
121 <para>Remove an empty documentation directory:</para>
122
123<screen><userinput remap="install">rmdir -v /usr/share/doc/udev</userinput></screen>
124
125 <para>Now install the LFS-specific custom rules files:</para>
126
127<screen><userinput remap="install">cd &udev-config;
128make install</userinput></screen>
129
130 <para>Install the documentation that explains the LFS-specific rules
131 files:</para>
132
133<screen><userinput remap="install">make install-doc</userinput></screen>
134
135 </sect2>
136
137 <sect2 id="contents-udev" role="content">
138 <title>Contents of Udev</title>
139
140 <segmentedlist>
141 <segtitle>Installed programs</segtitle>
142 <segtitle>Installed libraries</segtitle>
143 <segtitle>Installed directories</segtitle>
144
145 <seglistitem>
146 <seg>ata_id, cdrom_id, collect, create_floppy_devices, edd_id,
147 firmware.sh, fstab_import, path_id, scsi_id, udevadm, udevd,
148 usb_id, write_cd_rules, and write_net_rules</seg>
149 <seg>libudev.{a,so}</seg>
150 <seg>/etc/udev, /lib/udev, /lib/firmware, /usr/share/doc/udev-config,
151 /usr/share/gtk-doc/html/libudev</seg>
152 </seglistitem>
153 </segmentedlist>
154
155 <variablelist>
156 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
157 <?dbfo list-presentation="list"?>
158 <?dbhtml list-presentation="table"?>
159
160 <varlistentry id="ata_id">
161 <term><command>ata_id</command></term>
162 <listitem>
163 <para>Provides Udev with a unique string and
164 additional information (uuid, label) for an ATA drive</para>
165 <indexterm zone="ch-system-udev ata_id">
166 <primary sortas="b-ata_id">ata_id</primary>
167 </indexterm>
168 </listitem>
169 </varlistentry>
170
171 <varlistentry id="cdrom_id">
172 <term><command>cdrom_id</command></term>
173 <listitem>
174 <para>Provides Udev with the capabilities of a
175 CD-ROM or DVD-ROM drive</para>
176 <indexterm zone="ch-system-udev cdrom_id">
177 <primary sortas="b-cdrom_id">cdrom_id</primary>
178 </indexterm>
179 </listitem>
180 </varlistentry>
181
182 <varlistentry id="collect">
183 <term><command>collect</command></term>
184 <listitem>
185 <para>Given an ID for the current uevent and a list of
186 IDs (for all target uevents), registers the current ID
187 and indicates whether all target IDs have been registered</para>
188 <indexterm zone="ch-system-udev collect">
189 <primary sortas="b-collect">collect</primary>
190 </indexterm>
191 </listitem>
192 </varlistentry>
193
194 <varlistentry id="create_floppy_devices">
195 <term><command>create_floppy_devices</command></term>
196 <listitem>
197 <para>Creates all possible floppy devices based on the CMOS type</para>
198 <indexterm zone="ch-system-udev create_floppy_devices">
199 <primary sortas="b-create_floppy_devices">create_floppy_devices</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="edd_id">
205 <term><command>edd_id</command></term>
206 <listitem>
207 <para>Provides Udev with the EDD ID for a BIOS disk drive</para>
208 <indexterm zone="ch-system-udev edd_id">
209 <primary sortas="b-edd_id">edd_id</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="firmware.sh">
215 <term><command>firmware.sh</command></term>
216 <listitem>
217 <para>Uploads firmware to devices</para>
218 <indexterm zone="ch-system-udev firmware.sh">
219 <primary sortas="b-firmware.sh">firmware.sh</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="fstab_import">
225 <term><command>fstab_import</command></term>
226 <listitem>
227 <para>Finds an entry in <filename>/etc/fstab</filename> that
228 matches the current device, and provides its information to
229 Udev</para>
230 <indexterm zone="ch-system-udev fstab_import">
231 <primary sortas="b-fstab_import">fstab_import</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="path_id">
237 <term><command>path_id</command></term>
238 <listitem>
239 <para>Provides the shortest possible unique hardware path to a
240 device</para>
241 <indexterm zone="ch-system-udev path_id">
242 <primary sortas="b-path_id">path_id</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="scsi_id">
248 <term><command>scsi_id</command></term>
249 <listitem>
250 <para>Provides Udev with a unique SCSI identifier
251 based on the data returned from sending a SCSI INQUIRY command to
252 the specified device</para>
253 <indexterm zone="ch-system-udev scsi_id">
254 <primary sortas="b-scsi_id">scsi_id</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="udevadm">
260 <term><command>udevadm</command></term>
261 <listitem>
262 <para>Generic udev administration tool: controls the udevd daemon,
263 provides info from the Udev database, monitors uevents, waits for
264 uevents to finish, tests Udev configuration, and triggers uevents
265 for a given device</para>
266 <indexterm zone="ch-system-udev udevadm">
267 <primary sortas="b-udevadm">udevadm</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="udevd">
273 <term><command>udevd</command></term>
274 <listitem>
275 <para>A daemon that listens for uevents on the netlink socket,
276 creates devices and runs the configured external programs in
277 response to these uevents</para>
278 <indexterm zone="ch-system-udev udevd">
279 <primary sortas="b-udevd">udevd</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="usb_id">
285 <term><command>usb_id</command></term>
286 <listitem>
287 <para>Provides Udev with information about USB
288 devices</para>
289 <indexterm zone="ch-system-udev usb_id">
290 <primary sortas="b-usb_id">usb_id</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 <varlistentry id="write_cd_rules">
296 <term><command>write_cd_rules</command></term>
297 <listitem>
298 <para>A script which generates Udev rules to provide stable names for
299 optical drives (see also <xref linkend="ch-scripts-symlinks"/>)</para>
300 <indexterm zone="ch-system-udev write_cd_rules">
301 <primary sortas="b-write_cd_rules">write_cd_rules</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="write_net_rules">
307 <term><command>write_net_rules</command></term>
308 <listitem>
309 <para>A script which generates rules to provide stable names for
310 network interfaces (see also <xref linkend="ch-scripts-network"/>)
311 </para>
312 <indexterm zone="ch-system-udev write_net_rules">
313 <primary sortas="b-write_net_rules">write_net_rules</primary>
314 </indexterm>
315 </listitem>
316 </varlistentry>
317
318 <varlistentry id="libudev">
319 <term><filename class="libraryfile">libudev</filename></term>
320 <listitem>
321 <para>A library interface to udev device information</para>
322 <indexterm zone="ch-system-udev libudev">
323 <primary sortas="c-libudev">libudev</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="etc-udev">
329 <term><filename class="directory">/etc/udev</filename></term>
330 <listitem>
331 <para>Contains Udev configuration files,
332 device permissions, and rules for device naming</para>
333 <indexterm zone="ch-system-udev etc-udev">
334 <primary sortas="e-/etc/udev">/etc/udev</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 </variablelist>
340
341 </sect2>
342
343</sect1>
Note: See TracBrowser for help on using the repository browser.