davidb/jdnssec-tools
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 1 Wiki Activity
12310b6b2d
jdnssec-tools/README.md

57 lines
2.5 KiB
Markdown
Raw Normal View History

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
Fix issue 14 (#15) handle duplicate key tags, gen duplicate key tags, other minor cleanup
2024-03-25 04:38:47 +00:00
Author: David Blacka (<davidb@verisign.com>)
Update version, convert readme to markdown.
2016-12-05 23:36:36 +00:00
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
Cli improvements (#17) * add config file processing, refactor CLIBase some * fix algorithm aliases with key generation * Refactor to remove CLIState et al, move CLI common statics to new Utils * only use usage() for help, otherwise fail() * add a universal command line client, build a one-jar to use it. * bump the version * update ChangeLog, README, README.TODO, minor fixes * undo overzealous find/replace. sigh. * fix use_large_exponent logic in KeyGen * more fixes, minor improvements
2024-04-08 01:12:56 +00:00
See the "[licenses](https://github.com/dblacka/jdnssec-tools/tree/master/licenses)" directory for the licensing information of this package and the other packages that are distributed with it.
Update version, convert readme to markdown.
2016-12-05 23:36:36 +00:00
Cli improvements (#17) * add config file processing, refactor CLIBase some * fix algorithm aliases with key generation * Refactor to remove CLIState et al, move CLI common statics to new Utils * only use usage() for help, otherwise fail() * add a universal command line client, build a one-jar to use it. * bump the version * update ChangeLog, README, README.TODO, minor fixes * undo overzealous find/replace. sigh. * fix use_large_exponent logic in KeyGen * more fixes, minor improvements
2024-04-08 01:12:56 +00:00
## Getting Started
### Using the binary distribution
The binary distributions can be downloaded from the [releases](https://github.com/dblacka/jdnssec-tools/releases) page. To use it;
Update version, convert readme to markdown.
2016-12-05 23:36:36 +00:00
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
Cli improvements (#17) * add config file processing, refactor CLIBase some * fix algorithm aliases with key generation * Refactor to remove CLIState et al, move CLI common statics to new Utils * only use usage() for help, otherwise fail() * add a universal command line client, build a one-jar to use it. * bump the version * update ChangeLog, README, README.TODO, minor fixes * undo overzealous find/replace. sigh. * fix use_large_exponent logic in KeyGen * more fixes, minor improvements
2024-04-08 01:12:56 +00:00
### Building from source
There is a source distribution also downloadable from the [releases](https://github.com/dblacka/jdnssec-tools/releases) page, but this should work with a clone of this repo.
Update version, convert readme to markdown.
2016-12-05 23:36:36 +00:00
Cli improvements (#17) * add config file processing, refactor CLIBase some * fix algorithm aliases with key generation * Refactor to remove CLIState et al, move CLI common statics to new Utils * only use usage() for help, otherwise fail() * add a universal command line client, build a one-jar to use it. * bump the version * update ChangeLog, README, README.TODO, minor fixes * undo overzealous find/replace. sigh. * fix use_large_exponent logic in KeyGen * more fixes, minor improvements
2024-04-08 01:12:56 +00:00
1. (If downloaded) Unpack the source distribution, preferably into the same directory that the binary distribution was unpacked.
Update version, convert readme to markdown.
2016-12-05 23:36:36 +00:00
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
Cli improvements (#17) * add config file processing, refactor CLIBase some * fix algorithm aliases with key generation * Refactor to remove CLIState et al, move CLI common statics to new Utils * only use usage() for help, otherwise fail() * add a universal command line client, build a one-jar to use it. * bump the version * update ChangeLog, README, README.TODO, minor fixes * undo overzealous find/replace. sigh. * fix use_large_exponent logic in KeyGen * more fixes, minor improvements
2024-04-08 01:12:56 +00:00
4. You can build the distribution tarballs with 'ant dist', although the main `ant` build command will have built the primary jar file.
Update version, convert readme to markdown.
2016-12-05 23:36:36 +00:00
Cli improvements (#17) * add config file processing, refactor CLIBase some * fix algorithm aliases with key generation * Refactor to remove CLIState et al, move CLI common statics to new Utils * only use usage() for help, otherwise fail() * add a universal command line client, build a one-jar to use it. * bump the version * update ChangeLog, README, README.TODO, minor fixes * undo overzealous find/replace. sigh. * fix use_large_exponent logic in KeyGen * more fixes, minor improvements
2024-04-08 01:12:56 +00:00
The source for this project is available in git on github: <https://github.com/dblacka/jdnssec-tools>
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
Cli improvements (#17) * add config file processing, refactor CLIBase some * fix algorithm aliases with key generation * Refactor to remove CLIState et al, move CLI common statics to new Utils * only use usage() for help, otherwise fail() * add a universal command line client, build a one-jar to use it. * bump the version * update ChangeLog, README, README.TODO, minor fixes * undo overzealous find/replace. sigh. * fix use_large_exponent logic in KeyGen * more fixes, minor improvements
2024-04-08 01:12:56 +00:00
### Using the one-jar distribution
Update dnsjava to 2.1.9; normalize shell wrappers
2019-07-23 13:06:09 +00:00
Cli improvements (#17) * add config file processing, refactor CLIBase some * fix algorithm aliases with key generation * Refactor to remove CLIState et al, move CLI common statics to new Utils * only use usage() for help, otherwise fail() * add a universal command line client, build a one-jar to use it. * bump the version * update ChangeLog, README, README.TODO, minor fixes * undo overzealous find/replace. sigh. * fix use_large_exponent logic in KeyGen * more fixes, minor improvements
2024-04-08 01:12:56 +00:00
As of version 0.20, there is a one-jar (aka an executable jar) as part of the distribution. It can also be downloaded from the [releases](https://github.com/dblacka/jdnssec-tools/releases) page.
Update version, convert readme to markdown.
2016-12-05 23:36:36 +00:00
Cli improvements (#17) * add config file processing, refactor CLIBase some * fix algorithm aliases with key generation * Refactor to remove CLIState et al, move CLI common statics to new Utils * only use usage() for help, otherwise fail() * add a universal command line client, build a one-jar to use it. * bump the version * update ChangeLog, README, README.TODO, minor fixes * undo overzealous find/replace. sigh. * fix use_large_exponent logic in KeyGen * more fixes, minor improvements
2024-04-08 01:12:56 +00:00
1. Fetch the one-jar distribution.
2. Invoke with `java -jar jdnssec-tools-x.x.x.jar`
java -jar jdnssec-tools-x.x.x.jar signzone -h
Update version, convert readme to markdown.
2016-12-05 23:36:36 +00:00
---
Fix issue 14 (#15) handle duplicate key tags, gen duplicate key tags, other minor cleanup
2024-03-25 04:38:47 +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).
Reference in New Issue Copy Permalink