Provided by: xymon_4.3.0~beta2.dfsg-5_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)