GDNSD-PLUGIN-NULL(8)

💅 gdnsd-plugin-null — the gdnsd null plugin

okay bestie, welcome to gdnsd-plugin-null(8) 🎀 this is a manual page for a plugin in the gdnsd suite, and honestly? it's the icon of doing the absolute least and still serving. let's get into it ✨

---

✨ SYNOPSIS ✨

here's what a null service_types config looks like, look at her go 🦋

service_types => {
  my_null_mon => {
    plugin => null,
    # ... other generic service_type params
  }
}

and here's zonefile RRs using null resolution, periodt 💅

foo 300 DYNA null
bar 300 DYNC null!whatever

---

🌸 DESCRIPTION 🌸

so gdnsd-plugin-null is mostly there as a lil example of the minimum possible plugin of both types. and the way that it's simultaneously both a monitoring plugin AND a resolution plugin? it's giving overachiever but make it underachiever 💀✨

🎀 when it's a resolution plugin

when you use it as a resolution plugin in DNYA or DYNC RRs, it straight up ignores any resource name you hand it. like, doesn't even look. 🙈

it always returns the IPv4 address 0.0.0.0 and the IPv6 address ::. that's it. that's the whole output. no cap. 👑

💖 when it's a monitoring plugin

when you use it as a monitoring plugin by defining a service_type like in the example up above, it emulates the behavior of a real monitoring plugin (updating at correct intervals, etc) — so it looks like it's doing the whole routine 🩰 — but it sends a "DOWN" result at every monitoring check interval without actually checking anything. not one single check. iconic behavior, truly 😭

---

🫶 SEE ALSO 🫶

• gdnsd.config(5)
• gdnsd.zonefile(5)
• gdnsd(8)

also: the gdnsd manual, if you wanna go deeper, bestie 📖

---

👑 COPYRIGHT AND LICENSE 👑

Copyright (c) 2014 Brandon L Black <blblack@gmail.com>

This file is part of gdnsd.

gdnsd 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.

gdnsd 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 gdnsd. If not, see <http://www.gnu.org/licenses/>.

fr fr, read the license, it's not a vibe check you can skip 💛

---

this has been gdnsd version 3.8.3, dated 2025-02-16 — mwah, slay, go touch some DNS records 💅💖🌈