Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GDNSD.DJBDNS(5) 		      gdnsd			 GDNSD.DJBDNS(5)

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

SYNOPSIS
       /usr/local/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 subdi-
     rectory of the daemon config directory, default /usr/lo-
     cal/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 notifica-
     tion.  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 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 de-
     tails.

     You should have received a copy of the GNU General Public License along
     with gdnsd.  If not, see <http://www.gnu.org/licenses/>.

gdnsd 2.4.3			   2026-08-01			 GDNSD.DJBDNS(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gdnsd.djbdns&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help