README

   1 * What's this?
   2
   3 EasyPG is yet another GnuPG interface for Emacs.  It consists of three
   4 parts: transparent file encryption utility, Gnus/PGG backend, and
   5 elisp library to interact with GnuPG.
   6
   7 * Requirements
   8
   9 ** GNU Emacs 21.4 or later
  10
  11 ** XEmacs 21.4 or later
  12
  13 ** GnuPG 1.4.3 or later
  14
  15 ** Gnus 5.10.8 or later (optional)
  16
  17 * Quick start
  18
  19 ** Installation
  20
  21 $ ./configure
  22 $ sudo make install
  23
  24 ** Transparent file encryption utility
  25
  26 EasyPG provides transparent file encryption utility similar to
  27 crypt++, alpaca.el, hedgehog.  To try this, add the following line to
  28 your ~/.emacs and C-x C-f ~/test.txt.gpg.
  29
  30 (require 'epg-file)
  31
  32 ** Gnus/PGG backend
  33
  34 EasyPG provides an implementation of the backend interface of
  35 Gnus/PGG.  To use EasyPG instead of pgg-gpg, install pgg-epg.el and
  36 add the following line to your ~/.gnus.
  37
  38 (setq pgg-scheme 'epg)
  39
  40 * Advantages over other competitors
  41
  42 There are many competitors of EasyPG such as Mailcrypt, Gnus/PGG,
  43 gpg.el, etc.  EasyPG has some advantages over them.
  44
  45 ** EasyPG avoides potential security flaws of Emacs
  46
  47 *** `call-process-region' writes data in region to temporary files
  48
  49 `call-process-region' writes data in region to temporary files.
  50 EasyPG do _not_ use `call-process-region' to communicate with a gpg
  51 subprocess.
  52
  53 *** `(fillarray string 0)' is not enough to clear passphrases
  54
  55 If Emacs crashed and dumps core, passphrase strings in memory are also
  56 dumped within the core file.  `read-passwd' function clears passphrase
  57 strings by `(fillarray string 0)'.  However, Emacs performs compaction
  58 in gc_sweep phase.  If GC happens before `fillarray', passphrase
  59 strings may be moved elsewhere in memory.
  60
  61 Fortunately, there is gpg-agent to cache passphrases in more secure
  62 way, so EasyPG dares _not_ to cache passphrase.  Elisp programs can
  63 set `epg-context-passphrase-callback' to cache user's passphrases.
  64
  65 ** GnuPG features are directly accessible from Emacs
  66
  67 Other competitors provide only specific features of GnuPG since they
  68 still support PGP 2.*, 5.*, 6.*.  As the name indicates, EasyPG is
  69 inspired by GPGME (GnuPG Made Easy), and the library interface is
  70 close to GPGME.  With EasyPG you can benefit from a lot of features of
  71 GnuPG.