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)