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 PGG \e$B$OC1=c$J%a%+%K%:%`$r;H$C$F%Q%9%U%l!<%:$r%-%c%C%7%e$7$^$9!#$=$l$r9T$J\e(B
 243 \e$B$&$3$H$O!"%G%#%U%)%k%H$GM-8z$K$J$C$F$$$^$9!#\e(B
 244
 245 @defvar pgg-cache-passphrase
 246 @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
 247 \e$B$7$+$7!"$"$J$?$,%;%-%e%j%F%#$K$D$$$F5$3]$+$j$J$i!"$3$NJQ?t\e(B
 248 \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
 249 \e$B$k$3$H$,$G$-$^$9!#\e(B
 250 @end defvar
 251
 252 @defvar pgg-passphrase-cache-expiry
 253 \e$B%Q%9%U%l!<%:$rJ];}$7$F$*$/;~4V$rIC$G;XDj$7$^$9!#\e(B
 254 @end defvar
 255
 256 @defvar pgg-gpg-use-agent
 257 PGP \e$B<BAu$H$7$F\e(B GnuPG (gpg) \e$B$r;H$&>l9g!"%-%c%C%7%e$N$?$a\e(B
 258 \e$B$K\e(B @code{gpg-agent} \e$B$rJ;MQ$9$k$3$H$,$G$-$^$9!#\e(B@footnote{\e$B<B:]$K\e(B
 259 \e$B$O\e(B @code{gpg-agent} \e$B$O%Q%9%U%l!<%:$G$O$J$/HkL)80$r%-%c%C%7%e$7$^$9!#$b$C\e(B
 260 \e$B$H$b!"$3$N5;=QE*$J0c$$$O%f!<%6!<$K$O8+$($^$;$s$,!#\e(B} \e$B%G%#%U%)%k%HCM\e(B
 261 \e$B$O\e(B @code{t} \e$B$G$9!#$3$l$r\e(B @code{nil} \e$B$K@_Dj$9$k$3$H$O?d>)$5$l$^$;$s!#\e(B
 262 @end defvar
 263
 264 @node Default user identity
 265 @section \e$B%G%#%U%)%k%H$N%f!<%6!<\e(B ID
 266
 267 \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
 268 \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
 269 \e$B$"$j$^$9!#\e(B
 270
 271 @defvar pgg-default-user-id
 272 \e$B%G%#%U%)%k%H$N%f!<%6!<\e(B ID \e$B$G$9!#;XDj$7$J$$>l9g\e(B
 273 \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
 274 \e$B%+%9%?%^%$%:2DG=$G$9!#\e(B
 275 @end defvar
 276
 277 @defvar pgg-gpg-user-id
 278 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
 279 \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
 280 \e$B$F;H$o$l$^$9!#%+%9%?%^%$%:2DG=$G$9!#\e(B
 281 @end defvar
 282
 283 @defvar pgg-pgp-user-id
 284 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
 285 \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
 286 @samp{pgg-default-user-id} \e$B$h$jM%@h$7$F;H$o$l$^$9!#%+%9%?%^%$%:2DG=$G$9!#\e(B
 287 @end defvar
 288
 289 @defvar pgg-pgp5-user-id
 290 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
 291 \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
 292 \e$B$F;H$o$l$^$9!#%+%9%?%^%$%:2DG=$G$9!#\e(B
 293 @end defvar
 294
 295 @node Architecture
 296 @chapter \e$B9=@.\e(B
 297
 298 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
 299 \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
 300 object \e$B$KM3Mh$7$^$9!#\e(B
 301
 302 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
 303 \e$B$G!"$=$N9=@.$O!"Aj8_1?MQ@-$@$1$G$J$/3HD%@-$b9MN8$9$kI,MW$,$"$j$^$7$?!#$3\e(B
 304 \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
 305 \e$B$N$h$&$K$D$/$i$l$F$$$k$+$rC58!$7$F$_$^$7$g$&!#\e(B
 306
 307 @menu
 308 * Initializing::
 309 * Back end methods::
 310 * Getting output::
 311 @end menu
 312
 313 @node Initializing
 314 @section \e$B=i4|2=\e(B
 315
 316 \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
 317 \e$B$&$3$H$rJ]>Z$9$k$N$,NI$$$G$7$g$&!#\e(B
 318
 319 \e$B0J2<$N%3!<%I$O\e(B @file{pgg-gpg.el} \e$B$+$i$NH4$-=q$-$G$9!#$"\e(B
 320 \e$B$k\e(B @code{pgg-gpg} \e$B$N%9%-!<%`$,$$$C$?$s=i4|2=$5$l$k$H!"$=$l\e(B
 321 \e$B$O\e(B @code{pgg-scheme-gpg-instance} \e$BJQ?t$KJ]B8$5$l!"0J8e!":FMxMQ$5$l$^$9!#\e(B
 322
 323 @lisp
 324 (defvar pgg-scheme-gpg-instance nil)
 325
 326 (defun pgg-make-scheme-gpg ()
 327   (or pgg-scheme-gpg-instance
 328       (setq pgg-scheme-gpg-instance
 329             (luna-make-entity 'pgg-scheme-gpg))))
 330 @end lisp
 331
 332 \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
 333 \e$B$N$K$7$J$1$l$P$J$j$^$;$s!#\e(B
 334
 335 @node Back end methods
 336 @section \e$B%P%C%/%(%s%I$N%a%=%C%I\e(B
 337
 338 \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
 339 \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
 340 \e$B$J%P%C%U%!!<$KJ]B8$5$l$^$9\e(B (@pxref{Getting output})\e$B!#\e(B
 341
 342 @deffn Method pgg-scheme-lookup-key scheme string &optional type
 343 @var{string} \e$B$K4XO"IU$1$i$l$?80$rJV$7$^$9!#;0HVL\$N%*%W%7%g%s0z\e(B
 344 \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
 345 @end deffn
 346
 347 @deffn Method pgg-scheme-encrypt-region scheme start end recipients &optional sign passphrase
 348 @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
 349 \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
 350 \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
 351 \e$B$H\e(B @code{nil} \e$B$rJV$7$^$9!#\e(B
 352 @end deffn
 353
 354 @deffn Method pgg-scheme-encrypt-symmetric-region scheme start end &optional passphrase
 355 \e$B8=:_$N\e(B @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$r!"6&DL800E9f\e(B (symmetric
 356 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
 357 \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
 358 \e$B$l$F$$$^$9!#\e(B
 359 @end deffn
 360
 361 @deffn Method pgg-scheme-decrypt-region scheme start end &optional passphrase
 362 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$r2rFI$7$^$9!#2rFI$K@.8y$9$k\e(B
 363 \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
 364 @end deffn
 365
 366 @deffn Method pgg-scheme-sign-region scheme start end &optional cleartext passphrase
 367 @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
 368 \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
 369 \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
 370 @end deffn
 371
 372 @deffn Method pgg-scheme-verify-region scheme start end &optional signature
 373 @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
 374 \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
 375 \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
 376 \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
 377 @end deffn
 378
 379 @deffn Method pgg-scheme-insert-key scheme
 380 \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
 381 \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
 382 @end deffn
 383
 384 @deffn Method pgg-scheme-snarf-keys-region scheme start end
 385 @var{start} \e$B$H\e(B @var{end} \e$B$N4V$NNN0h$K$"$k8x3+80$r=8$a!"%f!<%6!<$N80\e(B
 386 \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
 387 \e$B$H\e(B @code{nil} \e$B$rJV$7$^$9!#\e(B
 388 @end deffn
 389
 390 @node Getting output
 391 @section \e$B=PNO$rF@$k\e(B
 392
 393 \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
 394 \e$B$K3JG<$5$l$^$9!#$7$?$,$C$F!"$3$l$i$N%a%=%C%I$O<B9T7k2L$rEA$($kI,MW$,$"$j\e(B
 395 \e$B$^$9!#\e(B
 396
 397 @defvar pgg-errors-buffer
 398 PGP \e$B%3%^%s%I<B9T;~$NI8=`%(%i!<=PNO$O!"$3$N%P%C%U%!!<$K3JG<$5$l$^$9!#\e(B
 399 @end defvar
 400
 401 @defvar pgg-output-buffer
 402 PGP \e$B%3%^%s%I<B9T;~$NI8=`=PNO$O!"$3$N%P%C%U%!!<$K3JG<$5$l$^$9!#\e(B
 403 @end defvar
 404
 405 @defvar pgg-status-buffer
 406 PGP \e$B%3%^%s%I<B9T;~$N$=$NB>$N7k2L$N>pJs$O!"$3$N%P%C%U%!!<$K3JG<$5$l$^$9!#\e(B
 407 @end defvar
 408
 409 @node Parsing OpenPGP packets
 410 @chapter OpenPGP \e$B%Q%1%C%H$N2r@O\e(B
 411
 412 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
 413 \e$B$KI,MW$J$9$Y$F$N>pJs$r=PNO$9$k$h$&$K0];}$5$l$F$$$^$9!#$=$NI8=`\e(B
 414 \e$B$O\e(B RFC2440 \e$B$K5-:\$5$l$F$$$^$9!#\e(B
 415
 416 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
 417
 418 @defun pgg-parse-armor string
 419 @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
 420 @end defun
 421
 422 @defun pgg-parse-armor-region start end
 423 @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
 424 \e$B7A<0$GJV$7$^$9!#\e(B
 425 @end defun
 426
 427 @defvar pgg-ignore-packet-checksum
 428 @code{nil} \e$B$G$J$+$C$?$i!"%Q%1%C%H$N%A%'%C%/%5%`$r8!>Z$7$^$;$s!#\e(B
 429 @end defvar
 430
 431 @node Function Index
 432 @chapter Function Index
 433 @printindex fn
 434
 435 @node Variable Index
 436 @chapter Variable Index
 437 @printindex vr
 438
 439 @summarycontents
 440 @contents
 441 @bye
 442
 443 @c Local Variables:
 444 @c coding: iso-2022-7bit
 445 @c fill-column: 72
 446 @c mode: texinfo
 447 @c use-kuten-for-period: t
 448 @c use-touten-for-comma: t
 449 @c End: