r6111 - in trunk/BOOK: . general/sysutils introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sat May 20 07:03:41 PDT 2006


Author: randy
Date: 2006-05-20 08:03:40 -0600 (Sat, 20 May 2006)
New Revision: 6111

Added:
   trunk/BOOK/general/sysutils/usbutils.xml
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/sysutils/pciutils.xml
   trunk/BOOK/general/sysutils/sysutils.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
Log:
Added new package usbutils-0.72

Modified: trunk/BOOK/general/sysutils/pciutils.xml
===================================================================
--- trunk/BOOK/general/sysutils/pciutils.xml	2006-05-18 22:50:04 UTC (rev 6110)
+++ trunk/BOOK/general/sysutils/pciutils.xml	2006-05-20 14:03:40 UTC (rev 6111)
@@ -108,11 +108,17 @@
     updated. To get a current version of this file, run
     <command>update-pciids</command> as the <systemitem
     class="username">root</systemitem> user. This program requires the
-    <xref linkend='which'/> script or program to find <xref linkend='wget'/>
-    or <xref linkend='lynx'/> which are used to fetch the most current file,
-    and then replace the existing file in
+    <xref linkend='which'/> script or program to find <xref linkend='curl'/>,
+    <xref linkend='wget'/> or <xref linkend='lynx'/> which are used to
+    download the most current file, and then replace the existing file in
     <filename class='directory'>/usr/share</filename>.</para>
 
+    <para>You may wish to add an entry to
+    <systemitem class="username">root</systemitem>'s (or any other user who
+    has write privilege to <filename class='directory'>/usr/share</filename>)
+    crontab to automatically update the <filename>pci.ids</filename> file
+    periodically.</para>
+
   </sect2>
 
   <sect2 role="content">
@@ -120,8 +126,8 @@
 
     <segmentedlist>
       <segtitle>Installed Programs</segtitle>
-      <segtitle>Installed Libraries</segtitle>
-      <segtitle>Installed Directories</segtitle>
+      <segtitle>Installed Library</segtitle>
+      <segtitle>Installed Directory</segtitle>
 
       <seglistitem>
         <seg>lspci, setpci and update-pciids</seg>
@@ -160,7 +166,8 @@
         <term><command>update-pciids</command></term>
         <listitem>
           <para>fetches the current version of the PCI ID list. Requires
-          <xref linkend="wget"/> or <xref linkend="lynx"/>.</para>
+          <xref linkend="curl"/>, <xref linkend="wget"/> or
+          <xref linkend="lynx"/>.</para>
           <indexterm zone="pciutils update-pciids">
             <primary sortas="b-update-pciids">update-pciids</primary>
           </indexterm>

Modified: trunk/BOOK/general/sysutils/sysutils.xml
===================================================================
--- trunk/BOOK/general/sysutils/sysutils.xml	2006-05-18 22:50:04 UTC (rev 6110)
+++ trunk/BOOK/general/sysutils/sysutils.xml	2006-05-20 14:03:40 UTC (rev 6111)
@@ -21,6 +21,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="unzip.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="zip.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pciutils.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="usbutils.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pkgconfig.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="cpio.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mc.xml"/>

