/*****************************************************************************
*
* Monitoring check_swap plugin
*
* License: GPL
* Copyright (c) 2000 Karl DeBisschop (kdebisschop@users.sourceforge.net)
* Copyright (c) 2000-2023 Monitoring Plugins Development Team
*
* Description:
*
* This file contains the check_swap 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 .
*
*
*****************************************************************************/
const char *progname = "check_swap";
const char *copyright = "2000-2023";
const char *email = "devel@monitoring-plugins.org";
#include "common.h"
#include "popen.h"
#include "utils.h"
#ifdef HAVE_DECL_SWAPCTL
#ifdef HAVE_SYS_PARAM_H
#include
#endif
#ifdef HAVE_SYS_SWAP_H
#include
#endif
#ifdef HAVE_SYS_STAT_H
#include
#endif
#endif
#ifndef SWAP_CONVERSION
#define SWAP_CONVERSION 1
#endif
typedef struct {
bool is_percentage;
uint64_t value;
} threshold;
typedef struct {
unsigned long long free; // Free swap in Bytes!
unsigned long long used; // Used swap in Bytes!
unsigned long long total; // Total swap size, you guessed it, in Bytes!
} swap_metrics;
typedef struct {
int errorcode;
int statusCode;
swap_metrics metrics;
} swap_result;
typedef struct {
int verbose;
bool allswaps;
int no_swap_state;
threshold warn;
threshold crit;
} swap_config;
typedef struct {
int errorcode;
swap_config config;
} swap_config_wrapper;
swap_config_wrapper process_arguments(swap_config_wrapper config, int argc,
char **argv);
void print_usage();
void print_help(swap_config);
swap_result getSwapFromProcMeminfo(swap_config config);
swap_result getSwapFromSwapCommand(swap_config config);
swap_result getSwapFromSwapctl_BSD(swap_config config);
swap_result getSwapFromSwap_SRV4(swap_config config);
swap_config swap_config_init() {
swap_config tmp = {0};
tmp.allswaps = false;
tmp.no_swap_state = STATE_CRITICAL;
tmp.verbose = 0;
return tmp;
}
int main(int argc, char **argv) {
setlocale(LC_ALL, "");
bindtextdomain(PACKAGE, LOCALEDIR);
textdomain(PACKAGE);
char *status;
status = strdup("");
/* Parse extra opts if any */
argv = np_extra_opts(&argc, argv, progname);
swap_config_wrapper tmp = {.errorcode = OK};
tmp.config = swap_config_init();
tmp = process_arguments(tmp, argc, argv);
if (tmp.errorcode != OK) {
usage4(_("Could not parse arguments"));
}
swap_config config = tmp.config;
#ifdef HAVE_PROC_MEMINFO
swap_result data = getSwapFromProcMeminfo(config);
#else
#ifdef HAVE_SWAP
swap_result data = getSwapFromSwapCommand();
#else
#ifdef CHECK_SWAP_SWAPCTL_SVR4
swap_result data = getSwapFromSwapctl_SRV4();
#else
#ifdef CHECK_SWAP_SWAPCTL_BSD
swap_result data = getSwapFromSwapctl_BSD();
#else
#error No way found to retrieve swap
#endif /* CHECK_SWAP_SWAPCTL_BSD */
#endif /* CHECK_SWAP_SWAPCTL_SVR4 */
#endif /* HAVE_SWAP */
#endif /* HAVE_PROC_MEMINFO */
double percent_used;
/* if total_swap_mb == 0, let's not divide by 0 */
if (data.metrics.total != 0) {
percent_used =
100 * ((double)data.metrics.used) / ((double)data.metrics.total);
} else {
printf(_("SWAP %s - Swap is either disabled, not present, or of zero "
"size."),
state_text(data.statusCode));
exit(config.no_swap_state);
}
if (config.verbose) {
printf("Computed usage percentage: %g\n", percent_used);
}
uint64_t warn_print = config.warn.value;
if (config.warn.is_percentage) {
warn_print = config.warn.value * (data.metrics.total / 100);
}
uint64_t crit_print = config.crit.value;
if (config.crit.is_percentage) {
crit_print = config.crit.value * (data.metrics.total / 100);
}
char *perfdata =
perfdata_uint64("swap", data.metrics.free, "B", true, warn_print, true,
crit_print, true, 0, true, (long)data.metrics.total);
if (config.verbose > 1) {
printf("Warn threshold value: %" PRIu64 "\n", config.warn.value);
}
if ((config.warn.is_percentage &&
(percent_used >= (100 - config.warn.value))) ||
config.warn.value >= data.metrics.free) {
data.statusCode = max_state(data.statusCode, STATE_WARNING);
}
if (config.verbose > 1) {
printf("Crit threshold value: %" PRIu64 "\n", config.crit.value);
}
if ((config.crit.is_percentage &&
(percent_used >= (100 - config.crit.value))) ||
config.crit.value >= data.metrics.free) {
data.statusCode = max_state(data.statusCode, STATE_CRITICAL);
}
printf(_("SWAP %s - %g%% free (%lluMB out of %lluMB) %s|%s\n"),
state_text(data.statusCode), (100 - percent_used), data.metrics.free,
data.metrics.total, status, perfdata);
exit(data.statusCode);
}
/* process command-line arguments */
swap_config_wrapper process_arguments(swap_config_wrapper conf_wrapper,
int argc, char **argv) {
if (argc < 2) {
conf_wrapper.errorcode = ERROR;
return conf_wrapper;
}
int option = 0;
static struct option longopts[] = {{"warning", required_argument, 0, 'w'},
{"critical", required_argument, 0, 'c'},
{"allswaps", no_argument, 0, 'a'},
{"no-swap", required_argument, 0, 'n'},
{"verbose", no_argument, 0, 'v'},
{"version", no_argument, 0, 'V'},
{"help", no_argument, 0, 'h'},
{0, 0, 0, 0}};
int c = 0; /* option character */
while (true) {
c = getopt_long(argc, argv, "+?Vvhac:w:n:", longopts, &option);
if (c == -1 || c == EOF)
break;
switch (c) {
case 'w': /* warning size threshold */
{
/*
* We expect either a positive integer value without a unit, which
* means the unit is Bytes or a positive integer value and a
* percentage sign (%), which means the value must be with 0 and 100
* and is relative to the total swap
*/
size_t length;
length = strlen(optarg);
if (optarg[length - 1] == '%') {
/* It's percentage */
conf_wrapper.config.warn.is_percentage = true;
optarg[length - 1] = '\0';
if (is_uint64(optarg, &conf_wrapper.config.warn.value)) {
if (conf_wrapper.config.warn.value > 100) {
usage4(
_("Warning threshold percentage must be <= 100!"));
}
}
break;
} else {
/* It's Bytes */
conf_wrapper.config.warn.is_percentage = false;
if (is_uint64(optarg, &conf_wrapper.config.warn.value)) {
break;
} else {
usage4(_("Warning threshold be positive integer or "
"percentage!"));
}
}
}
case 'c': /* critical size threshold */
{
/*
* We expect either a positive integer value without a unit, which
* means the unit is Bytes or a positive integer value and a
* percentage sign (%), which means the value must be with 0 and 100
* and is relative to the total swap
*/
size_t length;
length = strlen(optarg);
if (optarg[length - 1] == '%') {
/* It's percentage */
conf_wrapper.config.crit.is_percentage = true;
optarg[length - 1] = '\0';
if (is_uint64(optarg, &conf_wrapper.config.crit.value)) {
if (conf_wrapper.config.crit.value > 100) {
usage4(
_("Critical threshold percentage must be <= 100!"));
}
}
break;
} else {
/* It's Bytes */
conf_wrapper.config.crit.is_percentage = false;
if (is_uint64(optarg, &conf_wrapper.config.crit.value)) {
break;
} else {
usage4(_("Critical threshold be positive integer or "
"percentage!"));
}
}
}
case 'a': /* all swap */
conf_wrapper.config.allswaps = true;
break;
case 'n':
if ((conf_wrapper.config.no_swap_state =
mp_translate_state(optarg)) == ERROR) {
usage4(_("no-swap result must be a valid state name (OK, "
"WARNING, CRITICAL, UNKNOWN) or integer (0-3)."));
}
break;
case 'v': /* verbose */
conf_wrapper.config.verbose++;
break;
case 'V': /* version */
print_revision(progname, NP_VERSION);
exit(STATE_UNKNOWN);
case 'h': /* help */
print_help(conf_wrapper.config);
exit(STATE_UNKNOWN);
case '?': /* error */
usage5();
}
}
c = optind;
if (conf_wrapper.config.warn.value == 0 &&
conf_wrapper.config.crit.value == 0) {
conf_wrapper.errorcode = ERROR;
return conf_wrapper;
} else if ((conf_wrapper.config.warn.is_percentage ==
conf_wrapper.config.crit.is_percentage) &&
(conf_wrapper.config.warn.value >=
conf_wrapper.config.crit.value)) {
/* This is NOT triggered if warn and crit are different units, e.g warn
* is percentage and crit is absolute. We cannot determine the condition
* at this point since we dont know the value of total swap yet
*/
usage4(_("Warning should be more than critical"));
}
return conf_wrapper;
}
void print_help(swap_config config) {
print_revision(progname, NP_VERSION);
printf(_(COPYRIGHT), copyright, email);
printf("%s\n", _("Check swap space on local machine."));
printf("\n\n");
print_usage();
printf(UT_HELP_VRSN);
printf(UT_EXTRA_OPTS);
printf(" %s\n", "-w, --warning=INTEGER");
printf(" %s\n", _("Exit with WARNING status if less than INTEGER bytes "
"of swap space are free"));
printf(" %s\n", "-w, --warning=PERCENT%");
printf(" %s\n", _("Exit with WARNING status if less than PERCENT of "
"swap space is free"));
printf(" %s\n", "-c, --critical=INTEGER");
printf(" %s\n", _("Exit with CRITICAL status if less than INTEGER bytes "
"of swap space are free"));
printf(" %s\n", "-c, --critical=PERCENT%");
printf(" %s\n", _("Exit with CRITICAL status if less than PERCENT of "
"swap space is free"));
printf(" %s\n", "-a, --allswaps");
printf(" %s\n",
_("Conduct comparisons for all swap partitions, one by one"));
printf(" %s\n", "-n, --no-swap=");
printf(" %s %s\n",
_("Resulting state when there is no swap regardless of thresholds. "
"Default:"),
state_text(config.no_swap_state));
printf(UT_VERBOSE);
printf("\n");
printf("%s\n", _("Notes:"));
printf(" %s\n", _("Both INTEGER and PERCENT thresholds can be specified, "
"they are all checked."));
printf(
" %s\n",
_("On AIX, if -a is specified, uses lsps -a, otherwise uses lsps -s."));
printf(UT_SUPPORT);
}
void print_usage() {
printf("%s\n", _("Usage:"));
printf(" %s [-av] -w %% -c %%\n", progname);
printf(" -w -c [-n ]\n");
}
#ifdef HAVE_PROC_MEMINFO
swap_result getSwapFromProcMeminfo(swap_config config) {
if (config.verbose >= 3) {
printf("Reading PROC_MEMINFO at %s\n", PROC_MEMINFO);
}
FILE *fp;
fp = fopen(PROC_MEMINFO, "r");
swap_result result = {0};
result.statusCode = STATE_OK;
uint64_t swap_total = 0, swap_used = 0, swap_free = 0;
char input_buffer[MAX_INPUT_BUFFER];
char str[32];
while (fgets(input_buffer, MAX_INPUT_BUFFER - 1, fp)) {
uint64_t tmp_KB = 0;
/*
* The following sscanf call looks for a line looking like: "Swap: 123
* 123 123" On which kind of system this format exists, I can not say,
* but I wanted to document this for people who are not adapt with
* sscanf anymore, like me
*/
if (sscanf(input_buffer, "%*[S]%*[w]%*[a]%*[p]%*[:] %lu %lu %lu",
&swap_total, &swap_used, &swap_free) == 3) {
result.metrics.total += swap_total;
result.metrics.used += swap_used;
result.metrics.free += swap_free;
/*
* The following sscanf call looks for lines looking like:
* "SwapTotal: 123" and "SwapFree: 123" This format exists at least
* on Debian Linux with a 5.* kernel
*/
} else if (sscanf(input_buffer,
"%*[S]%*[w]%*[a]%*[p]%[TotalFreCchd]%*[:] %lu "
"%*[k]%*[B]",
str, &tmp_KB)) {
if (config.verbose >= 3) {
printf("Got %s with %lu\n", str, tmp_KB);
}
/* I think this part is always in Kb, so convert to mb */
if (strcmp("Total", str) == 0) {
swap_total = tmp_KB * 1024;
} else if (strcmp("Free", str) == 0) {
swap_free = swap_free + tmp_KB * 1024;
} else if (strcmp("Cached", str) == 0) {
swap_free = swap_free + tmp_KB * 1024;
}
}
}
fclose(fp);
result.metrics.total = swap_total;
result.metrics.used = swap_total - swap_free;
result.metrics.free = swap_free;
return result;
}
#endif
#ifdef HAVE_SWAP
swap_result getSwapFromSwapCommand() {
swap_result result = {0};
char *temp_buffer;
char *swap_command;
char *swap_format;
int conv_factor = SWAP_CONVERSION;
xasprintf(&swap_command, "%s", SWAP_COMMAND);
xasprintf(&swap_format, "%s", SWAP_FORMAT);
/* These override the command used if a summary (and thus ! allswaps) is
* required */
/* The summary flag returns more accurate information about swap usage on these
* OSes */
#ifdef _AIX
if (!allswaps) {
xasprintf(&swap_command, "%s", "/usr/sbin/lsps -s");
xasprintf(&swap_format, "%s", "%lu%*s %lu");
conv_factor = 1;
}
#endif
if (verbose >= 2)
printf(_("Command: %s\n"), swap_command);
if (verbose >= 3)
printf(_("Format: %s\n"), swap_format);
child_process = spopen(swap_command);
if (child_process == NULL) {
printf(_("Could not open pipe: %s\n"), swap_command);
return STATE_UNKNOWN;
}
child_stderr = fdopen(child_stderr_array[fileno(child_process)], "r");
if (child_stderr == NULL)
printf(_("Could not open stderr for %s\n"), swap_command);
sprintf(str, "%s", "");
/* read 1st line */
fgets(input_buffer, MAX_INPUT_BUFFER - 1, child_process);
if (strcmp(swap_format, "") == 0) {
temp_buffer = strtok(input_buffer, " \n");
while (temp_buffer) {
if (strstr(temp_buffer, "blocks"))
sprintf(str, "%s %s", str, "%lu");
else if (strstr(temp_buffer, "dskfree"))
sprintf(str, "%s %s", str, "%lu");
else
sprintf(str, "%s %s", str, "%*s");
temp_buffer = strtok(NULL, " \n");
}
}
/* If different swap command is used for summary switch, need to read format
* differently */
#ifdef _AIX
if (!allswaps) {
fgets(input_buffer, MAX_INPUT_BUFFER - 1,
child_process); /* Ignore first line */
sscanf(input_buffer, swap_format, &total_swap_mb, &used_swap_mb);
free_swap_mb = total_swap_mb * (100 - used_swap_mb) / 100;
used_swap_mb = total_swap_mb - free_swap_mb;
if (verbose >= 3)
printf(_("total=%.0f, used=%.0f, free=%.0f\n"), total_swap_mb,
used_swap_mb, free_swap_mb);
} else {
#endif
while (fgets(input_buffer, MAX_INPUT_BUFFER - 1, child_process)) {
sscanf(input_buffer, swap_format, &dsktotal_mb, &dskfree_mb);
dsktotal_mb = dsktotal_mb / conv_factor;
/* AIX lists percent used, so this converts to dskfree in MBs */
#ifdef _AIX
dskfree_mb = dsktotal_mb * (100 - dskfree_mb) / 100;
#else
dskfree_mb = dskfree_mb / conv_factor;
#endif
if (verbose >= 3)
printf(_("total=%.0f, free=%.0f\n"), dsktotal_mb, dskfree_mb);
dskused_mb = dsktotal_mb - dskfree_mb;
total_swap_mb += dsktotal_mb;
used_swap_mb += dskused_mb;
free_swap_mb += dskfree_mb;
if (allswaps) {
percent = 100 * (((double)dskused_mb) / ((double)dsktotal_mb));
result = max_state(result, check_swap(dskfree_mb, dsktotal_mb));
if (verbose)
xasprintf(&status, "%s [%.0f (%d%%)]", status, dskfree_mb,
100 - percent);
}
}
#ifdef _AIX
}
#endif
/* If we get anything on STDERR, at least set warning */
while (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);
}
#endif // HAVE_SWAP
#ifdef CHECK_SWAP_SWAPCTL_BSD
swap_result getSwapFromSwapctl_BSD(swap_config config) {
int i = 0, nswaps = 0, swapctl_res = 0;
struct swapent *ent;
int conv_factor = SWAP_CONVERSION;
/* get the number of active swap devices */
nswaps = swapctl(SWAP_NSWAP, NULL, 0);
/* initialize swap table + entries */
ent = (struct swapent *)malloc(sizeof(struct swapent) * nswaps);
/* and now, tally 'em up */
swapctl_res = swapctl(SWAP_STATS, ent, nswaps);
if (swapctl_res < 0) {
perror(_("swapctl failed: "));
die(STATE_UNKNOWN, _("Error in swapctl call\n"));
}
double dsktotal_mb = 0.0, dskfree_mb = 0.0, dskused_mb = 0.0;
unsigned long long total_swap_mb = 0, free_swap_mb = 0, used_swap_mb = 0;
for (i = 0; i < nswaps; i++) {
dsktotal_mb = (float)ent[i].se_nblks / conv_factor;
dskused_mb = (float)ent[i].se_inuse / conv_factor;
dskfree_mb = (dsktotal_mb - dskused_mb);
if (config.allswaps && dsktotal_mb > 0) {
double percent = 100 * (((double)dskused_mb) / ((double)dsktotal_mb));
if (config.verbose) {
printf("[%.0f (%g%%)]", dskfree_mb, 100 - percent);
}
}
total_swap_mb += dsktotal_mb;
free_swap_mb += dskfree_mb;
used_swap_mb += dskused_mb;
}
/* and clean up after ourselves */
free(ent);
swap_result result = {0};
result.statusCode = OK;
result.errorcode = OK;
result.metrics.total = total_swap_mb * 1024 * 1024;
result.metrics.free = free_swap_mb * 1024 * 1024;
result.metrics.used = used_swap_mb * 1024 * 1024;
return result;
}
#endif // CHECK_SWAP_SWAPCTL_BSD
#ifdef CHECK_SWAP_SWAPCTL_SVR4
swap_result getSwapFromSwap_SRV4(swap_config config) {
int i = 0, nswaps = 0, swapctl_res = 0;
//swaptbl_t *tbl = NULL;
void*tbl = NULL;
//swapent_t *ent = NULL;
void*ent = NULL;
/* get the number of active swap devices */
if ((nswaps = swapctl(SC_GETNSWP, NULL)) == -1)
die(STATE_UNKNOWN, _("Error getting swap devices\n"));
if (nswaps == 0)
die(STATE_OK, _("SWAP OK: No swap devices defined\n"));
if (config.verbose >= 3)
printf("Found %d swap device(s)\n", nswaps);
/* initialize swap table + entries */
tbl = (swaptbl_t *)malloc(sizeof(swaptbl_t) + (sizeof(swapent_t) * nswaps));
if (tbl == NULL)
die(STATE_UNKNOWN, _("malloc() failed!\n"));
memset(tbl, 0, sizeof(swaptbl_t) + (sizeof(swapent_t) * nswaps));
tbl->swt_n = nswaps;
for (i = 0; i < nswaps; i++) {
if ((tbl->swt_ent[i].ste_path =
(char *)malloc(sizeof(char) * MAXPATHLEN)) == NULL)
die(STATE_UNKNOWN, _("malloc() failed!\n"));
}
/* and now, tally 'em up */
swapctl_res = swapctl(SC_LIST, tbl);
if (swapctl_res < 0) {
perror(_("swapctl failed: "));
die(STATE_UNKNOWN, _("Error in swapctl call\n"));
}
double dsktotal_mb = 0.0, dskfree_mb = 0.0, dskused_mb = 0.0;
unsigned long long total_swap_mb = 0, free_swap_mb = 0, used_swap_mb = 0;
for (i = 0; i < nswaps; i++) {
dsktotal_mb = (float)tbl->swt_ent[i].ste_pages / SWAP_CONVERSION;
dskfree_mb = (float)tbl->swt_ent[i].ste_free / SWAP_CONVERSION;
dskused_mb = (dsktotal_mb - dskfree_mb);
if (config.verbose >= 3)
printf("dsktotal_mb=%.0f dskfree_mb=%.0f dskused_mb=%.0f\n",
dsktotal_mb, dskfree_mb, dskused_mb);
if (config.allswaps && dsktotal_mb > 0) {
double percent = 100 * (((double)dskused_mb) / ((double)dsktotal_mb));
if (config.verbose) {
printf("[%.0f (%g%%)]", dskfree_mb, 100 - percent);
}
}
total_swap_mb += dsktotal_mb;
free_swap_mb += dskfree_mb;
used_swap_mb += dskused_mb;
}
/* and clean up after ourselves */
for (i = 0; i < nswaps; i++) {
free(tbl->swt_ent[i].ste_path);
}
free(tbl);
swap_result result = {0};
result.errorcode = OK;
result.metrics.total = total_swap_mb * 1024 * 1024;
result.metrics.free = free_swap_mb * 1024 * 1024;
result.metrics.used = used_swap_mb * 1024 * 1024;
return result;
}
#endif // CHECK_SWAP_SWAPCTL_SVR4