Beyond Linux® From Scratch (systemd Edition) - Version r12.0-816

Chapter 17. Networking Libraries

libsoup-2.74.3

Introduction to libsoup

The libsoup 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

libsoup Dependencies

Required

glib-networking-2.78.0, libpsl-0.21.2, libxml2-2.12.1, and SQLite-3.44.2

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.4.0 (required to run the test suite), MIT Kerberos V5-1.21.2 (required to run the test suite), GTK-Doc-1.33.2, PHP-8.3.0 compiled with XMLRPC-EPI support (only used for the XMLRPC regression tests), Samba-4.19.3 (ntlm_auth is required to run the test suite), and sysprof

Installation of libsoup

First, fix a build failure caused by libxml2-2.12.x: 

sed -i '/tree/a #include <libxml/parser.h>' libsoup/soup-xmlrpc*.c

Install libsoup by running the following commands: 

mkdir build &&
cd    build &&

meson setup --prefix=/usr       \
            --buildtype=release \
            -Dvapi=enabled      \
            -Dgssapi=disabled   \
            -Dsysprof=disabled  \
            ..                  &&
ninja

To test the results, issue: ninja test. One test named ssl-test is known to fail.

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.

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

-Ddoc=enabled: Use this option if you want to build the documentation. Note that you must have GTK-Doc-1.33.2 installed.

-Dgssapi=disabled: libsoup defaults to building with GSSAPI support, which requires Kerberos (as does the test suite). If you are building GNOME or have kerberos installed, remove this option.

-Dsysprof=disabled: libsoup 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-2.4.so and libsoup-gnome-2.4.so
Installed Directories: /usr/include/libsoup-2.4, /usr/include/libsoup-gnome-2.4 and /usr/share/gtk-doc/html/libsoup-2.4

Short Descriptions

libsoup-2.4.so

provides functions for asynchronous HTTP connections

libsoup-gnome-2.4.so

provides GNOME specific features