english.txt

一个通用的Web服务器源程序

+-------------------------------+
|                               |
|   Son hServer   v. 0.2.0.95   |
|                               |
+-------------------------------+
     a small home WWW server

           FREEWARE

System requirements
-------------------
80386 CPU or higher.
OS Windows 95/98/ME or Windows NT/2000/XP.
Windows Sockets 2 or newer (check it only
under Win95 or old NT versions; others
contain Winsock 2 as a system part).
For functioning as Internet server
an Internet connection [of course] is
required (on test time not necessary).

Purpose
-------
  Son hServer is intended for work as WWW
(HTTP) Internet or intranet server. It can
also be used to test websites on a local
machine before uploading to remote server.
  Son hServer is a web server with simpli-
fied control. It's made generally for use
under Win9x family systems (Windows 95/98/
ME). NT family systems (Windows NT/2000/XP)
are also supported. But author consider
senseless running this server on NT family
systems because there are servers especial-
ly intended for these systems such as IIS.

Features
--------
  Son hServer serves client requests on a
standard HTTP port (80). Main web document
types, multimedia, VRML models, archives
and other files are supported. When recei-
ving request on directory names without
terminating forward slash (/) the redirect
to right address is generated. Server mess-
ages ("resource not exist", "access denied"
etc.) are being created as plain text
(Content-Type: text/plain) in english lang-
uage. HTTP/1.1 protocol is supported (mini-
mal instruction set).
  Files with "hidden" and "system" attribu-
tes are not client-accessible.
  NOT SUPPORETED: CGI, ISAPI, Java serv-
lets and other kinds of server program pro-
cessing; PHP and web bots; conditional
requests; access limitations for different
users; remote administration; HTTP methods
PUT, POST, DELETE, TRACE, CONNECT.
  Two or more commas following each other
in file paths are interpreted as one comma
(e.g. /file..ext will be processed as
/file.ext)
  INTERFACE is multilingual (yet english
and russian). Real-time monitoring of con-
nections, requests and errors statistics is
possible. Customizable event logging (save
in log file).


    ********************************
    ***       USER'S GUIDE       ***
    ********************************

1. Server start and termination

  Server begins working immediately after
program start. Any option changes (see
"Options..." button) are applied immedia-
tely after clicking "OK" button in "Ser-
ver options" dialog. Launching windows
("About program", "Server options")
doesn't stop server work梚t's continuing
to serve requests.
  Server stops when closing program win-
dow. If You don't like seeing working
server on your desktop please minimize it
into taskbar but do not close.

2. Site viewing

  If active Internet connection exists
then You can view your site from any
inet-connected machine by typing follow-
ing URL in web browser:
 http://YOUR_IP/
where YOUR_IP is your current IP address
(to see it launch "Run program" system
window and there enter winipcfg). If You
have a registered domain then view site
as usually: URL with Your domain.
  In intranets situation is analogous to
described above.
  If NO active Internet or intranet con-
nection exist then use following address
in web browser:
 http://localhost/
Be aware that it works only when server
is running.

3. Recommendations on logging

  Logging options are located in "Server
options" window on "Logs" tab. Program
writes log file in its dir, it's named
hserver.log
  I would recommend not to set without
necessarity checkbox "client request
headers" in "Save in log file informa-
tion on:" group. It's because this pro-
duces very large log files.
  Log file "growing" speed can also be
decreased by unchecking "requested
files (paths)" and (for popular sites)
"connections" checkboxes. However, all
is under administrator's will :)

4. How to begin

  First check the server: run it, then
open web browser and enter address
 localhost
Be glad looking at disk C contents in
hypertext form :) This is for You to
be assured that server truely works.
  Create anywhere a folder (e.g.
C:\WWWRoot) where should be placed
Your site. Even more better is to use
separate disk volume for this purpose.
  Then in server click "Options..."
button and instead of "C:" enter your
created folder's path in "Server root
path" field. Now nobody from Net can
access Your disk C because access is
limited to Yours specified root folder
(and its subfolders).
EXAMPLE:
  Let's advise, You've created folder
  C:\MyShared\HTTPfiles
  and specified it as a server root
  Now file C:\Windows\notepad.exe
  is inaccessible to site visitors;
  file C:\Secrets\My coctail.doc
  is also inaccessible for them,
  as files C:\Windows\Me.pwl
  C:\MyShared\LocalNet\gamelist.txt
  and C:\MyShared\nicegirl.avi
  File C:\MyShared\HTTPfiles\wow.htm
  is accessible under URL
  http://YOURIPORDOMAIN/wow.htm
  File C:\MyShared\HTTPfiles\pict.gif
  is accessible under URL
  http://YOURIPORDOMAIN/pict.gif