Added: trunk/BOOK/general/sysutils/usbutils.xml
===================================================================
--- trunk/BOOK/general/sysutils/usbutils.xml	                        (rev 0)
+++ trunk/BOOK/general/sysutils/usbutils.xml	2006-05-20 14:03:40 UTC (rev 6111)
@@ -0,0 +1,166 @@
+<?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;
+
+  <!ENTITY usbutils-download-http "http://prdownloads.sourceforge.net/linux-usb/usbutils-&usbutils-version;.tar.gz">
+  <!ENTITY usbutils-download-ftp  " ">
+  <!ENTITY usbutils-md5sum        "ee345fe605ffcfce843dae4aed81122b">
+  <!ENTITY usbutils-size          "166 KB">
+  <!ENTITY usbutils-buildsize     "1.6 MB">
+  <!ENTITY usbutils-time          "less than 0.1 SBU">
+]>
+
+<sect1 id="usbutils" xreflabel="usbutils-&usbutils-version;">
+  <?dbhtml filename="usbutils.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+    <keywordset>
+      <keyword role="package">usbutils-&usbutils-version;.tar</keyword>
+      <keyword role="ftpdir">usbutils</keyword>
+    </keywordset>
+  </sect1info>
+
+  <title>usbutils-&usbutils-version;</title>
+
+  <indexterm zone="usbutils">
+    <primary sortas="a-usbutils">usbutils</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to usbutils</title>
+
+    <para>The <application>usbutils</application> package contains a utility
+    used to display information about USB buses in the system and the devices
+    connected to them.</para>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&usbutils-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&usbutils-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &usbutils-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &usbutils-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &usbutils-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &usbutils-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">usbutils Dependencies</bridgehead>
+    
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required"><xref linkend="libusb"/></para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/usbutils"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of usbutils</title>
+
+    <para>Install <application>usbutils</application> by
+    running the following commands:</para>
+
+<screen><userinput>sed -i 's|DEST=|&/usr/share/|' update-usbids.sh &&
+./configure --prefix=/usr &&
+make</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &&
+install -v -m755 update-usbids.sh /usr/sbin/update-usbids</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><command>sed -i '...' update-usbids.sh</command>: This command is
+    used to modify the download script so that it will replace the existing
+    file in <filename class='directory'>/usr/share</filename> instead of in
+    the current directory.</para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring usbutils</title>
+
+    <para>The <filename>usb.ids</filename> data file is constantly being
+    updated. To get a current version of this file, run
+    <command>update-usbids</command> as the <systemitem
+    class="username">root</systemitem> user. This program requires the
+    <xref linkend='which'/> script or program to find <xref linkend='wget'/>
+    or <xref linkend='lynx'/> which are used to download the most current file,
+    and replace the existing file in
+    <filename class='directory'>/usr/share</filename>.</para>
+
+    <para>You may wish to add an entry to
+    <systemitem class="username">root</systemitem>'s (or any other user who
+    has write privilege to <filename class='directory'>/usr/share</filename>)
+    crontab to automatically update the <filename>usb.ids</filename> file
+    periodically.</para>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>lsusb and update-usbids</seg>
+        <seg>None</seg>
+        <seg>None</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="lsusb">
+        <term><command>lsusb</command></term>
+        <listitem>
+          <para>is a utility for displaying information about all USB buses in the
+          system and all devices connected to them.</para>
+          <indexterm zone="usbutils lsusb">
+            <primary sortas="b-lsusb">lsusb</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="update-usbids">
+        <term><command>update-usbids</command></term>
+        <listitem>
+          <para>downloads the current version of the USB ID list. Requires
+          <xref linkend="wget"/> or <xref linkend="lynx"/>.</para>
+          <indexterm zone="usbutils update-usbids">
+            <primary sortas="b-update-usbids">update-usbids</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/general/sysutils/usbutils.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2006-05-18 22:50:04 UTC (rev 6110)
+++ trunk/BOOK/general.ent	2006-05-20 14:03:40 UTC (rev 6111)
@@ -1,4 +1,4 @@
-<!ENTITY day          "19">                   <!-- Always 2 digits -->
+<!ENTITY day          "20">                   <!-- Always 2 digits -->
 <!ENTITY month        "05">                   <!-- Always 2 digits -->
 <!ENTITY year         "2006">
 <!ENTITY version      "svn-&year;&month;&day;">
@@ -158,6 +158,7 @@
 <!ENTITY unzip-version                "5.52">
 <!ENTITY zip-version                  "2.31">
 <!ENTITY pciutils-version             "2.2.3">
+<!ENTITY usbutils-version             "0.72">
 <!ENTITY pkgconfig-version            "0.20">
 <!ENTITY cpio-version                 "2.6">
 <!ENTITY mc-version                   "4.6.1">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2006-05-18 22:50:04 UTC (rev 6110)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2006-05-20 14:03:40 UTC (rev 6111)
@@ -42,6 +42,15 @@
 -->
 
     <listitem>
+      <para>May 20th, 2006</para>
+      <itemizedlist>
+        <listitem>
+          <para>[randy] - Added new package usbutils-0.72.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>May 19th, 2006</para>
       <itemizedlist>
         <listitem>

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2006-05-18 22:50:04 UTC (rev 6110)
+++ trunk/BOOK/introduction/welcome/credits.xml	2006-05-20 14:03:40 UTC (rev 6111)
@@ -238,7 +238,7 @@
         (extensive overhaul), NSS, Other Programming Tools, PDL, Perl Modules,
         pilot-link, Poppler, PyXML, Samba 3 (many additions), SANE (original
         instructions by Alex Kloss), Shadow (rewrite), SLIB, Sound Juicer,
-        Stunnel, Sysstat, system-tools-backends, Totem and unixODBC:
+        Stunnel, Sysstat, system-tools-backends, Totem, unixODBC and usbutils:
         <emphasis>Randy McMurchy</emphasis></para>
       </listitem>
 




More information about the blfs-book mailing list