cgiwrap, cgiwrapd, nph-cgiwrap, nph-cgiwrapd, php-cgiwrapd, php-cgiwrap

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 ... >

This manual page documents briefly the cgiwrap, cgiwrapd, php-cgiwrap, php-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/php-cgiwrap/cgiwrap.*". For more information about their use and format, please see the files themselves, the information printed during configuration that is enclosed in "/usr/share/doc/php-cgiwrap/README.Debian", and the example copies of them in "/usr/share/doc/php-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.

cgiwrap - the plain vanilla wrapper.

php-cgiwrap

- the wrapper with php support.

cgiwrapd

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

php-cgiwrap

- the debugging verion with php support. Script error debugging output is sent to the viewer.

nph-cgiwrap

- Non Parsed Headers version, without debug output.

nph-cgiwrapd

- nph with debugging.

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

This manual page was written by Karl M. Hegbloom <karlheg@inetarena.com> and modified by Pierre Machard <pmachard@debian.org> for the Debian GNU/Linux system.