.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "GPGMAILTUNL 1"
.TH GPGMAILTUNL 1 "2011-11-22" "perl v5.16.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
gpgmailtunl \- Encrypts an email message into the body of another email.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
gpgmailtunl [options] \-\-encrypt | \-\-decrypt
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBgpgmailtunl\fR 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.
.PP
It can be used to exchange emails across an open network betweeen two
trusted systems.
.SH "TYPICAL USAGE"
.IX Header "TYPICAL USAGE"
This program is intended to run from program like \fBprocmail\fR or
\&\fBsendmail\fR to create an email tunnel between two systems.  Of course
this is not as secure as using \fBgpg\fR as an end user program, it may
be convenient in certain case.
.SH "ENCRYPTION"
.IX Header "ENCRYPTION"
To encapsulates an email within another you pipe the message to 
\&\fBgpgmailtunl\fR.
.SS "\s-1OPTIONS\s0"
.IX Subsection "OPTIONS"
GetOptions( \e%opt, \*(L"encrypt\*(R", \*(L"decrypt\*(R", \*(L"sign\*(R", \*(L"secret\-file=s\*(R",
	    \*(L"from=s\*(R", \*(L"to=s\*(R", \*(L"subject=s\*(R", \*(L"homedir=s\*(R", \*(L"local\-user=s\*(R",
	    \*(L"recipient=s\*(R",
	  )
  or usage;
.IP "to" 4
.IX Item "to"
This is the address to which the encrypted message will be sent. This
is the only required fields.
.IP "recipient" 4
.IX Item "recipient"
This sets the keyid that will be used to encrypt the outgoing message.
If unset, \fBgpgmailtunl\fR will try to find a key matching the \fBto\fR 
option.
.IP "subject" 4
.IX Item "subject"
Sets the subject of the outgoing message. This defaults to 
\&\*(L"Encrypted mail\*(R".
.IP "from" 4
.IX Item "from"
Sets the From header line of the outgoing message which will contains
the encrypted one. \fBsendmail\fR will provides a default one if this is
not set.
.IP "sign" 4
.IX Item "sign"
If this option is used, the outgoing message will be signed. In this
case you should probably use to \fBlocal-user\fR and \fBsecret-file\fR
options.
.IP "secret-file" 4
.IX Item "secret-file"
File from which the secret to unlock the private used to sign the
message can be read.
.IP "local-user" 4
.IX Item "local-user"
The keyid of the user that should sign the outgoing message. The 
default user will be used if not specified.
.IP "homedir" 4
.IX Item "homedir"
Sets an alternate \fBgpg\fR home directory. (This is where the
keyrings are stored.)
.SH "DECRYPTION"
.IX Header "DECRYPTION"
To extract an email to be forwarded to the final user you pipe
the encrypted email to \fBgpgmailtunl\fR using the \fBdecrypt\fR switch.
.PP
Once decrypted, the encapsulated email message will be sent to the
original destinator of the message.
.SS "\s-1OPTIONS\s0"
.IX Subsection "OPTIONS"
.IP "homedir" 4
.IX Item "homedir"
Sets an alternate \fBgpg\fR home directory. (This is where the
keyrings are stored.)
.IP "secret-file" 4
.IX Item "secret-file"
File from which the secret to unlock the private used to decrypt the
message can be read.
.SH "AUTHOR"
.IX Header "AUTHOR"
Francis J. Lacoste <francis.lacoste@iNsu.COM>
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (c) 1999, 2000 iNsu Innovations Inc.
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the \s-1GNU\s0 General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIgpg\fR\|(1) \fIgpgmailtunl\fR\|(1) \fIGnuPG\fR\|(3)