![[tokkee]](http://tokkee.org/images/avatar.png){kind=avatar}
diff --git a/plugins/check_ups.c b/plugins/check_ups.c
index 116e888ce5c79d8610515dbda1f37d7537993f49..ce57ef3d00f8aafc415397c21183b12a1f7c8c04 100644 (file)
--- a/plugins/check_ups.c
+++ b/plugins/check_ups.c
-/******************************************************************************
-
- 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., 675 Mass Ave, Cambridge, MA 02139, USA.
-
-******************************************************************************/
+/*****************************************************************************
+*
+* Nagios check_ups plugin
+*
+* License: GPL
+* Copyright (c) 2000 Tom Shields
+* 2004 Alain Richard <alain.richard@equation.fr>
+* 2004 Arnaud Quette <arnaud.quette@mgeups.com>
+* Copyright (c) 2002-2007 Nagios Plugins Development Team
+*
+* Description:
+*
+* This file contains Network UPS Tools plugin for Nagios
+*
+* This plugin tests the UPS service on the specified host. Network UPS Tools
+* from www.networkupstools.org must be running for this plugin to work.
+*
+*
+* 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 3 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, see <http://www.gnu.org/licenses/>.
+*
+*
+*****************************************************************************/
const char *progname = "check_ups";
-const char *revision = "$Revision$";
-const char *copyright = "2000-2002";
+const char *copyright = "2000-2007";
const char *email = "nagiosplug-devel@lists.sourceforge.net";
#include "common.h"
#define UPS_TEMP 8 /* supports UPS temperature */
#define UPS_LOADPCT 16 /* supports load percent */
-#define UPSSTATUS_NONE 0
-#define UPSSTATUS_OFF 1
-#define UPSSTATUS_OL 2
-#define UPSSTATUS_OB 4
-#define UPSSTATUS_LB 8
-#define UPSSTATUS_CAL 16
-#define UPSSTATUS_RB 32 /*Replace Battery */
-#define UPSSTATUS_UNKOWN 64
+#define UPSSTATUS_NONE 0
+#define UPSSTATUS_OFF 1
+#define UPSSTATUS_OL 2
+#define UPSSTATUS_OB 4
+#define UPSSTATUS_LB 8
+#define UPSSTATUS_CAL 16
+#define UPSSTATUS_RB 32 /*Replace Battery */
+#define UPSSTATUS_BYPASS 64
+#define UPSSTATUS_OVER 128
+#define UPSSTATUS_TRIM 256
+#define UPSSTATUS_BOOST 512
+#define UPSSTATUS_CHRG 1024
+#define UPSSTATUS_DISCHRG 2048
+#define UPSSTATUS_UNKOWN 4096
+
+enum { NOSUCHVAR = ERROR-1 };
int server_port = PORT;
char *server_address;
double ups_load_percent = 0.0;
double ups_temperature = 0.0;
char *ups_status;
+int temp_output_c = 0;
int determine_status (void);
-int determine_supported_vars (void);
int get_ups_variable (const char *, char *, size_t);
int process_arguments (int, char **);
int
main (int argc, char **argv)
{
- int result = STATE_OK;
+ int result = STATE_UNKNOWN;
char *message;
char *data;
+ char *tunits;
char temp_buffer[MAX_INPUT_BUFFER];
double ups_utility_deviation = 0.0;
+ int res;
setlocale (LC_ALL, "");
bindtextdomain (PACKAGE, LOCALEDIR);
ups_status = strdup ("N/A");
data = strdup ("");
+ message = strdup ("");
+
+ /* Parse extra opts if any */
+ argv=np_extra_opts (&argc, argv, progname);
- if (process_arguments (argc, argv) != OK)
- usage ("Invalid command arguments supplied\n");
+ if (process_arguments (argc, argv) == ERROR)
+ usage4 (_("Could not parse arguments"));
/* initialize alarm signal handling */
signal (SIGALRM, socket_timeout_alarm_handler);
/* set socket timeout */
alarm (socket_timeout);
- /* determine what variables the UPS supports */
- if (determine_supported_vars () != OK)
- return STATE_CRITICAL;
-
/* get the ups status if possible */
+ if (determine_status () != OK)
+ return STATE_CRITICAL;
if (supported_options & UPS_STATUS) {
- if (determine_status () != OK)
- return STATE_CRITICAL;
ups_status = strdup ("");
result = STATE_OK;
}
else if ((status & (UPSSTATUS_OB | UPSSTATUS_LB)) ==
(UPSSTATUS_OB | UPSSTATUS_LB)) {
- asprintf (&ups_status, "On Battery, Low Battery");
+ asprintf (&ups_status, _("On Battery, Low Battery"));
result = STATE_CRITICAL;
}
else {
if (status & UPSSTATUS_OL) {
- asprintf (&ups_status, "%s%s", ups_status, "Online");
+ asprintf (&ups_status, "%s%s", ups_status, _("Online"));
}
if (status & UPSSTATUS_OB) {
- asprintf (&ups_status, "%s%s", ups_status, "On Battery");
+ asprintf (&ups_status, "%s%s", ups_status, _("On Battery"));
result = STATE_WARNING;
}
if (status & UPSSTATUS_LB) {
- asprintf (&ups_status, "%s%s", ups_status, ", Low Battery");
+ asprintf (&ups_status, "%s%s", ups_status, _(", Low Battery"));
result = STATE_WARNING;
}
if (status & UPSSTATUS_CAL) {
- asprintf (&ups_status, "%s%s", ups_status, ", Calibrating");
+ asprintf (&ups_status, "%s%s", ups_status, _(", Calibrating"));
}
if (status & UPSSTATUS_RB) {
- asprintf (&ups_status, "%s%s", ups_status, ", Replace Battery");
+ asprintf (&ups_status, "%s%s", ups_status, _(", Replace Battery"));
result = STATE_WARNING;
}
+ if (status & UPSSTATUS_BYPASS) {
+ asprintf (&ups_status, "%s%s", ups_status, _(", On Bypass"));
+ }
+ if (status & UPSSTATUS_OVER) {
+ asprintf (&ups_status, "%s%s", ups_status, _(", Overload"));
+ }
+ if (status & UPSSTATUS_TRIM) {
+ asprintf (&ups_status, "%s%s", ups_status, _(", Trimming"));
+ }
+ if (status & UPSSTATUS_BOOST) {
+ asprintf (&ups_status, "%s%s", ups_status, _(", Boosting"));
+ }
+ if (status & UPSSTATUS_CHRG) {
+ asprintf (&ups_status, "%s%s", ups_status, _(", Charging"));
+ }
+ if (status & UPSSTATUS_DISCHRG) {
+ asprintf (&ups_status, "%s%s", ups_status, _(", Discharging"));
+ }
if (status & UPSSTATUS_UNKOWN) {
- asprintf (&ups_status, "%s%s", ups_status, ", Unknown");
+ asprintf (&ups_status, "%s%s", ups_status, _(", Unknown"));
}
}
asprintf (&message, "%sStatus=%s ", message, ups_status);
}
/* get the ups utility voltage if possible */
- if (supported_options & UPS_UTILITY) {
-
- if (get_ups_variable ("UTILITY", temp_buffer, sizeof (temp_buffer)) != OK)
- return STATE_CRITICAL;
+ res=get_ups_variable ("input.voltage", temp_buffer, sizeof (temp_buffer));
+ if (res == NOSUCHVAR) supported_options &= ~UPS_UTILITY;
+ else if (res != OK)
+ return STATE_CRITICAL;
+ else {
+ supported_options |= UPS_UTILITY;
ups_utility_voltage = atof (temp_buffer);
asprintf (&message, "%sUtility=%3.1fV ", message, ups_utility_voltage);
}
/* get the ups battery percent if possible */
- if (supported_options & UPS_BATTPCT) {
-
- if (get_ups_variable ("BATTPCT", temp_buffer, sizeof (temp_buffer)) != OK)
- return STATE_CRITICAL;
-
+ res=get_ups_variable ("battery.charge", temp_buffer, sizeof (temp_buffer));
+ if (res == NOSUCHVAR) supported_options &= ~UPS_BATTPCT;
+ else if ( res != OK)
+ return STATE_CRITICAL;
+ else {
+ supported_options |= UPS_BATTPCT;
ups_battery_percent = atof (temp_buffer);
asprintf (&message, "%sBatt=%3.1f%% ", message, ups_battery_percent);
}
/* get the ups load percent if possible */
- if (supported_options & UPS_LOADPCT) {
-
- if (get_ups_variable ("LOADPCT", temp_buffer, sizeof (temp_buffer)) != OK)
- return STATE_CRITICAL;
-
+ res=get_ups_variable ("ups.load", temp_buffer, sizeof (temp_buffer));
+ if ( res == NOSUCHVAR ) supported_options &= ~UPS_LOADPCT;
+ else if ( res != OK)
+ return STATE_CRITICAL;
+ else {
+ supported_options |= UPS_LOADPCT;
ups_load_percent = atof (temp_buffer);
asprintf (&message, "%sLoad=%3.1f%% ", message, ups_load_percent);
}
/* get the ups temperature if possible */
- if (supported_options & UPS_TEMP) {
-
- if (get_ups_variable ("UPSTEMP", temp_buffer, sizeof (temp_buffer)) != OK)
- return STATE_CRITICAL;
-
- ups_temperature = (atof (temp_buffer) * 1.8) + 32;
- asprintf (&message, "%sTemp=%3.1fF", message, ups_temperature);
+ res=get_ups_variable ("ups.temperature", temp_buffer, sizeof (temp_buffer));
+ if ( res == NOSUCHVAR ) supported_options &= ~UPS_TEMP;
+ else if ( res != OK)
+ return STATE_CRITICAL;
+ else {
+ supported_options |= UPS_TEMP;
+ if (temp_output_c) {
+ tunits="degC";
+ ups_temperature = atof (temp_buffer);
+ asprintf (&message, "%sTemp=%3.1fC", message, ups_temperature);
+ }
+ else {
+ tunits="degF";
+ ups_temperature = (atof (temp_buffer) * 1.8) + 32;
+ asprintf (&message, "%sTemp=%3.1fF", message, ups_temperature);
+ }
if (check_variable == UPS_TEMP) {
if (check_crit==TRUE && ups_temperature>=critical_value) {
result = max_state (result, STATE_WARNING);
}
asprintf (&data, "%s %s", data,
- perfdata ("temp", (long)ups_temperature, "degF",
+ perfdata ("temp", (long)ups_temperature, tunits,
check_warn, (long)(1000*warning_value),
check_crit, (long)(1000*critical_value),
TRUE, 0, FALSE, 0));
} else {
asprintf (&data, "%s %s", data,
- perfdata ("temp", (long)ups_temperature, "degF",
+ perfdata ("temp", (long)ups_temperature, tunits,
FALSE, 0, FALSE, 0, TRUE, 0, FALSE, 0));
}
}
/* if the UPS does not support any options we are looking for, report an error */
if (supported_options == UPS_NONE) {
result = STATE_CRITICAL;
- asprintf (&message, "UPS does not support any available options\n");
+ asprintf (&message, _("UPS does not support any available options\n"));
}
/* reset timeout */
char recv_buffer[MAX_INPUT_BUFFER];
char temp_buffer[MAX_INPUT_BUFFER];
char *ptr;
+ int res;
- if (get_ups_variable ("STATUS", recv_buffer, sizeof (recv_buffer)) !=
- STATE_OK) {
- printf ("Invalid response received from hostn");
+ res=get_ups_variable ("ups.status", recv_buffer, sizeof (recv_buffer));
+ if (res == NOSUCHVAR) return OK;
+ if (res != STATE_OK) {
+ printf ("%s\n", _("Invalid response received from host"));
return ERROR;
}
- recv_buffer[strlen (recv_buffer) - 1] = 0;
+ supported_options |= UPS_STATUS;
strcpy (temp_buffer, recv_buffer);
for (ptr = (char *) strtok (temp_buffer, " "); ptr != NULL;
status |= UPSSTATUS_CAL;
else if (!strcmp (ptr, "RB"))
status |= UPSSTATUS_RB;
+ else if (!strcmp (ptr, "BYPASS"))
+ status |= UPSSTATUS_BYPASS;
+ else if (!strcmp (ptr, "OVER"))
+ status |= UPSSTATUS_OVER;
+ else if (!strcmp (ptr, "TRIM"))
+ status |= UPSSTATUS_TRIM;
+ else if (!strcmp (ptr, "BOOST"))
+ status |= UPSSTATUS_BOOST;
+ else if (!strcmp (ptr, "CHRG"))
+ status |= UPSSTATUS_CHRG;
+ else if (!strcmp (ptr, "DISCHRG"))
+ status |= UPSSTATUS_DISCHRG;
else
status |= UPSSTATUS_UNKOWN;
}
}
-/* determines what options are supported by the UPS */
-int
-determine_supported_vars (void)
-{
- char send_buffer[MAX_INPUT_BUFFER];
- char recv_buffer[MAX_INPUT_BUFFER];
- char temp_buffer[MAX_INPUT_BUFFER];
- char *ptr;
-
-
- /* get the list of variables that this UPS supports */
- if (ups_name)
- sprintf (send_buffer, "LISTVARS %s\r\n", ups_name);
- else
- sprintf (send_buffer, "LISTVARS\r\n");
- if (process_tcp_request
- (server_address, server_port, send_buffer, recv_buffer,
- sizeof (recv_buffer)) != STATE_OK) {
- printf ("Invalid response received from host\n");
- return ERROR;
- }
-
- recv_buffer[strlen (recv_buffer) - 1] = 0;
-
- if (ups_name)
- ptr = recv_buffer + 5 + strlen (ups_name) + 2;
- else
- ptr = recv_buffer + 5;
-
- strcpy (temp_buffer, recv_buffer);
-
- for (ptr = (char *) strtok (temp_buffer, " "); ptr != NULL;
- ptr = (char *) strtok (NULL, " ")) {
- if (!strcmp (ptr, "UTILITY"))
- supported_options |= UPS_UTILITY;
- else if (!strcmp (ptr, "BATTPCT"))
- supported_options |= UPS_BATTPCT;
- else if (!strcmp (ptr, "LOADPCT"))
- supported_options |= UPS_LOADPCT;
- else if (!strcmp (ptr, "STATUS"))
- supported_options |= UPS_STATUS;
- else if (!strcmp (ptr, "UPSTEMP"))
- supported_options |= UPS_TEMP;
- }
-
- return OK;
-}
-
-
/* gets a variable value for a specific UPS */
int
get_ups_variable (const char *varname, char *buf, size_t buflen)
char temp_buffer[MAX_INPUT_BUFFER];
char send_buffer[MAX_INPUT_BUFFER];
char *ptr;
+ char *logout = "OK Goodbye\n";
+ int logout_len = strlen(logout);
+ int len;
+
+ *buf=0;
/* create the command string to send to the UPS daemon */
- if (ups_name)
- sprintf (send_buffer, "REQ %s@%s\n", varname, ups_name);
- else
- sprintf (send_buffer, "REQ %s\n", varname);
+ /* Add LOGOUT to avoid read failure logs */
+ sprintf (send_buffer, "GET VAR %s %s\nLOGOUT\n", ups_name, varname);
/* send the command to the daemon and get a response back */
if (process_tcp_request
(server_address, server_port, send_buffer, temp_buffer,
sizeof (temp_buffer)) != STATE_OK) {
- printf ("Invalid response received from host\n");
+ printf ("%s\n", _("Invalid response received from host"));
return ERROR;
}
- if (ups_name)
- ptr = temp_buffer + strlen (varname) + 5 + strlen (ups_name) + 1;
- else
- ptr = temp_buffer + strlen (varname) + 5;
-
- if (!strcmp (ptr, "NOT-SUPPORTED")) {
- printf ("Error: Variable '%s' is not supported\n", varname);
+ ptr = temp_buffer;
+ len = strlen(ptr);
+ if (len > logout_len && strcmp (ptr + len - logout_len, logout) == 0) len -= logout_len;
+ if (len > 0 && ptr[len-1] == '\n') ptr[len-1]=0;
+ if (strcmp (ptr, "ERR UNKNOWN-UPS") == 0) {
+ printf (_("CRITICAL - no such UPS '%s' on that host\n"), ups_name);
return ERROR;
}
- if (!strcmp (ptr, "DATA-STALE")) {
- printf ("Error: UPS data is stale\n");
+ if (strcmp (ptr, "ERR VAR-NOT-SUPPORTED") == 0) {
+ /*printf ("Error: Variable '%s' is not supported\n", varname);*/
+ return NOSUCHVAR;
+ }
+
+ if (strcmp (ptr, "ERR DATA-STALE") == 0) {
+ printf ("%s\n", _("CRITICAL - UPS data is stale"));
return ERROR;
}
- if (!strcmp (ptr, "UNKNOWN-UPS")) {
- if (ups_name)
- printf ("Error: UPS '%s' is unknown\n", ups_name);
- else
- printf ("Error: UPS is unknown\n");
+ if (strncmp (ptr, "ERR", 3) == 0) {
+ printf (_("Unknown error: %s\n"), ptr);
return ERROR;
}
- strncpy (buf, ptr, buflen - 1);
- buf[buflen - 1] = 0;
+ ptr = temp_buffer + strlen (varname) + strlen (ups_name) + 6;
+ len = strlen(ptr);
+ if (len < 2 || ptr[0] != '"' || ptr[len-1] != '"') {
+ printf ("%s\n", _("Error: unable to parse variable"));
+ return ERROR;
+ }
+ strncpy (buf, ptr+1, len - 2);
+ buf[len - 2] = 0;
return OK;
}
-
-
-
-/* Command line: CHECK_UPS <host_address> [-u ups] [-p port] [-v variable]
+/* Command line: CHECK_UPS -H <host_address> -u ups [-p port] [-v variable]
[-wv warn_value] [-cv crit_value] [-to to_sec] */
{"critical", required_argument, 0, 'c'},
{"warning", required_argument, 0, 'w'},
{"timeout", required_argument, 0, 't'},
+ {"temperature", no_argument, 0, 'T'},
{"variable", required_argument, 0, 'v'},
{"version", no_argument, 0, 'V'},
{"help", no_argument, 0, 'h'},
}
while (1) {
- c = getopt_long (argc, argv, "hVH:u:p:v:c:w:t:", longopts,
+ c = getopt_long (argc, argv, "hVTH:u:p:v:c:w:t:", longopts,
&option);
if (c == -1 || c == EOF)
switch (c) {
case '?': /* help */
- usage3 ("Unknown option", optopt);
+ usage5 ();
case 'H': /* hostname */
if (is_host (optarg)) {
server_address = optarg;
}
else {
- usage2 ("Invalid host name", optarg);
+ usage2 (_("Invalid hostname/address"), optarg);
}
break;
+ case 'T': /* FIXME: to be improved (ie "-T C" for Celsius or "-T F" for Farenheit) */
+ temp_output_c = 1;
+ break;
case 'u': /* ups name */
ups_name = optarg;
break;
server_port = atoi (optarg);
}
else {
- usage2 ("Server port must be a positive integer", optarg);
+ usage2 (_("Port must be a positive integer"), optarg);
}
break;
case 'c': /* critical time threshold */
check_crit = TRUE;
}
else {
- usage2 ("Critical time must be a nonnegative integer", optarg);
+ usage2 (_("Critical time must be a positive integer"), optarg);
}
break;
case 'w': /* warning time threshold */
check_warn = TRUE;
}
else {
- usage2 ("Warning time must be a nonnegative integer", optarg);
+ usage2 (_("Warning time must be a positive integer"), optarg);
}
break;
case 'v': /* variable */
else if (!strcmp (optarg, "LOADPCT"))
check_variable = UPS_LOADPCT;
else
- usage2 ("Unrecognized UPS variable", optarg);
+ usage2 (_("Unrecognized UPS variable"), optarg);
break;
case 't': /* timeout */
if (is_intnonneg (optarg)) {
socket_timeout = atoi (optarg);
}
else {
- usage ("Time interval must be a nonnegative integer\n");
+ usage4 (_("Timeout interval must be a positive integer"));
}
break;
case 'V': /* version */
- print_revision (progname, "$Revision$");
+ print_revision (progname, NP_VERSION);
exit (STATE_OK);
case 'h': /* help */
print_help ();
if (is_host (argv[optind]))
server_address = argv[optind++];
else
- usage ("Invalid host name");
+ usage2 (_("Invalid hostname/address"), optarg);
}
if (server_address == NULL)
}
-
-
-
int
validate_arguments (void)
{
+ if (! ups_name) {
+ printf ("%s\n", _("Error : no UPS indicated"));
+ return ERROR;
+ }
return OK;
}
-
-
-
-\f
void
print_help (void)
{
char *myport;
asprintf (&myport, "%d", PORT);
- print_revision (progname, revision);
+ print_revision (progname, NP_VERSION);
- printf (_("Copyright (c) 2000 Tom Shields"));
- printf (_(COPYRIGHT), copyright, email);
+ printf ("Copyright (c) 2000 Tom Shields\n");
+ printf ("Copyright (c) 2004 Alain Richard <alain.richard@equation.fr>\n");
+ printf ("Copyright (c) 2004 Arnaud Quette <arnaud.quette@mgeups.com>\n");
+ printf (COPYRIGHT, copyright, email);
- printf (_("This plugin tests the UPS service on the specified host.\n\
-Network UPS Tools from www.exploits.org must be running for this plugin to\n\
-work.\n\n"));
-
- print_usage ();
+ printf ("%s\n", _("This plugin tests the UPS service on the specified host. Network UPS Tools"));
+ printf ("%s\n", _("from www.networkupstools.org must be running for this plugin to work."));
- printf (_(UT_HELP_VRSN));
+ printf ("\n\n");
- printf (_(UT_HOST_PORT), 'p', myport);
-
- printf (_("\
- -u, --ups=STRING\n\
- Name of UPS\n"));
-
- printf (_(UT_WARN_CRIT));
-
- printf (_(UT_TIMEOUT), DEFAULT_SOCKET_TIMEOUT);
-
- printf (_(UT_VERBOSE));
-
- printf (_("\
-This plugin attempts to determine the status of a UPS (Uninterruptible Power\n\
-Supply) on a local or remote host. If the UPS is online or calibrating, the\n\
-plugin will return an OK state. If the battery is on it will return a WARNING\n\
-state. If the UPS is off or has a low battery the plugin will return a CRITICAL\n\
-state.\n\n"));
-
- printf (_("\
-You may also specify a variable to check [such as temperature, utility voltage,\n\
-battery load, etc.] as well as warning and critical thresholds for the value of\n\
-that variable. If the remote host has multiple UPS that are being monitored you\n\
-will have to use the [ups] option to specify which UPS to check.\n\n"));
-
- printf (_("Notes:\n\n\
-This plugin requires that the UPSD daemon distributed with Russel Kroll's\n\
-Smart UPS Tools be installed on the remote host. If you do not have the\n\
-package installed on your system, you can download it from\n\
-http://www.exploits.org/nut\n\n"));
+ print_usage ();
- printf (_(UT_SUPPORT));
+ printf (UT_HELP_VRSN);
+ printf (UT_EXTRA_OPTS);
+
+ printf (UT_HOST_PORT, 'p', myport);
+
+ printf (" %s\n", "-u, --ups=STRING");
+ printf (" %s\n", _("Name of UPS"));
+ printf (" %s\n", "-T, --temperature");
+ printf (" %s\n", _("Output of temperatures in Celsius"));
+ printf (" %s\n", "-v, --variable=STRING");
+ printf (" %s %s\n", _("Valid values for STRING are"), "LINE, TEMP, BATTPCT or LOADPCT");
+
+ printf (UT_WARN_CRIT);
+
+ printf (UT_TIMEOUT, DEFAULT_SOCKET_TIMEOUT);
+
+/* TODO: -v clashing with -v/-variable. Commenting out help text since verbose
+ is unused up to now */
+/* printf (UT_VERBOSE); */
+
+ printf ("\n");
+ printf ("%s\n", _("This plugin attempts to determine the status of a UPS (Uninterruptible Power"));
+ printf ("%s\n", _("Supply) on a local or remote host. If the UPS is online or calibrating, the"));
+ printf ("%s\n", _("plugin will return an OK state. If the battery is on it will return a WARNING"));
+ printf ("%s\n", _("state. If the UPS is off or has a low battery the plugin will return a CRITICAL"));
+ printf ("%s\n", _("state."));
+
+ printf ("\n");
+ printf ("%s\n", _("Notes:"));
+ printf (" %s\n", _("You may also specify a variable to check (such as temperature, utility voltage,"));
+ printf (" %s\n", _("battery load, etc.) as well as warning and critical thresholds for the value"));
+ printf (" %s\n", _("of that variable. If the remote host has multiple UPS that are being monitored"));
+ printf (" %s\n", _("you will have to use the --ups option to specify which UPS to check."));
+ printf ("\n");
+ printf (" %s\n", _("This plugin requires that the UPSD daemon distributed with Russell Kroll's"));
+ printf (" %s\n", _("Network UPS Tools be installed on the remote host. If you do not have the"));
+ printf (" %s\n", _("package installed on your system, you can download it from"));
+ printf (" %s\n", _("http://www.networkupstools.org"));
+#ifdef NP_EXTRA_OPTS
+ printf ("\n");
+ printf (UT_EXTRA_OPTS_NOTES);
+#endif
+
+ printf (UT_SUPPORT);
}
-
-
void
print_usage (void)
{
- printf (_("\
-Usage: %s -H host [-e expect] [-p port] [-w warn] [-c crit]\n\
- [-t timeout] [-v]\n"), progname);
- printf (_(UT_HLP_VRS), progname, progname);
+ printf (_("Usage:"));
+ printf ("%s -H host -u ups [-p port] [-v variable] [-w warn_value] [-c crit_value] [-to to_sec] [-T]\n", progname);
}