]> git.ipfire.org Git - thirdparty/bind9.git/commitdiff
update ARM documentation
authorEvan Hunt <each@isc.org>
Sun, 23 Jun 2019 03:57:08 +0000 (20:57 -0700)
committerEvan Hunt <each@isc.org>
Tue, 2 Jul 2019 19:29:44 +0000 (12:29 -0700)
(cherry picked from commit c9945d61482dff4e6657460ba74b5ac459342530)
(cherry picked from commit d6bd7bb9afab0939ee4029d861c8ea3914761615)

doc/arm/Bv9ARM-book.xml

index e7fd08471037ed3f2a1a48692f46ec1510a6743f..5b04144a3a6c2b853d06663316f7a9cd32f54999 100644 (file)
@@ -4706,13 +4706,17 @@ badresp:1,adberr:0,findfail:0,valfail:0]
            <term><command>geoip-directory</command></term>
            <listitem>
              <para>
-               Specifies the directory containing GeoIP
-               <filename>.dat</filename> database files for GeoIP
-               initialization.  By default, this option is unset
-               and the GeoIP support will use libGeoIP's
-               built-in directory.
-               (For details, see <xref linkend="acl"/> about the
-               <command>geoip</command> ACL.)
+               When <command>named</command> is compiled using the
+               MaxMind GeoIP2 geolocation API, or the legacy GeoIP API,
+               this specifies the directory containing GeoIP
+               database files.  By default, the option is set based on
+               the prefix used to build the <command>libmaxminddb</command>
+               module: for example, if the library is installed in
+               <filename>/usr/local/lib</filename>, then the default
+               <command>geoip-directory</command> will be
+               <filename>/usr/local/share/GeoIP</filename>.
+               See <xref linkend="acl"/> for details about
+               <command>geoip</command> ACLs.
              </para>
            </listitem>
          </varlistentry>
@@ -16844,38 +16848,39 @@ zone "example.com" {
          to search for a match.  Available fields are "country",
          "region", "city", "continent", "postal" (postal code),
          "metro" (metro code), "area" (area code), "tz" (timezone),
-         "isp", "org", "asnum", "domain" and "netspeed".
+         "isp", "asnum", and "domain".
        </para>
        <para>
          <replaceable>value</replaceable> is the value to search
          for within the database.  A string may be quoted if it
-         contains spaces or other special characters.  If this is
-         an "asnum" search, then the leading "ASNNNN" string can be
-         used, otherwise the full description must be used (e.g.
-         "ASNNNN Example Company Name").  If this is a "country"
-         search and the string is two characters long, then it must
-         be a standard ISO-3166-1 two-letter country code, and if it
-         is three characters long then it must be an ISO-3166-1
-         three-letter country code; otherwise it is the full name
-         of the country.  Similarly, if this is a "region" search
-         and the string is two characters long, then it must be a
-         standard two-letter state or province abbreviation;
-         otherwise it is the full name of the state or province.
+         contains spaces or other special characters.  An "asnum"
+         search for autonomous system number can be specified using
+         the string "ASNNNN" or the integer NNNN.
+         When "country" search is specified with a string is two
+         characters long, then it must be a standard ISO-3166-1
+         two-letter country code; otherwise it is interpreted as
+         the full name of the country.  Similarly, if this is a
+         "region" search and the string is two characters long,
+         then it treated as a standard two-letter state or province
+         abbreviation; otherwise it treated as the full name of the
+         state or province.
        </para>
        <para>
          The <replaceable>database</replaceable> field indicates which
          GeoIP database to search for a match.  In most cases this is
          unnecessary, because most search fields can only be found in
-         a single database.  However, searches for country can be
-         answered from the "city", "region", or "country" databases,
-         and searches for region (i.e., state or province) can be
-         answered from the "city" or "region" databases.  For these
-         search types, specifying a <replaceable>database</replaceable>
+         a single database.  However, searches for "continent" or "country"
+         can be answered from either the "city" or "country" databases,
+         so for these search types, specifying a
+         <replaceable>database</replaceable>
          will force the query to be answered from that database and no
          other.  If <replaceable>database</replaceable> is not
          specified, then these queries will be answered from the "city",
-         database if it is installed, or the "region" database if it is
-         installed, or the "country" database, in that order.
+         database if it is installed, or the "country" database if it
+         is installed, in that order. Valid database names are
+         "country", "city", "asnum", "isp", and "domain". (If using
+         the legacy GeoIP API, "netspeed" and "org" databases are also
+         available.)
        </para>
        <para>
          By default, if a DNS query includes an EDNS Client Subnet (ECS)
@@ -16889,9 +16894,9 @@ zone "example.com" {
          Some example GeoIP ACLs:
        </para>
        <programlisting>geoip country US;
-geoip country JAP;
+geoip country JP;
 geoip db country country Canada;
-geoip db region region WA;
+geoip region WA;
 geoip city "San Francisco";
 geoip region Oklahoma;
 geoip postal 95062;