nightmaremail

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs

qmail-remote.8 (3993B)

      1 .TH qmail-remote 8
      2 .SH NAME
      3 qmail-remote \- send mail via SMTP
      4 .SH SYNOPSIS
      5 .B qmail-remote
      6 .I host
      7 .I sender
      8 .I recip
      9 [
     10 .I recip ...
     11 ]
     12 .SH DESCRIPTION
     13 .B qmail-remote
     14 reads a mail message from its input
     15 and sends the message
     16 to one or more recipients
     17 at a remote host.
     18 
     19 The remote host is
     20 .BR qmail-remote 's
     21 first argument,
     22 .IR host .
     23 .B qmail-remote
     24 sends the message to
     25 .IR host ,
     26 or to a mail exchanger for
     27 .I host
     28 listed in the Domain Name System,
     29 via the Simple Mail Transfer Protocol (SMTP).
     30 .I host
     31 can be either a fully-qualified domain name:
     32 
     33 .EX
     34      silverton.berkeley.edu
     35 .EE
     36 
     37 or an IP address enclosed in brackets:
     38 
     39 .EX
     40      [128.32.183.163]
     41 .EE
     42 
     43 The envelope recipient addresses are listed as
     44 .I recip
     45 arguments to
     46 .BR qmail-remote .
     47 The envelope sender address is listed as
     48 .I sender\fP.
     49 
     50 Note that
     51 .B qmail-remote
     52 does not take options
     53 and does not follow the
     54 .B getopt
     55 standard.
     56 
     57 .B qmail-rspawn
     58 will invoke the contents of
     59 .B $QMAILREMOTE
     60 instead of
     61 .BR qmail-remote,
     62 if that environment variable is set.
     63 .SH TRANSPARENCY
     64 End-of-file in SMTP is encoded as dot CR LF.
     65 A dot at the beginning of a line is encoded as dot dot.
     66 It is impossible in SMTP to send a message that does not end with a newline.
     67 .B qmail-remote
     68 converts the UNIX newline convention into the SMTP newline convention
     69 by inserting CR before each LF.
     70 
     71 It is a violation of the SMTP protocol
     72 to send a message that contains long lines or non-ASCII characters.
     73 However,
     74 .B qmail-remote
     75 will happily send such messages.
     76 It is the user's responsibility to avoid generating illegal messages.
     77 .SH "RESULTS"
     78 .B qmail-remote
     79 prints some number of 
     80 .I recipient reports\fP,
     81 followed by a
     82 .I message report\fR.
     83 Each report is terminated by a 0 byte.
     84 Each report begins with a single letter:
     85 .TP 5
     86 r
     87 Recipient report: acceptance.
     88 .TP 5
     89 h
     90 Recipient report: permanent rejection.
     91 .TP 5
     92 s
     93 Recipient report: temporary rejection.
     94 .TP 5
     95 K
     96 Message report: success.
     97 .I host
     98 has taken responsibility for delivering the message to each
     99 acceptable recipient.
    100 .TP 5
    101 Z
    102 Message report: temporary failure.
    103 .TP 5
    104 D
    105 Message report: permanent failure.
    106 .PP
    107 After this letter comes a human-readable description of
    108 what happened.
    109 
    110 The recipient reports will always be printed in the same order as
    111 .BR qmail-remote 's
    112 .I recip
    113 arguments.
    114 Note that in failure cases there may be fewer
    115 recipient reports
    116 than
    117 .I recip
    118 arguments.
    119 
    120 .B qmail-remote
    121 always exits zero.
    122 .SH "CONTROL FILES"
    123 .TP 5
    124 .I helohost
    125 Current host name,
    126 for use solely in saying hello to the remote SMTP server.
    127 Default:
    128 .IR me ,
    129 if that is supplied;
    130 otherwise
    131 .B qmail-remote
    132 refuses to run.
    133 .TP 5
    134 .I smtproutes
    135 Artificial SMTP routes.
    136 Each route has the form
    137 .IR domain\fB:\fIrelay ,
    138 without any extra spaces.
    139 If
    140 .I domain
    141 matches
    142 .IR host ,
    143 .B qmail-remote
    144 will connect to
    145 .IR relay ,
    146 as if
    147 .I host
    148 had
    149 .I relay
    150 as its only MX.
    151 (It will also avoid doing any CNAME lookups on
    152 .IR recip .)
    153 .I host
    154 may include a colon and a port number to use instead of the
    155 normal SMTP port, 25:
    156 
    157 .EX
    158    inside.af.mil:firewall.af.mil:26
    159 .EE
    160 
    161 .I relay
    162 may be empty;
    163 this tells
    164 .B qmail-remote
    165 to look up MX records as usual.
    166 .I smtproutes
    167 may include wildcards:
    168 
    169 .EX
    170    .af.mil:
    171    :heaven.af.mil
    172 .EE
    173 
    174 Here
    175 any address ending with
    176 .B .af.mil
    177 (but not
    178 .B af.mil
    179 itself)
    180 is routed by its MX records;
    181 any other address is artificially routed to
    182 .BR heaven.af.mil .
    183 
    184 The
    185 .B qmail
    186 system does not protect you if you create an artificial
    187 mail loop between machines.
    188 However,
    189 you are always safe using
    190 .I smtproutes
    191 if you do not accept mail from the network.
    192 .TP 5
    193 .I timeoutconnect
    194 Number of seconds
    195 .B qmail-remote
    196 will wait for the remote SMTP server to accept a connection.
    197 Default: 60.
    198 The kernel normally imposes a 75-second upper limit.
    199 .TP 5
    200 .I timeoutremote
    201 Number of seconds
    202 .B qmail-remote
    203 will wait for each response from the remote SMTP server.
    204 Default: 1200.
    205 .SH "SEE ALSO"
    206 addresses(5),
    207 envelopes(5),
    208 qmail-control(5),
    209 qmail-send(8),
    210 qmail-smtpd(8),
    211 qmail-tcpok(8),
    212 qmail-tcpto(8)