Manual Reference Pages - QMAIL-COMMAND (8)
qmail-command - user-specified mail delivery program
qmail-local will, upon your request,
feed each incoming mail message through a program of your choice.
When a mail message arrives,
sh -c command in your home directory.
It makes the message available on
commands standard input.
WARNING: The mail message does not begin with
qmail-local uses the same file descriptor for every delivery
.qmail file, so it is not safe for
command to fork a child that
reads the message in the background while the parent exits.
commands exit codes are interpreted as follows:
0 means that the delivery was successful;
99 means that the delivery was successful,
qmail-local should ignore all further delivery instructions;
100 means that the delivery failed permanently (hard error);
111 means that the delivery failed but should be tried again
in a little while (soft error).
Currently 64, 65, 70, 76, 77, 78, and 112 are considered hard errors,
and all other codes are considered soft errors,
command should avoid relying on this.
qmail-local supplies several useful environment variables to
WARNING: These environment variables are not quoted.
They may contain special characters.
They are under the control of a possibly malicious remote user.
SENDER is the envelope sender address.
NEWSENDER is the forwarding envelope sender address,
as described in
RECIPIENT is the envelope recipient address,
HOME is your home directory,
HOST is the
domain part of the recipient address.
LOCAL is the
EXT is the
HOST2 is the portion of
HOST preceding the last dot;
HOST3 is the portion of
HOST preceding the second-to-last dot;
HOST4 is the portion of
HOST preceding the third-to-last dot.
EXT2 is the portion of
EXT following the first dash;
EXT3 is the portion
following the second dash;
EXT4 is the portion
following the third dash.
DEFAULT is the portion
corresponding to the
default part of the
.qmail-... file name;
DEFAULT is not set if
the file name does not end with
RPLINE are the usual
UFLINE is the UUCP-style
From_ line that
qmail-local adds to
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.