Provided by: qmail_1.06-4_i386 bug

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)