#####################################################################
##                                                                 ##
##  snmpvar.monitor                                 Version 1.1.0  ##
##                                                  2000-03-30     ##
##  Copyright (C) 2000                                             ##
##  Peter Holzleitner (P.Holzleitner@computer.org)                 ##
##                                                                 ##
#####################################################################
#
# A MON plug-in monitor to test numeric values retrieved via SNMP
# against limits.
#
# Arguments:
#
#  [--community=cmn] [--timeout=n] [--retries=n]
#    [--varconf=variableconfig] [--config=configfile]
#    [--mibs='mib1:mib2:mibn'] [--list[=linesperpage]] serverlist
#
#   For every host name passed on the command line, snmpval.monitor looks
#   up the list of variables and corresponding limits in the configuration
#   file (snmpmon.cf).
#
#   For every such variable, it looks up the OID, description etc. from
#   the variable definition file (snmpvar.def).
#
#   This monitor looks for configuration files in the current directory,
#   in /etc/mon and /usr/lib/mon/etc.  Command line option --varconf
#   overrides the location of the variable definition file, option
#   --config sets the configuration file name.
#
#   For formats, please refer to the sample configuration files.
#
#   By default, this monitor does not load any MIB, and OIDs are specified
#   numerically in the  configuration files.  Use the option --mibs
#   to force certain MIBs to be loaded.
#
#   When invoked with the --list option, the output format is changed
#   into a more human-readable form used to check and troubleshoot the
#   configuration.  This option must not be used from within MON.
#
#
# Exit values:
#   0  if everything is OK
#   1  if any observed value is outside the specified interval
#   2  in case of an SNMP error (e.g. no response from host)
#
# Requirements:
#
#   UCD SNMP library and G.S. Marzot's Perl SNMP module (from CPAN).
#   (Avoid UCSD SNMP 3.6.1, it will cause segfaults.  Use 3.6.2+)
#
# License:
#
#   This program is free software; you can redistribute it and/or modify
#   it under the terms of the GNU General Public License as published by
#   the Free Software Foundation; either version 2 of the License, or
#   (at your option) any later version.
#
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#   GNU General Public License for more details.
#
#   You should have received a copy of the GNU General Public License
#   along with this program; if not, write to the Free Software Foundation,
#   Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA
#
# History:
#
#   1.1.0  30 Mar 2000  P.H.  added upper and lower plausibility limits
#   1.0.1  24 Jan 2000  P.H.  bugfix: reading Decode definitions
#   1.0.0  13 Jan 2000  P.H.  initial release