home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsf / gsm / GSM / README < prev    next >
Encoding:
Text File  |  1995-06-10  |  3.2 KB  |  73 lines
  1. GSM pager gateway code
  2. ----------------------
  3.  
  4. This code is copyright Nicko van Someren 1995.  You may use it and freely
  5. distribute it for non-profit purposes but it may not be used as the basis
  6. of a commercial service without the prior writen consent of the author.
  7. An exception to this is the 'chat' program and the parts of the 'sendpage'
  8. program based on the chat program which which are writen by Karl Fox
  9. of MorningStar and are in the public domain.
  10.  
  11.  
  12. This code provides a set of tools for queuing short text messages and sending
  13. then to a Short Messaging Service on a GSM telephone.  There is also code
  14. to allow email to be redirected to the messaging service and a cgi-bin 
  15. program to send messages from a World Wide Web server.  The code is made up
  16. of a number of C programs, Shell scripts and Python programs.  If you do
  17. not have the Python language then you should and you can get a copy from
  18. ftp://ftp.cwi.nl/python/src/python1.2.tar.gz
  19.  
  20. The distribution consists of the following code:
  21.  
  22.     callpager    A shell script to be run by cron to send the messages.
  23.     chat.c        A C program that talks to you modem.
  24.     pagemail.py    A python script to send an email message to a pager.
  25.     pager.py    A python script to run on a WWW server.
  26.     pagerq.c    A trivial program to count the message queue.
  27.     phonebook    A template phone book for the python scripts
  28.     qpage.c        A C program to put a messgae into the queue
  29.     sendpage.c    A C prpgram to send queued messages to the GSM network.
  30.  
  31. The callpager script will most likely need modifying for talking to your
  32. modem.  The script needs to be run by root on most systems in order to
  33. open the serial port corectly.  The script does nothing if there are
  34. no messages on the pager queue.
  35.  
  36. The chat program is useful for reseting your modem after messages have
  37. been sent if you use the modem for incoming calls as well as outgoing
  38. ones.
  39.  
  40. The pagemail program takes a mail message on the stdin, pulls off the
  41. headers and make a pager message out of the From: header, the Subject:
  42. header and the body of the message.  It should be called from your mail
  43. aliases file with the address book user name as a parameter, e.g.:
  44.  
  45. nicko-pager:    "|/usr/local/etc/GSM/pagemail.py nicko"
  46.  
  47. The pager.py program should be placed in the cgi-bin directory on a WWW
  48. server.  It will display a form to fill in for sending a message,
  49. do some checks on the message and send the message to the queue.  A menu
  50. listing the users in the phonebook file gives the user a quick way
  51. to send messages to known users.
  52.  
  53. The pagerq program just opens the directory used for the message queue
  54. and counts the messages.
  55.  
  56. The Phonebook file consists of lines of two whitespace separated fields,
  57. a user name (matched case insensitive) and a telephone number.
  58.  
  59. The qpage program places a pager message in the queue.  Files in the queue
  60. directory begining with a '.' and not considered to be queue so the file
  61. move opereation is used as an atomic way to put a file into the queue.
  62.  
  63. The sendpage program is used to chat to the modem to connect to
  64. the SMS gateway and then send the messages down the line.  It is derived
  65. from the chat program and doubtless has many bugs it if because of me.
  66. It is not very good at dealing with error back from the SMS gateway.
  67.  
  68. If you have any fixes or comments then email me:
  69.  
  70. Nicko@ant.co.uk
  71.  
  72.  
  73.