NAME

       qmail-command - user-specified mail delivery program

SYNOPSIS

       in .qmailext: |command

DESCRIPTION

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

       When a mail message arrives, qmail-local runs sh -c command in your  home  directory.   It
       makes the message available on command's standard input.

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

       Note that qmail-local 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.

EXIT CODES

       command's exit codes are interpreted as follows: 0 means that the delivery was successful;
       99  means that the delivery was successful, but that 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, but command should avoid relying on this.

ENVIRONMENT VARIABLES

       qmail-local supplies several useful environment  variables  to  command.   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  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 address extension,
       ext.

       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 default.

       DTLINE  and  RPLINE  are the usual Delivered-To and Return-Path lines, including newlines.
       UFLINE is the UUCP-style From_ line that qmail-local adds to mbox-format files.

SEE ALSO

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

                                                                                 qmail-command(8)