[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.
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)
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.
212b6f5d MW	31	It returns a temporary error and drops the connection on bare LFs;
	32	see
	33	.BR http://pobox.com/~djb/docs/smtplf.html .
2117e02e MW	34
	35	.B qmail-smtpd
	36	accepts messages that contain long lines or non-ASCII characters,
	37	even though such messages violate the SMTP protocol.
	38	.SH "CONTROL FILES"
	39	.TP 5
	40	.I badmailfrom
	41	Unacceptable envelope sender addresses.
	42	.B qmail-smtpd
	43	will reject every recipient address for a message
	44	if the envelope sender address is listed in
	45	.IR badmailfrom .
	46	A line in
	47	.I badmailfrom
	48	may be of the form
	49	.BR @\fIhost ,
	50	meaning every address at
	51	.IR host .
	52	.TP 5
212b6f5d MW	53	.I databytes
	54	Maximum number of bytes allowed in a message,
	55	or 0 for no limit.
	56	Default: 0.
	57	If a message exceeds this limit,
	58	.B qmail-smtpd
	59	returns a permanent error code to the client;
	60	in contrast, if
	61	the disk is full or
	62	.B qmail-smtpd
	63	hits a resource limit,
	64	.B qmail-smtpd
	65	returns a temporary error code.
	66
	67	.I databytes
	68	counts bytes as stored on disk, not as transmitted through the network.
	69	It does not count the
	70	.B qmail-smtpd
	71	Received line, the
	72	.B qmail-queue
	73	Received line, or the envelope.
	74
	75	If the environment variable
	76	.B DATABYTES
	77	is set, it overrides
	78	.IR databytes .
	79	.TP 5
2117e02e MW	80	.I localiphost
	81	Replacement host name for local IP addresses.
	82	Default:
	83	.IR me ,
	84	if that is supplied.
	85	.B qmail-smtpd
	86	is responsible for recognizing dotted-decimal addresses for the
	87	current host.
	88	When it sees a recipient address of the form
	89	.IR box@[d.d.d.d] ,
	90	where
	91	.I d.d.d.d
	92	is a local IP address,
	93	it replaces
	94	.IR [d.d.d.d]
	95	with
	96	.IR localiphost .
	97	This is done before
	98	.IR rcpthosts .
	99	.TP 5
212b6f5d MW	100	.I morercpthosts
	101	Extra allowed RCPT domains.
	102	If
	103	.I rcpthosts
	104	and
	105	.I morercpthosts
	106	both exist,
	107	.I morercpthosts
	108	is effectively appended to
	109	.IR rcpthosts .
	110
	111	You must run
	112	.B qmail-newmrh
	113	whenever
	114	.I morercpthosts
	115	changes.
	116
	117	Rule of thumb for large sites:
	118	Put your 50 most commonly used domains into
	119	.IR rcpthosts ,
	120	and the rest into
	121	.IR morercpthosts .
	122	.TP 5
2117e02e MW	123	.I rcpthosts
	124	Allowed RCPT domains.
	125	If
	126	.I rcpthosts
	127	is supplied,
	128	.B qmail-smtpd
	129	will reject
	130	any envelope recipient address with a domain not listed in
	131	.IR rcpthosts .
	132
	133	Exception:
	134	If the environment variable
	135	.B RELAYCLIENT
	136	is set,
	137	.B qmail-smtpd
	138	will ignore
	139	.IR rcpthosts ,
	140	and will append the value of
	141	.B RELAYCLIENT
	142	to each incoming recipient address.
	143
	144	.I rcpthosts
	145	may include wildcards:
	146
	147	.EX
	148	heaven.af.mil
	149	.heaven.af.mil
	150	.EE
	151
	152	Envelope recipient addresses without @ signs are
	153	always allowed through.
	154	.TP 5
	155	.I smtpgreeting
	156	SMTP greeting message.
	157	Default:
	158	.IR me ,
	159	if that is supplied;
	160	otherwise
	161	.B qmail-smtpd
	162	will refuse to run.
	163	The first word of
	164	.I smtpgreeting
	165	should be the current host's name.
	166	.TP 5
	167	.I timeoutsmtpd
	168	Number of seconds
	169	.B qmail-smtpd
	170	will wait for each new buffer of data from the remote SMTP client.
	171	Default: 1200.
	172	.SH "SEE ALSO"
	173	tcp-env(1),
	174	tcp-environ(5),
	175	qmail-control(5),
	176	qmail-inject(8),
212b6f5d	177	qmail-newmrh(8),
2117e02e MW	178	qmail-queue(8),
2117e02e MW	179	qmail-remote(8)