| 1 | httrcall(1) |
| 2 | ========== |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | httrcall - Call transient ashd handlers |
| 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | *httrcall* [*-h*] [*-l* 'LIMIT'] 'PROGRAM' ['ARGS'...] |
| 11 | |
| 12 | DESCRIPTION |
| 13 | ----------- |
| 14 | |
| 15 | *httrcall* is a persistent handler, as defined in *ashd*(7), but works |
| 16 | by starting a specified transient handler for every incoming |
| 17 | request. Thus, it can be used to run transient handlers where normally |
| 18 | only persistent handlers are accepted, such as for the program |
| 19 | specified to *accesslog*(1), *htextauth*(1) or even *htparser*(1). |
| 20 | |
| 21 | The transient handler to call is specified by the 'PROGRAM' |
| 22 | argument. Any 'ARGS' given are prepended to the usual arguments for |
| 23 | transient handlers, as described in *ashd*(7). |
| 24 | |
| 25 | OPTIONS |
| 26 | ------- |
| 27 | |
| 28 | *-h*:: |
| 29 | |
| 30 | Print a brief help message to standard output and exit. |
| 31 | |
| 32 | *-l* 'LIMIT':: |
| 33 | |
| 34 | If specified, only 'LIMIT' copies of the handler program are |
| 35 | allowed to run at one time. If furter request are received |
| 36 | while 'LIMIT' children are running, *httrcall* will block, |
| 37 | waiting for one to exit before processing further requests. If |
| 38 | no *-l* option is specified, *httrcall* imposes no limit on |
| 39 | the number of children that may run. |
| 40 | |
| 41 | AUTHOR |
| 42 | ------ |
| 43 | Fredrik Tolf <fredrik@dolda2000.com> |
| 44 | |
| 45 | SEE ALSO |
| 46 | -------- |
| 47 | *ashd*(7) |