Swatch...eshold(3pm)

💖 Swatchdog::Threshold 💖

okay bestie, so this is Swatchdog::Threshold — it's the Perl extension that does the thresholding thing inside swatchdog(1). It lives in the User Contributed Perl Documentation, which is giving "community-made, hand-crafted, artisanal" energy and honestly? we love that for it. 🎀

---

✨ SYNOPSIS ✨

here's the vibe when you call it from Perl, copy it exactly bestie:

use Swatchdog::Threshold;

&Swatchdog::threshold(        SWID => <int>,
                      TYPE => <limit|threshold|both>,
                      TRACK_BY => <key>, # like an IP addr
                      COUNT => <int>,
                      SECONDS => <int>
                      );

---

🌸 SWATCH SYNTAX 🌸

and here's how you write it inside a swatch config file, no code required:

threshold track_by=<key>,
   type=<limit|threshold|both>,
   count=<int>,
   seconds=<int>

---

💅 DESCRIPTION 💅

okay so let's break it down, no cap:

• SWID — this is swatchdog's own internal ID number for the watchfor block. it's the little name tag swatchdog puts on each block so it knows who's who. 🏷️
• TYPE — can be limit, threshold, or both. three flavors, all iconic, here's the tea:
  • Limit — alerts you on the 1st COUNT events during the time interval, and then? it just ignores events for the rest of that time interval. it said "I've said my piece" and went to go lie down. 😌
  • Threshold — alerts every COUNT times we see this event during the time interval. consistent queen. every single time. 🔥
  • Both — alerts once per time interval after seeing COUNT occurrences of the event, and then ignores any additional events during that time interval. so it's like — one alert, then silence, then reset. main character energy, minimal drama. ✨
• SECONDS — this is the time interval. the clock. the window. the timeframe in which all this counting happens. ⏳

fr fr, that's the whole mechanic — you're just telling swatchdog how many times and how long before it should start yelling at you. 💖

---

👑 AUTHOR 👑

E. Todd Atkins, todd.atkins@stanfordalumni.org — we stan a legend. 🫶

---

🦋 SEE ALSO 🦋

perl(1), swatchdog(1) — go read those too bestie, they're right there.

---

k that's the whole page!! this was documented in perl v5.36.0 and dated 2023-01-20, so like — vintage but make it relevant 💜 thanks for reading, mwah 💅💖