Ignore:
Timestamp:
07/23/2012 06:35:26 PM (12 years ago)
Author:
Krejzi <krejzi@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
696e766
Parents:
5b91a580
Message:

PCI Utils 3.1.10 and USB Utils 006.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10452 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/sysutils/usbutils.xml

    r5b91a580 r564851b  
    55  %general-entities;
    66
    7   <!ENTITY usbutils-download-http "http://ftp.de.debian.org/debian/pool/main/u/usbutils/usbutils_&usbutils-version;.orig.tar.gz">
    8   <!ENTITY usbutils-download-ftp  " ">
    9   <!ENTITY usbutils-md5sum        "2e990265d472e2f6f0662356d654683b">
    10   <!ENTITY usbutils-size          "232 KB">
     7  <!ENTITY usbutils-download-http "http://ftp.kernel.org/pub/linux/utils/usb/usbutils/usbutils-&usbutils-version;.tar.xz">
     8  <!ENTITY usbutils-download-ftp  "ftp://ftp.kernel.org/pub/linux/utils/usb/usbutils/usbutils-&usbutils-version;.tar.xz">
     9  <!ENTITY usbutils-md5sum        "c9aa14ee3d6c991fda183f42cf72a8a8">
     10  <!ENTITY usbutils-size          "400 KB">
    1111  <!ENTITY usbutils-buildsize     "6.0 MB">
    1212  <!ENTITY usbutils-time          "0.1 SBU">
    1313]>
    1414
    15 <sect1 id="usbutils" xreflabel="usbutils-&usbutils-version;">
     15<sect1 id="usbutils" xreflabel="USB Utils-&usbutils-version;">
    1616  <?dbhtml filename="usbutils.html"?>
    1717
    … …  
    2121  </sect1info>
    2222
    23   <title>usbutils-&usbutils-version;</title>
     23  <title>USB Utils-&usbutils-version;</title>
    2424
    2525  <indexterm zone="usbutils">
    26     <primary sortas="a-usbutils">usbutils</primary>
     26    <primary sortas="a-USB Utils">USB Utils</primary>
    2727  </indexterm>
    2828
    2929  <sect2 role="package">
    30     <title>Introduction to usbutils</title>
    31 
    32     <para>The <application>usbutils</application> package contains a utility
    33     used to display information about USB buses in the system and the devices
    34     connected to them.</para>
     30    <title>Introduction to USB Utils</title>
     31
     32    <para>
     33      The <application>USB Utils</application> package contains an utility
     34      used to display information about USB buses in the system and the
     35      devices connected to them.
     36    </para>
    3537
    3638    &lfs71_checked;
    … …  
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&usbutils-download-http;"/></para>
    42       </listitem>
    43       <listitem>
    44         <para>Download (FTP): <ulink url="&usbutils-download-ftp;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download MD5 sum: &usbutils-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &usbutils-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &usbutils-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &usbutils-time;</para>
     43        <para>
     44          Download (HTTP): <ulink url="&usbutils-download-http;"/>
     45        </para>
     46      </listitem>
     47      <listitem>
     48        <para>
     49          Download (FTP): <ulink url="&usbutils-download-ftp;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download MD5 sum: &usbutils-md5sum;
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download size: &usbutils-size;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Estimated disk space required: &usbutils-buildsize;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated build time: &usbutils-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
    5973
    60     <bridgehead renderas="sect3">usbutils Dependencies</bridgehead>
     74    <bridgehead renderas="sect3">USB Utils Dependencies</bridgehead>
    6175
    6276    <bridgehead renderas="sect4">Required</bridgehead>
    … …  
    6781
    6882    <para condition="html" role="usernotes">User Notes:
    69     <ulink url="&blfs-wiki;/usbutils"/></para>
    70 
     83      <ulink url="&blfs-wiki;/usbutils"/>
     84    </para>
    7185  </sect2>
    7286
    7387  <sect2 role="installation">
    74     <title>Installation of usbutils</title>
    75 
    76     <para>Install <application>usbutils</application> by
    77     running the following commands:</para>
    78 
    79 <screen><userinput>./autogen.sh --prefix=/usr --sbindir=/usr/sbin \
    80              --disable-zlib &amp;&amp;
     88    <title>Installation of USB Utils</title>
     89
     90    <para>
     91      Install <application>USB Utils</application> by
     92      running the following commands:
     93    </para>
     94
     95<screen><userinput>./configure --prefix=/usr \
     96            --datadir=/usr/share/misc \
     97            --disable-zlib &amp;&amp;
    8198make</userinput></screen>
    8299
    83     <para>This package does not come with a test suite.</para>
    84 
    85     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     100    <para>
     101      This package does not come with a test suite.
     102    </para>
     103
     104    <para>
     105      Now, as the <systemitem class="username">root</systemitem> user:
     106    </para>
    86107
    87108<screen role="root"><userinput>make install &amp;&amp;
    … …  
    93114    <title>Command Explanations</title>
    94115
    95     <para><parameter>--disable-zlib</parameter>: This stops
    96     <application>usbutils</application> from installing a compressed usb.ids
    97     alongside the uncompressed one.</para>
     116    <para>
     117      <option>--disable-zlib</option>: This stops
     118      <application>USB Utils</application> from installing a
     119      compressed <filename>usb.ids</filename>  alongside the
     120      uncompressed one.
     121    </para>
    98122
    99123  </sect2>
    100124
    101125  <sect2 role="configuration">
    102     <title>Configuring usbutils</title>
    103 
    104     <para>The <filename>usb.ids</filename> data file is constantly being
    105     updated. To get a current version of this file, run
    106     <command>update-usbids</command> as the <systemitem
    107     class="username">root</systemitem> user. This program requires the
    108     <xref linkend="which"/> script or program to find <xref linkend="wget"/>
    109     or <xref linkend="lynx"/> which are used to download the most current file,
    110     and replace the existing file in
    111     <filename class='directory'>/usr/share</filename>.</para>
    112 
    113     <para>You may wish to add an entry to
    114     <systemitem class="username">root</systemitem>'s (or any other user who
    115     has write privilege to <filename class='directory'>/usr/share</filename>)
    116     crontab to automatically update the <filename>usb.ids</filename> file
    117     periodically.</para>
     126    <title>Configuring USB Utils</title>
     127
     128    <para>
     129      The <filename>usb.ids</filename> data file is constantly being
     130      updated. To get a current version of this file, run
     131      <command>update-usbids</command> as the <systemitem
     132      class="username">root</systemitem> user. This program requires the
     133      <xref linkend="which"/> script or program to find <xref linkend="lynx"/>
     134      or <xref linkend="wget"/> which are used to download the most current file,
     135      and replace the existing file in
     136      <filename class="directory">/usr/share/misc</filename>.
     137    </para>
     138
     139    <para>
     140      You may wish to add an entry to
     141      <systemitem class="username">root</systemitem>'s (or any other user who has
     142      write privilege to <filename class="directory">/usr/share/misc</filename>)
     143      crontab to automatically update the <filename>usb.ids</filename> file
     144      periodically.
     145    </para>
    118146
    119147  </sect2>
    … …  
    124152    <segmentedlist>
    125153      <segtitle>Installed Programs</segtitle>
    126       <segtitle>Installed Libraries</segtitle>
    127       <segtitle>Installed Directories</segtitle>
    128154
    129155      <seglistitem>
    130         <seg>lsusb, update-usbids, and usb-devices</seg>
    131         <seg>None</seg>
    132         <seg>None</seg>
     156        <seg>
     157          lsusb, update-usbids, usb-devices and usbhid-dump
     158        </seg>
    133159      </seglistitem>
    134160    </segmentedlist>
    … …  
    142168        <term><command>lsusb</command></term>
    143169        <listitem>
    144           <para>is a utility for displaying information about all USB buses in the
    145           system and all devices connected to them.</para>
     170          <para>
     171            is an utility for displaying information about all USB buses
     172            in the system and all devices connected to them.
     173          </para>
    146174          <indexterm zone="usbutils lsusb">
    147175            <primary sortas="b-lsusb">lsusb</primary>
    … …  
    153181        <term><command>update-usbids</command></term>
    154182        <listitem>
    155           <para>downloads the current version of the USB ID list. Requires
    156           <xref linkend="wget"/> or <xref linkend="lynx"/>.</para>
     183          <para>
     184            downloads the current version of the USB ID list. Requires
     185            <xref linkend="lynx"/> or <xref linkend="wget"/>.
     186          </para>
    157187          <indexterm zone="usbutils update-usbids">
    158188            <primary sortas="b-update-usbids">update-usbids</primary>
    … …  
    164194        <term><command>usb-devices</command></term>
    165195        <listitem>
    166           <para>is a shell script that displays details of USB buses and devices
    167           connected to them. It is designed to be used if /proc/bus/usb/devices
    168           is not available on your system.</para>
    169           <!-- /proc/bus/usb/devices is scheduled to be moved from usbfs to
    170                debugfs in linux-2.6.31. -->
     196          <para>
     197            is a shell script that displays details of USB buses and devices
     198            connected to them. It is designed to be used if /proc/bus/usb/devices
     199            is not available on your system.
     200          </para>
    171201          <indexterm zone="usbutils usb-devices">
    172202            <primary sortas="b-usb-devices">usb-devices</primary>
    … …  
    175205      </varlistentry>
    176206
     207      <varlistentry id="usbhid-dump">
     208        <term><command>usbhid-dump</command></term>
     209        <listitem>
     210          <para>
     211            is used to dump report descriptors and streams from HID
     212            (human interface device) interfaces of USB devices.
     213          </para>
     214          <indexterm zone="usbutils usbhid-dump">
     215            <primary sortas="b-usbhid-dump">usbhid-dump</primary>
     216          </indexterm>
     217        </listitem>
     218      </varlistentry>
     219
    177220    </variablelist>
    178221
Note: See TracChangeset for help on using the changeset viewer.