python: Somewhat integrate async watchers with wsgidir currency.
[ashd.git] / doc / httrcall.doc
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)