home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 10 / AU_CD10.iso / Archived / Games / PD_Games / overcast.arc / !JFShared / ISvcs / !Help
Text File  |  1997-02-05  |  4KB  |  105 lines
  1.                                 InternetServices
  2.                                 ================
  3.  
  4. Version 1.07 (05 Feb 1997)
  5.      
  6. Introduction
  7. ------------
  8. Whilst learning the ins and outs of writing Internet software I found one
  9. sadly missing section of the SWI interface. Although we have calls to decode
  10. and encode host addresses, there is none to decode and encode services and
  11. ports. For my SocketLib I wrote a pair of basic routines to perform this,
  12. using the FreeNet and Acorn services files as the standard I would decode.
  13. These routines, whilst doing the job, were very slow. Therefore, I've
  14. re-written the code in Assembler and bunged it in a module. Much nicer :-)
  15.  
  16. Since I got fed up with the really pathetic error messages that the sockets
  17. interface kept giving me I decided to expand this by adding error number to
  18. text conversion. Nicer still :-)
  19.  
  20. And because I really don't like droping down to basic to read the error
  21. numbers or service names, I've added some *Commands to help.
  22.  
  23.  
  24. Usage
  25. -----
  26. Obviously, no programs will benefit currently from this module, as I've only
  27. just written it. However, to those of you who wish to use it, the StrongHelp
  28. manual provided should give you details enough to be able to write using it.
  29.  
  30. OSCLI Commands :
  31.   *Inet_DecodeError <number> - display the textual version of the error
  32.                                code
  33.   *Inet_ServiceByPort <port> - decode the service name and it's aliases
  34.   *Inet_ServiceByName <service> - decode the service number
  35.  
  36.  
  37. Disclaimer
  38. ----------
  39. The author accepts no responsibility for any problems which this application
  40. may cause or loss of data resulting in its use. This application is Public
  41. Domain Freeware. This means that it may be distributed, so long as no charge
  42. other than copying costs are charged for it.
  43.   
  44.  
  45. Source code
  46. -----------
  47.    This program requires the !JFPatch pre-assembler to make the code. This is
  48. a simple text-to-basic assembler which takes a text assembler file, makes a
  49. basic program from it to assemble, assembles it and returns any errors. It is
  50. available from Justin Fletcher's website (users.essex.ac.uk/users/gerph) or
  51. directly by mailing to Gerph@essex.ac.uk.
  52.    All source code and the resultant module must be distributed together.
  53.  
  54.  
  55. Contact
  56. -------
  57. Any comments, queries, donations or bug reports can be sent to Justin
  58. Fletcher at :
  59.  
  60. E-Mail : Gerph@essex.ac.uk
  61. URL    : http://users.essex.ac.uk/users/gerph
  62. IRC    : On #Acorn as Gerph
  63. Finger : finger jrflet@postman.essex.ac.uk
  64. Tel    : (01842) 813979
  65.  
  66. Snail Mail :
  67.     Justin Fletcher
  68.     “Galadriel”
  69.     17b Cromwell Road,
  70.     Weeting,
  71.     Brandon,
  72.     Suffolk.
  73.     IP27 0QT
  74.  
  75.  
  76. History
  77. -------
  78. Version 1.00 : 26 Sep 1996
  79.                Could only read lines out of the services file. Alias code
  80.                unfinished.
  81.  
  82. Version 1.01 : 26 Sep 1996
  83.                Alias code re-written. Crashed when alias comments encountered
  84.  
  85. Version 1.02 : 26 Sep 1996
  86.                Alias code works, tied in to Internet_GetServiceByPort, which
  87.                now works.
  88.  
  89. Version 1.03 : 26 Sep 1996
  90.                Internet_GetServiceByName now works correctly. Fixed alias
  91.                code to return 0 if no aliases are present.
  92.  
  93. Version 1.04 : 28 Sep 1996
  94.                Minor bug in ReadUnsigned for the port number fixed - should
  95.                ignore malformed numbers.
  96.  
  97. Version 1.05 : 02 Dec 1996
  98.                Added the DecodeError SWI to make life even easier.
  99.  
  100. Version 1.06 : 09 Dec 1996
  101.                Added the *Inet_DecodeError and *Inet_Service* commands.
  102.  
  103. Version 1.07 : 05 Feb 1997
  104.                Added CreateMenu SWI.
  105.