Beyond Linux® From Scratch (systemd edition) - Version 7.10

Chapter 9. General Libraries

libgcrypt-1.7.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.

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

Package Information

libgcrypt Dependencies

Required

libgpg-error-1.24

Optional

libcap-2.25 with PAM and Pth-2.0.7, texlive-20160523b (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

Only info documentation is shipped in the package tarball. If you wish to build alternate formats of the documentation, (you must have texlive-20160523b installed to build the PDF and PostScript documentation), then issue the following commands: 

make -C doc pdf ps 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.7.3 &&
install -v -m644    README doc/{README.apichanges,fips*,libgcrypt*} \
                    /usr/share/doc/libgcrypt-1.7.3

If you built the additional documentation, install it by issuing the following commands as the root user: 

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

Command Explanations

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

Contents

Installed Programs: dumpsexp, hmac256, libgcrypt-config, and mpicalc
Installed Library: libgcrypt.so
Installed Directory: /usr/share/doc/libgcrypt-1.7.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.

Last updated on 2016-08-27 10:19:11 -0700