"Fossies" - the Fresh Open Source Software Archive

Member "tin-2.6.2/doc/pgp.txt" (23 Aug 2021, 3964 Bytes) of package /linux/misc/tin-2.6.2.tar.xz:

    1 This file is correct as of tin-1.5.8
    2 
    3 Ensuring support is compiled in
    4 -------------------------------
    5 Tin will compile in support for PGP or GPG if it can find it.
    6 
    7 It looks for 'pgp' on the path
    8 If this is found, then PGP2 support is assumed
    9 It looks for 'pgpk' on the path
   10 If this is found, then PGP5 support is assumed
   11 It looks for 'gpg' on the path
   12 If this is found, then GPG support is assumed
   13 If neither is found, then no pgp and gpg support is compiled in
   14 
   15 If you have more than one of these programs installed, you have to decide
   16 which of these should be used by tin. By default, PGP2 is preferred over PGP5
   17 and PGP5 over GPG. If you want to use PGP2 or PGP5 and GPG is installed, make
   18 sure that you invoke configure with --without-gpg (otherwise appending public
   19 keys will fail). If you want to use GPG, invoke configure with --without-pgp
   20 and --without-pgpk. To use PGP5, invoke configure with --without-pgp and
   21 --without-gpg.
   22 
   23 If configure is called with --disable-pgp-gpg, then no pgp and gpg support is
   24 compiled in.
   25 
   26 When you try to use PGP
   27 -----------------------
   28 PGP2 support expects pubring.pgp
   29 PGP5 support expects pubring.pkr
   30 GPG support expects pubring.gpg
   31 
   32 It wants to find the above in:
   33 $HOME/.pgp/pubring.* if using PGP2 or PGP5
   34 $HOME/.gnupg/pubring.gpg if using GPG
   35 
   36 Or you can override this with $PGPPATH/pubring.*
   37 
   38 If an environment var PGPOPTS is defined, then tin will use it.
   39 
   40 Internal usage of PGP
   41 ---------------------
   42 There are 3 places where pgp is invoked:
   43 
   44 1) Checking articles (^G in the pager)
   45 
   46    If the article is pgp signed (-----BEGIN PGP SIGNED MESSAGE-----)
   47 
   48    PGP2:  pgp -f $PGPOPTS <article >/dev/null
   49    PGP5:  pgpv -f $PGPOPTS <article >/dev/null
   50    GPG:   gpg $PGPOPTS <article >/dev/null
   51 
   52    If the article has (-----BEGIN PGP PUBLIC KEY BLOCK-----)
   53 
   54    pgp $PGPOPTS -ka article
   55    pgpk $PGPOPTS -a article
   56    gpg $PGPOPTS --nobatch --import article
   57 
   58 2) When posting news or mail
   59 
   60    For signing when tinrc.mail_address or attributes.from is not defined:
   61 
   62    PGP2:  pgp $PGPOPTS -ats plaintextfile to_address
   63    PGP5:  pgps $PGPOPTS -at plaintextfile to_address
   64    GPG:   gpg $PGPOPTS --textmode --armor --no-batch --output
   65               plaintextfile.asc --escape-from --clearsign plaintextfile
   66 
   67    For signing and encrypting when tinrc.mail_address or attributes.from is
   68    not defined:
   69 
   70    PGP2:  pgp $PGPOPTS -ates plaintextfile to_address
   71    PGP5:  pgpe $PGPOPTS -ats plaintextfile to_address
   72    GPG:   gpg $PGPOPTS --textmode --armor --no-batch --output
   73               plaintextfile.asc --recipient to_address --sign --encrypt
   74               plaintextfile
   75 
   76    For signing when tinrc.mail_address or attributes.from is defined:
   77 
   78    PGP2:  pgp $PGPOPTS -ats plaintextfile to_address -u from_address
   79    PGP5:  pgps $PGPOPTS -at plaintextfile to_address -u from_address
   80    GPG:   gpg $PGPOPTS --textmode --armor --no-batch --local-user
   81               from_address --output plaintextfile.asc --escape-from
   82               --clearsign plaintextfile
   83 
   84    For signing and encrypting when tinrc.mail_address or attributes.from is
   85    defined:
   86 
   87    PGP2:  pgp $PGPOPTS -ates plaintextfile to_address -u from_address
   88    PGP5:  pgpe $PGPOPTS -ats plaintextfile to_address -u from_address
   89    GPG:   gpg $PGPOPTS --textmode --armor --no-batch --output
   90               plaintextfile.asc --recipient to_address --local-user
   91               from_address --sign --encrypt plaintextfile
   92 
   93    For encrypting:
   94 
   95    PGP2:  pgp $PGPOPTS -ate plaintextfile to_address
   96    PGP5:  pgpe $PGPOPTS -at plaintextfile to_address
   97    GPG:   gpg $PGPOPTS --textmode --armor --no-batch --output
   98               plaintextfile.asc --recipient to_address --encrypt
   99               plaintextfile
  100 
  101 3) Appending public key
  102 
  103    PGP2: pgp $PGPOPTS -kxa from_address keyfile
  104    PGP5: pgpk $PGPOPTS -xa from_address -o keyfile
  105    GPG:  gpg $PGPOPTS --nobatch --armor --output keyfile --export
  106              from_address
  107 
  108    Where from_address is the posting/mailing address