diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml index 75718c389c..33c841c768 100644 --- a/doc/guide/bind10-guide.xml +++ b/doc/guide/bind10-guide.xml @@ -2609,21 +2609,26 @@ can use various data source backends. > config set data_sources/classes/IN[1]/params { "example.org": "/path/to/example.org", "example.com": "/path/to/example.com" } > config commit + Unfortunately, due to current technical limitations, the + params must be set as one JSON blob. To reload a zone, use the + same Auth loadzone command as above. + + + Initially, a map value has to be set, but this value may be an - empty map. After that, key/value pairs can be added with 'config - add' and keys can be removed with 'config remove'. The initial - value may be an empty map, but it has to be set before zones are - added or removed. + empty map. After that, key/value pairs can be added with + config add and keys can be removed with + config remove. The initial value may be an + empty map, but it has to be set before zones are added or + removed. > config set data_sources/classes/IN[1]/params {} > config add data_sources/classes/IN[1]/params another.example.org /path/to/another.example.org > config add data_sources/classes/IN[1]/params another.example.com /path/to/another.example.com > config remove data_sources/classes/IN[1]/params another.example.org - +> config commit - bindctl. To reload a zone, you the same command - as above. @@ -2642,6 +2647,50 @@ can use various data source backends. +
+ Adding a static data source + + + BIND 10 includes a zone file named + static.zone in the CH (Chaos) class for + providing information about the server via the AUTHORS.BIND + and VERSION.BIND TXT records. By default, this BIND zone is + configured and its records are served. + + + + If you have removed this zone from the configuration (e.g., by + using the commands in the previous section to disable the + "built-in data source"), here is how you can add it back to + serve the zones in the static.zone file. + + + First, add the CH class if it doesn't exist: + + > config add data_sources/classes CH +> config commit + + Then, add a data source of type MasterFiles + in the CH class to serve the zones in + static.zone: + + > config add data_sources/classes/CH +> config set data_sources/classes/CH[0]/type MasterFiles +> config set data_sources/classes/CH[0]/cache-enable true +> config set data_sources/classes/CH[0]/params {"BIND": "/usr/local/bind10/share/bind10/static.zone"} +> config commit + + Then, lookup the static data from + static.zone to test it (assuming your + authoritative server is running on localhost): + + > dig @localhost -c CH -t TXT version.bind +> dig @localhost -c CH -t TXT authors.bind + + + +
+
diff --git a/src/lib/datasrc/static.zone.pre b/src/lib/datasrc/static.zone.pre index 13c0c9dbbb..8046410393 100644 --- a/src/lib/datasrc/static.zone.pre +++ b/src/lib/datasrc/static.zone.pre @@ -1,10 +1,10 @@ -;; This is the content of the BIND./CH zone. It contains the version and -;; authors (called VERSION.BIND. and AUTHORS.BIND.). You can add more or -;; modify the zone. Then you can reload the zone by issuing the command +;; This file contains records for the BIND./CH zone. It contains version +;; (VERSION.BIND.) and authors (AUTHORS.BIND.) information. You can add +;; more records or modify this zone file like any other zone file. If +;; you modify this file, you can reload the zone by issuing the +;; following command in the bindctl program: ;; -;; loadzone CH BIND -;; -;; in the bindctl. +;; Auth loadzone CH BIND ;; This is here mostly for technical reasons. BIND. 0 CH SOA bind. authors.bind. 0 28800 7200 604800 86400