lib: Added mblock support for kqueue.
[ashd.git] / doc / httrcall.doc
... / ...
CommitLineData
1httrcall(1)
2==========
3
4NAME
5----
6httrcall - Call transient ashd handlers
7
8SYNOPSIS
9--------
10*httrcall* [*-h*] [*-l* 'LIMIT'] 'PROGRAM' ['ARGS'...]
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
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
41AUTHOR
42------
43Fredrik Tolf <fredrik@dolda2000.com>
44
45SEE ALSO
46--------
47*ashd*(7)