Scroll to navigation

GDNSD-PLUGIN-NULL(8) gdnsd GDNSD-PLUGIN-NULL(8)

NAME

gdnsd-plugin-null - gdnsd null plugin

SYNOPSIS

Example null service_types config:

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

Zonefile RRs using null resolution

  foo 300 DYNA null
  bar 300 DYNC null!whatever

DESCRIPTION

gdnsd-plugin-null exists mostly as an example of the minimum possible plugin of both types. It is simultaneously both a monitoring plugin and a resolution plugin.

When used as a resolution plugin in "DNYA" or "DYNC" RRs, it ignores any resource name provided. It always returns the IPv4 address 0.0.0.0 and the IPv6 address "::".

When used as a monitoring plugin by defining a service_type as shown in the example above it emulates the behavior of a real monitoring plugin (updating at correct intervals, etc) but sends a "DOWN" result at every monitoring check interval without actually checking anything.

SEE ALSO

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

The gdnsd manual.

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

2024-09-20 gdnsd 3.8.3