Copyright (C) 2016-2021 Reto Gantenbein <reto.gantenbein@linuxmonk.ch> SPDX-License-Identifier: GPL-3.0-or-later
Default variables
Basic options
- gdnsd__default_packages
List of packages to install by default.
gdnsd__default_packages: [ 'gdnsd' ]
- gdnsd__custom_packages
List of additional user defined packages to install.
gdnsd__custom_packages: []
- gdnsd__packages
List of packages to install.
gdnsd__packages: '{{ gdnsd__default_packages | union(gdnsd__custom_packages) }}'
- gdsnd__listen
List of local IP addresses (and ports) where gdsnd should listen for DNS requests. If emtpy, it will listen on all interfaces on port 53.
gdnsd__listen: []
- gdnsd__options
Dictionary of configuration options. See :man:`gdnsd.config(5)` for a description of the possible configuration parameters.
gdnsd__options: {}
Zone configuration
- gdnsd__zones
List of DNS zones. For a detailed explanation see gdnsd__zones.
gdnsd__zones: []
- gdnsd__ttl
Default TTL for zone entries.
gdnsd__ttl: 86400
- gdnsd__mailbox
Mailbox name of the person responsible for this zone.
gdnsd__mailbox: 'hostmaster'
- gdnsd__refresh
Time interval before the zone should be refreshed.
gdnsd__refresh: '3h'
- gdnsd__retry
Time interval that should elapse before a failed refresh should be retried.
gdnsd__retry: '1h'
- gdnsd__expire
Specifies how long zone data is considered valid in case the zone cannot be refreshed from the primary name server.
gdnsd__expire: '1w'
- gdnsd__negative_cache
Negative caching TTL.
gdnsd__negative_cache: '1h'
- gdnsd__auto_reverse_zone
Automatically generate reverse zones for defined domains. This can be
overwritten per zone by specificying the auto_reverse_zone
attribute in
the zone definition.
gdnsd__auto_reverse_zone: True
- gdnsd__default_reverse_zone:
Default reverse zone (e.g. 1.168.192.in-addr.arpa).
This value is used if a zone entry has defined auto_reverse_zone: True
but doesn’t specify the reverse_zone
.
The default_reverse_zone.j2
lookup template will generate the zone
name based on the subnet mask of the default IPv4 address of the host. A
class ‘C’ subnet mask will result in three IP address octets prefixing the
in-addr.arpa
domain, a class ‘B’ subnet in two octets and a class ‘A’
in one octet.
gdnsd__default_reverse_zone: '{{ lookup("template", "lookup/default_reverse_zone.j2") | trim }}'