r6099 - in trunk/BOOK: general/genlib introduction/welcome postlfs/config

bdubbs at linuxfromscratch.org bdubbs at linuxfromscratch.org
Wed May 17 08:56:09 PDT 2006


Author: bdubbs
Date: 2006-05-17 09:56:07 -0600 (Wed, 17 May 2006)
New Revision: 6099

Added:
   trunk/BOOK/postlfs/config/devices.xml
Modified:
   trunk/BOOK/general/genlib/libusb.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/postlfs/config/config.xml
Log:
Added 'About Devices' page.

Modified: trunk/BOOK/general/genlib/libusb.xml
===================================================================
--- trunk/BOOK/general/genlib/libusb.xml	2006-05-17 15:08:55 UTC (rev 6098)
+++ trunk/BOOK/general/genlib/libusb.xml	2006-05-17 15:56:07 UTC (rev 6099)
@@ -161,6 +161,7 @@
 SUBSYSTEM=="usb_device", GROUP="usb" 
 EOF</literal></screen>
 
+<!--
     <para>Fine-tuning of permissions is also possible by creating extra rules,
     matching on something like this (on one line).  The vendor and product can
     be found by searchng the <filename
@@ -177,6 +178,7 @@
     file.  This is not normally needed.</para>
 
 <screen><literal>usbfs  /proc/bus/usb  usbfs  devgid=14,devmode=0660  0  0</literal></screen>
+-->
 
   </sect2>
 

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2006-05-17 15:08:55 UTC (rev 6098)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2006-05-17 15:56:07 UTC (rev 6099)
@@ -45,6 +45,9 @@
       <para>May 17th, 2006</para>
       <itemizedlist>
         <listitem>
+          <para>[bdubbs] - Added "About Devices" page.</para>
+        </listitem>
+        <listitem>
           <para>[dnicholson] - Added two patches to Cdrtools improving its
           use in locales with non-ISO-8859-1 character sets.  Fixes ticket
           #1837. Thanks to Alexander Patrakov for explaining the situation

Modified: trunk/BOOK/postlfs/config/config.xml
===================================================================
--- trunk/BOOK/postlfs/config/config.xml	2006-05-17 15:08:55 UTC (rev 6098)
+++ trunk/BOOK/postlfs/config/config.xml	2006-05-17 15:56:07 UTC (rev 6099)
@@ -42,6 +42,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bootdisk.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="skel.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="users.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="devices.xml"/>
   <!-- <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="inputrc.xml"/> -->
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="profile.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="vimrc.xml"/>

Copied: trunk/BOOK/postlfs/config/devices.xml (from rev 6092, trunk/BOOK/postlfs/config/users.xml)
===================================================================
--- trunk/BOOK/postlfs/config/devices.xml	                        (rev 0)
+++ trunk/BOOK/postlfs/config/devices.xml	2006-05-17 15:56:07 UTC (rev 6099)
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+
+<sect1 id="postlfs-devices" xreflabel="About Devices">
+  <?dbhtml filename="devices.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>About Devices</title>
+
+  <indexterm zone="postlfs-devices">
+    <primary sortas="e-etc-udev-rules">/etc/udev/rules.d</primary>
+  </indexterm>
+
+
+  <para>Although most devices needed by packages in BLFS and beyond are set up
+  properly by <application>udev</application> using the default rules installed
+  by LFS in <filename class="directory">/etc/udev/rules.d</filename>, there are
+  cases where the rules must be modified or augmented.</para>
+
+  <para condition="html" role="usernotes">User Notes:
+  <ulink url="&blfs-wiki;/aboutdevices"/></para>
+
+  <sect2>
+    <title>Multiple Sound Cards</title>
+
+    <para>If there are multiple sound cards in a system, the "default" 
+    sound card becomes random.  The method to establish sound card order 
+    depends on whether the drivers are modules or not.  If the sound card 
+    drivers are compiled into the kernel, control is via kernel command line
+    parameters in <filename>/boot/grib/menu.lst</filename>.  For example,
+    if a system has both an FM801 card and a SoundBlaster PCI card, the 
+    following can be appended to the command line:</para>
+
+<screen><literal>snd-fm801.index=0 snd-ens1371.index=1</literal></screen>
+
+    <para>If the sound card drivers are built as modules, the order can be
+    established in the <filename>/etc/modprobe.conf</filename> file
+    with:</para>
+
+<screen><literal>options snd-fm801 index=0
+options snd-ens1371 index=1</literal></screen>
+
+  </sect2>
+
+  <sect2>
+    <title>Udev Device Attrubutes</title>
+    
+    <para>Fine-tuning of device attributes such as group name and permissions
+    is possible by creating extra <application>udev</application> rules,
+    matching on something like this (on one line). The vendor and product can
+    be found by searchng the /sys/devices directory entries or using
+    <command>udevinfo</command> after the device has been attached. See the
+    documentation in the current <application>udev</application>  directory of
+    <filename class='directory'>/usr/share/doc</filename> for details.</para>
+          
+<screen><literal>SUBSYSTEM=="usb_device", SYSFS{idVendor}=="05d8", 
+   SYSFS{idProduct}=="4002", GROUP:="scanner", MODE:="0640"</literal></screen>
+  
+  </sect2>
+
+  <sect2>
+    <title>USB Device Issues</title>
+ 
+    <para>Some older applications, such as <application>VMware</application>,
+    need the following deprecated entry in the <filename>/etc/fstab</filename>
+    file. This is not normally needed.</para>
+
+<screen><literal>usbfs  /proc/bus/usb  usbfs  devgid=14,devmode=0660  0  0</literal></screen>
+
+  </sect2>
+
+<!--
+  <sect2>
+    <title>Multiple Network Interfaces</title>
+
+
+  </sect2>
+-->
+
+  <sect2>
+    <title>Devices for Servers</title>
+
+    <para>In some cases, it makes sense to disable
+    <application>udev</application> completely and create static devices.
+    Servers are one example of this situation.  Does a server need the
+    capability of handling dynamic devices?  Only the system administrator can
+    answer that question, but in many cases the answer will be no.</para>
+
+    <para>If dynamic devices are not desired, then static devices must be
+    created on the system.  In the default configuration, the
+    <filename>/etc/rc.d/rcsysinit.d/S10udev</filename> boot script mounts a
+    <systemitem class="filesystem">tmpfs</systemitem> partition over the
+    <filename class="directory">/dev</filename> directory.  This problem can be
+    overcome by mounting the root partition temporarily:</para>
+
+    <warning><para>If the instructions below are not followed carefully, your
+    system could become unbootable.</para></warning>
+    
+
+<screen><userinput>mount --bind / /mnt
+cp -a /dev/* /mnt/dev
+rm /etc/rc.d/rcsysinit.d/{S10udev,S45udev_retry}
+umount /mnt</userinput></screen>
+
+    <para>At this point, the system will use static devices upon the next
+    reboot.  Create any desired additional devices using
+    <command>mknod</command>.</para>
+    
+    <para>If you want to restore the dynamic devices, recreate the
+    <filename>/etc/rc.d/rcsysinit.d/{S10udev,S45udev_retry}</filename> symbolic
+    links and reboot again.  Static devices do not need to be removed (console
+    and null are always needed) because they are covered by the <systemitem
+    class="filesystem">tmpfs</systemitem> partition.  Disk usage for devices is
+    negligible (about 20–30 bytes per entry.)</para>
+
+  </sect2>
+
+</sect1>




More information about the blfs-book mailing list