E-mail to SMS gateway version 1.0 by Andy Hawkins
-------------------------------------------------

This is a small perl script designed to provide an e-mail to SMS gateway,
using the SMS client written by Angelo Masci (angelo@styx.demon.co.uk).

INSTALLATION
------------

1. Install sms_client such that it is possible to send SMS messages.

2. Create a user (for example sms)

3. Place the mail2sms perl script in that user's home directory

4. Create a .forward directory in the users home directory, containing:

	"| /path/to/mail2sms || exit 75"

N.B. The exit 75 part tells sendmail to requeue the mail if the command
returns a non-zero exit status. This should never happen, but is worth
including to be safe.

USAGE
-----

To use the gateway, simply construct an e-mail message to the following
criteria:

1. The message should be to the user created ni step 2 of the INSTALLATION
procedures.

2. The subject of the message should contain the destination (either as an
alias, or a SERVICE:number pair)

3. The main body of the message is the text to send. The text can be split
across multiple lines. Processing of the text will end either with the word
'end' on a line by itself, or on finding the standard signature separator
'-- ' (note the space is important.

You should then receive an e-mail telling you if the message was sent
successfully or not. If the message failed, an indication of common reasons
for failure is given.

If you have any questions regarding the usage of this software, please feel
free to e-mail me at the address below.

Andy Hawkins
andy@gently.demon.co.uk
