Beyond Linux® From Scratch (System V Edition) - Version 12.1

Chapter 17. Networking Libraries

libsoup-3.4.4

Introduction to libsoup3

The libsoup3 is a HTTP client/server library for GNOME. It uses GObject and the GLib main loop to integrate with GNOME applications and it also has an asynchronous API for use in threaded applications.

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

Package Information

libsoup3 Dependencies

Required

glib-networking-2.78.0, libpsl-0.21.5, libxml2-2.12.5, nghttp2-1.59.0, and SQLite-3.45.1

Recommended

gobject-introspection-1.78.1 and Vala-0.56.14

Optional

Apache-2.4.58 (required to run the test suite), Brotli-1.1.0, cURL-8.6.0 (required to run the test suite), Gi-DocGen-2023.3, MIT Kerberos V5-1.21.2 (required to run the test suite), PHP-8.3.3 compiled with XMLRPC-EPI support (only used for the XMLRPC regression tests), Samba-4.19.5 (ntlm_auth is required to run the test suite), sysprof, and wstest

Installation of libsoup3

Fix the installation path of API documentation: 

sed 's/apiversion/soup_version/' -i docs/reference/meson.build

Install libsoup3 by running the following commands: 

mkdir build &&
cd    build &&

meson setup --prefix=/usr          \
            --buildtype=release    \
            -Dvapi=enabled         \
            -Dgssapi=disabled      \
            -Dsysprof=disabled     \
            --wrap-mode=nofallback \
            ..                     &&
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.

--wrap-mode=nofallback: This switch prevents meson from using subproject fallbacks for any dependency declarations in the build files, stopping it downloading any optional dependency which is not installed on the system.

-Dvapi=disabled: Use this if you have not installed Vala, e.g. because you are not building GNOME.

-Ddocs=enabled: If Gi-DocGen-2023.3 is installed, the API documentation will be built and installed no matter if this option is used or not. This option causes the meson command to fail if Gi-DocGen-2023.3 is not installed.

-Dgssapi=disabled: libsoup3 defaults to building with GSSAPI support, which requires Kerberos (as does the test suite).

-Dsysprof=disabled: libsoup3 will automatically download a git version of sysprof if git is available or use the installed version if it is present on the system. If you need profiling, remove this option.

Contents

Installed Programs: None
Installed Libraries: libsoup-3.0.so
Installed Directories: /usr/include/libsoup-3.0, /usr/share/doc/libsoup-3.4.4 (only installed if gi-docgen is available)

Short Descriptions

libsoup-3.0.so

provides functions for asynchronous HTTP connections