pgp4pine - a PGP/GnuPG wrapper for Pine and general use

pgp4pine (-d | -e) -i fileName [-o fileName] [options]

pgp4pine is designed to "wrap" around PGP so that users of Pine 3.95 or newer can send/receive mail with Pine and PGP 2, PGP 5, PGP 6, or GPG. It is also useable as a general PGP/GnuPG wrapper.

0.

Open your ~/.pgp4pinerc (if you don't have one, copy it from /usr/share/doc/pgp4pine/pgp4pinerc.example) and rename it to .pgp4pinerc and edit it.

1.

In pine, go into Setup, then Configuration.

2.

If you want pgp4pine to automatically catch and decrypt/verify PGP-signed/encrypted messages, set display-filters (near the bottom) to

_BEGINNING("-----BEGIN PGP")_ /usr/bin/pgp4pine -d -i _TMPFILE_

(one line & literally. Five '-' and _TMPFILE_.) If you want to run pgp4pine only when you tell it to, don't fill this in, and do this instead: In a message, export it somewhere, then, in a shell/xterm, type "pgp4pine -d -i (filename)"

3.

Set sending-filters to (one line):

/usr/bin/pgp4pine -e -i _TMPFILE_ -r _RECIPIENTS_

4.

If you want Pine to offer pgp4pine for sending mail by default, go to Setup -> Configuration, and turn on 'compose-send-offers-first-filter'. Otherwise, you have to use Ctrl-N / Ctrl-P to access the filter.

[-e | --encrypt]

Specifies to encrypt file, used when sending messages.

[-d | --decrypt]

Specifies to decrypt/view file, used when receiving messages.

[-i | --infile] file

Specifies incoming file.

[-o | --outfile] file

Specifies file to output to. Not required, and by default the incoming file is used.

[-r | --recipients] recipients

Recipient list of addresses to encrypt to. Must be the last option. If not giving this option, you will be prompted to enter them.

[-q | --quiet]

Tells pgp4pine to skip the welcome screen and go straight to the interactive sequence.

[--debug]

Will save a ~/pgp4pine.debug file for use with debugging.

[-t | --tempfile] file

Overrides the tempfile setting of .pgp4pinerc

-k

Tells pgp4pine to keep the temp file, if used.

--noclear

Doesn't clear screen when run. Pine doesn't clear the screen properly when it runs a sub-command for filtering, so I put this in.

-sf / -sf+ / -sf-

Specifies whether or not to sign file. Overrides preferences, and does not ask.

-ef / -ef+ / -ef-

Specifies whether or not to encrypt file. Overrides preferences, and does not ask.

-af / -af+ / -af-

Specifies whether or not to ASCII-armor (RADIX-64) files. Overrides preferences, and does not ask.

-uf / -uf+ / -uf-

Specifies whether or not to canonicalize the text format. Overrides preferences, and does not ask.

-ds / -ds+ / -ds-

Specifies whether or not to make a detached signature. Overrides preferences and does not ask.

pgp4pine -e -i ~/out.msg pgp4pine -d -i ~/in.msg -o ~/in.txt pgp4pine -e -i ~/out.msg -sf+ -ef- -ds- pgp4pine -e -i ~/out.msg -r he@here.com she@there.org

The .pgp4pinerc consists of two parts, the global options and the profile options.

add_comment

=0: Add nothing.
=1: Add a comment that says 
    "Comment: Made with pgp4pine x.xx"

extra_enter_at_end

=1: Wait for two <RETURN> instead of one. Use if 
    somehow pgp4pine returns without asking you. 
=0: Just one enter at end.

external_pager

Set this to a pager (e.g. less ) to view the text with when in piping mode.

cache_keyrings

Cache keyrings to speed things up a bit. If you add keys without pgp4pine's knowledge, it will of course be outdated.

Value: Time to store. Units are min(utes), hour(s), day(s). Example: 1 day

cache_decrypted

This enables caching of decoded messages. They will be stored in ~/.pgp4pine.cache. Note that it will be readable by root!

=0: Don't do that, I want top-security! (default)

>0: Time to store.

pgp4pine will check the cache and delete old messages with every invocation. Since v1.75, the keyrings will be cached there as well (it always takes ages to obtain them from PGP), that behaviour is unaffected by this setting.

keyserver_on_sig

If checking signatures, fetch unknown keys from keyserver. (Without a key, signature check is not possible.)

=-1: no
=0: ask
=1: yes (if you have permanent Internet connection)

profile-list

A colon-separated list of the profiles you want to setup. The names are arbitrary.

Example: 
profile-list=pgp5:gpg

Per-Profile options have the format "profile_<name>_<option>". "<name>" is the name you used in the profile-list

profile_*_version

=1: GPG, 2: PGP 2, 5: PGP 5, 6: PGP 6 This sets the default name of the PGP programs, and the parameters they are called with, and what output is expected.

profile_*_folder

If the PGP commands are not in your standard path, set the path here.

profile_*_extra_options

Additional command-line parameters. Used only for encryption.

profile_*_autosign

profile_*_autoencrypt

Default actions when sending mail:
=-1: never sign / encrypt, =0: ask, =1: always

profile_*_encrypt_to_self

=0: Nothing
=1: Always add yourself to the recipient list. Useful
    to decipher your own sent-mail folder. 

Alternatively configure PGP to do this itself.

profile_*_my_address

Your own name, either hex format or Email address. Used to select your secret key and for the encrypt_to_self option.

profile_*_ascii_armor

Use ascii-armored output instead of binary. 
Always use this for mails.
=-1: Never, =0: Ask, =1: Always

profile_*_universal_text

Convert text to a platform-independent form. 
Recommended.
=-1: Never, =0: Ask, =1: Always

profile_*_pgpk

profile_*_pgpe

profile_*_pgps

profile_*_pgpv

Set the command name for program files if non-standard (PGP5).

profile_*_pgp2bin

The same for PGP2

profile_*_pgp6bin

The same for PGP6

profile_*_gpgbin

The same for GPG.

This program is released under the GNU License v2.

Keys having special characters like 'äöü' and '\' do not work with PGP 5. This is a bug in PGP, a patch is available of the homepage at http://pgp4pine.flatline.de/.

If you find more bugs, email holger@flatline.de

Holger Lamm <holger@flatline.de>