Beyond Linux® From Scratch (System V Edition) - Version 2021-04-13

Chapter 9. General Libraries

libgcrypt-1.9.2

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.

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

Package Information

libgcrypt Dependencies

Required

libgpg-error-1.42

Optional

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

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/libgcrypt

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

The above commands build the documentation in html and plaintext formats. If you wish to build alternate formats of the documentation, you need texlive-20200406 (or install-tl-unx). Issue the following command: 

make -C doc pdf ps

To test the results, issue: make check.

Now, as the root user: 

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

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

If you built alternate formats of the documentation, install them by issuing the following command as the root user: 

install -v -m644 doc/gcrypt.{pdf,ps,dvi} \
                    /usr/share/doc/libgcrypt-1.9.2

Command Explanations

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

Contents

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

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

Last updated on 2021-02-20 00:13:48 -0600