NAME
pgp4pine - a PGP/GnuPG wrapper for Pine and general use
SYNOPSIS
pgp4pine (-d | -e) -i fileName [-o fileName] [options]
DESCRIPTION
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.
HOWTO SETUP PINE
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 MESSAGE")_
/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.
COMMAND-LINE OPTIONS
[-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.
OUTGOING-ONLY OPTIONS
-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.
EXAMPLES
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
PGP4PINERC
The .pgp4pinerc consists of two parts, the global options and the
profile options.
GLOBAL 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
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.
LICENSE
This program is released under the GNU License v2.
BUGS
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
AUTHORS
Holger Lamm <holger@flatline.de>
DEC 2000 (v1.76) pgp4pine(1)