* call-scd.c (unescape_status_string): New. Actual a copy of
[gnupg.git] / doc / debugging.texi
index 9406ba5..49ab70b 100644 (file)
@@ -5,7 +5,7 @@
 @node Debugging
 @chapter How to solve problems
 
-Everone knows that software often does not do what it should do and thus
+Everyone 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.
 
@@ -87,9 +87,24 @@ in a standard way and directly available from @command{gpgsm}.
 @itemize @bullet
 @item Error code @samp{Not supported} from Dirmngr
 
-  Most likely the option @option{enable-ocsp} is active for gpgsm
-  but Dirmngr's OCSP feature has not been enabled using
-  @option{allow-ocsp} in @file{dirmngr.conf}.
+Most likely the option @option{enable-ocsp} is active for gpgsm
+but Dirmngr's OCSP feature has not been enabled using
+@option{allow-ocsp} in @file{dirmngr.conf}.
+
+@item The Curses based Pinentry does not work
+
+The far most common reason for this is that the environment variable
+@code{GPG_TTY} has not been set correctly.  Make sure that it has been
+set to a real tty devce and not just to @samp{/dev/tty};
+i.e. @samp{GPG_TTY=tty} is plainly wrong; what you want is
+@samp{GPG_TTY=`tty`} --- note the back ticks.  Also make sure that
+this environment variable gets exported, that is you should follow up
+the setting with an @samp{export GPG_TTY} (assuming a Bourne style
+shell). Even for GUI based Pinentries; you should have set
+@code{GPG_TTY}. See the section on installing the @command{gpg-agent}
+on how to do it.
+
+
 
 @end itemize