X-Git-Url: http://www.dolda2000.com/gitweb/?p=ashd.git;a=blobdiff_plain;f=doc%2Fhttrcall.doc;fp=doc%2Fhttrcall.doc;h=555284e3c834abf5eb141209e1f703646a4a6d24;hp=0000000000000000000000000000000000000000;hb=bcad6b0c48d516ddc920b52f06083ceaa242e1ca;hpb=589987f8218c9aa61d65f582a3b3e1bbd32bda81

diff --git a/doc/httrcall.doc b/doc/httrcall.doc
new file mode 100644
index 0000000..555284e
--- /dev/null
+++ b/doc/httrcall.doc
@@ -0,0 +1,47 @@
+httrcall(1)
+==========
+
+NAME
+----
+httrcall - Call transient ashd handlers
+
+SYNOPSIS
+--------
+*httrcall* [*-h*] [*-l* 'LIMIT'] 'PROGRAM' ['ARGS'...]
+
+DESCRIPTION
+-----------
+
+*httrcall* is a persistent handler, as defined in *ashd*(7), but works
+by starting a specified transient handler for every incoming
+request. Thus, it can be used to run transient handlers where normally
+only persistent handlers are accepted, such as for the program
+specified to *accesslog*(1), *htextauth*(1) or even *htparser*(1).
+
+The transient handler to call is specified by the 'PROGRAM'
+argument. Any 'ARGS' given are prepended to the usual arguments for
+transient handlers, as described in *ashd*(7).
+
+OPTIONS
+-------
+
+*-h*::
+
+	Print a brief help message to standard output and exit.
+
+*-l* 'LIMIT'::
+
+	If specified, only 'LIMIT' copies of the handler program are
+	allowed to run at one time. If furter request are received
+	while 'LIMIT' children are running, *httrcall* will block,
+	waiting for one to exit before processing further requests. If
+	no *-l* option is specified, *httrcall* imposes no limit on
+	the number of children that may run.
+
+AUTHOR
+------
+Fredrik Tolf <fredrik@dolda2000.com>
+
+SEE ALSO
+--------
+*ashd*(7)