chapter06/eudev.xml

   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>Next, 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"
  56 HAVE_BLKID=1
  57 BLKID_LIBS="-lblkid"
  58 BLKID_CFLAGS="-I/tools/include"
  59 EOF</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
  80 below are needed to allow the use of libraries that were installed in /tools,
  81 but have not yet been installed in the main system.  LIBRARY_PATH is
  82 used to find libraries during the linking process.  LD_LIBRARY_PATH is
  83 used to find libraries during program execution.</para></note>
  84
  85 <para>Create some directories now that are needed for tests, but
  86 will also be used as a part of installation:</para>
  87
  88 <screen><userinput remap="test">mkdir -pv /lib/udev/rules.d
  89 mkdir -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
 103 make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen>
 104
 105   </sect2>
 106
 107   <sect2 id="conf-eudev" role="configuration">
 108     <title>Configuring Eudev</title>
 109
 110     <indexterm zone="conf-eudev">
 111       <primary sortas="a-Eudev">Eudev</primary>
 112       <secondary>configuring</secondary>
 113     </indexterm>
 114
 115     <indexterm zone="conf-eudev">
 116       <primary sortas="e-/etc/udev/hwdb.bin">/etc/udev/hwdb.bin</primary>
 117     </indexterm>
 118
 119     <para>Information about hardware devices is maintained in the
 120     <filename class="directory">/etc/udev/hwdb.d</filename> and
 121     <filename class="directory">/lib/udev/hwdb.d</filename> directories.
 122     <application>Eudev</application> needs that information to be compiled
 123     into a binary database <filename>/etc/udev/hwdb.bin</filename>. Create the
 124     initial database:</para>
 125
 126 <screen><userinput>LD_LIBRARY_PATH=/tools/lib udevadm hwdb --update</userinput></screen>
 127
 128     <para>This command needs to be run each time the hardware information is
 129     updated.</para>
 130
 131   </sect2>
 132
 133   <sect2 id="contents-eudev" role="content">
 134     <title>Contents of Eudev</title>
 135
 136     <segmentedlist>
 137       <segtitle>Installed programs</segtitle>
 138       <segtitle>Installed libraries</segtitle>
 139       <segtitle>Installed directories</segtitle>
 140
 141       <seglistitem>
 142         <seg><!-- These are in /lib/udev and not to be called by the user:
 143          accelerometer, ata_id, cdrom_id, collect, mtd_probe,
 144          scsi_id, v4l_id,--> udevadm and udevd</seg>
 145
 146         <seg>libudev.so</seg>
 147
 148         <seg>/etc/udev, /lib/udev, and /usr/share/doc/udev-&udev-lfs-version;</seg>
 149       </seglistitem>
 150     </segmentedlist>
 151
 152     <variablelist>
 153       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 154       <?dbfo list-presentation="list"?>
 155       <?dbhtml list-presentation="table"?>
 156       <varlistentry id="udevadm" revision="sysv">
 157         <term><command>udevadm</command></term>
 158         <listitem>
 159           <para>Generic udev administration tool: controls the udevd daemon,
 160           provides info from the Udev database, monitors uevents, waits for
 161           uevents to finish, tests Udev configuration, and triggers uevents
 162           for a given device</para>
 163           <indexterm zone="ch-system-eudev udevadm">
 164             <primary sortas="b-udevadm">udevadm</primary>
 165           </indexterm>
 166         </listitem>
 167       </varlistentry>
 168
 169       <varlistentry id="udevd">
 170         <term><command>udevd</command></term>
 171         <listitem>
 172           <para>A daemon that listens for uevents on the netlink socket,
 173           creates devices and runs the configured external programs in
 174           response to these uevents</para>
 175           <indexterm zone="ch-system-eudev udevd">
 176             <primary sortas="b-udevd">udevd</primary>
 177           </indexterm>
 178         </listitem>
 179       </varlistentry>
 180
 181       <varlistentry id="libudev">
 182         <term><filename class="libraryfile">libudev</filename></term>
 183         <listitem>
 184           <para>A library interface to udev device information</para>
 185           <indexterm zone="ch-system-eudev libudev">
 186             <primary sortas="c-libudev">libudev</primary>
 187           </indexterm>
 188         </listitem>
 189       </varlistentry>
 190
 191       <varlistentry id="etc-udev">
 192         <term><filename class="directory">/etc/udev</filename></term>
 193         <listitem>
 194           <para>Contains Udev configuration files,
 195           device permissions, and rules for device naming</para>
 196           <indexterm zone="ch-system-eudev etc-udev">
 197             <primary sortas="e-/etc/udev">/etc/udev</primary>
 198           </indexterm>
 199         </listitem>
 200       </varlistentry>
 201
 202     </variablelist>
 203
 204   </sect2>
 205
 206 </sect1>