manpage.1'. You may view the manual page with: `docbook-to-man manpage.sgml | nroff -man | less'. A typical entry in a Makefile or Makefile.am is: manpage.1: manpage.sgml docbook-to-man $< > $@ The docbook-to-man binary is found in the docbook-to-man package. Please remember that if you create the nroff version in one of the debian/rules file targets (such as build), you will need to include docbook-to-man in your Build-Depends control field. --> Christian"> Recktenwald"> September, 19 2013"> 1"> support@lihas.de"> check_nut_plus"> LiHAS"> GNU"> upsc(8)"> nrpe(8)"> ]>
&dhemail;
&dhfirstname; &dhsurname; 2010 &dhusername; &dhdate;
&dhucpackage; &dhsection; &dhpackage; This nagios plugin reports the status of the UPS using NUT. &dhpackage; [ -D ] -d DEVICE -v CHECK_DESC [ -v CHECK_DESC ... ] &dhpackage; [ -V | -h ] DESCRIPTION This manual page documents the &dhpackage; command. &dhpackage; is a program to generate an &nrpe; suitable output of &upsc;, in short a nagios plugin for uninterruptable power supplies (UPS). FEATURES Watch and evaluate every value &upsc; can report. The kind of comparison can be specified by OPERATOR. Multiple and combined comparison can be specified. OPTIONS A device description &upsc; would accept. A check desciption. See CHECK DESCIPTION below. Enable debugging. Print version information and exit. Print help and exit. CHECK DESCIPTION check_nut-plus -d DEVICE -v CHECK_DESC [ -v CHECK_DESC ... ] DEVICE : a device description &upsc; would accept. CHECK_DESC := UPSCKEY '=' SEVERITY OPERATOR VALUE [ ':' SEVERITY OPERATOR VALUE ] ... UPSCKEY : key string as listed by &upsc;, see 'man upsc' SEVERITY := { 'w' | 'c' } 'w': warning 'c': critical errors OPERATOR := { '>=' | '>' | '<' | '<=' | '==' | '=' | '<>' | '!=' | '~' | '!~' } '>=': numerical comparison, reported value is greater or equal than VALUE '>' : numerical comparison, reported value is greater than VALUE '<=': numerical comparison, reported value is less or equal than VALUE '<' : numerical comparison, reported value is less than VALUE '=' : numerical comparison, reported value is equal to VALUE '<>': numerical comparison, reported value is not equal to VALUE '==': string comparison, reported value is identical to VALUE '!=': string comparison, reported value is not identical to VALUE '~' : regex match, reported value matches the perl regular expression given by VALUE '!~': regex match, reported value does not match the perl regular expression given by VALUE For perl regular expressions see 'man perlre'. ENVIRONMENT None Examples classic command[check_ups_load]=/usr/lib/nagios/plugins/check_nut_plus \ -d ups17@localhost -v "ups.load=w>90:c>=98" raise warning if the value reported by "ups.load" is greater than "90" and raise critical error if it is "greater or equal than "98" observe a fixed value command[check_ups_Ubat]=/usr/lib/nagios/plugins/check_nut_plus \ -d ups@localhost -v "battery.voltage=c!=27.0" raise critical error if the value reported by "battery.voltage" it not equal to 27.0 observe multiple fixed strings command[check_ups_model]=/usr/lib/nagios/plugins/check_nut_plus \ -d myups -v "device.mfr=c!=MGE UPS SYSTEMS" -v "device.model=c!=Evolution 1150" \ -v "device.serial=w!=AV4H4301K" raise critical error if "device.mfr" or "device.model" are not the specified ones. raise warning if "device.serial" has changed so you can see if someone has been tinkering ;-) window discrimitation command[check_ups_Uin]=/usr/lib/nagios/plugins/check_nut_plus \ -d otherups@somehost -v "input.voltage=w>=238:c>=240:w<=225:c<=220" critical error on input.voltage >=240 or c<=220 no error on input.voltage < 238 and > 220 warning otherwise FILES debian/changelog Debian changelog file. SEE ALSO perlre(1), &upsc;, http://www.networkupstools.org/, &nrpe; BUGS Sure... AUTHOR This manual page was written by &dhusername; &dhemail; for the &dhpackage; software and may be used by others. It has been loosely derived from check_ups by Luca Bertoncello <lucabert@lucabert.de>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. DISTRIBUTION The newest version of &dhpackage can be obtained from http://ftp.lihas.de/debian 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; Version 2. This guarantees your right to use, modify, and redistribute &dhpackage under certain conditions. 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 (it is in the COPYING file of the &dhpackage distribution).