<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
               "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
	       [<!ENTITY mdash "&#8212;">]>
<!--
 - Copyright (C) 2010  Internet Systems Consortium, Inc. ("ISC")
 -
 - Permission to use, copy, modify, and/or distribute this software for any
 - purpose with or without fee is hereby granted, provided that the above
 - copyright notice and this permission notice appear in all copies.
 -
 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
 - AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 - PERFORMANCE OF THIS SOFTWARE.
-->

<refentry>

  <refentryinfo>
    <date>March 8, 2010</date>
  </refentryinfo>

  <refmeta>
    <refentrytitle>b10-loadzone</refentrytitle>
    <manvolnum>8</manvolnum>
    <refmiscinfo>BIND10</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>b10-loadzone</refname>
    <refpurpose>Load DNS Zone File</refpurpose>
  </refnamediv>

  <docinfo>
    <copyright>
      <year>2010</year>
      <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
    </copyright>
  </docinfo>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>b10-loadzone</command>
      <arg><option>-d <replaceable class="parameter">database</replaceable></option></arg>
      <arg><option>-o <replaceable class="parameter">origin</replaceable></option></arg>
      <arg chose="req">filename</arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>DESCRIPTION</title>
    <para>The <command>b10-loadzone</command> utility
      loads a RFC 1035 style DNS master zone file and stores it
      in a BIND 10 ready data source format.
      Master files are text files that contain DNS Resource Records
      in text form.
    </para>
    <note><simpara>Currently only the SQLITE3 data source is supported.
    </simpara></note>

    <para>
    Some control entries (aka directives) are supported.
    $ORIGIN is followed by a domain name, and sets the the origin
    that will be used for relative domain names in subsequent records.
    $INCLUDE is followed by a filename to load.
<!-- TODO: and optionally a
    domain name used to set the relative domain name origin. -->
    The previous origin is restored after the file is included.
<!-- the current domain name is also restored -->
    $TTL is followed by a time-to-live value which is used
    by any following records that don't specify a TTL.
    </para>

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

  </refsect1>

  <refsect1>
    <title>ARGUMENTS</title>

    <variablelist>

      <varlistentry>
        <term>-d <replaceable class="parameter">database</replaceable> </term>
        <listitem><para>
          Defines the filename for the database.
	  The default is
	  <filename>/usr/local/var/bind10-devel/zone.sqlite3</filename>.
<!-- TODO: fix filename -->
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term>-o <replaceable class="parameter">origin</replaceable></term>
        <listitem><para>
          Defines the default origin for the zone file records.
        </para></listitem>
      </varlistentry>

    </variablelist>

  </refsect1>

  <refsect1>
    <title>FILES</title>
    <para><filename></filename>
    </para>
  </refsect1>

  <refsect1>
    <title>SEE ALSO</title>
    <para>
      <citerefentry>
        <refentrytitle>b10-auth</refentrytitle><manvolnum>8</manvolnum>
      </citerefentry>,
      <citerefentry>
        <refentrytitle>bind10</refentrytitle><manvolnum>8</manvolnum>
      </citerefentry>.
    </para>
  </refsect1>

  <refsect1>
    <title>AUTHORS</title>
    <para>
      The <command>b10-loadzone</command> tool was initial written
      by Evan Hunt of ISC.
    </para>
  </refsect1>
</refentry><!--
 - Local variables:
 - mode: sgml
 - End:
-->
