1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
.TH NAME CGIWRAP SECTION 1
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
.B cgiwrap, cgiwrapd, nph-cgiwrap, nph-cgiwrapd
.SH 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.
.PP
It is assumed that the user has already had an introduction to CGI and
HTML.
.PP
If
.I 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:
.PP
.B <form\ action="/cgi-bin/cgiwrap/joe/script"
.br
.I "[script options] files ..."
.B >
.br
.B <form\ action="/cgi-bin/cgiwrapd/joe/script"
.br
.I "[script options] files ..."
.B >
.br
.B <form\ action="/cgi-bin/nph-cgiwrap/joe/script"
.br
.I "[script options] files ..."
.B >
.br
.B <form\ action="/cgi-bin/nph-cgiwrapd/joe/script"
.br
.I "[script options] files ..."
.B >
.SH "DESCRIPTION"
This manual page documents briefly the
.BR cgiwrap,
.B cgiwrapd,
.B nph-cgiwrap,
and
.B 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
.B HTML
format; see below.
.PP
.B 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.
.PP
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.
.PP
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.
.SH OPTIONS
.B cgiwrap
- the plain vanilla wrapper.
.TP
.B cgiwrapd
- the debugging version. Script error debugging output is sent to the
viewer.
.TP
.B nph-cgiwrap
- Non Parsed Headers version, without debug output.
.TP
.B nph-cgiwrapd
- nph with debugging.
.SH "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
.IR dwww(1)
,
.IR <URL:http://localhost/doc/cgiwrap/htdocs/>
or
.IR <URL:file:/usr/doc/cgiwrap/htdocs/index.html>
, using
.IR lynx(1)
or any other HTML viewer.
.
.SH AUTHOR
This manual page was written by
.br
Karl M. Hegbloom <karlheg@inetarena.com>
.br
for the Debian GNU/Linux system.
|
