home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / ISP / readme.wn < prev    next >
Text File  |  2009-11-06  |  6KB  |  149 lines
  1. Version: 1.14.5
  2.  
  3. WN is compiled  with GNU C v1.42 with the small subset of the TOP 
  4. OS-9 library (OS-9 v2.4/ISP v1.4). All my additions are between
  5. #define OS9/#endif keywords.
  6.  
  7. Note: I don't fully test the implementation, only in my local
  8. LAN environment with the following browsers:
  9. o Windows for Workgroups 3.11
  10.     - Netscape 2.01
  11.     - Netscape 2.02
  12.     - Netscape 3.0
  13.     - Microsoft Internet Explorer 2.01
  14.     - Microsoft Internet Explorer 3.0
  15.     - WebSurfer 4.6 (16 bit)
  16. o Unix (BSD/OS 2.1)
  17.     - Lynx Version 2-4-2. The bug: WN sends the text lines with CR
  18.       (\015) at end of line (as is standard for OS-9 comparing with
  19.       Unix's \012). Lynx doesn't replace it with space 
  20.       (all other navigators do).
  21.  
  22. I don't use the virtual-host option at all, so it is *fully* 
  23. untested (even uncompiled).
  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.
  30.  
  31. In this release I don't preserve the original directories, so, 
  32. if you need the full package, download it from the WN site by yourself.
  33.  
  34. The OSK directories are:
  35. o WN        the main directory (HTTPD server)
  36. o WNDEX     utility to create index-files
  37. o DOCS      copy of the original's WN DOCS directory, but with my own
  38.             CGI-scripts (written in C -> see /COUNTER), new images and so on
  39. o DEFS&LIB  small OS-9/Unix library
  40. o AUTHWN    the simplest program to use password-protected pages
  41.             (but I don't crypt the password file at all)
  42. o CMDS      executables
  43. o CGI_BIN   CGI CMDS directory
  44.  
  45. I compile WN in the 'inetd'-mode, so there are two small programms
  46. in CMDS (inetd, inetdc) I wrote to emulate the UNIX-inetd capability.
  47. (I heard, that Microware announce ISP v2.?? includes the full
  48. support of this capability, but only for OS-9 v3.0).
  49.  
  50. To start server, use the following steps:
  51.  load -d <path>/inetd
  52.  load -d <path>/inetdc
  53.  load -d <path>/wn
  54.  inetd <port> wn <wn options>, like this:
  55.     inetd 80 wn -a 0 -d -v ncsa -l log.log -L log.err /dd/HTML<>>>/nil&
  56. and have fun!
  57.  
  58. Note: because the path to the data files is compiled into WN
  59. (and you don't recompile it), you *must* set the data directory
  60. in the command line to WN (see docs), and may be use new OSK 
  61. related options -D & -I (see below). Also, you can set the full
  62. hostname (host.domain) with -h option, because ISP doesn't support
  63. DNS. Because WN works under User.Group=254.254 (for security
  64. purposes) all files in your data directories must have "public-read"
  65. bit set (or must be owned by 254.254).
  66.  
  67. P.S.
  68. WN widely uses 'perl'-scripts, so some examples wouldn't work.
  69. Using mshell don't resolve the problem, because Microware's mshell
  70. can't get redirected input (@#$%^&!). i.e, mshell script</file 
  71. doesn't work (I don't know, why). I rewrote some in C, but not all.
  72.  
  73. ---------- Changes to OSK version ----------
  74. From 22-Jul-96:
  75.  
  76. o CGI_BIN directory is now "CGI_BIN" instead of "CGI"
  77. o User home directory is now "PUBLIC_HTML" instead of "PUBLIC"
  78. o Changed all ocurrences of \l to \012 to be more portable
  79.   (thanks to Martijn Schipper)
  80. o Changed all occurences of '$' in filenames to '_'
  81. o Changed all /h0/... to /dd/.. in ../config.h
  82. o Removed some unrequired translations \n-->\l (translation 
  83.   required only in HTTP header's lines)
  84. o Added debug/log file locking in write_debug() & log_logfile()
  85. o Bug in wndex fixed - 'attr -pr' to index.html file
  86. o The CGI-HTML library is now the part of the OSK package
  87.   (see OSK/CGIHTML/DOCS/*)
  88.   This version supports file-upload forms (z.B, /EXAMPLES/upload.html),
  89.   only with Netscape version 2.x and above.
  90. o strstr() function is now in the os9.l library to be CGIHTML happy
  91.   (#undef NEED_STRSTR in ../config.h)
  92. o The file 'mime.types' is in $ROOT/CONF directory (a la APACHE server)
  93.  
  94. --
  95. o config.h - #define NEED_PUTENV/NEED_STRFTIME only in main section
  96. o CGI-HTML library: change all '-' to '_' in #include's statements for all
  97.   sources
  98.  
  99. --
  100. o WN version now: 1.14.6
  101. o Added DNS-lookup with resolv.l library
  102.   (need new in.h - see DEFS/NETINET/in.h near the end of file. These
  103.   macroses make the GNU C handle some functions in other way). 
  104.   inet_ntoa() is removed from util.c, now used the special thunk 
  105.   function from resolv.l. It is compiled with Microware's old
  106.   compiler (v3.2), so you can use it with UCC in backward compatibility
  107.   mode (you need the new netdb.h - see DNS/DEFS).
  108. o Added RFC931 support for client identification (at now, only Unix clients
  109.   support this feature). If you want it, just uncomment the "#define 
  110.   RFC931_TIMEOUT" in config.h
  111. o Tested TILDE_TABLE option to handle user directories in other way
  112.   (compiled as default)
  113. o Compiled with GNU C optimizations (-O), so the binaries are only
  114.   about 75k ;-)
  115.  
  116. --
  117. o DNS sources moved to separate OSK BIND package 
  118.  
  119. --
  120. o WN version now 1.16.1
  121. o Bug in MW's CIO module (we can't use putenv()/getenv() functions)
  122.   (so don't compile with -i option!)
  123.  
  124. --
  125. o WN version now 1.16.4
  126.  
  127. -- April 14, 1997
  128. o CGIHTML library moved to separate package, compiled under
  129.   Ultra C
  130. o Binaries are compiled without DNS resolving and RFC931 support
  131.  
  132. -- May 7, 1997
  133. o WN version now 1.16.7
  134. o New options in OS-9 version added (to help people to use 
  135.   precompiled binaries)
  136.   wn:  
  137.         -D <temp dir name>  (/dd/tmp as default)
  138.         -I <tilde table file path> (/dd/c/unid/wn/osk/conf/wn.dir.table)
  139.            See docs for details.
  140.   wndex: 
  141.         -M <mime types file path> (/dd/c/unid/wn/osk/conf/mime.types)
  142. --
  143.  
  144. Ilja V.Levinson, Russia
  145. e-mail: lev@odusv.oduurl.ru
  146.  
  147.  
  148.  
  149.