qmail-remote(8) qmail-remote(8) NNAAMMEE qmail-remote - send mail via SMTP SSYYNNOOPPSSIISS qqmmaaiill--rreemmoottee _h_o_s_t _s_e_n_d_e_r _r_e_c_i_p [ _r_e_c_i_p _._._. ] DDEESSCCRRIIPPTTIIOONN qqmmaaiill--rreemmoottee reads a mail message from its input and sends the message to one or more recipients at a remote host. The remote host is qqmmaaiill--rreemmoottee’s first argument, _h_o_s_t. qqmmaaiill--rreemmoottee sends the message to _h_o_s_t, or to a mail exchanger for _h_o_s_t listed in the Domain Name System, via the Simple Mail Transfer Protocol (SMTP). _h_o_s_t 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 _r_e_c_i_p arguments to qqmmaaiill--rreemmoottee. The envelope sender address is listed as _s_e_n_d_e_r. Note that qqmmaaiill--rreemmoottee does not take options and does not follow the ggeettoopptt standard. TTRRAANNSSPPAARREENNCCYY End-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 mes- sage that does not end with a newline. qqmmaaiill--rreemmoottee converts the UNIX newline convention into the SMTP newline convention by inserting CR before each LF. It is a violation of the SMTP protocol to send a message that contains long lines or non-ASCII characters. However, qqmmaaiill--rreemmoottee will happily send such messages. It is the user’s responsibility to avoid generat- ing illegal messages. RREESSUULLTTSS qqmmaaiill--rreemmoottee prints some number of _r_e_c_i_p_i_e_n_t _r_e_p_o_r_t_s, followed by a _m_e_s_s_a_g_e _r_e_p_o_r_t. 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. _h_o_s_t has taken responsibility for deliv- ering 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 qqmmaaiill--rreemmoottee’s _r_e_c_i_p arguments. Note that in failure cases there may be fewer recipient reports than _r_e_c_i_p arguments. qqmmaaiill--rreemmoottee always exits zero. CCOONNTTRROOLL FFIILLEESS _h_e_l_o_h_o_s_t Current host name, for use solely in saying hello to the remote SMTP server. Default: _m_e, if that is supplied; otherwise qqmmaaiill-- rreemmoottee refuses to run. _s_m_t_p_r_o_u_t_e_s Artificial SMTP routes. Each route has the form _d_o_m_a_i_n::_r_e_l_a_y, without any extra spaces. If _d_o_m_a_i_n matches _h_o_s_t, qqmmaaiill--rreemmoottee will connect to _r_e_l_a_y, as if _h_o_s_t had _r_e_l_a_y as its only MX. (It will also avoid doing any CNAME lookups on _r_e_c_i_p.) _h_o_s_t may include a colon and a port number to use instead of the normal SMTP port, 25: inside.af.mil:firewall.af.mil:26 _r_e_l_a_y may be empty; this tells qqmmaaiill--rreemmoottee to look up MX records as usual. _s_m_t_p_r_o_u_t_e_s may include wildcards: .af.mil: :heaven.af.mil Here any address ending with ..aaff..mmiill (but not aaff..mmiill itself) is routed by its MX records; any other address is artificially routed to hheeaavveenn..aaff..mmiill. The qqmmaaiill system does not protect you if you create an artificial mail loop between machines. However, you are always safe using _s_m_t_p_r_o_u_t_e_s if you do not accept mail from the network. _t_i_m_e_o_u_t_c_o_n_n_e_c_t Number of seconds qqmmaaiill--rreemmoottee will wait for the remote SMTP server to accept a connection. Default: 60. The kernel normally imposes a 75-second upper limit. _t_i_m_e_o_u_t_r_e_m_o_t_e Number of seconds qqmmaaiill--rreemmoottee will wait for each response from the remote SMTP server. Default: 1200. SSEEEE AALLSSOO addresses(5), envelopes(5), qmail-control(5), qmail-send(8), qmail- smtpd(8), qmail-tcpok(8), qmail-tcpto(8) qmail-remote(8)