source: BOOK/boot/common/eudev.xml@ a988b8e

clfs-3.0.0-systemd systemd
Last change on this file since a988b8e was a988b8e, checked in by Chris Staub <chris@…>, 10 years ago

More consistent indentation

  • Property mode set to 100644
File size: 9.6 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-boot-eudev" role="wrap">
9 <?dbhtml filename="eudev.html"?>
10
11 <title>Eudev-&eudev-version;</title>
12
13 <indexterm zone="ch-boot-eudev">
14 <primary sortas="a-Eudev">Eudev</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Eudev package contains programs for dynamic creation of device
21 nodes.</para>
22
23 </sect2>
24
25 <sect2 role="installation">
26 <title>Installation of Eudev</title>
27
28 <para os="a">Prepare Eudev for compilation:</para>
29
30<screen os="b"><userinput>BLKID_CFLAGS="-I/tools/include" BLKID_LIBS="-L/tools/lib -lblkid" \
31 KMOD_CFLAGS="-I/tools/include/" KMOD_LIBS="-L/tools/lib -lkmod" \
32 ./configure --prefix=/tools --build=${CLFS_HOST} --host=${CLFS_TARGET} \
33 --disable-introspection --disable-gtk-doc-html \
34 --disable-gudev --disable-keymap --with-firmware-path=/lib/firmware \
35 --enable-libkmod</userinput></screen>
36
37 <para os="c">Compile the package:</para>
38
39<screen os="d"><userinput>make</userinput></screen>
40
41 <para os="g">Install the package:</para>
42
43<screen os="j"><userinput>make install</userinput></screen>
44
45 <para os="i">Create a directory for storing firmware that can be
46 loaded by <command>udev</command>:</para>
47
48<screen os="k"><userinput>install -dv /tools/lib/firmware</userinput></screen>
49
50 <para os="r1">Create a dummy rule so that Eudev will name ethernet devices properly for the system.</para>
51
52<screen os="r2"><userinput>echo "# dummy, so that network is once again on eth*" > \
53 /tools/etc/udev/rules.d/80-net-name-slot.rules</userinput></screen>
54
55 </sect2>
56
57 <sect2 id="contents-eudev" role="content">
58 <title>Contents of Eudev</title>
59
60 <segmentedlist>
61 <segtitle>Installed programs</segtitle>
62 <segtitle>Installed library</segtitle>
63 <segtitle>Installed directories</segtitle>
64
65 <seglistitem>
66 <seg>ata_id, cdrom_id, collect, create_floppy_devices, edd_id,
67 firmware.sh, fstab_import, path_id, scsi_id, udevadm, udevd, usb_id,
68 v4l_id, write_cd_rules, write_net_rules</seg>
69 <seg>libudev</seg>
70 <seg>/tools/etc/udev, /tools/lib/firmware, /tools/lib/udev</seg>
71 </seglistitem>
72 </segmentedlist>
73
74 <variablelist>
75 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
76 <?dbfo list-presentation="list"?>
77 <?dbhtml list-presentation="table"?>
78
79 <varlistentry id="udevadm">
80 <term><command>udevadm</command></term>
81 <listitem>
82 <para>Controls the runtime behavior of Eudev, requests kernel
83 events, manages the event queue, and provides simple debugging.</para>
84 <indexterm zone="ch-boot-eudev udevadm">
85 <primary sortas="b-udevadm">udevadm</primary>
86 </indexterm>
87 </listitem>
88 </varlistentry>
89
90 <varlistentry id="udevd">
91 <term><command>udevd</command></term>
92 <listitem>
93 <para>A daemon that reorders hotplug events before submitting them to
94 <command>udev</command>,
95 thus avoiding various race conditions</para>
96 <indexterm zone="ch-boot-eudev udevd">
97 <primary sortas="b-udevd">udevd</primary>
98 </indexterm>
99 </listitem>
100 </varlistentry>
101
102 <!-- Start of Helpers -->
103 <varlistentry id="ata_id">
104 <term><command>ata_id</command></term>
105 <listitem>
106 <para>Provides Eudev with a unique string and additional
107 information (uuid, label) for an ATA drive</para>
108 <indexterm zone="ch-boot-eudev ata_id">
109 <primary sortas="b-ata_id">ata_id</primary>
110 </indexterm>
111 </listitem>
112 </varlistentry>
113
114 <varlistentry id="cdrom_id">
115 <term><command>cdrom_id</command></term>
116 <listitem>
117 <para>Prints the capabilities of a CDROM or DVDROM drive.</para>
118 <indexterm zone="ch-boot-eudev cdrom_id">
119 <primary sortas="b-cdrom_id">cdrom_id</primary>
120 </indexterm>
121 </listitem>
122 </varlistentry>
123
124 <varlistentry id="collect">
125 <term><command>collect</command></term>
126 <listitem>
127 <para>Given an ID for the current uevent and a list of IDs
128(for all target uevents), registers the current ID and indicates whether
129all target IDs have been registered.</para>
130 <indexterm zone="ch-boot-eudev collect">
131 <primary sortas="b-collect">collect</primary>
132 </indexterm>
133 </listitem>
134 </varlistentry>
135
136 <varlistentry id="create_floppy_devices">
137 <term><command>create_floppy_devices</command></term>
138 <listitem>
139 <para>Creates all possible floppy devices based on the CMOS type</para>
140 <indexterm zone="ch-boot-eudev create_floppy_devices">
141 <primary sortas="b-create_floppy_devices">create_floppy_devices</primary>
142 </indexterm>
143 </listitem>
144 </varlistentry>
145
146 <varlistentry id="edd_id">
147 <term><command>edd_id</command></term>
148 <listitem>
149 <para>Identifies x86 disk drives from Enhanced Disk Drive calls</para>
150 <indexterm zone="ch-boot-eudev edd_id">
151 <primary sortas="b-edd_id">edd_id</primary>
152 </indexterm>
153 </listitem>
154 </varlistentry>
155
156 <varlistentry id="firmware.sh">
157 <term><command>firmware.sh</command></term>
158 <listitem>
159 <para>Script to load firmware for a device</para>
160 <indexterm zone="ch-boot-eudev firmware.sh">
161 <primary sortas="b-firmware.sh">firmware.sh</primary>
162 </indexterm>
163 </listitem>
164 </varlistentry>
165
166 <varlistentry id="fstab_import">
167 <term><command>fstab_import</command></term>
168 <listitem>
169 <para>Finds an entry in <filename>/etc/fstab</filename> that matches
170the current device, and provides its information to Udev.</para>
171 <indexterm zone="ch-boot-eudev fstab_import">
172 <primary sortas="b-fstab_import">fstab_import</primary>
173 </indexterm>
174 </listitem>
175 </varlistentry>
176
177 <varlistentry id="path_id">
178 <term><command>path_id</command></term>
179 <listitem>
180 <para>Provides the shortest possible unique hardware path to a
181 device</para>
182 <indexterm zone="ch-boot-eudev path_id">
183 <primary sortas="b-path_id">path_id</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="scsi_id">
189 <term><command>scsi_id</command></term>
190 <listitem>
191 <para>Retrieves or generates a unique SCSI identifier.</para>
192 <indexterm zone="ch-boot-eudev scsi_id">
193 <primary sortas="b-scsi_id">scsi_id</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="usb_id">
199 <term><command>usb_id</command></term>
200 <listitem>
201 <para>Identifies a USB block device.</para>
202 <indexterm zone="ch-boot-eudev usb_id">
203 <primary sortas="b-usb_id">usb_id</primary>
204 </indexterm>
205 </listitem>
206 </varlistentry>
207
208 <varlistentry id="v4l_id">
209 <term><command>v4l_id</command></term>
210 <listitem>
211 <para>Determines V4L capabilities for a given device.</para>
212 <indexterm zone="ch-boot-eudev v4l_id">
213 <primary sortas="b-v4l_id">v4l_id</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="write_cd_rules">
219 <term><command>write_cd_rules</command></term>
220 <listitem>
221 <para>A script which generates Eudev rules to provide stable names
222for network interfaces.</para>
223 <indexterm zone="ch-boot-eudev write_cd_rules">
224 <primary sortas="b-write_cd_rules">write_cd_rules</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="write_net_rules">
230 <term><command>write_net_rules</command></term>
231 <listitem>
232 <para>A script which generates Eudev rules to provide stable names
233for network interfaces.</para>
234 <indexterm zone="ch-boot-eudev write_net_rules">
235 <primary sortas="b-write_net_rules">write_net_rules</primary>
236 </indexterm>
237 </listitem>
238 </varlistentry>
239<!-- End of Helpers -->
240
241 <varlistentry id="libudev">
242 <term><filename class="libraryfile">libudev</filename></term>
243 <listitem>
244 <para>A library interface to eudev device information.</para>
245 <indexterm zone="ch-boot-eudev libudev">
246 <primary sortas="c-libudev">libudev</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 <varlistentry id="etc-eudev">
252 <term><filename class="directory">/etc/udev</filename></term>
253 <listitem>
254 <para>Contains <command>udev</command> configuration files,
255 device permissions, and rules for device naming</para>
256 <indexterm zone="ch-boot-eudev etc-eudev">
257 <primary sortas="e-/etc/udev">/etc/udev</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="lib-eudev">
263 <term><filename class="directory">/lib/udev</filename></term>
264 <listitem>
265 <para>Contains <command>udev</command> helper programs
266 and static devices which get copied to /dev when booted.</para>
267 <indexterm zone="ch-boot-eudev lib-eudev">
268 <primary sortas="e-/lib/udev">/lib/udev</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272 </variablelist>
273
274 </sect2>
275
276</sect1>
Note: See TracBrowser for help on using the repository browser.