source: BOOK/final-system/common/udev.xml @ dcbb278

clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since dcbb278 was dcbb278, checked in by William Harrington <kb0iic@…>, 11 years ago

Add slot rule to eudev install for ethernet device naming.

  • 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-system-udev" role="wrap">
9  <?dbhtml filename="udev.html"?>
10
11  <title>Eudev-&udev-version;</title>
12
13  <indexterm zone="ch-system-udev">
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>./configure --prefix=/usr --sysconfdir=/etc \
31    --with-rootprefix="" --libexecdir=/lib --enable-split-usr \
32    --libdir=/usr/lib --with-rootlibdir=/lib --enable-rule_generator \
33    --disable-introspection --disable-keymap --disable-gudev --enable-libkmod</userinput></screen>
34
35    <para os="c">Compile the package:</para>
36
37<screen os="d"><userinput>make</userinput></screen>
38
39    <para os="e">To test the results, issue: <userinput>make check</userinput>.</para>
40
41    <para os="g">Install the package:</para>
42
43<screen os="h"><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="j"><userinput>install -dv /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> /etc/udev/rules.d/80-net-name-slot.rules</userinput></screen>
54
55  </sect2>
56
57  <sect2 id="contents-udev" 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>/etc/udev, /lib/firmware, /lib/udev, /usr/share/doc/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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev 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-system-udev libudev">
246            <primary sortas="c-libudev">libudev</primary>
247          </indexterm>
248        </listitem>
249      </varlistentry>
250
251      <varlistentry id="etc-udev">
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-system-udev etc-udev">
257            <primary sortas="e-/etc/udev">/etc/udev</primary>
258          </indexterm>
259        </listitem>
260      </varlistentry>
261
262      <varlistentry id="lib-udev">
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-system-udev lib-udev">
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.