GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NEW-INJECT (1)

NAME

new-inject - preprocess a mail message

CONTENTS

Synopsis
Description

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 environment variable.

ADDRESS REWRITING

new-inject transforms each address according to the control files defaultdomain, defaulthost, me, plusdomain, and rewrite. See rewriting(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 addresses 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 command line. With the -h option, new-inject builds the envelope recipient 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 option, 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; otherwise, 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 environment variable: $QMAILSUSER, $QMAILUSER, $MAILUSER, $USER, or $LOGNAME, 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 envelope 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-Delivery-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 creates 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-Followup-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 obsolete 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, Resent-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)
Search for    or go to Top of page |  Section 1 |  Main Index


NEW-INJECT (1) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.