nph-cgiwrap

NAME(CGIWRAP)                                                    NAME(CGIWRAP)



NAME
       cgiwrap, cgiwrapd, nph-cgiwrap, nph-cgiwrapd

SYNOPSIS
       Run user CGI programs with the ownership and group membership of a
       user, rather than that of the HTTP server.  It allows ordinary users to
       install and use their own private CGI scripts from their web pages.

       It is assumed that the user has already had an introduction to CGI and
       HTML.

       If joe has a web page located in "~joe/public_html/", and it is
       accessible via <URL:http://www.internet-host.edu/~joe>, then Joe can
       make a directory called "cgi-bin" under his "~/public_html", and place
       cgi programs in it.  They can be run from web pages by giving their
       location in the PATH_INFO, as shown:

       <form action="/cgi-bin/cgiwrap/joe/script"
       [script options] files ...  >
       <form action="/cgi-bin/cgiwrapd/joe/script"
       [script options] files ...  >
       <form action="/cgi-bin/nph-cgiwrap/joe/script"
       [script options] files ...  >
       <form action="/cgi-bin/nph-cgiwrapd/joe/script"
       [script options] files ...  >

DESCRIPTION
       This manual page documents briefly the cgiwrap, cgiwrapd, nph-cgiwrap,
       and nph-cgiwrapd wrapper commands.  It was written for the Debian
       GNU/Linux distribution (but may be used by others), because the
       original program does not have an ordinary manual page.  Instead, it
       has documentation in HTML format; see below.

       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.

       There are three configuration files, installed in "/etc/cgiwrap.*".
       For more information about their use and format, please see the files
       themselves, the information printed during configuration that is
       enclosed in "/usr/doc/cgiwrap/README.Debian", and the example copies of
       them in "/usr/doc/cgiwrap/examples" directory.  If any of these
       configuration files does not exist, it will not be used.  So to disable
       "cgiwrap.allow" checking, just `rm` or `mv` the file.

OPTIONS
       cgiwrap - the plain vanilla wrapper.

       cgiwrapd
              - the debugging version.  Script error debugging output is sent
              to the viewer.

       nph-cgiwrap
              - Non Parsed Headers version, without debug output.

       nph-cgiwrapd
              - nph with debugging.

SEE ALSO
       The programs are documented by the author in the HTML files you will
       find in "/usr/doc/cgiwrap/htdocs/" which should be available via
       dwww(1) , <URL:http://localhost/doc/cgiwrap/htdocs/> or
       <URL:file:/usr/doc/cgiwrap/htdocs/index.html> , using lynx(1) or any
       other HTML viewer.

AUTHOR
       This manual page was written by
       Karl M. Hegbloom <karlheg@inetarena.com>
       for the Debian GNU/Linux system.



1                                   SECTION                      NAME(CGIWRAP)