Minor fixes.
[gnupg.git] / doc / debugging.texi
index fb27b27..f88f693 100644 (file)
@@ -16,7 +16,8 @@ solve the problem at hand.
 
 
 @menu
-* Debugging Tools::       Description of some useful tools
+* Debugging Tools::       Description of some useful tools.
+* Debugging Hints::       Various hints on debugging.
 * Common Problems::       Commonly seen problems.
 * Architecture Details::  How the whole thing works internally.
 @end menu
@@ -84,9 +85,27 @@ should not occur but sometimes things go wrong), run it using
 @samp{kbxutil --find-dups ~/.gnupg/pubring.kbx}
 
 
+@node Debugging Hints
+@section Various hints on debugging.
 
+@itemize @bullet
+
+@item How to find the IP address of a keyserver
+
+If a round robin URL of is used for a keyserver
+(e.g. subkeys.gnupg.org); it is not easy to see what server is actually
+used.  Using the keyserver debug option as in
+
+@smallexample
+ gpg --keyserver-options debug=1 -v --refresh-key 1E42B367
+@end smallexample
+
+is thus often helpful.  Note that the actual output depends on the
+backend and may change from release to release.
 
 
+@end itemize
+
 
 @node Common Problems
 @section Commonly Seen Problems
@@ -182,6 +201,31 @@ such a certificate.  You may use the @code{relax} flag in
 fingerprint and this flag may only be added manually to
 @file{trustlist.txt}.
 
+@item Error message: ``digest algorithm N has not been enabled''
+
+The signature is broken.  You may try the option
+@option{--extra-digest-algo SHA256} to workaround the problem.  The
+number N is the internal algorighm indentifier; for example 8 refers to
+SHA-256.
+
+
+@item The Windows version does not work under Wine
+
+When running the W32 version of @command{gpg} under Wine you may get
+an error messages like:
+
+@smallexample
+gpg: fatal: WriteConsole failed: Access denied
+@end smallexample
+
+@noindent
+The solution is to use the command @command{wineconsole}. 
+
+Some operations like gen-key really want to talk to the console directly
+for increased security (for example to prevent the passphrase from
+appearing on the screen).  So, you should use @command{wineconsole}
+instead of @command{wine}, which will launch a windows console that
+implements those additional features.
 
 
 @end itemize