diff --git a/plugins/check_by_ssh.c b/plugins/check_by_ssh.c
index 59264dcd69da1052b4abf3a6363e3535f05d7eb0..ce62ebafb3816fed1fbd45f28177bedb23fe570f 100644 (file)
--- a/plugins/check_by_ssh.c
+++ b/plugins/check_by_ssh.c
-/******************************************************************************
- *
- * This file is part of the Nagios Plugins.
- *
- * Copyright (c) 1999, 2000, 2001 Karl DeBisschop <karl@debisschop.net>
- *
- * The Nagios Plugins are free software; you can redistribute them
- * and/or modify them 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.
- *
- * $Id$
- *
- *****************************************************************************/
-
-#define PROGRAM check_by_ssh
-#define DESCRIPTION "Run checks on a remote system using ssh, wrapping the proper timeout around the ssh invocation."
-#define AUTHOR "Karl DeBisschop"
-#define EMAIL "karl@debisschop.net"
-#define COPYRIGHTDATE "1999, 2000, 2001"
-
-#include "config.h"
+/*****************************************************************************
+*
+* Nagios check_by_ssh plugin
+*
+* License: GPL
+* Copyright (c) 2000-2008 Nagios Plugins Development Team
+*
+* Last Modified: $Date$
+*
+* Description:
+*
+* This file contains the check_by_ssh plugin
+*
+*
+* 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/>.
+*
+* $Id$
+*
+*****************************************************************************/
+
+const char *progname = "check_by_ssh";
+const char *revision = "$Revision$";
+const char *copyright = "2000-2008";
+const char *email = "nagiosplug-devel@lists.sourceforge.net";
+
#include "common.h"
-#include "popen.h"
+#include "netutils.h"
#include "utils.h"
-#include <time.h>
-
-#define PROGNAME "check_by_ssh"
+#include "runcmd.h"
int process_arguments (int, char **);
-int call_getopt (int, char **);
int validate_arguments (void);
-void print_help (char *command_name);
+void print_help (void);
void print_usage (void);
-
-int commands;
+unsigned int commands = 0;
+unsigned int services = 0;
+int skip_stdout = 0;
+int skip_stderr = 0;
char *remotecmd = NULL;
char *comm = NULL;
char *hostname = NULL;
char *outputfile = NULL;
char *host_shortname = NULL;
-char *servicelist = NULL;
+char **service;
int passive = FALSE;
int verbose = FALSE;
-
int
main (int argc, char **argv)
{
- char input_buffer[MAX_INPUT_BUFFER] = "";
- char *result_text = NULL;
char *status_text;
- char *output = NULL;
- char *eol = NULL;
- char *srvc_desc = NULL;
int cresult;
int result = STATE_UNKNOWN;
+ int i;
time_t local_time;
FILE *fp = NULL;
+ struct output chld_out, chld_err;
+ remotecmd = "";
+ comm = strdup (SSH_COMMAND);
+
+ setlocale (LC_ALL, "");
+ bindtextdomain (PACKAGE, LOCALEDIR);
+ textdomain (PACKAGE);
+
+ /* Parse extra opts if any */
+ argv=np_extra_opts (&argc, argv, progname);
/* process arguments */
if (process_arguments (argc, argv) == ERROR)
- usage ("Could not parse arguments\n");
-
+ usage_va(_("Could not parse arguments"));
/* Set signal handling and alarm timeout */
if (signal (SIGALRM, popen_timeout_alarm_handler) == SIG_ERR) {
- printf ("Cannot catch SIGALRM");
- return STATE_UNKNOWN;
+ usage_va(_("Cannot catch SIGALRM"));
}
alarm (timeout_interval);
-
/* run the command */
-
if (verbose)
printf ("%s\n", comm);
- child_process = spopen (comm);
-
- if (child_process == NULL) {
- printf ("Unable to open pipe: %s", comm);
- return STATE_UNKNOWN;
- }
+ result = np_runcmd(comm, &chld_out, &chld_err, 0);
+ if (skip_stdout == -1) /* --skip-stdout specified without argument */
+ skip_stdout = chld_out.lines;
+ if (skip_stderr == -1) /* --skip-stderr specified without argument */
+ skip_stderr = chld_err.lines;
- /* open STDERR for spopen */
- child_stderr = fdopen (child_stderr_array[fileno (child_process)], "r");
- if (child_stderr == NULL) {
- printf ("Could not open stderr for %s\n", SSH_COMMAND);
+ /* UNKNOWN or worse if (non-skipped) output found on stderr */
+ if(chld_err.lines > skip_stderr) {
+ printf (_("Remote command execution failed: %s\n"),
+ chld_err.line[skip_stderr]);
+ return max_state_alt(result, STATE_UNKNOWN);
}
-
- /* get results from remote command */
- result_text = realloc (result_text, 1);
- result_text[0] = 0;
- while (fgets (input_buffer, MAX_INPUT_BUFFER - 1, child_process))
- result_text = strscat (result_text, input_buffer);
-
-
- /* WARNING if output found on stderr */
- if (fgets (input_buffer, MAX_INPUT_BUFFER - 1, child_stderr)) {
- printf ("%s\n", input_buffer);
- return STATE_WARNING;
+ /* this is simple if we're not supposed to be passive.
+ * Wrap up quickly and keep the tricks below */
+ if(!passive) {
+ if (chld_out.lines > skip_stdout)
+ for (i = skip_stdout; i < chld_out.lines; i++)
+ puts (chld_out.line[i]);
+ else
+ printf (_("%s - check_by_ssh: Remote command '%s' returned status %d\n"),
+ state_text(result), remotecmd, result);
+ return result; /* return error status from remote command */
}
- (void) fclose (child_stderr);
-
- /* close the pipe */
- result = spclose (child_process);
+ /*
+ * Passive mode
+ */
/* process output */
- if (passive) {
-
- if (!(fp = fopen (outputfile, "a"))) {
- printf ("SSH WARNING: could not open %s\n", outputfile);
- exit (STATE_UNKNOWN);
- }
-
- time (&local_time);
- srvc_desc = strtok (servicelist, ":");
- while (result_text != NULL) {
- status_text = (strstr (result_text, "STATUS CODE: "));
- if (status_text == NULL) {
- printf ("%s", result_text);
- return result;
- }
- output = result_text;
- result_text = strnl (status_text);
- eol = strpbrk (output, "\r\n");
- if (eol != NULL)
- eol[0] = 0;
- if (srvc_desc && status_text
- && sscanf (status_text, "STATUS CODE: %d", &cresult) == 1) {
- fprintf (fp, "%d PROCESS_SERVICE_CHECK_RESULT;%s;%s;%d;%s\n",
- (int) local_time, host_shortname, srvc_desc, cresult,
- output);
- srvc_desc = strtok (NULL, ":");
- }
- }
-
+ if (!(fp = fopen (outputfile, "a"))) {
+ printf (_("SSH WARNING: could not open %s\n"), outputfile);
+ exit (STATE_UNKNOWN);
}
- /* print the first line from the remote command */
- else {
- eol = strpbrk (result_text, "\r\n");
- if (eol)
- eol[0] = 0;
- printf ("%s\n", result_text);
-
+ local_time = time (NULL);
+ commands = 0;
+ for(i = skip_stdout; i < chld_out.lines; i++) {
+ status_text = chld_out.line[i++];
+ if (i == chld_out.lines || strstr (chld_out.line[i], "STATUS CODE: ") == NULL)
+ die (STATE_UNKNOWN, _("%s: Error parsing output\n"), progname);
+
+ if (service[commands] && status_text
+ && sscanf (chld_out.line[i], "STATUS CODE: %d", &cresult) == 1)
+ {
+ fprintf (fp, "[%d] PROCESS_SERVICE_CHECK_RESULT;%s;%s;%d;%s\n",
+ (int) local_time, host_shortname, service[commands++],
+ cresult, status_text);
+ }
}
-
-
- /* return error status from remote command */
+
+ /* Multiple commands and passive checking should always return OK */
return result;
}
-
-
-
-
/* process command-line arguments */
int
process_arguments (int argc, char **argv)
{
int c;
+ char *p1, *p2;
- if (argc < 2)
- return ERROR;
-
- remotecmd = realloc (remotecmd, 1);
- remotecmd[0] = 0;
-
- for (c = 1; c < argc; c++)
- if (strcmp ("-to", argv[c]) == 0)
- strcpy (argv[c], "-t");
-
- comm = strscpy (comm, SSH_COMMAND);
-
- c = 0;
- while (c += (call_getopt (argc - c, &argv[c]))) {
-
- if (argc <= c)
- break;
-
- if (hostname == NULL) {
- if (!is_host (argv[c]))
- terminate (STATE_UNKNOWN, "%s: Invalid host name %s\n", PROGNAME,
- argv[c]);
- hostname = argv[c];
- }
- else if (remotecmd == NULL) {
- remotecmd = strscpy (remotecmd, argv[c++]);
- for (; c < argc; c++)
- remotecmd = ssprintf (remotecmd, "%s %s", remotecmd, argv[c]);
- }
-
- }
-
- if (commands > 1)
- remotecmd = strscat (remotecmd, ";echo STATUS CODE: $?;");
-
- if (remotecmd == NULL || strlen (remotecmd) <= 1)
- usage ("No remotecmd\n");
-
- comm = ssprintf (comm, "%s %s '%s'", comm, hostname, remotecmd);
-
- return validate_arguments ();
-}
-
-
-
-
-
-/* Call getopt */
-int
-call_getopt (int argc, char **argv)
-{
- int c, i = 1;
-
-#ifdef HAVE_GETOPT_H
- int option_index = 0;
- static struct option long_options[] = {
+ int option = 0;
+ static struct option longopts[] = {
{"version", no_argument, 0, 'V'},
{"help", no_argument, 0, 'h'},
{"verbose", no_argument, 0, 'v'},
{"user", required_argument, 0, 'u'},
{"logname", required_argument, 0, 'l'},
{"command", required_argument, 0, 'C'},
+ {"skip", optional_argument, 0, 'S'}, /* backwards compatibility */
+ {"skip-stdout", optional_argument, 0, 'S'},
+ {"skip-stderr", optional_argument, 0, 'E'},
+ {"proto1", no_argument, 0, '1'},
+ {"proto2", no_argument, 0, '2'},
{"use-ipv4", no_argument, 0, '4'},
{"use-ipv6", no_argument, 0, '6'},
+ {"ssh-option", required_argument, 0, 'o'},
+ {"quiet", no_argument, 0, 'q'},
{0, 0, 0, 0}
};
-#endif
+
+ if (argc < 2)
+ return ERROR;
+
+ for (c = 1; c < argc; c++)
+ if (strcmp ("-to", argv[c]) == 0)
+ strcpy (argv[c], "-t");
while (1) {
-#ifdef HAVE_GETOPT_H
- c =
- getopt_long (argc, argv, "+?Vvhft46H:O:p:i:u:l:C:n:s:", long_options,
- &option_index);
-#else
- c = getopt (argc, argv, "+?Vvhft46H:O:p:i:u:l:C:n:s:");
-#endif
+ c = getopt_long (argc, argv, "Vvh1246fqt:H:O:p:i:u:l:C:S::E::n:s:o:", longopts,
+ &option);
if (c == -1 || c == EOF)
break;
- i++;
switch (c) {
- case 't':
- case 'H':
- case 'O':
- case 'p':
- case 'i':
- case 'u':
- case 'l':
- case 'n':
- case 's':
- i++;
- }
-
- switch (c) {
- case '?': /* help */
- print_usage ();
- exit (STATE_UNKNOWN);
case 'V': /* version */
- print_revision (PROGNAME, "$Revision$");
+ print_revision (progname, revision);
exit (STATE_OK);
case 'h': /* help */
- print_help (PROGNAME);
+ print_help ();
exit (STATE_OK);
case 'v': /* help */
verbose = TRUE;
break;
case 't': /* timeout period */
if (!is_integer (optarg))
- usage2 ("timeout interval must be an integer", optarg);
- timeout_interval = atoi (optarg);
+ usage_va(_("Timeout interval must be a positive integer"));
+ else
+ timeout_interval = atoi (optarg);
break;
case 'H': /* host */
- if (!is_host (optarg))
- usage2 ("invalid host name", optarg);
+ host_or_die(optarg);
hostname = optarg;
break;
case 'p': /* port number */
if (!is_integer (optarg))
- usage2 ("port must be an integer", optarg);
- comm = ssprintf (comm,"%s -p %s", comm, optarg);
+ usage_va(_("Port must be a positive integer"));
+ asprintf (&comm,"%s -p %s", comm, optarg);
break;
case 'O': /* output file */
outputfile = optarg;
passive = TRUE;
break;
case 's': /* description of service to check */
- servicelist = optarg;
+ p1 = optarg;
+ service = realloc (service, (++services) * sizeof(char *));
+ while ((p2 = index (p1, ':'))) {
+ *p2 = '\0';
+ service[services - 1] = p1;
+ service = realloc (service, (++services) * sizeof(char *));
+ p1 = p2 + 1;
+ }
+ service[services - 1] = p1;
break;
case 'n': /* short name of host in nagios configuration */
host_shortname = optarg;
break;
+
case 'u':
c = 'l';
case 'l': /* login name */
case 'i': /* identity */
- comm = ssprintf (comm, "%s -%c %s", comm, c, optarg);
+ asprintf (&comm, "%s -%c %s", comm, c, optarg);
break;
- case '4': /* Pass these switches directly to ssh */
- case '6': /* -4 for IPv4, -6 for IPv6 */
+
+ case '1': /* Pass these switches directly to ssh */
+ case '2': /* 1 to force version 1, 2 to force version 2 */
+ case '4': /* -4 for IPv4 */
+ case '6': /* -6 for IPv6 */
case 'f': /* fork to background */
- comm = ssprintf (comm, "%s -%c", comm, c);
+ asprintf (&comm, "%s -%c", comm, c);
break;
case 'C': /* Command for remote machine */
commands++;
if (commands > 1)
- remotecmd = strscat (remotecmd, ";echo STATUS CODE: $?;");
- remotecmd = strscat (remotecmd, optarg);
+ asprintf (&remotecmd, "%s;echo STATUS CODE: $?;", remotecmd);
+ asprintf (&remotecmd, "%s%s", remotecmd, optarg);
+ break;
+ case 'S': /* skip n (or all) lines on stdout */
+ if (optarg == NULL)
+ skip_stdout = -1; /* skip all output on stdout */
+ else if (!is_integer (optarg))
+ usage_va(_("skip-stdout argument must be an integer"));
+ else
+ skip_stdout = atoi (optarg);
+ break;
+ case 'E': /* skip n (or all) lines on stderr */
+ if (optarg == NULL)
+ skip_stderr = -1; /* skip all output on stderr */
+ else if (!is_integer (optarg))
+ usage_va(_("skip-stderr argument must be an integer"));
+ else
+ skip_stderr = atoi (optarg);
+ break;
+ case 'o': /* Extra options for the ssh command */
+ asprintf (&comm, "%s -%c '%s'", comm, c, optarg);
+ break;
+ case 'q': /* Tell the ssh command to be quiet */
+ asprintf (&comm, "%s -%c", comm, c);
+ break;
+ default: /* help */
+ usage5();
}
}
- return i;
-}
+ c = optind;
+ if (hostname == NULL) {
+ if (c <= argc) {
+ die (STATE_UNKNOWN, _("%s: You must provide a host name\n"), progname);
+ }
+ host_or_die(argv[c]);
+ hostname = argv[c++];
+ }
+ if (strlen(remotecmd) == 0) {
+ for (; c < argc; c++)
+ if (strlen(remotecmd) > 0)
+ asprintf (&remotecmd, "%s %s", remotecmd, argv[c]);
+ else
+ asprintf (&remotecmd, "%s", argv[c]);
+ }
+
+ if (commands > 1 || passive)
+ asprintf (&remotecmd, "%s;echo STATUS CODE: $?;", remotecmd);
+
+ if (remotecmd == NULL || strlen (remotecmd) <= 1)
+ usage_va(_("No remotecmd"));
+
+ asprintf (&comm, "%s %s '%s'", comm, hostname, remotecmd);
+
+ return validate_arguments ();
+}
{
if (remotecmd == NULL || hostname == NULL)
return ERROR;
- return OK;
-}
+ if (passive && commands != services)
+ die (STATE_UNKNOWN, _("%s: In passive mode, you must provide a service name for each command.\n"), progname);
+ if (passive && host_shortname == NULL)
+ die (STATE_UNKNOWN, _("%s: In passive mode, you must provide the host short name from the nagios configs.\n"), progname);
+ return OK;
+}
void
-print_help (char *cmd)
+print_help (void)
{
- print_revision (cmd, "$Revision$");
+ print_revision (progname, revision);
- printf
- ("Copyright (c) 1999 Karl DeBisschop (kdebisschop@alum.mit.edu)\n\n"
- "This plugin will execute a command on a remote host using SSH\n\n");
+ printf ("Copyright (c) 1999 Karl DeBisschop <kdebisschop@users.sourceforge.net>\n");
+ printf (COPYRIGHT, copyright, email);
- print_usage ();
+ printf (_("This plugin uses SSH to execute commands on a remote host"));
- printf
- ("\nOptions:\n"
- "-H, --hostname=HOST\n"
- " name or IP address of remote host\n"
- "-C, --command='COMMAND STRING'\n"
- " command to execute on the remote machine\n"
- "-f tells ssh to fork rather than create a tty\n"
- "-t, --timeout=INTEGER\n"
- " specify timeout (default: %d seconds) [optional]\n"
- "-p, --port=PORT\n"
- " port to connect to on remote system [optional]\n"
- "-l, --logname=USERNAME\n"
- " SSH user name on remote host [optional]\n"
- "-i, --identity=KEYFILE\n"
- " identity of an authorized key [optional]\n"
- "-O, --output=FILE\n"
- " external command file for nagios [optional]\n"
- "-s, --services=LIST\n"
- " list of nagios service names, separated by ':' [optional]\n"
- "-n, --name=NAME\n"
- " short name of host in nagios configuration [optional]\n"
- "-4, --use-ipv4\n"
- " tell ssh to use IPv4\n"
- "-6, --use-ipv6\n"
- " tell ssh to use IPv6\n"
- "\n"
- "The most common mode of use is to refer to a local identity file with\n"
- "the '-i' option. In this mode, the identity pair should have a null\n"
- "passphrase and the public key should be listed in the authorized_keys\n"
- "file of the remote host. Usually the key will be restricted to running\n"
- "only one command on the remote server. If the remote SSH server tracks\n"
- "invocation agruments, the one remote program may be an agent that can\n"
- "execute additional commands as proxy\n"
- "\n"
- "To use passive mode, provide multiple '-C' options, and provide\n"
- "all of -O, -s, and -n options (servicelist order must match '-C'\n"
- "options)\n", DEFAULT_SOCKET_TIMEOUT);
-}
+ printf ("\n\n");
+
+ print_usage ();
+ printf (_(UT_HELP_VRSN));
+
+ printf (_(UT_EXTRA_OPTS));
+
+ printf (_(UT_HOST_PORT), 'p', "none");
+
+ printf (_(UT_IPv46));
+
+ printf (" %s\n", "-1, --proto1");
+ printf (" %s\n", _("tell ssh to use Protocol 1 [optional]"));
+ printf (" %s\n", "-2, --proto2");
+ printf (" %s\n", _("tell ssh to use Protocol 2 [optional]"));
+ printf (" %s\n", "-S, --skip-stdout[=n]");
+ printf (" %s\n", _("Ignore all or (if specified) first n lines on STDOUT [optional]"));
+ printf (" %s\n", "-E, --skip-stderr[=n]");
+ printf (" %s\n", _("Ignore all or (if specified) first n lines on STDERR [optional]"));
+ printf (" %s\n", "-f");
+ printf (" %s\n", _("tells ssh to fork rather than create a tty [optional]. This will always return OK if ssh is executed"));
+ printf (" %s\n","-C, --command='COMMAND STRING'");
+ printf (" %s\n", _("command to execute on the remote machine"));
+ printf (" %s\n","-l, --logname=USERNAME");
+ printf (" %s\n", _("SSH user name on remote host [optional]"));
+ printf (" %s\n","-i, --identity=KEYFILE");
+ printf (" %s\n", _("identity of an authorized key [optional]"));
+ printf (" %s\n","-O, --output=FILE");
+ printf (" %s\n", _("external command file for nagios [optional]"));
+ printf (" %s\n","-s, --services=LIST");
+ printf (" %s\n", _("list of nagios service names, separated by ':' [optional]"));
+ printf (" %s\n","-n, --name=NAME");
+ printf (" %s\n", _("short name of host in nagios configuration [optional]"));
+ printf (" %s\n","-o, --ssh-option=OPTION");
+ printf (" %s\n", _("Call ssh with '-o OPTION' (may be used multiple times) [optional]"));
+ printf (" %s\n","-q, --quiet");
+ printf (" %s\n", _("Tell ssh to suppress warning and diagnostic messages [optional]"));
+ printf (_(UT_WARN_CRIT));
+ printf (_(UT_TIMEOUT), DEFAULT_SOCKET_TIMEOUT);
+ printf (_(UT_VERBOSE));
+ printf("\n");
+ printf (" %s\n", _("The most common mode of use is to refer to a local identity file with"));
+ printf (" %s\n", _("the '-i' option. In this mode, the identity pair should have a null"));
+ printf (" %s\n", _("passphrase and the public key should be listed in the authorized_keys"));
+ printf (" %s\n", _("file of the remote host. Usually the key will be restricted to running"));
+ printf (" %s\n", _("only one command on the remote server. If the remote SSH server tracks"));
+ printf (" %s\n", _("invocation arguments, the one remote program may be an agent that can"));
+ printf (" %s\n", _("execute additional commands as proxy"));
+ printf("\n");
+ printf (" %s\n", _("To use passive mode, provide multiple '-C' options, and provide"));
+ printf (" %s\n", _("all of -O, -s, and -n options (servicelist order must match '-C'options)"));
+ printf ("\n");
+ printf ("%s\n", _("Examples:"));
+ printf (" %s\n", "$ check_by_ssh -H localhost -n lh -s c1:c2:c3 -C uptime -C uptime -C uptime -O /tmp/foo");
+ printf (" %s\n", "$ cat /tmp/foo");
+ printf (" %s\n", "[1080933700] PROCESS_SERVICE_CHECK_RESULT;flint;c1;0; up 2 days");
+ printf (" %s\n", "[1080933700] PROCESS_SERVICE_CHECK_RESULT;flint;c2;0; up 2 days");
+ printf (" %s\n", "[1080933700] PROCESS_SERVICE_CHECK_RESULT;flint;c3;0; up 2 days");
+
+#ifdef NP_EXTRA_OPTS
+ printf("\n");
+ printf("%s\n", _("Notes:"));
+ printf(_(UT_EXTRA_OPTS_NOTES));
+#endif
+ printf(_(UT_SUPPORT));
+}
void
print_usage (void)
{
- printf
- ("Usage:\n"
- "check_by_ssh [-f46] [-t timeout] [-i identity] [-l user] -H <host> -C <command>\n"
- " [-n name] [-s servicelist] [-O outputfile] [-p port]\n"
- "check_by_ssh -V prints version info\n"
- "check_by_ssh -h prints more detailed help\n");
+ printf (_("Usage:"));
+ printf (" %s -H <host> -C <command> [-fqv] [-1|-2] [-4|-6]\n"
+ " [-S [lines]] [-E [lines]] [-t timeout] [-i identity]\n"
+ " [-l user] [-n name] [-s servicelist] [-O outputfile]\n"
+ " [-p port] [-o ssh-option]\n",
+ progname);
}