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)