home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / web213w2.zip / web.doc < prev    next >
Text File  |  1999-04-28  |  9KB  |  234 lines
  1. Web/2 v1.3w2 (c) 1998-1999 dink ( http://dink.org )
  2.  
  3. What is Web/2?
  4. ^^^^^^^^^^^^^^
  5. Web/2 is a Web server (HTTPD as the unix folks know it) for OS/2 v3.0 or
  6. newer.  It uses separate threads for each connection so everything is fast
  7. plus it's very easy to configure and supports both FAT and HPFS filesystems.
  8.  
  9. (please read the "whats new" section, because some features in that section
  10. aren't mentioned anywhere else!)
  11.  
  12. Whats New?
  13. ^^^^^^^^^^
  14. - 1.3w2 -
  15. 1: fixed a bug in redirection with keepalive
  16.  
  17. - 1.3w -
  18. 1: added $QUERY_STRING html variable.  example, put $QUERY_STRING in your
  19.    html file (example filename: blah.html) then load up
  20.    http://localhost/blah.html?this_is_a_test and $QUERY_STRING will be replaced
  21.    with "this_is_a_test"
  22. 2: fixed a bug that caused 404 not found on one particular proxy server
  23.  
  24. - 1.3v6 -
  25. 1: Couldn't send files from a cd-rom drive or other read-only media (fixed)
  26. 2: No longer sends a filelisting of /cgi-bin/ (idea by p0ing, says it might be
  27.      a security risk)
  28. 3: Made the date format nicer in the web/2 style logfile/compatible w/all
  29.      countries :)
  30. 4: Removed url-minder ignore from textcounter (incompatibilities w/javascript)
  31. 5: More code optimizations, removed and rewrote redundant code
  32. 6: Overflow error in getstr() (was accessing string[-1], eek!)
  33. 7: <host> hostname would get chopped short if name was long
  34. 8: Now compiled with VP/2 2.0 beta 3! (http://www.fprint.co.uk/vpascal)
  35.  
  36. - 1.3v5 -
  37. 1: Added support for umlaut characters in the file-list
  38. 2: Fixed a problem with the OS/2 and Web/2 "uptime" html-tags reporting
  39.    weird values after 24 days.
  40. 3: Sped up/Optimized some routines
  41. 4: Weird CGI's can no longer corrupt the Web/2 window
  42. 5: Fixed a possible RunTime error 216 (it would very rarely, if ever, happen)
  43. 6: Added support for Streaming MP3's (.M3U files)
  44. 7: New "Powered by Web/2!" icon, thanks to Bin-x on irc.  Check out sample.zip
  45. 8: Added a web e-mail cgi!  Check out email.doc in sample.zip
  46.  
  47. - 1.3v4 -
  48. 1: Fixed a result code in the CGI routines which prevented some scripts to
  49.    run properly
  50. 2: Added caching routines to the resolver, this should speed up things a bit!
  51. 3: Fixed a bunch of small bugs & optimized code
  52. 4: Made it so you can easily upgrade your web/2 when new versions are
  53.    released! (just unzip this package to your web/2 dir and voila!)
  54.  
  55. - 1.3v3 -
  56. 1: Fixed up the file/directory list, it doesn't use %20 for spaces anymore,
  57.    so files with spaces will look normal to the client
  58. 2: Added referer, browser & cgi requests to ncsa/apache style logfile
  59.  
  60. - 1.3v2 -
  61. 1: The /redirect/ feature would screw up on MS IE 4.0 browsers, fixed
  62.  
  63. - 1.3v -
  64. 1: Added NCSA/Apache style logfile option (run setup.exe to turn it on/off)
  65.    *note* if you run any log analyzer program, be sure to delete your web.log
  66.    after switching to the ncsa/apache style logfile.
  67. 2: Cleaned up some code
  68.  
  69. - 1.3u -
  70. 1: Fixed PATH_TRANSLATED in the cgi routines (thanks to Ltning for reporting
  71.    the bug!)
  72. 2: Added HTTP_REFERER and several other env. variables to the cgi routines
  73. 3: Removed unneeded debugging code
  74.  
  75. - 1.3t -
  76. 1: Fixed a problem with WebExplorer not being able to do CGI Posts
  77. 2: Fixed several misc. bugs
  78.  
  79. - 1.3s -
  80. 1: Added SSI commands: <!--#exec cgi=""--> and <!--#include virtual=""-->
  81. 2: Web/2 will display "notfound.htm" if it exists, instead of the default
  82.    "File not found" message
  83. 3: Web/2 now supports directories under the cgi-bin directory
  84. 4: Sped up the cgi routines
  85. 5: Added support for virtual hosting via IP
  86.  
  87. - 1.3r -
  88. 1: Fixed some more problems with the aliasing, everything should work OK
  89.    now
  90. 2: New feature to send a file list if no index.htm/index.html exists
  91.    (see web.cfg for the option to toggle this on/off)
  92. 3: Multiple textcounters!  Each .htm/.html file can have its own <textcounter>
  93.    now
  94. 4: Web/2 can now resume transfers (HTTP/1.1 "Range:" command support)
  95. 5: The html, cgi-bin and icons directory can now be set via web.cfg
  96. 6: Added virtual domain hosting support
  97. 7: Misc bug fixes
  98. 8: Wrote a nice setup program (setup.exe) to go along with Web/2!
  99.  
  100. - 1.3o -
  101. 1: Better support for sub-directories under aliased directories
  102.  
  103. - 1.3n -
  104. 1: Improved/Optimized the cgi code
  105. 2: Added a "url redirection" feature ex:
  106.    http://www.yoursite.com/redirect/http%3A//dink.org
  107.    (this is usefull if you'd like to see who uses your links :)
  108.  
  109. - 1.3k -
  110. 1: Fixed a bug that caused some log entries to get corrupted
  111. 2: Released 1.3k publically
  112.  
  113. - 1.3j -
  114. 1: Made the socket send() blocksize configurable via web.cfg
  115. 2: Added some new SSI codes, <referer>, <webversion>, <blocksize>, <sysuptime>,
  116.    <web2uptime> and <connections> - check out stat.htm
  117. 3: Added logging of "Browser" and "Referer"
  118.  
  119. - 1.3f -
  120. 1: Better support for directories under \web\html
  121. 2: Misc. bug fixes and speed improvements
  122. 3: Added a config file (web.cfg) instead of commandline parameters
  123.    (no more command line options!  everything is now in the web.cfg file
  124.    though a web port specified on the command line will override the
  125.    port in the config!)
  126. 4: Added some CGI env. variables which were somehow left out
  127.  
  128. - 1.3 -
  129. 1: Web/2 will no longer consume 100% cpu when 'detaching' it.
  130. 2: Added html ssi tags <date> <time> <time24h> <ip> <host> and <browser>,
  131.    refer to index.htm for examples.
  132. 3: CGI Scripting support (check out page.htm and the stuff in the cgi-bin dir)
  133. 4: Misc. bugfixes & speed enhancements.
  134.  
  135. Upgrading from a previous version
  136. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  137. Unzip this package into your Web/2 directory, then run setup.exe to
  138. automatically update your web.cfg with any new option(s).
  139.  
  140. Up and Running!
  141. ^^^^^^^^^^^^^^^
  142. Just unzip it into a directory, like c:\web, make a dir under c:\web
  143. called html, then copy all of your html/image/whatever files into
  144. c:\web\html.  If you are using pkunzip, make sure you use the -d option!
  145.  
  146. If you'd like to try the sample Web/2 pages, unzip sample.zip
  147.  
  148. Run setup.exe to configure Web/2, then create a program icon on your desktop
  149. with the following settings: (assuming c:\web is where you unzipped web/2)
  150.  
  151. Path and Filename: c:\web\web.exe
  152. Working Directory: c:\web
  153.  
  154. Specifying a port number as a parameter will override the port number in
  155. Web/2's configuration.
  156.  
  157. Note:
  158. If you're using HPFS and would like to use index.html instead of index.htm
  159. for the index file, edit the alias.cfg and remove the entry for index.htm!!
  160.  
  161. If you are using F.A.T. file allocation
  162. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  163. You may use alias.cfg to alias your file names to whatever you want!
  164. Example: you can alias super-long-filename.html to blah.htm, you can even
  165. alias directories!
  166. (edit alias.cfg with your favorite text editor for details..)
  167.  
  168. Neat feature!
  169. ^^^^^^^^^^^^^
  170. In your html file(s), you can include "<textcounter>" anywhere in the
  171. file to use the built-in textcounter.  If you want to change the number
  172. of hits your page has received, edit counter.dat :-)
  173. For an example of how to use the textcounter, look at the enclosed index.htm
  174. file.
  175.  
  176. Virtual Hosting How-To
  177. ^^^^^^^^^^^^^^^^^^^^^^
  178. Have all your domain names you wish to host point to the IP of the OS/2
  179. Machine you plan on running Web/2 on, then edit the alias.cfg and set up
  180. each domain.  Say, the domain name is "www.blah.com", and the directory with
  181. the html files is "c:\hosting\blah" - all you need to do is add a new line to
  182. the alias.cfg containing: "c:\hosting\blah virtual:www.blah.com" and voila!
  183.  
  184. Web/2 can also do virtual hosting via IP (IE: if each host has a different IP,
  185. on the same machine)  In the alias.cfg, instead of specifying a domain name,
  186. specify the IP instead.
  187. Example alias.cfg entry: "c:\hosting\blah virtual:127.0.0.1"
  188. (opinion mode)
  189. This method is compatible with the ancient HTTP standards and wastes IP
  190. addresses..  I can't think of a single web browser that doesn't support the
  191. "Host: <hostname>" (HTTP/1.1) token.
  192. (opinion mode off)
  193.  
  194. URL Redirection
  195. ^^^^^^^^^^^^^^^
  196. The reason for this feature is so you can log who visits the links on your
  197. page.  An example would be...
  198.  
  199.   Without redirection:
  200.     <a href="http://www.blah.com/bob/index.htm">Bob's page</a>
  201.  
  202.   With redirection:
  203.     <a href="/redirect/http%3A//www.blah.com/bob/index.htm">Bob's page</a>
  204.  
  205. Keep in mind, use %3A instead of a : (notice in the example above), to
  206. maintain compatibility with all web browsers.
  207.  
  208. Restrictions & Limitations
  209. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  210. 1: Aliases don't work under virtual hosts
  211. 2: The cgi-bin, icons and virtual includes dirs under virtual hosts are
  212.    the same as a non-virtual host
  213. 3: The "startup" directory of cgi's is the same dir as web.exe. 90% of the
  214.    cgi's i've tested worked flawlessly, the other 10% worked with a small
  215.    modification.
  216.  
  217. Notes & Stuff
  218. ^^^^^^^^^^^^^^^
  219. Web/2 is freeware, if you'd like to send me a postcard, that would be most
  220. excellent.  Please e-mail me for my mailing address :-)
  221.  
  222. Bug reports, comments & "help" are welcome, please e-mail me at:
  223.   http://dink.org/email
  224.  
  225. Greets go out to: (in no particular order)
  226.  
  227.   #bats, #os2...
  228.   Ananda
  229.   Ltning
  230.   Rosmo
  231.   Pete Moylan (for his wonderfull FTP server)
  232.   Tiny
  233.   ..other people I can't think of at this time..
  234.