Beyond Linux® From Scratch (systemd Edition) - Version r12.2-440

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.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

libsoup3 Dependencies

Required

glib-networking-2.80.0, libpsl-0.21.5, libxml2-2.13.4, nghttp2-1.64.0, and SQLite-3.47.0

Recommended

GLib-2.82.2 (with GObject Introspection) and Vala-0.56.17

Optional

Apache-2.4.62 (required to run the test suite), Brotli-1.1.0, cURL-8.10.1 (required to run the test suite), Gi-DocGen-2024.1, MIT Kerberos V5-1.21.3 (required to run the test suite), PHP-8.3.12 compiled with XMLRPC-EPI support (only used for the XMLRPC regression tests), Samba-4.21.1 (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    \
            -D vapi=enabled        \
            -D gssapi=disabled     \
            -D sysprof=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, preventing it from downloading any optional dependencies which are not not installed on the system.

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

-D docs=enabled: If Gi-DocGen-2024.1 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-2024.1 is not installed.

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

-D sysprof=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