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)

---

Free and Open Source Software