README
上传用户:gzpyjq
上传日期:2013-01-31
资源大小:1852k
文件大小:9k
源码类别:

手机WAP编程

开发平台:

WINDOWS

  1. README for Kannel: Open Source WAP and SMS Gateway
  2. Abstract
  3. This README describes Kannel, the Open Source WAP and SMS gateway,
  4. and how it can be used and installed.
  5. Introduction
  6. The Kannel Open Source WAP and SMS gateway works as both an SMS
  7. gateway, for implementing keyword based services via GSM text
  8. messages, and a WAP gateway, via UDP. The SMS part is fairly
  9. mature, the WAP part is early in its development. In this release,
  10. the GET request for WML pages and WMLScript files via HTTP works,
  11. including compilation for WML and WMLScript to binary forms. Only
  12. the data call bearer (UDP) is supported, not SMS.
  13. Requirements
  14. You need a Unix-like operating system that supports Posix threads
  15. (pthreads.h). We use Red Hat Linux and Debian systems.
  16.     There is also support for the Cygwin 1.x POSIX.1 emulation layer
  17.     for the Win32 platforms using the pthreads-win32 library.
  18. You need GNU make, other make's tend not to work. For example,
  19. the FreeBSD and Solaris versions of make do not work. Check the
  20. version of your make with "make --version"; if it does not reply
  21. with "GNU Make version x.y.z", then it is not GNU make.
  22. On Solaris, you probably want to install gcc, GNU make and GNU
  23. binutils from www.sunfreeware.com.
  24. Documentation
  25. The user manual is in the doc/userguide directory and although it
  26. is not complete, explain almost all parts of Kannel. Developer
  27. documentation (currently very outdated) is in the doc/arch
  28. directory.
  29. In order to convert the documentation from DocBook (a markup
  30. language) to HTML and PostScript, you need some tools. On a
  31. Debian GNU/Linux system, install the package "docbook-stylesheets"
  32. and everything it depends on:
  33.     apt-get install docbook-stylesheets
  34.     
  35.      On a Red Hat Linux system, you need to install the following
  36. packages, in order:
  37. sgml-common
  38. psgml
  39. docbook
  40. stylesheets
  41. jade
  42. jadetex
  43. transfig
  44.      See http://www.rpmfind.net to find the packages.
  45. Then apply this change to /usr/share/texmf/web2c/texmf.cnf:
  46. hash_extra.jadetex = 15000
  47. hash_extra.pdfjadetex = 15000
  48. pool_size.jadetex = 500000
  49. pool_size.pdfjadetex = 500000
  50. string_vacancies.jadetex = 45000
  51. string_vacancies.pdfjadetex = 45000
  52. max_strings.jadetex = 55000
  53. max_strings.pdfjadetex = 55000
  54. pool_free.jadetex = 47500
  55. pool_free.pdfjadetex = 47500
  56. nest_size.jadetex = 500
  57. nest_size.pdfjadetex = 500
  58. param_size.jadetex = 1500
  59. param_size.pdfjadetex = 1500
  60. save_size.jadetex = 5000
  61. save_size.pdfjadetex = 5000
  62. stack_size.jadetex = 1500
  63. stack_size.pdfjadetex = 1500
  64.      On other systems, you'll have to figure it out yourself.
  65. Getting the gateway sources
  66. You can download the sources from
  67. http://www.kannel.3glab.org/download.shtml.
  68. Note that you also need the Gnome-xml library from
  69. http://xmlsoft.org/xml.html. That one probably requires zlib,
  70. depending on how it is configured. You need at least version
  71. 2.2.0
  72. Compiling and installing the gateway
  73. See the file INSTALL for generic installation instructions.
  74. The short form:
  75. ./configure
  76. touch .depend
  77. make depend
  78. make
  79. make bindir=/somewhere/suitable install
  80. See the User Guide (doc/userguide/ or
  81. http://www.kannel.3glab.org/userguide.shtml) for Kannel specific
  82. options to configure.
  83. For developers only: autoconf, configure, config.status, and Makefile
  84. We use the GNU autoconf tool to make it easier to adapt Kannel to
  85. each platform. The `autoconf' program reads the file configure.in,
  86. and generates a corresponding shell script called configure,
  87. which investigates the system it runs on to see what it supports
  88. and what it does not. configure then reads Makefile.in and
  89. config.h.in and writes out Makefile, config.h, and a shell
  90. script config.status.
  91. If you modify configure.in, you need to run autoconf.
  92. If you modify Makefile.in or config.h.in, you need to run
  93. config.status.
  94. If you modify any source files to add or change any header
  95. includes, you need to run "make depend".
  96. You always need to run "make" (which is the same as "make all").
  97. If you have trouble building things and suspect that there is a
  98. problem with the Makefile, run "make clean all". If that solves
  99. it, report it as a bug (see the end of this README).
  100. For developers only: adding new SMS Center protocol support
  101. As Kannel does not support all the SMSC protocols that exists,
  102. it might become necessary to add new kind of protocols, 
  103. including support to use mobile phones as SMSCes.
  104. When doing this, read interface specification in gw/smscconn_p.h.
  105. Drivers should stick to these rules as good as they can.
  106. For developers only: "make check"
  107. The Kannel Makefile contains a target called "check", which
  108. is used to run a series of automatic, non-interactive tests on
  109. various subsystems. 
  110. Each test program MUST stored in the `checks' subdirectory. Each
  111. test MUST be written either as a C program named `check_*.c'
  112. or a Bourne shell script named `check_*.sh'. The C programs are
  113. compiled by the Makefile, the shell scripts MUST be executable.
  114. The test programs MUST output nothing to stdout, and MUST use a
  115. zero exit code to indicate that the test was successful, and a
  116. non-zero exit code to indicate a failure of the test. This way,
  117. if one runs "make -s check", one can easily see which tests are
  118. run and which tests work.
  119. The test programs MUST output error messages to stderr and they
  120. MUST mention which test program and which subtest failed. In
  121. case of failure, they may leave log files or other auxiliary
  122. files, and these MUST be listed in the error messages to stderr,
  123. so that the user has a reasonable way to diagnose the error.
  124. The Makefile captures the stderr output to `check.log'.
  125. The tests SHOULD take a reasonable time, preferably less than
  126. fifteen seconds each. This way, one can run "make -s check"
  127. before each commit. If there is a need to run longer tests,
  128. then the tests need to be divided into fast and slow ones.
  129. These tests are meant to test whether subsystems mostly work,
  130. stress testing needs to be done separately, and tends to require
  131. testing against real applications.
  132. For developers only: Source tree organization
  133. The source tree is organized as follows:
  134. gateway root of source tree: some docs, no sources
  135. |-- contrib contributed extra material
  136. |-- doc documentation
  137. |-- gw the gateway itself
  138. |-- gwlib utility functions
  139. |-- test programs for testing the gateway
  140. `-- utils utility programs
  141. For developers only: WMLScript references
  142. WMLScript Specification
  143.       Wireless Application Protocol WMLScript Language
  144.       Specification Version 1.1 http://www.wapforum.org/
  145. WMLScript Standard Libraries Specification
  146.       Wireless Aplication Protocol WMLScript
  147.       Standard Libraries Specification Version 1.1
  148.       http://www.wapforum.org/
  149. RFC-2279 UTF-8, a transformation format of ISO 10646
  150. rfc/iana/assignments/character-sets
  151.       The official names for character sets that may
  152.       be used in the Internet and may be referred to in
  153.       Internet Documentation.
  154. ANSI/IEEE Std 754-1985
  155.       IEEE Standard for Binary Floating-Point Arithmetic.
  156.       Institute of Electrical and Electronics Engineers,
  157.       New York (1985).
  158. Configuring and running the gateway
  159. See the user guide in doc/userguide or on the web at
  160. http://www.kannel.3glab.org/doc.shtml.
  161. For test use, you can see sample configurations
  162. gw/smskannel.conf (SMS gateway) and gw/wapkannel.conf (WAP gateway).
  163. Using the gateway with a Nokia 7110
  164. To configure a Nokia 7110 to use the gateway, fill in the
  165. following (note that you need to provide your own dialup
  166. line):
  167. Home page: http://www.wapit.com/~liw/hello.wml
  168. (or any other WML page)
  169. Connection type: continuous
  170. Connection security: off
  171. Bearer: data
  172. Dial-up number: <your dialup line>
  173. IP address: <IP number of the host running bearer box>
  174. Authentication type: normal
  175. Data call type: <analog or isdn, depending on your line>
  176. Data call speed: 9600
  177. User name: <username for your dialup line>
  178. Password: <password for your dialup line>
  179. After you have modified the profile, activate it and load the
  180. home page. If you use the sample page above, you should see
  181. "hello, world" on the screen after a few moments.
  182. Modifications to old Kannel (0.8 and older)
  183. After release 0.8 Kannel architecture has been modified
  184. considerably, resulting changes in basic running of the standard
  185. WAP or WAP gateway.
  186. In new design, there is only one configuration file (to be more
  187. exact, you can have several of them, one for each kind of box,
  188. but that is advanced feature, which is not very usable) for
  189. bearerbox, smsboxes and wapboxes. Details of that file is in
  190. doc/userguide/newconf.txt.  As a quick reference, you just put
  191. all your old configuration files into same file, remove some
  192. rows and add 'group = xxx' variables into it.
  193. Moreover, there is no internal smsbox in new Kannel. So, when
  194. running SMS services you MUST run separate smsbox. This is most
  195. easily done with Kannel as daemon, launched with init.d. See
  196. utils/ directory for any supplied systems.
  197. Feedback and more information
  198. You may want to subscribe the announce and devel lists at
  199. kannel.3glab.org if you need help or want to participate in the
  200. development of Kannel. Send e-mail to
  201. announce-subscribe@kannel.3glab.org
  202. devel-subscribe@kannel.3glab.org
  203. (You'll get further instructions via automatic reply mails.)