qmail-alias(8)        Maintenance Procedures       qmail-alias(8)



NAME
     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  mes-
     sage, 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 nonexis-
     tent .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 tempo-
     rary failure.

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










SunOS 5.5                 Last change:                          1