
                           shellver  0.0.2
                      written by Radovan Garabik

What it is
--------------------------

shellver is a small WWW server written in bash script.
It is probably the smallest WWW server in the world. It could be made even
smaller, if you take out support for directory listing and testing for
non-existent files (heck, it will be only 8 lines long then :-)).
I wrote it in order to prove to a friend that I can write a web server :-)
Note that I am not an expert in bash programming, so there are quirks and
things which could have been written better.
However, it does what it is supposed to do. It might be useful if
you want just to look at html file from time to time.
Note: use this primarily for educational purposes, do not use it as your
WWW-server, if you are really connected to Internet! If you want small 
and lightweight server, I recommend boa (http://www.boa.org).


Where to get it
--------------------------
http://www.dnp.fmph.uniba.sk/~garabik/shellver.html
The link might change, in that case try to look at my 
homepage at http://www.dnp.fmph.uniba.sk/~garabik/
My e-mail is garabik@fmph.uniba.sk


Features
--------------------------
 - Servers html files :-)
 - Runs from inetd
 - Can execute files and serve their output (sort of cgi support)
 - Small


Drawbacks
--------------------------
 - No logfile (but logging is possible via tcpd)
 - No users' directories
 - Only very basic cgi support 
 - Slow


Bugs
--------------------------
 - Only GET method is supported
 - No error handling
 - Directory listing is really lame
 - shellver does not implement HTTP protocol correctly
 

CGI support
--------------------------
CGI support is very basic. If the requested file you has an extension .cgi, it
will be executed and it output will be served. It is not possible to supply
the cgi-script with arguments.


Security
--------------------------
It is as secure as a nobody/nogroup bash script can be. 
Access to other directories is not restricted, so if you have somewhere
setuid root program with extension .cgi then you might have a problem :-)
 
 
Status
--------------------------
Public domain. Do what you want to do with it :-). 
However, if you base your application on it, it would be nice to mention me
somewhere in the documentation.


Warranty
--------------------------
None.


Credits
--------------------------
Thanks to Petr Hudec (PeHaSys) for helping with awk.


