.TH qmail-command 8.SH NAMEqmail-command \- user-specified mail delivery program.SH SYNOPSISin.BR .qmail\fIext :.B |\fIcommand.SH DESCRIPTION.B qmail-localwill, upon your request,feed each incoming mail message through a program of your choice.When a mail message arrives,.B qmail-localruns.B sh -c \fIcommandin your home directory.It makes the message available on .IR command 'sstandard input..B WARNING:The mail message does not begin with.BR qmail-local 'susual.B Return-Pathand.B Delivered-Tolines.Note that.B qmail-localuses the same file descriptor for every deliveryin your.B .qmailfile, so it is not safe for.I commandto fork a child thatreads the message in the background while the parent exits..SH "EXIT CODES".IR command 'sexit codes are interpreted as follows:0 means that the delivery was successful;99 means that the delivery was successful,but that.B qmail-localshould ignore all further delivery instructions;100 means that the delivery failed permanently (hard error);111 means that the delivery failed but should be tried againin 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.I commandshould avoid relying on this..SH "ENVIRONMENT VARIABLES".B qmail-localsupplies several useful environment variables to.IR command ..B WARNING:These environment variables are not quoted.They may contain special characters.They are under the control of a possibly malicious remote user..B SENDERis the envelope sender address..B NEWSENDERis the forwarding envelope sender address,as described in.BR dot-qmail(5) ..B RECIPIENTis the envelope recipient address,.IR local@domain ..B USERis.IR user ..B HOMEis your home directory,.IR homedir ..B HOSTis the.I domainpart of the recipient address..B LOCALis the.I localpart..B EXTis theaddress extension,.IR ext ..B HOST2is the portion of.B HOSTpreceding the last dot;.B HOST3is the portion of.B HOSTpreceding the second-to-last dot;.B HOST4is the portion of.B HOSTpreceding the third-to-last dot..B EXT2is the portion of.B EXTfollowing the first dash;.B EXT3is the portionfollowing the second dash;.B EXT4is the portionfollowing the third dash..B DEFAULTis the portioncorresponding to the.B defaultpart of the.BR .qmail\- ...file name;.B DEFAULTis not set ifthe file name does not end with.BR default ..B DTLINEand.B RPLINEare the usual.B Delivered-Toand.B Return-Pathlines,including newlines..B UFLINEis the UUCP-style.B From_line that.B qmail-localadds to.IR mbox -formatfiles..SH "SEE ALSO"dot-qmail(5),envelopes(5),qmail-local(8)