1From stonewall.demon.co.uk!nigel Wed Mar  8 09:46:56 1995
2Return-Path: <nigel@stonewall.demon.co.uk>
3Received: by greenie.muc.de (/\==/\ Smail3.1.24.1 #24.2)
4	id <m0rmHNf-0003lzC@greenie.muc.de>; Wed, 8 Mar 95 09:46 MET
5Received: from post.demon.co.uk ([158.152.1.72]) by colin.muc.de with SMTP id <25595-1>; Wed, 8 Mar 1995 03:00:04 +0100
6Received: from stonewall.demon.co.uk by post.demon.co.uk id aa09109;
7          8 Mar 95 1:31 GMT
8From: Nigel Whitfield <nigel@stonewall.demon.co.uk>
9Date: Wed, 8 Mar 1995 02:07:08 +0100
10In-Reply-To: Gert Doering's message 'Re: Email to gax gateway' of Tue 3 Jan
11Reply-To: Nigel Whitfield <nigel@stonewall.demon.co.uk>
12X-Mailer: Mail User's Shell (7.2.5 10/14/92)
13To: Gert Doering <gert@greenie.muc.de>
14Subject: E-mail to fax gateway - instructions
15Message-ID: <9503080107.aa20588@fags.stonewall.demon.co.uk>
16Status: RO
17
18Gert,
19
20This is a little late, but it appears to work reasonably well. It's
21not been extensively tested, but I've had no problems in casual use.
22
23The information below should be sufficient for people; I can give
24limited support via nigel@stonewall.demon.co.uk
25
26General information:
27
28This is a mail to fax gateway, designed to work with mgetty and MMDF
29on a SCO Unix system (ODT 3.0). It might well be possible to make it
30work with other systems, but it was a quick and dirty hack.
31
32It's designed to allow you to send a message to, for example
3301818061048@fax, using your ordinary mail program, and will turn the
34text of the message into a fax. If a global alias is set up, you can
35use an address like nigel@fax
36
37A header page will be generated with a brief explanatory note, and the
38date, subject and sender of the fax. A recipient name will be used if
39one is present in the global fax alias file.
40
41A log of faxes processed is sent to the fax administrator, and a
42receipt is sent to the originator when
43
44There is not a huge amount of checking in the code, and it may not
45stand up to heavy use. Use at your own risk. I'll give what help I
46can, but if you've fiddled with MMDF, or you run a different mail
47transport you're probably on your own.
48
49Note that there is no checking in this script to see if people are
50authorised to use your system for faxing. If you want authorisation,
51use the MMDF facilities.
52
53Nigel
54
551 - the fax channel
56The system relies on creating a passive channel in MMDF, which just
57leaves messages in a queue directory where they can be picked up by a
58program later.
59
60My domain is stonewall.demon.co.uk, and machines are hidden within
61that domain.
62
63Add the following lines to /usr/mmdf/mmdftailor (I put them between
64the SMTP channel and the local domain table):
65
66--- cut here
67;
68; Mail to fax gateway
69;
70MTBL	faxchn, file=fax.chn, show="Fax gateway"
71MCHN	fax, show="Mail to fax gateway", ap=same, mod=psv,
72	tbl=faxchn
73--- ends
74
75You also need to create the fax.chn file in /usr/mmdf/table:
76
77--- cut here
78fax.stonewall.demon.co.uk:
79--- ends
80
81And you can put a line in domain.dom like this:
82
83--- cut here
84fax: fax.stonewall.demon.co.uk
85--- ends
86
87Don't forget to run dbmbuild when you've made the changes
88
89
902 - the fax gateway script
91
92Install the faxgate script as something like /usr/mmdf/bin/faxgate.
93
94If you have a pretty standard SCO installation, you shouldn't need to
95change anything more than $faxsender and $faxadmin
96
97I won't pretend this is an elegant perl script, but it does the job.
98If you have a different mail transport, you'll need to hack the bit
99that opens the MMDF queue file and extracts the information from it.
100
101Note that we don't attempt to extract a Reply-To field or anything
102fancy - the address used for returning information is the envelope
103address.
104
1053 - Making it all work
106
107Create a crontab entry for MMDF to run the faxgate script
108periodically. Messages are not sent directly - they are simply placed
109in the fax queue, and will be sent whenever that is run.
110
1114 - Things to do
112
113* Make it understand mail messages that contain a PostScript document
114* Add authorisation lists
115* Look for a Reply-To: header
116* Find an elegant way of setting the recipient name on the header page
117* Make it less dependent on MMDF
118* Write proper documentation
119
1205 - Copyright
121I wrote this software, and it's my copyright. But you can distribute
122it freely, for use with Gert Doering's mgetty program. If you want to
123use it as the basis of non-commercial software, you're welcome to,
124provided you keep a credit of some type. If you change the software,
125I'd welcome details of your changes so that the software can be kept
126up to date.
127
128Nigel.
129
130
131--
132[Nigel Whitfield                                 nigel@stonewall.demon.co.uk]
133[For details on the uk-motss mailing list mail uk-motss-request@dircon.co.uk]
134[******  All demon.co.uk sites are independently run internet hosts   ******]
135
136