Beyond Linux® From Scratch (systemd Edition) - Version 12.1

Chapter 9. General Libraries

libgusb-0.4.8

Introduction to libgusb

The libgusb package contains the GObject wrappers for libusb-1.0 that makes it easy to do asynchronous control, bulk and interrupt transfers with proper cancellation and integration into a mainloop.

This package is known to build and work properly using an LFS 12.1 platform.

Package Information

libgusb Dependencies

Required

JSON-GLib-1.8.0 and libusb-1.0.27

Recommended

gobject-introspection-1.78.1, usbutils-017 (for usb.ids data file, which is also required for the tests), and Vala-0.56.14

Optional

Gi-DocGen-2023.3 and umockdev-0.17.18 (for full test coverage)

Installation of libgusb

Install libgusb by running the following commands: 

mkdir build &&
cd    build &&

meson setup ..            \
      --prefix=/usr       \
      --buildtype=release \
      -Ddocs=false        &&
ninja

If you have Gi-DocGen-2023.3 installed and wish to build the API documentation for this package, issue: 

sed -E "/output|install_dir/s/('libgusb)'/\1-0.4.8'/" \
    -i ../docs/meson.build                            &&
meson configure -Ddocs=true                           &&
ninja

To test the results, issue: ninja test.

Now, as the root user: 

ninja install

Command Explanations

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

-Ddocs=false: Allow building this package without Gi-DocGen-2023.3 installed. If you have Gi-DocGen-2023.3 installed and you wish to rebuild and install the API documentation, a meson configure command will reset this option.

Contents

Installed Programs: gusbcmd
Installed Library: libgusb.so
Installed Directories: /usr/include/gusb-1 and /usr/share/doc/libgusb-0.4.8 (if gi-docgen is used)

Short Descriptions

gusbcmd

is a debugging tool for the libgusb library

libgusb.so

contains the libgusb API functions