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)