Code

Updated check_procs with a hidden --input-file option.
[nagiosplug.git] / plugins / check_nt.c
index 45a2bb0fda8ccd4708c345dc900e3b9d94441eb5..60d58fd09e33b58f2e265c259584c7889ea28b6a 100644 (file)
@@ -1,44 +1,43 @@
-/******************************************************************************
-*
+/*****************************************************************************
+* 
 * Nagios check_nt plugin
-*
+* 
 * License: GPL
 * Copyright (c) 2000-2002 Yves Rubin (rubiyz@yahoo.com)
-* Copyright (c) 2003-2006 nagios-plugins team
-*
+* Copyright (c) 2003-2007 Nagios Plugins Development Team
+* 
 * Last Modified: $Date$
-*
+* 
 * Description:
-*
+* 
 * This file contains the check_nt plugin
-*
-*  This plugin collects data from the NSClient service running on a
-*  Windows NT/2000/XP/2003 server.
-*  This requires NSClient software to run on NT (http://nsclient.ready2run.nl/)
-*
-* License Information:
-*
-* This program is free software; you can redistribute it and/or modify
+* 
+* This plugin collects data from the NSClient service running on a
+* Windows NT/2000/XP/2003 server.
+* This plugin requires NSClient software to run on NT
+* (http://nsclient.ready2run.nl/)
+* 
+* 
+* 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
+* 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, write to the Free Software
-* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
-*
+* along with this program.  If not, see <http://www.gnu.org/licenses/>.
+* 
 * $Id$
-*
+* 
 *****************************************************************************/
 
 const char *progname = "check_nt";
 const char *revision = "$Revision$";
-const char *copyright = "2003-2006";
+const char *copyright = "2000-2007";
 const char *email = "nagiosplug-devel@lists.sourceforge.net";
 
 #include "common.h"
