qmail-inject(8) qmail-inject(8) NNAAMMEE qmail-inject - preprocess and send a mail message SSYYNNOOPPSSIISS qqmmaaiill--iinnjjeecctt [ --nnNNaaAAhhHH ] [ --ff_s_e_n_d_e_r ] [ _r_e_c_i_p _._._. ] DDEESSCCRRIIPPTTIIOONN qqmmaaiill--iinnjjeecctt reads a mail message from its standard input, adds appro- priate information to the message header, and invokes qqmmaaiill--qquueeuuee to send the message to one or more recipients. See qqmmaaiill--hheeaaddeerr((55)) for information on how qqmmaaiill--iinnjjeecctt rewrites header fields. qqmmaaiill--iinnjjeecctt normally exits 0. It exits 100 if it was invoked improp- erly or if there is a severe syntax error in the message. It exits 111 for temporary errors. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS For the convenience of users who do not run qqmmaaiill--iinnjjeecctt directly, qqmmaaiill--iinnjjeecctt takes many options through environment variables. The user name in the FFrroomm header field is set by QQMMAAIILLUUSSEERR, MMAAIILLUUSSEERR, UUSSEERR, or LLOOGGNNAAMMEE, whichever comes first. The host name is normally set by the _d_e_f_a_u_l_t_h_o_s_t control but can be overridden with QQMMAAIILLHHOOSSTT or MMAAIILLHHOOSSTT. The personal name is QQMMAAIILLNNAAMMEE, MMAAIILLNNAAMMEE, or NNAAMMEE. The default envelope sender address is the same as the default FFrroomm address, but it can be overridden with QQMMAAIILLSSUUSSEERR and QQMMAAIILLSSHHOOSSTT. It may also be modified by the rr and mm letters described below. Bounces will be sent to this address. If QQMMAAIILLMMFFTTFFIILLEE is set, qqmmaaiill--iinnjjeecctt reads a list of mailing list addresses, one per line, from that file. If To+Cc includes one of those addresses (without regard to case), qqmmaaiill--iinnjjeecctt adds a Mail-Fol- lowup-To field with all the To+Cc addresses. qqmmaaiill--iinnjjeecctt does not add Mail-Followup-To to a message that already has one. The QQMMAAIILLIINNJJEECCTT environment variable can contain any of the following letters: cc Use address-comment style for the FFrroomm field. Normally qqmmaaiill-- iinnjjeecctt uses name-address style. ss Do not look at any incoming RReettuurrnn--PPaatthh field. Normally, if RReettuurrnn--PPaatthh is supplied, it sets the envelope sender address, overriding all environment variables. RReettuurrnn--PPaatthh is deleted in any case. ff Delete any incoming FFrroomm field. Normally, if FFrroomm is supplied, it overrides the usual FFrroomm field created by qqmmaaiill--iinnjjeecctt. ii Delete any incoming MMeessssaaggee--IIDD field. Normally, if MMeessssaaggee--IIDD is supplied, it overrides the usual MMeessssaaggee--IIDD field created by qqmmaaiill--iinnjjeecctt. rr Use a per-recipient VERP. qqmmaaiill--iinnjjeecctt will append each recipi- ent address to the envelope sender of the copy going to that recipient. mm Use a per-message VERP. qqmmaaiill--iinnjjeecctt will append the current date and process ID to the envelope sender. OOPPTTIIOONNSS --aa Send the message to all addresses given as _r_e_c_i_p arguments; do not use header recipient addresses. --hh Send the message to all header recipient addresses. For non- forwarded messages, this means the addresses listed under TToo, CCcc, BBcccc, AAppppaarreennttllyy--TToo. For forwarded messages, this means the addresses listed under RReesseenntt--TToo, RReesseenntt--CCcc, RReesseenntt--BBcccc. Do not use any _r_e_c_i_p arguments. --AA (Default.) Send the message to all addresses given as _r_e_c_i_p arguments. If no _r_e_c_i_p arguments are supplied, send the message to all header recipient addresses. --HH Send the message to all header recipient addresses, and to all addresses given as _r_e_c_i_p arguments. --ff_s_e_n_d_e_r Pass _s_e_n_d_e_r to qqmmaaiill--qquueeuuee as the envelope sender address. This overrides RReettuurrnn--PPaatthh and all environment variables. --NN (Default.) Feed the resulting message to qqmmaaiill--qquueeuuee. --nn Print the message rather than feeding it to qqmmaaiill--qquueeuuee. CCOONNTTRROOLL FFIILLEESS _d_e_f_a_u_l_t_d_o_m_a_i_n Default domain name. Default: _m_e, if that is supplied; otherwise the literal name ddeeffaauullttddoommaaiinn, which is probably not what you want. qqmmaaiill--iinnjjeecctt adds this name to any host name without dots, including _d_e_f_a_u_l_t_h_o_s_t if _d_e_f_a_u_l_t_h_o_s_t does not have dots. (Excep- tion: see _p_l_u_s_d_o_m_a_i_n.) The QQMMAAIILLDDEEFFAAUULLTTDDOOMMAAIINN environment variable overrides _d_e_f_a_u_l_t_d_o_- _m_a_i_n. _d_e_f_a_u_l_t_h_o_s_t Default host name. Default: _m_e, if that is supplied; otherwise the literal name ddeeffaauulltthhoosstt, which is probably not what you want. qqmmaaiill--iinnjjeecctt adds this name to any address without a host name. _d_e_f_a_u_l_t_h_o_s_t need not be the current host’s name. For example, you may prefer that outgoing mail show just your domain name. The QQMMAAIILLDDEEFFAAUULLTTHHOOSSTT environment variable overrides _d_e_f_a_u_l_t_h_o_s_t. _i_d_h_o_s_t Host name for Message-IDs. Default: _m_e, if that is supplied; oth- erwise the literal name iiddhhoosstt, which is certainly not what you want. _i_d_h_o_s_t need not be the current host’s name. For example, you may prefer to use fake host names in Message-IDs. However, _i_d_h_o_s_t must be a fully-qualified name within your domain, and each host in your domain should use a different _i_d_h_o_s_t. The QQMMAAIILLIIDDHHOOSSTT environment variable overrides _i_d_h_o_s_t. _p_l_u_s_d_o_m_a_i_n Plus domain name. Default: _m_e, if that is supplied; otherwise the literal name pplluussddoommaaiinn, which is probably not what you want. qqmmaaiill--iinnjjeecctt adds this name to any host name that ends with a plus sign, including _d_e_f_a_u_l_t_h_o_s_t if _d_e_f_a_u_l_t_h_o_s_t ends with a plus sign. If a host name does not have dots but ends with a plus sign, qqmmaaiill--iinnjjeecctt uses _p_l_u_s_d_o_m_a_i_n, not _d_e_f_a_u_l_t_d_o_m_a_i_n. The QQMMAAIILLPPLLUUSSDDOOMMAAIINN environment variable overrides _p_l_u_s_d_o_m_a_i_n. SSEEEE AALLSSOO addresses(5), qmail-control(5), qmail-header(5), qmail-queue(8) qmail-inject(8)