.TH NAGIOS-STATD 8 "17 Nov 2005" "Version 3.12"
.SH NAME
nagios-statd \- nagios-statd daemon
.SH SYNOPSIS
nagios-statd [OPTION]
.SH DESCRIPTION
.PP
.B nagios-statd
(nagios-statd Daemon) is the daemon program for nagios-stat(1).  These programs
together comprise a systems monitoring tool for various platforms.  It is
designed to be integrated with the Nagios monitoring tool, although this is not
a requirement.
.PP
.B nagios-statd
is the daemon that listens for connections from clients.  It forks off a new
daemon for each incoming connection.  The forked daemon executes a series of
typical UNIX commands and returns those commands standard output to the client.
.SH OPTIONS
.I -a, --allowedhosts=HOSTS
.br
HOSTS is a comma delimited list of hostnames and/or IP addresses to accept
connections from.  The default behavior (without -a) is to accept incoming
connections from all hosts.
.PP
.I -b, --bindto=IP
.br
Normally, nagios-statd will bind to all interfaces on a machine.  You can enter
an IP address to get nagios-statd to only bind only on the IP of a particular
interface.
.PP
.I -i, --inetd
.br
It is possible to run nagios-statd from inetd, rather than as a standalone
daemon.  To do this, you'll need to enter something similar to:
.PP
.RS
.B /etc/inetd.conf:
.br
nagios-statd stream tcp nowait nobody /usr/sbin/nagios-statd nagios-statd -i
.br
.B /etc/services:
.br
nagios-statd/1040 tcp
.RE
.PP
This is probably the best way to run nagios-statd, although that can make it
prone to inetd DoSes (which might happen if the host is monitored on a very
short interval, such as every couple seconds).
.PP
.I -p, --port=PORT
.br
Port for nagios-statd to listen to.  The default port is 1040.
.PP
.I -P, --pid=FILE
.br
Save the pid (process id) of the master daemon to FILE.
.PP
.I -V, --version
.br
Output version information and exit.
.PP
.I -h, --help
.br
Print short option information and exit.
.SH BUGS
There is a general lack of feedback for the more obscure platforms.  As such
their behavior might not always be particularly deterministic.  Feedback is
always welcome.  Redhat Linux contains Python 1.x as /usr/bin/python.  This 
program requires Python 2.x to function.  Either change the shebang at the top
of the program to point to /usr/bin/python2, or change /usr/bin/python to be
Python 2.x.
.SH AUTHOR
April King
.I http://www.twoevils.org
.br
E-mail: april at twoevils dot org
.SH COPYRIGHT
Copyright (C) 2002-2005 April King.
.PP
This is free software, there is NO warranty; not even for MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  This program is licensed under the BSD
license.  More information is available in the LICENSE file included with
this program.
.PP
Nagios is a trademark of Ethan Galstad.
.I 
.SH "SEE ALSO"
.BR nagios-stat (1)