~ubuntu-branches/ubuntu/natty/gnupg2/natty-security

« back to all changes in this revision

Viewing changes to doc/debugging.texi

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Urlichs
  • Date: 2005-12-08 22:13:21 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20051208221321-4rvs2vu835iam5wv
Tags: 1.9.19-2
* Convert debian/changelog to UTF-8.
* Put gnupg-agent and gpgsm lintian overrides in the respectively
  right package.  Closes: #335066
* Added debhelper tokens to maintainer scripts.
* xsession fixes:
  o Added host name to gpg-agent PID file name.  Closes: #312717
  o Fixed xsession script to be able to run under zsh.  Closes: #308516
  o Don't run gpg-agent if one is already running.  Closes: #336480
* debian/control:
  o Fixed package description of gpgsm package.  Closes: #299842
  o Added mention of gpg-agent to description of gnupg-agent package.
    Closes: #304355
* Thanks to Peter Eisentraut <petere@debian.org> for all of the above.

Show diffs side-by-side

added added

removed removed

Lines of Context:
18
18
@menu
19
19
* Debugging Tools::       Description of some useful tools
20
20
* Common Problems::       Commonly seen problems.
 
21
* Architecture Details::  How the whole thing works internally.
21
22
@end menu
22
23
 
23
24
 
105
106
on how to do it.
106
107
 
107
108
 
 
109
@item SSH hangs while a popping up pinentry was expected
 
110
 
 
111
SSH has no way to tell the gpg-agent what terminal or X display it is
 
112
running on.  So when remotely logging into a box where a gpg-agent with
 
113
SSH support is running, the pinentry will get popped up on whatever
 
114
display t he gpg-agent has been started.  To solve this problem you may
 
115
issue the command
 
116
 
 
117
@smallexample
 
118
echo UPDATESTARTUPTTY | gpg-connect-agent
 
119
@end smallexample
 
120
 
 
121
and the next pinentry will pop up on your display or screen. However,
 
122
you need to kill the running pinentry first because only one pinentry
 
123
may be running at once.  If you plan to use ssh on a new display you
 
124
should issue the above command before invoking ssh or any other service
 
125
making use of ssh.
 
126
 
108
127
 
109
128
@end itemize
110
129
 
 
130
 
 
131
@c ********************************************
 
132
@c ***  Architecture Details  *****************
 
133
@c ********************************************
 
134
@node Architecture Details
 
135
@section How the whole thing works internally.
 
136
 
 
137
 
 
138
@menu
 
139
* gpg 1.4 vs. 1.9::   Relationship between the two branches.
 
140
@end menu
 
141
 
 
142
@node gpg 1.4 vs. 1.9
 
143
@subsection  Relationship between the two branches.
 
144
 
 
145
Here is a little picture showing how the components work together:
 
146
 
 
147
@image{gnupg-card-architecture, 14cm}
 
148
 
 
149
@noindent
 
150
Lets try to explain it:
 
151
 
 
152
TO BE DONE.
 
153
 
 
154