aboutsummaryrefslogtreecommitdiffstats
path: root/doc/debugging.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/debugging.texi')
-rw-r--r--doc/debugging.texi82
1 files changed, 0 insertions, 82 deletions
diff --git a/doc/debugging.texi b/doc/debugging.texi
deleted file mode 100644
index e5e3e43fd..000000000
--- a/doc/debugging.texi
+++ /dev/null
@@ -1,82 +0,0 @@
-@c Copyright (C) 2004 Free Software Foundation, Inc.
-@c This is part of the GnuPG manual.
-@c For copying conditions, see the file gnupg.texi.
-
-@node Debugging
-@chapter How to solve problems
-
-Everone knows that software often does not do what it should do and thus
-there is a need to track down problems. We call this debugging in a
-reminiscent to the moth jamming a relay in a Mark II box back in 1947.
-
-Most of the probelsm a merely configuration and user problems but
-nevertheless there are the most annoying ones and reposnible for may
-gray hairs. We try to give some guidelines here on how to identify and
-solve the problem at hand.
-
-
-@menu
-* Debugging Tools:: Description of some useful tools
-
-@end menu
-
-
-@node Debugging Tools
-@section Debugging Tools
-
-The GnuPG distribution comes with a couple of tools, useful to help find
-and solving problems.
-
-@menu
-* kbxutil:: Scrutinizing a keybox file.
-@end menu
-
-@node kbxutil
-@subsection Scrutinizing a keybox file
-
-A keybox is a file fomat used to store public keys along with meta
-information and indices. The commonly used one is the file
-@file{pubring.kbx} in the @file{.gnupg} directory. It contains all
-X.509 certificates as well as OpenPGP keys@footnote{Well, OpenPGP keys
-are not implemented, @command{gpg} still used the keyring file
-@file{pubring.gpg}} .
-
-@noindent
-When called the standard way, e.g.:
-
-@samp{kbxutil ~/.gnupg/pubring.kbx}
-
-@noindent
-it lists all records (called @acronym{blobs}) with there meta-information
-in a human readable format.
-
-@noindent
-To see statistics on the keybox in question, run it using
-
-@samp{kbxutil --stats ~/.gnupg/pubring.kbx}
-
-@noindent
-and you get an output like:
-
-@example
-Total number of blobs: 99
- header: 1
- empty: 0
- openpgp: 0
- x509: 98
- non flagged: 81
- secret flagged: 0
- ephemeral flagged: 17
-@end example
-
-In this example you see that the keybox does not have any OpenPGP keys
-but contains 98 X.509 cerificates and a total of 17 keys or certificates
-are flagges as ephemeral, meaning that they are only temporary stored
-(cached) in the keybox and won't get listed using the usual commands
-provided by @command{gpgsm} or @command{gpg}. 81 certifcates are stored
-in a standard way and directly available from @command{gpgsm}.
-
-
-
-
-