179 lines
3.5 KiB
Groff
179 lines
3.5 KiB
Groff
.TH qmail-smtpd 8
|
|
.SH NAME
|
|
qmail-smtpd \- receive mail via SMTP
|
|
.SH SYNOPSIS
|
|
.B qmail-smtpd
|
|
.SH DESCRIPTION
|
|
.B qmail-smtpd
|
|
receives mail messages via the Simple Mail Transfer Protocol (SMTP)
|
|
and invokes
|
|
.B qmail-queue
|
|
to deposit them into the outgoing queue.
|
|
.B qmail-smtpd
|
|
must be supplied several environment variables;
|
|
see
|
|
.BR tcp-environ(5) .
|
|
|
|
.B qmail-smtpd
|
|
is responsible for counting hops.
|
|
It rejects any message with 100 or more
|
|
.B Received
|
|
or
|
|
.B Delivered-To
|
|
header fields.
|
|
|
|
.B qmail-smtpd
|
|
supports ESMTP, including the 8BITMIME and PIPELINING options.
|
|
.SH TRANSPARENCY
|
|
.B qmail-smtpd
|
|
converts the SMTP newline convention into the UNIX newline convention
|
|
by converting CR LF into LF.
|
|
It returns a temporary error and drops the connection on bare LFs;
|
|
see
|
|
.BR http://pobox.com/~djb/docs/smtplf.html .
|
|
|
|
.B qmail-smtpd
|
|
accepts messages that contain long lines or non-ASCII characters,
|
|
even though such messages violate the SMTP protocol.
|
|
.SH "CONTROL FILES"
|
|
.TP 5
|
|
.I badmailfrom
|
|
Unacceptable envelope sender addresses.
|
|
.B qmail-smtpd
|
|
will reject every recipient address for a message
|
|
if the envelope sender address is listed in
|
|
.IR badmailfrom .
|
|
A line in
|
|
.I badmailfrom
|
|
may be of the form
|
|
.BR @\fIhost ,
|
|
meaning every address at
|
|
.IR host .
|
|
.TP 5
|
|
.I databytes
|
|
Maximum number of bytes allowed in a message,
|
|
or 0 for no limit.
|
|
Default: 0.
|
|
If a message exceeds this limit,
|
|
.B qmail-smtpd
|
|
returns a permanent error code to the client;
|
|
in contrast, if
|
|
the disk is full or
|
|
.B qmail-smtpd
|
|
hits a resource limit,
|
|
.B qmail-smtpd
|
|
returns a temporary error code.
|
|
|
|
.I databytes
|
|
counts bytes as stored on disk, not as transmitted through the network.
|
|
It does not count the
|
|
.B qmail-smtpd
|
|
Received line, the
|
|
.B qmail-queue
|
|
Received line, or the envelope.
|
|
|
|
If the environment variable
|
|
.B DATABYTES
|
|
is set, it overrides
|
|
.IR databytes .
|
|
.TP 5
|
|
.I localiphost
|
|
Replacement host name for local IP addresses.
|
|
Default:
|
|
.IR me ,
|
|
if that is supplied.
|
|
.B qmail-smtpd
|
|
is responsible for recognizing dotted-decimal addresses for the
|
|
current host.
|
|
When it sees a recipient address of the form
|
|
.IR box@[d.d.d.d] ,
|
|
where
|
|
.I d.d.d.d
|
|
is a local IP address,
|
|
it replaces
|
|
.IR [d.d.d.d]
|
|
with
|
|
.IR localiphost .
|
|
This is done before
|
|
.IR rcpthosts .
|
|
.TP 5
|
|
.I morercpthosts
|
|
Extra allowed RCPT domains.
|
|
If
|
|
.I rcpthosts
|
|
and
|
|
.I morercpthosts
|
|
both exist,
|
|
.I morercpthosts
|
|
is effectively appended to
|
|
.IR rcpthosts .
|
|
|
|
You must run
|
|
.B qmail-newmrh
|
|
whenever
|
|
.I morercpthosts
|
|
changes.
|
|
|
|
Rule of thumb for large sites:
|
|
Put your 50 most commonly used domains into
|
|
.IR rcpthosts ,
|
|
and the rest into
|
|
.IR morercpthosts .
|
|
.TP 5
|
|
.I rcpthosts
|
|
Allowed RCPT domains.
|
|
If
|
|
.I rcpthosts
|
|
is supplied,
|
|
.B qmail-smtpd
|
|
will reject
|
|
any envelope recipient address with a domain not listed in
|
|
.IR rcpthosts .
|
|
|
|
Exception:
|
|
If the environment variable
|
|
.B RELAYCLIENT
|
|
is set,
|
|
.B qmail-smtpd
|
|
will ignore
|
|
.IR rcpthosts ,
|
|
and will append the value of
|
|
.B RELAYCLIENT
|
|
to each incoming recipient address.
|
|
|
|
.I rcpthosts
|
|
may include wildcards:
|
|
|
|
.EX
|
|
heaven.af.mil
|
|
.heaven.af.mil
|
|
.EE
|
|
|
|
Envelope recipient addresses without @ signs are
|
|
always allowed through.
|
|
.TP 5
|
|
.I smtpgreeting
|
|
SMTP greeting message.
|
|
Default:
|
|
.IR me ,
|
|
if that is supplied;
|
|
otherwise
|
|
.B qmail-smtpd
|
|
will refuse to run.
|
|
The first word of
|
|
.I smtpgreeting
|
|
should be the current host's name.
|
|
.TP 5
|
|
.I timeoutsmtpd
|
|
Number of seconds
|
|
.B qmail-smtpd
|
|
will wait for each new buffer of data from the remote SMTP client.
|
|
Default: 1200.
|
|
.SH "SEE ALSO"
|
|
tcp-env(1),
|
|
tcp-environ(5),
|
|
qmail-control(5),
|
|
qmail-inject(8),
|
|
qmail-newmrh(8),
|
|
qmail-queue(8),
|
|
qmail-remote(8)
|