Man Linux: Main Page and Category List

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  seperated  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 output 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, or NAME,
       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)