MAN PAGES FOR QMAIL 1.03

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  back-
     ground 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)