qmail-send(8) qmail-send(8) NNAAMMEE qmail-send - deliver mail messages from the queue SSYYNNOOPPSSIISS qqmmaaiill--sseenndd DDEESSCCRRIIPPTTIIOONN qqmmaaiill--sseenndd handles messages placed into the outgoing queue by qqmmaaiill-- qquueeuuee. It uses qqmmaaiill--llssppaawwnn to deliver messages to local recipients and qqmmaaiill--rrssppaawwnn to deliver messages to remote recipients. If a mes- sage is temporarily undeliverable to one or more addresses, qqmmaaiill--sseenndd leaves it in the queue and tries the addresses again later. qqmmaaiill--sseenndd prints a readable record of its activities to descriptor 0. It writes commands to qqmmaaiill--llssppaawwnn, qqmmaaiill--rrssppaawwnn, and qqmmaaiill--cclleeaann on descriptors 1, 3, and 5, and reads responses from descriptors 2, 4, and 6. qqmmaaiill--sseenndd is responsible for avoiding deadlock. If qqmmaaiill--sseenndd receives a TERM signal, it will exit cleanly, after wait- ing (possibly more than a minute) for current delivery attempts to fin- ish. If qqmmaaiill--sseenndd receives an ALRM signal, it will reschedule every message in the queue for immediate delivery. CCOONNTTRROOLL FFIILLEESS WWAARRNNIINNGG:: qqmmaaiill--sseenndd reads its control files only when it starts. If you change the control files, you must stop and restart qqmmaaiill--sseenndd. Exception: If qqmmaaiill--sseenndd receives a HUP signal, it will reread _l_o_c_a_l_s and _v_i_r_t_u_a_l_d_o_m_a_i_n_s. _b_o_u_n_c_e_f_r_o_m Bounce username. Default: MMAAIILLEERR--DDAAEEMMOONN. _b_o_u_n_c_e_h_o_s_t Bounce host. Default: _m_e, if that is supplied; otherwise the lit- eral name bboouunncceehhoosstt, which is probably not what you want. If a message is permanently undeliverable, qqmmaaiill--sseenndd sends a ssiinnggllee-- bboouunnccee notice back to the message’s envelope sender. The notice is FFrroomm:: _b_o_u_n_c_e_f_r_o_m@@_b_o_u_n_c_e_h_o_s_t, although its envelope sender is empty. _c_o_n_c_u_r_r_e_n_c_y_l_o_c_a_l Maximum number of simultaneous local delivery attempts. Default: 10. If 0, local deliveries will be put on hold. _c_o_n_c_u_r_r_e_n_c_y_l_o_c_a_l is limited at compile time to 120. _c_o_n_c_u_r_r_e_n_c_y_r_e_m_o_t_e Maximum number of simultaneous remote delivery attempts. Default: 20. If 0, remote deliveries will be put on hold. _c_o_n_c_u_r_r_e_n_c_y_r_e_- _m_o_t_e is limited at compile time to 120. _d_o_u_b_l_e_b_o_u_n_c_e_h_o_s_t Double-bounce host. Default: _m_e, if that is supplied; otherwise the literal name ddoouubblleebboouunncceehhoosstt, which is probably not what you want. _d_o_u_b_l_e_b_o_u_n_c_e_t_o User to receive double-bounces. Default: ppoossttmmaasstteerr. If a sin- gle-bounce notice is permanently undeliverable, qqmmaaiill--sseenndd sends a ddoouubbllee--bboouunnccee notice to _d_o_u_b_l_e_b_o_u_n_c_e_t_o@@_d_o_u_b_l_e_b_o_u_n_c_e_h_o_s_t. (If that bounces, qqmmaaiill--sseenndd gives up.) _e_n_v_n_o_a_t_h_o_s_t Presumed domain name for addresses without @ signs. Default: _m_e, if that is supplied; otherwise the literal name eennvvnnooaatthhoosstt, which is probably not what you want. If qqmmaaiill--sseenndd sees an envelope recipient address without an @ sign, it appends @@_e_n_v_n_o_a_t_h_o_s_t. _l_o_c_a_l_s List of domain names that the current host receives mail for, one per line. Default: _m_e, if that is supplied; otherwise qqmmaaiill--sseenndd refuses to run. An address _u_s_e_r_@_d_o_m_a_i_n is considered local if _d_o_m_a_i_n is listed in _l_o_c_a_l_s. _p_e_r_c_e_n_t_h_a_c_k List of domain names where the percent hack is applied. If _d_o_m_a_i_n is listed in _p_e_r_c_e_n_t_h_a_c_k, any address of the form _u_s_e_r_%_f_q_d_n_@_d_o_m_a_i_n is rewritten as _u_s_e_r_@_f_q_d_n. _u_s_e_r may contain %, so the percent hack may be applied repeatedly. qqmmaaiill--sseenndd handles _p_e_r_c_e_n_t_h_a_c_k before _l_o_c_a_l_s. _q_u_e_u_e_l_i_f_e_t_i_m_e Number of seconds a message can stay in the queue. Default: 604800 (one week). After this time expires, qqmmaaiill--sseenndd will try the message once more, but it will treat any temporary delivery failures as permanent failures. _v_i_r_t_u_a_l_d_o_m_a_i_n_s List of virtual users or domains, one per line. A virtual user has the form _u_s_e_r@@_d_o_m_a_i_n::_p_r_e_p_e_n_d, without any extra spaces. When qqmmaaiill--sseenndd sees the recipient address _u_s_e_r@@_d_o_m_a_i_n, it converts it to _p_r_e_p_e_n_d--_u_s_e_r@@_d_o_m_a_i_n and treats it as local. A virtual domain has the form _d_o_m_a_i_n::_p_r_e_p_e_n_d. It applies to any recipient address at _d_o_m_a_i_n. For example, if nowhere.mil:joe-foo is in _v_i_r_t_u_a_l_d_o_m_a_i_n_s, and a message arrives for iinnffoo@@nnoowwhheerree..mmiill, qqmmaaiill--sseenndd will rewrite the recipient address as jjooee--ffoooo-- iinnffoo@@nnoowwhheerree..mmiill and deliver the message locally. _v_i_r_t_u_a_l_d_o_m_a_i_n_s may contain wildcards: .fax:uucp-fax :alias-catchall .nowhere.mil:joe-foo-host _v_i_r_t_u_a_l_d_o_m_a_i_n_s may also contain exceptions: an empty _p_r_e_p_e_n_d means that _d_o_m_a_i_n is not a virtual domain. qqmmaaiill--sseenndd handles _v_i_r_t_u_a_l_d_o_m_a_i_n_s after _l_o_c_a_l_s: if a domain is listed in _l_o_c_a_l_s, _v_i_r_t_u_a_l_d_o_m_a_i_n_s does not apply. SSEEEE AALLSSOO nice(1), addresses(5), envelopes(5), qmail-control(5), qmail-log(5), qmail-queue(8), qmail-clean(8), qmail-lspawn(8), qmail-rspawn(8) qmail-send(8)