nsec3hash.docbook revision 30eec077db2bdcb6f2a0dc388a3cdde2ede75ec1
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster<!--
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - Copyright (C) 2009, 2014, 2015 Internet Systems Consortium, Inc. ("ISC")
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster -
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - Permission to use, copy, modify, and/or distribute this software for any
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - purpose with or without fee is hereby granted, provided that the above
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - copyright notice and this permission notice appear in all copies.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster -
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster - PERFORMANCE OF THIS SOFTWARE.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster-->
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster<!-- Converted by db4-upgrade version 1.0 -->
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.nsec3hash">
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <info>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <date>2009-03-02</date>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </info>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refentryinfo>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <corpname>ISC</corpname>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </refentryinfo>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refmeta>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refentrytitle><application>nsec3hash</application></refentrytitle>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <manvolnum>8</manvolnum>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refmiscinfo>BIND9</refmiscinfo>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </refmeta>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refnamediv>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refname><application>nsec3hash</application></refname>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refpurpose>generate NSEC3 hash</refpurpose>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </refnamediv>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <docinfo>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <copyright>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <year>2009</year>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <year>2014</year>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <year>2015</year>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </copyright>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </docinfo>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refsynopsisdiv>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <cmdsynopsis sepchar=" ">
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <command>nsec3hash</command>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <arg choice="req" rep="norepeat"><replaceable class="parameter">salt</replaceable></arg>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <arg choice="req" rep="norepeat"><replaceable class="parameter">algorithm</replaceable></arg>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <arg choice="req" rep="norepeat"><replaceable class="parameter">iterations</replaceable></arg>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <arg choice="req" rep="norepeat"><replaceable class="parameter">domain</replaceable></arg>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </cmdsynopsis>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </refsynopsisdiv>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refsection><info><title>DESCRIPTION</title></info>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <command>nsec3hash</command> generates an NSEC3 hash based on
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster a set of NSEC3 parameters. This can be used to check the validity
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster of NSEC3 records in a signed zone.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </refsection>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <refsection><info><title>ARGUMENTS</title></info>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <variablelist>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <varlistentry>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <term>salt</term>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <listitem>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster The salt provided to the hash algorithm.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </listitem>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </varlistentry>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <varlistentry>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <term>algorithm</term>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <listitem>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster A number indicating the hash algorithm. Currently the
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster only supported hash algorithm for NSEC3 is SHA-1, which is
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster indicated by the number 1; consequently "1" is the only
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster useful value for this argument.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </listitem>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </varlistentry>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <varlistentry>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <term>iterations</term>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <listitem>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster The number of additional times the hash should be performed.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </listitem>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </varlistentry>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <varlistentry>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <term>domain</term>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <listitem>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster <para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster The domain name to be hashed.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </para>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </listitem>
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster </varlistentry>
</variablelist>
</refsection>
<refsection><info><title>SEE ALSO</title></info>
<para>
<citetitle>BIND 9 Administrator Reference Manual</citetitle>,
<citetitle>RFC 5155</citetitle>.
</para>
</refsection>
</refentry>