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
       subdirectory of the daemon config directory, default
       /usr/local/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 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/>.

gdnsd 2.4.3			  2026-02-28		       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.0.quarterly>

home | help