upstream/monitoring-plugins
1
0
Fork 0
mirror of https://github.com/monitoring-plugins/monitoring-plugins.git synced 2026-02-16 09:09:01 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions 3
monitoring-plugins/plugins/check_snmp.c
Karl DeBisschop 5ed7e0a148 reorder for consistency (no code changes) 
git-svn-id: https://nagiosplug.svn.sourceforge.net/svnroot/nagiosplug/nagiosplug/trunk@657 f882894a-f735-0410-b71e-b25c423dba1c
2003-08-07 12:00:18 +00:00

966 lines
26 KiB
C
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/******************************************************************************
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.
******************************************************************************/
const char *progname = "check_snmp";
const char *revision = "$Revision$";
const char *copyright = "1999-2003";
const char *email = "nagiosplug-devel@lists.sourceforge.net";
#include "common.h"
#include "utils.h"
#include "popen.h"
#define DEFAULT_COMMUNITY "public"
#define DEFAULT_PORT "161"
#define DEFAULT_MIBLIST "ALL"
#define DEFAULT_PROTOCOL "1"
#define DEFAULT_AUTH_PROTOCOL "MD5"
#define DEFAULT_DELIMITER "="
#define DEFAULT_OUTPUT_DELIMITER " "
#define mark(a) ((a)!=0?"*":"")
#define CHECK_UNDEF 0
#define CRIT_PRESENT 1
#define CRIT_STRING 2
#define CRIT_REGEX 4
#define CRIT_GT 8
#define CRIT_LT 16
#define CRIT_GE 32
#define CRIT_LE 64
#define CRIT_EQ 128
#define CRIT_NE 256
#define CRIT_RANGE 512
#define WARN_PRESENT 1024
#define WARN_STRING 2048
#define WARN_REGEX 4096
#define WARN_GT 8192
#define WARN_LT 16384
#define WARN_GE 32768
#define WARN_LE 65536
#define WARN_EQ 131072
#define WARN_NE 262144
#define WARN_RANGE 524288
#define MAX_OIDS 8
#define MAX_DELIM_LENGTH 8
int process_arguments (int, char **);
int validate_arguments (void);
char *clarify_message (char *);
int check_num (int);
int lu_getll (unsigned long *, char *);
int lu_getul (unsigned long *, char *);
char *thisarg (char *str);
char *nextarg (char *str);
void print_usage (void);
void print_help (void);
#ifdef HAVE_REGEX_H
#include <regex.h>
char regex_expect[MAX_INPUT_BUFFER] = "";
regex_t preg;
regmatch_t pmatch[10];
char timestamp[10] = "";
char errbuf[MAX_INPUT_BUFFER];
int cflags = REG_EXTENDED | REG_NOSUB | REG_NEWLINE;
int eflags = 0;
int errcode, excode;
#endif
char *server_address = NULL;
char *community = DEFAULT_COMMUNITY;
char *authpriv = NULL;
char *proto = NULL;
char *seclevel = NULL;
char *secname = NULL;
char *authproto = NULL;
char *authpasswd = NULL;
char *privpasswd = NULL;
char *oid = "";
char *label = "SNMP";
char *units = "";
char *port = DEFAULT_PORT;
char string_value[MAX_INPUT_BUFFER] = "";
char **labels = NULL;
char **unitv = NULL;
int nlabels = 0;
int labels_size = 8;
int nunits = 0;
int unitv_size = 8;
int verbose = FALSE;
unsigned long lower_warn_lim[MAX_OIDS];
unsigned long upper_warn_lim[MAX_OIDS];
unsigned long lower_crit_lim[MAX_OIDS];
unsigned long upper_crit_lim[MAX_OIDS];
unsigned long response_value[MAX_OIDS];
int check_warning_value = FALSE;
int check_critical_value = FALSE;
int eval_method[MAX_OIDS];
char *delimiter = DEFAULT_DELIMITER;
char *output_delim = DEFAULT_OUTPUT_DELIMITER;
char *miblist = DEFAULT_MIBLIST;
int
main (int argc, char **argv)
{
int i = 0;
int iresult = STATE_UNKNOWN;
int found = 0;
int result = STATE_DEPENDENT;
char input_buffer[MAX_INPUT_BUFFER];
char *command_line = NULL;
char *response = NULL;
char *outbuff = "";
char *output = "";
char *ptr = NULL;
char *p2 = NULL;
char *show = NULL;
labels = malloc (labels_size);
unitv = malloc (unitv_size);
for (i = 0; i < MAX_OIDS; i++)
eval_method[i] = CHECK_UNDEF;
i = 0;
if (process_arguments (argc, argv) == ERROR)
usage (_("Incorrect arguments supplied\n"));
/* create the command line to execute */
asprintf (&command_line, "%s -t 1 -r %d -m %s -v %s %s %s:%s %s",
PATH_TO_SNMPGET, timeout_interval - 1, miblist, proto,
authpriv, server_address, port, oid);
if (verbose)
printf ("%s\n", command_line);
/* run the command */
child_process = spopen (command_line);
if (child_process == NULL) {
printf (_("Could not open pipe: %s\n"), command_line);
exit (STATE_UNKNOWN);
}
child_stderr = fdopen (child_stderr_array[fileno (child_process)], "r");
if (child_stderr == NULL) {
printf (_("Could not open stderr for %s\n"), command_line);
}
while (fgets (input_buffer, MAX_INPUT_BUFFER - 1, child_process))
asprintf (&output, "%s%s", output, input_buffer);
if (verbose)
printf ("%s\n", output);
ptr = output;
while (ptr) {
ptr = strstr (ptr, delimiter);
if (ptr == NULL)
break;
ptr += strlen (delimiter);
ptr += strspn (ptr, " ");
found++;
if (ptr[0] == '"') {
ptr++;
response = strpcpy (response, ptr, "\"");
ptr = strpbrk (ptr, "\"");
ptr += strspn (ptr, "\"\n");
}
else {
response = strpcpy (response, ptr, "\n");
ptr = strpbrk (ptr, "\n");
ptr += strspn (ptr, "\n");
while
(strstr (ptr, delimiter) &&
strstr (ptr, "\n") && strstr (ptr, "\n") < strstr (ptr, delimiter)) {
response = strpcat (response, ptr, "\n");
ptr = strpbrk (ptr, "\n");
}
if (ptr && strstr (ptr, delimiter) == NULL) {
response = strscat (response, ptr);
ptr = NULL;
}
}
/* We strip out the datatype indicator for PHBs */
if (strstr (response, "Gauge: "))
show = strstr (response, "Gauge: ") + 7;
else if (strstr (response, "Gauge32: "))
show = strstr (response, "Gauge32: ") + 9;
else if (strstr (response, "Counter32: "))
show = strstr (response, "Counter32: ") + 11;
else if (strstr (response, "INTEGER: "))
show = strstr (response, "INTEGER: ") + 9;
else if (strstr (response, "STRING: "))
show = strstr (response, "STRING: ") + 8;
else
show = response;
p2 = show;
iresult = STATE_DEPENDENT;
/* Process this block for integer comparisons */
if (eval_method[i] & CRIT_GT ||
eval_method[i] & CRIT_LT ||
eval_method[i] & CRIT_GE ||
eval_method[i] & CRIT_LE ||
eval_method[i] & CRIT_EQ ||
eval_method[i] & CRIT_NE ||
eval_method[i] & WARN_GT ||
eval_method[i] & WARN_LT ||
eval_method[i] & WARN_GE ||
eval_method[i] & WARN_LE ||
eval_method[i] & WARN_EQ ||
eval_method[i] & WARN_NE) {
p2 = strpbrk (p2, "0123456789");
if (p2 == NULL)
die (STATE_UNKNOWN,"No valid data returned");
response_value[i] = strtoul (p2, NULL, 10);
iresult = check_num (i);
asprintf (&show, "%lu", response_value[i]);
}
/* Process this block for string matching */
else if (eval_method[i] & CRIT_STRING) {
if (strcmp (response, string_value))
iresult = STATE_CRITICAL;
else
iresult = STATE_OK;
}
/* Process this block for regex matching */
else if (eval_method[i] & CRIT_REGEX) {
#ifdef HAVE_REGEX_H
excode = regexec (&preg, response, 10, pmatch, eflags);
if (excode == 0) {
iresult = STATE_OK;
}
else if (excode != REG_NOMATCH) {
regerror (excode, &preg, errbuf, MAX_INPUT_BUFFER);
printf (_("Execute Error: %s\n"), errbuf);
exit (STATE_CRITICAL);
}
else {
iresult = STATE_CRITICAL;
}
#else
printf (_("%s UNKNOWN: call for regex which was not a compiled option"), label);
exit (STATE_UNKNOWN);
#endif
}
/* Process this block for existence-nonexistence checks */
else {
if (eval_method[i] & CRIT_PRESENT)
iresult = STATE_CRITICAL;
else if (eval_method[i] & WARN_PRESENT)
iresult = STATE_WARNING;
else if (response && iresult == STATE_DEPENDENT)
iresult = STATE_OK;
}
/* Result is the worst outcome of all the OIDs tested */
result = max_state (result, iresult);
/* Prepend a label for this OID if there is one */
if (nlabels > 1 && i < nlabels && labels[i] != NULL)
asprintf (&outbuff, "%s%s%s %s%s%s", outbuff,
(i == 0) ? " " : output_delim,
labels[i], mark (iresult), show, mark (iresult));
else
asprintf (&outbuff, "%s%s%s%s%s", outbuff, (i == 0) ? " " : output_delim,
mark (iresult), show, mark (iresult));
/* Append a unit string for this OID if there is one */
if (nunits > 0 && i < nunits && unitv[i] != NULL)
asprintf (&outbuff, "%s %s", outbuff, unitv[i]);
i++;
} /* end while (ptr) */
if (found == 0)
die (STATE_UNKNOWN,
_("%s problem - No data recieved from host\nCMD: %s\n"),
label,
command_line);
/* WARNING if output found on stderr */
if (fgets (input_buffer, MAX_INPUT_BUFFER - 1, child_stderr))
result = max_state (result, STATE_WARNING);
/* close stderr */
(void) fclose (child_stderr);
/* close the pipe */
if (spclose (child_process))
result = max_state (result, STATE_WARNING);
/* if (nunits == 1 || i == 1) */
/* printf ("%s %s -%s %s\n", label, state_text (result), outbuff, units); */
/* else */
printf ("%s %s -%s\n", label, state_text (result), outbuff);
return result;
}
/* process command-line arguments */
int
process_arguments (int argc, char **argv)
{
char *ptr;
int c = 1;
int j = 0, jj = 0, ii = 0;
int option_index = 0;
static struct option long_options[] = {
STD_LONG_OPTS,
{"community", required_argument, 0, 'C'},
{"oid", required_argument, 0, 'o'},
{"object", required_argument, 0, 'o'},
{"delimiter", required_argument, 0, 'd'},
{"output-delimiter", required_argument, 0, 'D'},
{"string", required_argument, 0, 's'},
{"regex", required_argument, 0, 'r'},
{"ereg", required_argument, 0, 'r'},
{"eregi", required_argument, 0, 'R'},
{"label", required_argument, 0, 'l'},
{"units", required_argument, 0, 'u'},
{"port", required_argument, 0, 'p'},
{"miblist", required_argument, 0, 'm'},
{"protocol", required_argument, 0, 'P'},
{"seclevel", required_argument, 0, 'L'},
{"secname", required_argument, 0, 'U'},
{"authproto", required_argument, 0, 'a'},
{"authpasswd", required_argument, 0, 'A'},
{"privpasswd", required_argument, 0, 'X'},
{0, 0, 0, 0}
};
if (argc < 2)
return ERROR;
/* reverse compatibility for very old non-POSIX usage forms */
for (c = 1; c < argc; c++) {
if (strcmp ("-to", argv[c]) == 0)
strcpy (argv[c], "-t");
if (strcmp ("-wv", argv[c]) == 0)
strcpy (argv[c], "-w");
if (strcmp ("-cv", argv[c]) == 0)
strcpy (argv[c], "-c");
}
while (1) {
c = getopt_long (argc, argv, "hvVt:c:w:H:C:o:e:E:d:D:s:R:r:l:u:p:m:P:L:U:a:A:X:",
long_options, &option_index);
if (c == -1 || c == EOF)
break;
switch (c) {
case '?': /* usage */
usage3 ("Unknown argument", optopt);
case 'h': /* help */
print_help ();
exit (STATE_OK);
case 'V': /* version */
print_revision (progname, revision);
exit (STATE_OK);
case 'v': /* verbose */
verbose = TRUE;
break;
/* Connection info */
case 'C': /* group or community */
community = strscpy (community, optarg);
break;
case 'H': /* Host or server */
server_address = strscpy (server_address, optarg);
break;
case 'p': /* TCP port number */
port = strscpy(port, optarg);
break;
case 'm': /* List of MIBS */
miblist = strscpy(miblist, optarg);
break;
case 'P': /* SNMP protocol version */
proto = strscpy(proto, optarg);
break;
case 'L': /* security level */
seclevel = strscpy(seclevel,optarg);
break;
case 'U': /* security username */
secname = strscpy(secname, optarg);
break;
case 'a': /* auth protocol */
asprintf (&authproto, optarg);
break;
case 'A': /* auth passwd */
authpasswd = strscpy(authpasswd, optarg);
break;
case 'X': /* priv passwd */
privpasswd = strscpy(privpasswd, optarg);
break;
case 't': /* timeout period */
if (!is_integer (optarg))
usage2 (_("Timeout Interval must be an integer"), optarg);
timeout_interval = atoi (optarg);
break;
/* Test parameters */
case 'c': /* critical time threshold */
if (strspn (optarg, "0123456789:,") < strlen (optarg)) {
printf (_("Invalid critical threshold: %s\n"), optarg);
print_usage ();
exit (STATE_UNKNOWN);
}
for (ptr = optarg; ptr && jj < MAX_OIDS; jj++) {
if (lu_getll (&lower_crit_lim[jj], ptr) == 1)
eval_method[jj] |= CRIT_LT;
if (lu_getul (&upper_crit_lim[jj], ptr) == 1)
eval_method[jj] |= CRIT_GT;
(ptr = index (ptr, ',')) ? ptr++ : ptr;
}
break;
case 'w': /* warning time threshold */
if (strspn (optarg, "0123456789:,") < strlen (optarg)) {
printf (_("Invalid warning threshold: %s\n"), optarg);
print_usage ();
exit (STATE_UNKNOWN);
}
for (ptr = optarg; ptr && ii < MAX_OIDS; ii++) {
if (lu_getll (&lower_warn_lim[ii], ptr) == 1)
eval_method[ii] |= WARN_LT;
if (lu_getul (&upper_warn_lim[ii], ptr) == 1)
eval_method[ii] |= WARN_GT;
(ptr = index (ptr, ',')) ? ptr++ : ptr;
}
break;
case 'o': /* object identifier */
case 'e': /* PRELIMINARY - may change */
case 'E': /* PRELIMINARY - may change */
for (ptr = optarg; (ptr = index (ptr, ',')); ptr++)
ptr[0] = ' '; /* relpace comma with space */
for (ptr = optarg; (ptr = index (ptr, ' ')); ptr++)
j++; /* count OIDs */
asprintf (&oid, "%s %s", (oid?oid:""), optarg);
if (c == 'E' || c == 'e') {
jj++;
ii++;
}
if (c == 'E')
eval_method[j+1] |= WARN_PRESENT;
else if (c == 'e')
eval_method[j+1] |= CRIT_PRESENT;
break;
case 's': /* string or substring */
strncpy (string_value, optarg, sizeof (string_value) - 1);
string_value[sizeof (string_value) - 1] = 0;
eval_method[jj++] = CRIT_STRING;
ii++;
break;
case 'R': /* regex */
#ifdef HAVE_REGEX_H
cflags = REG_ICASE;
#endif
case 'r': /* regex */
#ifdef HAVE_REGEX_H
cflags |= REG_EXTENDED | REG_NOSUB | REG_NEWLINE;
strncpy (regex_expect, optarg, sizeof (regex_expect) - 1);
regex_expect[sizeof (regex_expect) - 1] = 0;
errcode = regcomp (&preg, regex_expect, cflags);
if (errcode != 0) {
regerror (errcode, &preg, errbuf, MAX_INPUT_BUFFER);
printf (_("Could Not Compile Regular Expression"));
return ERROR;
}
eval_method[jj++] = CRIT_REGEX;
ii++;
#else
printf (_("%s UNKNOWN: call for regex which was not a compiled option"), label);
exit (STATE_UNKNOWN);
#endif
break;
/* Format */
case 'd': /* delimiter */
delimiter = strscpy (delimiter, optarg);
break;
case 'D': /* output-delimiter */
output_delim = strscpy (output_delim, optarg);
break;
case 'l': /* label */
label = optarg;
nlabels++;
if (nlabels >= labels_size) {
labels_size += 8;
labels = realloc (labels, labels_size);
if (labels == NULL)
die (STATE_UNKNOWN,
_("Could not realloc() labels[%d]"), nlabels);
}
labels[nlabels - 1] = optarg;
ptr = thisarg (optarg);
if (strstr (ptr, "'") == ptr)
labels[nlabels - 1] = ptr + 1;
else
labels[nlabels - 1] = ptr;
while (ptr && (ptr = nextarg (ptr))) {
if (nlabels >= labels_size) {
labels_size += 8;
labels = realloc (labels, labels_size);
if (labels == NULL)
die (STATE_UNKNOWN, _("Could not realloc() labels\n"));
}
labels++;
ptr = thisarg (ptr);
if (strstr (ptr, "'") == ptr)
labels[nlabels - 1] = ptr + 1;
else
labels[nlabels - 1] = ptr;
}
break;
case 'u': /* units */
units = optarg;
nunits++;
if (nunits >= unitv_size) {
unitv_size += 8;
unitv = realloc (unitv, unitv_size);
if (unitv == NULL)
die (STATE_UNKNOWN,
_("Could not realloc() units [%d]\n"), nunits);
}
unitv[nunits - 1] = optarg;
ptr = thisarg (optarg);
if (strstr (ptr, "'") == ptr)
unitv[nunits - 1] = ptr + 1;
else
unitv[nunits - 1] = ptr;
while (ptr && (ptr = nextarg (ptr))) {
if (nunits >= unitv_size) {
unitv_size += 8;
unitv = realloc (unitv, unitv_size);
if (units == NULL)
die (STATE_UNKNOWN, _("Could not realloc() units\n"));
}
nunits++;
ptr = thisarg (ptr);
if (strstr (ptr, "'") == ptr)
unitv[nunits - 1] = ptr + 1;
else
unitv[nunits - 1] = ptr;
}
break;
}
}
if (server_address == NULL)
asprintf (&server_address, argv[optind]);
return validate_arguments ();
}
/******************************************************************************
@@-
<sect3>
<title>validate_arguments</title>
<para>&PROTO_validate_arguments;</para>
<para>Given a database name, this function returns TRUE if the string
is a valid PostgreSQL database name, and returns false if it is
not.</para>
<para>Valid PostgreSQL database names are less than &NAMEDATALEN;
characters long and consist of letters, numbers, and underscores. The
first character cannot be a number, however.</para>
</sect3>
-@@
******************************************************************************/
int
validate_arguments ()
{
/* Need better checks to verify seclevel and authproto choices */
if (seclevel == NULL)
asprintf (&seclevel, "noAuthNoPriv");
if (authproto == NULL )
asprintf(&authproto, DEFAULT_AUTH_PROTOCOL);
if (proto == NULL || (strcmp(proto,DEFAULT_PROTOCOL) == 0) ) { /* default protocol version */
asprintf(&proto, DEFAULT_PROTOCOL);
asprintf(&authpriv, "%s%s", "-c ", community);
}
else if ( strcmp (proto, "3") == 0 ) { /* snmpv3 args */
asprintf(&proto, "%s", "3");
if ( (strcmp(seclevel, "noAuthNoPriv") == 0) || seclevel == NULL ) {
asprintf(&authpriv, "%s", "-l noAuthNoPriv" );
}
else if ( strcmp(seclevel, "authNoPriv") == 0 ) {
if ( secname == NULL || authpasswd == NULL) {
printf (_("Missing secname (%s) or authpassword (%s) ! \n)"),secname, authpasswd );
print_usage ();
exit (STATE_UNKNOWN);
}
asprintf(&authpriv, "-l authNoPriv -a %s -u %s -A %s ", authproto, secname, authpasswd);
}
else if ( strcmp(seclevel, "authPriv") == 0 ) {
if ( secname == NULL || authpasswd == NULL || privpasswd == NULL ) {
printf (("Missing secname (%s), authpassword (%s), or privpasswd (%s)! \n"),secname, authpasswd,privpasswd );
print_usage ();
exit (STATE_UNKNOWN);
}
asprintf(&authpriv, "-l authPriv -a %s -u %s -A %s -x DES -X %s ", authproto, secname, authpasswd, privpasswd);
}
}
else {
printf (_("Invalid SNMP version: %s\n"), proto);
print_usage ();
exit (STATE_UNKNOWN);
}
return OK;
}
char *
clarify_message (char *msg)
{
int i = 0;
int foo;
char tmpmsg_c[MAX_INPUT_BUFFER];
char *tmpmsg = (char *) &tmpmsg_c;
tmpmsg = strcpy (tmpmsg, msg);
if (!strncmp (tmpmsg, " Hex:", 5)) {
tmpmsg = strtok (tmpmsg, ":");
while ((tmpmsg = strtok (NULL, " "))) {
foo = strtol (tmpmsg, NULL, 16);
/* Translate chars that are not the same value in the printers
* character set.
*/
switch (foo) {
case 208:
{
foo = 197;
break;
}
case 216:
{
foo = 196;
break;
}
}
msg[i] = foo;
i++;
}
msg[i] = 0;
}
return (msg);
}
int
check_num (int i)
{
int result;
result = STATE_OK;
if (eval_method[i] & WARN_GT && eval_method[i] & WARN_LT &&
lower_warn_lim[i] > upper_warn_lim[i]) {
if (response_value[i] <= lower_warn_lim[i] &&
response_value[i] >= upper_warn_lim[i]) {
result = STATE_WARNING;
}
}
else if
((eval_method[i] & WARN_GT && response_value[i] > upper_warn_lim[i]) ||
(eval_method[i] & WARN_GE && response_value[i] >= upper_warn_lim[i]) ||
(eval_method[i] & WARN_LT && response_value[i] < lower_warn_lim[i]) ||
(eval_method[i] & WARN_LE && response_value[i] <= lower_warn_lim[i]) ||
(eval_method[i] & WARN_EQ && response_value[i] == upper_warn_lim[i]) ||
(eval_method[i] & WARN_NE && response_value[i] != upper_warn_lim[i])) {
result = STATE_WARNING;
}
if (eval_method[i] & CRIT_GT && eval_method[i] & CRIT_LT &&
lower_warn_lim[i] > upper_warn_lim[i]) {
if (response_value[i] <= lower_crit_lim[i] &&
response_value[i] >= upper_crit_lim[i]) {
result = STATE_CRITICAL;
}
}
else if
((eval_method[i] & CRIT_GT && response_value[i] > upper_crit_lim[i]) ||
(eval_method[i] & CRIT_GE && response_value[i] >= upper_crit_lim[i]) ||
(eval_method[i] & CRIT_LT && response_value[i] < lower_crit_lim[i]) ||
(eval_method[i] & CRIT_LE && response_value[i] <= lower_crit_lim[i]) ||
(eval_method[i] & CRIT_EQ && response_value[i] == upper_crit_lim[i]) ||
(eval_method[i] & CRIT_NE && response_value[i] != upper_crit_lim[i])) {
result = STATE_CRITICAL;
}
return result;
}
int
lu_getll (unsigned long *ll, char *str)
{
char tmp[100];
if (strchr (str, ':') == NULL)
return 0;
if (strchr (str, ',') != NULL && (strchr (str, ',') < strchr (str, ':')))
return 0;
if (sscanf (str, "%lu%[:]", ll, tmp) == 2)
return 1;
return 0;
}
int
lu_getul (unsigned long *ul, char *str)
{
char tmp[100];
if (sscanf (str, "%lu%[^,]", ul, tmp) == 1)
return 1;
if (sscanf (str, ":%lu%[^,]", ul, tmp) == 1)
return 1;
if (sscanf (str, "%*u:%lu%[^,]", ul, tmp) == 1)
return 1;
return 0;
}
/* trim leading whitespace
if there is a leading quote, make sure it balances */
char *
thisarg (char *str)
{
str += strspn (str, " \t\r\n"); /* trim any leading whitespace */
if (strstr (str, "'") == str) { /* handle SIMPLE quoted strings */
if (strlen (str) == 1 || !strstr (str + 1, "'"))
die (STATE_UNKNOWN, "Unbalanced quotes\n");
}
return str;
}
/* if there's a leading quote, advance to the trailing quote
set the trailing quote to '\x0'
if the string continues, advance beyond the comma */
char *
nextarg (char *str)
{
if (strstr (str, "'") == str) {
if (strlen (str) > 1) {
str = strstr (str + 1, "'");
str[0] = 0;
return (++str);
}
else {
str[0] = 0;
return NULL;
}
}
if (strstr (str, ",") == str) {
if (strlen (str) > 1) {
str[0] = 0;
return (++str);
}
else {
str[0] = 0;
return NULL;
}
}
if ((str = strstr (str, ",")) && strlen (str) > 1) {
str[0] = 0;
return (++str);
}
return NULL;
}
void
print_help (void)
{
print_revision (progname, revision);
printf (_(COPYRIGHT), copyright, email);
printf (_("\
Check status of remote machines and obtain sustem information via SNMP\n\n"));
print_usage ();
printf (_(UT_HELP_VRSN));
printf (_(UT_HOST_PORT), 'p', DEFAULT_PORT);
/* SNMP and Authentication Protocol */
printf (_("\
-P, --protocol=[1|3]\n\
SNMP protocol version\n\
-L, --seclevel=[noAuthNoPriv|authNoPriv|authPriv]\n\
SNMPv3 securityLevel\n\
-a, --authproto=[MD5|SHA]\n\
SNMPv3 auth proto\n"));
/* Authentication Tokens*/
printf (_("\
-C, --community=STRING\n\
Optional community string for SNMP communication\n\
(default is \"%s\")\n\
-U, --secname=USERNAME\n\
SNMPv3 username\n\
-A, --authpassword=PASSWORD\n\
SNMPv3 authentication password\n\
-X, --privpasswd=PASSWORD\n\
SNMPv3 crypt passwd (DES)\n"), DEFAULT_COMMUNITY);
/* OID Stuff */
printf (_("\
-o, --oid=OID(s)\n\
Object identifier(s) whose value you wish to query\n\
-m, --miblist=STRING\n\
List of MIBS to be loaded (default = ALL)\n -d, --delimiter=STRING\n\
Delimiter to use when parsing returned data. Default is \"%s\"\n\
Any data on the right hand side of the delimiter is considered\n\
to be the data that should be used in the evaluation.\n"), DEFAULT_DELIMITER);
/* Tests Against Integers */
printf (_("\
-w, --warning=INTEGER_RANGE(s)\n\
Range(s) which will not result in a WARNING status\n\
-c, --critical=INTEGER_RANGE(s)\n\
Range(s) which will not result in a CRITICAL status\n"));
/* Tests Against Strings */
printf (_("\
-s, --string=STRING\n\
Return OK state (for that OID) if STRING is an exact match\n\
-r, --ereg=REGEX\n\
Return OK state (for that OID) if extended regular expression REGEX matches\n\
-R, --eregi=REGEX\n\
Return OK state (for that OID) if case-insensitive extended REGEX matches\n\
-l, --label=STRING\n\
Prefix label for output from plugin (default -s 'SNMP')\n"));
/* Output Formatting */
printf (_("\
-u, --units=STRING\n\
Units label(s) for output data (e.g., 'sec.').\n\
-D, --output-delimiter=STRING\n\
Separates output on multiple OID requests\n"));
printf (_(UT_TIMEOUT), DEFAULT_SOCKET_TIMEOUT);
printf (_(UT_VERBOSE));
printf (_("\n\
- This plugin uses the 'snmpget' command included with the NET-SNMP package.\n\
If you don't have the package installed, you will need to download it from\n\
http://net-snmp.sourceforge.net before you can use this plugin.\n"));
printf (_("\
- Multiple OIDs may be indicated by a comma- or space-delimited list (lists with\n\
internal spaces must be quoted) [max 8 OIDs]\n"));
printf (_("\
- Ranges are inclusive and are indicated with colons. When specified as\n\
'min:max' a STATE_OK will be returned if the result is within the indicated\n\
range or is equal to the upper or lower bound. A non-OK state will be\n\
returned if the result is outside the specified range.\n"));
printf (_("\
- If specified in the order 'max:min' a non-OK state will be returned if the\n\
result is within the (inclusive) range.\n"));
printf (_("\
- Upper or lower bounds may be omitted to skip checking the respective limit.\n\
- Bare integers are interpreted as upper limits.\n\
- When checking multiple OIDs, separate ranges by commas like '-w 1:10,1:,:20'\n\
- Note that only one string and one regex may be checked at present\n\
- All evaluation methods other than PR, STR, and SUBSTR expect that the value\n\
returned from the SNMP query is an unsigned integer.\n"));
printf (_(UT_SUPPORT));
}
void
print_usage (void)
{
printf (_("\
Usage: %s -H <ip_address> -o <OID> [-w warn_range] [-c crit_range] \n\
[-C community] [-s string] [-r regex] [-R regexi] [-t timeout]\n\
[-l label] [-u units] [-p port-number] [-d delimiter]\n\
[-D output-delimiter] [-m miblist] [-P snmp version]\n\
[-L seclevel] [-U secname] [-a authproto] [-A authpasswd]\n\
[-X privpasswd]\n"), progname);
printf (_(UT_HLP_VRS), progname, progname);
}
Reference in a new issue View git blame Copy permalink