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

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.

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

Package Information

libsoup Dependencies

Required

glib-networking-2.74.0, libpsl-0.21.2, libxml2-2.10.3, and SQLite-3.40.1

Recommended

gobject-introspection-1.74.0 and Vala-0.56.4

Optional

Apache-2.4.55 (required to run the test suite), Brotli-1.0.9, cURL-7.88.1 (required to run the test suite), sysprof-3.46.0 (for profiling), MIT Kerberos V5-1.20.1 (required to run the test suite), GTK-Doc-1.33.2, PHP-8.2.3 compiled with XMLRPC-EPI support (only used for the XMLRPC regression tests), and Samba-4.17.5 (ntlm_auth is required to run the test suite)

User Notes: https://wiki.linuxfromscratch.org/blfs/wiki/libsoup

Installation of libsoup

Install libsoup by running the following commands: 

mkdir build &&
cd    build &&

meson --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-3.46.0 if git is available or use the installed version if available. 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