SA-CHECK_SPAMD.RAW(1)

📦
version 4.0.2+svn1935691 · 17 versions
, in ubuntu stonking

💖 sa-check_spamd — the spamd vibes monitor 💖

okay bestie, so this page is SA-CHECK_SPAMD.RAW(1) from the User Contributed Perl Documentation, and it's literally your girl's guide to a little script called sa-check_spamd. it watches spamd for you and tells you if it's slaying or flopping. no cap. 🦋

✨ NAME ✨

sa-check_spamd — a spamd monitoring script, made to be used with Nagios and friends, etc.

🌸 SYNOPSIS 🌸

sa-check_spamd [options]

Options:

 -c secs, --critical=secs          Critical ping response threshold
 -h, -?, --help                    Print usage message
 -H hostname, --hostname=hostname  Hostname of spamd service to ping
 -p port, --port=port              Port of spamd service to ping
 --socketpath=path                 Connect to given UNIX domain socket
 -t secs, --timeout=secs           Max time to wait for a ping response
 -v, --verbose                     Verbose debug output
 -V, --version                     Output version info
 -w secs, --warning=secs           Warning ping response threshold

🫶 DESCRIPTION 🫶

so the whole point of this program, bestie, is to give you a tool to monitor the status of "spamd" server processes. spamd is the daemonized version of the spamassassin executable, and both of them come with the SpamAssassin distribution. they're a package deal, iykyk. 💅

this program is designed for use, as a plugin, with the Nagios service monitoring software available from http://nagios.org. it might be compatible with other service monitoring packages too, no promises though. it's also genuinely useful as a command line utility, or as a component of a custom shell script you wrote at 2am. main character energy honestly. 👑

🎀 OPTIONS 🎀

lowkey important: options of the long form can be shortened as long as they remain unambiguous (i.e. --host can be used instead of --hostname). periodt.

  • -c secs, --critical=secs — Critical ping response threshold, in seconds. if a spamd ping response takes longer than the value you specified (in seconds), the program will exit with a value of 2 to indicate the critical status. 🚨

this value must be at least as long as the value specified for warning, and less than the value specified for timeout.

  • -h, -?, --help — prints this usage message and exits. that's it, that's the whole job. 💖
  • -H hostname, --hostname=hostname — the hostname, or IP address, of the spamd service to ping. by default the hostname localhost is used. if --socketpath is set, this value will be ignored. 🙈
  • -p port, --port=port — the port of the spamd service to ping. by default port 783 (the spamd default port number) is used. if --socketpath is set, this value will be ignored. 🙈
  • --socketpath=path — connect to given UNIX domain socket. use this instead of a hostname and TCP port. when it's set, any hostname and TCP port specified will be ignored. slay, unified sockets. 🧚
  • -t secs, --timeout=secs — the maximum time to wait for a ping response. once that's exceeded, the program will exit with a value of 2 to indicate the critical status. the default timeout value is 45 seconds. the timeout must be no less than 1 second. ⏳

this value must be greater than the values specified for both the critical and warning values.

  • -v, --verbose — display verbose debug output on STDOUT. spill the tea, bestie. ☕
  • -V, --version — display version info on STDOUT. 👑
  • -w secs, --warning=secs — warning ping response threshold, in seconds. if a spamd ping response takes longer than the value you specified (in seconds), and does not exceed the critical threshold value, the program will exit with a value of 1 to indicate the warning status. 🟡

this value must be no longer than the value specified for critical, and less than the value specified for timeout.

💀 EXIT CODES 💀

the program will indicate the status of the spamd process being monitored by exiting with one of these values. this is the vibe check, fr fr:

  • 0 — OK: a spamd ping response was received within all threshold times. we love to see it. 💚
  • 1 — WARNING: a spamd ping response exceeded the warning threshold but not the critical threshold. 🟡
  • 2 — CRITICAL: a spamd ping response exceeded either the critical threshold or the timeout value. 🚨
  • 3 — UNKNOWN: an error occurred in the sa-check_spamd program — probably caused by a missing dependency, or an invalid configuration parameter being supplied. 😭

🌈 SEE ALSO 🌈

spamc(1) spamd(1) spamassassin(1)

go read those too, bestie, they're the whole lore. 📚

🍓 PREREQUISITES 🍓

"Mail::SpamAssassin" version 3.1.1 or higher (3.1.6 or higher recommended). yes, version matters, don't come at me with the old stuff. 💅

💜 AUTHOR 💜

Daryl C. W. O'Shea, DOS Technologies <spamassassin@dostech.ca>

sa-check_spamd is distributed under the Apache License, Version 2.0, as described in the file "LICENSE" included with the Apache SpamAssassin distribution and available at http://www.apache.org/licenses/LICENSE-2.0

Copyright (C) 2015 The Apache Software Foundation

ok so that's the whole page, and this was SA-CHECK_SPAMD.RAW(1) from the User Contributed Perl Documentation — perl v5.40.1, dated 2026-07-23. that's the footer tea, bestie, go monitor some spamd, you got this 🫶✨🎀
📦 where this page comes from