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