qmail-remote(8)

NAME
qmail-remote - send mail via SMTP

SYNOPSIS
qmail-remote host sender recip [ recip ... ]

DESCRIPTION
qmail-remote reads a mail message from its input and sends the message to one or more recipients at a remote host. The remote host is qmail-remote's first argument, host. qmail-remote sends the message to host, or to a mail exchanger for host listed in the Domain Name System, via the Simple Mail Transfer Protocol (SMTP). host can be either a fully-qualified domain name:
         silverton.berkeley.edu
or an IP address enclosed in brackets:
         [128.32.183.163]
The envelope recipient addresses are listed as recip arguments to qmail-remote. The envelope sender address is listed as sender. Note that qmail-remote does not take options and does not follow the getopt standard.

TRANSPARENCY
End-of-file in SMTP is encoded as dot CR LF. A dot at the beginning of a line is encoded as dot dot. qmail-remote converts the UNIX newline convention into the SMTP newline convention by inserting CR before each LF. It is impossible in SMTP to send a message that does not end with a newline; qmail-remote will add a final CR LF if necessary. It is a violation of the SMTP protocol to send a message that contains long lines or non-ASCII characters. However, qmail-remote will happily send such messages. It is the user's responsibility to avoid generating illegal messages.

RESULTS
qmail-remote prints some number of recipient reports, followed by a message report. Each report is terminated by a 0 byte. Each report begins with a single letter:

r   Recipient report: acceptance.

h   Recipient report: permanent rejection.

s   Recipient report: temporary rejection.

K   Message report: success. host has taken responsibility for delivering the message to each acceptable recipient.

Z   Message report: temporary failure.

D   Message report: permanent failure.

After this letter comes a human-readable description of what happened. The recipient reports will always be printed in the same order as qmail-remote's recip arguments. Note that in failure cases there may be fewer recipient reports than recip arguments. qmail-remote always exits zero.

CONTROL FILES

helohost
    Current host name, for use solely in saying hello to the remote SMTP server. Default: me, if that is supplied; otherwise qmail-remote refuses to run.

localnet
    Name of the local network. If localnet is supplied, any host name ending with localnet (including localnet itself) is exempt from smarthost handling.

smarthost
    Name of a smart host. If you supply smarthost, qmail-remote will deliver all messages to smarthost, as if all remote hosts had smarthost as the only MX. Note that the qmail system does not protect you if you create a smarthost mail loop between machines; however, you are always safe using smarthost if you are not running an SMTP daemon.

timeoutremote
    Number of seconds qmail-remote will wait for each response from the remote SMTP server. Default: 1200.

SEE ALSO
addresses(5), envelopes(5), qmail-control(5), qmail-send(8), qmail-smtpd(8)