source: BOOK/final-system/common/eudev.xml@ 5ca6d3b

clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 5ca6d3b was ddd9fa5, checked in by William Harrington <kb0iic@…>, 11 years ago

Fix typo.

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