

    Welcome to mod_cgisock V 0.4.2
    
    This is the pre production beta test series of mod_cgisock . Punish
    this module as best you can , I am looking for feedback on bugs 
    platform compatability issues and other annoyances . Bug squashing
    is moving at a reasonable pace with several gotchas and nasties being
    duly squashed.
    
    
    Installation -
    
	1) Grab a copy of Apache 1.3.x . So far, cgisock has been tested
	with 1.3.1 thru to 1.3.9. Dont try and use this module with the 2.0
	development series. It wont work ( yet ). Install the source code onto
	your system ( refer to the FAQ and the numerous quantities of docs
	oh how to do this ) . If you cant / havent / wont get apache , then
	just throw it in the /src/modules/extra directory of whatever
	apache you have and hope for the best .  
	
	2) Copy mod_cgisock.c to the directory
	
	/apache_source_path/src/modules/extra

	4) Change directory to the apache source path and configure apache 
	with
	
	    ./configure --add-module=src/modules/extra/mod_cgisock.c
	
	    Of course if there are any other directives that you may need
	to configure then add them as well . 

	5) Build the source code . If you dont know how to build the 
	source code then refer to the Apache INSTALL document for
	thourough discussions on building and installing apache.
	
	To configure apache when its built , add a declaration for
	a socket directory  by  adding a <Location > block as follows...
	
	    <Location /sockets>   # Or any directory ...
	    SetHandler cgi-socket
	    CgisockPath /var/tmp   # Dont use this path on production servers
	    </Location>
	    
	to httpd.conf in the Apache configuration .If you want use the test
	harness unmodified , then use the configuration line given above.
	In the location block any other regular authorization and access
	control configurations can be used to regulate who has access to this 
	dirctory .
	
	6) Start Apache and start the test_harness script as root.
	
	A note to Webmasters: The test_harness and printenv scripts
	are for test purposes only and represents a security risk if
	used in their default state ( using /var/tmp as a directory ).   
	 
	Use lynx or your favourite web browser to go to
	    
	    http://your.host.address/sockets/cgisock
	    
	    And you will get the cheesy little bit of advertising guff 
	thats in test harness. If it doesnt work then check the error
	logs for the server. If you get a permission denied, then 
	chances are that the script is not running as the apache user.
	Dont set your sockets so that they are world readable as this
	will cause a security hole.
	
	NOTE : THIS SOFTWARE IS PROVIDED 'AS IS' WITHOUT ANY FORM OF
	WARRANTY EXPRESSED OR IMPLIED . USE IT AT YOUR OWN RISK AND
	IN DOING SO YOU HEREBY RECOGNIZE THAT MICHAEL H. VOASE OR ANY
	CONTRIBUTORS TO THIS PACKAGE WILL NOT BE LIABLE FOR ANY DAMAGES
	FROM THE USE OR MISUSE OF THIS PACKAGE . 
	
	I also hereby grant that you may do whatever you wish with
	this package under the proviso that the above message and the 
	accompanying apache license is distributed with any derived
	packages , and that all resulting derivaties are also freely
	available and credit work attributable to Michael Voase in 
	accompanying copyrights . 
	
	But most of all, have fun ;).
	
    Cheers Mik Voase .
    

	
	    	    
