source: final-system/common/udev.xml@ be205bc2

Last change on this file since be205bc2 was bf8c11f, checked in by Jim Gifford <clfs@…>, 19 years ago

r627@server (orig r625): jim | 2005-10-31 12:59:34 -0800
Import of Cross-LFS Book

  • Property mode set to 100644
File size: 7.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 <!ENTITY % patches-entities SYSTEM "../../patches.ent">
6 %general-entities;
7 %patches-entities;
8]>
9
10<sect1 id="ch-system-udev" role="wrap">
11 <?dbhtml filename="udev.html"?>
12
13 <title>Udev-&udev-version;</title>
14
15 <indexterm zone="ch-system-udev">
16 <primary sortas="a-Udev">Udev</primary>
17 </indexterm>
18
19 <sect2 role="package">
20 <title/>
21
22 <para>The Udev package contains programs for dynamic creation of device
23 nodes.</para>
24
25 <segmentedlist>
26 <segtitle>&buildtime;</segtitle>
27 <segtitle>&diskspace;</segtitle>
28
29 <seglistitem>
30 <seg>Not checked yet</seg>
31 <seg>Not checked yet</seg>
32 </seglistitem>
33 </segmentedlist>
34
35 <segmentedlist>
36 <segtitle>&dependencies;</segtitle>
37
38 <seglistitem>
39 <seg>Coreutils and Make</seg>
40 </seglistitem>
41 </segmentedlist>
42
43 </sect2>
44
45 <sect2 role="installation">
46 <title>Installation of Udev</title>
47
48 <para os="c">Compile the package:</para>
49
50<screen><userinput>make EXTRAS="extras/firmware extras/run_directory" udevdir=/dev</userinput></screen>
51
52 <variablelist os="d">
53 <title>The meaning of the make parameter:</title>
54
55 <varlistentry>
56 <term><parameter>udevdir=/dev</parameter></term>
57 <listitem>
58 <para>This tells <command>udev</command> in which directory
59 devices nodes are to be created.</para>
60 </listitem>
61 </varlistentry>
62
63 </variablelist>
64
65 <para os="e">To test the results, issue:
66 <userinput>make test</userinput>.</para>
67
68 <para os="f">Install the package:</para>
69
70<screen os="g"><userinput>make EXTRAS="extras/firmware extras/run_directory" udevdir=/dev install</userinput></screen>
71
72 <para os="h">Udev's configuration is far from ideal by default, so install
73 the configuration files here:</para>
74
75<screen os="i"><userinput>cp ../&udev-config-file; /etc/udev/rules.d/25-lfs.rules</userinput></screen>
76
77 <para os="a">Install the documentation that explains how to create
78 Udev rules:</para>
79
80<screen os="b"><userinput>install -m644 -D docs/writing_udev_rules/index.html /usr/share/doc/udev-&udev-version;/index.html</userinput></screen>
81
82 <para os="j">Run the <command>udevstart</command> program to create our full
83 complement of device nodes.</para>
84
85<screen os="k"><userinput>/sbin/udevstart</userinput></screen>
86
87 </sect2>
88
89 <sect2 id="contents-udev" role="content">
90 <title>Contents of Udev</title>
91
92 <segmentedlist>
93 <segtitle>Installed programs</segtitle>
94 <segtitle>Installed directory</segtitle>
95
96 <seglistitem>
97 <seg>udev, udevcontrol, udevd, udevinfo, udevmonitor, udevsend,
98 udevstart and udevtest</seg>
99 <seg>/etc/udev</seg>
100 </seglistitem>
101 </segmentedlist>
102
103 <variablelist>
104 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
105 <?dbfo list-presentation="list"?>
106 <?dbhtml list-presentation="table"?>
107
108 <varlistentry id="udev">
109 <term><command>udev</command></term>
110 <listitem>
111 <para>Creates device nodes in <filename
112 class="directory">/dev</filename> or renames network interfaces (not
113 in LFS) in response to hotplug events</para>
114 <indexterm zone="ch-system-udev udev">
115 <primary sortas="b-udev">udev</primary>
116 </indexterm>
117 </listitem>
118 </varlistentry>
119
120 <varlistentry id="udevcontrol">
121 <term><command>udevcontrol</command></term>
122 <listitem>
123 <para>Configures a number of options for the running
124 <command>udevd</command> daemon, such as the log level.</para>
125 <indexterm zone="ch-system-udev udevcontrol">
126 <primary sortas="b-udevcontrol">udevcontrol</primary>
127 </indexterm>
128 </listitem>
129 </varlistentry>
130
131 <varlistentry id="udevd">
132 <term><command>udevd</command></term>
133 <listitem>
134 <para>A daemon that reorders hotplug events before submitting them to
135 <command>udev</command>,
136 thus avoiding various race conditions</para>
137 <indexterm zone="ch-system-udev udevd">
138 <primary sortas="b-udevd">udevd</primary>
139 </indexterm>
140 </listitem>
141 </varlistentry>
142
143 <varlistentry id="udevinfo">
144 <term><command>udevinfo</command></term>
145 <listitem>
146 <para>Allows users to query the <command>udev</command> database for
147 information on any device currently present on the system; it also
148 provides a way to query any device in the <systemitem
149 class="filesystem">sysfs</systemitem> tree to help create udev
150 rules</para>
151 <indexterm zone="ch-system-udev udevinfo">
152 <primary sortas="b-udevinfo">udevinfo</primary>
153 </indexterm>
154 </listitem>
155 </varlistentry>
156
157 <varlistentry id="udevmonitor">
158 <term><command>udevmonitor</command></term>
159 <listitem>
160 <para>Prints the event received from the kernel and the event which
161 <command>udev</command> sends out after rule processing</para>
162 <indexterm zone="ch-system-udev udevmonitor">
163 <primary sortas="b-udevmonitor">udevmonitor</primary>
164 </indexterm>
165 </listitem>
166 </varlistentry>
167
168 <varlistentry id="udevsend">
169 <term><command>udevsend</command></term>
170 <listitem>
171 <para>Delivers hotplug events to <command>udevd</command></para>
172 <indexterm zone="ch-system-udev udevsend">
173 <primary sortas="b-udevsend">udevsend</primary>
174 </indexterm>
175 </listitem>
176 </varlistentry>
177
178 <varlistentry id="udevstart">
179 <term><command>udevstart</command></term>
180 <listitem>
181 <para>Creates device nodes in <filename class="directory">/dev</filename>
182 that correspond to drivers compiled directly into the kernel; it
183 performs that task by simulating hotplug events presumably dropped by
184 the kernel before invocation of this program (e.g., because the root
185 filesystem has not been mounted) and submitting such synthetic hotplug
186 events to <command>udev</command></para>
187 <indexterm zone="ch-system-udev udevstart">
188 <primary sortas="b-udevstart">udevstart</primary>
189 </indexterm>
190 </listitem>
191 </varlistentry>
192
193 <varlistentry id="udevtest">
194 <term><command>udevtest</command></term>
195 <listitem>
196 <para>Simulates a <command>udev</command> run for the given device,
197 and prints out the name of the node the real <command>udev</command>
198 would have created or (not in LFS) the name of the renamed network
199 interface</para>
200 <indexterm zone="ch-system-udev udevtest">
201 <primary sortas="b-udevtest">udevtest</primary>
202 </indexterm>
203 </listitem>
204 </varlistentry>
205
206 <varlistentry id="etc-udev">
207 <term><filename class="directory">/etc/udev</filename></term>
208 <listitem>
209 <para>Contains <command>udev</command> configuation files,
210 device permissions, and rules for device naming</para>
211 <indexterm zone="ch-system-udev etc-udev">
212 <primary sortas="e-/etc/udev">/etc/udev</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 </variablelist>
218
219 </sect2>
220
221</sect1>
Note: See TracBrowser for help on using the repository browser.