home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / TELECOM / readme.wn < prev    next >
Text File  |  2009-11-06  |  3KB  |  86 lines
  1. Unpacking: There are four(4) zip-files in this archive (I zip-slit
  2. the whole wn.zip into 4 parts to simplify uploading over my slow
  3. IP-connection). Copy all wn?.zip files to your destination directory 
  4. and unzip it. 
  5.  
  6. WN is compiled  with GNU C v1.42 with the small subset of the TOP 
  7. OS-9 library (OS-9 v2.4/ISP v1.4). All my additions are between
  8. #define OS9/#endif keywords.
  9.  
  10. Note: I don't fully test the implementation, only in my local
  11. LAN environment with the following browsers:
  12. o Windows for Workgroups 3.11
  13.     - Netscape 2.01
  14.     - Microsoft Internet Explorer 2.0
  15. o Unix (BSD/OS 2.1)
  16.     - Lynx Version 2-4-2
  17.  
  18. It seems, all is intact. I can't to use keep_alive option,
  19. so compilation was with NO_KEEP_ALIVE #define.
  20. I don't use the virtual-host option at all, so it is *fully* 
  21. untested (even uncompiled). Also there are some problems with the
  22. log-files (locking), so they may be corrupted if 2 or more instances
  23. of wn are writing log.
  24.  
  25. Very hard trouble for me was the EOF-character. HTTP standard says,
  26. that alll strings should end with CRLF or just LF character, where
  27. CR is ASCII 13 & LF is ASCII 10. In Unix '\n' is ASCII 10 vs OS-9 '\l', 
  28. so I must change all ocurrences of the '\n' in the sources with 
  29. '\l' by hand. But I am not in the firm belief, that *all* ocurrences 
  30. are changed.
  31. For input purposes, I have separated chop() & fgets() functions for 
  32.  1) reading local files (that end with '\n') 
  33.  2) reading network (than end with '\l' or "\n\l"). 
  34. But this is very dirty...
  35.  
  36. I preserved all the original directories and all my patches are in
  37. the separate OSK directory. There are:
  38.  
  39. o WN        the main directory (HTTPD server)
  40. o WNDEX     utility to create index-files
  41. o DOCS      copy of the original's WN DOCS directory, but with my own
  42.             CGI-scripts (written in C -> see /COUNTER), 
  43.             new images and so on
  44. o DEFS/LIB  small OS-9/Unix library
  45. o AUTHWN    the simplest program to use password-protected pages
  46.             (but I don't crypt the password file at all)
  47. o CMDS      executables
  48.  
  49. I compile WN in the 'inetd'-mode, so there are two small programms
  50. in CMDS (inetd, inetdc) I wrote to emulate the UNIX-inetd capability.
  51. (I heard, that Microware announce ISP v2.?? includes the full
  52. support of this capability, but only for OS-9 v3.0).
  53.  
  54. To start server, use the following steps:
  55.  load -d <path>/inetd
  56.  load -d <path>/inetdc
  57.  load -d <path>/wn
  58.  inetd <port> wn <wn options>, like this:
  59.     inetd 80 wn -a 0 -d<>>>/nil&
  60. and have fun!
  61.  
  62. Note: because the path to the data files is compiled into WN
  63. (and you don't recompile it), you *must* set the data directory
  64. in the command line to WN (see docs). Also, you can set the full
  65. hostname (host.domain) with -h option, because ISP don't supports
  66. DNS.
  67.  
  68. P.S.
  69. WN widely uses 'perl'-scripts, so some examples wouldn't work.
  70. Using mshell don't resolve the problem, because Microware's mshell
  71. can't get redirected input (@#$%^&!). i.e, mshell script</file 
  72. don't work (I don't know, why). I rewrote some in C, but not all.
  73. By the way, it would be very interesting to port 'perl' to OS-9?!
  74.  
  75. At this moment (July, 10) John Franks released the new (1.14.4) version
  76. of this software with some bugs fixed. May be, I'll continue working...
  77. Yes, I have introduced this pathches to this release - they are #defined
  78. as PATCH4 (cgi.c, gsearch.c, err.h, chkcntrl.c, wn.h).
  79.  
  80. --
  81. Ilja V.Levinson, Russia
  82. e-mail: lev@odusv.oduurl.ru
  83.  
  84.  
  85.  
  86.