cgiwrap(1)
NAME
- cgiwrap, cgiwrapd, nph-cgiwrap, nph-cgiwrapd,
- php-cgiwrapd, php-cgiwrap
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,
- 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 dis
- tributed, cgiwrap is configured to run user scripts which are lo
- cated 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" directo
- ry. 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.
- 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 er
- ror 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/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.
AUTHOR
- This manual page was written by Karl M. Hegbloom <karl
- heg@inetarena.com> and modified by Pierre Machard <pmachard@de
- bian.org> for the Debian GNU/Linux system.
CGI