source: chapter06/eudev.xml@ 01ffc23

multilib-10.1
Last change on this file since 01ffc23 was 01ffc23, checked in by Thomas Trepl <thomas@…>, 5 years ago

Merge changes from trunk

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/multilib@11606 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 9.2 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" revision="sysv">
9 <?dbhtml filename="eudev.html"?>
10
11 <sect1info condition="script">
12 <productname>eudev</productname>
13 <productnumber>&eudev-version;</productnumber>
14 <address>&eudev-url;</address>
15 </sect1info>
16
17 <title>Eudev-&eudev-version;</title>
18
19 <indexterm zone="ch-system-eudev">
20 <primary sortas="a-Eudev">Eudev</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Eudev package contains programs for dynamic creation of device
27 nodes.</para>
28
29 <segmentedlist>
30 <segtitle>&buildtime;</segtitle>
31 <segtitle>&diskspace;</segtitle>
32
33 <seglistitem>
34 <seg>&eudev-ch6-sbu;</seg>
35 <seg>&eudev-ch6-du;</seg>
36 </seglistitem>
37 </segmentedlist>
38 </sect2>
39
40 <sect2 role="installation">
41 <title>Installation of Eudev</title>
42<!--
43 <para>First, fix a test script:</para>
44
45<screen><userinput remap="pre">sed -r -i 's|/usr(/bin/test)|\1|' test/udev-test.pl</userinput></screen>
46-->
47<!--
48 <para>Next, remove an unneeded line that causes a build failure:</para>
49
50<screen><userinput remap="pre">sed -i '/keyboard_lookup_key/d' src/udev/udev-builtin-keyboard.c</userinput></screen>
51-->
52 <para>First, add a workaround to prevent the /tools directory from being
53 hard coded into Eudev binary files library locations:</para>
54
55<screen><userinput remap="pre">cat &gt; config.cache &lt;&lt; "EOF"
56HAVE_BLKID=1
57BLKID_LIBS="-lblkid"
58BLKID_CFLAGS="-I/tools/include"
59EOF</userinput></screen>
60
61<para>Prepare Eudev for compilation:</para>
62
63<screen><userinput remap="configure">./configure --prefix=/usr \
64 --bindir=/sbin \
65 --sbindir=/sbin \
66 --libdir=/usr/lib \
67 --sysconfdir=/etc \
68 --libexecdir=/lib \
69 --with-rootprefix= \
70 --with-rootlibdir=/lib \
71 --enable-manpages \
72 --disable-static \
73 --config-cache</userinput></screen>
74
75<para>Compile the package:</para>
76
77<screen><userinput remap="make">LIBRARY_PATH=/tools/lib make</userinput></screen>
78
79<note><para>The LIBRARY_PATH variable here and the LD_LIBRARY_PATH variable
80below are needed to allow the use of libraries that were installed in /tools,
81but have not yet been installed in the main system. LIBRARY_PATH is
82used to find libraries during the linking process. LD_LIBRARY_PATH is
83used to find libraries during program execution.</para></note>
84
85<para>Create some directories now that are needed for tests, but
86will also be used as a part of installation:</para>
87
88<screen><userinput remap="test">mkdir -pv /lib/udev/rules.d
89mkdir -pv /etc/udev/rules.d</userinput></screen>
90
91<para>To test the results, issue:</para>
92
93<screen><userinput remap="test">make LD_LIBRARY_PATH=/tools/lib check</userinput></screen>
94
95 <para>Install the package:</para>
96
97<screen><userinput remap="install">make LD_LIBRARY_PATH=/tools/lib install</userinput></screen>
98
99 <para>Install some custom rules and support files useful in an LFS
100 environment:</para>
101
102<screen><userinput remap="install">tar -xvf ../&udev-lfs-version;.tar.bz2
103make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen>
104
105 </sect2>
106
107 <!-- ~~~~~~~~~~~~~~~~~~~~ ABI 32 ~~~~~~~~~~~~~~~~~~~~ -->
108
109 <sect2 arch="ml_32,ml_all" role="installation">
110 <title>Installation of Eudev - 32-bit</title>
111
112 <para>Clean previous build:</para>
113
114<screen><userinput remap="pre">make distclean</userinput></screen>
115
116 <para>Prepare Eudev for compilation:</para>
117
118<screen><userinput remap="configure">CC="gcc -m32" \
119./configure --host=i686-pc-linux-gnu \
120 --prefix=/usr \
121 --bindir=/sbin \
122 --sbindir=/sbin \
123 --libdir=/usr/lib32 \
124 --sysconfdir=/etc \
125 --libexecdir=/lib32 \
126 --with-rootprefix= \
127 --with-rootlibdir=/usr/lib32 \
128 --disable-manpages \
129 --disable-static \
130 --config-cache</userinput></screen>
131
132 <para>Compile the package:</para>
133
134<screen><userinput remap="make">make</userinput></screen>
135
136 <para>Install the package:</para>
137
138<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
139cp -Rv DESTDIR/usr/lib32/* /usr/lib32
140rm -rf DESTDIR</userinput></screen>
141
142 </sect2>
143
144 <!-- ~~~~~~~~~~~~~~~~~~~~ ABI x32 ~~~~~~~~~~~~~~~~~~~~ -->
145
146 <sect2 arch="ml_x32,ml_all" role="installation">
147 <title>Installation of Eudev - x32-bit</title>
148
149 <para>Clean previous build:</para>
150
151<screen><userinput remap="pre">make distclean</userinput></screen>
152
153 <para>Prepare Eudev for compilation:</para>
154
155<screen><userinput remap="configure">CC="gcc -mx32" \
156./configure --prefix=/usr \
157 --bindir=/sbin \
158 --sbindir=/sbin \
159 --libdir=/usr/libx32 \
160 --sysconfdir=/etc \
161 --libexecdir=/libx32 \
162 --with-rootprefix= \
163 --with-rootlibdir=/usr/libx32 \
164 --disable-manpages \
165 --disable-static \
166 --config-cache</userinput></screen>
167
168 <para>Compile the package:</para>
169
170<screen><userinput remap="make">make</userinput></screen>
171
172 <para>Install the package:</para>
173
174<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
175cp -Rv DESTDIR/usr/libx32/* /usr/libx32
176rm -rf DESTDIR</userinput></screen>
177
178 </sect2>
179
180 <sect2 id="conf-eudev" role="configuration">
181 <title>Configuring Eudev</title>
182
183 <indexterm zone="conf-eudev">
184 <primary sortas="a-Eudev">Eudev</primary>
185 <secondary>configuring</secondary>
186 </indexterm>
187
188 <indexterm zone="conf-eudev">
189 <primary sortas="e-/etc/udev/hwdb.bin">/etc/udev/hwdb.bin</primary>
190 </indexterm>
191
192 <para>Information about hardware devices is maintained in the
193 <filename class="directory">/etc/udev/hwdb.d</filename> and
194 <filename class="directory">/lib/udev/hwdb.d</filename> directories.
195 <application>Eudev</application> needs that information to be compiled
196 into a binary database <filename>/etc/udev/hwdb.bin</filename>. Create the
197 initial database:</para>
198
199<screen><userinput>LD_LIBRARY_PATH=/tools/lib udevadm hwdb --update</userinput></screen>
200
201 <para>This command needs to be run each time the hardware information is
202 updated.</para>
203
204 </sect2>
205
206 <sect2 id="contents-eudev" role="content">
207 <title>Contents of Eudev</title>
208
209 <segmentedlist>
210 <segtitle>Installed programs</segtitle>
211 <segtitle>Installed libraries</segtitle>
212 <segtitle>Installed directories</segtitle>
213
214 <seglistitem>
215 <seg><!-- These are in /lib/udev and not to be called by the user:
216 accelerometer, ata_id, cdrom_id, collect, mtd_probe,
217 scsi_id, v4l_id,--> udevadm and udevd</seg>
218
219 <seg>libudev.so</seg>
220
221 <seg>/etc/udev, /lib/udev, and /usr/share/doc/udev-&udev-lfs-version;</seg>
222 </seglistitem>
223 </segmentedlist>
224
225 <variablelist>
226 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
227 <?dbfo list-presentation="list"?>
228 <?dbhtml list-presentation="table"?>
229 <varlistentry id="udevadm" revision="sysv">
230 <term><command>udevadm</command></term>
231 <listitem>
232 <para>Generic udev administration tool: controls the udevd daemon,
233 provides info from the Udev database, monitors uevents, waits for
234 uevents to finish, tests Udev configuration, and triggers uevents
235 for a given device</para>
236 <indexterm zone="ch-system-eudev udevadm">
237 <primary sortas="b-udevadm">udevadm</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="udevd">
243 <term><command>udevd</command></term>
244 <listitem>
245 <para>A daemon that listens for uevents on the netlink socket,
246 creates devices and runs the configured external programs in
247 response to these uevents</para>
248 <indexterm zone="ch-system-eudev udevd">
249 <primary sortas="b-udevd">udevd</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="libudev">
255 <term><filename class="libraryfile">libudev</filename></term>
256 <listitem>
257 <para>A library interface to udev device information</para>
258 <indexterm zone="ch-system-eudev libudev">
259 <primary sortas="c-libudev">libudev</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="etc-udev">
265 <term><filename class="directory">/etc/udev</filename></term>
266 <listitem>
267 <para>Contains Udev configuration files,
268 device permissions, and rules for device naming</para>
269 <indexterm zone="ch-system-eudev etc-udev">
270 <primary sortas="e-/etc/udev">/etc/udev</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 </variablelist>
276
277 </sect2>
278
279</sect1>
Note: See TracBrowser for help on using the repository browser.