[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
.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-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
78	.IR rcpthosts .
79
80	Exception:
81	If the environment variable
82	.B RELAYCLIENT
83	is set,
84	.B qmail-smtpd
85	will ignore
86	.IR rcpthosts ,
87	and will append the value of
88	.B RELAYCLIENT
89	to each incoming recipient address.
90
91	.I rcpthosts
92	may include wildcards:
93
94	.EX
95	heaven.af.mil
96	.heaven.af.mil
97	.EE
98
99	Envelope recipient addresses without @ signs are
100	always allowed through.
101	.TP 5
102	.I smtpgreeting
103	SMTP greeting message.
104	Default:
105	.IR me ,
106	if that is supplied;
107	otherwise
108	.B qmail-smtpd
109	will refuse to run.
110	The first word of
111	.I smtpgreeting
112	should be the current host's name.
113	.TP 5
114	.I timeoutsmtpd
115	Number of seconds
116	.B qmail-smtpd
117	will wait for each new buffer of data from the remote SMTP client.
118	Default: 1200.
119	.SH "SEE ALSO"
120	tcp-env(1),
121	tcp-environ(5),
122	qmail-control(5),
123	qmail-inject(8),
124	qmail-queue(8),
125	qmail-remote(8)