Skip to content

Various man page updates and consistency tweaks.#84

Merged
ximon18 merged 332 commits intomainfrom
man-page-updates
Jun 4, 2025
Merged

Various man page updates and consistency tweaks.#84
ximon18 merged 332 commits intomainfrom
man-page-updates

Conversation

@ximon18
Copy link
Member

@ximon18 ximon18 commented May 28, 2025

To be merged to main after PR #8 has been merged, or be retargeted to merge into PR #8.

ximon18 and others added 21 commits May 15, 2025 14:05
- Don't permit signing keys to be passed as arguments when using `-H`.
- Don't attempt to process signing keys when using `-H`.
* Remove -M option.

* Fallout of merging.
- Add a test of '-u' that sets the SOA SERIAL to the Epoch time now if ahead of the SOA SERIAL, or increments the SOA SERIAL otherwise.
- Change the code that determines the serial now to do so with its own mockable source of time from the environment, instead of using Serial::now() which hard-codes use of the real system clock.
- Extend the concept of Env to support seconds since the epoch which can be overridden when using FakeEnv.

---------

Co-authored-by: Philip-NLnetLabs <philip@nlnetlabs.nl>
* Add missing arguments and re-order arguments to match -h output, plus some argument re-ordering to better group related arguments together in -h output.

* Remove orphaned comment.

* Note that we don't attempt to detect a zone file origin if not defined, unlike ldns-signzone which will use the owner of the first SOA RR as the origin. To support this would require a change in the `domain` zonefile parser which we are not convinced would be right, but may revisit this if there appears to be actual users out there depending on and wanting this detection logic.
- Be consistent with trailing periods (not shown in -h but the inconsistencies are visible via --help).
- Document in --help output arguments that have dependencies on other arguments.
- Encode some inter-argument dependencies via Clap rules.
- Also makes LDNS mode error message the same as the real ldns-signzone.
- Require `-o` for `dnst signzone`, but for `ldns-signzone` allow it to be missing and then use the owner name first SOA found as the apex. This avoids unreliable apex detection in `dnst`, while keeping maximum backward compatibility with `ldns`.
- Removed the no longer necessary separation of `execute()` into an extra `go_further()` fn, which was previously needed as a workaround for using the right generic values.
- Did some cleanup in affected/related code, e.g. bump the SOA SERIAL and use only that bumped SOA RR rather than use two different SOA RRs, refer to `new_default_rr_ttl` instead of `soa_rr.ttl()` to make it clear that it's not per se the SOA RR TTL we are interested in, this is just the default we choose to use, and make more use of the `apex` variable.
- Improved an error message.
- Added some tests for the case of early glue showing that the wrong apex is no longer searched for a SOA by the signer.
@ximon18 ximon18 requested a review from a team May 28, 2025 20:23
@ximon18 ximon18 added the documentation Improvements or additions to documentation label May 28, 2025
@ximon18 ximon18 mentioned this pull request May 30, 2025
60 tasks
@ximon18 ximon18 merged commit 1b90fc1 into main Jun 4, 2025
28 checks passed
@ximon18 ximon18 deleted the man-page-updates branch June 4, 2025 08:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants