doc/httimed.doc

   1 httimed(1)
   2 ==========
   3
   4 NAME
   5 ----
   6 httimed - Ashd handler expiration pipe
   7
   8 SYNOPSIS
   9 --------
  10 *httimed* [*-h*] [*-t* 'TIMEOUT'] 'CHILD' ['ARGS'...]
  11
  12 DESCRIPTION
  13 -----------
  14
  15 The *httimed* handler starts a single child handler which it passes
  16 all request it receives unmodified, and in addition keeps track of
  17 time and simply exits if no requests are received in a certain
  18 interval, which might be useful for handlers which are only rarely
  19 used and waste unproportionally much system resources if kept beyond
  20 their usefulness.
  21
  22 *httimed* is a persistent handler, as defined in *ashd*(7), and the
  23 specified child handler must also be a persistent handler.
  24
  25 By default, *httimed* exits if it receives no requests in five
  26 minutes, but the time interval can be specified using the *-t* option.
  27
  28 If the child handler exits, *httimed* exits as well.
  29
  30 OPTIONS
  31 -------
  32
  33 *-h*::
  34
  35         Print a brief help message to standard output and exit.
  36
  37 *-t* 'TIMEOUT'::
  38
  39         Exit if no requests are received after 'TIMEOUT' seconds since
  40         the last one. If *-t* is not specified, 'TIMEOUT' is five
  41         minutes by default.
  42
  43 AUTHOR
  44 ------
  45 Fredrik Tolf <fredrik@dolda2000.com>
  46
  47 SEE ALSO
  48 --------
  49 *ashd*(7)