qmail-inject - preprocess and send a mail message

SYNOPSIS

       qmail-inject [ -nNaAhH ] [ -fsender ] [ recip ...  ]

DESCRIPTION

       qmail-inject reads a mail message from its standard input,
       adds appropriate information to the  message  header,  and
       invokes  qmail-queue  to  send  the message to one or more
       recipients.

       See qmail-header(5) for information  on  how  qmail-inject
       rewrites header fields.

       qmail-inject  normally  exits  0.   It  exits  1 if it was
       invoked improperly or if there is a severe syntax error in
       the message.  It exits 111 for temporary errors.

ENVIRONMENT VARIABLES

       For  the  convenience of users who do not run qmail-inject
       directly, qmail-inject takes many options through environ-
       ment variables.

       The  user  name  in  the  From  header  field  is  set  by
       QMAILUSER, MAILUSER, USER,  or  LOGNAME,  whichever  comes
       first.

       The  host  name is normally set by the defaulthost control
       but can be overridden with QMAILHOST or MAILHOST.

       The personal name is QMAILNAME, MAILNAME, or NAME.

       The envelope sender address is normally the  same  as  the
       address in the From header field, but it can be overridden
       with QMAILSUSER and QMAILSHOST.  It may also  be  modified
       by  the  r and m letters described below.  Bounces will be
       sent to this address.

       The QMAILINJECT environment variable can  contain  any  of
       the following letters:

       c      Use address-comment style for the From field.  Nor-
              mally qmail-inject uses name-address style.

       s      Do not look  at  any  incoming  Return-Path  field.
              Normally,  if  Return-Path is supplied, it sets the
              envelope sender address, overriding all environment
              variables.  Return-Path is deleted in any case.

       f      Delete  any incoming From field.  Normally, if From
              is supplied, it overrides the usual From field cre-
              ated by qmail-inject.
              Message-ID is supplied, it overrides the usual Mes-
              sage-ID field created by qmail-inject.

       r      Use  the  per-recipient  owner  hack.  qmail-inject
              will append each recipient address to the  envelope
              sender of the copy going to that recipient.

       m      Use  the per-message owner hack.  qmail-inject will
              append the current date and process ID to the enve-
              lope sender.

OPTIONS

       -a     Send  the  message  to all addresses given as recip
              arguments; do not use header recipient addresses.

       -h     Send the message to all header recipient addresses.
              For   non-forwarded   messages,   this   means  the
              addresses listed under To, Cc, Bcc,  Apparently-To.
              For  forwarded  messages,  this means the addresses
              listed under Resent-To, Resent-Cc, Resent-Bcc.   Do
              not use any recip arguments.

       -A     (Default.)  Send the message to all addresses given
              as recip arguments.  If no recip arguments are sup-
              plied,  send  the  message  to all header recipient
              addresses.

       -H     Send the message to all header recipient addresses,
              and to all addresses given as recip arguments.

       -fsender
              Pass  sender  to qmail-queue as the envelope sender
              address.  This overrides Return-Path and all  envi-
              ronment variables.

       -N     (Default.)   Feed  the  resulting message to qmail-
              queue.

       -n     Print the message rather than feeding it to  qmail-
              queue.

CONTROL FILES

       defaultdomain
            Default  domain  name.   Default: me, if that is sup-
            plied;  otherwise  the  literal  name  defaultdomain,
            which  is  probably  not what you want.  qmail-inject
            adds this name to any host name without dots, includ-
            ing  defaulthost  if  defaulthost does not have dots.
            (Exception: see plusdomain.)

       defaulthost
            Default host name.  Default: me, if that is supplied;
            name to any address without a host name.  defaulthost
            need not be the current host's  name.   For  example,
            you  may  prefer  that  outgoing  mail show just your
            domain name.

       idhost
            Host name for Message-IDs.  Default: me, if  that  is
            supplied; otherwise the literal name idhost, which is
            certainly not what you want.  idhost need not be  the
            current  host's name.  For example, you may prefer to
            use fake host names in Message-IDs.  However,  idhost
            must  be  a  fully-qualified name within your domain,
            and each host in your domain should use  a  different
            idhost.

       plusdomain
            Plus  domain name.  Default: me, if that is supplied;
            otherwise the literal name plusdomain, which is prob-
            ably  not what you want.  qmail-inject adds this name
            to any host name that ends with a plus sign,  includ-
            ing defaulthost if defaulthost ends with a plus sign.
            If a host name does not have dots  but  ends  with  a
            plus sign, qmail-inject uses plusdomain, not default-
            domain.

SEE ALSO

       addresses(5),  qmail-control(5),  qmail-header(5),  
       qmail-queue(8)