jdnssec-tools/README.md

# jdnssec-tools

* <https://github.com/dblacka/jdnssec-tools/wiki>

Author: David Blacka (davidb@verisign.com)

This is a collection of DNSSEC tools written in Java.  They are intended to be an addition or replacement for the DNSSEC tools that are part of BIND 9.

These tools depend upon DNSjava (<https://github.com/dnsjava/dnsjava>), the Jakarta Commons CLI and Logging libraries (<https://commons.apache.org/proper/commons-cli>), slf4j (<https://www.slf4j.org>), and Sun's Java Cryptography extensions.  A copy of each of these libraries is included in the distribution.

See the "licenses" directory for the licensing information of this package and the other packages that are distributed with it.

Getting started:

1. Unpack the binary distribution:

        tar zxvf java-dnssec-tools-x.x.x.tar.gz

2. Run the various tools from their unpacked location:

        cd java-dnssec-tools-x.x.x
        ./bin/jdnssec-signzone -h

Building from source:

1. Unpack the source distribution, preferably into the same directory that the binary distribution was unpacked.

        tar zxvf java-dnssec-tools-x.x.x-src.tar.gz

2. Edit the build.properties file to suit your environment.
3. Run Ant (see <http://ant.apache.org> for information about the Ant build tool).

        ant

4. You can build the distribution tarballs with 'ant dist'.  You can run the tools directly from the build area (without building the jdnssec-tools.jar file) by using the ./bin/\_jdnssec_* wrappers.

5. Alternatively, build the project using gradle:

        gradlew clean
        gradlew assemble -i

The resulting jar file gets generated in build/libs.

The source for this project is available in git on github: <https://github.com/dblacka/jdnssec-tools>

---

Questions or comments may be directed to the author (mailto:davidb@verisign.com), or by creating issues in the [github issue tracker](https://github.com/dblacka/jdnssec-tools/issues).
Update version, convert readme to markdown. 2016-12-05 23:36:36 +00:00			`# jdnssec-tools`

Port to DNSJava 3.5.1, Java 8, linter fixes (#13) * Initial port to dnsjava 3.5.1 * java.util.Date -> java.time.Instant * for (Iterator ..) to for ( Object : List ) * DSRecord.<digest type> -> DNSSEC.Digest.<type> * source to java 8 * formatting overhaul; copyright; author * add slf4j jars for dnsjava 3.5.1 * NSEC/NSEC3 ttls are now min(soa.min, soa.ttl) * Upgrade to commons-cli-1.5; some linter fixes * Add CDS support of jdnssec-dstool * linter suggestions * add a TODO list * Add a TODO list 2022-09-21 18:24:42 +00:00			`* <https://github.com/dblacka/jdnssec-tools/wiki>`
Update version, convert readme to markdown. 2016-12-05 23:36:36 +00:00
			`Author: David Blacka (davidb@verisign.com)`

			`This is a collection of DNSSEC tools written in Java. They are intended to be an addition or replacement for the DNSSEC tools that are part of BIND 9.`

Port to DNSJava 3.5.1, Java 8, linter fixes (#13) * Initial port to dnsjava 3.5.1 * java.util.Date -> java.time.Instant * for (Iterator ..) to for ( Object : List ) * DSRecord.<digest type> -> DNSSEC.Digest.<type> * source to java 8 * formatting overhaul; copyright; author * add slf4j jars for dnsjava 3.5.1 * NSEC/NSEC3 ttls are now min(soa.min, soa.ttl) * Upgrade to commons-cli-1.5; some linter fixes * Add CDS support of jdnssec-dstool * linter suggestions * add a TODO list * Add a TODO list 2022-09-21 18:24:42 +00:00			`These tools depend upon DNSjava (<https://github.com/dnsjava/dnsjava>), the Jakarta Commons CLI and Logging libraries (<https://commons.apache.org/proper/commons-cli>), slf4j (<https://www.slf4j.org>), and Sun's Java Cryptography extensions. A copy of each of these libraries is included in the distribution.`
Update version, convert readme to markdown. 2016-12-05 23:36:36 +00:00
			`See the "licenses" directory for the licensing information of this package and the other packages that are distributed with it.`

			`Getting started:`

			`1. Unpack the binary distribution:`

			`tar zxvf java-dnssec-tools-x.x.x.tar.gz`

			`2. Run the various tools from their unpacked location:`

			`cd java-dnssec-tools-x.x.x`
			`./bin/jdnssec-signzone -h`

			`Building from source:`

			`1. Unpack the source distribution, preferably into the same directory that the binary distribution was unpacked.`

			`tar zxvf java-dnssec-tools-x.x.x-src.tar.gz`

			`2. Edit the build.properties file to suit your environment.`
Port to DNSJava 3.5.1, Java 8, linter fixes (#13) * Initial port to dnsjava 3.5.1 * java.util.Date -> java.time.Instant * for (Iterator ..) to for ( Object : List ) * DSRecord.<digest type> -> DNSSEC.Digest.<type> * source to java 8 * formatting overhaul; copyright; author * add slf4j jars for dnsjava 3.5.1 * NSEC/NSEC3 ttls are now min(soa.min, soa.ttl) * Upgrade to commons-cli-1.5; some linter fixes * Add CDS support of jdnssec-dstool * linter suggestions * add a TODO list * Add a TODO list 2022-09-21 18:24:42 +00:00			`3. Run Ant (see <http://ant.apache.org> for information about the Ant build tool).`
Update version, convert readme to markdown. 2016-12-05 23:36:36 +00:00
			`ant`

Update dnsjava to 2.1.9; normalize shell wrappers 2019-07-23 13:06:09 +00:00			`4. You can build the distribution tarballs with 'ant dist'. You can run the tools directly from the build area (without building the jdnssec-tools.jar file) by using the ./bin/\_jdnssec_* wrappers.`
Update version, convert readme to markdown. 2016-12-05 23:36:36 +00:00
Update dnsjava to 2.1.9; normalize shell wrappers 2019-07-23 13:06:09 +00:00			`5. Alternatively, build the project using gradle:`
Added support for gradle and restructured the source code directory from src to src/main/java directory 2018-07-15 14:59:40 +00:00
Update dnsjava to 2.1.9; normalize shell wrappers 2019-07-23 13:06:09 +00:00			`gradlew clean`
			`gradlew assemble -i`

			`The resulting jar file gets generated in build/libs.`
Update version, convert readme to markdown. 2016-12-05 23:36:36 +00:00
Port to DNSJava 3.5.1, Java 8, linter fixes (#13) * Initial port to dnsjava 3.5.1 * java.util.Date -> java.time.Instant * for (Iterator ..) to for ( Object : List ) * DSRecord.<digest type> -> DNSSEC.Digest.<type> * source to java 8 * formatting overhaul; copyright; author * add slf4j jars for dnsjava 3.5.1 * NSEC/NSEC3 ttls are now min(soa.min, soa.ttl) * Upgrade to commons-cli-1.5; some linter fixes * Add CDS support of jdnssec-dstool * linter suggestions * add a TODO list * Add a TODO list 2022-09-21 18:24:42 +00:00			`The source for this project is available in git on github: <https://github.com/dblacka/jdnssec-tools>`
Update version, convert readme to markdown. 2016-12-05 23:36:36 +00:00
			`---`

Update dnsjava to 2.1.9; normalize shell wrappers 2019-07-23 13:06:09 +00:00			`Questions or comments may be directed to the author (mailto:davidb@verisign.com), or by creating issues in the [github issue tracker](https://github.com/dblacka/jdnssec-tools/issues).`