Gcr-4.1.0

Introduction to Gcr

The Gcr package contains libraries used for displaying certificates and accessing key stores. It also provides the viewer for crypto files on the GNOME Desktop.

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

Package Information

Gcr Dependencies

Required

GLib-2.76.4, libgcrypt-1.10.2, and p11-kit-0.25.0

Recommended

Optional

Gi-DocGen-2023.1 and Valgrind-3.21.0

Installation of Gcr

[Note]

Note

Both gcr-3 and gcr-4 are coinstallable. This version of the package is used to support GTK-4 applications, such as gnome-shell-44.3 and Epiphany-44.6.

Install Gcr by running the following commands:

mkdir build &&
cd    build &&

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 -e "/install_dir/s@,\$@ / 'gcr-4.1.0'&@" \
    -e "/fatal-warnings/d"                   \
    -i ../docs/*/meson.build                 &&
meson configure -Dgtk_doc=true               &&
ninja

To test the results, issue: ninja test. The tests must be run from an X Terminal or similar.

Now, as the root user:

ninja install

Command Explanations

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

-Dgtk=false: Use this switch if you haven't installed GTK-4.12.0. Note that gcr-viewer will not be installed if this is passed to meson.

-Dgtk_doc=true: 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.

Contents

Installed Program: gcr-viewer-gtk4
Installed Libraries: libgck-2.so, libgcr-4.so
Installed Directories: /usr/include/gck-2, /usr/include/gcr-4, and /usr/share/gtk-doc/html/{gcr,gck}

Short Descriptions

gcr-viewer-gtk4

is used to view certificates and key files

libgck-2.so

contains GObject bindings for PKCS#11

libgcr-4.so

contains functions for accessing key stores and displaying certificates