.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "GDNSD_GEOIP_TEST 1"
.TH GDNSD_GEOIP_TEST 1 2024-03-15 "gdnsd 3.8.2" gdnsd
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
gdnsd_geoip_test \- Commandline test program for gdnsd\-plugin\-geoip maps
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 4
\&  gdnsd_geoip_test [\-c /etc/gdnsd] [map_name addr]
\&    \-c            gdnsd config dir, see main gdnsd(8) manpage for details
\&    map_name      Mapping name from geoip plugin config
\&    addr          Client IP address to map.
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This is a simple commandline test program for \f(CW\*(C`gdnsd\-plugin\-geoip\*(C'\fR map
configurations.  It parses your standard gdnsd config file, extracts the
relevant bits from the geoip plugin section, and processes the \f(CW\*(C`maps\*(C'\fR
section using the same core code as the plugin itself.  It then resolves
the supplied IP address against the supplied map name, providing an
ordered datacenter list (and edns scope netmask) result.
.PP
The input IP addresses on the commandline do not accept CIDR subnet
information.  This is intentional.  Because of the method by which
\&\f(CW\*(C`gdnsd\-plugin\-geoip\*(C'\fR builds, optimizes, and performs lookups on the
internal data, the client subnet mask is irrelevant, and the response
scope mask is always as specific or general as necessary.  To simulate
different edns input masks on the same address data, simply zero out
more of the right hand bits of the address.
.PP
If no \f(CW\*(C`[map_name addr]\*(C'\fR is given on the commandline, the program
enters a REPL (Read-Eval-Print Loop) mode with a prompt, allowing
you to interactively enter several \f(CW\*(C`[map_name addr]\*(C'\fR pairs without
reloading the configured database(s).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBgdnsd\-plugin\-geoip\fR\|(8), \fBgdnsd.config\fR\|(5), \fBgdnsd\fR\|(8)
.PP
The gdnsd manual.
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (c) 2012 Brandon L Black <blblack@gmail.com>
.PP
This file is part of gdnsd.
.PP
gdnsd-plugin-geoip 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.
.PP
gdnsd-plugin-geoip 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.
.PP
You should have received a copy of the GNU General Public License
along with gdnsd-plugin-geoip.  If not, see <http://www.gnu.org/licenses/>.