]> code.delx.au - gnu-emacs/blobdiff - lisp/epg.el
Merge: Minor changes for problems found by GCC 4.5.2's static checks.
[gnu-emacs] / lisp / epg.el
index 64489858a6dceff33a72e4a6c33ff98fffdc4120..c096ec6df98a5e921c330017025db4879c971cc8 100644 (file)
@@ -1,9 +1,9 @@
 ;;; epg.el --- the EasyPG Library
-;; Copyright (C) 1999, 2000, 2002, 2003, 2004,
-;;   2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
+;; Copyright (C) 1999-2000, 2002-2011 Free Software Foundation, Inc.
 
 ;; Author: Daiki Ueno <ueno@unixuser.org>
 ;; Keywords: PGP, GnuPG
+;; Version: 1.0.0
 
 ;; This file is part of GNU Emacs.
 
@@ -66,7 +66,7 @@
 (defconst epg-digest-algorithm-alist
   '((1 . "MD5")
     (2 . "SHA1")
-    (3 . "RMD160")
+    (3 . "RIPEMD160")
     (8 . "SHA256")
     (9 . "SHA384")
     (10 . "SHA512")
   '((?e . encrypt)
     (?s . sign)
     (?c . certify)
-    (?a . authentication)))
+    (?a . authentication)
+    (?D . disabled)))
 
 (defvar epg-new-signature-type-alist
   '((?D . detached)
     (signal 'wrong-type-argument (list 'epg-data-p data)))
   (aref (cdr data) 1))
 
