/***************************************************************************** * * Nagios check_snmp plugin * * License: GPL * Copyright (c) 1999-2007 Nagios Plugins Development Team * * Description: * * This file contains the check_snmp plugin * * Check status of remote machines and obtain system information via SNMP * * * 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 . * * *****************************************************************************/ const char *progname = "check_snmp"; const char *copyright = "1999-2007"; const char *email = "nagiosplug-devel@lists.sourceforge.net"; #include "common.h" #include "utils.h" #include "utils_cmd.h" #define DEFAULT_COMMUNITY "public" #define DEFAULT_PORT "161" #define DEFAULT_MIBLIST "ALL" #define DEFAULT_PROTOCOL "1" #define DEFAULT_TIMEOUT 1 #define DEFAULT_RETRIES 5 #define DEFAULT_AUTH_PROTOCOL "MD5" #define DEFAULT_PRIV_PROTOCOL "DES" #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 WARN_PRESENT 8 #define WARN_STRING 16 #define WARN_REGEX 32 #define MAX_OIDS 8 /* Longopts only arguments */ #define L_CALCULATE_RATE CHAR_MAX+1 #define L_RATE_MULTIPLIER CHAR_MAX+2 #define L_INVERT_SEARCH CHAR_MAX+3 #define L_OFFSET CHAR_MAX+4 /* Gobble to string - stop incrementing c when c[0] match one of the * characters in s */ #define GOBBLE_TOS(c, s) while(c[0]!='\0' && strchr(s, c[0])==NULL) { c++; } /* Given c, keep track of backslashes (bk) and double-quotes (dq) * from c[0] */ #define COUNT_SEQ(c, bk, dq) switch(c[0]) {\ case '\\': \ if (bk) bk--; \ else bk++; \ break; \ case '"': \ if (!dq) { dq++; } \ else if(!bk) { dq--; } \ else { bk--; } \ break; \ } int process_arguments (int, char **); int validate_arguments (void); char *thisarg (char *str); char *nextarg (char *str); void print_usage (void); void print_help (void); #include "regex.h" char regex_expect[MAX_INPUT_BUFFER] = ""; regex_t preg; regmatch_t pmatch[10]; char errbuf[MAX_INPUT_BUFFER] = ""; char perfstr[MAX_INPUT_BUFFER] = "| "; int cflags = REG_EXTENDED | REG_NOSUB | REG_NEWLINE; int eflags = 0; int errcode, excode; char *server_address = NULL; char *community = NULL; char **authpriv = NULL; char *proto = NULL; char *seclevel = NULL; char *secname = NULL; char *authproto = NULL; char *privproto = NULL; char *authpasswd = NULL; char *privpasswd = NULL; char **oids = NULL; char *label; char *units; char *port; char *snmpcmd; char string_value[MAX_INPUT_BUFFER] = ""; int invert_search=0; char **labels = NULL; char **unitv = NULL; size_t nlabels = 0; size_t labels_size = 8; size_t nunits = 0; size_t unitv_size = 8; int numoids = 0; int numauthpriv = 0; int verbose = 0; int usesnmpgetnext = FALSE; char *warning_thresholds = NULL; char *critical_thresholds = NULL; thresholds *thlds[MAX_OIDS]; double response_value[MAX_OIDS]; int retries = 0; int eval_method[MAX_OIDS]; char *delimiter; char *output_delim; char *miblist = NULL; int needmibs = FALSE; int calculate_rate = 0; double offset = 0.0; int rate_multiplier = 1; state_data *previous_state; double previous_value[MAX_OIDS]; int perf_labels = 1; static char *fix_snmp_range(char *th) { double left, right; char *colon, *ret; if ((colon = strchr(th, ':')) == NULL || *(colon + 1) == '\0') return th; left = strtod(th, NULL); right = strtod(colon + 1, NULL); if (right >= left) return th; if ((ret = malloc(strlen(th) + 2)) == NULL) die(STATE_UNKNOWN, _("Cannot malloc")); *colon = '\0'; sprintf(ret, "@%s:%s", colon + 1, th); free(th); return ret; } int main (int argc, char **argv) { int i, len, line, total_oids; unsigned int bk_count = 0, dq_count = 0; int iresult = STATE_UNKNOWN; int result = STATE_UNKNOWN; int return_code = 0; int external_error = 0; char **command_line = NULL; char *cl_hidden_auth = NULL; char *oidname = NULL; char *response = NULL; char *mult_resp = NULL; char *outbuff; char *ptr = NULL; char *show = NULL; char *th_warn=NULL; char *th_crit=NULL; char type[8] = ""; output chld_out, chld_err; char *previous_string=NULL; char *ap=NULL; char *state_string=NULL; size_t response_length, current_length, string_length; char *temp_string=NULL; char *quote_string=NULL; time_t current_time; double temp_double; time_t duration; char *conv = "12345678"; int is_counter=0; setlocale (LC_ALL, ""); bindtextdomain (PACKAGE, LOCALEDIR); textdomain (PACKAGE); labels = malloc (labels_size * sizeof(*labels)); unitv = malloc (unitv_size * sizeof(*unitv)); for (i = 0; i < MAX_OIDS; i++) eval_method[i] = CHECK_UNDEF; label = strdup ("SNMP"); units = strdup (""); port = strdup (DEFAULT_PORT); outbuff = strdup (""); delimiter = strdup (" = "); output_delim = strdup (DEFAULT_OUTPUT_DELIMITER); timeout_interval = DEFAULT_TIMEOUT; retries = DEFAULT_RETRIES; np_init( (char *) progname, argc, argv ); /* Parse extra opts if any */ argv=np_extra_opts (&argc, argv, progname); np_set_args(argc, argv); if (process_arguments (argc, argv) == ERROR) usage4 (_("Could not parse arguments")); if(calculate_rate) { if (!strcmp(label, "SNMP")) label = strdup("SNMP RATE"); time(¤t_time); i=0; previous_state = np_state_read(); if(previous_state!=NULL) { /* Split colon separated values */ previous_string = strdup((char *) previous_state->data); while((ap = strsep(&previous_string, ":")) != NULL) { if(verbose>2) printf("State for %d=%s\n", i, ap); previous_value[i++]=strtod(ap,NULL); } } } /* Populate the thresholds */ th_warn=warning_thresholds; th_crit=critical_thresholds; for (i=0; i 0) { printf (_("External command error: %s\n"), chld_err.line[0]); for (i = 1; i < chld_err.lines; i++) { printf ("%s\n", chld_err.line[i]); } } else { printf(_("External command error with no output (return code: %d)\n"), return_code); } exit (STATE_UNKNOWN); } if (verbose) { for (i = 0; i < chld_out.lines; i++) { printf ("%s\n", chld_out.line[i]); } } for (line=0, i=0; line < chld_out.lines; line++, i++) { if(calculate_rate) conv = "%.10g"; else conv = "%.0f"; ptr = chld_out.line[line]; oidname = strpcpy (oidname, ptr, delimiter); response = strstr (ptr, delimiter); if (response == NULL) break; if (verbose > 2) { printf("Processing oid %i (line %i)\n oidname: %s\n response: %s\n", i+1, line+1, oidname, response); } /* Clean up type array - Sol10 does not necessarily zero it out */ bzero(type, sizeof(type)); is_counter=0; /* 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; is_counter=1; if(!calculate_rate) strcpy(type, "c"); } else if (strstr (response, "Counter64: ")) { show = strstr (response, "Counter64: ") + 11; is_counter=1; if(!calculate_rate) strcpy(type, "c"); } else if (strstr (response, "INTEGER: ")) { show = strstr (response, "INTEGER: ") + 9; } else if (strstr (response, "STRING: ")) { show = strstr (response, "STRING: ") + 8; conv = "%.10g"; /* Get the rest of the string on multi-line strings */ ptr = show; COUNT_SEQ(ptr, bk_count, dq_count) while (dq_count && ptr[0] != '\n' && ptr[0] != '\0') { ptr++; GOBBLE_TOS(ptr, "\n\"\\") COUNT_SEQ(ptr, bk_count, dq_count) } if (dq_count) { /* unfinished line */ /* copy show verbatim first */ if (!mult_resp) mult_resp = strdup(""); xasprintf (&mult_resp, "%s%s:\n%s\n", mult_resp, oids[i], show); /* then strip out unmatched double-quote from single-line output */ if (show[0] == '"') show++; /* Keep reading until we match end of double-quoted string */ for (line++; line < chld_out.lines; line++) { ptr = chld_out.line[line]; xasprintf (&mult_resp, "%s%s\n", mult_resp, ptr); COUNT_SEQ(ptr, bk_count, dq_count) while (dq_count && ptr[0] != '\n' && ptr[0] != '\0') { ptr++; GOBBLE_TOS(ptr, "\n\"\\") COUNT_SEQ(ptr, bk_count, dq_count) } /* Break for loop before next line increment when done */ if (!dq_count) break; } } } else if (strstr (response, "Timeticks: ")) { show = strstr (response, "Timeticks: "); } else show = response + 3; iresult = STATE_DEPENDENT; /* Process this block for numeric comparisons */ /* Make some special values,like Timeticks numeric only if a threshold is defined */ if (thlds[i]->warning || thlds[i]->critical || calculate_rate) { ptr = strpbrk (show, "0123456789"); if (ptr == NULL) die (STATE_UNKNOWN,_("No valid data returned (%s)\n"), show); response_value[i] = strtod (ptr, NULL) + offset; if(calculate_rate) { if (previous_state!=NULL) { duration = current_time-previous_state->time; if(duration<=0) die(STATE_UNKNOWN,_("Time duration between plugin calls is invalid")); temp_double = response_value[i]-previous_value[i]; /* Simple overflow catcher (same as in rrdtool, rrd_update.c) */ if(is_counter) { if(temp_double<(double)0.0) temp_double+=(double)4294967296.0; /* 2^32 */ if(temp_double<(double)0.0) temp_double+=(double)18446744069414584320.0; /* 2^64-2^32 */; } /* Convert to per second, then use multiplier */ temp_double = temp_double/duration*rate_multiplier; iresult = get_status(temp_double, thlds[i]); xasprintf (&show, conv, temp_double); } } else { iresult = get_status(response_value[i], thlds[i]); xasprintf (&show, conv, response_value[i]); } } /* Process this block for string matching */ else if (eval_method[i] & CRIT_STRING) { if (strcmp (show, string_value)) iresult = (invert_search==0) ? STATE_CRITICAL : STATE_OK; else iresult = (invert_search==0) ? STATE_OK : STATE_CRITICAL; } /* Process this block for regex matching */ else if (eval_method[i] & CRIT_REGEX) { excode = regexec (&preg, response, 10, pmatch, eflags); if (excode == 0) { iresult = (invert_search==0) ? STATE_OK : STATE_CRITICAL; } else if (excode != REG_NOMATCH) { regerror (excode, &preg, errbuf, MAX_INPUT_BUFFER); printf (_("Execute Error: %s\n"), errbuf); exit (STATE_CRITICAL); } else { iresult = (invert_search==0) ? STATE_CRITICAL : STATE_OK; } } /* Process this block for existence-nonexistence checks */ /* TV: Should this be outside of this else block? */ 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 >= (size_t)1 && (size_t)i < nlabels && labels[i] != NULL) xasprintf (&outbuff, "%s%s%s %s%s%s", outbuff, (i == 0) ? " " : output_delim, labels[i], mark (iresult), show, mark (iresult)); else xasprintf (&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 > (size_t)0 && (size_t)i < nunits && unitv[i] != NULL) xasprintf (&outbuff, "%s %s", outbuff, unitv[i]); /* Write perfdata with whatever can be parsed by strtod, if possible */ ptr = NULL; strtod(show, &ptr); if (ptr > show) { if (perf_labels && nlabels >= (size_t)1 && (size_t)i < nlabels && labels[i] != NULL) temp_string=labels[i]; else temp_string=oidname; if (strpbrk (temp_string, " ='\"") == NULL) { strncat(perfstr, temp_string, sizeof(perfstr)-strlen(perfstr)-1); } else { if (strpbrk (temp_string, "'") == NULL) { quote_string="'"; } else { quote_string="\""; } strncat(perfstr, quote_string, sizeof(perfstr)-strlen(perfstr)-1); strncat(perfstr, temp_string, sizeof(perfstr)-strlen(perfstr)-1); strncat(perfstr, quote_string, sizeof(perfstr)-strlen(perfstr)-1); } strncat(perfstr, "=", sizeof(perfstr)-strlen(perfstr)-1); len = sizeof(perfstr)-strlen(perfstr)-1; strncat(perfstr, show, len>ptr-show ? ptr-show : len); if (type) strncat(perfstr, type, sizeof(perfstr)-strlen(perfstr)-1); strncat(perfstr, " ", sizeof(perfstr)-strlen(perfstr)-1); } } total_oids=i; /* Save state data, as all data collected now */ if(calculate_rate) { string_length=1024; state_string=malloc(string_length); if(state_string==NULL) die(STATE_UNKNOWN, _("Cannot malloc")); current_length=0; for(i=0; istring_length) { string_length=current_length+1024; state_string=realloc(state_string,string_length); if(state_string==NULL) die(STATE_UNKNOWN, _("Cannot realloc()")); } strcpy(&state_string[current_length],temp_string); current_length=current_length+response_length; state_string[current_length]=':'; current_length++; free(temp_string); } state_string[--current_length]='\0'; if (verbose > 2) printf("State string=%s\n",state_string); /* This is not strictly the same as time now, but any subtle variations will cancel out */ np_state_write_string(current_time, state_string ); if(previous_state==NULL) { /* Or should this be highest state? */ die( STATE_OK, _("No previous data to calculate rate - assume okay" ) ); } } printf ("%s %s -%s %s\n", label, state_text (result), outbuff, perfstr); if (mult_resp) printf ("%s", mult_resp); 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 = 0; static struct option longopts[] = { 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'}, {"timeout", required_argument, 0, 't'}, {"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'}, {"retries", required_argument, 0, 'e'}, {"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'}, {"privproto", required_argument, 0, 'x'}, {"authpasswd", required_argument, 0, 'A'}, {"privpasswd", required_argument, 0, 'X'}, {"next", no_argument, 0, 'n'}, {"rate", no_argument, 0, L_CALCULATE_RATE}, {"rate-multiplier", required_argument, 0, L_RATE_MULTIPLIER}, {"offset", required_argument, 0, L_OFFSET}, {"invert-search", no_argument, 0, L_INVERT_SEARCH}, {"perf-oids", no_argument, 0, 'O'}, {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, "nhvVOt:c:w:H:C:o:e:E:d:D:s:t:R:r:l:u:p:m:P:L:U:a:x:A:X:", longopts, &option); if (c == -1 || c == EOF) break; switch (c) { case '?': /* usage */ usage5 (); case 'h': /* help */ print_help (); exit (STATE_OK); case 'V': /* version */ print_revision (progname, NP_VERSION); exit (STATE_OK); case 'v': /* verbose */ verbose++; break; /* Connection info */ case 'C': /* group or community */ community = optarg; break; case 'H': /* Host or server */ server_address = optarg; break; case 'p': /* TCP port number */ port = optarg; break; case 'm': /* List of MIBS */ miblist = optarg; break; case 'n': /* usesnmpgetnext */ usesnmpgetnext = TRUE; break; case 'P': /* SNMP protocol version */ proto = optarg; break; case 'L': /* security level */ seclevel = optarg; break; case 'U': /* security username */ secname = optarg; break; case 'a': /* auth protocol */ authproto = optarg; break; case 'x': /* priv protocol */ privproto = optarg; break; case 'A': /* auth passwd */ authpasswd = optarg; break; case 'X': /* priv passwd */ privpasswd = optarg; break; case 't': /* timeout period */ if (!is_integer (optarg)) usage2 (_("Timeout interval must be a positive integer"), optarg); else timeout_interval = atoi (optarg); break; /* Test parameters */ case 'c': /* critical threshold */ critical_thresholds = optarg; break; case 'w': /* warning threshold */ warning_thresholds = optarg; break; case 'e': /* PRELIMINARY - may change */ case 'E': /* PRELIMINARY - may change */ if (!is_integer (optarg)) usage2 (_("Retries interval must be a positive integer"), optarg); else retries = atoi(optarg); break; case 'o': /* object identifier */ if ( strspn( optarg, "0123456789.," ) != strlen( optarg ) ) { /* * we have something other than digits, periods and comas, * so we have a mib variable, rather than just an SNMP OID, * so we have to actually read the mib files */ needmibs = TRUE; } if (!oids) oids = calloc(MAX_OIDS, sizeof (char *)); for (ptr = strtok(optarg, ", "); ptr != NULL && j < MAX_OIDS; ptr = strtok(NULL, ", "), j++) { oids[j] = strdup(ptr); } numoids = j; 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 */ cflags = REG_ICASE; case 'r': /* regex */ 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++; break; /* Format */ case 'd': /* delimiter */ delimiter = strscpy (delimiter, optarg); break; case 'D': /* output-delimiter */ output_delim = strscpy (output_delim, optarg); break; case 'l': /* label */ nlabels++; if (nlabels > labels_size) { labels_size += 8; labels = realloc (labels, labels_size * sizeof(*labels)); if (labels == NULL) die (STATE_UNKNOWN, _("Could not reallocate labels[%d]"), (int)nlabels); } labels[nlabels - 1] = optarg; ptr = thisarg (optarg); labels[nlabels - 1] = ptr; if (ptr[0] == '\'') labels[nlabels - 1] = ptr + 1; while (ptr && (ptr = nextarg (ptr))) { nlabels++; if (nlabels > labels_size) { labels_size += 8; labels = realloc (labels, labels_size * sizeof(*labels)); if (labels == NULL) die (STATE_UNKNOWN, _("Could not reallocate labels\n")); } ptr = thisarg (ptr); if (ptr[0] == '\'') 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 * sizeof(*unitv)); if (unitv == NULL) die (STATE_UNKNOWN, _("Could not reallocate units [%d]\n"), (int)nunits); } unitv[nunits - 1] = optarg; ptr = thisarg (optarg); unitv[nunits - 1] = ptr; if (ptr[0] == '\'') unitv[nunits - 1] = ptr + 1; while (ptr && (ptr = nextarg (ptr))) { if (nunits > unitv_size) { unitv_size += 8; unitv = realloc (unitv, unitv_size * sizeof(*unitv)); if (units == NULL) die (STATE_UNKNOWN, _("Could not realloc() units\n")); } nunits++; ptr = thisarg (ptr); if (ptr[0] == '\'') unitv[nunits - 1] = ptr + 1; else unitv[nunits - 1] = ptr; } break; case L_CALCULATE_RATE: if(calculate_rate==0) np_enable_state(NULL, 1); calculate_rate = 1; break; case L_RATE_MULTIPLIER: if(!is_integer(optarg)||((rate_multiplier=atoi(optarg))<=0)) usage2(_("Rate multiplier must be a positive integer"),optarg); break; case L_OFFSET: offset=strtod(optarg,NULL); break; case L_INVERT_SEARCH: invert_search=1; break; case 'O': perf_labels=0; break; } } if (server_address == NULL) server_address = argv[optind]; if (community == NULL) community = strdup (DEFAULT_COMMUNITY); return validate_arguments (); } /****************************************************************************** @@- validate_arguments &PROTO_validate_arguments; Checks to see if the default miblist needs to be loaded. Also verifies the authentication and authorization combinations based on protocol version selected. -@@ ******************************************************************************/ int validate_arguments () { /* check whether to load locally installed MIBS (CPU/disk intensive) */ if (miblist == NULL) { if ( needmibs == TRUE ) { miblist = strdup (DEFAULT_MIBLIST); }else{ miblist = ""; /* don't read any mib files for numeric oids */ } } /* Check server_address is given */ if (server_address == NULL) die(STATE_UNKNOWN, _("No host specified\n")); /* Check oid is given */ if (numoids == 0) die(STATE_UNKNOWN, _("No OIDs specified\n")); if (proto == NULL) xasprintf(&proto, DEFAULT_PROTOCOL); if ((strcmp(proto,"1") == 0) || (strcmp(proto, "2c")==0)) { /* snmpv1 or snmpv2c */ numauthpriv = 2; authpriv = calloc (numauthpriv, sizeof (char *)); authpriv[0] = strdup ("-c"); authpriv[1] = strdup (community); } else if ( strcmp (proto, "3") == 0 ) { /* snmpv3 args */ if (seclevel == NULL) xasprintf(&seclevel, "noAuthNoPriv"); if (strcmp(seclevel, "noAuthNoPriv") == 0) { numauthpriv = 2; authpriv = calloc (numauthpriv, sizeof (char *)); authpriv[0] = strdup ("-l"); authpriv[1] = strdup ("noAuthNoPriv"); } else { if (! ( (strcmp(seclevel, "authNoPriv")==0) || (strcmp(seclevel, "authPriv")==0) ) ) { usage2 (_("Invalid seclevel"), seclevel); } if (authproto == NULL ) xasprintf(&authproto, DEFAULT_AUTH_PROTOCOL); if (secname == NULL) die(STATE_UNKNOWN, _("Required parameter: %s\n"), "secname"); if (authpasswd == NULL) die(STATE_UNKNOWN, _("Required parameter: %s\n"), "authpasswd"); if ( strcmp(seclevel, "authNoPriv") == 0 ) { numauthpriv = 8; authpriv = calloc (numauthpriv, sizeof (char *)); authpriv[0] = strdup ("-l"); authpriv[1] = strdup ("authNoPriv"); authpriv[2] = strdup ("-a"); authpriv[3] = strdup (authproto); authpriv[4] = strdup ("-u"); authpriv[5] = strdup (secname); authpriv[6] = strdup ("-A"); authpriv[7] = strdup (authpasswd); } else if ( strcmp(seclevel, "authPriv") == 0 ) { if (privproto == NULL ) xasprintf(&privproto, DEFAULT_PRIV_PROTOCOL); if (privpasswd == NULL) die(STATE_UNKNOWN, _("Required parameter: %s\n"), "privpasswd"); numauthpriv = 12; authpriv = calloc (numauthpriv, sizeof (char *)); authpriv[0] = strdup ("-l"); authpriv[1] = strdup ("authPriv"); authpriv[2] = strdup ("-a"); authpriv[3] = strdup (authproto); authpriv[4] = strdup ("-u"); authpriv[5] = strdup (secname); authpriv[6] = strdup ("-A"); authpriv[7] = strdup (authpasswd); authpriv[8] = strdup ("-x"); authpriv[9] = strdup (privproto); authpriv[10] = strdup ("-X"); authpriv[11] = strdup (privpasswd); } } } else { usage2 (_("Invalid SNMP version"), proto); } return OK; } /* 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 (str[0] == '\'') { /* 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 (str[0] == '\'') { str[0] = 0; if (strlen (str) > 1) { str = strstr (str + 1, "'"); return (++str); } else { return NULL; } } if (str[0] == ',') { str[0] = 0; if (strlen (str) > 1) { return (++str); } else { return NULL; } } if ((str = strstr (str, ",")) && strlen (str) > 1) { str[0] = 0; return (++str); } return NULL; } void print_help (void) { print_revision (progname, NP_VERSION); printf (COPYRIGHT, copyright, email); printf ("%s\n", _("Check status of remote machines and obtain system information via SNMP")); printf ("\n\n"); print_usage (); printf (UT_HELP_VRSN); printf (UT_EXTRA_OPTS); printf (UT_HOST_PORT, 'p', DEFAULT_PORT); /* SNMP and Authentication Protocol */ printf (" %s\n", "-n, --next"); printf (" %s\n", _("Use SNMP GETNEXT instead of SNMP GET")); printf (" %s\n", "-P, --protocol=[1|2c|3]"); printf (" %s\n", _("SNMP protocol version")); printf (" %s\n", "-L, --seclevel=[noAuthNoPriv|authNoPriv|authPriv]"); printf (" %s\n", _("SNMPv3 securityLevel")); printf (" %s\n", "-a, --authproto=[MD5|SHA]"); printf (" %s\n", _("SNMPv3 auth proto")); printf (" %s\n", "-x, --privproto=[DES|AES]"); printf (" %s\n", _("SNMPv3 priv proto (default DES)")); /* Authentication Tokens*/ printf (" %s\n", "-C, --community=STRING"); printf (" %s ", _("Optional community string for SNMP communication")); printf ("(%s \"%s\")\n", _("default is") ,DEFAULT_COMMUNITY); printf (" %s\n", "-U, --secname=USERNAME"); printf (" %s\n", _("SNMPv3 username")); printf (" %s\n", "-A, --authpassword=PASSWORD"); printf (" %s\n", _("SNMPv3 authentication password")); printf (" %s\n", "-X, --privpasswd=PASSWORD"); printf (" %s\n", _("SNMPv3 privacy password")); /* OID Stuff */ printf (" %s\n", "-o, --oid=OID(s)"); printf (" %s\n", _("Object identifier(s) or SNMP variables whose value you wish to query")); printf (" %s\n", "-m, --miblist=STRING"); printf (" %s\n", _("List of MIBS to be loaded (default = none if using numeric OIDs or 'ALL'")); printf (" %s\n", _("for symbolic OIDs.)")); printf (" %s\n", "-d, --delimiter=STRING"); printf (" %s \"%s\"\n", _("Delimiter to use when parsing returned data. Default is"), DEFAULT_DELIMITER); printf (" %s\n", _("Any data on the right hand side of the delimiter is considered")); printf (" %s\n", _("to be the data that should be used in the evaluation.")); /* Tests Against Integers */ printf (" %s\n", "-w, --warning=THRESHOLD(s)"); printf (" %s\n", _("Warning threshold range(s)")); printf (" %s\n", "-c, --critical=THRESHOLD(s)"); printf (" %s\n", _("Critical threshold range(s)")); printf (" %s\n", "--rate"); printf (" %s\n", _("Enable rate calculation. See 'Rate Calculation' below")); printf (" %s\n", "--rate-multiplier"); printf (" %s\n", _("Converts rate per second. For example, set to 60 to convert to per minute")); printf (" %s\n", "--offset=OFFSET"); printf (" %s\n", _("Add/substract the specified OFFSET to numeric sensor data")); /* Tests Against Strings */ printf (" %s\n", "-s, --string=STRING"); printf (" %s\n", _("Return OK state (for that OID) if STRING is an exact match")); printf (" %s\n", "-r, --ereg=REGEX"); printf (" %s\n", _("Return OK state (for that OID) if extended regular expression REGEX matches")); printf (" %s\n", "-R, --eregi=REGEX"); printf (" %s\n", _("Return OK state (for that OID) if case-insensitive extended REGEX matches")); printf (" %s\n", "--invert-search"); printf (" %s\n", _("Invert search result (CRITICAL if found)")); /* Output Formatting */ printf (" %s\n", "-l, --label=STRING"); printf (" %s\n", _("Prefix label for output from plugin")); printf (" %s\n", "-u, --units=STRING"); printf (" %s\n", _("Units label(s) for output data (e.g., 'sec.').")); printf (" %s\n", "-D, --output-delimiter=STRING"); printf (" %s\n", _("Separates output on multiple OID requests")); printf (UT_TIMEOUT, DEFAULT_SOCKET_TIMEOUT); printf (" %s\n", "-e, --retries=INTEGER"); printf (" %s\n", _("Number of retries to be used in the requests")); printf (" %s\n", "-O, --perf-oids"); printf (" %s\n", _("Label performance data with OIDs instead of --label's")); printf (UT_VERBOSE); printf ("\n"); printf ("%s\n", _("This plugin uses the 'snmpget' command included with the NET-SNMP package.")); printf ("%s\n", _("if you don't have the package installed, you will need to download it from")); printf ("%s\n", _("http://net-snmp.sourceforge.net before you can use this plugin.")); printf ("\n"); printf ("%s\n", _("Notes:")); printf (" %s\n", _("- Multiple OIDs (and labels) may be indicated by a comma or space-delimited ")); printf (" %s %i %s\n", _("list (lists with internal spaces must be quoted). Maximum:"), MAX_OIDS, _("OIDs.")); printf(" -%s", UT_THRESHOLDS_NOTES); printf (" %s\n", _("- When checking multiple OIDs, separate ranges by commas like '-w 1:10,1:,:20'")); printf (" %s\n", _("- Note that only one string and one regex may be checked at present")); printf (" %s\n", _("- All evaluation methods other than PR, STR, and SUBSTR expect that the value")); printf (" %s\n", _("returned from the SNMP query is an unsigned integer.")); printf("\n"); printf("%s\n", _("Rate Calculation:")); printf(" %s\n", _("In many places, SNMP returns counters that are only meaningful when")); printf(" %s\n", _("calculating the counter difference since the last check. check_snmp")); printf(" %s\n", _("saves the last state information in a file so that the rate per second")); printf(" %s\n", _("can be calculated. Use the --rate option to save state information.")); printf(" %s\n", _("On the first run, there will be no prior state - this will return with OK.")); printf(" %s\n", _("The state is uniquely determined by the arguments to the plugin, so")); printf(" %s\n", _("changing the arguments will create a new state file.")); printf (UT_SUPPORT); } void print_usage (void) { printf ("%s\n", _("Usage:")); printf ("%s -H -o [-w warn_range] [-c crit_range]\n",progname); printf ("[-C community] [-s string] [-r regex] [-R regexi] [-t timeout] [-e retries]\n"); printf ("[-l label] [-u units] [-p port-number] [-d delimiter] [-D output-delimiter]\n"); printf ("[-m miblist] [-P snmp version] [-L seclevel] [-U secname] [-a authproto]\n"); printf ("[-A authpasswd] [-x privproto] [-X privpasswd]\n"); }