README
上传用户:mei_mei897
上传日期:2007-01-05
资源大小:82k
文件大小:10k
源码类别:

手机短信编程

开发平台:

Unix_Linux

  1.         Linux SMS Client 2.0.7k by (c) 1997,1998 Angelo Masci
  2.         =====================================================
  3.         
  4. A simple UNIX client Allowing you to send SMS messages to mobile phones 
  5. and pagers. The software currently supports a number of providers
  6. and protocols:
  7.   +----------------------------------------------------------------------+
  8.   | Service         Protocol      Notes                                  |
  9.   +----------------------------------------------------------------------+
  10.   | CELLNET         TAP           Supports multiple sends (see NOTE)     |
  11.   | DETEMOBIL       TAP           Supports multiple sends (see NOTE)     |
  12.   | AZCOM           TAP           Supports multiple sends (see NOTE)     |
  13.   | TELSTRA         TAP           Supports multiple sends (see NOTE)     |
  14.   | VODAFONE        proprietary                                          |
  15.   | ORANGE          proprietary   Supports multiple sends (see NOTE)     |
  16.   |                               Includes Hutchinson Pagers             |
  17.   | PAGEONE         proprietary   Supports multiple sends (see NOTE)     |
  18.   | MINICALL        PAGEONE       Supports multiple sends (see NOTE)     |
  19.   | ONE2ONE         proprietary   Supports multiple sends (see NOTE)     |
  20.   | VODAPAGE        proprietary   Block Mode supported                   |
  21.   | VODACOM         proprietary                                          |
  22.   | PTT/KPN Telcom  proprietary   Supports multiple sends (see NOTE)     |
  23.   | ANSWER          proprietary                                          |
  24.   | MTN             proprietary                                          |
  25.   | LIBERTEL        proprietary   Supports multiple sends (see NOTE)     |
  26.   | TIM             proprietary   Supports multiple sends (see NOTE)     |
  27.   | PROXIMUS        proprietary                                          |
  28.   | AMPI            TAP                                                  |
  29.   | EUROPOLITAN     CIMD          Currently in ALPHA and testing         |
  30.   +----------------------------------------------------------------------+
  31.   |                 SNPP*         Currently in ALPHA and testing         |
  32.   |                 GENERIC*      Currently in ALPHA and testing         |
  33.   +----------------------------------------------------------------------+
  34. Using an unlisted provider that allow TAP access should be quite straight 
  35. forward. 
  36. There are a large number of services that do not appear to use TAP
  37. but instead simple user interfaces for interactive use by a user dialing up
  38. with a modem. For several UK based services such as these I have written
  39. drivers, note that providers often offer more that one service and as such 
  40. you may require a different driver for each one.
  41. NOTE - Services supporting 'multiple sends' allow the same message to
  42.        be sent to several recipients with only a single connection 
  43.        having to be established, saving the cost of addition connection
  44.        charges.
  45.        It should be noted that ORANGE although allowing multiple
  46.        sends does seem to limit them to a maximum of 3 messages per
  47.        connection. Likewise, PTT/KPN Telcom has a limit of 2 messages
  48.        per connection.
  49. NOTE - Protocols marked '*' are using ALPHA version drivers.
  50.        SNPP support is limited as we don't currently have any SNPP
  51.        servers to connect to other than 'snppd'. The GENERIC driver
  52.        uses a script to connect to either modem based or tcp/ip based
  53.        servers, it's still early days for this driver but is
  54.        interesting to play with. 
  55. SMS Client 2.0.7 can use the optional libmodem package written by 
  56. Riccardo Facchetti. Prior to version 2.0.7 this package was a requirement
  57. to build and use the SMS Client. You can obtain it from sunsite.unc.edu in 
  58. /pub/Linux/libs/ as libmodem-1.0.0.tar.gz 
  59. If you use the libmodem package it is recommended that you obtain and 
  60. install the libmodem-1.0.0.patch as this fixes an annoying bug in 
  61. libmodem-1.0.0 that causes intermitent connection problems. SMS Client 
  62. will still work without this patch but the reliability of several drivers 
  63. will be compromised.
  64. NOTE - libmodem-1.1.tar.gz is a NEW release and it appears
  65.        to be causing problems with SMS Client. Until these problems
  66.        have been resolved please continue to use libmodem-1.0.0.tar.gz
  67.        If you have difficulties finding libmodem-1.0.0 go to the
  68.        WWW site hosting sms_client. Several WWW Addresses can be 
  69.        found at the end of this document.
  70. To build the sms_client binary on Linux/Solaris:
  71.         sh configure.sh
  72. make ; make install
  73. NOTE - To build the sms_client binary under on a different Operating 
  74.        System copy the appropriate 'Makefile.config.OS' file from the 
  75.        config directory along with 'Makefile', rename the 
  76.        'Makefile.config.OS' to 'Makefile.config' edit if necessary
  77.        and run 'make ; make install'
  78. Example using the SMS Client:
  79.         sms-client [SERVICE:]XXXXXXXX "Test Message 1" "Test Message 2" ...
  80.                        |         |         |
  81.                        |         |         +-- The message you
  82.                        |         |             want to send
  83.                        |         |             Maximum 150 Characters
  84.                        |         |                  
  85.                        |         +------------ Mobile or Pager ID
  86.                        |                       
  87.                        |                       For mobiles this is usually
  88.                        |                       the telephone number. In
  89.                        |                       international format.
  90.                        |                       ie. For UK Numbers remove leading
  91.                        |                       0 and add 44 prefix
  92.                        |
  93.                        +---------------------- Optional SERVICE name
  94. You can use a simple address book file called sms_addressbook 
  95. This is your global resource file, it should contain the name of
  96. your default service and possibly commonly used numbers. See the 
  97. sms_addressbook file for examples. Any user can also create a local 
  98. version of this file which should be placed in their home directory as 
  99. .sms_addressbook The names are searched for in the user's local resource 
  100. file and and finally the global resource file, this is so a user can 
  101. override global names.
  102. The sms/sms_services file contains a list of services and the protocols
  103. that should be used when sending a message via that service.
  104. Each service must have a corresponding SERVICE file in sms/services, 
  105. this file instructs the software which settings to use for the specified 
  106. service, the service centre number to dial and additional comms parameters.
  107. A number of these service files exist and can be found in the sms/services 
  108. directory.
  109. Configuring Drivers:
  110. You may want of modify the number of services that are supported
  111. by sms_client, you can do this simply by editing Makefile.config
  112. and adding or removing drivers from the DRIVERS line. You must then
  113. rebuild and install the sms_client binary. To obtain a list of drivers 
  114. currently built into your binary simply type:
  115. sms_client -d
  116. Writing Drivers:
  117. This is much more straight forward than you may think. Take a look
  118. at src/driver/skeleton.c for an example driver.
  119. Return Values:
  120. On error sms_client WILL return some useful error codes so that you can
  121. determine what went wrong. For each message sent you receive output
  122. in the form:
  123. [ERROR] SERVICE:NUMBER "MESSAGE"
  124. The ERROR is set to 000 for successful delivery any positive value
  125. indicates there was a problem in delivery. See sms_error.h for description
  126. of values.
  127. If all messages were delivered successfully then sms_client returns 0
  128. any other value indcates one or more delivery problems occurred.
  129. Contributions:
  130. A New 'contrib' directory has been added which contains some useful
  131. scripts, at the moment we have:
  132. mail2sms  (Andy Hawkins)    - perl script for forwarding E-Mail via sms.
  133. www       (David Usherwood) - WWW Frontend
  134. NOTE - These scripts were written for sms_client-2.0.5 and may not work
  135.        correctly with this version as I have not tested them.
  136. Credits:
  137. I would like to express my thanks to the following individuals for
  138. their help in testing, hardware, debugging, support and general 
  139. feedback:
  140. Mike Casella <mike@lines0.uwic.ac.uk>
  141. Guy William Hayton  <guy@hayton.demon.co.uk>
  142. David Hill <dave@minnie.demon.co.uk>
  143. Chris Voce <cvoce@rcsuk.com>
  144. Frans Andersson  <frans@concept.se>
  145. Jonathan M. Hunter <jon@ninja.ml.org>
  146. Geoff Peacock <geoff@ccmobile.com>
  147. Harald Milz <hm@seneca.muc.de>
  148. Job J. van Gorkum <JvGorkum@gbnetworks.com>
  149. Nick Andrew <nick@gidora.zeta.org.au>
  150. Jon Laughton  <jon@eoin.demon.co.uk>
  151. Contrib Credits:
  152. Forward queries concerning 'mail2sms' perl script
  153. to the author:
  154. Andy Hawkins <andy@gently.demon.co.uk>
  155. Forward queries concerning 'mail2sms' shell script
  156. to the author:
  157. Matt Foster  <matt@molnir.demon.co.uk>
  158. Forward queries concerning 'smsweb' 
  159. to the author:
  160. David Usherwood <David_Usherwood@infocat.co.uk>
  161. Driver Credits:
  162. Forward queries concerning VODACOM and MTN  
  163. to the author:
  164. Alf Stockton  <stockton@fast.co.za>
  165. Forward queries concerning VODAPAGE 'verbose'
  166. to the author:
  167. Neil A. Hillard <hillardn@gkn-whl.co.uk>
  168. Forward queries concerning LIBERTEL
  169. to the authors:
  170. Henk Wevers  <jhwevers@telekabel.nl>
  171. Aart Koelewijn  <aart@mtack.xs4all.nl>
  172. Forward queries concerning TIM
  173. to the author:
  174. Massimo Nuvoli  <massimo@nuvoli.to.it>
  175. Forward queries concerning PROXIMUS
  176. to the author:
  177. Mario Brackeva  <mariob@jeeves.be>
  178. Forward queries concerning AZCOM
  179. to the contributor:
  180. Brad Smith <brad@figint.com>
  181. Forward queries concerning TELSTRA
  182. to the contributor:
  183. Paul Gampe  <paulg@apnic.net>
  184. Forward queries concerning PTT
  185. to the contributor:
  186. Harold Baur <bo@bikerider.com>
  187. Forward queries concerning ANSWER
  188. to the contributor:
  189. Paul Andrew  <PaulJ@Optimation.co.nz>
  190. Contact information:
  191. This Software is still considered BETA release. If you have any comments,
  192. problems, patches and improvements, please contact the author:
  193. Angelo Masci <angelo@styx.demon.co.uk>
  194. WWW Sites:
  195. http://www.styx.demon.co.uk/
  196. http://smsclient.home.ml.org/
  197. http://line0.uwic.ac.uk/~ac0412/sms_client/
  198. Mailing List:
  199. 'Mark Lewis' has kindly set up a mailing list for SMS Client. 
  200. If you would like to join, send and email to 'majordomo@medusa.myth.co.uk'
  201. with the following text in the body of the message:
  202. subscribe sms_client
  203. Mark can be contacted via email at mark@mythic.net