+;;;###autoload
 (defun epg-make-context (&optional protocol armor textmode include-certs
                                   cipher-algorithm digest-algorithm
                                   compress-algorithm)
@@ -334,7 +336,13 @@ PASSPHRASE-CALLBACK is either a function, or a cons-cell whose
 car is a function and cdr is a callback data.
 
 The function gets three arguments: the context, the key-id in
-question, and the callback data (if any)."
+question, and the callback data (if any).
+
+The callback may not be called if you use GnuPG 2.x, which relies
+on the external program called `gpg-agent' for passphrase query.
+If you really want to intercept passphrase query, consider
+installing GnuPG 1.x _along with_ GnuPG 2.x, which does passphrase
+query by itself and Emacs can intercept them."
   (unless (eq (car-safe context) 'epg-context)
     (signal 'wrong-type-argument (list 'epg-context-p context)))
   (aset (cdr context) 7 (if (consp passphrase-callback)
@@ -1142,8 +1150,7 @@ This function is for internal use only."
        (goto-char (point-max))
        (insert input)))
   (if (buffer-live-p (process-buffer process))
-      (save-excursion
-       (set-buffer (process-buffer process))
+      (with-current-buffer (process-buffer process)
        (goto-char (point-max))
        (insert input)
        (unless epg-process-filter-running
@@ -1186,7 +1193,10 @@ This function is for internal use only."
                epg-pending-status-list)
       (accept-process-output (epg-context-process context) 1))
     (if epg-pending-status-list
-       (epg-context-set-result-for context 'error 'exit))))
+       (epg-context-set-result-for
+        context 'error
+        (cons (list 'exit)
+              (epg-context-result-for context 'error))))))
 
 (defun epg-wait-for-completion (context)
   "Wait until the `epg-gpg-program' process completes."
@@ -1551,14 +1561,14 @@ This function is for internal use only."
 
 (defun epg--status-KEYEXPIRED (context string)
   (epg-context-set-result-for
-   context 'error
+   context 'key
    (cons (list 'key-expired (cons 'expiration-time
                                  (epg--time-from-seconds string)))
         (epg-context-result-for context 'error))))
 
 (defun epg--status-KEYREVOKED (context string)
   (epg-context-set-result-for
-   context 'error
+   context 'key
    (cons '(key-revoked)
         (epg-context-result-for context 'error))))
 
@@ -1755,7 +1765,6 @@ This function is for internal use only."
    (if (aref line 6)
        (epg--time-from-seconds (aref line 6)))))
 
-;;;###autoload
 (defun epg-list-keys (context &optional name mode)
   "Return a list of epg-key objects matched with NAME.
 If MODE is nil or 'public, only public keyring should be searched.
@@ -1922,11 +1931,9 @@ You can then use `write-region' to write new data into the file."
                      (epg-sig-notation-value notation)))))
          notations)))
 
-;;;###autoload
 (defun epg-cancel (context)
   (if (buffer-live-p (process-buffer (epg-context-process context)))
-      (save-excursion
-       (set-buffer (process-buffer (epg-context-process context)))
+      (with-current-buffer (process-buffer (epg-context-process context))
        (epg-context-set-result-for
         epg-context 'error
         (cons '(quit)
@@ -1934,7 +1941,6 @@ You can then use `write-region' to write new data into the file."
   (if (eq (process-status (epg-context-process context)) 'run)
       (delete-process (epg-context-process context))))
 
-;;;###autoload
 (defun epg-start-decrypt (context cipher)
   "Initiate a decrypt operation on CIPHER.
 CIPHER must be a file data object.
@@ -1966,7 +1972,6 @@ If you are unsure, use synchronous version of this function
            (signal 'epg-error (list "No data")))
        (signal 'epg-error (list "Can't decrypt" error)))))
 
-;;;###autoload
 (defun epg-decrypt-file (context cipher plain)
   "Decrypt a file CIPHER and store the result to a file PLAIN.
 If PLAIN is nil, it returns the result as a string."
@@ -1985,7 +1990,6 @@ If PLAIN is nil, it returns the result as a string."
       (epg-delete-output-file context))
     (epg-reset context)))
 
-;;;###autoload
 (defun epg-decrypt-string (context cipher)
   "Decrypt a string CIPHER and return the plain text."
   (let ((input-file (epg--make-temp-file "epg-input"))
@@ -2004,7 +2008,6 @@ If PLAIN is nil, it returns the result as a string."
          (delete-file input-file))
       (epg-reset context))))
 
-;;;###autoload
 (defun epg-start-verify (context signature &optional signed-text)
   "Initiate a verify operation on SIGNATURE.
 SIGNATURE and SIGNED-TEXT are a data object if they are specified.
@@ -2045,7 +2048,6 @@ If you are unsure, use synchronous version of this function
       (if (eq (process-status (epg-context-process context)) 'run)
          (process-send-eof (epg-context-process context))))))
 
-;;;###autoload
 (defun epg-verify-file (context signature &optional signed-text plain)
   "Verify a file SIGNATURE.
 SIGNED-TEXT and PLAIN are also a file if they are specified.
@@ -2073,7 +2075,6 @@ stored into the file after successful verification."
       (epg-delete-output-file context))
     (epg-reset context)))
 
-;;;###autoload
 (defun epg-verify-string (context signature &optional signed-text)
   "Verify a string SIGNATURE.
 SIGNED-TEXT is a string if it is specified.
@@ -2104,7 +2105,6 @@ successful verification."
          (delete-file input-file))
       (epg-reset context))))
 
-;;;###autoload
 (defun epg-start-sign (context plain &optional mode)
   "Initiate a sign operation on PLAIN.
 PLAIN is a data object.
@@ -2150,7 +2150,6 @@ If you are unsure, use synchronous version of this function
     (if (eq (process-status (epg-context-process context)) 'run)
        (process-send-eof (epg-context-process context)))))
 
-;;;###autoload
 (defun epg-sign-file (context plain signature &optional mode)
   "Sign a file PLAIN and store the result to a file SIGNATURE.
 If SIGNATURE is nil, it returns the result as a string.
@@ -2176,7 +2175,6 @@ Otherwise, it makes a cleartext signature."
       (epg-delete-output-file context))
     (epg-reset context)))
 
-;;;###autoload
 (defun epg-sign-string (context plain &optional mode)
   "Sign a string PLAIN and return the output as string.
 If optional 3rd argument MODE is t or 'detached, it makes a detached signature.
@@ -2214,7 +2212,6 @@ Otherwise, it makes a cleartext signature."
          (delete-file input-file))
       (epg-reset context))))
 
-;;;###autoload
 (defun epg-start-encrypt (context plain recipients
                                  &optional sign always-trust)
   "Initiate an encrypt operation on PLAIN.
@@ -2265,7 +2262,6 @@ If you are unsure, use synchronous version of this function
     (if (eq (process-status (epg-context-process context)) 'run)
        (process-send-eof (epg-context-process context)))))
 
-;;;###autoload
 (defun epg-encrypt-file (context plain recipients
                                 cipher &optional sign always-trust)
   "Encrypt a file PLAIN and store the result to a file CIPHER.
@@ -2295,7 +2291,6 @@ If RECIPIENTS is nil, it performs symmetric encryption."
       (epg-delete-output-file context))
     (epg-reset context)))
 
-;;;###autoload
 (defun epg-encrypt-string (context plain recipients
                                   &optional sign always-trust)
   "Encrypt a string PLAIN.
@@ -2337,7 +2332,6 @@ If RECIPIENTS is nil, it performs symmetric encryption."
          (delete-file input-file))
       (epg-reset context))))
 
