From: JINMEI Tatuya Date: Sat, 15 Dec 2012 23:26:57 +0000 (-0800) Subject: [2380] updated man page. X-Git-Tag: bind10-1.0.0-beta-release~9^2~14^2~12 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=935c918578e428b5d24718e2e113dc706ac952da;p=thirdparty%2Fkea.git [2380] updated man page. --- diff --git a/src/bin/loadzone/b10-loadzone.xml b/src/bin/loadzone/b10-loadzone.xml index 8c41e54f71..5174f440bc 100644 --- a/src/bin/loadzone/b10-loadzone.xml +++ b/src/bin/loadzone/b10-loadzone.xml @@ -2,7 +2,7 @@ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" []> The previous origin is restored after the file is included. $TTL is followed by a time-to-live value which is used by any following records that don't specify a TTL. + + If the specified zone does not exist in the specified data + source, b10-loadzone will first create a + new empty zone in the data source, then fill it with the RRs + given in the specified master zone file. In this case, if + loading fails for some reason, the creation of the new zone + is also canceled. + + Due to an implementation limitation, the current version + does not make the zone creation and subsequent loading an + atomic operation; an empty zone will be visible and used by + other application (e.g., the b10-auth + authoritative server) while loading. If this is an issue, + make sure the initial loading of a new zone is done before + starting other BIND 10 applications. + + + When re-loading an existing zone, the prior version is completely removed. While the new version of the zone is being loaded, the old version remains accessible to queries. After the new version is completely loaded, the old version is swapped out and replaced - with the new one in a single operation. + with the new one in a single operation. If loading fails for + some reason, the loaded RRs will be effectively deleted, and the + old version will still remain accessible for other applications. @@ -90,19 +112,77 @@ - -d database + -d debug_level - Defines the filename for the database. - The default is - /usr/local/var/bind10-devel/zone.sqlite3. - + Enable dumping debug level logging with the specified + level. By default, only log messages at the severity of + informational or higher levels will be produced. - -o origin + -i report_interval - Defines the default origin for the zone file records. + Specifies the interval of status update by the number of RRs + loaded in the interval. + The b10-loadzone tool periodically + reports the progress of loading with the total number of + loaded RRs and elapsed time. This option specifies the + interval of the reports. If set to 0, status reports will + be suppressed. The default is 10,000. + + + + + -t datasrc_type + + Specifies the type of data source to store the zone. + Currently, only the "sqlite3" type is supported (which is + the default of this option), which means the SQLite3 data + source. + + + + + -C zone_class + + Specifies the RR class of the zone. + Currently, only class IN is supported (which is the default + of this option) due to limitation of the underlying data + source implementation. + + + + + -c datasrc_config + + Specifies configuration of the data source in the JSON + format. The configuration contents depend on the type of + the data source, and that's the same as what would be + specified for the BIND 10 servers (see the data source + configuration section of the BIND 10 guide). For example, + for an SQLite3 data source, it would look like + '{"database_file": "path-to-sqlite3-db-file"}'. + + This option currently cannot be omitted. In a future + version it will be possible to retrieve the configuration from + the BIND 10 server configuration (if it exists). + + + + + + zone name + + The name of the zone to create or update. This must be a valid DNS + domain name. + + + + + zone file + + A path to the master zone file to be loaded. @@ -131,8 +211,30 @@ AUTHORS - The b10-loadzone tool was initial written - by Evan Hunt of ISC. + A prior version of the b10-loadzone tool was + written by Evan Hunt of ISC. + The new version that this manual refers to was rewritten from + the scratch by the BIND 10 development team in around December 2012. + + + + + BUGS + + As of the initial implementation, the underlying library that + this tool uses does not fully validate the loaded zone; for + example, loading will succeed even if it doesn't have the SOA or + NS record at its origin name. Such checks will be implemented + in a near future version, but until then, the + b10-loadzone performs the existence of the + SOA and NS records by itself. However, b10-loadzone + only warns about it, and does not cancel the load itself. + If this warning message is produced, it's the user's + responsibility to fix the errors and reload it. When the + library is updated with the post load checks, it will be more + sophisticated and the such zone won't be successfully loaded. + + There are some other issues noted in the DESCRIPTION section.