source: general/genlib/libusb.xml@ e231e7c

10.0 10.1 11.0 11.1 11.2 6.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 krejzi/svn lazarus nosym perl-modules plabs/python-mods qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since e231e7c was e231e7c, checked in by Randy McMurchy <randy@…>, 18 years ago

Modified libusb instructions as suggested by Alexander Patrakov

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

  • Property mode set to 100644
File size: 4.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7<!ENTITY libusb-download-http "http://prdownloads.sourceforge.net/libusb/libusb-&libusb-version;.tar.gz">
8<!ENTITY libusb-download-ftp " ">
9<!ENTITY libusb-size "314 KB">
10<!ENTITY libusb-buildsize "2.1 MB">
11<!ENTITY libusb-time "0.03 SBU">
12]>
13
14<sect1 id="libusb" xreflabel="libusb-&libusb-version;">
15<sect1info>
16<othername>$LastChangedBy$</othername>
17<date>$Date$</date>
18</sect1info>
19<?dbhtml filename="libusb.html"?>
20<title>libusb-&libusb-version;</title>
21
22<sect2>
23<title>Introduction to <application>libusb</application></title>
24
25<para>The <application>libusb</application> package contains a library
26used by some applications for <acronym>USB</acronym> device access.</para>
27
28<sect3><title>Package information</title>
29<itemizedlist spacing='compact'>
30<listitem><para>Download (HTTP): <ulink url="&libusb-download-http;"/></para></listitem>
31<listitem><para>Download (FTP): <ulink url="&libusb-download-ftp;"/></para></listitem>
32<listitem><para>Download size: &libusb-size;</para></listitem>
33<listitem><para>Estimated Disk space required: &libusb-buildsize;</para></listitem>
34<listitem><para>Estimated build time: &libusb-time;</para></listitem></itemizedlist>
35</sect3>
36
37<sect3><title><application>libusb</application> dependencies</title>
38<sect4><title>Optional</title>
39<para><xref linkend="openjade"/> and <xref linkend="sgml-dtd-3"/></para></sect4>
40</sect3>
41
42</sect2>
43
44<sect2>
45<title>Installation of <application>libusb</application></title>
46
47<para>Install <application>libusb</application> by running the following
48commands:</para>
49
50<screen><userinput><command>./configure --prefix=/usr --disable-build-docs &amp;&amp;
51make &amp;&amp;
52make install</command></userinput></screen>
53
54</sect2>
55
56<sect2>
57<title>Command explanations</title>
58
59<para><option>--disable-build-docs</option>: This switch avoids building the
60documentation. If you wish to build the documentation , you may need to remove
61the <application>OpenSP</application> catalog definitions from the system
62<acronym>SGML</acronym> catalogs. Use the following commands before building
63the package to accomplish this:</para>
64
65<screen><userinput><command>sed -i.orig -e "/CATALOG \/etc\/sgml\/OpenSP-1.5.1.cat/d" \
66 /etc/sgml/catalog &amp;&amp;
67sed -i.orig -e "/CATALOG \/etc\/sgml\/OpenSP-1.5.1.cat/d" \
68 /etc/sgml/sgml-docbook.cat</command></userinput></screen>
69
70<para>If desired, restore the orginal <acronym>SGML</acronym> catalogs after
71the build is complete using the following commands:</para>
72
73<screen><userinput><command>cp /etc/sgml/catalog.orig /etc/sgml/catalog &amp;&amp;
74cp /etc/sgml/sgml-docbook.cat.orig /etc/sgml/sgml-docbook.cat</command></userinput></screen>
75
76</sect2>
77
78<sect2>
79<title>Configuring <application>libusb</application></title>
80
81<para>libusb requires the usbfs kernel filesystem to be mounted on
82<filename class="directory">/proc/bus/usb</filename>. Applications require the
83files in this directory to be accessible to the user, sometimes for both
84reading and writing. To restrict access to <acronym>USB</acronym> devices,
85ensure the usb group exits on your system. If necessary, create the usb group
86using the following command:</para>
87
88<screen><userinput><command>groupadd -g 14 usb</command></userinput></screen>
89
90<!-- <para>Compiling the <quote>USB device filesystem</quote> as a kernel module is
91not recommended. However, if you did compile it as a module, you can install an
92init script to mount usbfs at system boot-up. An init script is included in the
93<xref linkend="intro-important-bootscripts"/> package and is installed using
94the following command:</para>
95
96<screen><userinput><command>make install-usb</command></userinput></screen> -->
97
98<para>Ensure that you have compiled the <quote>USB device filesystem</quote>
99directly into the kernel or compiled it as a module (listing the resulting
100<quote>usbcore</quote> module in the
101<filename>/etc/sysconfig/modules</filename> file). You should also have an
102entry similar to the line below in your <filename>/etc/fstab</filename>
103file:</para>
104
105<screen><userinput>usbfs /proc/bus/usb usbfs devgid=14,devmode=0660 0 0</userinput></screen>
106
107</sect2>
108
109<sect2>
110<title>Contents</title>
111
112<para>The <application>libusb</application> package contains
113<filename class="libraryfile">libusb</filename> libraries,
114the <filename>/usr/include/usb.h</filename> header,
115and a <command>usb-config</command> script.</para>
116
117</sect2>
118
119<sect2><title>Description</title>
120
121<sect3><title>libusb libraries</title>
122<para><filename class="libraryfile">libusb</filename> libraries contain C
123functions for accessing <acronym>USB</acronym> hardware.</para></sect3>
124
125<sect3><title>usb-config</title>
126<para>The <command>usb-config</command> script provides the right
127compiler and linker flags for programs using this library.</para></sect3>
128
129</sect2>
130
131</sect1>
132
Note: See TracBrowser for help on using the repository browser.