Commit 08379e2d authored by Jeremy C. Reed's avatar Jeremy C. Reed
Browse files

Add a TODO file for loading zones.

Add a manual page for b10-loadzone. (Actually in xml docbook format.
Later need to add make targets for this and add the nroff man result.)


git-svn-id: svn://bind10.isc.org/svn/bind10/trunk@1219 e5f2f494-b856-4b98-b285-d166d9295462
parent af72796a
<!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.
-->
<!-- $Id$ -->
<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 is used to define the
relative domain name.
$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 following records that don't have their TTL set.
</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>/tmp/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:
-->
Support optional origin in $INCLUDE:
$INCLUDE filename origin
Support optional comment in $INCLUDE:
$INCLUDE filename origin comment
Support optional comment in $TTL (RFC 2308):
$TTL number comment
If ttl is not set on the record line but $TTL is set at top,
it is not loaded. But running master.py manually does show the
TTL to be same as the $TTL. When including the ttl on every line,
it is loaded and can be served.
Open questions to document in manual page:
What happens in the database? replaces existing? What if a.foo
existed but new zone file didn't have a.foo, would previous a.foo
in database be removed?
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment