.\" Copyright (C) 2001-2007 Graeme Walker .\" .\" 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 3 of the License, or .\" (at your option) any later version. .\" .\" This program is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . .TH EMAILRELAY 1 local .SH NAME emailrelay \- e-mail transfer agent and proxy .SH SYNOPSIS .B emailrelay [OPTIONS] .LP .B emailrelay --as-server .LP .B emailrelay --as-client .I server-address .LP .B emailrelay --as-proxy .I server-address .SH DESCRIPTION .I emailrelay is a simple SMTP proxy and store-and-forward message transfer agent. It does store-and-forward mail relay to a fixed next-hop server, without any routing. .LP It runs in two main modes: a storage daemon .RI ( --as-server ) and a forwarding agent .RI ( --as-client ). The storage daemon is an SMTP server which stores e-mail messages in a local spool directory. The forwarding agent acts as an SMTP client sending the spooled e-mail messages on to the next SMTP server in the chain. .LP It can also run in a third mode, as a proxy server .RI ( --as-proxy ). In this mode all messages are forwarded immediately to the next-hop server. Messages are only fully accepted from the sender once they have been successfully delivered to the next-hop server. .SH OPTIONS .TP .B \-a, --admin \fI\fR Enables the administration interface and specifies its listening port number. .TP .B \-Q, --admin-terminate Enables the terminate command on the admin interface. .TP .B \-A, --anonymous Disables the smtp vrfy command and sends less verbose smtp responses. .TP .B \-q, --as-client \fI\fR Runs as a client, forwarding spooled mail to : equivalent to \fI--log\fR \fI--no-syslog\fR \fI--no-daemon\fR \fI--dont-serve\fR \fI--forward\fR \fI--forward-to\fR. .TP .B \-y, --as-proxy \fI\fR Runs as a proxy: equivalent to \fI--log\fR \fI--close-stderr\fR \fI--immediate\fR \fI--forward-to\fR. .TP .B \-d, --as-server Runs as a server: equivalent to \fI--log\fR \fI--close-stderr\fR. .TP .B \-C, --client-auth \fI\fR Enables smtp authentication with remote server, using the given secrets file. .TP .B \-Y, --client-filter \fI\fR Specifies an external program to process messages when they are forwarded. .TP .B \-e, --close-stderr Closes the standard error stream after start-up. .TP .B \-U, --connection-timeout \fI