man.nsec3hash.html 5.1 KB
Newer Older
Tinderbox User's avatar
Tinderbox User committed
1 2
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--
Tinderbox User's avatar
Tinderbox User committed
3
 - Copyright (C) 2000-2019 Internet Systems Consortium, Inc. ("ISC")
Tinderbox User's avatar
Tinderbox User committed
4 5 6 7 8 9 10 11 12
 - 
 - This Source Code Form is subject to the terms of the Mozilla Public
 - License, v. 2.0. If a copy of the MPL was not distributed with this
 - file, You can obtain one at http://mozilla.org/MPL/2.0/.
-->
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>nsec3hash</title>
Tinderbox User's avatar
Tinderbox User committed
13
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
Tinderbox User's avatar
Tinderbox User committed
14
<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
15
<link rel="up" href="Bv9ARM.ch12.html" title="Manual pages">
16 17
<link rel="prev" href="man.named.html" title="named">
<link rel="next" href="man.nslookup.html" title="nslookup">
Tinderbox User's avatar
Tinderbox User committed
18 19 20 21 22 23 24
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center"><span class="application">nsec3hash</span></th></tr>
<tr>
<td width="20%" align="left">
25
<a accesskey="p" href="man.named.html">Prev</a></td>
Tinderbox User's avatar
Tinderbox User committed
26
<th width="60%" align="center">Manual pages</th>
27
<td width="20%" align="right"><a accesskey="n" href="man.nslookup.html">Next</a>
Tinderbox User's avatar
Tinderbox User committed
28 29 30 31 32 33 34
</td>
</tr>
</table>
<hr>
</div>
<div class="refentry">
<a name="man.nsec3hash"></a><div class="titlepage"></div>
Tinderbox User's avatar
Tinderbox User committed
35 36 37 38 39 40
  
  

  

  <div class="refnamediv">
Tinderbox User's avatar
Tinderbox User committed
41
<h2>Name</h2>
Tinderbox User's avatar
Tinderbox User committed
42 43 44 45
<p>
    <span class="application">nsec3hash</span>
     &#8212; generate NSEC3 hash
  </p>
Tinderbox User's avatar
Tinderbox User committed
46
</div>
Tinderbox User's avatar
Tinderbox User committed
47 48 49 50

  

  <div class="refsynopsisdiv">
Tinderbox User's avatar
Tinderbox User committed
51
<h2>Synopsis</h2>
Tinderbox User's avatar
Tinderbox User committed
52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
    <div class="cmdsynopsis"><p>
      <code class="command">nsec3hash</code> 
       {<em class="replaceable"><code>salt</code></em>}
       {<em class="replaceable"><code>algorithm</code></em>}
       {<em class="replaceable"><code>iterations</code></em>}
       {<em class="replaceable"><code>domain</code></em>}
    </p></div>
    <div class="cmdsynopsis"><p>
      <code class="command">nsec3hash -r</code> 
       {<em class="replaceable"><code>algorithm</code></em>}
       {<em class="replaceable"><code>flags</code></em>}
       {<em class="replaceable"><code>iterations</code></em>}
       {<em class="replaceable"><code>salt</code></em>}
       {<em class="replaceable"><code>domain</code></em>}
    </p></div>
  </div>

  <div class="refsection">
Tinderbox User's avatar
Tinderbox User committed
70
<a name="id-1.13.29.7"></a><h2>DESCRIPTION</h2>
Tinderbox User's avatar
Tinderbox User committed
71 72

    <p>
Tinderbox User's avatar
Tinderbox User committed
73 74 75 76
      <span class="command"><strong>nsec3hash</strong></span> generates an NSEC3 hash based on
      a set of NSEC3 parameters.  This can be used to check the validity
      of NSEC3 records in a signed zone.
    </p>
Tinderbox User's avatar
Tinderbox User committed
77 78

    <p>
Tinderbox User's avatar
Tinderbox User committed
79 80 81 82 83 84 85
      If this command is invoked as <span class="command"><strong>nsec3hash -r</strong></span>,
      it takes arguments in an order matching the first four fields
      of an NSEC3 record, followed by the domain name: algorithm, flags,
      iterations, salt, domain.  This makes it convenient to copy and
      paste a portion of an NSEC3 or NSEC3PARAM record into a command
      line to confirm the correctness of an NSEC3 hash.
    </p>
