Add nsec3-hash command.

Cargo.toml

@@ -9,10 +9,14 @@ name = "ldns"
 path = "src/bin/ldns.rs"
 
 [dependencies]
-clap = { version = "4", features = ["derive"] }
-domain = "0.10.1"
-lexopt = "0.3.0"
+arbitrary = { version = "1", optional = true, features = ["derive"] }
+clap      = { version = "4", features = ["derive"] }
+#domain   = "0.10.3"
+domain    = { git = "https://github.com/NLnetLabs/domain/", branch = "initial-nsec3-generation", features = ["ring", "unstable-validator"] }
+lexopt    = "0.3.0"
 
-# for implementation of nsec3 hash until domain has it stabilized
-octseq = { version = "0.5.1", features = ["std"] }
-ring = { version = "0.17" }
+[dev-dependencies]
+test_bin = "0.4.0"
+
+[features]
+arbitrary = [ "dep:arbitrary", "domain/arbitrary" ]

doc/manual/source/conf.py

@@ -189,8 +189,8 @@
 # (source start file, name, description, authors, manual section).
 man_pages = [
     ('man/dnst', 'dnst', 'DNS Management Tools', author, 1),
-    ('man/dnst-nsec3-hash', 'dnst-nsec3-hash', 'DNS Management Tools', author,
-     1),
+    ('man/dnst-nsec3-hash', 'dnst-nsec3-hash', 'print out the NSEC3 hash for a domain name', author, 1),
+    ('man/ldns-nsec3-hash', 'ldns-nsec3-hash', 'print out the NSEC3 hash for a domain name', author, 1),
 ]
 
 

doc/manual/source/man/dnst-nsec3-hash.rst

@@ -4,27 +4,27 @@ dnst-nsec3-hash
 Synopsis
 --------
 
-:program:`dnst nsec3-hash` [``options``] :samp:`domain-name`
+:program:`dnst nsec3-hash` [``OPTIONS``] :samp:`<DOMAIN NAME>`
 
 Description
 -----------
 
-**dnst nsec3-hash** prints the NSEC3 hash for the given domain name.
+**dnst nsec3-hash** prints the NSEC3 hash of a given domain name.
 
 Options
 -------
 
-.. option:: -a number-or-mnemonic, --algorithm=number-or-mnemonic
+.. option:: -a <NUMBER OR MNEMONIC>, --algorithm <NUMBER OR MNEMONIC>
 
       Use the given algorithm number for the hash calculation. Defaults to
-      ``sha1``.
+      1 (SHA-1).
 
-.. option:: -s salt, --salt=count
+.. option:: -i <NUMBER>, -t <NUMBER>, --iterations <NUMBER>
 
-      Use the given salt for the hash calculation. The salt value should be
-      in hexadecimal format.
+      Use the given number of additional iterations for the hash calculation.
 
-.. option:: -i count, -t count, --iterations=count
+.. option:: -s <HEX STRING>, --salt <HEX STRING>
 
-      Use *count* iterations for the hash calculation.
+      Use the given salt for the hash calculation. The salt value should be
+      in hexadecimal format.
 

doc/manual/source/man/ldns-nsec3-hash.rst

@@ -0,0 +1,29 @@
+ldns-nsec3-hash
+===============
+
+Synopsis
+--------
+
+:program:`ldns-nsec3-hash` :samp:`<{domain-name}>`
+
+Description
+-----------
+
+**ldns-nsec3-hash** is used to print out the NSEC3 hash for the given domain name.
+
+Options
+-------
+
+.. option:: -a number
+
+      Use the given algorithm number for the hash calculation. Defaults to
+      1 (SHA-1).
+
+.. option:: -s salt
+
+      Use the given salt for the hash calculation. The salt value should be
+      in hexadecimal format.
+
+.. option:: -t count
+
+      Use count iterations for the hash calculation.

fuzz/.gitignore

@@ -0,0 +1,4 @@
+target
+corpus
+artifacts
+coverage