Return CGI Library
Return to CGI-Wrap

 NAME
      cgiwrap - CGI Wrapper for HTTPd WWW Server

 SYNOPSIS
      http://server:port/cgi-bin/cgiwrap?user=USERID&script=SCRIPTNAME
      http://server:port/cgi-bin/cgiwrap/USERID/SCRIPTNAME
      http://server:port/cgi-bin/cgiwrap/~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.

      (~/cgi-bin/ directory on BareMetal)

      server:port
           The server that the script is located on. Port is optional.

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

      USERID
           The userid 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 (UMR TEST WEB-SERVER)
      The following are instructions for setting up your directories and
      scripts for execution on UMR's test web server.

      The instructions are intended for use with AFS. It is assumed that you
      are familiar with writing CGI scripts and writing HTML documents for
      the WWW. If not, see one of the URL's listed at the bottom of this man
      page for more information.

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

      Create the directories needed to hold html documents and scripts

      1. cd

      2. mkdir cgi-bin

      Install the script into the cgi-bin directory, along with any related
      files.

      The script is executed using the following URL:

      http://www.baremetal.com/cgi-bin/cgiwrap/joeminer/email.pl

 NOTES
      Cgiwrap can be used with forms, but 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.

      I suggest installing 4 copies of cgiwrap into the servers cgi-bin
      directory.  (cgiwrap, cgiwrapd, nph-cgiwrap, nph-cgiwrapd) This will
      allow your 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. These 4 "versions" are present at BareMetal.


 FILES
      HTTPD/cgi-bin/cgiwrap ~USERID/cgi-bin/SCRIPTNAME

 AUTHOR
      Nathan Neulinger (nneul@umr.edu)

 SEE ALSO
      Mosaic, lynx

      http://sunsite.unc.edu/boutell/faq/www_faq.html
      http://hoohoo.ncsa.uiuc.edu
      http://www.ncsa.uiuc.edu/General/Internet/WWW/HTMLPrimer.html
      http://www.ncsa.uiuc.edu/General/Internet/WWW/HTMLQuickRef.html