Tinderbox User's avatar
Tinderbox User committed
86 87 88 89

  </div>

  <div class="refsection">
Tinderbox User's avatar
Tinderbox User committed
90
<a name="id-1.13.29.8"></a><h2>ARGUMENTS</h2>
Tinderbox User's avatar
Tinderbox User committed
91 92

    <div class="variablelist"><dl class="variablelist">
Tinderbox User's avatar
Tinderbox User committed
93
<dt><span class="term">salt</span></dt>
Tinderbox User's avatar
Tinderbox User committed
94 95
<dd>
          <p>
Tinderbox User's avatar
Tinderbox User committed
96
            The salt provided to the hash algorithm.
Tinderbox User's avatar
Tinderbox User committed
97 98
          </p>
        </dd>
Tinderbox User's avatar
Tinderbox User committed
99
<dt><span class="term">algorithm</span></dt>
Tinderbox User's avatar
Tinderbox User committed
100 101
<dd>
          <p>
Tinderbox User's avatar
Tinderbox User committed
102 103 104 105
            A number indicating the hash algorithm.  Currently the
            only supported hash algorithm for NSEC3 is SHA-1, which is
            indicated by the number 1; consequently "1" is the only
            useful value for this argument.
Tinderbox User's avatar
Tinderbox User committed
106 107
          </p>
        </dd>
Tinderbox User's avatar
Tinderbox User committed
108
<dt><span class="term">flags</span></dt>
Tinderbox User's avatar
Tinderbox User committed
109 110
<dd>
          <p>
Tinderbox User's avatar
Tinderbox User committed
111 112
            Provided for compatibility with NSEC3 record presentation
            format, but ignored since the flags do not affect the hash.
Tinderbox User's avatar
Tinderbox User committed
113 114
          </p>
        </dd>
Tinderbox User's avatar
Tinderbox User committed
115
<dt><span class="term">iterations</span></dt>
Tinderbox User's avatar
Tinderbox User committed
116 117
<dd>
          <p>
Tinderbox User's avatar
Tinderbox User committed
118
            The number of additional times the hash should be performed.
Tinderbox User's avatar
Tinderbox User committed
119 120
          </p>
        </dd>
Tinderbox User's avatar
Tinderbox User committed
121
<dt><span class="term">domain</span></dt>
Tinderbox User's avatar
Tinderbox User committed
122 123
<dd>
          <p>
Tinderbox User's avatar
Tinderbox User committed
124
            The domain name to be hashed.
Tinderbox User's avatar
Tinderbox User committed
125 126
          </p>
        </dd>
Tinderbox User's avatar
Tinderbox User committed
127
</dl></div>
Tinderbox User's avatar
Tinderbox User committed
128 129 130
  </div>

  <div class="refsection">
Tinderbox User's avatar
Tinderbox User committed
131
<a name="id-1.13.29.9"></a><h2>SEE ALSO</h2>
Tinderbox User's avatar
Tinderbox User committed
132 133

    <p>
Tinderbox User's avatar
Tinderbox User committed
134 135 136
      <em class="citetitle">BIND 9 Administrator Reference Manual</em>,
      <em class="citetitle">RFC 5155</em>.
    </p>
Tinderbox User's avatar
Tinderbox User committed
137 138
  </div>

Tinderbox User's avatar
Tinderbox User committed
139 140 141 142 143 144
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
145
<a accesskey="p" href="man.named.html">Prev</a></td>
146
<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch12.html">Up</a></td>
147
<td width="40%" align="right"><a accesskey="n" href="man.nslookup.html">Next</a>
Tinderbox User's avatar
Tinderbox User committed
148 149 150 151
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">
152
<span class="application">named</span></td>
Tinderbox User's avatar
Tinderbox User committed
153
<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
154
<td width="40%" align="right" valign="top">nslookup</td>
Tinderbox User's avatar
Tinderbox User committed
155 156 157
</tr>
</table>
</div>
Tinderbox User's avatar
Tinderbox User committed
158
<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.14.1 (Stable Release)</p>
Tinderbox User's avatar
Tinderbox User committed
159 160
</body>
</html>