source: general/sysutils/udev-extras.xml@ 3e072580

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY eudev-download-http "http://dev.gentoo.org/~blueness/eudev/eudev-&eudev-version;.tar.gz">
  <!ENTITY eudev-download-ftp  " ">
  <!ENTITY eudev-md5sum        "80649a0350ff9620fc2da9562d9f2a6a">
  <!ENTITY eudev-size          "1.7 MB">
  <!ENTITY eudev-buildsize     "23 MB">
  <!ENTITY eudev-time          "0.3 SBU">
]>

<sect1 id="udev-extras" xreflabel="udev-extras (from eudev)">
  <?dbhtml filename="udev-extras.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Udev Extras (from eudev)</title>

  <indexterm zone="udev-extras">
    <primary sortas="a-udev-extras">udev extras (from eudev)</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Udev Extras</title>

    <para>Udev was installed as a part of eudev in LFS. However, not
    all components were installed due to dependencies that were unavailable.
    This procedure adds those missing components.</para>

    <!-- &lfs75_checked; -->

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <caution>
      <para>
         If you are using the development version of BLFS, the Eudev version
         on this page may be higher than the one you used for building LFS.
         Newer versions of Eudev may occasionally be incompatible with former
         ones, either because they require some new options to be enabled
         in the kernel or because they change the way rules are parsed. You
         may want to consult
         <ulink url="http:wiki.gentoo.org/wiki/Udev/upgrade">the Gentoo
         page</ulink> about upgrading Udev. Another alternative is
         to run the instructions below with the Eudev version on your
         current system.
      </para>
    </caution>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&eudev-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&eudev-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &eudev-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &eudev-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &eudev-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &eudev-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Udev Extras Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="glib2"/>
    </para>

    <bridgehead renderas="sect4">Optional Dependencies</bridgehead>
    <para role="optional">
      <xref linkend="gobject-introspection"/> (for gir-data, needed for Gnome),
      <xref linkend="docbook-xsl"/> and <xref linkend="libxslt"/> (to build
      man pages, which are not shipped with the package), and
      <xref linkend="gtk-doc"/> (to rebuild the documentation)
    </para>

    <bridgehead renderas="sect4">Optional Runtime Dependencies</bridgehead>
    <para role="optional">
      <xref linkend="pciutils"/> and
      <xref linkend="usbutils"/>
    </para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/udev-extras"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Udev Extras</title>

    <para>First, re-build eudev:</para>

<screen><userinput>sed    -i '/struct ucred/i struct ucred;' src/libudev/util.h &amp;&amp;
sed -r -i 's|/usr(/bin/test)|\1|'         test/udev-test.pl  &amp;&amp;

./configure --prefix=/usr           \
            --bindir=/sbin          \
            --sbindir=/sbin         \
            --libdir=/usr/lib       \
            --sysconfdir=/etc       \
            --libexecdir=/lib       \
            --with-rootprefix=      \
            --with-rootlibdir=/lib  \
            --enable-split-usr      \
            --enable-libkmod        \
            --enable-rule_generator \
            --enable-keymap         \
            --disable-introspection \
            --disable-gtk-doc-html  \
            --with-firmware-path=/lib/firmware &amp;&amp;

make</userinput></screen>

   <para>To test the results, issue: <command>make check</command>.</para>

   <para>Now re-install as the <systemitem class="username">root</systemitem> 
   user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <parameter>--disable-introspection</parameter>: This prevents the
      gir-data instructions from running.  Remove this option if the optional
      <xref linkend="gobject-introspection"/> package is installed.
    </para>

    <para>
      <parameter>--disable-gtk-doc-html</parameter>: This prevents the
      building of the html data.  Remove this option if the optional
      <xref linkend="gtk-doc"/> package is installed.
    </para>

  </sect2> 

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>None</seg>

        <seg>libgudev-1.0.so</seg>

        <seg>/usr/include/gudev-1.0/gudev,
             /usr/lib/girepository-1.0,
             /usr/share/gir-1.0, and
             /usr/share/gtk-doc/html/gudev (optional)</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="libgudev-1.0-systemd">
        <term><filename class='libraryfile'>libgudev-1.0.so</filename></term>
        <listitem>
          <para>is a GObject-based wrapper library for libudev.</para>
          <indexterm zone="udev-extras libgudev-1.0-systemd">
            <primary sortas="c-libgudev-1.0-systemd">libgudev-1.0.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>