Applied Alexanders descriptions for udev package contents

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3850 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

chapter01/changelog.xml

@@ -78,6 +78,9 @@ first a summary, then a detailed log.</para>
 </itemizedlist>
 </listitem>
 
+<listitem><para>June 26, 2004 [matt]: Added descriptions for udev package
+contents (Alexander Patrakov)</para></listitem>
+
 <listitem><para>June 24, 2004 [winkie]: Upgraded to Linux-Libc-Headers 2.6.7.0
 and updated the Net-tools GCC 3.4 patch.</para></listitem>
 

chapter05/udev.xml

@@ -12,9 +12,7 @@
 <secondary>tools</secondary></indexterm>
 
 <sect2 role="package"><title/>
-<!--
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/udev.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
- -->
 
 <segmentedlist>
 <segtitle>&buildtime;</segtitle>

chapter06/udev.xml

@@ -10,6 +10,7 @@
 <indexterm zone="ch-system-udev"><primary sortas="a-Udev">Udev</primary></indexterm>
 
 <sect2 role="package"><title/>
+<para>The Udev package contains programs for dynamic creation of device nodes.</para>
 
 <segmentedlist>
 <segtitle>&buildtime;</segtitle>
@@ -46,8 +47,87 @@ cp ../udev-config-1.rules /etc/udev/rules.d/00-lfs.rules</userinput></screen>
 
 
 <sect2 id="contents-udev" role="content"><title>Contents of Udev</title>
-<para>Who knows?</para>
-</sect2>
 
+<segmentedlist>
+<segtitle>Installed programs</segtitle>
+<seglistitem><seg>udev, udevd, udevsend, udevstart, udevinfo, udevtest</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><title>Short descriptions</title>
+                                                                                
+<varlistentry id="udev">
+<term><command>udev</command></term>
+<listitem><indexterm zone="ch-system-udev udev"><primary
+sortas="b-udev">udev</primary></indexterm>
+<para>is used to create device nodes in <filename
+class="directory">/dev</filename> or to rename network interfaces (not in LFS)
+in response to hotplug events.</para>
+</listitem></varlistentry>
+
+<varlistentry id="udevd">
+<term><command>udevd</command></term>
+<listitem> <indexterm zone="ch-system-udev udevd"><primary
+sortas="b-udevd">udevd</primary></indexterm>
+<para>is a daemon that reorders hotplug events before submitting them to
+<command>udev</command>,
+thus avoiding various race conditions.</para>
+</listitem></varlistentry>
+
+<varlistentry id="udevsend">
+<term><command>udevsend</command></term>
+<listitem> <indexterm zone="ch-system-udev udevsend"><primary
+sortas="b-udevsend">udevsend</primary></indexterm>
+<para>is used to deliver hotplug events to <command>udevd</command>.</para>
+</listitem></varlistentry>
+
+<varlistentry id="udevstart">
+<term><command>udevstart</command></term>
+<listitem> <indexterm zone="ch-system-udev udevstart"><primary
+sortas="b-udevstart">udevstart</primary></indexterm>
+<para>is used to create device nodes in <filename
+class="directory">/dev</filename> that correspond to drivers compiled directly
+into the kernel. It performs that task by simulating hotplug events presumably
+dropped by the kernel before invocation of this program (e.g. because the root
+filesystem has not been mounted) and submitting such synthetic hotplug events
+to <command>udev</command>.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="udevinfo">
+<term><command>udevinfo</command></term>
+<listitem> <indexterm zone="ch-system-udev udevinfo"><primary
+sortas="b-udevinfo">udevinfo</primary></indexterm>
+<para>allows users to query the <command>udev</command> database for
+information on any device currently present on the system. It also
+provides a way to query any device in the sysfs tree to help creating udev
+rules.</para>
+</listitem></varlistentry>
+
+<varlistentry id="udevtest">
+<term><command>udevtest</command></term>
+<listitem> <indexterm zone="ch-system-udev udevtest"><primary
+sortas="b-udevtest">udevtest</primary></indexterm>
+<para>simulates a <command>udev</command> run for the given device,
+and prints out the name of the node the real <command>udev</command> would
+have created, or (not in LFS) the name of the renamed network interface.</para>
+</listitem></varlistentry>
+
+<varlistentry id="etc-dev-d">
+<term><filename class="directory">/etc/dev.d</filename></term>
+<listitem> <indexterm zone="ch-system-udev etc-dev-d"><primary
+sortas="b-etc-dev-d">/etc/dev.d</primary></indexterm>
+<para>directory is supposed to contain user-written handlers for device
+creation hotplug events.</para>
+</listitem></varlistentry>
+
+<varlistentry id="etc-udev">
+<term><filename class="directory">/etc/udev</filename></term>
+<listitem> <indexterm zone="ch-system-udev etc-udev"><primary
+sortas="b-etc-udev">/etc/udev</primary></indexterm>
+<para>directory contains <command>udev</command> configuation files,
+device permissions and rules for device naming.</para>
+</listitem></varlistentry>
+</variablelist>
+</sect2>
 
 </sect1>

general.ent

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
-<!ENTITY version "SVN-20040624">
-<!ENTITY releasedate "June 24, 2004">
+<!ENTITY version "SVN-20040626">
+<!ENTITY releasedate "June 26, 2004">
 <!ENTITY milestone "6.0">
 
 <!ENTITY lfs-root "http://www.linuxfromscratch.org/">