[qmail] / qmail-smtpd.8

.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.

.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 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 rcpthosts
Allowed RCPT domains.
If
.I rcpthosts
is supplied,
.B qmail-smtpd
will reject
any envelope recipient address with a domain not listed in
.I rcpthosts
unless the sending host is a designated relay client (see the
description of the
.I relayhosts
file beow).

.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 relayhosts
Allowed relay clients.  Each line is a host-suffix pair, separated by a
colon.  If the client's hostname matches one of the hostnames in the
file, that client is permitted to send mail to any host (i.e., to use us
as a relay), and the corresponding suffix is appended to all recipient
addresses generated by the client.

.I relayhosts
may include wildcards:

.EX
   heaven.af.mil:
   .heaven.af.mil:
   hell.irs.gov:.irs.virtdomain
.EE

For historical reasons, the
.B RELAYCLIENT
environment variable overrides this table.  If
.B RELAYCLIENT
is set, it has the same effect as there being a matching entry in the
.I relayhosts
file, using the value of
.B RELAYCLIENT
as the suffix.
.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-queue(8),
qmail-remote(8)
Commit	Line	Data
2117e02e MW	1	.TH qmail-smtpd 8
	2	.SH NAME
	3	qmail-smtpd \- receive mail via SMTP
	4	.SH SYNOPSIS
	5	.B qmail-smtpd
	6	.SH DESCRIPTION
	7	.B qmail-smtpd
	8	receives mail messages via the Simple Mail Transfer Protocol (SMTP)
	9	and invokes
	10	.B qmail-queue
	11	to deposit them into the outgoing queue.
	12	.B qmail-smtpd
	13	must be supplied several environment variables;
	14	see
	15	.BR tcp-environ(5) .
	16
	17	.B qmail-smtpd
	18	is responsible for counting hops.
	19	It rejects any message with 100 or more
	20	.B Received
	21	or
	22	.B Delivered-To
	23	header fields.
	24
	25	.B qmail-smtpd
	26	supports ESMTP, including the 8BITMIME and PIPELINING options.
	27	.SH TRANSPARENCY
	28	.B qmail-smtpd
	29	converts the SMTP newline convention into the UNIX newline convention
	30	by converting CR LF into LF.
	31
	32	.B qmail-smtpd
	33	accepts messages that contain long lines or non-ASCII characters,
	34	even though such messages violate the SMTP protocol.
	35	.SH "CONTROL FILES"
	36	.TP 5
	37	.I badmailfrom
	38	Unacceptable envelope sender addresses.
	39	.B qmail-smtpd
	40	will reject every recipient address for a message
	41	if the envelope sender address is listed in
	42	.IR badmailfrom .
	43	A line in
	44	.I badmailfrom
	45	may be of the form
	46	.BR @\fIhost ,
	47	meaning every address at
	48	.IR host .
	49	.TP 5
	50	.I localiphost
	51	Replacement host name for local IP addresses.
	52	Default:
	53	.IR me ,
	54	if that is supplied.
	55	.B qmail-smtpd
	56	is responsible for recognizing dotted-decimal addresses for the
	57	current host.
	58	When it sees a recipient address of the form
	59	.IR box@[d.d.d.d] ,
	60	where
	61	.I d.d.d.d
	62	is a local IP address,
	63	it replaces
	64	.IR [d.d.d.d]
65	with
66	.IR localiphost .
67	This is done before
68	.IR rcpthosts .
69	.TP 5
70	.I rcpthosts
71	Allowed RCPT domains.
72	If
73	.I rcpthosts
74	is supplied,
75	.B qmail-smtpd
76	will reject
77	any envelope recipient address with a domain not listed in
10649f16 MW	78	.I rcpthosts
	79	unless the sending host is a designated relay client (see the
	80	description of the
	81	.I relayhosts
	82	file beow).
2117e02e MW	83
	84	.I rcpthosts
	85	may include wildcards:
	86
	87	.EX
	88	heaven.af.mil
	89	.heaven.af.mil
	90	.EE
	91
	92	Envelope recipient addresses without @ signs are
	93	always allowed through.
	94	.TP 5
10649f16 MW	95	.I relayhosts
	96	Allowed relay clients. Each line is a host-suffix pair, separated by a
	97	colon. If the client's hostname matches one of the hostnames in the
	98	file, that client is permitted to send mail to any host (i.e., to use us
	99	as a relay), and the corresponding suffix is appended to all recipient
	100	addresses generated by the client.
	101
	102	.I relayhosts
	103	may include wildcards:
	104
	105	.EX
	106	heaven.af.mil:
	107	.heaven.af.mil:
	108	hell.irs.gov:.irs.virtdomain
	109	.EE
	110
	111	For historical reasons, the
	112	.B RELAYCLIENT
	113	environment variable overrides this table. If
	114	.B RELAYCLIENT
	115	is set, it has the same effect as there being a matching entry in the
	116	.I relayhosts
	117	file, using the value of
	118	.B RELAYCLIENT
	119	as the suffix.
	120	.TP 5
2117e02e MW	121	.I smtpgreeting
	122	SMTP greeting message.
	123	Default:
	124	.IR me ,
	125	if that is supplied;
	126	otherwise
	127	.B qmail-smtpd
	128	will refuse to run.
	129	The first word of
	130	.I smtpgreeting
	131	should be the current host's name.
	132	.TP 5
	133	.I timeoutsmtpd
	134	Number of seconds
	135	.B qmail-smtpd
	136	will wait for each new buffer of data from the remote SMTP client.
	137	Default: 1200.
	138	.SH "SEE ALSO"
	139	tcp-env(1),
	140	tcp-environ(5),
	141	qmail-control(5),
	142	qmail-inject(8),
	143	qmail-queue(8),
	144	qmail-remote(8)