/*****************************************************************************
*
* Monitoring check_real plugin
*
* License: GPL
* Copyright (c) 2000-2024 Monitoring Plugins Development Team
*
* Description:
*
* This file contains the check_real plugin
*
* This plugin tests the REAL service on the specified host.
*
*
* 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_real";
const char *copyright = "2000-2024";
const char *email = "devel@monitoring-plugins.org";
#include "common.h"
#include "netutils.h"
#include "utils.h"
enum {
PORT = 554
};
#define EXPECT "RTSP/1."
#define URL ""
static int process_arguments(int, char **);
static void print_help(void);
void print_usage(void);
static int server_port = PORT;
static char *server_address;
static char *host_name;
static char *server_url = NULL;
static char *server_expect;
static int warning_time = 0;
static bool check_warning_time = false;
static int critical_time = 0;
static bool check_critical_time = false;
static bool verbose = false;
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);
if (process_arguments(argc, argv) == ERROR)
usage4(_("Could not parse arguments"));
/* initialize alarm signal handling */
signal(SIGALRM, socket_timeout_alarm_handler);
/* set socket timeout */
alarm(socket_timeout);
time(&start_time);
/* try to connect to the host at the given port number */
int socket;
if (my_tcp_connect(server_address, server_port, &socket) != STATE_OK)
die(STATE_CRITICAL, _("Unable to connect to %s on port %d\n"), server_address, server_port);
/* Part I - Server Check */
/* send the OPTIONS request */
char buffer[MAX_INPUT_BUFFER];
sprintf(buffer, "OPTIONS rtsp://%s:%d RTSP/1.0\r\n", host_name, server_port);
int result = send(socket, buffer, strlen(buffer), 0);
/* send the header sync */
sprintf(buffer, "CSeq: 1\r\n");
result = send(socket, buffer, strlen(buffer), 0);
/* send a newline so the server knows we're done with the request */
sprintf(buffer, "\r\n");
result = send(socket, buffer, strlen(buffer), 0);
/* watch for the REAL connection string */
result = recv(socket, buffer, MAX_INPUT_BUFFER - 1, 0);
/* return a CRITICAL status if we couldn't read any data */
if (result == -1)
die(STATE_CRITICAL, _("No data received from %s\n"), host_name);
char *status_line = NULL;
/* make sure we find the response we are looking for */
if (!strstr(buffer, server_expect)) {
if (server_port == PORT)
printf("%s\n", _("Invalid REAL response received from host"));
else
printf(_("Invalid REAL response received from host on port %d\n"), server_port);
} else {
/* else we got the REAL string, so check the return code */
time(&end_time);
result = STATE_OK;
status_line = (char *)strtok(buffer, "\n");
if (strstr(status_line, "200"))
result = STATE_OK;
/* client errors result in a warning state */
else if (strstr(status_line, "400"))
result = STATE_WARNING;
else if (strstr(status_line, "401"))
result = STATE_WARNING;
else if (strstr(status_line, "402"))
result = STATE_WARNING;
else if (strstr(status_line, "403"))
result = STATE_WARNING;
else if (strstr(status_line, "404"))
result = STATE_WARNING;
/* server errors result in a critical state */
else if (strstr(status_line, "500"))
result = STATE_CRITICAL;
else if (strstr(status_line, "501"))
result = STATE_CRITICAL;
else if (strstr(status_line, "502"))
result = STATE_CRITICAL;
else if (strstr(status_line, "503"))
result = STATE_CRITICAL;
else
result = STATE_UNKNOWN;
}
/* Part II - Check stream exists and is ok */
if ((result == STATE_OK) && (server_url != NULL)) {
/* Part I - Server Check */
/* send the DESCRIBE request */
sprintf(buffer, "DESCRIBE rtsp://%s:%d%s RTSP/1.0\r\n", host_name, server_port, server_url);
result = send(socket, buffer, strlen(buffer), 0);
/* send the header sync */
sprintf(buffer, "CSeq: 2\r\n");
result = send(socket, buffer, strlen(buffer), 0);
/* send a newline so the server knows we're done with the request */
sprintf(buffer, "\r\n");
result = send(socket, buffer, strlen(buffer), 0);
/* watch for the REAL connection string */
result = recv(socket, buffer, MAX_INPUT_BUFFER - 1, 0);
buffer[result] = '\0'; /* null terminate received buffer */
/* return a CRITICAL status if we couldn't read any data */
if (result == -1) {
printf(_("No data received from host\n"));
result = STATE_CRITICAL;
} else {
/* make sure we find the response we are looking for */
if (!strstr(buffer, server_expect)) {
if (server_port == PORT)
printf("%s\n", _("Invalid REAL response received from host"));
else
printf(_("Invalid REAL response received from host on port %d\n"), server_port);
} else {
/* else we got the REAL string, so check the return code */
time(&end_time);
result = STATE_OK;
status_line = (char *)strtok(buffer, "\n");
if (strstr(status_line, "200"))
result = STATE_OK;
/* client errors result in a warning state */
else if (strstr(status_line, "400"))
result = STATE_WARNING;
else if (strstr(status_line, "401"))
result = STATE_WARNING;
else if (strstr(status_line, "402"))
result = STATE_WARNING;
else if (strstr(status_line, "403"))
result = STATE_WARNING;
else if (strstr(status_line, "404"))
result = STATE_WARNING;
/* server errors result in a critical state */
else if (strstr(status_line, "500"))
result = STATE_CRITICAL;
else if (strstr(status_line, "501"))
result = STATE_CRITICAL;
else if (strstr(status_line, "502"))
result = STATE_CRITICAL;
else if (strstr(status_line, "503"))
result = STATE_CRITICAL;
else
result = STATE_UNKNOWN;
}
}
}
/* Return results */
if (result == STATE_OK) {
if (check_critical_time && (end_time - start_time) > critical_time)
result = STATE_CRITICAL;
else if (check_warning_time && (end_time - start_time) > warning_time)
result = STATE_WARNING;
/* Put some HTML in here to create a dynamic link */
printf(_("REAL %s - %d second response time\n"), state_text(result), (int)(end_time - start_time));
} else
printf("%s\n", status_line);
/* close the connection */
close(socket);
/* reset the alarm */
alarm(0);
return result;
}
/* process command-line arguments */
int process_arguments(int argc, char **argv) {
static struct option longopts[] = {{"hostname", required_argument, 0, 'H'}, {"IPaddress", required_argument, 0, 'I'},
{"expect", required_argument, 0, 'e'}, {"url", required_argument, 0, 'u'},
{"port", required_argument, 0, 'p'}, {"critical", required_argument, 0, 'c'},
{"warning", required_argument, 0, 'w'}, {"timeout", required_argument, 0, 't'},
{"verbose", no_argument, 0, 'v'}, {"version", no_argument, 0, 'V'},
{"help", no_argument, 0, 'h'}, {0, 0, 0, 0}};
if (argc < 2)
return ERROR;
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_char;
while (true) {
int option = 0;
option_char = getopt_long(argc, argv, "+hvVI:H:e:u:p:w:c:t:", longopts, &option);
if (option_char == -1 || option_char == EOF)
break;
switch (option_char) {
case 'I': /* hostname */
case 'H': /* hostname */
if (server_address)
break;
else if (is_host(optarg))
server_address = optarg;
else
usage2(_("Invalid hostname/address"), optarg);
break;
case 'e': /* string to expect in response header */
server_expect = optarg;
break;
case 'u': /* server URL */
server_url = optarg;
break;
case 'p': /* port */
if (is_intpos(optarg)) {
server_port = atoi(optarg);
} else {
usage4(_("Port must be a positive integer"));
}
break;
case 'w': /* warning time threshold */
if (is_intnonneg(optarg)) {
warning_time = atoi(optarg);
check_warning_time = true;
} else {
usage4(_("Warning time must be a positive integer"));
}
break;
case 'c': /* critical time threshold */
if (is_intnonneg(optarg)) {
critical_time = atoi(optarg);
check_critical_time = true;
} else {
usage4(_("Critical time must be a positive integer"));
}
break;
case 'v': /* verbose */
verbose = true;
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);
case '?': /* usage */
usage5();
}
}
option_char = optind;
if (server_address == NULL && argc > option_char) {
if (is_host(argv[option_char])) {
server_address = argv[option_char++];
} else {
usage2(_("Invalid hostname/address"), argv[option_char]);
}
}
if (server_address == NULL)
usage4(_("You must provide a server to check"));
if (host_name == NULL)
host_name = strdup(server_address);
if (server_expect == NULL)
server_expect = strdup(EXPECT);
return OK;
}
void print_help(void) {
char *myport;
xasprintf(&myport, "%d", PORT);
print_revision(progname, NP_VERSION);
printf("Copyright (c) 1999 Pedro Leite \n");
printf(COPYRIGHT, copyright, email);
printf("%s\n", _("This plugin tests the REAL service on the specified host."));
printf("\n\n");
print_usage();
printf(UT_HELP_VRSN);
printf(UT_EXTRA_OPTS);
printf(UT_HOST_PORT, 'p', myport);
printf(" %s\n", "-u, --url=STRING");
printf(" %s\n", _("Connect to this url"));
printf(" %s\n", "-e, --expect=STRING");
printf(_("String to expect in first line of server response (default: %s)\n"), EXPECT);
printf(UT_WARN_CRIT);
printf(UT_CONN_TIMEOUT, DEFAULT_SOCKET_TIMEOUT);
printf(UT_VERBOSE);
printf("\n");
printf("%s\n", _("This plugin will attempt to open an RTSP connection with the host."));
printf("%s\n", _("Successful connects return STATE_OK, refusals and timeouts return"));
printf("%s\n", _("STATE_CRITICAL, other errors return STATE_UNKNOWN. Successful connects,"));
printf("%s\n", _("but incorrect response messages from the host result in STATE_WARNING return"));
printf("%s\n", _("values."));
printf(UT_SUPPORT);
}
void print_usage(void) {
printf("%s\n", _("Usage:"));
printf("%s -H host [-e expect] [-p port] [-w warn] [-c crit] [-t timeout] [-v]\n", progname);
}