NAME
        cgiwrap - CGI Wrapper for HTTPd WWW Server

    SYNOPSIS
        http://server:port/cgi-bin/cgiwrap?user=USERNAME&script=SCRIPTNAME
        http://server:port/cgi-bin/cgiwrap/USERNAME/SCRIPTNAME
        http://server:port/cgi-bin/cgiwrap/~USERNAME/SCRIPTNAME

    DESCRIPTION
        Cgiwrap is a gateway program that allows users to
        use CGI scripts and HTML forms without compromising the
        security of the server. Scripts are run with the
        permissions of the user who owns the script. In addition,
        several security checks are performed on the script, which
        will not be executed if any checks fail.

        Cgiwrap is used via a URL in an HTML document. As
        distributed, cgiwrap is configured to run user scripts which
        are located in the ~/public_html/cgi-bin/ directory.

        server:port
            The server that the script is located on. Port is
            optional. Here at the University of Saskatchewan,
	    server should be www.usask.ca or homepage.usask.ca.

        cgi-bin
            The common cgi directory on the http server.

        USERNAME
            The username of the user who owns the script that is to
            be run

        SCRIPTNAME
            The actual filename of the script that is to be run.

    INSTRUCTIONS

	For www.usask.ca, see:
	    http://www.usask.ca/its/services/webpage_hosting/dept/tools/custom_scripts.php
	
	For homepage, see:
	    http://www.usask.ca/its/services/webpage_hosting/ind/ind_scripts.php

    NOTES
        When using cgiwrap keep in mind that the scripts run with
	the same privileges as you have.  A poorly written script
	has the potential to give anyone on the Internet access
	to your files.  If you do not understand how a script works,
	don't use it.

	You can debug your scripts using cgiwrapd instead of cgiwrap:

	http://homepage.usask.ca/cgi-bin/cgiwrapd/abc123/sample.pl

    FILES
        HTTPD/cgi-bin/cgiwrap ~USERNAME/public_html/cgi-bin/SCRIPTNAME

    AUTHOR
        Nathan Neulinger (nneul@umr.edu)

    SEE ALSO

        http://cgiwrap.sourceforge.net/