qmail-command(8) Maintenance Procedures qmail-command(8) 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. 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 con- sidered hard errors, and all other codes are considered soft errors, but command should avoid relying on this. qmail-local 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-local 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-local(8) SunOS 5.5 Last change: 1