.\"	$Csoft: mail.fcgi.1,v 1.2 2003/12/20 01:51:57 vedge Exp $
.\"
.\" Copyright (c) 2003 CubeSoft Communications, Inc.
.\" <http://www.csoft.org>
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
.\" (INCLUDING BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd SEPTEMBER 21, 2003
.Dt MAIL.FCGI 1
.Os
.ds vT Csoft-CGI Reference
.ds oS Csoft-CGI 1.0
.Sh NAME
.Nm mail.fcgi
.Nd send e-mail to specific recipients
.Sh DESCRIPTION
The
.Nm
program sends e-mail to one or more pre-defined recipients, whose e-mail
addresses are hidden from the user of the script.
.Nm
also inserts an
.Sq X-MailFCGI-IP
field into the message header and maintains an archive of sent messages.
.Pp
The options are as follows:
.Pp
.Bl -tag -width "message " -compact
.It Ar sender
Sender e-mail address.
.It Ar rcpt
Name of the recipient.
.It Ar subject
Subject of the e-mail to send.
.It Ar message
The message body.
.It Ar x_<key>
Value(s) to insert in the message header.
.It Ar f_<key>
Value(s) to display at the end of the message body.
.It Ar lang
Alternate language (overrides HTTP language negotiation).
.El
.\" .Sh ENVIRONMENT
.Sh FILES
.Bl -tag -width "./mail.fcgi.conf/recipients " -compact
.It Pa ./mail.fcgi.conf/recipients
Recipient database.
.It Pa ./mail.sent
Archive of sent messages.
.El
.Sh SEE ALSO
.Xr cgi 3
.Pp
.Bl -tag -width "RFC 822 " -compact
.It RFC 822
Standard for the Format of ARPA Internet Text Messages
.It ISO 639
Code for the Representation of the Names of Languages
.El