qmail-alias - deliver or forward a mail message

SYNOPSIS

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

DESCRIPTION

       qmail-alias 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-
       alias records local@domain in a  new  Delivered-To  header
       field.   If  exactly  the  same Delivered-To: local@domain
       already appears in the  header,  qmail-alias  bounces  the
       message, to prevent mail forwarding loops.

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

       homedir is the user's home directory.  It must be an abso-
       lute directory name.

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

       The  standard  input  for  qmail-alias  must be a seekable
       file, so that qmail-alias 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 tem-
       porary failure.

SEE ALSO

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