GitHub

The check_ifoperstatus Plugin

check_ifoperstatus v2.3git (monitoring-plugins 2.3git)
The Monitoring Plugins come with ABSOLUTELY NO WARRANTY. You may redistribute
copies of the plugins under the terms of the GNU General Public License.
For more information about these matters, see the file named COPYING.

usage: 
check_ifoperstatus -k <IF_KEY> -H <HOSTNAME> [-C <community>]
Copyright (C) 2000 Christoph Kron
check_ifoperstatus.pl comes with ABSOLUTELY NO WARRANTY
This programm is licensed under the terms of the GNU General Public License
(check source code for details)

check_ifoperstatus plugin for monitoring operational 
status of a particular network interface on the target host

Usage:
   -H (--hostname)   Hostname to query - (required)
   -C (--community)  SNMP read community (defaults to public,
                     used with SNMP v1 and v2c
   -v (--snmp_version)  1 for SNMP v1 (default)
                        2 for SNMP v2c
                        SNMP v2c will use get_bulk for less overhead
                        if monitoring with -d
   -L (--seclevel)   choice of "noAuthNoPriv", "authNoPriv", or "authPriv"
   -U (--secname)    username for SNMPv3 context
   -c (--context)    SNMPv3 context name (default is empty string)
   -A (--authpass)   authentication password (cleartext ascii or localized key
                     in hex with 0x prefix generated by using "snmpkey" utility
                     auth password and authEngineID
   -a (--authproto)  Authentication protocol (MD5 or SHA1)
   -X (--privpass)   privacy password (cleartext ascii or localized key
                     in hex with 0x prefix generated by using "snmpkey" utility
                     privacy password and authEngineID
   -P (--privproto)  privacy protocol (DES or AES; default: DES)
   -k (--key)        SNMP IfIndex value
   -d (--descr)      SNMP ifDescr value
   -T (--type)       SNMP ifType integer value (see http://www.iana.org/assignments/ianaiftype-mib)
   -p (--port)       SNMP port (default 161)
   -I (--ifmib)      Agent supports IFMIB ifXTable. Do not use if
                     you don't know what this is. 
   -n (--name)       the value should match the returned ifName
                     (Implies the use of -I)
   -w (--warn =i|w|c) ignore|warn|crit if the interface is dormant (default critical)
   -D (--admin-down =i|w|c) same for administratively down interfaces (default warning)
   -M (--maxmsgsize) Max message size - useful only for v1 or v2c
   -t (--timeout)    seconds before the plugin times out (default=15)
   -V (--version)    Plugin version
   -h (--help)       usage help

 -k or -d or -T must be specified

Note: either -k or -d or -T must be specified and -d and -T are much more network 
intensive.  Use it sparingly or not at all.  -n is used to match against
a much more descriptive ifName value in the IfXTable to verify that the
snmpkey has not changed to some other network interface after a reboot.