Things you have to decide before starting:

* The location of the qmail home directory, normally /var/qmail. The
qmsmac programs use several of qmail's control files so that they will
treat unqualified hostnames the same way as qmail-inject. (To change
this directory, edit conf-mailhome.h now.)

* The location of the qmsmac home directory, normally /var/qmsmac. This
is where the qmsmac programs and aliases will be installed. (To change
this directory, edit conf-home.h now.)

Security note: If any :include: file is user-owned, the user can see the
contents of any world-readable file accessible by your alias uid.


How to install:

 1. Create the formatted man pages, *.0:
       # make man
 2. Compile the programs:
       # make
 3. Create the qmsmac home directory:
       # make setup
 4. Copy your old /etc/aliases file to the qmsmac location:
       # cp /etc/aliases /var/qmsmac/etc/aliases
       # chmod 444 /etc/aliases
 5. Make sure there are no file or program deliveries in etc/aliases.
    (Include files are allowed.) See qmail-alias(8) for a description
    of qmail's mechanisms for file and program deliveries. For example,
    instead of
	    trashcan: /dev/null
    you can put /dev/null into ~alias/.qmail-trashcan.
 6. Make sure there aren't any \user addresses in etc/aliases. Under
    qmail, if you want a message to be delivered to joe's default
    mailbox, just touch ~joe/.qmail-direct and send the message to
    joe-direct.
 7. Compile the alias file:
       # /var/qmsmac/bin/newaliases
    Remember to run newaliases again whenever you change etc/aliases.
 8. Invoke qmsmac from ~alias/.qmail-default:
	    | /var/qmsmac/bin/qmsmac
    If qmail is already running, make sure to chmod +t ~alias before you
    edit ~alias/.qmail-default, and chmod -t ~alias after.


How to test:

 9. Check the expansion of postmaster@your.host:
       # env DTLINE=d SENDER=god@heaven.af.mil \
       RECIPIENT=postmaster@your.host /var/qmsmac/bin/qmsmac -n
    Replace your.host with your fully qualified domain name. Make sure
    to include the -n.
10. Check the expansion of other aliases in /var/qmsmac/etc/aliases.
11. Try sending a message to a few aliases.


That's it! To report success:
       % cat `cat SYSDEPS` | mail djb-qst@koobera.math.uic.edu
