NAME

       nullmailer-inject - Reformat and inject a message into the queue.

SYNOPSIS

       nullmailer-inject [-a] [-b] [-e] [-f sender] [-h] [recipient [recipient ...]]

DESCRIPTION

       This  program  reads a email message from standard input, reformats its header to comply with RFC822, and
       sends the resulting message to the queue.

   HEADER FIELDS
       The following lines are parsed for recipient addresses: To, Cc, Bcc, Apparently-To, Resent-To, Resent-Cc,
       and Resent-Bcc.

       The following sender address lines are parsed and rewritten: Sender, From, Reply-To, Return-Path, Return-
       Receipt-To, Errors-To, Resent-Sender, Resent-From, and Resent-Reply-To.  If the Return-Path header  field
       is present and contains a single address, its contents will be used to set the envelope sender address.

       If  the  message  contains any of the following fields, it is treated as a resent message: Resent-Sender,
       Resent-From, Resent-Reply-To, Resent-To, Resent-Cc, Resent-Bcc, Resent-Date, Resent-Message-ID.   If  the
       message is resent, only the recipient fields prefixed with Resent- are examined for addresses.

       Any  occurrences  of  Bcc, Resent-Bcc, Return-Path, or Content-Length are discarded after they are parsed
       (if necessary).

       If the header lacks a Message-Id field, a unique string is generated and added to the  message.   If  the
       header  lacks  a Date field, the current local date and time in RFC822 format is appended to the message.
       If the message has no To or Cc fields, the following line is appended to the message:

            Cc: recipient list not shown: ;

   ADDRESS LISTS
       Address lists are expected to follow the syntax set  out  in  RFC822.   The  following  is  a  simplified
       explanation of the syntax.

       An  address  list  is  list  of addresses separated by commas.  An individual address may have one of the
       following three forms: user@fqdn, comment<user@fqdn>, or phrase:address-list;.   Any  of  the  first  two
       forms may be used within the address list of the third form.  Any word containing special characters must
       be placed in double quotes and the special characters must be preceded with a backslash.  Comments may be
       placed between addresses in parenthesis.  All comments are ignored.

       Addresses  lists are reformatted as they are parsed for ease of later re-parsing when the message reaches
       the destination(s).  If an address is missing a fqdn, nullmailer-inject adds one.

OPTIONS

       -a     Use only the command line arguments as recipient addresses.  Ignore the header recipient lines.

       -b     Use both the command line arguments and data from the message header as recipient addresses.

       -e     Use either the command line arguments (if there are any) or data from the message header (if there
              are no arguments) as the recipient addresses.

       -f sender
              Set the envelope sender address to sender.

       -h     Use only data from the message header as the recipient addresses.

       -n     Do not queue the message, but print the reformatted contents to standard output.

       -v     Print  out  the  envelope (sender and recipient addresses) preceding the message when printing the
              message to standard output.

RETURN VALUE

       Exits 0 if it was successful, otherwise it prints a diagnostic message to standard error and exits 1.

ENVIRONMENT

       The environment variable NULLMAILER_FLAGS is parsed and the behavior of nullmailer-inject is modified  if
       any of the following letters are present:

       c      Use  "address  (comment)"  style  in  the  generated  From  field  instead of the default "comment
              <address>" style.

       f      Ignore and remove any From header lines and always insert a generated one.

       i      Ignore and remove any Message-Id header lines.

       s      Ignore and remove any Return-Path header lines.

       t      Insert a To line containing a list of the recipients if the header does not contain either a To or
              a Cc field.  If the message is determined to be a resent message (see above), a Resent-To field is
              added if the header does not contain either a Resent-To or a Resent-Cc field.

       The user name is set by NULLMAILER_USER, MAILUSER, USER, or LOGNAME, whichever comes first.  If  none  of
       the above are set the name is taken from the password file, or set to unknown if that fails.

       The  host  name  is  set  by the canonicalized value of NULLMAILER_HOST, MAILHOST, or HOSTNAME, whichever
       comes first, or the defaulthost config file if none of the above are set (see below).

       The full name of the user is set by NULLMAILER_NAME, MAILNAME, NAME, or the user  name  above,  whichever
       comes first.

       The  user  and  host  name of the envelope sender default to the user and host name set above, but may be
       overridden by NULLMAILER_SUSER and NULLMAILER_SHOST.

       If NULLMAILER_QUEUE is set, the program named is used in place of nullmailer-queue to queue the formatted
       message.

CONTROL FILES

       When  reading  the  following  files,  a  single  line  is  read and stripped of all leading and trailing
       whitespace characters.

       defaultdomain
              The content of this file is appended to any host name that  does  not  contain  a  period  (except
              localhost),  including  defaulthost and idhost.  Defaults to the value of the /etc/mailname system
              file, if it exists, otherwise the literal name defauldomain.

       defaulthost
              The content of this file is appended to any address that is missing a host name.  Defaults to  the
              value of the /etc/mailname system file, if it exists, otherwise the literal name defaulthost.

       idhost The content of this file is used when building the message-id string for the message.  Defaults to
              the canonicalized value of defaulthost.

       /etc/mailname
              The fully-qualifiled host name of the computer running nullmailer.  Defaults to the  literal  name
              me.

SEE ALSO

       nullmailer-queue(8)

NOTES

       This  document  glosses over very many details of how address parsing and rewriting actually works (among
       other things).

                                                                                            nullmailer-inject(1)