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