SYNOPSIS

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

DESCRIPTION

       qmail-inject  reads a mail message from its standard input, adds	appro-
       priate 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	100 if it was invoked  improp-
       erly 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 environment 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  default  envelope  sender  address is the same as the default From
       address,	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.

       If QMAILMFTFILE is set, qmail-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), qmail-inject adds a Mail-Fol-
       lowup-To	field with all the To+Cc addresses.  qmail-inject does not add
       Mail-Followup-To	to a message that already has one.

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

       c      Use  address-comment  style for the From field.  Normally	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	created	by qmail-inject.


       -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 supplied, 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 environment	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 supplied;  otherwise
	    the	 literal  name	defaultdomain,	which is probably not what you
	    want.  qmail-inject	adds this name to any host name	without	 dots,
	    including  defaulthost if defaulthost does not have	dots.  (Excep-
	    tion: see plusdomain.)

	    The	QMAILDEFAULTDOMAIN environment variable	 overrides  defaultdo-
	    main.

       defaulthost
	    Default  host  name.   Default: me,	if that	is supplied; otherwise
	    the	literal	name defaulthost, which	is probably not	what you want.
	    qmail-inject  adds	this  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.

	    The	QMAILDEFAULTHOST environment variable overrides	defaulthost.

       idhost
	    Host name for Message-IDs.	Default: me, if	that is	supplied; oth-
	    erwise 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.

	    The	QMAILIDHOST environment	variable overrides idhost.


				       8		s/qmail:(qmail-inject)