qmail-command(8)      Maintenance Procedures     qmail-command(8)



NAME
     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  command
     in  your  home directory.  It makes the message available 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 back-
     ground while the parent exits.

     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-alias should ignore all  fur-
     ther  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  con-
     sidered hard errors, and all other codes are considered soft
     errors, but command should avoid relying on this.

     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 control
     of a possibly malicious remote user.

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



SunOS 5.5                 Last change:                          1