Commit | Line | Data |
---|---|---|
a7431959 FT |
1 | callcgi(1) |
2 | ========== | |
3 | ||
4 | NAME | |
5 | ---- | |
6 | callcgi - CGI request handler for ashd(7) | |
7 | ||
8 | SYNOPSIS | |
9 | -------- | |
10 | *callcgi* [*-c*] [*-p* 'PROGRAM'] 'METHOD' 'URL' 'REST' | |
11 | ||
12 | DESCRIPTION | |
13 | ----------- | |
14 | ||
15 | *callcgi* serves CGI scripts by translating the *ashd*(7) request | |
16 | environment into a standard CGI environment and executing the target | |
17 | file. It needs to be called with the `X-Ash-File` header added to the | |
18 | request, as *dirplex*(1) does. | |
19 | ||
20 | *callcgi* is a transient handler, as defined in *ashd*(7), and the | |
21 | 'METHOD', 'URL' and 'REST' arguments will normally be added by the | |
22 | parent handler. | |
23 | ||
24 | The CGI script is called with its own filename as the first and only | |
25 | command-line parameter. | |
26 | ||
27 | OPTIONS | |
28 | ------- | |
29 | ||
30 | *-c*:: | |
31 | ||
32 | Change directory to the directory containing the CGI script | |
33 | before running it. This behavior is encouraged by the CGI | |
34 | specification, but is not used by *callcgi* by default. | |
35 | ||
36 | *-p* 'PROGRAM':: | |
37 | ||
38 | Call 'PROGRAM' instead of the file itself. This mechanism can | |
39 | be used to serve e.g. PHP scripts and other programs that have | |
40 | an interpreter that can act as a CGI script. The filename of | |
41 | the actual script is still passed as the first and only | |
42 | command-line parameter to the program. | |
43 | ||
44 | AUTHOR | |
45 | ------ | |
46 | Fredrik Tolf <fredrik@dolda2000.com> | |
47 | ||
48 | SEE ALSO | |
49 | -------- | |
50 | *dirplex*(1), *ashd*(7), RFC 3875 |