=================================================================== RCS file: /cvs/nagios/check_hw_sensors/README,v retrieving revision 1.4 retrieving revision 1.8 diff -u -r1.4 -r1.8 --- nagios/check_hw_sensors/README 2006/10/26 00:30:23 1.4 +++ nagios/check_hw_sensors/README 2009/11/09 22:51:01 1.8 @@ -1,13 +1,14 @@ -check_hw_sensors plugin for Nagios monitors sysctl hw.sensors on OpenBSD +check_hw_sensors - monitors sysctl hw.sensors on OpenBSD check_hw_sensors [-i] (-f []|(-s [-w limit] [-c limit])) Usage: -i, --ignore-status - Don't check the status of sensors that report it. + Don't automatically check the status of sensors that report it. -f, --filename=FILE FILE to load checks from (defaults to /etc/sensorsd.conf) -s, --sensor=ID - ID of a single sensor. "-s 0" means hw.sensors.0. + ID of a single sensor. "-s kate0.temp0" means hw.sensors.kate0.temp0 + Overrides --filename. -w, --warning=RANGE or single ENTRY Exit with WARNING status if outside of RANGE or if != ENTRY -c, --critical=RANGE or single ENTRY @@ -15,7 +16,8 @@ FILE is in the same format as sensorsd.conf(5) plus some additional entries. These additional entries in the file are ignored by -sensorsd(8). +sensorsd(8) this means you can use the same config file for check_hw_sensors +as well as sensorsd(8). check_hw_sensors understands the following entries: @@ -25,17 +27,18 @@ An ENTRY depends on the type. The descriptions in sensorsd.conf(5) can be used when appropriate, or you can use the following: - volts_dc, fanrpm or raw - Anything that includes digits. - Both the value of the check and the value of the sensor - response that are not either a digit or period are stripped - and then the two resultant values are compared. + fanrpm, volts_dc, amps, watthour, amphour, integer (raw), percent, + lux or timedelta - Anything that includes digits. Both the value of + the check and the value of the sensor response that are not either a + digit or period are stripped and then the two resultant values are + compared. temp - Can be as above, but if the entry has an F in it, it compares farenheit, otherwise it uses celcius. indicator or drive - does a case sensitive match of each entry in the comma separated list and if it does not match - any of the entries, it matches the status. + any of the entries, it sets the status. The entries 'crit' or 'warn' (or the -c or -w on the command line) may be a RANGE or a comma separated list of acceptable values. @@ -45,18 +48,25 @@ A RANGE is a low ENTRY and a high ENTRY separated by a colon (:). It can also be low: or :high with the other side left blank to only -make the single check.. +make the single check. An entry marked "ignore" will cause that sensor to be skipped. -Generally used with status checking of all sensors to ignore sensors you +Generally used with state checking of all sensors to ignore sensors you don't care about or that report incorrectly. If you are using --ignore-status, you can still check the status of individual sensors with a status entry. -check_hw_sensors (nagios-plugins 1.4.2) 1.17 -The nagios 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. +check_hw_sensors v1.26 +Copyright (c) 2009 Andrew Fresh +Permission to use, copy, modify, and distribute this software for any +purpose with or without fee is hereby granted, provided that the above +copyright notice and this permission notice appear in all copies. -$RedRiver$ +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.