pgg-ja.texi

   1 \input texinfo                  @c -*-texinfo-*-
   2
   3 @setfilename pgg-ja
   4 @iftex
   5 @firstparagraphindent insert
   6 @end iftex
   7
   8 @set VERSION 0.1
   9
  10 @copying
  11 This file describes PGG, an Emacs interface to various PGP implementations.
  12
  13 Copyright @copyright{} 2001, 2003, 2004, 2005, 2006, 2007  Free Software
  14 Foundation, Inc.
  15
  16 @quotation
  17 Permission is granted to copy, distribute and/or modify this document
  18 under the terms of the GNU Free Documentation License, Version 1.2 or
  19 any later version published by the Free Software Foundation; with no
  20 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  21 Texts.  A copy of the license is included in the section entitled ``GNU
  22 Free Documentation License.''.
  23
  24 \e$B$3$NJ8=q$r!"%U%j!<%=%U%H%&%'%":bCDH/9T$N\e(B GNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q\e(B
  25 \e$BBh\e(B 1.2 \e$BHG$^$?$O$=$l0J9_$NHG$,Dj$a$k>r7o$N2<$GJ#@=!"G[I[!"$"$k$$$OJQ99$9\e(B
  26 \e$B$k$3$H$r5v2D$7$^$9!#JQ99IT2DItJ,!"I=I=;f%F%-%9%H$*$h$SN"I=;f%F%-%9%H$O;X\e(B
  27 \e$BDj$7$^$;$s!#$3$NMxMQ5vBz7@Ls=q$NJ#<L$O!V\e(BGNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q!W$H\e(B
  28 \e$B$$$&>O$K4^$^$l$F$$$^$9!#\e(B
  29 @end quotation
  30 @end copying
  31
  32 @dircategory Emacs
  33 @direntry
  34 * PGG-ja: (pgg-ja).        Emacs interface to various PGP implementations (Ja).
  35 @end direntry
  36
  37 @settitle PGG @value{VERSION}
  38
  39 @titlepage
  40 @title PGG
  41
  42 @author by Daiki Ueno
  43 @page
  44
  45 @vskip 0pt plus 1filll
  46 @insertcopying
  47 @end titlepage
  48 @page
  49
  50 @node Top
  51 @top PGG
  52
  53 \e$B$3$l$O\e(B PGG \e$B$N%^%K%e%"%k$G$9!#\e(BPGG \e$B$O!"0BA4$JDL?.$N$?$a$NMM!9$J%D!<%k\e(B
  54 \e$B$H\e(B Emacs \e$B$NCg$r<h$j;}$D%i%$%V%i%j!<$G$9!#$^$?!"\e(BPGG \e$B$O\e(B MIME \e$B%a%C%;!<%8$N\e(B
  55 \e$B0E9f2=$H2rFI!"$=$l$K=pL>$H8!>Z$N$?$a$NC1=c$J%f!<%6!<%$%s%?%U%'!<%9$bDs6!\e(B
  56 \e$B$7$^$9!#\e(B
  57
  58 @menu
  59 * Overview::                    PGG \e$B$H$O\e(B
  60 * Prerequisites::               \e$B$"$i$+$8$a$7$F$*$/$Y$-J#;($J;vJA\e(B
  61 * How to use::                  \e$B$H$C$H$H;H$$;O$a$h$&\e(B
  62 * Architecture::
  63 * Parsing OpenPGP packets::
  64 * Function Index::
  65 * Variable Index::
  66 @end menu
  67
  68 @node Overview
  69 @chapter \e$B35MW\e(B
  70
  71 PGG \e$B$O!"0BA4$JDL?.$N$?$a$NMM!9$J%D!<%k$H\e(B Emacs \e$B$NCg$r<h$j;}$D%i%$%V%i%j!<\e(B
  72 \e$B$G$9!#F1MM$N5!G=$O\e(B Mailcrypt \e$B$b;}$C$F$$$^$9$,!"\e(BMailcrypt \e$B$O\e(B PGP/MIME \e$B$N\e(B
  73 \e$B%$%s%U%i$GDL>oMQ$$$i$l$kJ,N%$5$l$?\e(B PGP \e$B%a%C%;!<%8$r<h$j07$&$3$H$,$G$-$^\e(B
  74 \e$B$;$s!#$3$l$,!";d\e(B (\e$B:n<T\e(B) \e$B$,?7$7$$%i%$%V%i%j!<$r=q$$$?<g$JM}M3$G$9!#\e(B
  75
  76 PGP/MIME \e$B$O\e(B MIME Object Security Services (RFC1848) \e$B$N<BAu$G$9!#$=$NI8=`\e(B
  77 \e$B$O\e(B RFC2015 \e$B$G5-=R$5$l$F$$$^$9!#\e(B
  78
  79 @node Prerequisites
  80 @chapter \e$BI,MW>r7o\e(B
  81
  82 PGG \e$B$r;H$&$?$a$K$O!">/$J$/$H$b0l$D$N%W%i%$%P%7!<J]8n%7%9%F%`$N<BAu$,I,MW\e(B
  83 \e$B$G$9!#$3$N%^%K%e%"%k$O!"$=$N$h$&$J%W%m%0%i%`$r$9$G$K<hF@!"%$%s%9%H!<%k$7\e(B
  84 \e$B$F$$$F!"4pK\E*$J;H$$J}$rCN$C$F$$$k$3$H$rA[Dj$7$F$$$^$9!#\e(B
  85
  86 \e$B%G%#%U%)%k%H$G$O\e(B PGG \e$B$O\e(B GnuPG \e$B$r;H$$$^$9!#$=$N$h$&$J%7%9%F%`$K47$l$F$$$J\e(B
  87 \e$B$$$N$G$"$l$P!"\e(B@uref{http://www.gnupg.org/documentation/} \e$B$K$"$k\e(B GNU
  88 Privacy Handbook (GPH) \e$B$KL\$rDL$9$3$H$r4+$a$^$9!#\e(B
  89
  90 GnuPG \e$B$r;H$&>l9g$K$O\e(B @code{gpg-agent} \e$B$NMxMQ$r?d>)$7$^$9!#$=$l$O%P!<%8%g\e(B
  91 \e$B%s\e(B 2.0 \e$B0J9_$N\e(B GnuPG \e$B$H$H$b$KG[I[$5$l$F$$$^$9!#$3$l$O!"$I$s$J%W%m%H%3%k$r\e(B
  92 \e$B;H$&$+$H$OL54X78$KHkL)80$r4IM}$9$k%G!<%b%s$G!"%Q%9%U%l!<%:$rF~NO$7$F%-%c%C\e(B
  93 \e$B%7%e$9$k$?$a$N:G$b0BA4$J<jCJ$rDs6!$7$^$9\e(B (@pxref{Caching passphrase})\e$B!#\e(B
  94 \e$B$=$l$,2TF/$7$F$$$k>l9g!"\e(BPGG \e$B$O%G%#%U%)%k%H$G\e(B @code{gpg-agent} \e$B$r;H$*$&$H\e(B
  95 \e$B$7$^$9!#\e(B@xref{Invoking GPG-AGENT,,,gnupg,Using the GNU Privacy Guard}.
  96
  97 PGG \e$B$O\e(B Pretty Good Privacy \e$B%P!<%8%g%s\e(B 2 \e$B$^$?$O%P!<%8%g%s\e(B 5 \e$B$b%5%]!<%H$7\e(B
  98 \e$B$^$9!#\e(B
  99
 100 @node How to use
 101 @chapter \e$B;H$$J}\e(B
 102
 103 \e$B$3$N%i%$%V%i%j!<$N:G>e0L%$%s%?%U%'!<%9$O$H$F$bC1=c$G!"8x3+80$K$h$k0E9f$N\e(B
 104 \e$BA`:n$N$_$rA[Dj$7$F$$$^$9!#\e(B
 105
 106 PGG \e$B$r;H$&$?$a$K$O!"%"%W%j%1!<%7%g%s%W%m%0%i%`$NKAF,$G<!$N\e(B S \e$B<0$rI>2A$7\e(B
 107 \e$B$F2<$5$$!#\e(B
 108
 109 @lisp
 110 (require 'pgg)
 111 @end lisp
 112
 113 \e$B<B9T;~$K\e(B pgg.el \e$B$NB8:_$r3NG'$7$?$$$J$i!">e5-$NJ}K!$G$O$J$/0J2<$N$h$&$K!"\e(B
 114 \e$BI,MW$J5!G=$N\e(B autoload \e$B$r@_Dj$9$k$3$H$b$G$-$^$9!#\e(B
 115
 116 @lisp
 117 (autoload 'pgg-encrypt-region "pgg"
 118   "Encrypt the current region." t)
 119 (autoload 'pgg-encrypt-symmetric-region "pgg"
 120   "Encrypt the current region with symmetric algorithm." t)
 121 (autoload 'pgg-decrypt-region "pgg"
 122   "Decrypt the current region." t)
 123 (autoload 'pgg-sign-region "pgg"
 124   "Sign the current region." t)
 125 (autoload 'pgg-verify-region "pgg"
 126   "Verify the current region." t)
 127 (autoload 'pgg-insert-key "pgg"
 128   "Insert the ASCII armored public key." t)
 129 (autoload 'pgg-snarf-keys-region "pgg"
 130   "Import public keys in the current region." t)
 131 @end lisp
 132
 133 @menu
 134 * User Commands::
 135 * Selecting an implementation::
 136 * Caching passphrase::
 137 * Default user identity::
 138 @end menu
 139
 140 @node User Commands
 141 @section \e$B%f!<%6!<%3%^%s%I\e(B
 142
 143 \e$B$3$N;~E@$G!"$$$/$D$+$N0E9f$K4X$9$k%3%^%s%I$r;H$&$3$H$,$G$-$^$9!#$3$l$i$N\e(B
 144 \e$B%3%^%s%I$N5sF0$O5/F0J}K!$K0MB8$7$^$9!#$3$l$i$N%3%^%s%I$O!"%i%$%V%i%j!<4X\e(B
 145 \e$B?t$H$7$FMxMQ$5$l$k$3$H$b$"$k$+$i$G$9!#Nc$($P!"$"$J$?$,$"$k=pL><T$N8x3+80\e(B
 146 \e$B$r;}$C$F$$$J$$$H\e(B @code{pgg-verify-region} \e$B$H$$$&4X?t$OB(:B$K<:GT$7$^$9$,!"\e(B
 147 \e$B$3$l$,BPOCE*$K8F$S=P$5$l$?>l9g$K$O!"%5!<%P!<$+$i8x3+80$r%@%&%s%m!<%I$9$k\e(B
 148 \e$B$+$I$&$+$r$"$J$?$K?R$M$^$9!#\e(B
 149
 150 @deffn Command pgg-encrypt-region start end recipients &optional sign passphrase
 151 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$r\e(B @var{recipients} \e$B08$KAw$k$b$N$H$7\e(B
 152 \e$B$F0E9f2=$7$^$9!#BPOCE*$K8F$V$H!"<u?.<T$r?R$M$^$9!#\e(B
 153
 154 \e$B0E9f2=$K@.8y$9$k$H!"8=:_$NNN0h$NFbMF$r0E9f2=$7$?%G!<%?$GCV$-49$($^$9!#\e(B
 155
 156 \e$B%*%W%7%g%s0z?t\e(B @var{sign} \e$B$,\e(B @code{nil} \e$B$G$J$+$C$?$i!"=pL>$H0E9f2=$rF1;~\e(B
 157 \e$B$K9T$J$$$^$9!#8=:_$3$N5!G=$O\e(B GnuPG \e$B$GF0:n$9$k$3$H$,3NG'$5$l$F$$$^$9$,!"\e(B
 158 PGP \e$B$d\e(B PGP5 \e$B$G$OF0:n$7$J$$$+$b$7$l$^$;$s!#\e(B
 159
 160 \e$B%*%W%7%g%s0z?t\e(B @var{passphrase} \e$B$,\e(B @code{nil} \e$B$@$C$?$i!"%Q%9%U%l!<%:$N\e(B
 161 \e$B%-%c%C%7%e$+$i$+!"$^$?$O%f!<%6!<$KF~NO$7$F$b$i$&$3$H$K$h$C$F%Q%9%U%l!<%:\e(B
 162 \e$B$rF@$^$9!#\e(B
 163 @end deffn
 164
 165 @deffn Command pgg-encrypt-symmetric-region &optional start end passphrase
 166 \e$B8=:_$N\e(B @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$r!"6&DL800E9f\e(B (symmetric
 167 cipher) \e$B$G0E9f2=$7$^$9!#8F$S=P$7$?8e$G%Q%9%U%l!<%:$,?R$M$i$l$^$9!#\e(B
 168
 169 \e$B%*%W%7%g%s0z?t\e(B @var{passphrase} \e$B$,\e(B @code{nil} \e$B$@$C$?$i!"%Q%9%U%l!<%:$N\e(B
 170 \e$B%-%c%C%7%e$+$i$+!"$^$?$O%f!<%6!<$KF~NO$7$F$b$i$&$3$H$K$h$C$F%Q%9%U%l!<%:\e(B
 171 \e$B$rF@$^$9!#\e(B
 172
 173 \e$B6&DL800E9f$K$h$k0E9f2=$O!"8=:_\e(B GnuPG \e$B$@$1$G<BAu$5$l$F$$$^$9!#\e(B
 174 @end deffn
 175
 176 @deffn Command pgg-decrypt-region start end &optional passphrase
 177 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$r2rFI$7$^$9!#2rFI$K@.8y$9$k$H!"8=:_\e(B
 178 \e$B$NNN0h$NFbMF$r2rFI$7$?%G!<%?$GCV$-49$($^$9!#\e(B
 179
 180 \e$B%*%W%7%g%s0z?t\e(B @var{passphrase} \e$B$,\e(B @code{nil} \e$B$@$C$?$i!"%Q%9%U%l!<%:$N\e(B
 181 \e$B%-%c%C%7%e$+$i$+!"$^$?$O%f!<%6!<$KF~NO$7$F$b$i$&$3$H$K$h$C$F%Q%9%U%l!<%:\e(B
 182 \e$B$rF@$^$9!#\e(B
 183 @end deffn
 184
 185 @deffn Command pgg-sign-region start end &optional cleartext passphrase
 186 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$N%F%-%9%H$K=pL>$7$^$9!#;0HVL\$N%*%W%7%g%s\e(B
 187 \e$B0z?t\e(B @var{cleartext} \e$B$,\e(B @code{nil} \e$B$G$O$J$$$+!"$"$k$$$OBPOCE*$K8F$P$l$?\e(B
 188 \e$B>l9g!"J,N%$5$l$?=pL>$r:n$j$^$;$s!#$=$N$h$&$J>l9g$K$O!"8=:_$NNN0h$NFbMF$r\e(B
 189 \e$B=pL>$7$?%G!<%?$GCV$-49$($^$9!#\e(B
 190
 191 \e$B%*%W%7%g%s0z?t\e(B @var{passphrase} \e$B$,\e(B @code{nil} \e$B$@$C$?$i!"%Q%9%U%l!<%:$N\e(B
 192 \e$B%-%c%C%7%e$+$i$+!"$^$?$O%f!<%6!<$KF~NO$7$F$b$i$&$3$H$K$h$C$F%Q%9%U%l!<%:\e(B
 193 \e$B$rF@$^$9!#\e(B
 194 @end deffn
 195
 196 @deffn Command pgg-verify-region start end &optional signature fetch
 197 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$K$"$k=pL>$r8!>Z$7$^$9!#;0HVL\$N%*%W\e(B
 198 \e$B%7%g%s0z?t\e(B @var{signature} \e$B$,\e(B @code{nil} \e$B$G$J$+$C$?$i!"$=$N0z?t$O8=:_$N\e(B
 199 \e$BNN0h$NJ,N%$5$l$?=pL>$N%U%!%$%k$H$7$F<h$j07$o$l$^$9!#\e(B
 200
 201 \e$B;MHVL\$N%*%W%7%g%s0z?t\e(B @var{fetch} \e$B$,\e(B @code{nil} \e$B$G$O$J$$$+!"$"$k$$$OBP\e(B
 202 \e$BOCE*$K8F$P$l$?>l9g!"8x3+80$r%5!<%P!<$+$i<hF@$7$^$9!#\e(B
 203 @end deffn
 204
 205 @deffn Command pgg-insert-key
 206 \e$B%f!<%6!<$N8x3+80$r<hF@$7$F!"$=$l$r\e(B ASCII \e$BAu9C$N7A<0$GA^F~$7$^$9!#\e(B
 207 @end deffn
 208
 209 @deffn Command pgg-snarf-keys-region start end
 210 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$K$"$k8x3+80$r=8$a!"%f!<%6!<$N80\e(B
 211 \e$BB+\e(B (keyring) \e$B$KDI2C$7$^$9!#\e(B
 212 @end deffn
 213
 214 @node Selecting an implementation
 215 @section \e$B$I$N<BAu$r;H$&$+\e(B
 216
 217 PGP \e$B$ONr;K$,D9$/!":#$G$OB?$/$N<BAu$rMxMQ$9$k$3$H$,$G$-$k$N$G!"$=$l$>$l$,\e(B
 218 \e$B;}$C$F$$$k8D!9$N5!G=$,$:$$$V$s0[$J$C$F$$$k$3$H$,$"$j$^$9!#Nc$(\e(B
 219 \e$B$P\e(B GnuPG \e$B$r;H$C$F$$$k$N$J$i$P!"0E9f%"%k%4%j%:%`$H$7$F\e(B 3DES \e$B$d\e(B CAST5\e$B!"\e(B
 220 BLOWFISH \e$B$J$I$rA*$V$3$H$,$G$-$^$9$,!"\e(BPGP \e$B$N%P!<%8%g%s\e(B 2 \e$B$O\e(B IDEA \e$B$7$+%5%]!<\e(B
 221 \e$B%H$7$F$$$^$;$s!#\e(B
 222
 223 \e$B$I$N<BAu$r;H$&$+$O\e(B @code{pgg-scheme} \e$BJQ?t$,@)8f$7$^$9!#\e(B@code{nil} \e$B$@$C$?\e(B
 224 \e$B$i\e(B (\e$B$=$l$,%G%#%U%)%k%H\e(B)\e$B!"Be$o$j$K\e(B @code{pgg-default-scheme} \e$BJQ?t$NCM$r;H\e(B
 225 \e$B$$$^$9!#\e(B
 226
 227 @defvar pgg-scheme
 228 \e$B$I$N\e(B PGP \e$B<BAu$rMQ$$$k$+$r6/@)$7$^$9!#@_Dj$G$-$k$N$O\e(B @code{gpg}\e$B!"\e(B
 229 @code{pgp} \e$B$*$h$S\e(B @code{pgp5} \e$B$N$I$l$+$G$9!#%G%#%U%)%k%H$O\e(B @code{nil} \e$B$G\e(B
 230 \e$B$9!#\e(B
 231 @end defvar
 232
 233 @defvar pgg-default-scheme
 234 \e$B%G%#%U%)%k%H$N\e(B PGP \e$B<BAu$G$9!#CM$O\e(B @code{gpg}\e$B!"\e(B@code{pgp} \e$B$*$h\e(B
 235 \e$B$S\e(B @code{pgp5} \e$B$N$I$l$+$G$J$1$l$P$J$j$^$;$s!#%G%#%U%)%k%H\e(B
 236 \e$B$O\e(B @code{gpg} \e$B$G$9!#\e(B
 237 @end defvar
 238
 239 @node Caching passphrase
 240 @section \e$B%Q%9%U%l!<%:$r%-%c%C%7%e$9$k\e(B
 241
 242 PGP \e$B<BAu$H$7$F\e(B GnuPG (gpg) \e$B$r;H$&$N$G$"$l$P!"%Q%9%U%l!<%:$NF~NO$H%-%c%C\e(B
 243 \e$B%7%e\e(B@footnote{@code{gpg-agent} \e$B$O<B:]$K$O%Q%9%U%l!<%:$G$O$J$/$FHkL)80$r\e(B
 244 \e$B%-%c%C%7%e$7$^$9!#0lJ}%f!<%6!<$N;kE@$+$i$O!"$3$N5;=QE*$J:90[$O8+$($^$;\e(B
 245 \e$B$s!#\e(B}\e$B$9$k$?$a$K\e(B @code{gpg-agent} \e$B$H$$$&%W%m%0%i%`$r;H$&$3$H$r?d>)$7$^$9!#\e(B
 246
 247 @defvar pgg-gpg-use-agent
 248 @code{nil} \e$B$G$J$$CM$G$O!"2DG=$J>l9g$O>o$K$$$D$G$b\e(B @code{gpg-agent} \e$B$r;H\e(B
 249 \e$B$*$&$H$7$^$9!#%G%#%U%#%U%)%k%H$O\e(B @code{t} \e$B$G$9!#\e(B@code{gpg-agent} \e$B$,2TF/\e(B
 250 \e$B$7$F$$$J$$$+!"$^$?$O\e(B GnuPG \e$B$,8=:_$N\e(B PGP \e$B<BAu$H$7$FA*Br$5$l$F$$$J$$>l9g$O!"\e(B
 251 PGG \e$B<+?H$,;}$C$F$$$k%Q%9%U%l!<%:$r%-%c%C%7%e$9$k;EAH$_$,;H$o$l$^$9\e(B (\e$B2<5-\e(B
 252 \e$B;2>H\e(B)\e$B!#\e(B
 253 @end defvar
 254
 255 PGG \e$B$G\e(B @code{gpg-agent}\e$B$r;H$&$K$O!"Bh0l$K\e(B @code{gpg-agent} \e$B$,3N<B$K2TF/\e(B
 256 \e$B$7$F$$$k$h$&$K$7$F2<$5$$!#Nc$($P\e(B X Window System \e$B$rAv$i$;$F$$$k$N$G$"$l\e(B
 257 \e$B$P!"0J2<$N9T$r$"$J$?$N\e(B @file{.xsession} \e$B%U%!%$%k$KCV$/$3$H$K$h$C$F!"$=$l\e(B
 258 \e$B$r3N<B$K$9$k$3$H$,$G$-$^$9\e(B:
 259
 260 @smallexample
 261 eval "$(gpg-agent --daemon)"
 262 @end smallexample
 263
 264 @code{gpg-agent} \e$B$N5/F0$K4X$9$k$5$i$K>\$7$$$3$H$O!"\e(B@xref{Invoking
 265 GPG-AGENT,,,gnupg,Using the GNU Privacy Guard}.
 266
 267 GnuPG \e$B$N%Q%9%U%l!<%:$rI,MW$H$9$k\e(B PGG \e$B$N5!G=$r<B9T$9$k$H$-$O$$$D$b!"\e(B
 268 GnuPG \e$B$O\e(B @code{gpg-agent} \e$B$H$d$j<h$j$r9T$J$$!"$=$l$O$"$J$?$K%Q%9%U%l!<%:\e(B
 269 \e$B$rF~NO$9$k$3$H$rMW5a$7$^$9!#$7$+$7\e(B @code{gpg-agent} \e$B$,$=$N7k2L$r!V%-%c%C\e(B
 270 \e$B%7%e!W$9$k$N$G!"<!2s0J9_$N<B9T$G$O:F$S%Q%9%U%l!<%:$NF~NO$OMW$j$^$;$s!#\e(B
 271 (\e$BDL>o$3$N%-%c%C%7%e$O0lDj;~4V7P2a8e$K4|8B@Z$l>C5n$5$l$^$9!#$3$l$rJQ99$9\e(B
 272 \e$B$k$K$O!"\e(B@code{gpg-agent} \e$B$r5/F0$9$k$H$-$K\e(B @code{--default-cache-ttl} \e$B%*\e(B
 273 \e$B%W%7%g%s$r;H$C$F2<$5$$!#\e(B)
 274
 275 X Window System \e$B$N4D6-$G$O\e(B @code{gpg-agent} \e$B$O%Q%9%U%l!<%:$NF~NO$rMW5a$9\e(B
 276 \e$B$k$?$a$K%0%i%U%#%C%/$J%&%#%s%I%&$r3+$-$^$9!#$7$+$7J8;zC<Kv$G\e(B Emacs \e$B$r;H$C\e(B
 277 \e$B$F$$$k>l9g$O!"\e(B@code{gpg-agent} \e$B$OC<Kv$+$i$NF~NO$r<u$1<h$k>e$GLdBj$,$"$j\e(B
 278 \e$B$^$9!#$=$l$,\e(B Emacs \e$B$KAw$i$l$F$7$^$&$+$i$G$9!#$3$NLdBj$KBP=h$9$k$?$a$N;C\e(B
 279 \e$BDjE*$JBP:v$N$R$H$D$O!"\e(B@code{gpg-agent} \e$B$r\e(B @code{--keep-tty} \e$B%*%W%7%g%s$H\e(B
 280 \e$B$H$b$K\e(B Emacs \e$B$H$OJL$NC<Kv$GAv$i$;$k$3$H$G$9!#$3$l$O\e(B @code{gpg-agent} \e$B$K!"\e(B
 281 \e$B%Q%9%U%l!<%:$NF~NO$K$=$l<+?H$NC<Kv$r;H$&$h$&$K$5$;$^$9!#\e(B
 282
 283 @code{gpg-agent} \e$B$r;H$o$J$$>l9g!"\e(BPGG \e$B$O\e(B Emacs \e$B$r2p$7$F%Q%9%U%l!<%:$NF~NO\e(B
 284 \e$B$rMW5a$7$^$9!#$3$l$K$O%Q%9%U%l!<%:$r%-%c%C%7%e$9$k;EAH$_$,$"$j!"$=$l$OJQ\e(B
 285 \e$B?t\e(B @code{pgg-cache-passphrase} \e$B$G@)8f$5$l$^$9\e(B (\e$B2<5-;2>H\e(B)\e$B!#\e(B
 286
 287 @code{gpg-agent} \e$B$G$O$J$/\e(B PGG \e$B$G%Q%9%U%l!<%:$r07$&>l9g$K$O0BA4>e$N%j%9%/\e(B
 288 \e$B$,$"$j$^$9!#\e(BEmacs \e$B$NMW5a$K=>$C$F%Q%9%U%l!<%:$rF~NO$9$k$H!"$=$l$O0l;~E*\e(B
 289 \e$B$K\e(B Emacs \e$B$,<B9T$7$F$$$k%a%b%j!<$K\e(B cleartext \e$BJ8;zNs$H$7$F3JG<$5$l$^$9!#$b\e(B
 290 \e$B$7$=$N%a%b%j!<$,%G%#%9%/$H$N4V$G\e(B swap \e$B$5$l$k$H!"M}O@>e\e(B root \e$B%f!<%6!<$O%Q\e(B
 291 \e$B%9%U%l!<%:$r\e(B swap \e$B%U%!%$%k$+$iCj=P$9$k$3$H$,$G$-$^$9!#$=$N>e!"$=$N%7%9%F\e(B
 292 \e$B%`$,GQ4~$5$l$?$jEpFq$K2q$C$?8e$b!"$=$N\e(B cleartext \e$B$N%Q%9%U%l!<%:$,4^$^$l\e(B
 293 \e$B$F$$$k\e(B swap \e$B%U%!%$%k$O%G%#%9%/$K;D$C$F$$$k$+$b$7$l$J$$$N$G$9!#\e(B
 294 @code{gpg-agent} \e$B$O%a%b%j!<$r\e(B lock \e$B$9$k$h$&$J:v$r$b$C$F!"$3$NLdBj$r2sHr\e(B
 295 \e$B$7$F$$$^$9!#$=$l$O\e(B Emacs \e$B$K$O<BAu$5$l$F$$$^$;$s!#\e(B
 296
 297 @defvar pgg-cache-passphrase
 298 @code{nil} \e$B$G$J$1$l$P!"%Q%9%U%l!<%:$rJ];}$7$^$9!#=i4|CM$O\e(B @code{t} \e$B$G$9!#\e(B
 299 \e$B$7$+$7!"$"$J$?$,%;%-%e%j%F%#$K$D$$$F5$3]$+$j$J$i!"$3$NJQ?t\e(B
 300 \e$B$r\e(B @code{nil} \e$B$K@_Dj$9$k$3$H$K$h$C$F!"%Q%9%U%l!<%:$N%-%c%C%7%e$r$d$a$5$;\e(B
 301 \e$B$k$3$H$,$G$-$^$9!#\e(B
 302 @end defvar
 303
 304 @defvar pgg-passphrase-cache-expiry
 305 \e$B%Q%9%U%l!<%:$rJ];}$7$F$*$/;~4V$rIC$G;XDj$7$^$9!#\e(B
 306 @end defvar
 307
 308 @node Default user identity
 309 @section \e$B%G%#%U%)%k%H$N%f!<%6!<\e(B ID
 310
 311 \e$BDL>o\e(B PGP \e$B$N<BAu$O!"0E9f2=$*$h$SI|9f2=$K;H$&E,@Z$J80$rA*$V$3$H$,$G$-$^$9\e(B
 312 \e$B$,!"$"$J$?$,0l$D0J>e$N80$r;}$C$F$$$k>l9g!"MQ$$$k80$N\e(B id \e$B$r;XDj$9$kI,MW$,\e(B
 313 \e$B$"$j$^$9!#\e(B
 314
 315 @defvar pgg-default-user-id
 316 \e$B%G%#%U%)%k%H$N%f!<%6!<\e(B ID \e$B$G$9!#;XDj$7$J$$>l9g\e(B
 317 \e$B$O\e(B @samp{(user-login-name)} \e$B$NLa$jCM$,%G%#%U%)%k%H$K$J$j$^$9!#$3$NJQ?t$O\e(B
 318 \e$B%+%9%?%^%$%:2DG=$G$9!#\e(B
 319 @end defvar
 320
 321 @defvar pgg-gpg-user-id
 322 GnuPG \e$B$G;H$&%G%#%U%)%k%H$N%f!<%6!<\e(B ID \e$B$G$9!#%G%#%U%)%k%H$O\e(B @samp{nil} \e$B$G\e(B
 323 \e$B$9!#\e(B@code{nil} \e$B$G$O$J$$CM$K$9$k$H!"\e(B@samp{pgg-default-user-id} \e$B$h$jM%@h$7\e(B
 324 \e$B$F;H$o$l$^$9!#%+%9%?%^%$%:2DG=$G$9!#\e(B
 325 @end defvar
 326
 327 @defvar pgg-pgp-user-id
 328 PGP 2.x/6.x \e$B$G;H$&%G%#%U%)%k%H$N%f!<%6!<\e(B ID \e$B$G$9!#%G%#%U%)%k%H\e(B
 329 \e$B$O\e(B @samp{nil} \e$B$G$9!#\e(B@code{nil} \e$B$G$O$J$$CM$K$9$k$H!"\e(B
 330 @samp{pgg-default-user-id} \e$B$h$jM%@h$7$F;H$o$l$^$9!#%+%9%?%^%$%:2DG=$G$9!#\e(B
 331 @end defvar
 332
 333 @defvar pgg-pgp5-user-id
 334 PGP 5.x \e$B$G;H$&%G%#%U%)%k%H$N%f!<%6\e(B ID \e$B$G$9!#%G%#%U%)%k%H$O\e(B @samp{nil} \e$B$G\e(B
 335 \e$B$9!#\e(B@code{nil} \e$B$G$O$J$$CM$K$9$k$H!"\e(B@samp{pgg-default-user-id} \e$B$h$jM%@h$7\e(B
 336 \e$B$F;H$o$l$^$9!#%+%9%?%^%$%:2DG=$G$9!#\e(B
 337 @end defvar
 338
 339 @node Architecture
 340 @chapter \e$B9=@.\e(B
 341
 342 PGG \e$B$O!V\e(BPGP \e$B<BAu$N%9%-!<%`\e(B (\e$BOHAH\e(B)\e$B!W$H$$$&9M$($rF3F~$7$^$9!#0J8e!"!V%9%-!<\e(B
 343 \e$B%`\e(B (scheme)\e$B!W$HI=5-$7$^$9!#$3$NMQ8l$O\e(B luna object system \e$B$G$N\e(B singleton
 344 object \e$B$KM3Mh$7$^$9!#\e(B
 345
 346 PGG \e$B$O\e(B PGP \e$B$N5!G=$K%"%/%;%9$9$k$HF1;~$K$=$l$r3+H/$9$k$?$a$K@_7W$5$l$?$N\e(B
 347 \e$B$G!"$=$N9=@.$O!"Aj8_1?MQ@-$@$1$G$J$/3HD%@-$b9MN8$9$kI,MW$,$"$j$^$7$?!#$3\e(B
 348 \e$B$N>O$G$O!"\e(BPGG \e$B$N%P%C%/%(%s%I$r$I$N$h$&$K5-=R$9$k$+$rC5$7$J$,$i!"\e(BPGG \e$B$,$I\e(B
 349 \e$B$N$h$&$K$D$/$i$l$F$$$k$+$rC58!$7$F$_$^$7$g$&!#\e(B
 350
 351 @menu
 352 * Initializing::
 353 * Back end methods::
 354 * Getting output::
 355 @end menu
 356
 357 @node Initializing
 358 @section \e$B=i4|2=\e(B
 359
 360 \e$B%9%-!<%`$O!";H$&A0$K=i4|2=$5$l$J$1$l$P$J$j$^$;$s!#$?$@0l$D$N%9%-!<%`$r;H\e(B
 361 \e$B$&$3$H$rJ]>Z$9$k$N$,NI$$$G$7$g$&!#\e(B
 362
 363 \e$B0J2<$N%3!<%I$O\e(B @file{pgg-gpg.el} \e$B$+$i$NH4$-=q$-$G$9!#$"\e(B
 364 \e$B$k\e(B @code{pgg-gpg} \e$B$N%9%-!<%`$,$$$C$?$s=i4|2=$5$l$k$H!"$=$l\e(B
 365 \e$B$O\e(B @code{pgg-scheme-gpg-instance} \e$BJQ?t$KJ]B8$5$l!"0J8e!":FMxMQ$5$l$^$9!#\e(B
 366
 367 @lisp
 368 (defvar pgg-scheme-gpg-instance nil)
 369
 370 (defun pgg-make-scheme-gpg ()
 371   (or pgg-scheme-gpg-instance
 372       (setq pgg-scheme-gpg-instance
 373             (luna-make-entity 'pgg-scheme-gpg))))
 374 @end lisp
 375
 376 \e$B4X?t$NL>A0$O\e(B @code{pgg-make-scheme-} \e$B$N8e$m$K%P%C%/%(%s%IL>$rIU2C$7$?$b\e(B
 377 \e$B$N$K$7$J$1$l$P$J$j$^$;$s!#\e(B
 378
 379 @node Back end methods
 380 @section \e$B%P%C%/%(%s%I$N%a%=%C%I\e(B
 381
 382 \e$B3F%P%C%/%(%s%I$K$O!"$3$l$i$N%a%=%C%I$,B8:_$7$J$1$l$P$J$j$^$;$s!#%a%=%C%I\e(B
 383 \e$B$N<B9T7k2L$N%9%F!<%?%9$rCN$i$;$J$1$l$P$J$i$J$$$N$G!"%a%=%C%I$N=PNO$OFCJL\e(B
 384 \e$B$J%P%C%U%!!<$KJ]B8$5$l$^$9\e(B (@pxref{Getting output})\e$B!#\e(B
 385
 386 @deffn Method pgg-scheme-lookup-key scheme string &optional type
 387 @var{string} \e$B$K4XO"IU$1$i$l$?80$rJV$7$^$9!#;0HVL\$N%*%W%7%g%s0z\e(B
 388 \e$B?t\e(B @var{type} \e$B$,Hs\e(B-@code{nil} \e$B$@$C$?$i!"HkL)$N80B+$+$i8!:w$7$^$9!#\e(B
 389 @end deffn
 390
 391 @deffn Method pgg-scheme-encrypt-region scheme start end recipients &optional sign passphrase
 392 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$r\e(B @var{recipients} \e$B08$KAw$k$b$N$H$7\e(B
 393 \e$B$F0E9f2=$7$^$9!#%*%W%7%g%s0z?t\e(B @var{sign} \e$B$,\e(B @code{nil} \e$B$G$J$+$C$?$i!"=p\e(B
 394 \e$BL>$H0E9f2=$rF1;~$K9T$J$$$^$9!#0E9f2=$K@.8y$9$k$H\e(B @code{t} \e$B$r!"<:GT$9$k\e(B
 395 \e$B$H\e(B @code{nil} \e$B$rJV$7$^$9!#\e(B
 396 @end deffn
 397
 398 @deffn Method pgg-scheme-encrypt-symmetric-region scheme start end &optional passphrase
 399 \e$B8=:_$N\e(B @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$r!"6&DL800E9f\e(B (symmetric
 400 cipher) \e$B$H%Q%9%U%l!<%:$G0E9f2=$7$^$9!#0E9f2=$K@.8y$9$k$H\e(B @code{t} \e$B$rJV$7!"\e(B
 401 \e$B$=$&$G$J$1$l$P\e(B @code{nil} \e$B$rJV$7$^$9!#$3$N5!G=$O8=:_\e(B GnuPG \e$B$@$1$G<BAu$5\e(B
 402 \e$B$l$F$$$^$9!#\e(B
 403 @end deffn
 404
 405 @deffn Method pgg-scheme-decrypt-region scheme start end &optional passphrase
 406 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$r2rFI$7$^$9!#2rFI$K@.8y$9$k\e(B
 407 \e$B$H\e(B @code{t} \e$B$r!"<:GT$9$k$H\e(B @code{nil} \e$B$rJV$7$^$9!#\e(B
 408 @end deffn
 409
 410 @deffn Method pgg-scheme-sign-region scheme start end &optional cleartext passphrase
 411 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$N%F%-%9%H$K=pL>$7$^$9!#;0HVL\$N%*%W%7%g%s\e(B
 412 \e$B0z?t\e(B @var{cleartext} \e$B$,\e(B @code{nil} \e$B$G$O$J$$>l9g!"J,N%$5$l$?=pL>$r:n$j$^\e(B
 413 \e$B$;$s!#=pL>$K@.8y$9$k$H\e(B @code{t} \e$B$r!"<:GT$9$k$H\e(B @code{nil} \e$B$rJV$7$^$9!#\e(B
 414 @end deffn
 415
 416 @deffn Method pgg-scheme-verify-region scheme start end &optional signature
 417 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$K$"$k=pL>$r8!>Z$7$^$9!#;0HVL\$N%*%W\e(B
 418 \e$B%7%g%s0z?t\e(B @var{signature} \e$B$,\e(B @code{nil} \e$B$G$J$+$C$?$i!"$=$N0z?t$O8=:_$N\e(B
 419 \e$BNN0h$NJ,N%$5$l$?=pL>$N%U%!%$%k$H$7$F<h$j07$o$l$^$9!#=pL>$,@5$7$/8!>Z$5$l\e(B
 420 \e$B$?>l9g$O\e(B @code{t} \e$B$r!"<:GT$9$k$H\e(B @code{nil} \e$B$rJV$7$^$9!#\e(B
 421 @end deffn
 422
 423 @deffn Method pgg-scheme-insert-key scheme
 424 \e$B%f!<%6!<$N8x3+80$r<hF@$7$F!"$=$l$r\e(B ASCII \e$BAu9C$N7A<0$GA^F~$7$^$9!#@.8y$9\e(B
 425 \e$B$k$H\e(B @code{t} \e$B$r!"<:GT$9$k$H\e(B @code{nil} \e$B$rJV$7$^$9!#\e(B
 426 @end deffn
 427
 428 @deffn Method pgg-scheme-snarf-keys-region scheme start end
 429 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$K$"$k8x3+80$r=8$a!"%f!<%6!<$N80\e(B
 430 \e$BB+\e(B (keyring) \e$B$KDI2C$7$^$9!#@.8y$9$k$H\e(B @code{t} \e$B$r!"<:GT$9$k\e(B
 431 \e$B$H\e(B @code{nil} \e$B$rJV$7$^$9!#\e(B
 432 @end deffn
 433
 434 @node Getting output
 435 @section \e$B=PNO$rF@$k\e(B
 436
 437 \e$B%P%C%/%(%s%I%a%=%C%I\e(B (@pxref{Back end methods}) \e$B$N=PNO$OFCJL$J%P%C%U%!!<\e(B
 438 \e$B$K3JG<$5$l$^$9!#$7$?$,$C$F!"$3$l$i$N%a%=%C%I$O<B9T7k2L$rEA$($kI,MW$,$"$j\e(B
 439 \e$B$^$9!#\e(B
 440
 441 @defvar pgg-errors-buffer
 442 PGP \e$B%3%^%s%I<B9T;~$NI8=`%(%i!<=PNO$O!"$3$N%P%C%U%!!<$K3JG<$5$l$^$9!#\e(B
 443 @end defvar
 444
 445 @defvar pgg-output-buffer
 446 PGP \e$B%3%^%s%I<B9T;~$NI8=`=PNO$O!"$3$N%P%C%U%!!<$K3JG<$5$l$^$9!#\e(B
 447 @end defvar
 448
 449 @defvar pgg-status-buffer
 450 PGP \e$B%3%^%s%I<B9T;~$N$=$NB>$N7k2L$N>pJs$O!"$3$N%P%C%U%!!<$K3JG<$5$l$^$9!#\e(B
 451 @end defvar
 452
 453 @node Parsing OpenPGP packets
 454 @chapter OpenPGP \e$B%Q%1%C%H$N2r@O\e(B
 455
 456 OpenPGP \e$B$N%a%C%;!<%8$N%U%)!<%^%C%H$O!"Aj8_1?MQ$G$-$k%"%W%j%1!<%7%g%s3+H/\e(B
 457 \e$B$KI,MW$J$9$Y$F$N>pJs$r=PNO$9$k$h$&$K0];}$5$l$F$$$^$9!#$=$NI8=`\e(B
 458 \e$B$O\e(B RFC2440 \e$B$K5-:\$5$l$F$$$^$9!#\e(B
 459
 460 PGG \e$B$O\e(B OpenPGP \e$B%Q%1%C%H$KBP1~$7$?FH<+$N%a%C%;!<%82r@O$r9T$J$$$^$9!#\e(B
 461
 462 @defun pgg-parse-armor string
 463 @var{string} \e$BFb$N%Q%1%C%H$NJB$S$r\e(B @code{list} \e$B$N7A<0$GJV$7$^$9!#\e(B
 464 @end defun
 465
 466 @defun pgg-parse-armor-region start end
 467 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$K$"$k%Q%1%C%H$NJB$S$r\e(B @code{list} \e$B$N\e(B
 468 \e$B7A<0$GJV$7$^$9!#\e(B
 469 @end defun
 470
 471 @defvar pgg-ignore-packet-checksum
 472 @code{nil} \e$B$G$J$+$C$?$i!"%Q%1%C%H$N%A%'%C%/%5%`$r8!>Z$7$^$;$s!#\e(B
 473 @end defvar
 474
 475 @node Function Index
 476 @chapter Function Index
 477 @printindex fn
 478
 479 @node Variable Index
 480 @chapter Variable Index
 481 @printindex vr
 482
 483 @summarycontents
 484 @contents
 485 @bye
 486
 487 @c Local Variables:
 488 @c coding: iso-2022-7bit
 489 @c fill-column: 72
 490 @c mode: texinfo
 491 @c use-kuten-for-period: t
 492 @c use-touten-for-comma: t
 493 @c End: