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

Chapter 9. General Libraries

libgcrypt-1.10.3

Introduction to libgcrypt

The libgcrypt package contains a general purpose crypto library based on the code used in GnuPG. The library provides a high level interface to cryptographic building blocks using an extendable and flexible API.

[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

libgcrypt Dependencies

Required

libgpg-error-1.47

Optional

Pth-2.0.7 and texlive-20230313 (or install-tl-unx)

Installation of libgcrypt

Install libgcrypt by running the following commands: 

./configure --prefix=/usr &&
make                      &&

make -C doc html                                                       &&
makeinfo --html --no-split -o doc/gcrypt_nochunks.html doc/gcrypt.texi &&
makeinfo --plaintext       -o doc/gcrypt.txt           doc/gcrypt.texi

To test the results, issue: make check.

Now, as the root user: 

make install &&
install -v -dm755   /usr/share/doc/libgcrypt-1.10.3 &&
install -v -m644    README doc/{README.apichanges,fips*,libgcrypt*} \
                    /usr/share/doc/libgcrypt-1.10.3 &&

install -v -dm755   /usr/share/doc/libgcrypt-1.10.3/html &&
install -v -m644 doc/gcrypt.html/* \
                    /usr/share/doc/libgcrypt-1.10.3/html &&
install -v -m644 doc/gcrypt_nochunks.html \
                    /usr/share/doc/libgcrypt-1.10.3      &&
install -v -m644 doc/gcrypt.{txt,texi} \
                    /usr/share/doc/libgcrypt-1.10.3

Command Explanations

--with-capabilities: This option enables libcap2 support. Note that this breaks cryptsetup-2.4.3

Contents

Installed Programs: dumpsexp, hmac256, libgcrypt-config, and mpicalc
Installed Library: libgcrypt.so
Installed Directory: /usr/share/doc/libgcrypt-1.10.3

Short Descriptions

dumpsexp

is a debug tool for S-expressions

hmac256

is a standalone HMAC-SHA-256 implementation used to compute an HMAC-SHA-256 authentication code

libgcrypt-config

determines the compile and linker flags that should be used to compile and link programs that use libgcrypt

mpicalc

is a RPN (Reverse Polish Notation) calculator

libgcrypt.so

contains the cryptographic API functions