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 further 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)