source: general/genlib/libusb.xml@ a89a5a6

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a89a5a6 was a89a5a6, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Update to glib-2.60.7
Update to dbus-python-1.2.10 (Python Module)
Update to libnl-3.5.0
Update to unrar-5.8.1
Update to NSS-3.46
Update to libusb-1.0.23

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

  • Property mode set to 100644
File size: 5.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY libusb-download-http "https://github.com//libusb/libusb/releases/download/v&libusb-version;/libusb-&libusb-version;.tar.bz2">
8 <!ENTITY libusb-download-ftp " ">
9 <!ENTITY libusb-md5sum "1e29700f6a134766d32b36b8d1d61a95">
10 <!ENTITY libusb-size "592 KB">
11 <!ENTITY libusb-buildsize "6.4 MB">
12 <!ENTITY libusb-time "less than 0.1 SBU">
13]>
14
15<sect1 id="libusb" xreflabel="libusb-&libusb-version;">
16 <?dbhtml filename="libusb.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>libusb-&libusb-version;</title>
24
25 <indexterm zone="libusb">
26 <primary sortas="a-libusb">libusb</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to libusb</title>
31
32 <para>
33 The <application>libusb</application> package contains a library
34 used by some applications for USB device access.
35 </para>
36
37 &lfs90_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&libusb-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&libusb-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &libusb-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &libusb-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &libusb-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &libusb-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">libusb Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Optional</bridgehead>
76 <para role="optional">
77 <xref linkend="doxygen"/>
78 </para>
79
80 <para condition="html" role="usernotes">User Notes:
81 <ulink url="&blfs-wiki;/libusb"/>
82 </para>
83 </sect2>
84
85 <sect2 role="installation">
86 <title>Installation of libusb</title>
87
88 <note>
89 <para>
90 This package does not support parallel build.
91 </para>
92 </note>
93
94 <para>
95 Install <application>libusb</application> by running the following
96 commands:
97 </para>
98
99<screen><userinput>sed -i "s/^PROJECT_LOGO/#&amp;/" doc/doxygen.cfg.in &amp;&amp;
100
101./configure --prefix=/usr --disable-static &amp;&amp;
102make -j1</userinput></screen>
103
104 <para>
105 If <application>Doxygen</application> is installed and you wish to
106 build the API documentation, issue the following command:
107 </para>
108
109<screen remap="doc"><userinput>make -C doc docs</userinput></screen>
110
111 <para>
112 This package does not come with a test suite.
113 </para>
114
115 <para>
116 Now, as the <systemitem class="username">root</systemitem> user:
117 </para>
118
119<screen role="root"><userinput>make install</userinput></screen>
120
121 <para>
122 If you built the API documentation, install it using the following
123 commands as the <systemitem class="username">root</systemitem> user:
124 </para>
125
126<screen role="root"
127 remap="doc"><userinput>install -v -d -m755 /usr/share/doc/libusb-&libusb-version;/apidocs &amp;&amp;
128install -v -m644 doc/html/* \
129 /usr/share/doc/libusb-&libusb-version;/apidocs</userinput></screen>
130
131 </sect2>
132
133 <sect2 role="commands">
134 <title>Command Explanations</title>
135
136 <para>
137 <command>sed -i ...</command>: This sed prevents a warning when
138 building the documentation.
139 </para>
140 </sect2>
141
142 <sect2 role="configuration">
143 <title>Configuring Libusb</title>
144
145 <para id="libusb-kernel">
146 To access raw USB devices (those not treated as a disk by the mass-storage
147 driver), appropriate support must be available in the kernel. Check your
148 kernel configuration:
149 </para>
150
151<screen><literal>Device Drivers ---&gt;
152 [*] USB support ---&gt; [CONFIG_USB_SUPPORT]
153 &lt;*/M&gt; Support for Host-side USB [CONFIG_USB]
154 (Select any USB hardware device drivers you may need on the same page)</literal></screen>
155
156 <indexterm zone="libusb libusb-kernel">
157 <primary sortas="d-USB-device-filesystem">Support for Host-side USB</primary>
158 </indexterm>
159
160 <para>
161 For more details on setting up USB devices, see <xref
162 linkend="usb-device-issues"/>.
163 </para>
164
165 </sect2>
166
167 <sect2 role="content">
168 <title>Contents</title>
169
170 <segmentedlist>
171 <segtitle>Installed Programs</segtitle>
172 <segtitle>Installed Library</segtitle>
173 <segtitle>Installed Directories</segtitle>
174
175 <seglistitem>
176 <seg>
177 None
178 </seg>
179 <seg>
180 libusb-1.0.so
181 </seg>
182 <seg>
183 /usr/include/libusb-1.0 and
184 /usr/share/doc/libusb-&libusb-version;
185 </seg>
186 </seglistitem>
187 </segmentedlist>
188
189 <variablelist>
190 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
191 <?dbfo list-presentation="list"?>
192 <?dbhtml list-presentation="table"?>
193
194 <varlistentry id="libusb-lib">
195 <term><filename class='libraryfile'>libusb-1.0.so</filename></term>
196 <listitem>
197 <para>
198 contains API functions used for accessing USB hardware.
199 </para>
200 <indexterm zone="libusb libusb-lib">
201 <primary sortas="c-libusb">libusb-1.0.so</primary>
202 </indexterm>
203 </listitem>
204 </varlistentry>
205
206 </variablelist>
207
208 </sect2>
209
210</sect1>
Note: See TracBrowser for help on using the repository browser.