1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/tests/README	Fri Sep 26 17:05:23 2008 +0200
     1.3 @@ -0,0 +1,37 @@
     1.4 +Here a two test programs: local.sh and smtpout.sh. They both send
     1.5 +three mails, using different options. Run them from within this
     1.6 +directory, preferably NOT as root, but you got to have write
     1.7 +permission for this directory.
     1.8 +
     1.9 +local.sh sends mail accepted from stdin and sends them to a fake local
    1.10 +mailbox, using your login name. If it works, there should be a file
    1.11 +named with your login name with the mails. You can look at it with cat
    1.12 +or less, or with an ordinary mail program.
    1.13 +
    1.14 +smtpout.sh sends mail accepted from stdin and sends them to your local
    1.15 +MTA, so use it only if you have an MTA running on your box (sendmail,
    1.16 +exim, qmail or whatever, or masqmail when you have it already
    1.17 +installed). If it works, you should get three mails.
    1.18 +
    1.19 +The scripts assume that your login name corresponds to your mailbox
    1.20 +(quite probable) and that your MTA listens on port 25 with the
    1.21 +interface which corresponds to the hostname as returned by the shell
    1.22 +command "hostname" (without quotes...), also very probable. They are
    1.23 +created with make from test.templ. They use a special configuration
    1.24 +(test.conf) for masqmail, which is also created with make from
    1.25 +conf.templ.
    1.26 +
    1.27 +Two log files, masqmail.log and debug.log will also be created within
    1.28 +this directory. They may give some information if anything went wrong.
    1.29 +
    1.30 +If the log files reveal that your MTA is not willing to relay, you may
    1.31 +have to qualify the hostname: Say
    1.32 +
    1.33 +sed s/RECV_HOST/foo.bar.com/ test.templ > smtpout.sh
    1.34 +
    1.35 +where you set your fully qualified host name for foo.bar.com.
    1.36 +
    1.37 +If they do not work, there could be some problem with either the test
    1.38 +programs, the configuration file or masqmail itself. If you have
    1.39 +installed masqmail successfully and these scripts do not work, do not
    1.40 +worry too much :-).