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)