source: BOOK/final-system/common/eudev.xml @ 686839b

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

Add screen tags around userinput test commands and remap userinput for test commands as remap="test".

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