Commit | Line | Data |
---|---|---|
f7b4b93e FT |
1 | httrcall(1) |
2 | ========== | |
3 | ||
4 | NAME | |
5 | ---- | |
6 | httrcall - Call transient ashd handlers | |
7 | ||
8 | SYNOPSIS | |
9 | -------- | |
547a4189 | 10 | *httrcall* [*-h*] [*-l* 'LIMIT'] 'PROGRAM' ['ARGS'...] |
f7b4b93e FT |
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 | ||
547a4189 FT |
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, | |
e7f62088 FT |
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. | |
547a4189 | 40 | |
f7b4b93e FT |
41 | AUTHOR |
42 | ------ | |
43 | Fredrik Tolf <fredrik@dolda2000.com> | |
44 | ||
45 | SEE ALSO | |
46 | -------- | |
47 | *ashd*(7) |