nsec3hash.docbook revision 234010
1169695Skan<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 2169695Skan "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 3169695Skan [<!ENTITY mdash "—">]> 4169695Skan<!-- 5169695Skan - Copyright (C) 2009 Internet Systems Consortium, Inc. ("ISC") 6169695Skan - 7169695Skan - Permission to use, copy, modify, and/or distribute this software for any 8169695Skan - purpose with or without fee is hereby granted, provided that the above 9169695Skan - copyright notice and this permission notice appear in all copies. 10169695Skan - 11169695Skan - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH 12169695Skan - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 13169695Skan - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, 14169695Skan - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM 15169695Skan - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 16169695Skan - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 17169695Skan - PERFORMANCE OF THIS SOFTWARE. 18169695Skan--> 19169695Skan 20169695Skan<!-- $Id: nsec3hash.docbook,v 1.3 2009/03/02 23:47:43 tbox Exp $ --> 21169695Skan<refentry id="man.nsec3hash"> 22169695Skan <refentryinfo> 23169695Skan <date>Feb 18, 2009</date> 24169695Skan </refentryinfo> 25169695Skan 26169695Skan <refmeta> 27169695Skan <refentrytitle><application>nsec3hash</application></refentrytitle> 28169695Skan <manvolnum>8</manvolnum> 29169695Skan <refmiscinfo>BIND9</refmiscinfo> 30169695Skan </refmeta> 31169695Skan 32169695Skan <refnamediv> 33169695Skan <refname><application>nsec3hash</application></refname> 34169695Skan <refpurpose>generate NSEC3 hash</refpurpose> 35169695Skan </refnamediv> 36169695Skan 37169695Skan <docinfo> 38169695Skan <copyright> 39169695Skan <year>2009</year> 40169695Skan <holder>Internet Systems Consortium, Inc. ("ISC")</holder> 41169695Skan </copyright> 42169695Skan </docinfo> 43169695Skan 44169695Skan <refsynopsisdiv> 45169695Skan <cmdsynopsis> 46169695Skan <command>nsec3hash</command> 47169695Skan <arg choice="req"><replaceable class="parameter">salt</replaceable></arg> 48169695Skan <arg choice="req"><replaceable class="parameter">algorithm</replaceable></arg> 49169695Skan <arg choice="req"><replaceable class="parameter">iterations</replaceable></arg> 50169695Skan <arg choice="req"><replaceable class="parameter">domain</replaceable></arg> 51169695Skan </cmdsynopsis> 52169695Skan </refsynopsisdiv> 53169695Skan 54169695Skan <refsect1> 55169695Skan <title>DESCRIPTION</title> 56 <para> 57 <command>nsec3hash</command> generates an NSEC3 hash based on 58 a set of NSEC3 parameters. This can be used to check the validity 59 of NSEC3 records in a signed zone. 60 </para> 61 </refsect1> 62 63 <refsect1> 64 <title>ARGUMENTS</title> 65 <variablelist> 66 <varlistentry> 67 <term>salt</term> 68 <listitem> 69 <para> 70 The salt provided to the hash algorithm. 71 </para> 72 </listitem> 73 </varlistentry> 74 75 <varlistentry> 76 <term>algorithm</term> 77 <listitem> 78 <para> 79 A number indicating the hash algorithm. Currently the 80 only supported hash algorithm for NSEC3 is SHA-1, which is 81 indicated by the number 1; consequently "1" is the only 82 useful value for this argument. 83 </para> 84 </listitem> 85 </varlistentry> 86 87 <varlistentry> 88 <term>iterations</term> 89 <listitem> 90 <para> 91 The number of additional times the hash should be performed. 92 </para> 93 </listitem> 94 </varlistentry> 95 96 <varlistentry> 97 <term>domain</term> 98 <listitem> 99 <para> 100 The domain name to be hashed. 101 </para> 102 </listitem> 103 </varlistentry> 104 </variablelist> 105 </refsect1> 106 107 <refsect1> 108 <title>SEE ALSO</title> 109 <para> 110 <citetitle>BIND 9 Administrator Reference Manual</citetitle>, 111 <citetitle>RFC 5155</citetitle>. 112 </para> 113 </refsect1> 114 115 <refsect1> 116 <title>AUTHOR</title> 117 <para><corpauthor>Internet Systems Consortium</corpauthor> 118 </para> 119 </refsect1> 120 121</refentry><!-- 122 - Local variables: 123 - mode: sgml 124 - End: 125--> 126