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

  
 
  

home | help
COREDNS-TRANSFER(7)		 CoreDNS Plugins	     COREDNS-TRANSFER(7)

NAME
     transfer - perform (outgoing) zone transfers for other plugins.

DESCRIPTION
     This plugin answers zone transfers for authoritative plugins that implement
     transfer.Transferer.

     transfer  answers	full  zone transfer (AXFR) requests and incremental zone
     transfer (IXFR) requests with AXFR fallback if the zone has changed.

     When a plugin wants to notify it's secondaries it will call back  into  the
     transfer plugin.

     The  following  plugins  implement  zone transfers using this plugin: file,
     auto, secondary, and kubernetes. See transfer.go for implementation details
     if you are a plugin author that wants to use this plugin.

SYNTAX
	    transfer [ZONE...] {
	      to ADDRESS...
	    }

     *	 ZONE The zones transfer will answer zone transfer requests for. If left
	 blank, the zones are inherited from the enclosing server block. To  an-
	 swer  zone  transfers for a given zone, there must be another plugin in
	 the same server block that serves the same zone, and implements  trans-
	 fer.Transferer.

     *	 to  ADDRESS...  The  hosts  transfer  will transfer to. Use * to permit
	 transfers to all addresses. Zone change notifications are sent  to  all
	 ADDRESS  that are an IP address or an IP address and port e.g. 1.2.3.4,
	 12:34::56, 1.2.3.4:5300, [12:34::56]:5300.  to may be specified  multi-
	 ple times.

     You can use the acl plugin to further restrict hosts permitted to receive a
     zone transfer.  See example below.

EXAMPLES
     Use  in  conjunction  with  the  acl  plugin  to  restrict access to subnet
     10.1.0.0/16.

	    ...
	      acl {
		allow type AXFR net 10.1.0.0/16
		allow type IXFR net 10.1.0.0/16
		block type AXFR net *
		block type IXFR net *
	      }
	      transfer {
		to *
	      }
	    ...

     Each plugin that can use transfer includes an example of use in  their  re-
     spective documentation.

CoreDNS 			   March 2026		     COREDNS-TRANSFER(7)

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

home | help