Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
new-inject(1)		    General Commands Manual		 new-inject(1)

NAME
       new-inject - preprocess a mail message

SYNOPSIS
       new-inject [ -nNaAhHFIMRS ] [ -fsender ]	[ recip	...  ]

DESCRIPTION
       With  the (default) -N option, new-inject reads a mail message from its
       standard	input, rewrites	the message header, and	 feeds	the  rewritten
       message to qmail-queue.

       With  the  -n option, new-inject	prints the message rather than feeding
       it to qmail-queue.

       See http://pobox.com/~djb/proto/immhf.html for a	 complete  description
       of the Internet mail message header format.

       The  FIMRS  options can be set as letters inside	the $QMAILINJECT envi-
       ronment variable.

ADDRESS	REWRITING
       new-inject transforms each address according to the control  files  de-
       faultdomain,  defaulthost,  me,	plusdomain,  and rewrite.  See rewrit-
       ing(5) for further  details.   If  you  set  the	 environment  variable
       $QMAILREWRITEFILE, and that file	exists,	it overrides rewrite.

ENVELOPE ADDRESSES
       new-inject  builds an envelope for the message: a list of recipient ad-
       dresses that will receive the message, and a sender address  that  will
       receive bounces.

       If  new-inject is printing the message rather than feeding it to	qmail-
       queue, it prints	an Envelope-Sender field  and  an  Envelope-Recipients
       field at	the top	of the new message header.

       With  the -a option, new-inject builds the envelope recipient list from
       the argument recipients,	i.e., all recip	addresses listed on  the  com-
       mand  line.  With the -h	option,	new-inject builds the envelope recipi-
       ent list	from the header	recipients, i.e., all addresses	listed in  the
       incoming	 message  under	Envelope-Recipients, or	under To, Cc, Bcc, and
       Apparently-To if	Envelope-Recipients is not supplied.  With the -H  op-
       tion,  new-inject  uses both argument recipients	and header recipients.
       With the	(default) -A option, new-inject	uses argument  recipients,  or
       header recipients if there are no argument recipients.

       The  envelope  sender is	set by the -f option if	it is supplied;	other-
       wise, the incoming Envelope-Sender field, if there is  one;  otherwise,
       the  incoming  Return-Path field, if there is one, and if the -S	option
       is not set; otherwise, the default envelope sender, as described	below.
       Incoming	Envelope-Sender	and Return-Path	 fields	 are  removed  in  any
       case.

       The default envelope sender contains a user name, a per-message VERP, a
       per-recipient  VERP, and	a host name.  The user name is set by an envi-
       ronment variable: $QMAILSUSER, $QMAILUSER, $MAILUSER, $USER,  or	 $LOG-
       NAME,  whichever	comes first.  If the -M	option is set, the per-message
       VERP contains a dash, the current time, and the process	ID;  otherwise
       it  is empty.  If the -R	option is set, the per-recipient VERP contains
       a dash, the envelope recipient user name, an equals sign, and the enve-
       lope recipient host name; otherwise it is empty.	 (If there are several
       recipients, each	recipient sees a different sender address.)  The  host
       name is set by $QMAILSHOST, $QMAILHOST, $MAILHOST, or the empty string,
       subject to rewriting.

RECIPIENTS
       new-inject  rewrites addresses in To, Cc, and Notice-Requested-Upon-De-
       livery-To fields.  It cleans up the spacing, adds missing commas, trims
       extra commas, adds missing quotes, wraps	lines at a reasonable  length,
       converts	 source	 routes	 into  comments, etc.  If there	are several To
       fields, new-inject merges them into a single To field.

       new-inject removes all incoming Bcc and Apparently-To fields.

SENDERS
       new-inject rewrites addresses in	From and Sender	fields.

       If the incoming message does not	contain	a From field, new-inject  cre-
       ates a new From field.

       If  the	-F option is set, new-inject discards any incoming From	field,
       and creates a new From field.

       The new From field contains a personal name, a user name,  and  a  host
       name.   The  personal  name  is set by $QMAILNAME, $MAILNAME, or	$NAME,
       whichever comes first; if none of these variables are set, the personal
       name is omitted.	 The user name is set by $QMAILUSER, $MAILUSER,	$USER,
       or $LOGNAME.  The host name is set by  $QMAILHOST,  $MAILHOST,  or  the
       empty string, subject to	rewriting.

RESPONSE TARGETS
       new-inject rewrites addresses in	Reply-To, Mail-Reply-To, and Mail-Fol-
       lowup-To	fields.

       If  the	environment  variable $QMAILMFTFILE is set, new-inject 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),  and  if  the
       incoming	 message does not contain a Mail-Followup-To field, new-inject
       adds a Mail-Followup-To field with all the To+Cc	addresses.

DATE FIELDS
       If the incoming message	has  comprehensible  Date  fields,  new-inject
       takes the last one and rewrites it in a standard	format.	 It transforms
       2-digit (and 3-digit) years into	4-digit	years.	It also	transforms ob-
       solete time zone	names into numeric time	zones.

       Otherwise  new-inject  makes  a new Date	field with the current time in
       UTC, counting leap seconds.

THREADING
       If the incoming message does not	contain	a Message-ID field, new-inject
       creates a new Message-ID	field.

       If the -I option	is set,	new-inject discards  any  incoming  Message-ID
       field, and creates a new	Message-ID field.

       new-inject  uses	 the control file idhost (overridden by	he environment
       variable	$QMAILIDHOST; defaulting to me)	in its new  Message-ID	field.
       idhost  need not	be the current host's name.  It	is your	responsibility
       to obtain authorization from the	owner of the idhost domain.

MISCELLANY
       new-inject puts Received, Delivered-To,	Errors-To,  Return-Receipt-To,
       Resent-Sender,  Resent-From, Resent-Reply-To, Resent-To,	Resent-Cc, Re-
       sent-Bcc, Resent-Date, and Resent-Message-ID fields at the top  of  the
       header.	It does	not rewrite any	of these fields; it follows the	822bis
       approach	of treating Resent-* as	trace fields.

       new-inject discards incoming Content-Length fields.

SEE ALSO
       leapsecs(3), qmail-control(5), rewriting(5), qmail-queue(8)

								 new-inject(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=new-inject&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help