xenial (5) gdnsd.djbdns.5.gz

Provided by: gdnsd_2.2.0-1ubuntu1_amd64 bug

NAME
       gdnsd.djbdns - gdnsd support for the djbdns tinydns zone data format


SYNOPSIS
         /etc/gdnsd/djbdns/my-djbdns-datafile:
           Zexample.com:a.ns.example.com:hostmaster.example.com::::::86400
           &example.com:192.0.2.1:a.ns.example.com.:86400
           &example.com:192.0.2.2:b.ns.example.com.:86400
           =foo.example.com:192.0.2.100:86400


DESCRIPTION
       This zone data backend implements the tinydns format described in
       <http://cr.yp.to/djbdns/tinydns-data.html>.

       As of this writing, djbdns file format support is considered EXPERIMENTAL.  Feel free to submit issues
       and/or pull requests to make the implementation and documentation more correct and complete!  There are
       probably many legal djbdns zone datasets that do not load correctly (or at all) yet.  However, there are
       users loading data from this in production.

       The djbdns zone data backend loads all files found within the djbdns subdirectory of the daemon config
       directory, default /etc/gdnsd/djbdns/.  Each file can contain multiple zones (identified by "Z" records).

       At this time, unlike the RFC1035 zone data backend, the djbdns backend does not support automatic
       reloading of updates based on filesystem notification.  It only explicitly reloads any changed data on
       "SIGUSR1" / "gdnsd reload-zones".


SUPPORTED RECORD TYPES
       The following record types are implemented in the parser:

       Z - SOA
           The "Z" type denotes the existence of a zone and defines its SOA-record.  All records within a file
           must be contained within a zone defined by a "Z" entry.

       & - NS (+ A)
           Implemented.

       . - NS + SOA (+ A)
           The "." type is meant to create an SOA along with the zone's NS records.  At this time, gdnsd doesn't
           support this record for defining the SOA or a zone's existence, and treats it just like "&" above.

       @ - MX (+ A)
           Implemented.

       + - A
           If the 5th field is "~~", this can be used to create "DYNA" records as well, with the
           "plugin!resource" part in the 2nd field.

       = - A + PTR
           The autogeneration of PTR records for "=" is not implemented yet, so this is treated identically to
           "+" above.

       C - CNAME
           If the 5th field is "~~", this can be used to create "DYNC" records as well, with the
           "plugin!resource" part in the 2nd field.

       \ - TXT
           Implemented.

       S - SRV
           Implemented.

       N - NAPTR
           Implemented.

       3 - AAAA
           Not yet implemented.

       6 - AAAA + PTR
           Not yet implemented.

       ^ - PTR
           Not yet implemented.

       : - Raw
           Not yet implemented.


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

       The gdnsd manual.


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