Provided by: xymon_4.3.0~beta2.dfsg-9.1_i386 bug

NAME

       hobbitd_channel - Feed a hobbitd channel to a worker module

SYNOPSIS

       hobbitd_channel   --channel=CHANNEL  [options]  workerprogram  [worker-
       options]

DESCRIPTION

       hobbitd_channel hooks into one of the hobbitd(8) channels that  provide
       information  about  events occurring in the Xymon system.  It retrieves
       messages  from  the  hobbitd  daemon,  and  passes  them  on   to   the
       workerprogram  on  the STDIN (file descripter 1) of the worker program.
       Worker programs can then handle messages as they like.

       A  number  of  worker  programs  are   shipped   with   hobbitd,   e.g.
       hobbitd_filestore(8) hobbitd_history(8) hobbitd_alert(8) hobbitd_rrd(8)

       If  you want to write your own worker module, a sample worker module is
       provided as part of the hobbitd distribution  in  the  hobbitd_sample.c
       file. This illustrates how to easily fetch and parse messages.

OPTIONS

       hobbitd_channel accepts a few options.

       --channel=CHANNELNAME
              Specifies the channel to receive messages from, only one channel
              can be used.  This option is required.  The  following  channels
              are available:
              "status" receives all Xymon status- and summary-messages
              "stachg" receives information about status changes
              "page" receives information about statuses triggering alerts
              "data" receives all Xymon "data" messages
              "notes" receives all Xymon "notes" messages
              "enadis"  receives  information  about  hosts  being disabled or
              enabled.

       --daemon
              hobbitd_channel is normally started by hobbitlaunch(8) as a task
              defined  in  the  hobbitlaunch.cfg(5) file. If you are not using
              hobbitlaunch, then starting  hobbitd_channel  with  this  option
              causes it to run as a stand-alone background task.

       --pidfile=FILENAME
              If  running  as  a stand-alone daemon, hobbitd_channel will save
              the proces-ID of the daemon in  FILENAME.  This  is  useful  for
              automated startup- and shutdown- scripts.

       --env=FILENAME
              Loads  the  environment  variables  defined  in  FILENAME before
              starting hobbitd_channel.   This  is  normally  used  only  when
              running  as  a stand-alone daemon; if hobbitd_channel is started
              by hobbitlaunch, then the environment is controlled by the  task
              definition in the hobbitlaunch.cfg(5) file.

       --log=FILENAME
              Redirect output to this log-file.

       --debug
              Enable debugging output.

FILES

       This program does not use any configuration files.

SEE ALSO

       hobbitd(8), xymon(7)