The server root is not required to
be on disk C. You may specify root
in any part of file system, e.g. on
CD-ROM or other machine in a local
network.
  Another recommendation: uncheck
in options a checkbox "Show catalog
contents when no index file exist"
(except, maybe, sites-WebBBSs). BUT
do it only after you're assured the
server works.

5. Comments on performance

  The minimal CPU signed in require-
ments is 80386. However for Internet
server Pentium or higher is better.
For organisation inner intranet i486
can be enough but I would recommend
at least early Pentium or compatible
(K5 et al.)
  Generally request serving speed
depends from connection speed. For
big (very big!) speeds with many
requests it may depend from file
system speed. So do not damn PII
when you have 28k modem and it is
one in all local network :) And
remember: high speed modem doesn't
save you if provider is slow :)

***      END OF USER'S GUIDE       ***
**************************************


OK, I understand that user's guide is
scarce. But interface's intuitive un-
derstandable; old friend Experiment
will help non-experienced users.


       *** APPENDIX A ***
 List of recognisable file extensions
 and their server-associated content-
 types

Files with extensions not present in
this list are being transmitted by
server with content-type
application/octet-stream

    htm  html  shtm  sht  shtml  dhtm  dht  dhtml
        xhtm  xht  xhtml  phtm  pht  phtml
       text/html
    xml  xsl
       text/xml
    txt  ans  rus  nfo  me  log
       text/plain
    js
       text/javascript
    vbs
       text/vbscript
    gif
       image/gif
    jpg  jpe  jfif  jpeg
       image/jpeg
    png
       image/png
    tiff  tif
       image/tiff
    xbm
       image/x-xbitmap
    art
       image/x-jg
    bmp
       image/bmp
    ivf
       video/x-ivf
    qt  mov
       video/quicktime
    avi
       video/avi
    enc  mpg  m1v  mpa  mpe  mpeg  mpv2
       video/mpeg
    asf  lsf  asr  asx  lsx
       video/x-ms-asf
    vdo
       video/vdo
    aiff  aif  aifc
       audio/aiff
    au  snd
       audio/basic
    wav
       audio/wav
    hta
       application/hta
    rar
       application/x-rar-compressed
    doc  wiz  dot
       application/msword
    xls  xlb
       application/vnd.ms-excel
    ppt  pps  pwz  ppa  pot
       application/vnd.ms-powerpoint
    pdf
       application/pdf
    fdf
       application/vnd.fdf
    cab
       application/x-compressed
    iii
       application/x-iphone
    ins  isp
       application/x-internet-signup
    mhtml  mht  eml  nws
       message/rfc822
    pfx  p12
       application/x-pkcs12
    prf
       application/pics-rules
    ra  rm  rmm  ram
       audio/x-pn-realaudio
    rts
       application/x-rtsl
    spl  swf
       application/futuresplash
    wrz  vrml  wrl
       model/vrml
    it  xm  s3m  stm  mod  dsm  med  ult
        mm  669  mp3  mp2  mp1
       audio/mpeg
    m3u  pls
       audio/x-mpegurl
    zip
       application/x-zip-compressed
    p10
       application/pkcs10
    cat
       application/vnd.ms-pki.seccat
    pko
       application/vnd.ms-pki.pko
    p7r
       application/x-pkcs7-certreqresp
    p7s
       application/pkcs7-signature
    exe
       application/x-msdownload
    crt  der  cer
       application/pkix-cert
    spc  p7b
       application/x-pkcs7-certificates
    uls
       text/iuls
    p7m  p7c
       application/pkcs7-mime
    stl
       application/vnd.ms-pki.stl
    crl
       application/pkix-crl
    wsc  sct
       text/scriptlet
    323
       text/h323
    rmi  mid  midi
       audio/mid
    vcf
       text/x-vcard
    cdf
       application/x-cdf
    sst
       application/vnd.ms-pki.certstore
    htt
       text/webviewhtml

Please report author of any mistakes
in list or incorrect content-type
assigning by server.


      *** APPENDIX B ***
 How to rule own website on own
 hom