-;;;###autoload
 (defun epg-start-export-keys (context keys)
   "Initiate an export keys operation.
 
@@ -2355,7 +2349,6 @@ If you are unsure, use synchronous version of this function
                               (car (epg-key-sub-key-list key))))
                            keys))))
 
-;;;###autoload
 (defun epg-export-keys-to-file (context keys file)
   "Extract public KEYS."
   (unwind-protect
@@ -2375,12 +2368,10 @@ If you are unsure, use synchronous version of this function
       (epg-delete-output-file context))
     (epg-reset context)))
 
-;;;###autoload
 (defun epg-export-keys-to-string (context keys)
   "Extract public KEYS and return them as a string."
   (epg-export-keys-to-file context keys nil))
 
-;;;###autoload
 (defun epg-start-import-keys (context keys)
   "Initiate an import keys operation.
 KEYS is a data object.
@@ -2412,17 +2403,14 @@ If you are unsure, use synchronous version of this function
                   (epg-context-result-for context 'error))))
     (epg-reset context)))
 
-;;;###autoload
 (defun epg-import-keys-from-file (context keys)
   "Add keys from a file KEYS."
   (epg--import-keys-1 context (epg-make-data-from-file keys)))
 
-;;;###autoload
 (defun epg-import-keys-from-string (context keys)
   "Add keys from a string KEYS."
   (epg--import-keys-1 context (epg-make-data-from-string keys)))
 
-;;;###autoload
 (defun epg-start-receive-keys (context key-id-list)
   "Initiate a receive key operation.
 KEY-ID-LIST is a list of key IDs.
@@ -2436,7 +2424,6 @@ If you are unsure, use synchronous version of this function
   (epg-context-set-result context nil)
   (epg--start context (cons "--recv-keys" key-id-list)))
 
-;;;###autoload
 (defun epg-receive-keys (context keys)
   "Add keys from server.
 KEYS is a list of key IDs"
@@ -2449,10 +2436,8 @@ KEYS is a list of key IDs"
                   (epg-context-result-for context 'error))))
     (epg-reset context)))
 
-;;;###autoload
 (defalias 'epg-import-keys-from-server 'epg-receive-keys)
 
-;;;###autoload
 (defun epg-start-delete-keys (context keys &optional allow-secret)
   "Initiate a delete keys operation.
 
@@ -2472,7 +2457,6 @@ If you are unsure, use synchronous version of this function
                                (car (epg-key-sub-key-list key))))
                             keys))))
 
-;;;###autoload
 (defun epg-delete-keys (context keys &optional allow-secret)
   "Delete KEYS from the key ring."
   (unwind-protect
@@ -2488,7 +2472,6 @@ If you are unsure, use synchronous version of this function
                (error "Delete keys failed")))))
     (epg-reset context)))
 
-;;;###autoload
 (defun epg-start-sign-keys (context keys &optional local)
   "Initiate a sign keys operation.
 
@@ -2509,7 +2492,6 @@ If you are unsure, use synchronous version of this function
                            keys))))
 (make-obsolete 'epg-start-sign-keys "do not use." "23.1")
 
-;;;###autoload
 (defun epg-sign-keys (context keys &optional local)
   "Sign KEYS from the key ring."
   (unwind-protect
@@ -2522,7 +2504,6 @@ If you are unsure, use synchronous version of this function
     (epg-reset context)))
 (make-obsolete 'epg-sign-keys "do not use." "23.1")
 
-;;;###autoload
 (defun epg-start-generate-key (context parameters)
   "Initiate a key generation.
 PARAMETERS specifies parameters for the key.
@@ -2544,7 +2525,6 @@ If you are unsure, use synchronous version of this function
     (if (eq (process-status (epg-context-process context)) 'run)
        (process-send-eof (epg-context-process context)))))
 
-;;;###autoload
 (defun epg-generate-key-from-file (context parameters)
   "Generate a new key pair.
 PARAMETERS is a file which tells how to create the key."
@@ -2557,7 +2537,6 @@ PARAMETERS is a file which tells how to create the key."
                   (epg-context-result-for context 'error))))
     (epg-reset context)))
 
-;;;###autoload
 (defun epg-generate-key-from-string (context parameters)
   "Generate a new key pair.
 PARAMETERS is a string which tells how to create the key."
@@ -2670,5 +2649,4 @@ Type names are resolved using `epg-dn-type-alist'."
 
 (provide 'epg)
 
-;; arch-tag: de8f0acc-1bcf-4c14-a09e-bfffe1b579b7
 ;;; epg.el ends here