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