File: README

package info (click to toggle)
gcr 3.14.0-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 13,528 kB
  • ctags: 9,510
  • sloc: ansic: 69,915; sh: 11,548; makefile: 1,278; python: 538; xml: 228
file content (43 lines) | stat: -rw-r--r-- 1,574 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
GCR is a library for displaying certificates, and crypto UI, accessing
key stores. It also provides the viewer for crypto files on the GNOME
desktop.

GCK is a library for accessing PKCS#11 modules like smart cards, in a
(G)object oriented way.


DEBUG TRACING
==============

The Gcr and Gck libraries contain statements which help debug flow
and logic. In many cases these help you track down problems.

Use the environment variable GCR_DEBUG='all' or GCR_HELP='xxx' to
display either all messages or a specific category of debug messages.
To figure out what you can use in place of the 'xxx' category above,
use GCR_DEBUG='help' and you'll see a list of all the messages.

Example to display all debug messages:

 $ GCR_DEBUG=all gcr-viewer /path/to/certificate.crt
 (gcr-viewer:9418): Gcr-DEBUG: gcr_pkcs11_initialize_async: starting initialize of registered modules
 ...

Example to display the various debug categories:

 $ GCR_DEBUG=help gcr-viewer /path/to/certificate.crt
 Supported debug values: library certificate-chain parse gnupg trust import key prompt all help

Example to display debug messages for a specific category:

 $ GCR_DEBUG=library gcr-viewer /path/to/certificate.crt
 (gcr-viewer:9503): Gcr-DEBUG: gcr_pkcs11_initialize_async: starting initialize of registered modules
 ...

If you wish to permanently enable certain debug messages, include compiler
directives like this when configuring this library:

 $ CFLAGS='-DGCR_DEBUG=library' ./configure ...

For the Gck debug messages simply replace 'GCR_DEBUG' with 'GCK_DEBUG'
in the above examples.