File: README

package info (click to toggle)
smsclient 2.0.8r-7
  • links: PTS
  • area: main
  • in suites: potato
  • size: 1,440 kB
  • ctags: 1,284
  • sloc: ansic: 13,440; makefile: 507; sh: 433; perl: 161
file content (329 lines) | stat: -rw-r--r-- 12,493 bytes parent folder | download
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