.TH qmail-remote 8.SH NAMEqmail-remote \- send mail via SMTP.SH SYNOPSIS.B qmail-remote.I host.I sender.I recip[.I recip ...].SH DESCRIPTION.B qmail-remotereads a mail message from its inputand sends the messageto one or more recipientsat a remote host.The remote host is.BR qmail-remote 'sfirst argument,.IR host ..B qmail-remotesends the message to.IR host ,or to a mail exchanger for.I hostlisted in the Domain Name System,via the Simple Mail Transfer Protocol (SMTP)..I hostcan be either a fully-qualified domain name:.EX     silverton.berkeley.edu.EEor an IP address enclosed in brackets:.EX     [128.32.183.163].EEThe envelope recipient addresses are listed as.I reciparguments to.BR qmail-remote .The envelope sender address is listed as.I sender\fP.Note that.B qmail-remotedoes not take optionsand does not follow the.B getoptstandard..SH TRANSPARENCYEnd-of-file in SMTP is encoded as dot CR LF.A dot at the beginning of a line is encoded as dot dot.It is impossible in SMTP to send a message that does not end with a newline..B qmail-remoteconverts the UNIX newline convention into the SMTP newline conventionby inserting CR before each LF.It is a violation of the SMTP protocolto send a message that contains long lines or non-ASCII characters.However,.B qmail-remotewill happily send such messages.It is the user's responsibility to avoid generating illegal messages..SH "RESULTS".B qmail-remoteprints some number of .I recipient reports\fP,followed by a.I message report\fR.Each report is terminated by a 0 byte.Each report begins with a single letter:.TP 5rRecipient report: acceptance..TP 5hRecipient report: permanent rejection..TP 5sRecipient report: temporary rejection..TP 5KMessage report: success..I hosthas taken responsibility for delivering the message to eachacceptable recipient..TP 5ZMessage report: temporary failure..TP 5DMessage report: permanent failure..PPAfter this letter comes a human-readable description ofwhat happened.The recipient reports will always be printed in the same order as.BR qmail-remote 's.I reciparguments.Note that in failure cases there may be fewerrecipient reportsthan.I reciparguments..B qmail-remotealways exits zero..SH "CONTROL FILES".TP 5.I helohostCurrent host name,for use solely in saying hello to the remote SMTP server.Default:.IR me ,if that is supplied;otherwise.B qmail-remoterefuses to run..TP 5.I smtproutesArtificial SMTP routes.Each route has the form.IR domain\fB:\fIrelay ,without any extra spaces.If.I domainmatches.IR host ,.B qmail-remotewill connect to.IR relay ,as if.I hosthad.I relayas its only MX.(It will also avoid doing any CNAME lookups on.IR recip .).I hostmay include a colon and a port number to use instead of thenormal SMTP port, 25:.EX   inside.af.mil:firewall.af.mil:26.EE.I relaymay be empty;this tells.B qmail-remoteto look up MX records as usual..I smtproutesmay include wildcards:.EX   .af.mil:   :heaven.af.mil.EEHereany address ending with.B .af.mil(but not.B af.militself)is routed by its MX records;any other address is artificially routed to.BR heaven.af.mil .The.B qmailsystem does not protect you if you create an artificialmail loop between machines.However,you are always safe using.I smtproutesif you do not accept mail from the network..TP 5.I timeoutconnectNumber of seconds.B qmail-remotewill wait for the remote SMTP server to accept a connection.Default: 60.The kernel normally imposes a 75-second upper limit..TP 5.I timeoutremoteNumber of seconds.B qmail-remotewill wait for each response from the remote SMTP server.Default: 1200..SH "SEE ALSO"addresses(5),envelopes(5),qmail-control(5),qmail-send(8),qmail-smtpd(8),qmail-tcpok(8),qmail-tcpto(8)