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

Chapter 33. GNOME Libraries and Desktop

libsecret-0.21.0

Introduction to libsecret

The libsecret package contains a GObject based library for accessing the Secret Service API.

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

Package Information

libsecret Dependencies

Required

GLib-2.76.4

Recommended

gobject-introspection-1.76.1, libgcrypt-1.10.2, and Vala-0.56.11

Optional

Gi-DocGen-2023.1 and docbook-xml-4.5, docbook-xsl-nons-1.79.2, libxslt-1.1.38 (to build manual pages), and Valgrind-3.21.0 (can be used in tests)

Optional (Required for the test suite)

D-Bus Python-1.3.2, Gjs-1.76.2, PyGObject-3.44.1 (Python 3 module), and tpm2-tss

Runtime Dependency

gnome-keyring-42.1

[Note]

Note

Any package requiring libsecret expects GNOME Keyring to be present at runtime.

Installation of libsecret

Install libsecret by running the following commands: 

mkdir bld &&
cd    bld &&

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

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

sed "s/api_version_major/'0.20.5'/"            \
    -i ../docs/reference/libsecret/meson.build &&
meson configure -Dgtk_doc=true                 &&
ninja

Now, as the root user: 

ninja install

To test the results, issue: dbus-run-session ninja test.

Command Explanations

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

-Dgtk_doc=false: Allow building this package without Gi-DocGen-2023.1 installed. If you have Gi-DocGen-2023.1 installed and you wish to rebuild and install the API documentation, a meson configure command will reset this option.

-Dmanpage=false: Use this switch if you have not installed libxslt-1.1.38 and DocBook packages.

-Dgcrypt=false: Use this switch if you have not installed the recommended dependency of libgcrypt-1.10.2.

Contents

Installed Program: secret-tool
Installed Library: libsecret-1.so
Installed Directories: /usr/include/libsecret-1 and /usr/share/doc/libsecret-0.21.0

Short Descriptions

secret-tool

is a command line tool that can be used to store and retrieve passwords

libsecret-1.so

contains the libsecret API functions