home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / vptcp110.zip / README.TXT < prev    next >
Text File  |  1996-06-07  |  4KB  |  150 lines
  1. TCP/IP Toolkit for Virtual Pascal
  2. =================================
  3.  
  4. Version 1.05
  5. Copyright 1996 Antony T Curtis.
  6. All rights reserved.
  7.  
  8.  
  9. INSTALLATION
  10. Simply run the INSTALL.CMD file provided.
  11.  
  12. This version fixes the problem with incompatible
  13. unit file versions and the (unofficial) internal
  14. linker problems in the 1.01 betas.
  15.  
  16. INTRODUCTION
  17. I've converted some C TCPIP files for use with Virtual Pascal.
  18. Currently, the translation is incomplete, but I hope to have
  19. converted the whole set of C header files into Units and
  20. Includes. When I have the time, I'll be putting updates on to
  21. the Virtual Pascal FTP site and on my own site.
  22.  
  23.  
  24.  
  25. DISCLAIMER
  26. There is absolutely no warranty with these files... If you
  27. screw up, it's your own problem. You may use and spread the
  28. source code supplied as long as all the comments are left
  29. as is. This toolkit may only be distributed as a whole set.
  30.  
  31.  
  32.  
  33. REQUIREMENTS:
  34.         OS/2 TCPIP v2 or
  35.         OS/2 Warp IAK or
  36.         OS/2 Warp Connect/TCPIP v3
  37.  
  38.         Virtual Pascal v1.0+ for OS/2
  39.  
  40.  
  41.  
  42. INFORMATION
  43. I would appreciate it if my name is left in the source code.
  44. You need not mention me in your software, but it would be
  45. very nice if you would, maybe as a footnote in the Docs ;)
  46.  
  47. If you have any improvements, or comments, please feel free
  48. to send me an email.
  49.  
  50. As an aside, I'm also going to make some "programmer friendly"
  51. units to hide the nasties of these librarys...
  52.  
  53. Included is a Virtual Pascal help file (SOCKETS.VPH).
  54.  
  55.  
  56. PROGRAMMING INFO
  57.  
  58. The Sockets library:
  59.         SOCKETS.INT SOCKETS.VPI SOCKETS.OBJ
  60.  
  61.     For the available api, please examine the SOCKETS.INT
  62.     file.
  63.  
  64. Please examine the supplied example files:
  65.  
  66.         FINGERD.PAS     FINGERD.EXE
  67.                 A simple functional Finger Daemon.
  68.  
  69.         TELNETD.PAS     TELNETD.EXE
  70.                 A simple not very functional
  71.                 Telnet Daemon.
  72.  
  73.     Please note: both these programs now use the port
  74.     database to determine what port to use.
  75.  
  76.     I've tidyied up the way Port numbers... In traditional
  77.     *nix code, functions such as htons() are used to convert
  78.     the endian of the port numbers - this messyness is
  79.     handled within the unit, eliminating onw source of
  80.     possible confusion/bugs.
  81.  
  82.     The port numbers returned in the GetServiceByName
  83.     function are already processed.
  84.  
  85.     As illistrated in the TELNETD.PAS, multi-threading
  86.     is possible with this socket library.
  87.  
  88.     I'am still trying to develop a tidier method, which
  89.     probably won't be very unix-like.
  90.  
  91. N.B.
  92.         Several structures have been renamed in this
  93.       library to conform to the TP naming convention.
  94.  
  95.         Original C name   |   Sockets Library name
  96.         ==========================================
  97. Types     sockaddr        |   TSockAddr
  98.           sockaddr_in     |   TSockAddr_in
  99.           hostent         |   THostEnt / PHostEnt
  100.           servent         |   TServEnt / PServEnt
  101.                           |
  102. Procs     socket()        |   Sock_New()
  103.           soclose()       |   Sock_Close()
  104.           bind()          |   Sock_Bind()
  105.           listen()        |   Sock_Listen()
  106.           accept()        |   Sock_Accept()
  107.           send()          |   Sock_Write()
  108.           recv()          |   Sock_Read()
  109.           getservbyname() |   GetServiceByName()
  110.           getservbyport() |   GetServiceByPort()
  111.           getprotbyname() |   GetProtocolByName()
  112.           getprotbynum()  |   GetProtocolByNumber()
  113.  
  114.  
  115.         This list is not comprehensive.
  116.         Most of these calls are documented on the
  117.         online help.
  118.  
  119.  
  120. HISTORY
  121.   1.04  Simpler installation. Added Select() call.
  122.         Docs not done, due to work on v2.00
  123.   1.03  Added the online help. Tidied up some code.
  124.   1.02  Sorted out the Port numbering system, to make it
  125.         easier.
  126.         Added additional functions from netdb.h
  127.   1.01  Tidier than 1.00
  128.   1.00  First attempt. Basically, a direct port of
  129.         socket.h with a few bits from types.h
  130.  
  131.  
  132.  
  133. THINGS TO DO
  134.  
  135.         Port the rest of the tcpip librarys.
  136.                 ftpapi.h, hameser.h, etc...
  137.  
  138.         Perhaps make a multithreaded class version.
  139.  
  140.         Write a proper programmer's manual, maybe
  141.         as an addon to the Virtual Pascal's help system.
  142.  
  143.  
  144.  
  145. CONTACTING THE AUTHOR
  146.  
  147.         email:  ssu95atc@rdg.ac.uk
  148.         www:    http://nuts.ml.org/
  149.  
  150.