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

FreeBSD Manual Pages

  
 
  

home | help
GDNSD-PLUGIN-REFLECT(8) 	      gdnsd		 GDNSD-PLUGIN-REFLECT(8)

NAME
     gdnsd-plugin-reflect - gdnsd cache reflector plugin

SYNOPSIS
     Zonefile RRs using reflect resolution

       reflect	    10 DYNA reflect
       reflect-dns  10 DYNA reflect!dns
       reflect-edns 10 DYNA reflect!edns
       reflect-both 10 DYNA reflect!both
       reflect-best 10 DYNA reflect!best

DESCRIPTION
     gdnsd-plugin-reflect is a resolution plugin that acts as a live debugging
     tool.  It reflects a view of the client's network address back in the re-
     sponse in the form of "A" or "AAAA" RRs.  It can be used with both "DYNA"
     and "DYNC" RRs, and will return address data in both cases.

     The plugin can operate in one of four modes named "dns", "edns", "both",
     and "best", which can be selected by using the mode name as a resource name
     in the zonefile, as shown in the example above.  The default mode is
     "best".  The modes operate as follows:

     dns In the "dns" mode, the address in the response is always the source IP
	 address of the request as seen by gdnsd.  Note that this is generally
	 the public address of a central cache/resolver server rather than the
	 end-user client itself.

     ednsIn the "edns" mode, the address in the response is the address sent by
	 the client in the "edns-client-subnet" option.  If the client did not
	 send such an option, the IPv4 address 0.0.0.0 is returned.

     bothIn the "both" mode, both of the above results are returned in the same
	 response, but there is no artificial 0.0.0.0 added if no
	 "edns-client-subnet" option was available.

     bestIn the "best" (default) mode, if the "edns-client-subnet" option was
	 specified its data is returned as in the "edns" case, otherwise the
	 source IP address is returned as in the "dns" case.

SEE ALSO
     gdnsd.config(5), gdnsd.zonefile(5), gdnsd(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 3.8.0			   2026-08-01		 GDNSD-PLUGIN-REFLECT(8)

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

home | help