NAME:
-----

  cgiwrap - CGI Wrapper for HTTPd WWW Server


SYNOPSIS:
---------

  Normal Calling
  http://www.flex.com/cgi-bin/cgiwrap/USERID/SCRIPTNAME

  DEBUG Calling
  http://www.flex.com/cgi-bin/cgiwrapd/USERID/SCRIPTNAME


DESCRIPTION:
------------

  CgiWrap is a gateway program that allows general users to use CGI
  scripts and HTML forms without compromising the security of the http
  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.  

  USERID (see use in SYNOPSIS above)

      The userid of the user who owns the script that is to be run.

  SCRIPTNAME (see use in SYNOPSIS above)

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



INSTRUCTIONS:
-------------

  The following are instructions for setting up your directories and
  cgi scripts for execution on FlexNet's web server.

  It is assumed that you are familiar with writing CGI scripts and writing
  HTML documents for the WWW. If not, then get yourself educated. Don't
  depend on FlexNet to educate you. Experiment, experiment.

  For this example, the script is "email.pl". The user id is "keoki".
  -------------------------------------------------------------------

  1. Create a folder i.e. directory called "cgi-bin" in your public_html web folder:

	~keoki/public_html/cgi-bin

  2. Install your script into this cgi-bin directory, along with any
     other related files.
  
  3. Now your cgi script is executed using the following URL:

  	http://www.flex.com/cgi-bin/cgiwrap/keoki/email.pl
				or
	http://www.myvirtualdomain.com/cgi-bin/cgiwrap/keoki/email.pl

  4. If your program isn't working, then debug it like this:

	http://www.flex.com/cgi-bin/cgiwrapd/keoki/email.pl


NOTES:
------

  Our PERL interpreter is located at /usr/bin/perl.

  Cgiwrap can be used with forms, and it is suggested that you use the
  "POST" method. If you use the "GET" method you will need to add two
  hidden fields to your form containing the user and script name. "GET"
  types requests are discouraged in any case due to the limited amount
  of data that can be passed to the script.

  Four copies of cgiwrap are installed in FlexNet's WWW cgi-bin directory
  (cgiwrap, cgiwrapd, nph-cgiwrap, nph-cgiwrapd). This allows users to run
  almost any kind of script. The two ending in "d" will display debugging
  output which is a great aid when writing CGI scripts as you usually
  can't see the output of your script if it screws up.