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

Chapter 9. General Libraries

libgusb-0.4.9

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.2 platform.

Package Information

libgusb Dependencies

Required

JSON-GLib-1.8.0 and libusb-1.0.27

Recommended

GLib-2.80.4 (with GObject Introspection), hwdata-0.385 (for usb.ids data file, which is also required for the tests), and Vala-0.56.17

Optional

Gi-DocGen-2024.1 and umockdev-0.18.3 (for full test coverage)

Installation of libgusb

Install libgusb by running the following commands: 

mkdir build &&
cd    build &&

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

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

sed -E "/output|install_dir/s/('libgusb)'/\1-0.4.9'/" \
    -i ../docs/meson.build                            &&
meson configure -D docs=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.

-D docs=false: Allow building this package without Gi-DocGen-2024.1 installed. If you have Gi-DocGen-2024.1 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.9 (if gi-docgen is used)

Short Descriptions

gusbcmd

is a debugging tool for the libgusb library

libgusb.so

contains the libgusb API functions