From 32324418a08263ee61cb1d8a18747ee7ca09d4c9 Mon Sep 17 00:00:00 2001
From: Matthew Burgess <matthew@linuxfromscratch.org>
Date: Sat, 26 Jun 2004 13:19:14 +0000
Subject: Applied Alexanders descriptions for udev package contents

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3850 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 chapter06/udev.xml | 84 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 82 insertions(+), 2 deletions(-)

(limited to 'chapter06')

diff --git a/chapter06/udev.xml b/chapter06/udev.xml
index 5e2416077..0f1ae802e 100644
--- a/chapter06/udev.xml
+++ b/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>
-- 
cgit v1.2.3-54-g00ecf