GDNSD-PLUGIN-STATIC(8)

💖 GDNSD-PLUGIN-STATIC 💖

okay bestie, so this is the page for gdnsd-plugin-static — the static plugin for gdnsd, straight out of the gdnsd manual. sit down, hydrate, let's get into it 🫶

---

✨ NAME ✨

gdnsd-plugin-static — it's the gdnsd static plugin, that's the whole name, no notes 💅

---

🌸 SYNOPSIS 🌸

so here's an example static resources config for resolution, look at her go:

plugins => {
  static => {
    foo => 192.0.2.1
    bar => 2001:db8::1
    baz => something.example.org.
  }
}

and here's an example static service_types config for monitoring:

service_types => {
  my_static_mon => {
    plugin => static,
    ttl => 123,
    state => UP,
    # ... other generic service_type params (ignored)
  }
}

and then zonefile RRs using the static plugin for resolution, inside the zone example.com, slay:

foo 300 DYNA static!foo
bar 300 DYNC static!bar
baz 300 DYNC static!baz

---

🦋 DESCRIPTION 🦋

gdnsd-plugin-static is a combined monitoring and resolution plugin that just... returns static data. that's it, that's the whole personality. ngl it's generally useless in real scenarios — it mostly serves as an example/test plugin. she's not the main character, she's the tutorial level 🎀

for resolution, the config is a simple key/value hash where the keys are resource names and the values can be either a single IP address (v4 or v6) or a domainname. the domainname form can only be used with DYNC, while the address form works with either DYNA or DYNC. periodt 💅

for monitoring config as a service_type, the only two useful parameters are ttl and state, which set a fixed TTL and state for this static monitor result. the other standard monitoring parameters (like interval, timeout, all of that) are ignored, because static sets its states once at startup and then never runs again. she said one and done 💀

---

🌈 SEE ALSO 🌈

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

and yeah — that's the gdnsd manual, go read it, iykyk ✨

---

👑 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, the license is not a vibe check you can skip. read it, respect it, love her 💜

and that's a wrap, bestie 🫶 this was gdnsd 3.8.3, dated 2025-02-16, from the GDNSD-PLUGIN-STATIC(8) page. go forth and return static data like the icon you are 🌟💖