mdw@git.distorted.org.uk Git - qmail/blob - qmail-smtpd.8

   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 It returns a temporary error and drops the connection on bare LFs;
  32 see
  33 .BR http://pobox.com/~djb/docs/smtplf.html .
  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
  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
  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
 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
 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),
 177 qmail-newmrh(8),
 178 qmail-queue(8),
 179 qmail-remote(8)