@@ -55,7 +54,8 @@ enum checkvars {
        CHECK_PROCSTATE,
        CHECK_MEMUSE,
        CHECK_COUNTER,
-       CHECK_FILEAGE
+       CHECK_FILEAGE,
+       CHECK_INSTANCES
 };
 
 enum {
@@ -414,7 +414,7 @@ int main(int argc, char **argv){
                                        return_code=STATE_WARNING;      
                                else
                                        return_code=STATE_OK;   
-                       } 
+                       }
                        else {                                       /* inverse thresholds */
                                if(check_critical_value==TRUE && age_in_minutes <= critical_value)
                                        return_code=STATE_CRITICAL;
@@ -426,6 +426,21 @@ int main(int argc, char **argv){
                }
                break;
 
+       case CHECK_INSTANCES:           
+               if (value_list==NULL)
+                       output_message = strdup (_("No counter specified"));
+               else {
+                       asprintf(&send_buffer,"%s&10&%s", req_password,value_list);
+                       fetch_data (server_address, server_port, send_buffer);
+                       if (!strncmp(recv_buffer,"ERROR",5)) {
+                               printf("NSClient - %s\n",recv_buffer);
+                               exit(STATE_UNKNOWN);
+                       }
+                       asprintf(&output_message,"%s",recv_buffer);                     
+                       return_code=STATE_OK;
+               }
+               break;
+
        case CHECK_NONE:
        default:
                usage4 (_("Please specify a variable to check"));
@@ -483,16 +498,15 @@ int process_arguments(int argc, char **argv){
       strcpy(argv[c],"-c");
        }
 
-       while (1){
+       while (1) {
                c = getopt_long(argc,argv,"+hVH:t:c:w:p:v:l:s:d:",longopts,&option);
 
                if (c==-1||c==EOF||c==1)
                        break;
 
-               switch (c)
-                       {
+               switch (c) {
                        case '?': /* print short usage statement if args not parsable */
-                       usage2 (_("Unknown argument"), optarg);
+                       usage5 ();
                        case 'h': /* help */
                                print_help();
                                exit(STATE_OK);
@@ -533,6 +547,8 @@ int process_arguments(int argc, char **argv){
                                        vars_to_check=CHECK_COUNTER;
                                else if(!strcmp(optarg,"FILEAGE"))
                                        vars_to_check=CHECK_FILEAGE;
+                               else if(!strcmp(optarg,"INSTANCES"))
+                                       vars_to_check=CHECK_INSTANCES;
                                else
                                        return ERROR;
                                break;
@@ -629,7 +645,7 @@ void print_help(void)
        
   printf (_(UT_HELP_VRSN));
 
-  printf ("%s\n", _("Options:"));
+    printf ("%s\n", _("Options:"));
   printf (" %s\n", "-H, --hostname=HOST");
   printf ("   %s\n", _("Name of the host to check"));
   printf (" %s\n", "-p, --port=INTEGER");
@@ -649,54 +665,69 @@ void print_help(void)
   printf (" %s\n", "-V, --version");
   printf ("   %s\n", _("Print version information"));
   printf (" %s\n", "-v, --variable=STRING");
-  printf ("   %s\n", _("Variable to check.  Valid variables are:"));
-  printf (_("\
-   CLIENTVERSION = Get the NSClient version\n\
-     If -l <version> is specified, will return warning if versions differ.\n"));
-  printf (_("\
-   CPULOAD = Average CPU load on last x minutes.\n\
-     Request a -l parameter with the following syntax:\n\
-     -l <minutes range>,<warning threshold>,<critical threshold>.\n\
-     <minute range> should be less than 24*60.\n\
-     Thresholds are percentage and up to 10 requests can be done in one shot.\n\
-     ie: -l 60,90,95,120,90,95\n"));
-  printf (_("\
-   UPTIME = Get the uptime of the machine.\n\
-     No specific parameters. No warning or critical threshold\n"));
-  printf (_("\
-   USEDDISKSPACE = Size and percentage of disk use.\n\
-     Request a -l parameter containing the drive letter only.\n\
-     Warning and critical thresholds can be specified with -w and -c.\n"));
-  printf (_("\
-   MEMUSE = Memory use.\n\
-     Warning and critical thresholds can be specified with -w and -c.\n"));
-  printf (_("\
-   SERVICESTATE = Check the state of one or several services.\n\
-     Request a -l parameters with the following syntax:\n\
-     -l <service1>,<service2>,<service3>,...\n\
-     You can specify -d SHOWALL in case you want to see working services\n\
-                in the returned string.\n"));
-  printf (_("\
-   PROCSTATE = Check if one or several process are running.\n\
-     Same syntax as SERVICESTATE.\n"));
-  printf (_("\
-   COUNTER = Check any performance counter of Windows NT/2000.\n\
-     Request a -l parameters with the following syntax:\n\
-                -l \"\\\\<performance object>\\\\counter\",\"<description>\n\
-     The <description> parameter is optional and \n\
-     is given to a printf output command which requires a float parameter.\n\
-     If <description> does not include \"%%\", it is used as a label.\n\
-     Some examples:\n\
-       \"Paging file usage is %%.2f %%%%\"\n\
-       \"%%.f %%%% paging file used.\"\n"));
-  printf (_("Notes:\n\
- - The NSClient service should be running on the server to get any information\n\
-   (http://nsclient.ready2run.nl).\n\
- - Critical thresholds should be lower than warning thresholds\n\
- - Default port 1248 is sometimes in use by other services. The error \n\
-   output when this happens contains \"Cannot map xxxxx to protocol number\". \n\
-   One fix for this is to change the port to something else on check_nt \n\
-   and on the client service it\'s connecting to. \n"));
+  printf ("   %s\n\n", _("Variable to check"));
+  printf ("%s\n", _("Valid variables are:"));
+  printf (" %s", "CLIENTVERSION =");
+  printf (" %s\n", _("Get the NSClient version"));
+  printf ("  %s\n", _("If -l <version> is specified, will return warning if versions differ."));
+  printf (" %s\n", "CPULOAD =");
+  printf ("  %s\n", _("Average CPU load on last x minutes."));
+  printf ("  %s\n", _("Request a -l parameter with the following syntax:"));
+  printf ("  %s\n", _("-l <minutes range>,<warning threshold>,<critical threshold>."));
+  printf ("  %s\n", _("<minute range> should be less than 24*60."));
+  printf ("  %s\n", _("Thresholds are percentage and up to 10 requests can be done in one shot."));
+  printf ("  %s\n", "ie: -l 60,90,95,120,90,95");
+  printf (" %s\n", "UPTIME =");
+  printf ("  %s\n", _("Get the uptime of the machine."));
+  printf ("  %s\n", _("No specific parameters. No warning or critical threshold"));
+  printf (" %s\n", "USEDDISKSPACE =");
+  printf ("  %s\n", _("Size and percentage of disk use."));
+  printf ("  %s\n", _("Request a -l parameter containing the drive letter only."));
+  printf ("  %s\n", _("Warning and critical thresholds can be specified with -w and -c."));
+  printf (" %s\n", "MEMUSE =");
+  printf ("  %s\n", _("Memory use."));
+  printf ("  %s\n", _("Warning and critical thresholds can be specified with -w and -c."));
+  printf (" %s\n", "SERVICESTATE =");
+  printf ("  %s\n", _("Check the state of one or several services."));
+  printf ("  %s\n", _("Request a -l parameters with the following syntax:"));
+  printf ("  %s\n", _("-l <service1>,<service2>,<service3>,..."));
+  printf ("  %s\n", _("You can specify -d SHOWALL in case you want to see working services"));
+  printf ("  %s\n", _("in the returned string."));
+  printf (" %s\n", "PROCSTATE =");
+  printf ("  %s\n", _("Check if one or several process are running."));
+  printf ("  %s\n", _("Same syntax as SERVICESTATE."));
+  printf (" %s\n", "COUNTER =");
+  printf ("  %s\n", _("Check any performance counter of Windows NT/2000."));
+  printf ("  %s\n", _("Request a -l parameters with the following syntax:"));
+  printf ("  %s\n", _("-l \"\\\\<performance object>\\\\counter\",\"<description>"));
+  printf ("  %s\n", _("The <description> parameter is optional and is given to a printf "));
+  printf ("  %s\n", _("output command which requires a float parameter."));
+  printf ("  %s\n", _("If <description> does not include \"%%\", it is used as a label."));
+  printf ("  %s\n", _("Some examples:"));
+  printf ("  %s\n", "\"Paging file usage is %%.2f %%%%\"");
+  printf ("  %s\n", "\"%%.f %%%% paging file used.\"");
+  printf (" %s\n", "INSTANCES =");  
+  printf ("  %s\n", _("Check any performance counter object of Windows NT/2000."));
+  printf ("  %s\n", _("Syntax: check_nt -H <hostname> -p <port> -v INSTANCES -l <counter object>"));
+  printf ("  %s\n", _("<counter object> is a Windows Perfmon Counter object (eg. Process),"));
+  printf ("  %s\n", _("if it is two words, it should be enclosed in quotes"));
+  printf ("  %s\n", _("The returned results will be a comma-separated list of instances on "));
+  printf ("  %s\n", _(" the selected computer for that object."));
+  printf ("  %s\n", _("The purpose of this is to be run from command line to determine what instances"));
+  printf ("  %s\n", _(" are available for monitoring without having to log onto the Windows server"));
+  printf ("  %s\n", _("  to run Perfmon directly."));
+  printf ("  %s\n", _("It can also be used in scripts that automatically create Nagios service"));
+  printf ("  %s\n", _(" configuration files."));
+  printf ("  %s\n", _("Some examples:"));
+  printf ("  %s\n\n", _("check_nt -H 192.168.1.1 -p 1248 -v INSTANCES -l Process"));
+  printf (_("Notes:"));
+  printf (" %s\n", _("- The NSClient service should be running on the server to get any information"));
+  printf (" %s\n", "(http://nsclient.ready2run.nl).");
+  printf (" %s\n", _("- Critical thresholds should be lower than warning thresholds"));
+  printf (" %s\n", _("- Default port 1248 is sometimes in use by other services. The error"));
+  printf (" %s\n", _("output when this happens contains \"Cannot map xxxxx to protocol number\"."));
+  printf (" %s\n", _("One fix for this is to change the port to something else on check_nt "));
+  printf (" %s\n", _("and on the client service it\'s connecting to."));
 }