Beyond Linux® From Scratch (System V Edition) - Version r11.2-1338

Chapter 33. GNOME Libraries and Desktop

libsecret-0.20.5

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 11.3 platform.

Package Information

libsecret Dependencies

Required

GLib-2.74.5

Recommended

gobject-introspection-1.74.0, libgcrypt-1.10.1, and Vala-0.56.4

Optional

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

Optional (Required for the test suite)

D-Bus Python-1.3.2, Gjs-1.74.1, PyGObject-3.42.2 (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.

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

Installation of libsecret

Install libsecret by running the following commands: 

mkdir bld &&
cd bld &&

meson --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.

If gi-docgen is installed and the -Dgtk_doc=false has been removed, as the root user, issue the following command to fix the name of the installed documentation directory: 

mv -v /usr/share/doc/libsecret-{1,0.20.5}

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.37 and DocBook packages.

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

Contents

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

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