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  por-
       tion  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  por-
       tion 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.


Man(1) output converted with man2html