qmail-local(8) [osf1 man page]

qmail-local(8)						      System Manager's Manual						    qmail-local(8)

NAME

       qmail-local - deliver or forward a mail message

SYNOPSIS

       qmail-local [ -nN ] user homedir local dash ext domain sender defaultdelivery

DESCRIPTION

       qmail-local reads a mail message and delivers it to user by the procedure described in dot-qmail(5).

       The  message's  envelope  recipient  is local@domain.  qmail-local records local@domain in a new Delivered-To header field.  If exactly the
       same Delivered-To: local@domain already appears in the header, qmail-local bounces the message, to prevent mail forwarding loops.

       The message's envelope sender is sender.  qmail-local records sender in a new Return-Path header field.

       homedir is the user's home directory.  It must be an absolute directory name.

       dash and ext identify the .qmaildashext file used by qmail-local; see dot-qmail(5).  Normally dash is either empty or a lone hyphen.  If it
       is  empty,  qmail-local	treats	a nonexistent .qmailext the same way as an empty .qmailext: namely, following the delivery instructions in
       defaultdelivery.

       The standard input for qmail-local must be a seekable file, so that qmail-local can read it more than once.

OPTIONS

       -n     Instead of reading and delivering the message, print a description of the delivery instructions.

       -N     (Default.) Read and deliver the message.

EXIT CODES

       0 if the delivery is completely successful; nonzero if any delivery instruction failed.	Exit code 111 indicates temporary failure.

SEE ALSO

       dot-qmail(5), envelopes(5), qmail-command(8), qmail-queue(8), qmail-send(8), qmail-lspawn(8)

																    qmail-local(8)

qmail-command(8)                                              System Manager's Manual                                             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 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  con-
       tain 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 recipi-
       ent 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)

                                                                                                                                  qmail-command(8)