                    vshttpd Frequently Asked Questions

Table of Contents

      *  1. General/Software Feature Questions
	 - 1.1 What do I need to build this software on Solaris?
	 - 1.2 What do I need to build this software on ***BSD?
	 - 1.3 What do I need to build this software on Linux?
	 - 1.4 Do I need root permission to run vshttpd?
      *  2. Errors and problems
         - 2.1 Why does vshttpd return 404 Not Found?
	 - 2.2 Why does vshttpd return 500 Internal Server Error?
	 - 2.3 Why is some of the CGI output missing?
	 - 2.4 Why is vshttpd only listening on IPv6 on ***BSD?

1. General/Software Feature Questions
     _________________________________________________________________

   1.1 What do I need to build this software on Solaris?

          You will need a c99 compiler (Sun Studio, gcc, etc), and gmake.
     _________________________________________________________________

   1.2 What do I need to build this software on ***BSD?

          You will need a c99 compiler (gcc, clang, etc), and gmake.
	  And also you may want to use the noipv6 target on the
	  command line ex, make noipv6
     _________________________________________________________________
     
   1.3 What do I need to build this software on Linux?
   
         You will need a c99 compiler and make.
     _________________________________________________________________

    1.4 Do I need root permission to run vshttpd?

    	No, but you will have to run it on a non standard port.
     _________________________________________________________________

2. Errors and problems

     _________________________________________________________________

    2.1 Why does vshttpd return 404 Not Found?

    	Is there a index.html in the root directory/directory?
	Are you using virtual hosts?, if so then in the document root
	 should have a directory for each virtual host:
	 $ ls /path/to/docroot
	 example.com	www.example.com	ww1.example.com
	 $
    ___________________________________________________________________
 
   2.2 Why does vshttpd return 500 Internal Server Error?

       Check the log.
    ___________________________________________________________________

   2.3 Why is some of the CGI output missing?

       Check to make sure the CGI script is outputting the CGI headers.
       The CGI script should output something like:
        Content-Type: text/html\r\n\r\n
    ___________________________________________________________________

   2.4 Why is vshttpd only listening on IPv6 on ***BSD?
   
       BSD does not have a shared IPv4/IPv6 stack, compile with 
        gmake noipv6 to disable IPv6 support
    ___________________________________________________________________
