1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329
|
Linux SMS Client 2.0.8 by (c) 1997,1998,1999 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 D1 TAP Supports multiple sends (see NOTE) |
| D2 UCP |
| EPLUS TAP Supports multiple sends (see NOTE) |
| AZCOM TAP Supports multiple sends (see NOTE) |
| CALLMAX TAP Supports multiple sends (see NOTE) |
| TELSTRA TAP Supports multiple sends (see NOTE) |
| VODAFONE proprietary UK/Australian Telenote services |
| VODAFONE_TAP TAP UK |
| 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 |
| BTEASYREACH TAP Currently in ALPHA and testing |
| SWISSCOM UCP Currently in ALPHA and testing |
| TELENOR UCP Currently in ALPHA and testing |
| HELLO Currently in ALPHA and testing |
| VOICESTREAM TAP Currently in ALPHA and testing |
| TELECOM NZ TAP Currently in ALPHA and testing |
| SKYTEL TAP Currently in ALPHA and testing |
| TELECOM NZ TAP Currently in ALPHA and testing |
+----------------------------------------------------------------------+
| CELLNET_WEB proprietary Currently in ALPHA and testing |
| ORANGE_WEB proprietary Currently in ALPHA and testing |
| PROXIMUS_WEB proprietary Currently in ALPHA and testing |
| ATT_WEB proprietary Currently in ALPHA and testing |
| NEXTEL_WEB proprietary Currently in ALPHA and testing |
| PAGENET_WEB proprietary 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.3.tar.gz
NOTE - Prior to version 1.3 of libmodem a patch was required, this is no
longer the case. To use libmodem instead of the builtin modem
handling routines edit 'Makefile.config'
To build the sms_client binary on Linux/Solaris:
sh configure
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 phones this is
| usually the telephone number,
| In some cases this must be
| written 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>
Michael Josephson <michael@josephson.org>
Dimitri Brukakis <dimitri.brukakis@omp.de>
Are Tysland <arety@dolphinics.no>
Petter Reinholdtsen <pere@td.org.uit.no>
Chris Berrington <chrisb@redac.co.uk>
Tim Ruehsen <TRuehsen@aol.com>
Gareth Abel <abelge@behp72.gpt.co.uk>
Jeff Duffy <jduffy@semcor.com>
Sergio Barresi <sbarresi@imispa.it>
matth <matth@labyrinth.net.au>
David Ockwell-Jenner <doj@nortelnetworks.com>
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 Australian Telenote service
using the VODAFONE driver to the patch contributor:
Jeremy Laidman <JLaidman@AUUG.org.au>
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 authors:
Massimo Nuvoli <massimo@nuvoli.to.it>
<adrieder@sbox.tu-graz.ac.at>
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>
Forward queries concerning VSTREAM
to the contributor:
doughnut <doughnut@doughnut.net>
Forward queries concerning NZ
to the contributor:
Robbie Poharama <robbiep@sequent.com>
Forward queries concerning SKYTEL
to the contributor:
Kal Kolberg <Kal.Kolberg@BassHotels.com>
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/
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
|