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