README
上传用户:mei_mei897
上传日期:2007-01-05
资源大小:82k
文件大小:10k
- Linux SMS Client 2.0.7k by (c) 1997,1998 Angelo Masci
- =====================================================
-
- A simple UNIX client Allowing you to send SMS messages to mobile phones
- and pagers. The software currently supports a number of providers
- and protocols:
- +----------------------------------------------------------------------+
- | Service Protocol Notes |
- +----------------------------------------------------------------------+
- | CELLNET TAP Supports multiple sends (see NOTE) |
- | DETEMOBIL TAP Supports multiple sends (see NOTE) |
- | AZCOM TAP Supports multiple sends (see NOTE) |
- | TELSTRA TAP Supports multiple sends (see NOTE) |
- | VODAFONE proprietary |
- | ORANGE proprietary Supports multiple sends (see NOTE) |
- | Includes Hutchinson Pagers |
- | PAGEONE proprietary Supports multiple sends (see NOTE) |
- | MINICALL PAGEONE Supports multiple sends (see NOTE) |
- | ONE2ONE proprietary Supports multiple sends (see NOTE) |
- | VODAPAGE proprietary Block Mode supported |
- | VODACOM proprietary |
- | PTT/KPN Telcom proprietary Supports multiple sends (see NOTE) |
- | ANSWER proprietary |
- | MTN proprietary |
- | LIBERTEL proprietary Supports multiple sends (see NOTE) |
- | TIM proprietary Supports multiple sends (see NOTE) |
- | PROXIMUS proprietary |
- | AMPI TAP |
- | EUROPOLITAN CIMD Currently in ALPHA and testing |
- +----------------------------------------------------------------------+
- | SNPP* Currently in ALPHA and testing |
- | GENERIC* Currently in ALPHA and testing |
- +----------------------------------------------------------------------+
- Using an unlisted provider that allow TAP access should be quite straight
- forward.
- There are a large number of services that do not appear to use TAP
- but instead simple user interfaces for interactive use by a user dialing up
- with a modem. For several UK based services such as these I have written
- drivers, note that providers often offer more that one service and as such
- you may require a different driver for each one.
- NOTE - Services supporting 'multiple sends' allow the same message to
- be sent to several recipients with only a single connection
- having to be established, saving the cost of addition connection
- charges.
- It should be noted that ORANGE although allowing multiple
- sends does seem to limit them to a maximum of 3 messages per
- connection. Likewise, PTT/KPN Telcom has a limit of 2 messages
- per connection.
- NOTE - Protocols marked '*' are using ALPHA version drivers.
- SNPP support is limited as we don't currently have any SNPP
- servers to connect to other than 'snppd'. The GENERIC driver
- uses a script to connect to either modem based or tcp/ip based
- servers, it's still early days for this driver but is
- interesting to play with.
- SMS Client 2.0.7 can use the optional libmodem package written by
- Riccardo Facchetti. Prior to version 2.0.7 this package was a requirement
- to build and use the SMS Client. You can obtain it from sunsite.unc.edu in
- /pub/Linux/libs/ as libmodem-1.0.0.tar.gz
- If you use the libmodem package it is recommended that you obtain and
- install the libmodem-1.0.0.patch as this fixes an annoying bug in
- libmodem-1.0.0 that causes intermitent connection problems. SMS Client
- will still work without this patch but the reliability of several drivers
- will be compromised.
- NOTE - libmodem-1.1.tar.gz is a NEW release and it appears
- to be causing problems with SMS Client. Until these problems
- have been resolved please continue to use libmodem-1.0.0.tar.gz
- If you have difficulties finding libmodem-1.0.0 go to the
- WWW site hosting sms_client. Several WWW Addresses can be
- found at the end of this document.
- To build the sms_client binary on Linux/Solaris:
- sh configure.sh
- make ; make install
- NOTE - To build the sms_client binary under on a different Operating
- System copy the appropriate 'Makefile.config.OS' file from the
- config directory along with 'Makefile', rename the
- 'Makefile.config.OS' to 'Makefile.config' edit if necessary
- and run 'make ; make install'
- Example using the SMS Client:
- sms-client [SERVICE:]XXXXXXXX "Test Message 1" "Test Message 2" ...
- | | |
- | | +-- The message you
- | | want to send
- | | Maximum 150 Characters
- | |
- | +------------ Mobile or Pager ID
- |
- | For mobiles this is usually
- | the telephone number. In
- | international format.
- | ie. For UK Numbers remove leading
- | 0 and add 44 prefix
- |
- +---------------------- Optional SERVICE name
- You can use a simple address book file called sms_addressbook
- This is your global resource file, it should contain the name of
- your default service and possibly commonly used numbers. See the
- sms_addressbook file for examples. Any user can also create a local
- version of this file which should be placed in their home directory as
- .sms_addressbook The names are searched for in the user's local resource
- file and and finally the global resource file, this is so a user can
- override global names.
- The sms/sms_services file contains a list of services and the protocols
- that should be used when sending a message via that service.
- Each service must have a corresponding SERVICE file in sms/services,
- this file instructs the software which settings to use for the specified
- service, the service centre number to dial and additional comms parameters.
- A number of these service files exist and can be found in the sms/services
- directory.
- Configuring Drivers:
- You may want of modify the number of services that are supported
- by sms_client, you can do this simply by editing Makefile.config
- and adding or removing drivers from the DRIVERS line. You must then
- rebuild and install the sms_client binary. To obtain a list of drivers
- currently built into your binary simply type:
- sms_client -d
- Writing Drivers:
- This is much more straight forward than you may think. Take a look
- at src/driver/skeleton.c for an example driver.
- Return Values:
- On error sms_client WILL return some useful error codes so that you can
- determine what went wrong. For each message sent you receive output
- in the form:
- [ERROR] SERVICE:NUMBER "MESSAGE"
- The ERROR is set to 000 for successful delivery any positive value
- indicates there was a problem in delivery. See sms_error.h for description
- of values.
- If all messages were delivered successfully then sms_client returns 0
- any other value indcates one or more delivery problems occurred.
- Contributions:
- A New 'contrib' directory has been added which contains some useful
- scripts, at the moment we have:
- mail2sms (Andy Hawkins) - perl script for forwarding E-Mail via sms.
- www (David Usherwood) - WWW Frontend
- NOTE - These scripts were written for sms_client-2.0.5 and may not work
- correctly with this version as I have not tested them.
- Credits:
- I would like to express my thanks to the following individuals for
- their help in testing, hardware, debugging, support and general
- feedback:
- Mike Casella <mike@lines0.uwic.ac.uk>
- Guy William Hayton <guy@hayton.demon.co.uk>
- David Hill <dave@minnie.demon.co.uk>
- Chris Voce <cvoce@rcsuk.com>
- Frans Andersson <frans@concept.se>
- Jonathan M. Hunter <jon@ninja.ml.org>
- Geoff Peacock <geoff@ccmobile.com>
- Harald Milz <hm@seneca.muc.de>
- Job J. van Gorkum <JvGorkum@gbnetworks.com>
- Nick Andrew <nick@gidora.zeta.org.au>
- Jon Laughton <jon@eoin.demon.co.uk>
- Contrib Credits:
- Forward queries concerning 'mail2sms' perl script
- to the author:
- Andy Hawkins <andy@gently.demon.co.uk>
- Forward queries concerning 'mail2sms' shell script
- to the author:
- Matt Foster <matt@molnir.demon.co.uk>
- Forward queries concerning 'smsweb'
- to the author:
- David Usherwood <David_Usherwood@infocat.co.uk>
- Driver Credits:
- Forward queries concerning VODACOM and MTN
- to the author:
- Alf Stockton <stockton@fast.co.za>
- Forward queries concerning VODAPAGE 'verbose'
- to the author:
- Neil A. Hillard <hillardn@gkn-whl.co.uk>
- Forward queries concerning LIBERTEL
- to the authors:
- Henk Wevers <jhwevers@telekabel.nl>
- Aart Koelewijn <aart@mtack.xs4all.nl>
- Forward queries concerning TIM
- to the author:
- Massimo Nuvoli <massimo@nuvoli.to.it>
- Forward queries concerning PROXIMUS
- to the author:
- Mario Brackeva <mariob@jeeves.be>
- Forward queries concerning AZCOM
- to the contributor:
- Brad Smith <brad@figint.com>
- Forward queries concerning TELSTRA
- to the contributor:
- Paul Gampe <paulg@apnic.net>
- Forward queries concerning PTT
- to the contributor:
- Harold Baur <bo@bikerider.com>
- Forward queries concerning ANSWER
- to the contributor:
-
- Paul Andrew <PaulJ@Optimation.co.nz>
- Contact information:
- This Software is still considered BETA release. If you have any comments,
- problems, patches and improvements, please contact the author:
- Angelo Masci <angelo@styx.demon.co.uk>
- WWW Sites:
- http://www.styx.demon.co.uk/
- http://smsclient.home.ml.org/
- http://line0.uwic.ac.uk/~ac0412/sms_client/
- Mailing List:
- 'Mark Lewis' has kindly set up a mailing list for SMS Client.
- If you would like to join, send and email to 'majordomo@medusa.myth.co.uk'
- with the following text in the body of the message:
-
- subscribe sms_client
- Mark can be contacted via email at mark@mythic.net