qmail-command - user-specified mail delivery program


SYNOPSIS

       in .qmailext: |command


DESCRIPTION

       qmail-alias  will,  upon  your request, feed each incoming
       mail message through a program of your choice.

       When a mail message arrives, qmail-alias runs sh  -c  com-
       mand  in your home directory.  It makes the message avail-
       able on command's standard input.

       WARNING: The mail  message  does  not  begin  with  qmail-
       alias's usual Return-Path and Delivered-To lines.

       Note  that  qmail-alias  uses the same file descriptor for
       every delivery in your .qmail file, so it is not safe  for
       command  to  fork  a  child  that reads the message in the
       background while the parent exits.

       command's exit codes are interpreted as follows:  0  means
       that the delivery was successful; 99 means that the deliv-
       ery was successful, but that qmail-alias should ignore all
       further  delivery  instructions;  71,  74, 75, 111, or 120
       means that the delivery failed but should be  tried  again
       in  a  little while; anything else means that the delivery
       failed permanently.

       qmail-alias supplies several useful environment  variables
       to  command.   SENDER  is  the  envelope  sender  address.
       NEWSENDER is the forwarding envelope  sender  address,  as
       described  in  dot-qmail(5).   RECIPIENT  is  the envelope
       recipient address, local@domain.  USER is user.   HOME  is
       your  home directory, homedir.  HOST is the domain part of
       the recipient address.  LOCAL is the local part.   EXT  is
       the  .qmail  extension,  ext.   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.  DTLINE and RPLINE are the  usual  Delivered-To  and
       Return-Path  lines,  including  newlines.   UFLINE  is the
       UUCP-style From_ line that qmail-alias adds to mbox-format
       files.

       WARNING: These environment variables are not quoted.  They
       may contain special characters.  They are under  the  con-
       trol of a possibly malicious remote user.


SEE ALSO

       dot-qmail(5), envelopes(5), qmail-alias(8)