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

Package Information

Gcr Dependencies


GLib-2.78.4, libgcrypt-1.10.3, and p11-kit-0.25.3



Gi-DocGen-2023.3 and Valgrind-3.22.0

Installation of Gcr



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

Install Gcr by running the following commands:

mkdir build &&
cd    build &&

meson setup --prefix=/usr       \
            --buildtype=release \
            -Dgtk_doc=false     \
            ..                  &&

If you have Gi-DocGen-2023.3 installed and wish to build the API documentation for this package, issue:

sed -e "/install_dir/s@,\$@ / 'gcr-4.2.0'&@" \
    -e "/fatal-warnings/d"                   \
    -i ../docs/*/meson.build                 &&
meson configure -Dgtk_doc=true               &&

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.5. Note that gcr-viewer will not be installed if this is passed to meson.

-Dssh_agent=false: Use this switch if you haven't installed OpenSSH-9.6p1, and wish to disable ssh compatibility.

-Dgtk_doc=true: Allow building this package without Gi-DocGen-2023.3 installed. If you have Gi-DocGen-2023.3 installed and you wish to rebuild and install the API documentation, a meson configure command will reset this option.


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


is used to view certificates and key files


contains GObject bindings for PKCS#11


contains functions for accessing key stores and displaying certificates