monitoring-plugins/plugins/check_ups.c
Lorenz Kästle 9bbc764838
Ok summary (#2270)
* lib: implement functionality to set ok summary

* check_load: implement setting ok summary

* OK summary for ntp_peer, ntp_time and users

* check_apt: implement ok summary

* check_curl: implement ok summary

* check_disk: implement ok summary

* check_dbi: implement ok summary

* check_ldap: auto formatting

* check_ldap: implement ok summary

* check_ssh: implement ok summary

* check_tcp: implement ok summary

* fixup! check_curl: implement ok summary

* fixup! check_dbi: implement ok summary

* fixup! check_ldap: implement ok summary

* fixup! check_ssh: implement ok summary

* fixup! check_tcp: implement ok summary

* check_apt: remove illegal free

* check_mrtg: fix link

* check_mrtg: implement ok summary

* check_mrtgtraf: fix link

* check_mrtgtraf: implement ok summary

* check_mysql: implement ok summary

* check_mysql_query: implement ok summary

* check_pgsql: implement ok summary

* check_radius: implement ok summary

* check_real: implement ok summary

* check_smtp: implement ok summary

* check_snmp: implement ok summary

* check_swap: implement ok summary

* check_ups: add OK summary

---------

Co-authored-by: Lorenz Kästle <lorenz.kaestle@netways.de>
2026-06-08 08:23:44 +02:00

738 lines
25 KiB
C

/*****************************************************************************
*
* Monitoring 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-2024 Monitoring Plugins Development Team
*
* Description:
*
* This file contains Network UPS Tools plugin for Monitoring
*
* 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 *copyright = "2000-2024";
const char *email = "devel@monitoring-plugins.org";
#include "output.h"
#include "perfdata.h"
#include "thresholds.h"
#include "common.h"
#include "netutils.h"
#include "utils.h"
#include "check_ups.d/config.h"
#include "states.h"
enum {
NOSUCHVAR = ERROR - 1
};
// Forward declarations
typedef struct {
int errorcode;
int ups_status;
int supported_options;
} determine_status_result;
static determine_status_result determine_status(check_ups_config /*config*/);
static int get_ups_variable(const char * /*varname*/, char * /*buf*/, check_ups_config config);
typedef struct {
int errorcode;
check_ups_config config;
} check_ups_config_wrapper;
static check_ups_config_wrapper process_arguments(int /*argc*/, char ** /*argv*/);
static check_ups_config_wrapper validate_arguments(check_ups_config_wrapper /*config_wrapper*/);
static void print_help(void);
void print_usage(void);
int main(int argc, char **argv) {
setlocale(LC_ALL, "");
bindtextdomain(PACKAGE, LOCALEDIR);
textdomain(PACKAGE);
/* Parse extra opts if any */
argv = np_extra_opts(&argc, argv, progname);
check_ups_config_wrapper tmp_config = process_arguments(argc, argv);
if (tmp_config.errorcode == ERROR) {
usage4(_("Could not parse arguments"));
}
// Config from commandline
check_ups_config config = tmp_config.config;
/* initialize alarm signal handling */
signal(SIGALRM, socket_timeout_alarm_handler);
/* set socket timeout */
alarm(socket_timeout);
mp_check overall = mp_check_init();
mp_set_ok_summary(&overall, "UPS check is OK");
mp_subcheck sc_retrieve_status = mp_subcheck_init();
/* get the ups status if possible */
determine_status_result query_result = determine_status(config);
if (query_result.errorcode != OK) {
xasprintf(&sc_retrieve_status.output, "%s", "Failed to retrieve status from UPS tools");
mp_add_subcheck_to_check(&overall, sc_retrieve_status);
mp_exit(overall);
}
xasprintf(&sc_retrieve_status.output, "%s", "Retrieved status from UPS tools");
mp_add_subcheck_to_check(&overall, sc_retrieve_status);
int ups_status_flags = query_result.ups_status;
int supported_options = query_result.supported_options;
// Exit result
mp_subcheck sc_ups_status = mp_subcheck_init();
if (supported_options & UPS_STATUS) {
mp_state_enum ups_state_result = STATE_OK;
if (ups_status_flags & UPSSTATUS_OFF) {
xasprintf(&sc_ups_status.output, "Off");
ups_state_result = STATE_CRITICAL;
} else if ((ups_status_flags & (UPSSTATUS_OB | UPSSTATUS_LB)) ==
(UPSSTATUS_OB | UPSSTATUS_LB)) {
xasprintf(&sc_ups_status.output, _("On Battery, Low Battery"));
ups_state_result = STATE_CRITICAL;
} else {
if (ups_status_flags & UPSSTATUS_OL) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _("Online"));
}
if (ups_status_flags & UPSSTATUS_OB) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _("On Battery"));
ups_state_result = max_state(ups_state_result, STATE_WARNING);
}
if (ups_status_flags & UPSSTATUS_LB) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", Low Battery"));
ups_state_result = max_state(ups_state_result, STATE_WARNING);
}
if (ups_status_flags & UPSSTATUS_CAL) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", Calibrating"));
}
if (ups_status_flags & UPSSTATUS_RB) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output,
_(", Replace Battery"));
ups_state_result = max_state(ups_state_result, STATE_WARNING);
}
if (ups_status_flags & UPSSTATUS_BYPASS) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", On Bypass"));
// Bypassing the battery is likely a bad thing
ups_state_result = STATE_CRITICAL;
}
if (ups_status_flags & UPSSTATUS_OVER) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", Overload"));
ups_state_result = max_state(ups_state_result, STATE_WARNING);
}
if (ups_status_flags & UPSSTATUS_TRIM) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", Trimming"));
}
if (ups_status_flags & UPSSTATUS_BOOST) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", Boosting"));
}
if (ups_status_flags & UPSSTATUS_CHRG) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", Charging"));
}
if (ups_status_flags & UPSSTATUS_DISCHRG) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", Discharging"));
ups_state_result = max_state(ups_state_result, STATE_WARNING);
}
if (ups_status_flags & UPSSTATUS_ALARM) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", ALARM"));
ups_state_result = STATE_CRITICAL;
}
if (ups_status_flags & UPSSTATUS_UNKNOWN) {
xasprintf(&sc_ups_status.output, "%s%s", sc_ups_status.output, _(", Unknown"));
}
}
xasprintf(&sc_ups_status.output, "Status: %s", sc_ups_status.output);
sc_ups_status = mp_set_subcheck_state(sc_ups_status, ups_state_result);
}
int res;
char temp_buffer[MAX_INPUT_BUFFER];
/* get the ups utility voltage if possible */
mp_subcheck sc_voltage = mp_subcheck_init();
sc_voltage = mp_set_subcheck_default_state(sc_voltage, STATE_OK);
res = get_ups_variable("input.voltage", temp_buffer, config);
if (res == NOSUCHVAR) {
supported_options &= ~UPS_UTILITY;
} else if (res != OK) {
sc_voltage = mp_set_subcheck_state(sc_voltage, STATE_CRITICAL);
xasprintf(&sc_voltage.output, "%s", "Failed to detect voltage");
mp_add_subcheck_to_check(&overall, sc_voltage);
mp_exit(overall);
} else {
supported_options |= UPS_UTILITY;
double ups_utility_voltage = 0.0;
ups_utility_voltage = atof(temp_buffer);
xasprintf(&sc_voltage.output, "Utility: %3.1fV", ups_utility_voltage);
double ups_utility_deviation = 0.0;
if (ups_utility_voltage > 120.0) {
ups_utility_deviation = 120.0 - ups_utility_voltage;
} else {
ups_utility_deviation = ups_utility_voltage - 120.0;
}
mp_perfdata pd_voltage_deviation = perfdata_init();
pd_voltage_deviation.label = "voltage_deviation";
pd_voltage_deviation.uom = "V";
pd_voltage_deviation.value = mp_create_pd_value(ups_utility_deviation);
pd_voltage_deviation =
mp_pd_set_thresholds(pd_voltage_deviation, config.utility_thresholds);
sc_voltage = mp_set_subcheck_state(sc_voltage, mp_get_pd_status(pd_voltage_deviation));
mp_add_perfdata_to_subcheck(&sc_voltage, pd_voltage_deviation);
mp_perfdata pd_voltage = perfdata_init();
pd_voltage.label = "voltage";
pd_voltage.uom = "V";
pd_voltage.value = mp_create_pd_value(ups_utility_voltage);
mp_add_perfdata_to_subcheck(&sc_voltage, pd_voltage);
mp_add_subcheck_to_check(&overall, sc_voltage);
}
/* get the ups battery percent if possible */
mp_subcheck sc_battery_charge = mp_subcheck_init();
sc_battery_charge = mp_set_subcheck_default_state(sc_battery_charge, STATE_OK);
res = get_ups_variable("battery.charge", temp_buffer, config);
if (res == NOSUCHVAR) {
supported_options &= ~UPS_BATTPCT;
} else if (res != OK) {
sc_battery_charge = mp_set_subcheck_state(sc_battery_charge, STATE_CRITICAL);
xasprintf(&sc_battery_charge.output, "%s", "Failed to detect battery charge");
mp_add_subcheck_to_check(&overall, sc_battery_charge);
mp_exit(overall);
} else {
supported_options |= UPS_BATTPCT;
double ups_battery_percent = atof(temp_buffer);
xasprintf(&sc_battery_charge.output, "Battery charge: %3.1f%%", ups_battery_percent);
mp_perfdata pd_battery_charge = perfdata_init();
pd_battery_charge = mp_set_pd_value(pd_battery_charge, ups_battery_percent);
pd_battery_charge.label = "battery";
pd_battery_charge.uom = "%";
pd_battery_charge = mp_pd_set_thresholds(pd_battery_charge, config.battery_thresholds);
mp_add_perfdata_to_subcheck(&sc_battery_charge, pd_battery_charge);
sc_battery_charge =
mp_set_subcheck_state(sc_battery_charge, mp_get_pd_status(pd_battery_charge));
// if (config.check_crit && ups_battery_percent <= config.critical_value) {
// } else if (config.check_warn && ups_battery_percent <= config.warning_value) {
mp_add_subcheck_to_check(&overall, sc_battery_charge);
}
/* get the ups load percent if possible */
res = get_ups_variable("ups.load", temp_buffer, config);
mp_subcheck sc_load_percent = mp_subcheck_init();
mp_set_subcheck_default_state(sc_load_percent, STATE_OK);
if (res == NOSUCHVAR) {
supported_options &= ~UPS_LOADPCT;
} else if (res != OK) {
sc_load_percent = mp_set_subcheck_state(sc_load_percent, STATE_CRITICAL);
xasprintf(&sc_load_percent.output, "%s", "Failed to detect load");
mp_add_subcheck_to_check(&overall, sc_load_percent);
mp_exit(overall);
} else {
supported_options |= UPS_LOADPCT;
double ups_load_percent = atof(temp_buffer);
xasprintf(&sc_load_percent.output, "Load :%3.1f%% ", ups_load_percent);
mp_perfdata pd_load_percent = perfdata_init();
pd_load_percent.label = "load";
pd_load_percent.uom = "%";
pd_load_percent.value = mp_create_pd_value(ups_load_percent);
pd_load_percent = mp_pd_set_thresholds(pd_load_percent, config.load_thresholds);
sc_load_percent = mp_set_subcheck_state(sc_load_percent, mp_get_pd_status(pd_load_percent));
// if (config.check_crit && ups_load_percent >= config.critical_value) {
// } else if (config.check_warn && ups_load_percent >= config.warning_value) {
}
/* get the ups temperature if possible */
res = get_ups_variable("ups.temperature", temp_buffer, config);
mp_subcheck sc_temperature = mp_subcheck_init();
sc_temperature = mp_set_subcheck_default_state(sc_temperature, STATE_OK);
if (res == NOSUCHVAR) {
supported_options &= ~UPS_TEMP;
} else if (res != OK) {
sc_temperature = mp_set_subcheck_state(sc_temperature, STATE_CRITICAL);
xasprintf(&sc_temperature.output, "%s", "Failed to detect temperature");
mp_add_subcheck_to_check(&overall, sc_temperature);
mp_exit(overall);
} else {
supported_options |= UPS_TEMP;
double ups_temperature = atof(temp_buffer);
mp_perfdata pd_temperature = perfdata_init();
pd_temperature.label = "temp";
if (config.temp_output_c) {
xasprintf(&sc_temperature.output, "Temperature: %3.1fC", ups_temperature);
pd_temperature.uom = "C";
} else {
ups_temperature = (ups_temperature * 1.8) + 32;
xasprintf(&sc_temperature.output, "Temperature: %3.1fF", ups_temperature);
pd_temperature.uom = "F";
}
pd_temperature = mp_set_pd_value(pd_temperature, ups_temperature);
pd_temperature = mp_pd_set_thresholds(pd_temperature, config.temperature_thresholds);
sc_temperature = mp_set_subcheck_state(sc_temperature, mp_get_pd_status(pd_temperature));
// if (config.check_crit && ups_temperature >= config.critical_value) {
// } else if (config.check_warn && ups_temperature >= config.warning_value) {
}
/* get the ups real power if possible */
res = get_ups_variable("ups.realpower", temp_buffer, config);
mp_subcheck sc_real_power = mp_subcheck_init();
sc_real_power = mp_set_subcheck_default_state(sc_real_power, STATE_OK);
if (res == NOSUCHVAR) {
supported_options &= ~UPS_REALPOWER;
} else if (res != OK) {
sc_real_power = mp_set_subcheck_state(sc_real_power, STATE_CRITICAL);
xasprintf(&sc_real_power.output, "%s", "Failed to detect real power");
mp_add_subcheck_to_check(&overall, sc_real_power);
mp_exit(overall);
} else {
supported_options |= UPS_REALPOWER;
double ups_realpower = atof(temp_buffer);
xasprintf(&sc_temperature.output, "Real power: %3.1fW ", ups_realpower);
mp_perfdata pd_real_power = perfdata_init();
pd_real_power.label = "realpower";
pd_real_power = mp_set_pd_value(pd_real_power, ups_realpower);
pd_real_power.uom = "W";
pd_real_power = mp_pd_set_thresholds(pd_real_power, config.real_power_thresholds);
// if (config.check_crit && ups_realpower >= config.critical_value) {
// } else if (config.check_warn && ups_realpower >= config.warning_value) {
}
/* if the UPS does not support any options we are looking for, report an
* error */
if (supported_options == UPS_NONE) {
mp_subcheck sc_any_option = mp_subcheck_init();
sc_any_option = mp_set_subcheck_state(sc_any_option, STATE_CRITICAL);
xasprintf(&sc_any_option.output, _("UPS does not support any available options\n"));
mp_add_subcheck_to_check(&overall, sc_any_option);
}
/* reset timeout */
alarm(0);
mp_exit(overall);
}
/* determines what options are supported by the UPS */
determine_status_result determine_status(const check_ups_config config) {
determine_status_result result = {
.errorcode = OK,
.ups_status = UPSSTATUS_NONE,
.supported_options = 0,
};
char recv_buffer[MAX_INPUT_BUFFER];
int res = get_ups_variable("ups.status", recv_buffer, config);
if (res == NOSUCHVAR) {
return result;
}
if (res != STATE_OK) {
printf("%s\n", _("Invalid response received from host"));
result.errorcode = ERROR;
return result;
}
result.supported_options |= UPS_STATUS;
char temp_buffer[MAX_INPUT_BUFFER];
strcpy(temp_buffer, recv_buffer);
for (char *ptr = strtok(temp_buffer, " "); ptr != NULL; ptr = strtok(NULL, " ")) {
if (!strcmp(ptr, "OFF")) {
result.ups_status |= UPSSTATUS_OFF;
} else if (!strcmp(ptr, "OL")) {
result.ups_status |= UPSSTATUS_OL;
} else if (!strcmp(ptr, "OB")) {
result.ups_status |= UPSSTATUS_OB;
} else if (!strcmp(ptr, "LB")) {
result.ups_status |= UPSSTATUS_LB;
} else if (!strcmp(ptr, "CAL")) {
result.ups_status |= UPSSTATUS_CAL;
} else if (!strcmp(ptr, "RB")) {
result.ups_status |= UPSSTATUS_RB;
} else if (!strcmp(ptr, "BYPASS")) {
result.ups_status |= UPSSTATUS_BYPASS;
} else if (!strcmp(ptr, "OVER")) {
result.ups_status |= UPSSTATUS_OVER;
} else if (!strcmp(ptr, "TRIM")) {
result.ups_status |= UPSSTATUS_TRIM;
} else if (!strcmp(ptr, "BOOST")) {
result.ups_status |= UPSSTATUS_BOOST;
} else if (!strcmp(ptr, "CHRG")) {
result.ups_status |= UPSSTATUS_CHRG;
} else if (!strcmp(ptr, "DISCHRG")) {
result.ups_status |= UPSSTATUS_DISCHRG;
} else if (!strcmp(ptr, "ALARM")) {
result.ups_status |= UPSSTATUS_ALARM;
} else {
result.ups_status |= UPSSTATUS_UNKNOWN;
}
}
return result;
}
/* gets a variable value for a specific UPS */
int get_ups_variable(const char *varname, char *buf, const check_ups_config config) {
char send_buffer[MAX_INPUT_BUFFER];
/* create the command string to send to the UPS daemon */
/* Add LOGOUT to avoid read failure logs */
int res = snprintf(send_buffer, sizeof(send_buffer), "GET VAR %s %s\nLOGOUT\n", config.ups_name,
varname);
if ((res > 0) && ((size_t)res >= sizeof(send_buffer))) {
printf("%s\n", _("UPS name to long for buffer"));
return ERROR;
}
char temp_buffer[MAX_INPUT_BUFFER];
/* send the command to the daemon and get a response back */
if (process_tcp_request(config.server_address, config.server_port, send_buffer, temp_buffer,
sizeof(temp_buffer)) != STATE_OK) {
printf("%s\n", _("Invalid response received from host"));
return ERROR;
}
char *ptr = temp_buffer;
int len = strlen(ptr);
const char *logout = "OK Goodbye\n";
const int logout_len = strlen(logout);
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"), config.ups_name);
return ERROR;
}
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 (strncmp(ptr, "ERR", 3) == 0) {
printf(_("Unknown error: %s\n"), ptr);
return ERROR;
}
ptr = temp_buffer + strlen(varname) + strlen(config.ups_name) + 6;
len = strlen(ptr);
if (len < 2 || ptr[0] != '"' || ptr[len - 1] != '"') {
printf("%s\n", _("Error: unable to parse variable"));
return ERROR;
}
*buf = 0;
strncpy(buf, ptr + 1, len - 2);
buf[len - 2] = 0;
return OK;
}
/* Command line: CHECK_UPS -H <host_address> -u ups [-p port] [-v variable]
[-wv warn_value] [-cv crit_value] [-to to_sec] */
/* process command-line arguments */
check_ups_config_wrapper process_arguments(int argc, char **argv) {
static struct option longopts[] = {{"hostname", required_argument, 0, 'H'},
{"ups", required_argument, 0, 'u'},
{"port", required_argument, 0, 'p'},
{"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'},
{0, 0, 0, 0}};
check_ups_config_wrapper result = {
.errorcode = OK,
.config = check_ups_config_init(),
};
if (argc < 2) {
result.errorcode = ERROR;
return result;
}
for (int i = 1; i < argc; i++) {
if (strcmp("-to", argv[i]) == 0) {
strcpy(argv[i], "-t");
} else if (strcmp("-wt", argv[i]) == 0) {
strcpy(argv[i], "-w");
} else if (strcmp("-ct", argv[i]) == 0) {
strcpy(argv[i], "-c");
}
}
int option = 0;
ups_test_type test_selection = UPS_NONE;
mp_thresholds tmp_thr = mp_thresholds_init();
while (true) {
int counter = getopt_long(argc, argv, "hVTH:u:p:v:c:w:t:", longopts, &option);
if (counter == -1 || counter == EOF) {
break;
}
switch (counter) {
case '?': /* help */
usage5();
case 'H': /* hostname */
if (is_host(optarg)) {
result.config.server_address = optarg;
} else {
usage2(_("Invalid hostname/address"), optarg);
}
break;
case 'T': /* FIXME: to be improved (ie "-T C" for Celsius or "-T F" for
Fahrenheit) */
result.config.temp_output_c = true;
break;
case 'u': /* ups name */
result.config.ups_name = optarg;
break;
case 'p': /* port */
if (is_intpos(optarg)) {
result.config.server_port = atoi(optarg);
} else {
usage2(_("Port must be a positive integer"), optarg);
}
break;
case 'c': /* critical voltage threshold */
if (is_intnonneg(optarg)) {
mp_range_parsed tmp = mp_parse_range_string(optarg);
if (tmp.error != MP_PARSING_SUCCESS) {
usage2(_("Critical voltage must be a valid range expression"), optarg);
} else {
tmp_thr = mp_thresholds_set_crit(tmp_thr, tmp.range);
}
} else {
usage2(_("Critical voltage must be a positive integer"), optarg);
}
break;
case 'w': /* warning voltage threshold */
if (is_intnonneg(optarg)) {
mp_range_parsed tmp = mp_parse_range_string(optarg);
if (tmp.error != MP_PARSING_SUCCESS) {
usage2(_("Warning voltage must be a valid range expression"), optarg);
} else {
tmp_thr = mp_thresholds_set_warn(tmp_thr, tmp.range);
}
} else {
usage2(_("Warning voltage must be a positive integer"), optarg);
}
break;
case 'v': /* variable */
if (!strcmp(optarg, "LINE")) {
test_selection = UPS_UTILITY;
} else if (!strcmp(optarg, "TEMP")) {
test_selection = UPS_TEMP;
} else if (!strcmp(optarg, "BATTPCT")) {
test_selection = UPS_BATTPCT;
} else if (!strcmp(optarg, "LOADPCT")) {
test_selection = UPS_LOADPCT;
} else if (!strcmp(optarg, "REALPOWER")) {
test_selection = UPS_REALPOWER;
} else {
usage2(_("Unrecognized UPS variable"), optarg);
}
break;
case 't': /* timeout */
if (is_intnonneg(optarg)) {
socket_timeout = atoi(optarg);
} else {
usage4(_("Timeout interval must be a positive integer"));
}
break;
case 'V': /* version */
print_revision(progname, NP_VERSION);
exit(STATE_UNKNOWN);
case 'h': /* help */
print_help();
exit(STATE_UNKNOWN);
}
}
if (result.config.server_address == NULL && argc > optind) {
if (is_host(argv[optind])) {
result.config.server_address = argv[optind++];
} else {
usage2(_("Invalid hostname/address"), optarg);
}
}
if (result.config.server_address == NULL) {
result.config.server_address = strdup("127.0.0.1");
}
switch (test_selection) {
case UPS_UTILITY:
result.config.utility_thresholds = tmp_thr;
case UPS_BATTPCT:
result.config.battery_thresholds = tmp_thr;
case UPS_LOADPCT:
result.config.load_thresholds = tmp_thr;
case UPS_REALPOWER:
result.config.real_power_thresholds = tmp_thr;
case UPS_TEMP:
result.config.temperature_thresholds = tmp_thr;
case UPS_NONE:
case UPS_STATUS:
default: {
}
}
return validate_arguments(result);
}
check_ups_config_wrapper validate_arguments(check_ups_config_wrapper config_wrapper) {
if (config_wrapper.config.ups_name) {
printf("%s\n", _("Error : no UPS indicated"));
config_wrapper.errorcode = ERROR;
}
return config_wrapper;
}
void print_help(void) {
print_revision(progname, NP_VERSION);
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("%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("\n\n");
print_usage();
printf(UT_HELP_VRSN);
printf(UT_EXTRA_OPTS);
char *myport;
xasprintf(&myport, "%d", PORT);
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, LOADPCT or REALPOWER");
printf(" %s\n", "-w, --warning");
printf(" %s\n", _("Set warning threshold on metric selected via --variable"));
printf(" %s\n", "-c, --critical");
printf(" %s\n", _("Set critical threshold on metric selected via --variable"));
printf(UT_CONN_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"));
printf(UT_SUPPORT);
}
void print_usage(void) {
printf("%s\n", _("Usage:"));
printf("%s -H host -u ups [-p port] [-v variable] [-w warn_value] [-c "
"crit_value] [-to to_sec] [-T]\n",
progname);
}