NAME
gpgmailtunl - Encrypts an email message into the body
of another email.
SYNOPSIS
gpgmailtunl [options]
--encrypt | --decrypt
DESCRIPTION
gpgmailtunl is a
filter program that either encrypts an email message using the Gnu
Privacy Guard and sends it to another recipient or decrypt an email
message and forwards unencrypted to another destination.
It can be used to exchange emails across an open network
betweeen two trusted systems.
TYPICAL USAGE
This program is intended
to run from program like procmail or sendmail to
create an email tunnel between two systems. Of course this is not
as secure as using gpg as an end user program, it may be
convenient in certain case.
ENCRYPTION
To encapsulates an email
within another you pipe the message to gpgmailtunl.
OPTIONS
GetOptions( \%opt, ``encrypt'', ``decrypt'', ``sign'',
``secret-file=s'',
``from=s'', ``to=s'', ``subject=s'', ``homedir=s'',
``local-user=s'',
``recipient=s'',
)
or usage;
- to
- This is the address to which the encrypted
message will be sent. This is the only required fields.
- recipient
- This sets the keyid that will be used to
encrypt the outgoing message. If unset, gpgmailtunl will try
to find a key matching the to option.
- subject
- Sets the subject of the outgoing message.
This defaults to ``Encrypted mail''.
- from
- Sets the From header line of the outgoing
message which will contains the encrypted one. sendmail will
provides a default one if this is not set.
- sign
- If this option is used, the outgoing
message will be signed. In this case you should probably use to
local-user and secret-file options.
- secret-file
- File from which the secret to unlock the
private used to sign the message can be read.
- local-user
- The keyid of the user that should sign the
outgoing message. The default user will be used if not specified.
- homedir
- Sets an alternate gpg home
directory. (This is where the keyrings are stored.)
DECRYPTION
To extract an email to be
forwarded to the final user you pipe the encrypted email to
gpgmailtunl using the decrypt switch.
Once decrypted, the encapsulated email message will be sent to
the original destinator of the message.
OPTIONS
- homedir
- Sets an alternate gpg home
directory. (This is where the keyrings are stored.)
- secret-file
- File from which the secret to unlock the
private used to decrypt the message can be read.
AUTHOR
Francis J. Lacoste <francis.lacoste@iNsu.COM>
COPYRIGHT
Copyright (c) 1999, 2000
iNsu Innovations Inc.
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General
Public License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
SEE ALSO
gpg(1)
gpgmailtunl(1)
(3)