r3848 - in trunk/BOOK: . chapter01 chapter03 chapter06

alexander at linuxfromscratch.org alexander at linuxfromscratch.org
Thu Jun 24 07:27:06 PDT 2004


Author: alexander
Date: 2004-06-24 08:27:04 -0600 (Thu, 24 Jun 2004)
New Revision: 3848

Modified:
   trunk/BOOK/chapter01/changelog.xml
   trunk/BOOK/chapter03/patches.xml
   trunk/BOOK/chapter06/hotplug.xml
   trunk/BOOK/general.ent
Log:
Various hotplug-related changes

Modified: trunk/BOOK/chapter01/changelog.xml
===================================================================
--- trunk/BOOK/chapter01/changelog.xml	2004-06-24 00:33:14 UTC (rev 3847)
+++ trunk/BOOK/chapter01/changelog.xml	2004-06-24 14:27:04 UTC (rev 3848)
@@ -78,6 +78,12 @@
 </itemizedlist>
 </listitem>
 
+<listitem><para>June 24, 2004 [alexander]: Wordings changed on the hotplug
+page</para></listitem>
+
+<listitem><para>June 24, 2004 [alexander]: Removed hotplug isapnp patch for a
+while until bugs are fixed</para></listitem>
+
 <listitem><para>June 23, 2004 [matt]: Removed the note regarding the use of
 GRUB's --no-mem-option</para></listitem>
 

Modified: trunk/BOOK/chapter03/patches.xml
===================================================================
--- trunk/BOOK/chapter03/patches.xml	2004-06-24 00:33:14 UTC (rev 3847)
+++ trunk/BOOK/chapter03/patches.xml	2004-06-24 14:27:04 UTC (rev 3848)
@@ -77,12 +77,14 @@
 </listitem>
 </varlistentry>
 
+<!--
 <varlistentry>
 <term>Hotplug ISAPNP Coldplugging Patch - 1 KB:</term>
 <listitem>
 <para><ulink url="&patches-root;hotplug-&hotplug-version;-isapnp-2.patch"/></para>
 </listitem>
 </varlistentry>
+-->
 
 <varlistentry>
 <term>Inetutils Kernel Headers Patch - 1 KB:</term>

Modified: trunk/BOOK/chapter06/hotplug.xml
===================================================================
--- trunk/BOOK/chapter06/hotplug.xml	2004-06-24 00:33:14 UTC (rev 3847)
+++ trunk/BOOK/chapter06/hotplug.xml	2004-06-24 14:27:04 UTC (rev 3848)
@@ -11,10 +11,11 @@
 
 <sect2 role="package"><title/>
 
-<para>The Hotplug package contains scripts that react upon various changes
-in the kernel state, in particular, addition and removal of hardware. This
-package also detects existing hardware during boot and inserts the relevant
-modules into the running kernel.
+<para>The Hotplug package contains scripts that react upon hotplug events
+generated by the kernel. Such events correspond to every change in the
+in the kernel state visible in the "sysfs" filesystem, e.g., the addition and
+removal of hardware. This package also detects existing hardware during
+boot and inserts the relevant modules into the running kernel.
 </para>
 <segmentedlist>
 <segtitle>&buildtime;</segtitle>
@@ -28,32 +29,35 @@
 <title>Installation of Hotplug</title>
 
 <para>
-Apply the patch that avoids bogus dependencies of the
-<command>usb.rc</command> script
-upon <application>which</application> and
-<application>usbutils</application> packages:
+The <command>usb.rc</command> script provided by the
+<application>Hotplug</application> package depends on the programs 
+<command>usbutils</command> and <command>which</command> being present.
+However, these programs are not called for any useful purpose.
+Apply the patch that removes those dependencies:
 </para>
 
 <screen><userinput>patch -Np1 -i ../hotplug-&hotplug-version;-bogus_deps-1.patch</userinput></screen>
 
 <para>
-USB coldplugging is somewhat broken in Hotplug by default. Fix this with the
-following patch:
+USB coldplugging is somewhat broken in <application>Hotplug</application>
+by default: the DEVICE environment variable is not passed to user-defined USB
+hotplug handlers. Fix this with the following patch:
 </para>
 
 <screen><userinput>patch -Np1 -i ../hotplug-&hotplug-version;-device-2.patch</userinput></screen>
 
+<!-- Waiting for hotplug-2004_04_01-isapnp-4.patch
 <para>
-At last, there is an optional patch that adds ISAPNP hardware detection
-capabilities to Hotplug. It is not well tested. If you chose to apply it,
-run the following command:
+There is an optional patch that adds ISAPNP hardware detection
+capabilities to Hotplug. It is not well tested and in fact contains known
+bugs. If you chose to apply it, run the following command:
 </para>
 
 <screen><userinput>patch -Np1 -i ../hotplug-&hotplug-version;-isapnp-2.patch</userinput></screen>
+-->
 
+<para>Now install the Hotplug package:</para>
 
-<para>And finally install the Hotplug package:</para>
-
 <screen><userinput>make install</userinput></screen>
 
 <para>Remove Hotplug's not-so-clean init script, since we're going to be using
@@ -61,6 +65,11 @@
 
 <screen><userinput>rm -rf /etc/init.d</userinput></screen>
 
+<para>Network device hotplugging is not supported by LFS bootscripts yet. For
+that reason, remove the network hotplug agent:</para>
+
+<screen><userinput>rm -f /etc/hotplug/net.agent</userinput></screen>
+<!-- Will be useless with version 4 of the isapnp patch
 <para>
 If you have applied the ISAPNP patch, add some required entries to
 <filename>/etc/modprobe.conf</filename>:</para>
@@ -81,7 +90,7 @@
 <para>These entries may not be needed in newer versions of the Linux kernel,
 since Marco d'Itri will try to convince developers to put them into the
 corresponding modules themselves.</para>
-
+-->
 </sect2>
 
 
@@ -109,8 +118,8 @@
 They are called by the <filename>hotplug</filename> initscript that comes
 from the lfs-bootscripts package.
 The <command>*.rc</command>
-scripts try to find kernel modules corresponding to your hardware and insert
-them into the running kernel.
+scripts try to recover hotplug events that were lost during system boot
+because, e.g., the root filesystem was not mounted by the kernel.
 </para>
 </listitem>
 </varlistentry>
@@ -179,7 +188,7 @@
 <indexterm zone="ch-system-hotplug hotplug-hotplug.d"><primary
 sortas="e-/etc/hotplug.d">/etc/hotplug.d</primary></indexterm>
 <para>This directory contains programs (or symlinks to them)
-that are interested in receiving all hotplug events. E.g.,
+that are interested in receiving hotplug events. E.g.,
 <application>udev</application> puts its symlink here during installation.
 </para>
 </listitem>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2004-06-24 00:33:14 UTC (rev 3847)
+++ trunk/BOOK/general.ent	2004-06-24 14:27:04 UTC (rev 3848)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
-<!ENTITY version "SVN-20040623">
-<!ENTITY releasedate "June 23, 2004">
+<!ENTITY version "SVN-20040624">
+<!ENTITY releasedate "June 24, 2004">
 <!ENTITY milestone "6.0">
 
 <!ENTITY lfs-root "http://www.linuxfromscratch.org/">




More information about the lfs-book mailing list