* epg.el (epg-start-decrypt): Append "--" to the end of options.
[elisp/epg.git] / epg.el
1 ;;; epg.el --- the EasyPG Library
2 ;; Copyright (C) 1999, 2000, 2002, 2003, 2004,
3 ;;   2005, 2006 Free Software Foundation, Inc.
4 ;; Copyright (C) 2006 Daiki Ueno
5
6 ;; Author: Daiki Ueno <ueno@unixuser.org>
7 ;; Keywords: PGP, GnuPG
8
9 ;; This file is part of EasyPG.
10
11 ;; This program is free software; you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation; either version 2, or (at your option)
14 ;; any later version.
15
16 ;; This program is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19 ;; GNU General Public License for more details.
20
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
23 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
24 ;; Boston, MA 02110-1301, USA.
25
26 ;;; Code:
27
28 (require 'epg-config)
29
30 (defvar epg-user-id nil
31   "GnuPG ID of your default identity.")
32
33 (defvar epg-user-id-alist nil
34   "An alist mapping from key ID to user ID.")
35
36 (defvar epg-read-point nil)
37 (defvar epg-process-filter-running nil)
38 (defvar epg-pending-status-list nil)
39 (defvar epg-key-id nil)
40 (defvar epg-context nil)
41 (defvar epg-debug-buffer nil)
42
43 ;; from gnupg/include/cipher.h
44 (defconst epg-cipher-algorithm-alist
45   '((0 . "NONE")
46     (1 . "IDEA")
47     (2 . "3DES")
48     (3 . "CAST5")
49     (4 . "BLOWFISH")
50     (7 . "AES")
51     (8 . "AES192")
52     (9 . "AES256")
53     (10 . "TWOFISH")
54     (110 . "DUMMY")))
55
56 ;; from gnupg/include/cipher.h
57 (defconst epg-pubkey-algorithm-alist
58   '((1 . "RSA")
59     (2 . "RSA_E")
60     (3 . "RSA_S")
61     (16 . "ELGAMAL_E")
62     (17 . "DSA")
63     (20 . "ELGAMAL")))
64
65 ;; from gnupg/include/cipher.h
66 (defconst epg-digest-algorithm-alist
67   '((1 . "MD5")
68     (2 . "SHA1")
69     (3 . "RMD160")
70     (8 . "SHA256")
71     (9 . "SHA384")
72     (10 . "SHA512")))
73
74 ;; from gnupg/include/cipher.h
75 (defconst epg-compress-algorithm-alist
76   '((0 . "NONE")
77     (1 . "ZIP")
78     (2 . "ZLIB")
79     (3 . "BZIP2")))
80
81 (defconst epg-invalid-recipients-reason-alist
82   '((0 . "No specific reason given")
83     (1 . "Not Found")
84     (2 . "Ambigious specification")
85     (3 . "Wrong key usage")
86     (4 . "Key revoked")
87     (5 . "Key expired")
88     (6 . "No CRL known")
89     (7 . "CRL too old")
90     (8 . "Policy mismatch")
91     (9 . "Not a secret key")
92     (10 . "Key not trusted")))
93
94 (defconst epg-delete-problem-reason-alist
95   '((1 . "No such key")
96     (2 . "Must delete secret key first")
97     (3 . "Ambigious specification")))
98
99 (defconst epg-import-ok-reason-alist
100   '((0 . "Not actually changed")
101     (1 . "Entirely new key")
102     (2 . "New user IDs")
103     (4 . "New signatures")
104     (8 . "New subkeys")
105     (16 . "Contains private key")))
106
107 (defconst epg-import-problem-reason-alist
108   '((0 . "No specific reason given")
109     (1 . "Invalid Certificate")
110     (2 . "Issuer Certificate missing")
111     (3 . "Certificate Chain too long")
112     (4 . "Error storing certificate")))
113
114 (defconst epg-no-data-reason-alist
115   '((1 . "No armored data")
116     (2 . "Expected a packet but did not found one")
117     (3 . "Invalid packet found, this may indicate a non OpenPGP message")
118     (4 . "Signature expected but not found")))
119
120 (defconst epg-unexpected-reason-alist nil)
121
122 (defvar epg-key-validity-alist
123   '((?o . unknown)
124     (?i . invalid)
125     (?d . disabled)
126     (?r . revoked)
127     (?e . expired)
128     (?- . none)
129     (?q . undefined)
130     (?n . never)
131     (?m . marginal)
132     (?f . full)
133     (?u . ultimate)))
134
135 (defvar epg-key-capablity-alist
136   '((?e . encrypt)
137     (?s . sign)
138     (?c . certify)
139     (?a . authentication)))
140
141 (defvar epg-new-signature-type-alist
142   '((?D . detached)
143     (?C . clear)
144     (?S . normal)))
145
146 (defvar epg-dn-type-alist
147   '(("1.2.840.113549.1.9.1" . "EMail")
148     ("2.5.4.12" . "T")
149     ("2.5.4.42" . "GN")
150     ("2.5.4.4" . "SN")
151     ("0.2.262.1.10.7.20" . "NameDistinguisher")
152     ("2.5.4.16" . "ADDR")
153     ("2.5.4.15" . "BC")
154     ("2.5.4.13" . "D")
155     ("2.5.4.17" . "PostalCode")
156     ("2.5.4.65" . "Pseudo")
157     ("2.5.4.5" . "SerialNumber")))
158
159 (defvar epg-prompt-alist nil)
160
161 (defun epg-make-data-from-file (file)
162   "Make a data object from FILE."
163   (cons 'epg-data (vector file nil)))
164
165 (defun epg-make-data-from-string (string)
166   "Make a data object from STRING."
167   (cons 'epg-data (vector nil string)))
168
169 (defun epg-data-file (data)
170   "Return the file of DATA."
171   (unless (eq (car data) 'epg-data)
172     (signal 'wrong-type-argument (list 'epg-data-p data)))
173   (aref (cdr data) 0))
174
175 (defun epg-data-string (data)
176   "Return the string of DATA."
177   (unless (eq (car data) 'epg-data)
178     (signal 'wrong-type-argument (list 'epg-data-p data)))
179   (aref (cdr data) 1))
180
181 (defun epg-make-context (&optional protocol armor textmode include-certs
182                                    cipher-algorithm digest-algorithm
183                                    compress-algorithm)
184   "Return a context object."
185   (cons 'epg-context
186         (vector (or protocol 'OpenPGP) armor textmode include-certs
187                 cipher-algorithm digest-algorithm compress-algorithm
188                 #'epg-passphrase-callback-function
189                 nil
190                 nil nil nil nil nil)))
191
192 (defun epg-context-protocol (context)
193   "Return the protocol used within CONTEXT."
194   (unless (eq (car context) 'epg-context)
195     (signal 'wrong-type-argument (list 'epg-context-p context)))
196   (aref (cdr context) 0))
197
198 (defun epg-context-armor (context)
199   "Return t if the output shouled be ASCII armored in CONTEXT."
200   (unless (eq (car context) 'epg-context)
201     (signal 'wrong-type-argument (list 'epg-context-p context)))
202   (aref (cdr context) 1))
203
204 (defun epg-context-textmode (context)
205   "Return t if canonical text mode should be used in CONTEXT."
206   (unless (eq (car context) 'epg-context)
207     (signal 'wrong-type-argument (list 'epg-context-p context)))
208   (aref (cdr context) 2))
209
210 (defun epg-context-include-certs (context)
211   "Return how many certificates should be included in an S/MIME signed
212 message."
213   (unless (eq (car context) 'epg-context)
214     (signal 'wrong-type-argument (list 'epg-context-p context)))
215   (aref (cdr context) 3))
216
217 (defun epg-context-cipher-algorithm (context)
218   "Return the cipher algorithm in CONTEXT."
219   (unless (eq (car context) 'epg-context)
220     (signal 'wrong-type-argument (list 'epg-context-p context)))
221   (aref (cdr context) 4))
222
223 (defun epg-context-digest-algorithm (context)
224   "Return the digest algorithm in CONTEXT."
225   (unless (eq (car context) 'epg-context)
226     (signal 'wrong-type-argument (list 'epg-context-p context)))
227   (aref (cdr context) 5))
228
229 (defun epg-context-compress-algorithm (context)
230   "Return the compress algorithm in CONTEXT."
231   (unless (eq (car context) 'epg-context)
232     (signal 'wrong-type-argument (list 'epg-context-p context)))
233   (aref (cdr context) 6))
234
235 (defun epg-context-passphrase-callback (context)
236   "Return the function used to query passphrase."
237   (unless (eq (car context) 'epg-context)
238     (signal 'wrong-type-argument (list 'epg-context-p context)))
239   (aref (cdr context) 7))
240
241 (defun epg-context-progress-callback (context)
242   "Return the function which handles progress update."
243   (unless (eq (car context) 'epg-context)
244     (signal 'wrong-type-argument (list 'epg-context-p context)))
245   (aref (cdr context) 8))
246
247 (defun epg-context-signers (context)
248   "Return the list of key-id for singning."
249   (unless (eq (car context) 'epg-context)
250     (signal 'wrong-type-argument (list 'epg-context-p context)))
251   (aref (cdr context) 9))
252
253 (defun epg-context-process (context)
254   "Return the process object of `epg-gpg-program'.
255 This function is for internal use only."
256   (unless (eq (car context) 'epg-context)
257     (signal 'wrong-type-argument (list 'epg-context-p context)))
258   (aref (cdr context) 10))
259
260 (defun epg-context-output-file (context)
261   "Return the output file of `epg-gpg-program'.
262 This function is for internal use only."
263   (unless (eq (car context) 'epg-context)
264     (signal 'wrong-type-argument (list 'epg-context-p context)))
265   (aref (cdr context) 11))
266
267 (defun epg-context-result (context)
268   "Return the result of the previous cryptographic operation."
269   (unless (eq (car context) 'epg-context)
270     (signal 'wrong-type-argument (list 'epg-context-p context)))
271   (aref (cdr context) 12))
272
273 (defun epg-context-operation (context)
274   "Return the name of the current cryptographic operation."
275   (unless (eq (car context) 'epg-context)
276     (signal 'wrong-type-argument (list 'epg-context-p context)))
277   (aref (cdr context) 13))
278
279 (defun epg-context-set-protocol (context protocol)
280   "Set the protocol used within CONTEXT."
281   (unless (eq (car context) 'epg-context)
282     (signal 'wrong-type-argument (list 'epg-context-p context)))
283   (aset (cdr context) 0 protocol))
284
285 (defun epg-context-set-armor (context armor)
286   "Specify if the output shouled be ASCII armored in CONTEXT."
287   (unless (eq (car context) 'epg-context)
288     (signal 'wrong-type-argument (list 'epg-context-p context)))
289   (aset (cdr context) 1 armor))
290
291 (defun epg-context-set-textmode (context textmode)
292   "Specify if canonical text mode should be used in CONTEXT."
293   (unless (eq (car context) 'epg-context)
294     (signal 'wrong-type-argument (list 'epg-context-p context)))
295   (aset (cdr context) 2 textmode))
296
297 (defun epg-context-set-include-certs (context include-certs)
298  "Set how many certificates should be included in an S/MIME signed message."
299   (unless (eq (car context) 'epg-context)
300     (signal 'wrong-type-argument (list 'epg-context-p context)))
301   (aset (cdr context) 3 include-certs))
302
303 (defun epg-context-set-cipher-algorithm (context cipher-algorithm)
304  "Set the cipher algorithm in CONTEXT."
305   (unless (eq (car context) 'epg-context)
306     (signal 'wrong-type-argument (list 'epg-context-p context)))
307   (aset (cdr context) 4 cipher-algorithm))
308
309 (defun epg-context-set-digest-algorithm (context digest-algorithm)
310  "Set the digest algorithm in CONTEXT."
311   (unless (eq (car context) 'epg-context)
312     (signal 'wrong-type-argument (list 'epg-context-p context)))
313   (aset (cdr context) 5 digest-algorithm))
314
315 (defun epg-context-set-compress-algorithm (context compress-algorithm)
316  "Set the compress algorithm in CONTEXT."
317   (unless (eq (car context) 'epg-context)
318     (signal 'wrong-type-argument (list 'epg-context-p context)))
319   (aset (cdr context) 6 compress-algorithm))
320
321 (defun epg-context-set-passphrase-callback (context
322                                                  passphrase-callback)
323   "Set the function used to query passphrase."
324   (unless (eq (car context) 'epg-context)
325     (signal 'wrong-type-argument (list 'epg-context-p context)))
326   (aset (cdr context) 7 passphrase-callback))
327
328 (defun epg-context-set-progress-callback (context progress-callback)
329   "Set the function which handles progress update."
330   (unless (eq (car context) 'epg-context)
331     (signal 'wrong-type-argument (list 'epg-context-p context)))
332   (aset (cdr context) 8 progress-callback))
333
334 (defun epg-context-set-signers (context signers)
335  "Set the list of key-id for singning."
336   (unless (eq (car context) 'epg-context)
337     (signal 'wrong-type-argument (list 'epg-context-p context)))
338   (aset (cdr context) 9 signers))
339
340 (defun epg-context-set-process (context process)
341   "Set the process object of `epg-gpg-program'.
342 This function is for internal use only."
343   (unless (eq (car context) 'epg-context)
344     (signal 'wrong-type-argument (list 'epg-context-p context)))
345   (aset (cdr context) 10 process))
346
347 (defun epg-context-set-output-file (context output-file)
348   "Set the output file of `epg-gpg-program'.
349 This function is for internal use only."
350   (unless (eq (car context) 'epg-context)
351     (signal 'wrong-type-argument (list 'epg-context-p context)))
352   (aset (cdr context) 11 output-file))
353
354 (defun epg-context-set-result (context result)
355   "Set the result of the previous cryptographic operation."
356   (unless (eq (car context) 'epg-context)
357     (signal 'wrong-type-argument (list 'epg-context-p context)))
358   (aset (cdr context) 12 result))
359
360 (defun epg-context-set-operation (context operation)
361   "Set the name of the current cryptographic operation."
362   (unless (eq (car context) 'epg-context)
363     (signal 'wrong-type-argument (list 'epg-context-p context)))
364   (aset (cdr context) 13 operation))
365
366 (defun epg-make-signature (status &optional key-id)
367   "Return a signature object."
368   (cons 'epg-signature (vector status key-id nil nil nil nil nil nil nil nil)))
369
370 (defun epg-signature-status (signature)
371   "Return the status code of SIGNATURE."
372   (unless (eq (car signature) 'epg-signature)
373     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
374   (aref (cdr signature) 0))
375
376 (defun epg-signature-key-id (signature)
377   "Return the key-id of SIGNATURE."
378   (unless (eq (car signature) 'epg-signature)
379     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
380   (aref (cdr signature) 1))
381
382 (defun epg-signature-validity (signature)
383   "Return the validity of SIGNATURE."
384   (unless (eq (car signature) 'epg-signature)
385     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
386   (aref (cdr signature) 2))
387
388 (defun epg-signature-fingerprint (signature)
389   "Return the fingerprint of SIGNATURE."
390   (unless (eq (car signature) 'epg-signature)
391     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
392   (aref (cdr signature) 3))
393
394 (defun epg-signature-creation-time (signature)
395   "Return the creation time of SIGNATURE."
396   (unless (eq (car signature) 'epg-signature)
397     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
398   (aref (cdr signature) 4))
399
400 (defun epg-signature-expiration-time (signature)
401   "Return the expiration time of SIGNATURE."
402   (unless (eq (car signature) 'epg-signature)
403     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
404   (aref (cdr signature) 5))
405
406 (defun epg-signature-pubkey-algorithm (signature)
407   "Return the public key algorithm of SIGNATURE."
408   (unless (eq (car signature) 'epg-signature)
409     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
410   (aref (cdr signature) 6))
411
412 (defun epg-signature-digest-algorithm (signature)
413   "Return the digest algorithm of SIGNATURE."
414   (unless (eq (car signature) 'epg-signature)
415     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
416   (aref (cdr signature) 7))
417
418 (defun epg-signature-class (signature)
419   "Return the class of SIGNATURE."
420   (unless (eq (car signature) 'epg-signature)
421     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
422   (aref (cdr signature) 8))
423
424 (defun epg-signature-version (signature)
425   "Return the version of SIGNATURE."
426   (unless (eq (car signature) 'epg-signature)
427     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
428   (aref (cdr signature) 9))
429
430 (defun epg-signature-set-status (signature status)
431  "Set the status code of SIGNATURE."
432   (unless (eq (car signature) 'epg-signature)
433     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
434   (aset (cdr signature) 0 status))
435
436 (defun epg-signature-set-key-id (signature key-id)
437  "Set the key-id of SIGNATURE."
438   (unless (eq (car signature) 'epg-signature)
439     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
440   (aset (cdr signature) 1 key-id))
441
442 (defun epg-signature-set-validity (signature validity)
443  "Set the validity of SIGNATURE."
444   (unless (eq (car signature) 'epg-signature)
445     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
446   (aset (cdr signature) 2 validity))
447
448 (defun epg-signature-set-fingerprint (signature fingerprint)
449  "Set the fingerprint of SIGNATURE."
450   (unless (eq (car signature) 'epg-signature)
451     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
452   (aset (cdr signature) 3 fingerprint))
453
454 (defun epg-signature-set-creation-time (signature creation-time)
455   "Set the creation time of SIGNATURE."
456   (unless (eq (car signature) 'epg-signature)
457     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
458   (aset (cdr signature) 4 creation-time))
459
460 (defun epg-signature-set-expiration-time (signature expiration-time)
461   "Set the expiration time of SIGNATURE."
462   (unless (eq (car signature) 'epg-signature)
463     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
464   (aset (cdr signature) 5 expiration-time))
465
466 (defun epg-signature-set-pubkey-algorithm (signature pubkey-algorithm)
467   "Set the public key algorithm of SIGNATURE."
468   (unless (eq (car signature) 'epg-signature)
469     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
470   (aset (cdr signature) 6 pubkey-algorithm))
471
472 (defun epg-signature-set-digest-algorithm (signature digest-algorithm)
473   "Set the digest algorithm of SIGNATURE."
474   (unless (eq (car signature) 'epg-signature)
475     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
476   (aset (cdr signature) 7 digest-algorithm))
477
478 (defun epg-signature-set-class (signature class)
479   "Set the class of SIGNATURE."
480   (unless (eq (car signature) 'epg-signature)
481     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
482   (aset (cdr signature) 8 class))
483
484 (defun epg-signature-set-version (signature version)
485   "Set the version of SIGNATURE."
486   (unless (eq (car signature) 'epg-signature)
487     (signal 'wrong-type-argument (list 'epg-signature-p signature)))
488   (aset (cdr signature) 9 version))
489
490 (defun epg-make-new-signature (type pubkey-algorithm digest-algorithm
491                                     class creation-time fingerprint)
492   "Return a new signature object."
493   (cons 'epg-new-signature (vector type pubkey-algorithm digest-algorithm
494                                    class creation-time fingerprint)))
495
496 (defun epg-new-signature-type (new-signature)
497   "Return the type of NEW-SIGNATURE."
498   (unless (eq (car new-signature) 'epg-new-signature)
499     (signal 'wrong-type-argument (list 'epg-new-signature-p new-signature)))
500   (aref (cdr new-signature) 0))
501
502 (defun epg-new-signature-pubkey-algorithm (new-signature)
503   "Return the public key algorithm of NEW-SIGNATURE."
504   (unless (eq (car new-signature) 'epg-new-signature)
505     (signal 'wrong-type-argument (list 'epg-new-signature-p new-signature)))
506   (aref (cdr new-signature) 1))
507
508 (defun epg-new-signature-digest-algorithm (new-signature)
509   "Return the digest algorithm of NEW-SIGNATURE."
510   (unless (eq (car new-signature) 'epg-new-signature)
511     (signal 'wrong-type-argument (list 'epg-new-signature-p new-signature)))
512   (aref (cdr new-signature) 2))
513
514 (defun epg-new-signature-class (new-signature)
515   "Return the class of NEW-SIGNATURE."
516   (unless (eq (car new-signature) 'epg-new-signature)
517     (signal 'wrong-type-argument (list 'epg-new-signature-p new-signature)))
518   (aref (cdr new-signature) 3))
519
520 (defun epg-new-signature-creation-time (new-signature)
521   "Return the creation time of NEW-SIGNATURE."
522   (unless (eq (car new-signature) 'epg-new-signature)
523     (signal 'wrong-type-argument (list 'epg-new-signature-p new-signature)))
524   (aref (cdr new-signature) 4))
525
526 (defun epg-new-signature-fingerprint (new-signature)
527   "Return the fingerprint of NEW-SIGNATURE."
528   (unless (eq (car new-signature) 'epg-new-signature)
529     (signal 'wrong-type-argument (list 'epg-new-signature-p new-signature)))
530   (aref (cdr new-signature) 5))
531
532 (defun epg-make-key (owner-trust)
533   "Return a key object."
534   (cons 'epg-key (vector owner-trust nil nil)))
535
536 (defun epg-key-owner-trust (key)
537   "Return the owner trust of KEY."
538   (unless (eq (car key) 'epg-key)
539     (signal 'wrong-type-argument (list 'epg-key-p key)))
540   (aref (cdr key) 0))
541
542 (defun epg-key-sub-key-list (key)
543   "Return the sub key list of KEY."
544   (unless (eq (car key) 'epg-key)
545     (signal 'wrong-type-argument (list 'epg-key-p key)))
546   (aref (cdr key) 1))
547
548 (defun epg-key-user-id-list (key)
549   "Return the user ID list of KEY."
550   (unless (eq (car key) 'epg-key)
551     (signal 'wrong-type-argument (list 'epg-key-p key)))
552   (aref (cdr key) 2))
553
554 (defun epg-key-set-sub-key-list (key sub-key-list)
555   "Set the sub key list of KEY."
556   (unless (eq (car key) 'epg-key)
557     (signal 'wrong-type-argument (list 'epg-key-p key)))
558   (aset (cdr key) 1 sub-key-list))
559
560 (defun epg-key-set-user-id-list (key user-id-list)
561   "Set the user ID list of KEY."
562   (unless (eq (car key) 'epg-key)
563     (signal 'wrong-type-argument (list 'epg-key-p key)))
564   (aset (cdr key) 2 user-id-list))
565
566 (defun epg-make-sub-key (validity capability secret-p algorithm length id
567                                   creation-time expiration-time)
568   "Return a sub key object."
569   (cons 'epg-sub-key
570         (vector validity capability secret-p algorithm length id creation-time
571                 expiration-time nil)))
572
573 (defun epg-sub-key-validity (sub-key)
574   "Return the validity of SUB-KEY."
575   (unless (eq (car sub-key) 'epg-sub-key)
576     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
577   (aref (cdr sub-key) 0))
578
579 (defun epg-sub-key-capability (sub-key)
580   "Return the capability of SUB-KEY."
581   (unless (eq (car sub-key) 'epg-sub-key)
582     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
583   (aref (cdr sub-key) 1))
584
585 (defun epg-sub-key-secret-p (sub-key)
586   "Return non-nil if SUB-KEY is a secret key."
587   (unless (eq (car sub-key) 'epg-sub-key)
588     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
589   (aref (cdr sub-key) 2))
590
591 (defun epg-sub-key-algorithm (sub-key)
592   "Return the algorithm of SUB-KEY."
593   (unless (eq (car sub-key) 'epg-sub-key)
594     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
595   (aref (cdr sub-key) 3))
596
597 (defun epg-sub-key-length (sub-key)
598   "Return the length of SUB-KEY."
599   (unless (eq (car sub-key) 'epg-sub-key)
600     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
601   (aref (cdr sub-key) 4))
602
603 (defun epg-sub-key-id (sub-key)
604   "Return the ID of SUB-KEY."
605   (unless (eq (car sub-key) 'epg-sub-key)
606     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
607   (aref (cdr sub-key) 5))
608
609 (defun epg-sub-key-creation-time (sub-key)
610   "Return the creation time of SUB-KEY."
611   (unless (eq (car sub-key) 'epg-sub-key)
612     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
613   (aref (cdr sub-key) 6))
614
615 (defun epg-sub-key-expiration-time (sub-key)
616   "Return the expiration time of SUB-KEY."
617   (unless (eq (car sub-key) 'epg-sub-key)
618     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
619   (aref (cdr sub-key) 7))
620
621 (defun epg-sub-key-fingerprint (sub-key)
622   "Return the fingerprint of SUB-KEY."
623   (unless (eq (car sub-key) 'epg-sub-key)
624     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
625   (aref (cdr sub-key) 8))
626
627 (defun epg-sub-key-set-fingerprint (sub-key fingerprint)
628   "Set the fingerprint of SUB-KEY.
629 This function is for internal use only."
630   (unless (eq (car sub-key) 'epg-sub-key)
631     (signal 'wrong-type-argument (list 'epg-sub-key-p sub-key)))
632   (aset (cdr sub-key) 8 fingerprint))
633
634 (defun epg-make-user-id (validity string)
635   "Return a user ID object."
636   (cons 'epg-user-id (vector validity string nil)))
637
638 (defun epg-user-id-validity (user-id)
639   "Return the validity of USER-ID."
640   (unless (eq (car user-id) 'epg-user-id)
641     (signal 'wrong-type-argument (list 'epg-user-id-p user-id)))
642   (aref (cdr user-id) 0))
643
644 (defun epg-user-id-string (user-id)
645   "Return the name of USER-ID."
646   (unless (eq (car user-id) 'epg-user-id)
647     (signal 'wrong-type-argument (list 'epg-user-id-p user-id)))
648   (aref (cdr user-id) 1))
649
650 (defun epg-user-id-signature-list (user-id)
651   "Return the signature list of USER-ID."
652   (unless (eq (car user-id) 'epg-user-id)
653     (signal 'wrong-type-argument (list 'epg-user-id-p user-id)))
654   (aref (cdr user-id) 2))
655
656 (defun epg-user-id-set-signature-list (user-id signature-list)
657   "Set the signature list of USER-ID."
658   (unless (eq (car user-id) 'epg-user-id)
659     (signal 'wrong-type-argument (list 'epg-user-id-p user-id)))
660   (aset (cdr user-id) 2 signature-list))
661
662 (defun epg-make-key-signature (validity pubkey-algorithm key-id creation-time
663                                         expiration-time user-id class
664                                         exportable-p)
665   "Return a key signature object."
666   (cons 'epg-key-signature
667         (vector validity pubkey-algorithm key-id creation-time expiration-time
668                 user-id class exportable-p)))
669
670 (defun epg-key-signature-validity (key-signature)
671   "Return the validity of KEY-SIGNATURE."
672   (unless (eq (car key-signature) 'epg-key-signature)
673     (signal 'wrong-type-argument (list 'epg-key-signature-p key-signature)))
674   (aref (cdr key-signature) 0))
675
676 (defun epg-key-signature-pubkey-algorithm (key-signature)
677   "Return the public key algorithm of KEY-SIGNATURE."
678   (unless (eq (car key-signature) 'epg-key-signature)
679     (signal 'wrong-type-argument (list 'epg-key-signature-p key-signature)))
680   (aref (cdr key-signature) 1))
681
682 (defun epg-key-signature-key-id (key-signature)
683   "Return the key-id of KEY-SIGNATURE."
684   (unless (eq (car key-signature) 'epg-key-signature)
685     (signal 'wrong-type-argument (list 'epg-key-signature-p key-signature)))
686   (aref (cdr key-signature) 2))
687
688 (defun epg-key-signature-creation-time (key-signature)
689   "Return the creation time of KEY-SIGNATURE."
690   (unless (eq (car key-signature) 'epg-key-signature)
691     (signal 'wrong-type-argument (list 'epg-key-signature-p key-signature)))
692   (aref (cdr key-signature) 3))
693
694 (defun epg-key-signature-expiration-time (key-signature)
695   "Return the expiration time of KEY-SIGNATURE."
696   (unless (eq (car key-signature) 'epg-key-signature)
697     (signal 'wrong-type-argument (list 'epg-key-signature-p key-signature)))
698   (aref (cdr key-signature) 4))
699
700 (defun epg-key-signature-user-id (key-signature)
701   "Return the user-id of KEY-SIGNATURE."
702   (unless (eq (car key-signature) 'epg-key-signature)
703     (signal 'wrong-type-argument (list 'epg-key-signature-p key-signature)))
704   (aref (cdr key-signature) 5))
705
706 (defun epg-key-signature-class (key-signature)
707   "Return the class of KEY-SIGNATURE."
708   (unless (eq (car key-signature) 'epg-key-signature)
709     (signal 'wrong-type-argument (list 'epg-key-signature-p key-signature)))
710   (aref (cdr key-signature) 6))
711
712 (defun epg-key-signature-exportable-p (key-signature)
713   "Return t if KEY-SIGNATURE is exportable."
714   (unless (eq (car key-signature) 'epg-key-signature)
715     (signal 'wrong-type-argument (list 'epg-key-signature-p key-signature)))
716   (aref (cdr key-signature) 7))
717
718 (defun epg-context-result-for (context name)
719   "Return the result of CONTEXT associated with NAME."
720   (cdr (assq name (epg-context-result context))))
721
722 (defun epg-context-set-result-for (context name value)
723   "Set the result of CONTEXT associated with NAME to VALUE."
724   (let* ((result (epg-context-result context))
725          (entry (assq name result)))
726     (if entry
727         (setcdr entry value)
728       (epg-context-set-result context (cons (cons name value) result)))))
729
730 (defun epg-signature-to-string (signature)
731   "Convert SIGNATURE to a human readable string."
732   (let ((user-id (cdr (assoc (epg-signature-key-id signature)
733                              epg-user-id-alist))))
734     (concat
735      (cond ((eq (epg-signature-status signature) 'good)
736             "Good signature from ")
737            ((eq (epg-signature-status signature) 'bad)
738             "Bad signature from ")
739            ((eq (epg-signature-status signature) 'expired)
740             "Expired signature from ")
741            ((eq (epg-signature-status signature) 'expired-key)
742             "Signature made by expired key ")
743            ((eq (epg-signature-status signature) 'revoked-key)
744             "Signature made by revoked key ")
745            ((eq (epg-signature-status signature) 'no-pubkey)
746             "No public key for "))
747      (epg-signature-key-id signature)
748      (if user-id
749          (concat " "
750                  (if (stringp user-id)
751                      user-id
752                    (epg-decode-dn user-id)))
753        "")
754      (if (epg-signature-validity signature)
755          (format " (trust %s)"  (epg-signature-validity signature))
756        ""))))
757
758 (defun epg-verify-result-to-string (verify-result)
759   "Convert VERIFY-RESULT to a human readable string."
760   (mapconcat #'epg-signature-to-string verify-result "\n"))
761
762 (defun epg-new-signature-to-string (new-signature)
763   "Convert NEW-SIGNATURE to a human readable string."
764   (concat
765    (cond ((eq (epg-new-signature-type new-signature) 'detached)
766           "Detached signature ")
767          ((eq (epg-new-signature-type new-signature) 'clear)
768           "Clear text signature ")
769          (t
770           "Signature "))
771    (cdr (assq (epg-new-signature-pubkey-algorithm new-signature)
772               epg-pubkey-algorithm-alist))
773    "/"
774    (cdr (assq (epg-new-signature-digest-algorithm new-signature)
775               epg-digest-algorithm-alist))
776    " "
777    (format "%02X " (epg-new-signature-class new-signature))
778    (epg-new-signature-fingerprint new-signature)))
779
780 (defun epg--start (context args)
781   "Start `epg-gpg-program' in a subprocess with given ARGS."
782   (if (and (epg-context-process context)
783            (eq (process-status (epg-context-process context)) 'run))
784       (error "%s is already running in this context"
785              (if (eq (epg-context-protocol context) 'CMS)
786                  epg-gpgsm-program
787                epg-gpg-program)))
788   (let* ((args (append (list "--no-tty"
789                              "--status-fd" "1"
790                              "--yes")
791                        (if (epg-context-progress-callback context)
792                            (list "--enable-progress-filter"))
793                        (if epg-gpg-home-directory
794                            (list "--homedir" epg-gpg-home-directory))
795                        (unless (eq (epg-context-protocol context) 'CMS)
796                          (list "--command-fd" "0"))
797                        (if (epg-context-armor context) '("--armor"))
798                        (if (epg-context-textmode context) '("--textmode"))
799                        (if (epg-context-output-file context)
800                            (list "--output" (epg-context-output-file context)))
801                        args))
802          (coding-system-for-write 'binary)
803          process-connection-type
804          (orig-mode (default-file-modes))
805          (buffer (generate-new-buffer " *epg*"))
806          process)
807     (if epg-debug
808         (save-excursion
809           (unless epg-debug-buffer
810             (setq epg-debug-buffer (generate-new-buffer " *epg-debug*")))
811           (set-buffer epg-debug-buffer)
812           (goto-char (point-max))
813           (insert (format "%s %s\n"
814                           (if (eq (epg-context-protocol context) 'CMS)
815                               epg-gpgsm-program
816                            epg-gpg-program)
817                           (mapconcat #'identity args " ")))))
818     (with-current-buffer buffer
819       (make-local-variable 'epg-read-point)
820       (setq epg-read-point (point-min))
821       (make-local-variable 'epg-process-filter-running)
822       (setq epg-process-filter-running nil)
823       (make-local-variable 'epg-pending-status-list)
824       (setq epg-pending-status-list nil)
825       (make-local-variable 'epg-key-id)
826       (setq epg-key-id nil)
827       (make-local-variable 'epg-context)
828       (setq epg-context context))
829     (unwind-protect
830         (progn
831           (set-default-file-modes 448)
832           (setq process
833                 (apply #'start-process "epg" buffer
834                        (if (eq (epg-context-protocol context) 'CMS)
835                            epg-gpgsm-program
836                          epg-gpg-program)
837                        args)))
838       (set-default-file-modes orig-mode))
839     (set-process-filter process #'epg--process-filter)
840     (epg-context-set-process context process)))
841
842 (defun epg--process-filter (process input)
843   (if epg-debug
844       (save-excursion
845         (unless epg-debug-buffer
846           (setq epg-debug-buffer (generate-new-buffer " *epg-debug*")))
847         (set-buffer epg-debug-buffer)
848         (goto-char (point-max))
849         (insert input)))
850   (if (buffer-live-p (process-buffer process))
851       (save-excursion
852         (set-buffer (process-buffer process))
853         (goto-char (point-max))
854         (insert input)
855         (unless epg-process-filter-running
856           (unwind-protect
857               (progn
858                 (setq epg-process-filter-running t)
859                 (goto-char epg-read-point)
860                 (beginning-of-line)
861                 (while (looking-at ".*\n") ;the input line finished
862                   (if (looking-at "\\[GNUPG:] \\([A-Z_]+\\) ?\\(.*\\)")
863                       (let* ((status (match-string 1))
864                              (string (match-string 2))
865                              (symbol (intern-soft (concat "epg--status-"
866                                                           status))))
867                         (if (member status epg-pending-status-list)
868                             (setq epg-pending-status-list nil))
869                         (if (and symbol
870                                  (fboundp symbol))
871                             (funcall symbol epg-context string))))
872                   (forward-line)
873                   (setq epg-read-point (point))))
874             (setq epg-process-filter-running nil))))))
875
876 (defun epg-read-output (context)
877   "Read the output file CONTEXT and return the content as a string."
878   (with-temp-buffer
879     (if (fboundp 'set-buffer-multibyte)
880         (set-buffer-multibyte nil))
881     (if (file-exists-p (epg-context-output-file context))
882         (let ((coding-system-for-read 'binary))
883           (insert-file-contents (epg-context-output-file context))
884           (buffer-string)))))
885
886 (defun epg-wait-for-status (context status-list)
887   "Wait until one of elements in STATUS-LIST arrives."
888   (with-current-buffer (process-buffer (epg-context-process context))
889     (setq epg-pending-status-list status-list)
890     (while (and (eq (process-status (epg-context-process context)) 'run)
891                 epg-pending-status-list)
892       (accept-process-output (epg-context-process context) 1))))
893
894 (defun epg-wait-for-completion (context)
895   "Wait until the `epg-gpg-program' process completes."
896   (while (eq (process-status (epg-context-process context)) 'run)
897     (accept-process-output (epg-context-process context) 1)))
898
899 (defun epg-reset (context)
900   "Reset the CONTEXT."
901   (if (and (epg-context-process context)
902            (buffer-live-p (process-buffer (epg-context-process context))))
903       (kill-buffer (process-buffer (epg-context-process context))))
904   (epg-context-set-process context nil))
905
906 (defun epg-delete-output-file (context)
907   "Delete the output file of CONTEXT."
908   (if (and (epg-context-output-file context)
909            (file-exists-p (epg-context-output-file context)))
910       (delete-file (epg-context-output-file context))))
911
912 (defun epg--status-USERID_HINT (context string)
913   (if (string-match "\\`\\([^ ]+\\) \\(.*\\)" string)
914       (let* ((key-id (match-string 1 string))
915              (user-id (match-string 2 string))
916              (entry (assoc key-id epg-user-id-alist)))
917         (if entry
918             (setcdr entry user-id)
919           (setq epg-user-id-alist (cons (cons key-id user-id)
920                                         epg-user-id-alist))))))
921
922 (defun epg--status-NEED_PASSPHRASE (context string)
923   (if (string-match "\\`\\([^ ]+\\)" string)
924       (setq epg-key-id (match-string 1 string))))
925
926 (defun epg--status-NEED_PASSPHRASE_SYM (context string)
927   (setq epg-key-id 'SYM))
928
929 (defun epg--status-NEED_PASSPHRASE_PIN (context string)
930   (setq epg-key-id 'PIN))
931
932 (defun epg--status-GET_HIDDEN (context string)
933   (when (and epg-key-id
934              (string-match "\\`passphrase\\." string))
935     (unless (epg-context-passphrase-callback context)
936       (error "passphrase-callback not set"))
937     (let (inhibit-quit
938           passphrase
939           passphrase-with-new-line
940           encoded-passphrase-with-new-line)
941       (unwind-protect
942           (condition-case nil
943               (progn
944                 (setq passphrase
945                       (funcall
946                        (if (consp (epg-context-passphrase-callback context))
947                            (car (epg-context-passphrase-callback context))
948                          (epg-context-passphrase-callback context))
949                        context
950                        epg-key-id
951                        (if (consp (epg-context-passphrase-callback context))
952                            (cdr (epg-context-passphrase-callback context)))))
953                 (when passphrase
954                   (setq passphrase-with-new-line (concat passphrase "\n"))
955                   (epg--clear-string passphrase)
956                   (setq passphrase nil)
957                   (if epg-passphrase-coding-system
958                       (progn
959                         (setq encoded-passphrase-with-new-line
960                               (encode-coding-string
961                                passphrase-with-new-line
962                                epg-passphrase-coding-system))
963                         (epg--clear-string passphrase-with-new-line)
964                         (setq passphrase-with-new-line nil))
965                     (setq encoded-passphrase-with-new-line
966                           passphrase-with-new-line
967                           passphrase-with-new-line nil))
968                   (process-send-string (epg-context-process context)
969                                        encoded-passphrase-with-new-line)))
970             (quit
971              (epg-context-set-result-for
972               context 'error
973               (cons '(quit)
974                     (epg-context-result-for context 'error)))
975              (delete-process (epg-context-process context))))
976         (if passphrase
977             (epg--clear-string passphrase))
978         (if passphrase-with-new-line
979             (epg--clear-string passphrase-with-new-line))
980         (if encoded-passphrase-with-new-line
981             (epg--clear-string encoded-passphrase-with-new-line))))))
982
983 (defun epg--status-GET_BOOL (context string)
984   (let ((entry (assoc string epg-prompt-alist))
985         inhibit-quit)
986     (condition-case nil
987       (if (y-or-n-p (if entry (cdr entry) (concat string "? ")))
988           (process-send-string (epg-context-process context) "y\n")
989         (process-send-string (epg-context-process context) "n\n"))
990       (quit
991        (epg-context-set-result-for
992         context 'error
993         (cons '(quit)
994               (epg-context-result-for context 'error)))
995        (delete-process (epg-context-process context))))))
996
997 (defun epg--status-GET_LINE (context string)
998   (let ((entry (assoc string epg-prompt-alist))
999         inhibit-quit)
1000     (condition-case nil
1001         (process-send-string (epg-context-process context)
1002                              (concat (read-string
1003                                       (if entry
1004                                           (cdr entry)
1005                                         (concat string ": ")))
1006                                      "\n"))
1007       (quit
1008        (epg-context-set-result-for
1009         context 'error
1010         (cons '(quit)
1011               (epg-context-result-for context 'error)))
1012        (delete-process (epg-context-process context))))))
1013
1014 (defun epg--status-*SIG (context status string)
1015   (if (string-match "\\`\\([^ ]+\\) \\(.*\\)" string)
1016       (let* ((key-id (match-string 1 string))
1017              (user-id (match-string 2 string))
1018              (entry (assoc key-id epg-user-id-alist)))
1019         (epg-context-set-result-for
1020          context
1021          'verify
1022          (cons (epg-make-signature status key-id)
1023                (epg-context-result-for context 'verify)))
1024         (if (eq (epg-context-protocol context) 'CMS)
1025             (condition-case nil
1026                 (setq user-id (epg-dn-from-string user-id))
1027               (error)))
1028         (if entry
1029             (setcdr entry user-id)
1030           (setq epg-user-id-alist
1031                 (cons (cons key-id user-id) epg-user-id-alist))))
1032     (epg-context-set-result-for
1033      context
1034      'verify
1035      (cons (epg-make-signature status)
1036            (epg-context-result-for context 'verify)))))
1037
1038 (defun epg--status-GOODSIG (context string)
1039   (epg--status-*SIG context 'good string))
1040
1041 (defun epg--status-EXPSIG (context string)
1042   (epg--status-*SIG context 'expired string))
1043
1044 (defun epg--status-EXPKEYSIG (context string)
1045   (epg--status-*SIG context 'expired-key string))
1046
1047 (defun epg--status-REVKEYSIG (context string)
1048   (epg--status-*SIG context 'revoked-key string))
1049
1050 (defun epg--status-BADSIG (context string)
1051   (epg--status-*SIG context 'bad string))
1052
1053 (defun epg--status-NO_PUBKEY (context string)
1054   (let ((signature (car (epg-context-result-for context 'verify))))
1055     (if (and signature
1056              (eq (epg-signature-status signature) 'error)
1057              (equal (epg-signature-key-id signature) string))
1058         (epg-signature-set-status signature 'no-pubkey))))
1059
1060 (defun epg--time-from-seconds (seconds)
1061   (let ((number-seconds (string-to-number (concat seconds ".0"))))
1062     (cons (floor (/ number-seconds 65536))
1063           (floor (mod number-seconds 65536)))))
1064
1065 (defun epg--status-ERRSIG (context string)
1066   (if (string-match "\\`\\([^ ]+\\) \\([0-9]+\\) \\([0-9]+\\) \
1067 \\([0-9A-Fa-f][0-9A-Fa-f]\\) \\([^ ]+\\) \\([0-9]+\\)"
1068                     string)
1069       (let ((signature (epg-make-signature 'error)))
1070         (epg-context-set-result-for
1071          context
1072          'verify
1073          (cons signature
1074                (epg-context-result-for context 'verify)))
1075         (epg-signature-set-key-id
1076          signature
1077          (match-string 1 string))
1078         (epg-signature-set-pubkey-algorithm
1079          signature
1080          (string-to-number (match-string 2 string)))
1081         (epg-signature-set-digest-algorithm
1082          signature
1083          (string-to-number (match-string 3 string)))
1084         (epg-signature-set-class
1085          signature
1086          (string-to-number (match-string 4 string) 16))
1087         (epg-signature-set-creation-time
1088          signature
1089          (epg--time-from-seconds (match-string 5 string))))))
1090
1091 (defun epg--status-VALIDSIG (context string)
1092   (let ((signature (car (epg-context-result-for context 'verify))))
1093     (when (and signature
1094                (eq (epg-signature-status signature) 'good)
1095                (string-match "\\`\\([^ ]+\\) [^ ]+ \\([^ ]+\\) \\([^ ]+\\) \
1096 \\([0-9]+\\) [^ ]+ \\([0-9]+\\) \\([0-9]+\\) \\([0-9A-Fa-f][0-9A-Fa-f]\\) \
1097 \\(.*\\)"
1098                            string))
1099       (epg-signature-set-fingerprint
1100        signature
1101        (match-string 1 string))
1102       (epg-signature-set-creation-time
1103        signature
1104        (epg--time-from-seconds (match-string 2 string)))
1105       (epg-signature-set-expiration-time
1106        signature
1107        (epg--time-from-seconds (match-string 3 string)))
1108       (epg-signature-set-version
1109        signature
1110        (string-to-number (match-string 4 string)))
1111       (epg-signature-set-pubkey-algorithm
1112        signature 
1113        (string-to-number (match-string 5 string)))
1114       (epg-signature-set-digest-algorithm
1115        signature
1116        (string-to-number (match-string 6 string)))
1117       (epg-signature-set-class
1118        signature
1119        (string-to-number (match-string 7 string) 16)))))
1120
1121 (defun epg--status-TRUST_UNDEFINED (context string)
1122   (let ((signature (car (epg-context-result-for context 'verify))))
1123     (if (and signature
1124              (eq (epg-signature-status signature) 'good))
1125         (epg-signature-set-validity signature 'undefined))))
1126
1127 (defun epg--status-TRUST_NEVER (context string)
1128   (let ((signature (car (epg-context-result-for context 'verify))))
1129     (if (and signature
1130              (eq (epg-signature-status signature) 'good))
1131         (epg-signature-set-validity signature 'never))))
1132
1133 (defun epg--status-TRUST_MARGINAL (context string)
1134   (let ((signature (car (epg-context-result-for context 'verify))))
1135     (if (and signature
1136              (eq (epg-signature-status signature) 'marginal))
1137         (epg-signature-set-validity signature 'marginal))))
1138
1139 (defun epg--status-TRUST_FULLY (context string)
1140   (let ((signature (car (epg-context-result-for context 'verify))))
1141     (if (and signature
1142              (eq (epg-signature-status signature) 'good))
1143         (epg-signature-set-validity signature 'full))))
1144
1145 (defun epg--status-TRUST_ULTIMATE (context string)
1146   (let ((signature (car (epg-context-result-for context 'verify))))
1147     (if (and signature
1148              (eq (epg-signature-status signature) 'good))
1149         (epg-signature-set-validity signature 'ultimate))))
1150
1151 (defun epg--status-PROGRESS (context string)
1152   (if (string-match "\\`\\([^ ]+\\) \\([^ ]\\) \\([0-9]+\\) \\([0-9]+\\)"
1153                     string)
1154       (funcall (if (consp (epg-context-progress-callback context))
1155                    (car (epg-context-progress-callback context))
1156                  (epg-context-progress-callback context))
1157                context
1158                (match-string 1 string)
1159                (match-string 2 string)
1160                (string-to-number (match-string 3 string))
1161                (string-to-number (match-string 4 string))
1162                (if (consp (epg-context-progress-callback context))
1163                    (cdr (epg-context-progress-callback context))))))
1164
1165 (defun epg--status-DECRYPTION_FAILED (context string)
1166   (epg-context-set-result-for
1167    context 'error
1168    (cons '(decryption-failed)
1169          (epg-context-result-for context 'error))))
1170
1171 (defun epg--status-NODATA (context string)
1172   (epg-context-set-result-for
1173    context 'error
1174    (cons (list 'no-data (cons 'reason (string-to-number string)))
1175          (epg-context-result-for context 'error))))
1176
1177 (defun epg--status-UNEXPECTED (context string)
1178   (epg-context-set-result-for
1179    context 'error
1180    (cons (list 'unexpected (cons 'reason (string-to-number string)))
1181          (epg-context-result-for context 'error))))
1182
1183 (defun epg--status-KEYEXPIRED (context string)
1184   (epg-context-set-result-for
1185    context 'error
1186    (cons (list 'key-expired (cons 'expiration-time
1187                                   (epg--time-from-seconds string)))
1188          (epg-context-result-for context 'error))))
1189
1190 (defun epg--status-KEYREVOKED (context string)
1191   (epg-context-set-result-for
1192    context 'error
1193    (cons '(key-revoked)
1194          (epg-context-result-for context 'error))))
1195
1196 (defun epg--status-BADARMOR (context string)
1197   (epg-context-set-result-for
1198    context 'error
1199    (cons '(bad-armor)
1200          (epg-context-result-for context 'error))))
1201
1202 (defun epg--status-INV_RECP (context string)
1203   (if (string-match "\\`\\([0-9]+\\) \\(.*\\)" string)
1204       (epg-context-set-result-for
1205        context 'error
1206        (cons (list 'invalid-recipient
1207                    (cons 'reason
1208                          (string-to-number (match-string 1 string)))
1209                    (cons 'requested-recipient
1210                          (match-string 2 string)))
1211              (epg-context-result-for context 'error)))))
1212
1213 (defun epg--status-NO_RECP (context string)
1214   (epg-context-set-result-for
1215    context 'error
1216    (cons '(no-recipients)
1217          (epg-context-result-for context 'error))))
1218
1219 (defun epg--status-DELETE_PROBLEM (context string)
1220   (if (string-match "\\`\\([0-9]+\\)" string)
1221       (epg-context-set-result-for
1222        context 'error
1223        (cons (list 'delete-problem
1224                    (cons 'reason (string-to-number (match-string 1 string))))
1225              (epg-context-result-for context 'error)))))
1226
1227 (defun epg--status-SIG_CREATED (context string)
1228   (if (string-match "\\`\\([DCS]\\) \\([0-9]+\\) \\([0-9]+\\) \
1229 \\([0-9A-Fa-F][0-9A-Fa-F]\\) \\(.*\\) " string)
1230       (epg-context-set-result-for
1231        context 'sign
1232        (cons (epg-make-new-signature
1233               (cdr (assq (aref (match-string 1 string) 0)
1234                          epg-new-signature-type-alist))
1235               (string-to-number (match-string 2 string))
1236               (string-to-number (match-string 3 string))
1237               (string-to-number (match-string 4 string) 16)
1238               (epg--time-from-seconds (match-string 5 string))
1239               (substring string (match-end 0)))
1240              (epg-context-result-for context 'sign)))))
1241
1242 (defun epg--status-KEY_CREATED (context string)
1243   (if (string-match "\\`\\([BPS]\\) \\([^ ]+\\)" string)
1244       (epg-context-set-result-for
1245        context 'generate-key
1246        (cons (list (cons 'type (string-to-char (match-string 1 string)))
1247                    (cons 'fingerprint (match-string 2 string)))
1248              (epg-context-result-for context 'generate-key)))))
1249
1250 (defun epg--status-KEY_NOT_CREATED (context string)
1251   (epg-context-set-result-for
1252    context 'error
1253    (cons '(key-not-created)
1254          (epg-context-result-for context 'error))))
1255
1256 (defun epg--status-IMPORTED (context string)
1257   (if (string-match "\\`\\([^ ]+\\) \\(.*\\)" string)
1258       (let* ((key-id (match-string 1 string))
1259              (user-id (match-string 2 string))
1260              (entry (assoc key-id epg-user-id-alist)))
1261         (if entry
1262             (setcdr entry user-id)
1263           (setq epg-user-id-alist (cons (cons key-id user-id)
1264                                         epg-user-id-alist)))
1265         (epg-context-set-result-for
1266          context 'import
1267          (cons (list (cons 'key-id key-id)
1268                      (cons 'user-id user-id))
1269                (epg-context-result-for context 'import))))))
1270
1271 (defun epg--status-IMPORT_OK (context string)
1272   (let ((result (epg-context-result-for context 'import)))
1273     (if (and result
1274              (string-match "\\`\\([0-9]+\\)\\( \\(.+\\)\\)?" string))
1275         (setcar result
1276                 (append (list (cons 'reason
1277                                     (string-to-number
1278                                      (match-string 1 string))))
1279                         (if (match-beginning 2)
1280                             (list (cons 'fingerprint
1281                                         (match-string 3 string))))
1282                         (car result))))))
1283
1284 (defun epg--status-IMPORT_PROBLEM (context string)
1285   (if (string-match "\\`\\([0-9]+\\)\\( \\(.+\\)\\)?" string)
1286       (epg-context-set-result-for
1287        context 'error
1288        (cons (cons 'import-problem
1289                    (append (list (cons 'reason
1290                                        (string-to-number
1291                                         (match-string 1 string))))
1292                            (if (match-beginning 2)
1293                                (list (cons 'fingerprint
1294                                            (match-string 3 string))))))
1295              (epg-context-result-for context 'error)))))
1296
1297 (defun epg-passphrase-callback-function (context key-id handback)
1298   (if (eq key-id 'SYM)
1299       (read-passwd "Passphrase for symmetric encryption: "
1300                    (eq (epg-context-operation context) 'encrypt))
1301     (read-passwd
1302      (if (eq key-id 'PIN)
1303         "Passphrase for PIN: "
1304        (let ((entry (assoc key-id epg-user-id-alist)))
1305          (if entry
1306              (format "Passphrase for %s %s: " key-id (cdr entry))
1307            (format "Passphrase for %s: " key-id)))))))
1308
1309 (defun epg-progress-callback-function (context what char current total
1310                                                handback)
1311   (message "%s: %d%% (%d/%d)" what
1312            (if (> total 0) (floor (* (/ current (float total)) 100)) 0)
1313            current total))
1314
1315 (defun epg--list-keys-1 (context name mode)
1316   (let ((args (append (if epg-gpg-home-directory
1317                           (list "--homedir" epg-gpg-home-directory))
1318                       (list "--with-colons" "--no-greeting" "--batch"
1319                             "--with-fingerprint"
1320                             "--with-fingerprint"
1321                             (if (memq mode '(t secret))
1322                                 "--list-secret-keys"
1323                               (if (memq mode '(nil public))
1324                                   "--list-keys"
1325                                 "--list-sigs")))
1326                       (unless (eq (epg-context-protocol context) 'CMS)
1327                         '("--fixed-list-mode"))
1328                       (if name (list name))))
1329         keys string field index)
1330     (with-temp-buffer
1331       (apply #'call-process
1332              (if (eq (epg-context-protocol context) 'CMS)
1333                  epg-gpgsm-program
1334                epg-gpg-program)
1335              nil (list t nil) nil args)
1336       (goto-char (point-min))
1337       (while (re-search-forward "^[a-z][a-z][a-z]:.*" nil t)
1338         (setq keys (cons (make-vector 15 nil) keys)
1339               string (match-string 0)
1340               index 0
1341               field 0)
1342         (while (eq index
1343                    (string-match "\\([^:]+\\)?:" string index))
1344           (setq index (match-end 0))
1345           (aset (car keys) field (match-string 1 string))
1346           (setq field (1+ field))))
1347       (nreverse keys))))
1348
1349 (defun epg--make-sub-key-1 (line)
1350   (epg-make-sub-key
1351    (if (aref line 1)
1352        (cdr (assq (string-to-char (aref line 1)) epg-key-validity-alist)))
1353    (delq nil
1354          (mapcar (lambda (char) (cdr (assq char epg-key-capablity-alist)))
1355                  (aref line 11)))
1356    (member (aref line 0) '("sec" "ssb"))
1357    (string-to-number (aref line 3))
1358    (string-to-number (aref line 2))
1359    (aref line 4)
1360    (epg--time-from-seconds (aref line 5))
1361    (epg--time-from-seconds (aref line 6))))
1362
1363 ;;;###autoload
1364 (defun epg-list-keys (context &optional name mode)
1365   "Return a list of epg-key objects matched with NAME.
1366 If MODE is nil or 'public, only public keyring should be searched.
1367 If MODE is t or 'secret, only secret keyring should be searched. 
1368 Otherwise, only public keyring should be searched and the key
1369 signatures should be included."
1370   (let ((lines (epg--list-keys-1 context name mode))
1371         keys cert pointer pointer-1)
1372     (while lines
1373       (cond
1374        ((member (aref (car lines) 0) '("pub" "sec" "crt" "crs"))
1375         (setq cert (member (aref (car lines) 0) '("crt" "crs"))
1376               keys (cons (epg-make-key
1377                           (if (aref (car lines) 8)
1378                               (cdr (assq (string-to-char (aref (car lines) 8))
1379                                          epg-key-validity-alist))))
1380                          keys))
1381         (epg-key-set-sub-key-list
1382          (car keys)
1383          (cons (epg--make-sub-key-1 (car lines))
1384                (epg-key-sub-key-list (car keys)))))
1385        ((member (aref (car lines) 0) '("sub" "ssb"))
1386         (epg-key-set-sub-key-list
1387          (car keys)
1388          (cons (epg--make-sub-key-1 (car lines))
1389                (epg-key-sub-key-list (car keys)))))
1390        ((equal (aref (car lines) 0) "uid")
1391         (epg-key-set-user-id-list
1392          (car keys)
1393          (cons (epg-make-user-id
1394                 (if (aref (car lines) 1)
1395                     (cdr (assq (string-to-char (aref (car lines) 1))
1396                                epg-key-validity-alist)))
1397                 (if cert
1398                     (condition-case nil
1399                         (epg-dn-from-string (aref (car lines) 9))
1400                       (error (aref (car lines) 9)))
1401                   (aref (car lines) 9)))
1402                (epg-key-user-id-list (car keys)))))
1403        ((equal (aref (car lines) 0) "fpr")
1404         (epg-sub-key-set-fingerprint (car (epg-key-sub-key-list (car keys)))
1405                                      (aref (car lines) 9)))
1406        ((equal (aref (car lines) 0) "sig")
1407         (epg-user-id-set-signature-list
1408          (car (epg-key-user-id-list (car keys)))
1409          (cons
1410           (epg-make-key-signature
1411            (if (aref (car lines) 1)
1412                (cdr (assq (string-to-char (aref (car lines) 1))
1413                           epg-key-validity-alist)))
1414            (string-to-number (aref (car lines) 3))
1415            (aref (car lines) 4)
1416            (epg--time-from-seconds (aref (car lines) 5))
1417            (epg--time-from-seconds (aref (car lines) 6))
1418            (aref (car lines) 9)
1419            (string-to-number (aref (car lines) 10) 16)
1420            (eq (aref (aref (car lines) 10) 2) ?x))
1421           (epg-user-id-signature-list
1422            (car (epg-key-user-id-list (car keys))))))))
1423       (setq lines (cdr lines)))
1424     (setq keys (nreverse keys)
1425           pointer keys)
1426     (while pointer
1427       (epg-key-set-sub-key-list
1428        (car pointer)
1429        (nreverse (epg-key-sub-key-list (car pointer))))
1430       (setq pointer-1 (epg-key-set-user-id-list
1431                           (car pointer)
1432                           (nreverse (epg-key-user-id-list (car pointer)))))
1433       (while pointer-1
1434         (epg-user-id-set-signature-list
1435          (car pointer-1)
1436          (nreverse (epg-user-id-signature-list (car pointer-1))))
1437         (setq pointer-1 (cdr pointer-1)))
1438       (setq pointer (cdr pointer)))
1439     keys))
1440
1441 (if (fboundp 'make-temp-file)
1442     (defalias 'epg--make-temp-file 'make-temp-file)
1443   (defvar temporary-file-directory)
1444   ;; stolen from poe.el.
1445   (defun epg--make-temp-file (prefix)
1446     "Create a temporary file.
1447 The returned file name (created by appending some random characters at the end
1448 of PREFIX, and expanding against `temporary-file-directory' if necessary),
1449 is guaranteed to point to a newly created empty file.
1450 You can then use `write-region' to write new data into the file."
1451     (let (tempdir tempfile)
1452       (setq prefix (expand-file-name prefix
1453                                      (if (featurep 'xemacs)
1454                                          (temp-directory)
1455                                        temporary-file-directory)))
1456       (unwind-protect
1457           (let (file)
1458             ;; First, create a temporary directory.
1459             (while (condition-case ()
1460                        (progn
1461                          (setq tempdir (make-temp-name
1462                                         (concat
1463                                          (file-name-directory prefix)
1464                                          "DIR")))
1465                          ;; return nil or signal an error.
1466                          (make-directory tempdir))
1467                      ;; let's try again.
1468                      (file-already-exists t)))
1469             (set-file-modes tempdir 448)
1470             ;; Second, create a temporary file in the tempdir.
1471             ;; There *is* a race condition between `make-temp-name'
1472             ;; and `write-region', but we don't care it since we are
1473             ;; in a private directory now.
1474             (setq tempfile (make-temp-name (concat tempdir "/EMU")))
1475             (write-region "" nil tempfile nil 'silent)
1476             (set-file-modes tempfile 384)
1477             ;; Finally, make a hard-link from the tempfile.
1478             (while (condition-case ()
1479                        (progn
1480                          (setq file (make-temp-name prefix))
1481                          ;; return nil or signal an error.
1482                          (add-name-to-file tempfile file))
1483                      ;; let's try again.
1484                      (file-already-exists t)))
1485             file)
1486         ;; Cleanup the tempfile.
1487         (and tempfile
1488              (file-exists-p tempfile)
1489              (delete-file tempfile))
1490         ;; Cleanup the tempdir.
1491         (and tempdir
1492              (file-directory-p tempdir)
1493              (delete-directory tempdir))))))
1494
1495 (if (fboundp 'clear-string)
1496     (defalias 'epg--clear-string 'clear-string)
1497   (defun epg--clear-string (string)
1498     (fillarray string 0)))
1499
1500 ;;;###autoload
1501 (defun epg-cancel (context)
1502   (if (buffer-live-p (process-buffer (epg-context-process context)))
1503       (save-excursion
1504         (set-buffer (process-buffer (epg-context-process context)))
1505         (epg-context-set-result-for
1506          epg-context 'error
1507          (cons '(quit)
1508                (epg-context-result-for epg-context 'error)))))
1509   (if (eq (process-status (epg-context-process context)) 'run)
1510       (delete-process (epg-context-process context))))
1511   
1512 ;;;###autoload
1513 (defun epg-start-decrypt (context cipher)
1514   "Initiate a decrypt operation on CIPHER.
1515 CIPHER must be a file data object.
1516
1517 If you use this function, you will need to wait for the completion of
1518 `epg-gpg-program' by using `epg-wait-for-completion' and call
1519 `epg-reset' to clear a temporaly output file.
1520 If you are unsure, use synchronous version of this function
1521 `epg-decrypt-file' or `epg-decrypt-string' instead."
1522   (unless (epg-data-file cipher)
1523     (error "Not a file"))
1524   (epg-context-set-operation context 'decrypt)
1525   (epg-context-set-result context nil)
1526   (epg--start context (list "--decrypt" "--" (epg-data-file cipher)))
1527   ;; `gpgsm' does not read passphrase from stdin, so waiting is not needed.
1528   (unless (eq (epg-context-protocol context) 'CMS)
1529     (epg-wait-for-status context '("BEGIN_DECRYPTION"))))
1530
1531 ;;;###autoload
1532 (defun epg-decrypt-file (context cipher plain)
1533   "Decrypt a file CIPHER and store the result to a file PLAIN.
1534 If PLAIN is nil, it returns the result as a string."
1535   (unwind-protect
1536       (progn
1537         (if plain
1538             (epg-context-set-output-file context plain)
1539           (epg-context-set-output-file context
1540                                        (epg--make-temp-file "epg-output")))
1541         (epg-start-decrypt context (epg-make-data-from-file cipher))
1542         (epg-wait-for-completion context)
1543         (if (epg-context-result-for context 'error)
1544             (error "Decrypt failed: %S"
1545                    (epg-context-result-for context 'error)))
1546         (unless plain
1547           (epg-read-output context)))
1548     (unless plain
1549       (epg-delete-output-file context))
1550     (epg-reset context)))
1551
1552 ;;;###autoload
1553 (defun epg-decrypt-string (context cipher)
1554   "Decrypt a string CIPHER and return the plain text."
1555   (let ((input-file (epg--make-temp-file "epg-input"))
1556         (coding-system-for-write 'binary))
1557     (unwind-protect
1558         (progn
1559           (write-region cipher nil input-file nil 'quiet)
1560           (epg-context-set-output-file context
1561                                        (epg--make-temp-file "epg-output"))
1562           (epg-start-decrypt context (epg-make-data-from-file input-file))
1563           (epg-wait-for-completion context)
1564           (if (epg-context-result-for context 'error)
1565               (error "Decrypt failed: %S"
1566                      (epg-context-result-for context 'error)))
1567           (epg-read-output context))
1568       (epg-delete-output-file context)
1569       (if (file-exists-p input-file)
1570           (delete-file input-file))
1571       (epg-reset context))))
1572
1573 ;;;###autoload
1574 (defun epg-start-verify (context signature &optional signed-text)
1575   "Initiate a verify operation on SIGNATURE.
1576 SIGNATURE and SIGNED-TEXT are a data object if they are specified.
1577
1578 For a detached signature, both SIGNATURE and SIGNED-TEXT should be set.
1579 For a normal or a clear text signature, SIGNED-TEXT should be nil.
1580
1581 If you use this function, you will need to wait for the completion of
1582 `epg-gpg-program' by using `epg-wait-for-completion' and call
1583 `epg-reset' to clear a temporaly output file.
1584 If you are unsure, use synchronous version of this function
1585 `epg-verify-file' or `epg-verify-string' instead."
1586   (epg-context-set-operation context 'verify)
1587   (epg-context-set-result context nil)
1588   (if signed-text
1589       ;; Detached signature.
1590       (if (epg-data-file signed-text)
1591           (epg--start context (list "--verify" "--" (epg-data-file signature)
1592                                    (epg-data-file signed-text)))
1593         (epg--start context (list "--verify" (epg-data-file signature) "-"))
1594         (if (eq (process-status (epg-context-process context)) 'run)
1595             (process-send-string (epg-context-process context)
1596                                  (epg-data-string signed-text)))
1597         (if (eq (process-status (epg-context-process context)) 'run)
1598             (process-send-eof (epg-context-process context))))
1599     ;; Normal (or cleartext) signature.
1600     (if (epg-data-file signature)
1601         (epg--start context (list "--verify" "--" (epg-data-file signature)))
1602       (epg--start context (list "--verify"))
1603       (if (eq (process-status (epg-context-process context)) 'run)
1604           (process-send-string (epg-context-process context)
1605                                (epg-data-string signature)))
1606       (if (eq (process-status (epg-context-process context)) 'run)
1607           (process-send-eof (epg-context-process context))))))
1608
1609 ;;;###autoload
1610 (defun epg-verify-file (context signature &optional signed-text plain)
1611   "Verify a file SIGNATURE.
1612 SIGNED-TEXT and PLAIN are also a file if they are specified.
1613
1614 For a detached signature, both SIGNATURE and SIGNED-TEXT should be string.
1615 For a normal or a clear text signature, SIGNED-TEXT should be nil."
1616   (unwind-protect
1617       (progn
1618         (if plain
1619             (epg-context-set-output-file context plain)
1620           (epg-context-set-output-file context
1621                                        (epg--make-temp-file "epg-output")))
1622         (if signed-text
1623             (epg-start-verify context
1624                               (epg-make-data-from-file signature)
1625                               (epg-make-data-from-file signed-text))
1626           (epg-start-verify context
1627                             (epg-make-data-from-file signature)))
1628         (epg-wait-for-completion context)
1629 ;       (if (epg-context-result-for context 'error)
1630 ;           (error "Verify failed: %S"
1631 ;                  (epg-context-result-for context 'error)))
1632         (unless plain
1633           (epg-read-output context)))
1634     (unless plain
1635       (epg-delete-output-file context))
1636     (epg-reset context)))
1637
1638 ;;;###autoload
1639 (defun epg-verify-string (context signature &optional signed-text)
1640   "Verify a string SIGNATURE.
1641 SIGNED-TEXT is a string if it is specified.
1642
1643 For a detached signature, both SIGNATURE and SIGNED-TEXT should be string.
1644 For a normal or a clear text signature, SIGNED-TEXT should be nil."
1645   (let ((coding-system-for-write 'binary)
1646         input-file)
1647     (unwind-protect
1648         (progn
1649           (epg-context-set-output-file context
1650                                        (epg--make-temp-file "epg-output"))
1651           (if signed-text
1652               (progn
1653                 (setq input-file (epg--make-temp-file "epg-signature"))
1654                 (write-region signature nil input-file nil 'quiet)
1655                 (epg-start-verify context
1656                                   (epg-make-data-from-file input-file)
1657                                   (epg-make-data-from-string signed-text)))
1658             (epg-start-verify context (epg-make-data-from-string signature)))
1659           (epg-wait-for-completion context)
1660 ;         (if (epg-context-result-for context 'error)
1661 ;             (error "Verify failed: %S"
1662 ;                    (epg-context-result-for context 'error)))
1663           (epg-read-output context))
1664       (epg-delete-output-file context)
1665       (if (and input-file
1666                (file-exists-p input-file))
1667           (delete-file input-file))
1668       (epg-reset context))))
1669
1670 ;;;###autoload
1671 (defun epg-start-sign (context plain &optional mode)
1672   "Initiate a sign operation on PLAIN.
1673 PLAIN is a data object.
1674
1675 If optional 3rd argument MODE is t or 'detached, it makes a detached signature.
1676 If it is nil or 'normal, it makes a normal signature.
1677 Otherwise, it makes a clear text signature.
1678
1679 If you use this function, you will need to wait for the completion of
1680 `epg-gpg-program' by using `epg-wait-for-completion' and call
1681 `epg-reset' to clear a temporaly output file.
1682 If you are unsure, use synchronous version of this function
1683 `epg-sign-file' or `epg-sign-string' instead."
1684   (epg-context-set-operation context 'sign)
1685   (epg-context-set-result context nil)
1686   (epg--start context
1687              (append (list (if (memq mode '(t detached))
1688                                "--detach-sign"
1689                              (if (memq mode '(nil normal))
1690                                  "--sign"
1691                                "--clearsign")))
1692                      (apply #'nconc
1693                             (mapcar
1694                              (lambda (signer)
1695                                (list "-u"
1696                                      (epg-sub-key-id
1697                                       (car (epg-key-sub-key-list signer)))))
1698                              (epg-context-signers context)))
1699                      (if (epg-data-file plain)
1700                          (list "--" (epg-data-file plain)))))
1701   ;; `gpgsm' does not read passphrase from stdin, so waiting is not needed.
1702   (unless (eq (epg-context-protocol context) 'CMS)
1703     (epg-wait-for-status context '("BEGIN_SIGNING")))
1704   (when (epg-data-string plain)
1705     (if (eq (process-status (epg-context-process context)) 'run)
1706         (process-send-string (epg-context-process context)
1707                              (epg-data-string plain)))
1708     (if (eq (process-status (epg-context-process context)) 'run)
1709         (process-send-eof (epg-context-process context)))))
1710
1711 ;;;###autoload
1712 (defun epg-sign-file (context plain signature &optional mode)
1713   "Sign a file PLAIN and store the result to a file SIGNATURE.
1714 If SIGNATURE is nil, it returns the result as a string.
1715 If optional 3rd argument MODE is t or 'detached, it makes a detached signature.
1716 If it is nil or 'normal, it makes a normal signature.
1717 Otherwise, it makes a clear text signature."
1718   (unwind-protect
1719       (progn
1720         (if signature
1721             (epg-context-set-output-file context signature)
1722           (epg-context-set-output-file context
1723                                        (epg--make-temp-file "epg-output")))
1724         (epg-start-sign context (epg-make-data-from-file plain) mode)
1725         (epg-wait-for-completion context)
1726         (unless (epg-context-result-for context 'sign)
1727           (if (epg-context-result-for context 'error)
1728               (error "Sign failed: %S"
1729                      (epg-context-result-for context 'error))
1730             (error "Sign failed")))
1731         (unless signature
1732           (epg-read-output context)))
1733     (unless signature
1734       (epg-delete-output-file context))
1735     (epg-reset context)))
1736
1737 ;;;###autoload
1738 (defun epg-sign-string (context plain &optional mode)
1739   "Sign a string PLAIN and return the output as string.
1740 If optional 3rd argument MODE is t or 'detached, it makes a detached signature.
1741 If it is nil or 'normal, it makes a normal signature.
1742 Otherwise, it makes a clear text signature."
1743   (unwind-protect
1744       (progn
1745         (epg-context-set-output-file context
1746                                      (epg--make-temp-file "epg-output"))
1747         (epg-start-sign context (epg-make-data-from-string plain) mode)
1748         (epg-wait-for-completion context)
1749         (unless (epg-context-result-for context 'sign)
1750           (if (epg-context-result-for context 'error)
1751               (error "Sign failed: %S"
1752                      (epg-context-result-for context 'error))
1753             (error "Sign failed")))
1754         (epg-read-output context))
1755     (epg-delete-output-file context)
1756     (epg-reset context)))
1757
1758 ;;;###autoload
1759 (defun epg-start-encrypt (context plain recipients
1760                                   &optional sign always-trust)
1761   "Initiate an encrypt operation on PLAIN.
1762 PLAIN is a data object.
1763 If RECIPIENTS is nil, it performs symmetric encryption.
1764
1765 If you use this function, you will need to wait for the completion of
1766 `epg-gpg-program' by using `epg-wait-for-completion' and call
1767 `epg-reset' to clear a temporaly output file.
1768 If you are unsure, use synchronous version of this function
1769 `epg-encrypt-file' or `epg-encrypt-string' instead."
1770   (epg-context-set-operation context 'encrypt)
1771   (epg-context-set-result context nil)
1772   (epg--start context
1773              (append (if always-trust '("--always-trust"))
1774                      (if recipients '("--encrypt") '("--symmetric"))
1775                      (if sign
1776                          (cons "--sign"
1777                                (apply #'nconc
1778                                       (mapcar
1779                                        (lambda (signer)
1780                                          (list "-u"
1781                                                (epg-sub-key-id
1782                                                 (car (epg-key-sub-key-list
1783                                                       signer)))))
1784                                        (epg-context-signers context)))))
1785                      (apply #'nconc
1786                             (mapcar
1787                              (lambda (recipient)
1788                                (list "-r"
1789                                      (epg-sub-key-id
1790                                       (car (epg-key-sub-key-list recipient)))))
1791                              recipients))
1792                      (if (epg-data-file plain)
1793                          (list "--" (epg-data-file plain)))))
1794   ;; `gpgsm' does not read passphrase from stdin, so waiting is not needed.
1795   (unless (eq (epg-context-protocol context) 'CMS)
1796     (if sign
1797         (epg-wait-for-status context '("BEGIN_SIGNING"))
1798       (epg-wait-for-status context '("BEGIN_ENCRYPTION"))))
1799   (when (epg-data-string plain)
1800     (if (eq (process-status (epg-context-process context)) 'run)
1801         (process-send-string (epg-context-process context)
1802                              (epg-data-string plain)))
1803     (if (eq (process-status (epg-context-process context)) 'run)
1804         (process-send-eof (epg-context-process context)))))
1805
1806 ;;;###autoload
1807 (defun epg-encrypt-file (context plain recipients
1808                                  cipher &optional sign always-trust)
1809   "Encrypt a file PLAIN and store the result to a file CIPHER.
1810 If CIPHER is nil, it returns the result as a string.
1811 If RECIPIENTS is nil, it performs symmetric encryption."
1812   (unwind-protect
1813       (progn
1814         (if cipher
1815             (epg-context-set-output-file context cipher)
1816           (epg-context-set-output-file context
1817                                        (epg--make-temp-file "epg-output")))
1818         (epg-start-encrypt context (epg-make-data-from-file plain)
1819                            recipients sign always-trust)
1820         (epg-wait-for-completion context)
1821         (if (and sign
1822                  (not (epg-context-result-for context 'sign)))
1823             (if (epg-context-result-for context 'error)
1824                 (error "Sign failed: %S"
1825                        (epg-context-result-for context 'error))
1826                 (error "Sign failed")))
1827         (if (epg-context-result-for context 'error)
1828             (error "Encrypt failed: %S"
1829                    (epg-context-result-for context 'error)))
1830         (unless cipher
1831           (epg-read-output context)))
1832     (unless cipher
1833       (epg-delete-output-file context))
1834     (epg-reset context)))
1835
1836 ;;;###autoload
1837 (defun epg-encrypt-string (context plain recipients
1838                                    &optional sign always-trust)
1839   "Encrypt a string PLAIN.
1840 If RECIPIENTS is nil, it performs symmetric encryption."
1841   (unwind-protect
1842       (progn
1843         (epg-context-set-output-file context
1844                                      (epg--make-temp-file "epg-output"))
1845         (epg-start-encrypt context (epg-make-data-from-string plain)
1846                            recipients sign always-trust)
1847         (epg-wait-for-completion context)
1848         (if (and sign
1849                  (not (epg-context-result-for context 'sign)))
1850             (if (epg-context-result-for context 'error)
1851                 (error "Sign failed: %S"
1852                        (epg-context-result-for context 'error))
1853               (error "Sign failed")))
1854         (if (epg-context-result-for context 'error)
1855             (error "Encrypt failed: %S"
1856                    (epg-context-result-for context 'error)))
1857         (epg-read-output context))
1858     (epg-delete-output-file context)
1859     (epg-reset context)))
1860
1861 ;;;###autoload
1862 (defun epg-start-export-keys (context keys)
1863   "Initiate an export keys operation.
1864
1865 If you use this function, you will need to wait for the completion of
1866 `epg-gpg-program' by using `epg-wait-for-completion' and call
1867 `epg-reset' to clear a temporaly output file.
1868 If you are unsure, use synchronous version of this function
1869 `epg-export-keys-to-file' or `epg-export-keys-to-string' instead."
1870   (epg-context-set-operation context 'export-keys)
1871   (epg-context-set-result context nil)
1872   (epg--start context (cons "--export"
1873                            (mapcar
1874                             (lambda (key)
1875                               (epg-sub-key-id
1876                                (car (epg-key-sub-key-list key))))
1877                             keys))))
1878
1879 ;;;###autoload
1880 (defun epg-export-keys-to-file (context keys file)
1881   "Extract public KEYS."
1882   (unwind-protect
1883       (progn
1884         (if keys
1885             (epg-context-set-output-file context file)
1886           (epg-context-set-output-file context
1887                                        (epg--make-temp-file "epg-output")))
1888         (epg-start-export-keys context keys)
1889         (epg-wait-for-completion context)
1890         (if (epg-context-result-for context 'error)
1891             (error "Export keys failed: %S"
1892                    (epg-context-result-for context 'error)))
1893         (unless file
1894           (epg-read-output context)))
1895     (unless file
1896       (epg-delete-output-file context))
1897     (epg-reset context)))
1898
1899 ;;;###autoload
1900 (defun epg-export-keys-to-string (context keys)
1901   "Extract public KEYS and return them as a string."
1902   (epg-export-keys-to-file context keys nil))
1903
1904 ;;;###autoload
1905 (defun epg-start-import-keys (context keys)
1906   "Initiate an import keys operation.
1907 KEYS is a data object.
1908
1909 If you use this function, you will need to wait for the completion of
1910 `epg-gpg-program' by using `epg-wait-for-completion' and call
1911 `epg-reset' to clear a temporaly output file.
1912 If you are unsure, use synchronous version of this function
1913 `epg-import-keys-from-file' or `epg-import-keys-from-string' instead."
1914   (epg-context-set-operation context 'import-keys)
1915   (epg-context-set-result context nil)
1916   (epg--start context (if (epg-data-file keys)
1917                           (list "--import" "--" (epg-data-file keys))
1918                         (list "--import")))
1919   (when (epg-data-string keys)
1920     (if (eq (process-status (epg-context-process context)) 'run)
1921         (process-send-string (epg-context-process context)
1922                              (epg-data-string keys)))
1923     (if (eq (process-status (epg-context-process context)) 'run)
1924         (process-send-eof (epg-context-process context)))))
1925
1926 (defun epg--import-keys-1 (context keys)
1927   (unwind-protect
1928       (progn
1929         (epg-start-import-keys context keys)
1930         (epg-wait-for-completion context)
1931         (if (epg-context-result-for context 'error)
1932             (error "Import keys failed: %S"
1933                    (epg-context-result-for context 'error))))
1934     (epg-reset context)))
1935
1936 ;;;###autoload
1937 (defun epg-import-keys-from-file (context keys)
1938   "Add keys from a file KEYS."
1939   (epg--import-keys-1 context (epg-make-data-from-file keys)))
1940
1941 ;;;###autoload
1942 (defun epg-import-keys-from-string (context keys)
1943   "Add keys from a string KEYS."
1944   (epg--import-keys-1 context (epg-make-data-from-string keys)))
1945
1946 ;;;###autoload
1947 (defun epg-start-receive-keys (context key-id-list)
1948   "Initiate a receive key operation.
1949 KEY-ID-LIST is a list of key IDs.
1950
1951 If you use this function, you will need to wait for the completion of
1952 `epg-gpg-program' by using `epg-wait-for-completion' and call
1953 `epg-reset' to clear a temporaly output file.
1954 If you are unsure, use synchronous version of this function
1955 `epg-generate-key-from-file' or `epg-generate-key-from-string' instead."
1956   (epg-context-set-operation context 'receive-keys)
1957   (epg-context-set-result context nil)
1958   (epg--start context (cons "--recv-keys" key-id-list)))
1959
1960 ;;;###autoload
1961 (defun epg-receive-keys (context keys)
1962   "Add keys from server.
1963 KEYS is a list of key IDs"
1964   (unwind-protect
1965       (progn
1966         (epg-start-receive-keys context keys)
1967         (epg-wait-for-completion context)
1968         (if (epg-context-result-for context 'error)
1969             (error "Receive keys failed: %S"
1970                    (epg-context-result-for context 'error))))
1971     (epg-reset context)))
1972
1973 ;;;###autoload
1974 (defalias 'epg-import-keys-from-server 'epg-receive-keys)
1975
1976 ;;;###autoload
1977 (defun epg-start-delete-keys (context keys &optional allow-secret)
1978   "Initiate an delete keys operation.
1979
1980 If you use this function, you will need to wait for the completion of
1981 `epg-gpg-program' by using `epg-wait-for-completion' and call
1982 `epg-reset' to clear a temporaly output file.
1983 If you are unsure, use synchronous version of this function
1984 `epg-delete-keys' instead."
1985   (epg-context-set-operation context 'delete-keys)
1986   (epg-context-set-result context nil)
1987   (epg--start context (cons (if allow-secret
1988                                "--delete-secret-key"
1989                              "--delete-key")
1990                            (mapcar
1991                             (lambda (key)
1992                               (epg-sub-key-id
1993                                (car (epg-key-sub-key-list key))))
1994                             keys))))
1995
1996 ;;;###autoload
1997 (defun epg-delete-keys (context keys &optional allow-secret)
1998   "Delete KEYS from the key ring."
1999   (unwind-protect
2000       (progn
2001         (epg-start-delete-keys context keys allow-secret)
2002         (epg-wait-for-completion context)
2003         (if (epg-context-result-for context 'error)
2004             (error "Delete keys failed: %S"
2005                    (epg-context-result-for context 'error))))
2006     (epg-reset context)))
2007
2008 ;;;###autoload
2009 (defun epg-start-sign-keys (context keys &optional local)
2010   "Initiate an sign keys operation.
2011
2012 If you use this function, you will need to wait for the completion of
2013 `epg-gpg-program' by using `epg-wait-for-completion' and call
2014 `epg-reset' to clear a temporaly output file.
2015 If you are unsure, use synchronous version of this function
2016 `epg-sign-keys' instead."
2017   (epg-context-set-operation context 'sign-keys)
2018   (epg-context-set-result context nil)
2019   (epg--start context (cons (if local
2020                                "--lsign-key"
2021                              "--sign-key")
2022                            (mapcar
2023                             (lambda (key)
2024                               (epg-sub-key-id
2025                                (car (epg-key-sub-key-list key))))
2026                             keys))))
2027
2028 ;;;###autoload
2029 (defun epg-sign-keys (context keys &optional local)
2030   "Sign KEYS from the key ring."
2031   (unwind-protect
2032       (progn
2033         (epg-start-sign-keys context keys local)
2034         (epg-wait-for-completion context)
2035         (if (epg-context-result-for context 'error)
2036             (error "Sign keys failed: %S"
2037                    (epg-context-result-for context 'error))))
2038     (epg-reset context)))
2039
2040 ;;;###autoload
2041 (defun epg-start-generate-key (context parameters)
2042   "Initiate a key generation.
2043 PARAMETERS specifies parameters for the key.
2044
2045 If you use this function, you will need to wait for the completion of
2046 `epg-gpg-program' by using `epg-wait-for-completion' and call
2047 `epg-reset' to clear a temporaly output file.
2048 If you are unsure, use synchronous version of this function
2049 `epg-generate-key-from-file' or `epg-generate-key-from-string' instead."
2050   (epg-context-set-operation context 'generate-key)
2051   (epg-context-set-result context nil)
2052   (if (epg-data-file parameters)
2053       (epg--start context (list "--batch" "--genkey" "--"
2054                                (epg-data-file parameters)))
2055     (epg--start context '("--batch" "--genkey"))
2056     (if (eq (process-status (epg-context-process context)) 'run)
2057         (process-send-string (epg-context-process context)
2058                              (epg-data-string parameters)))
2059     (if (eq (process-status (epg-context-process context)) 'run)
2060         (process-send-eof (epg-context-process context)))))
2061
2062 ;;;###autoload
2063 (defun epg-generate-key-from-file (context parameters)
2064   "Generate a new key pair.
2065 PARAMETERS is a file which tells how to create the key."
2066   (unwind-protect
2067       (progn
2068         (epg-start-generate-key context (epg-make-data-from-file parameters))
2069         (epg-wait-for-completion context)
2070         (if (epg-context-result-for context 'error)
2071             (error "Generate key failed: %S"
2072                    (epg-context-result-for context 'error))))
2073     (epg-reset context)))
2074
2075 ;;;###autoload
2076 (defun epg-generate-key-from-string (context parameters)
2077   "Generate a new key pair.
2078 PARAMETERS is a string which tells how to create the key."
2079   (unwind-protect
2080       (progn
2081         (epg-start-generate-key context (epg-make-data-from-string parameters))
2082         (epg-wait-for-completion context)
2083         (if (epg-context-result-for context 'error)
2084             (error "Generate key failed: %S"
2085                    (epg-context-result-for context 'error))))
2086     (epg-reset context)))
2087
2088 (defun epg--decode-hexstring (string)
2089   (let ((index 0))
2090     (while (eq index (string-match "[0-9A-Fa-f][0-9A-Fa-f]" string index))
2091       (setq string (replace-match "\\x\\&" t nil string)
2092             index (+ index 4)))
2093     (car (read-from-string (concat "\"" string "\"")))))
2094
2095 (defun epg--decode-quotedstring (string)
2096   (let ((index 0))
2097     (while (string-match "\\\\\\(\\([,=+<>#;\\\"]\\)\\|\
2098 \\([0-9A-Fa-f][0-9A-Fa-f]\\)\\|\\(.\\)\\)"
2099                          string index)
2100       (if (match-beginning 2)
2101           (setq string (replace-match "\\2" t nil string)
2102                 index (1+ index))
2103         (if (match-beginning 3)
2104             (setq string (replace-match "\\x\\3" t nil string)
2105                   index (+ index 4))
2106           (setq string (replace-match "\\\\\\\\\\4" t nil string)
2107                 index (+ index 3)))))
2108     (car (read-from-string (concat "\"" string "\"")))))
2109
2110 (defun epg-dn-from-string (string)
2111   "Parse STRING as LADPv3 Distinguished Names (RFC2253).
2112 The return value is an alist mapping from types to values."
2113   (let ((index 0)
2114         (length (length string))
2115         alist type value group)
2116     (while (< index length)
2117       (if (eq index (string-match "[ \t\n\r]*" string index))
2118           (setq index (match-end 0)))
2119       (if (eq index (string-match
2120                      "\\([0-9]+\\(\\.[0-9]+\\)*\\)\[ \t\n\r]*=[ \t\n\r]*"
2121                      string index))
2122           (setq type (match-string 1 string)
2123                 index (match-end 0))
2124         (if (eq index (string-match "\\([0-9A-Za-z]+\\)[ \t\n\r]*=[ \t\n\r]*"
2125                                     string index))
2126             (setq type (match-string 1 string)
2127                   index (match-end 0))))
2128       (unless type
2129         (error "Invalid type"))
2130       (if (eq index (string-match
2131                      "\\([^,=+<>#;\\\"]\\|\\\\.\\)+"
2132                      string index))
2133           (setq index (match-end 0)
2134                 value (epg--decode-quotedstring (match-string 0 string)))
2135         (if (eq index (string-match "#\\([0-9A-Fa-f]+\\)" string index))
2136             (setq index (match-end 0)
2137                   value (epg--decode-hexstring (match-string 1 string)))
2138           (if (eq index (string-match "\"\\([^\\\"]\\|\\\\.\\)*\""
2139                                       string index))
2140               (setq index (match-end 0)
2141                     value (epg--decode-quotedstring
2142                            (match-string 0 string))))))
2143       (if group
2144           (if (stringp (car (car alist)))
2145               (setcar alist (list (cons type value) (car alist)))
2146             (setcar alist (cons (cons type value) (car alist))))
2147         (if (consp (car (car alist)))
2148             (setcar alist (nreverse (car alist))))
2149         (setq alist (cons (cons type value) alist)
2150               type nil
2151               value nil))
2152       (if (eq index (string-match "[ \t\n\r]*\\([,;+]\\)" string index))
2153           (setq index (match-end 0)
2154                 group (eq (aref string (match-beginning 1)) ?+))))
2155     (nreverse alist)))
2156
2157 (defun epg-decode-dn (alist)
2158   "Convert ALIST returned by `epg-dn-from-string' to a human readable form.
2159 Type names are resolved using `epg-dn-type-alist'."
2160   (mapconcat
2161    (lambda (rdn)
2162      (if (stringp (car rdn))
2163          (let ((entry (assoc (car rdn) epg-dn-type-alist)))
2164            (if entry
2165                (format "%s=%s" (cdr entry) (cdr rdn))
2166              (format "%s=%s" (car rdn) (cdr rdn))))
2167        (concat "(" (epg-decode-dn rdn) ")")))
2168    alist
2169    ", "))
2170
2171 (provide 'epg)
2172
2173 ;;; epg.el ends here