Beyond Linux From Scratch - Version 6.1

Chapter 8. General Libraries

Libusb-0.1.10a

Introduction to Libusb

The libusb package contains a library used by some applications for USB device access.

Package Information

Libusb Dependencies

Optional (Required to Build the HTML User Manual)

OpenJade-1.3.2 and DocBOOK SGML DTD-4.2

Optional (Required to Build the API Documentation)

Doxygen-1.4.3 and GraphViz

Installation of Libusb

Install libusb by running the following commands: 

./configure --prefix=/usr --disable-build-docs &&
make

If you wish to build the API documentation, issue the following command: 

make apidox

Now, as the root user: 

make install

If you built the HTML user manual, install it using the following commands as the root user: 

install -v -d -m755 /usr/share/doc/libusb-0.1.10a/html &&
install -v -m644 doc/html/* /usr/share/doc/libusb-0.1.10a/html

If you built the API documentation, install it using the following commands as the root user: 

install -v -d -m755 /usr/share/doc/libusb-0.1.10a/apidocs &&
install -v -m644 apidocs/html/* \
    /usr/share/doc/libusb-0.1.10a/apidocs

Command Explanations

--disable-build-docs: This switch avoids building the HTML user manual. If you wish to build the user manual, you may need to remove the OpenSP catalog definitions from the system SGML catalogs. Use the following command before building the package to accomplish this: 

sed -i.orig \
    -e "/CATALOG \/etc\/sgml\/OpenSP-1.5.1.cat/d" \
    /etc/sgml/catalog \
    /etc/sgml/sgml-docbook.cat

Configuring Libusb

libusb requires the usbfs kernel filesystem to be mounted on /proc/bus/usb. Applications require the files in this directory to be accessible to the user, sometimes for both reading and writing. To restrict access to USB devices, ensure the usb group exits on your system. If necessary, create the usb group using the following command: 

groupadd -g 14 usb

Ensure that you have compiled the “USB device filesystem” directly into the kernel or compiled it as a module (listing the resulting “usbcore” module in the /etc/sysconfig/modules file). You should also have an entry similar to the line below in your /etc/fstab file: 

usbfs  /proc/bus/usb  usbfs  devgid=14,devmode=0660  0  0

Contents

Installed Program: usb-config
Installed Libraries: libusb.[so,a] and libusbpp.[so,a]
Installed Directory: /usr/share/doc/libusb-0.1.10a

Short Descriptions

usb-config

is a script that provides the right compiler and linker flags for programs using libusb.

libusb.[so,a]

libraries contain C functions for accessing USB hardware.

Last updated on 2005-08-01 13:29:19 -0600