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

       edns
	   In 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.

       both
	   In 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.

       best
	   In 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	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 3.8.0			  2025-04-13	       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+14.3.quarterly>

home | help