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