Provided by: dot-forward_0.71-1_i386 bug

NAME

       dot-forward - read a .forward file under qmail

SYNOPSIS

       in ~/.qmail: | dot-forward [ -nN ] file ...

OVERVIEW

       dot-forward  forwards  incoming  messages  according  to sendmail-style
       instructions in file, if file exists.  Normally file is .forward.

       WARNING: If you create a .qmail file to enable dot-forward,  make  sure
       to  add  a second line specifying delivery to your normal mailbox.  For
       example:

          |dot-forward .forward
          ./Mailbox

       COMPATIBILITY WARNING: dot-forward does not support :include:  or  mbox
       deliveries.   You  can  use  the  delivery  mechanism described in dot-
       qmail(5) instead.

OPTIONS

       -N   (Default.)  Read and forward a message.

       -n   Parse file and print the forwarding instructions in  it,  one  per
            line;  do  not  follow  the instructions.  You can use this option
            from the command line to  see  how  your  .forward  file  will  be
            interpreted:

               dot-forward -n .forward

FILE HANDLING

       When  a  message  arrives,  dot-forward  opens  file  and handles it as
       discussed below.  It exits  99,  so  qmail-local  will  ignore  further
       instructions in .qmail.  Exception: If file specifies delivery directly
       to  you,  dot-forward  exits  0,  so  qmail-local  will  read   further
       instructions in .qmail.

       If  file  does  not  exist,  dot-forward exits 0.  You can list several
       files; then dot-forward will try each one in turn, using the first  one
       that exists, or exiting 0 if none exist.

       COMPATIBILITY  WARNING:  dot-forward  treats an empty file as if it did
       not exist.  Versions  of  sendmail  before  V8  would  throw  away  the
       incoming message.

       COMPATIBILITY  WARNING:  If  dot-forward  encounters  a temporary error
       opening file, it exits 111, so that qmail-local will try  again  later.
       sendmail assumes incorrectly that file does not exist.

       COMPATIBILITY  WARNING:  file must be readable by dot-forward, which is
       normally running as the user.  sendmail places different constraints on
       its .forward permissions, since it is normally running as root.

FORWARDING

       Normally file contains an address.  dot-forward forwards the message to
       that address.

       The address is parsed as if it were  in  an  RFC  822  message  header.
       Parenthesized comments and bracketed addresses are permitted:

          bob (Bob, the postmaster) @heaven.af.mil

       Addresses with special characters must be quoted:

          "spaced out mailbox"@heaven.af.mil

       Address groups are not permitted.

       file  can  contain any number of lines, each line containing any number
       of addresses.  dot-forward forwards the message to each address:

          bob, fred, susan
          Joe Shmoe <shmoe@heaven.af.mil>

       An address  without  a  fully  qualified  domain  name  is  handled  as
       described  in  qmail-header(5).   Exception:  Certain addresses without
       domain names are handled specially, as described below.

DIRECT DELIVERY

       If an  address  does  not  contain  a  domain  name,  and  matches  the
       environment  variable  $USER  (without  regard  to  case), it specifies
       delivery directly to you.

       If  an  address  matches  $USER@$HOST  (without  regard  to  case),  it
       specifies delivery directly to you.

       COMPATIBILITY  WARNING:  sendmail's  handling of quotes and backslashes
       violates RFC 821 and RFC 822, and  is  not  supported  by  dot-forward.
       dot-forward  treats  \joe  the same way as joe.  The dot-qmail delivery
       mechanism lets each user manage several addresses, so there is no  need
       for a special syntax to get around forwarding.

COMMANDS

       If  an  address  does  not  contain  a  domain  name, and begins with a
       vertical bar, dot-forward takes the rest of the address as a command to
       run:

          bob, "|vacation bob"

       dot-forward   feeds  the  message  to  the  command,  preceded  by  the
       environment variables $UFLINE, $RPLINE, and $DTLINE.

       COMPATIBILITY WARNING: Internet addresses can legitimately start with a
       slash  or vertical bar.  dot-forward treats anything with an unquoted @
       as an address.  sendmail appears to have various problems  coping  with
       these addresses, and with commands that contain @ signs.

COMMENTS

       Any line in file that begins with # is ignored:

          # this is a comment

       COMPATIBILITY  WARNING:  Versions  of  sendmail before V8 did not allow
       comments in .forward files.

VERSION

       This   is   dot-forward   0.71.    The   dot-forward   home   page   is
       http://pobox.com/~djb/dot-forward.html.

SEE ALSO

       qmail-header(5), dot-qmail(5)

                                                                dot-forward(1)