Commit Graph

108 Commits

Author SHA1 Message Date
Michal Nowak
5082d60105 Fix generated documentation 2020-08-26 16:30:04 +00:00
Matthijs Mekking
624f1b9531 rndc dnssec -checkds set algorithm
In the rare case that you have multiple keys acting as KSK and that
have the same keytag, you can now set the algorithm when calling
'-checkds'.

(cherry picked from commit 46fcd927e7)
2020-08-07 13:34:10 +02:00
Matthijs Mekking
4892006a92 Make 'parent-registration-delay' obsolete
With the introduction of 'checkds', the 'parent-registration-delay'
option becomes obsolete.

(cherry picked from commit a25f49f153)
2020-08-07 13:30:50 +02:00
Matthijs Mekking
81d0c63ecb Implement 'rndc dnssec -checkds'
Add a new 'rndc' command 'dnssec -checkds' that allows the user to
signal named that a new DS record has been seen published in the
parent, or that an existing DS record has been withdrawn from the
parent.

Upon the 'checkds' request, 'named' will write out the new state for
the key, updating the 'DSPublish' or 'DSRemoved' timing metadata.

This replaces the "parent-registration-delay" configuration option,
this was unreliable because it was purely time based (if the user
did not actually submit the new DS to the parent for example, this
could result in an invalid DNSSEC state).

Because we cannot rely on the parent registration delay for state
transition, we need to replace it with a different guard. Instead,
if a key wants its DS state to be moved to RUMOURED, the "DSPublish"
time must be set and must not be in the future. If a key wants its
DS state to be moved to UNRETENTIVE, the "DSRemoved" time must be set
and must not be in the future.

By default, with '-checkds' you set the time that the DS has been
published or withdrawn to now, but you can set a different time with
'-when'. If there is only one KSK for the zone, that key has its
DS state moved to RUMOURED. If there are multiple keys for the zone,
specify the right key with '-key'.

(cherry picked from commit 04d8fc0143)
2020-08-07 13:30:19 +02:00
Ondřej Surý
b48e9ab201 Add stale-cache-enable option and disable serve-stable by default
The current serve-stale implementation in BIND 9 stores all received
records in the cache for a max-stale-ttl interval (default 12 hours).

This allows DNS operators to turn the serve-stale answers in an event of
large authoritative DNS outage.  The caching of the stale answers needs
to be enabled before the outage happens or the feature would be
otherwise useless.

The negative consequence of the default setting is the inevitable
cache-bloat that happens for every and each DNS operator running named.

In this MR, a new configuration option `stale-cache-enable` is
introduced that allows the operators to selectively enable or disable
the serve-stale feature of BIND 9 based on their decision.

The newly introduced option has been disabled by default,
e.g. serve-stale is disabled in the default configuration and has to be
enabled if required.

(cherry picked from commit ce53db34d6)
2020-08-05 09:09:16 +02:00
Suzanne Goldlust
4112b96d52 Fix formatting of See Also section header
(cherry picked from commit e3e787bc14)
2020-07-01 23:46:39 +02:00
Michał Kępień
8c9cacb7e8 Restore man pages for symlinked BIND tools
Commit b580eb2fb3 inadvertently caused the
man pages for symlinked BIND tools (named-compilezone, tsig-keygen) to
no longer be installed by "make install".  Fix by restoring the commands
which ensure that.
2020-07-01 22:06:25 +02:00
Michał Kępień
58c07cc153 Install NZD-related man pages conditionally
Commit b580eb2fb3 inadvertently caused
NZD-related man pages to be installed unconditionally.  Ensure they are
only installed for LMDB-enabled builds.
2020-07-01 22:06:25 +02:00
Michał Kępień
75e322ec08 Install dnstap-related man pages conditionally
Commit b580eb2fb3 inadvertently caused
dnstap-related man pages to be installed unconditionally.  Ensure they
are only installed for dnstap-enabled builds.
2020-07-01 22:06:25 +02:00
Ondřej Surý
4d65685cc3 Commit the regenerated rndc.conf.5in manual page
(cherry picked from commit c5b63e14bc)
2020-07-01 12:21:16 +02:00
Matthijs Mekking
2d9b282d77 Update notes, changes for #1612
(cherry picked from commit e273b95a8b)
2020-07-01 09:58:25 +02:00
Matthijs Mekking
34a9c3f6c9 Implement dummy 'rndc dnssec -status' command
Add the code and documentation required to provide DNSSEC signing
status through rndc.  This does not yet show any useful information,
just provide the command that will output some dummy string.

(cherry picked from commit e1ba1bea7c)
2020-07-01 09:57:44 +02:00
Tinderbox User
adab85b815 prep 9.16.4 2020-06-18 10:25:50 +02:00
Evan Hunt
b580eb2fb3 add support for building sphinx documentation 2020-06-01 09:54:46 +02:00
Evan Hunt
330c9b32ba convert python tools' man pages to RST 2020-06-01 09:54:45 +02:00
Ondřej Surý
58e20fa746 Convert the documentation to Sphinx documentation format
The ARM and the manpages have been converted into Sphinx documentation
format.

Sphinx uses reStructuredText as its markup language, and many of its
strengths come from the power and straightforwardness of
reStructuredText and its parsing and translating suite, the Docutils.

(cherry picked from commit 9fb6d11abb)
2020-06-01 09:54:45 +02:00
Andreas Gustafsson
1cc90ff672 removed the ctoman script 2001-01-18 01:46:34 +00:00
Andreas Gustafsson
b4a62f571d removed libisc man pages 2001-01-18 01:42:50 +00:00
Andreas Gustafsson
f7bf406044 lwres man pages moved to lib/lwres/man/ 2001-01-18 01:15:08 +00:00
Andreas Gustafsson
e2b3253d77 man pages have been moved to bin/dnssec 2001-01-18 01:05:50 +00:00
Andreas Gustafsson
d4134b2fc3 binary man pages have been moved to the source directories of
their respective binaries, and resolver.5 has been moved to ../lwres
(note that resolver.5 is still not included in releases)
2001-01-18 01:04:10 +00:00
Brian Wellington
499b34cea0 copyright update 2001-01-09 22:01:04 +00:00
Andreas Gustafsson
75d927bd72 renamed check-zone to named-checkzone and check-conf to named-checkzone
to reduce /usr/local/bin namespace pollution; added a CHANGES entry for them
2000-12-19 19:51:08 +00:00
Andreas Gustafsson
4004165d00 removed reference to nonexistent named.conf man page; added
more detailed references to ARM
2000-12-15 00:24:10 +00:00
Mark Andrews
92f372bb48 Initial checkin. 2000-12-14 21:41:50 +00:00
Mark Andrews
f815ada673 Initial checkin. 2000-12-14 00:52:44 +00:00
Brian Wellington
5d63dfaa9d Document the -n option 2000-12-07 02:20:07 +00:00
Andreas Gustafsson
f55dd75bca minor editing 2000-12-04 18:37:40 +00:00
Andreas Gustafsson
acb053cc54 references to named.conf statements should not include an empty
set of braces
2000-11-30 00:20:40 +00:00
Andreas Gustafsson
21dc0cbb26 reload is no longer the only command supported by rndc 2000-11-30 00:18:16 +00:00
Andreas Gustafsson
8b4eaec405 removed RRSET_AUTHORITATIVE bit as decided in lengthy
teleconference discussion; some editorial changes
2000-11-29 22:55:11 +00:00
Mark Andrews
517950ae99 579. [bug] nsupdate did not take a filename to read update from.
[RT #492]
2000-11-27 00:43:33 +00:00
Brian Wellington
cffe50abf6 Lots of copyright updates 2000-11-18 03:01:17 +00:00
Mark Andrews
383f4adf3b document "local" keyword. 2000-11-16 05:59:11 +00:00
Andreas Gustafsson
5ae97875f9 undo: last changes belongs on release branch, not mainline 2000-11-10 18:05:25 +00:00
Andreas Gustafsson
ba8176b44d document that RSA keys are limited to 2000 bits in 9.0.1 2000-11-10 18:03:05 +00:00
Andreas Gustafsson
f9e2ce8223 warn against relative path names as arguments to the -c
option [RT #428]
2000-11-09 18:09:12 +00:00
Brian Wellington
4d833ef73b Document lwres_getrrsetbyname 2000-11-02 02:21:09 +00:00
Brian Wellington
6e4deb9f1b updates 2000-11-01 00:33:50 +00:00
Brian Wellington
0bd785149d Document the '-t' (statistics) option. 2000-10-28 01:16:46 +00:00
Brian Wellington
b05c91f9d5 The 'hints' parameter somehow turned into 'arg' in the middle of the
description.
2000-10-19 00:43:07 +00:00
Andreas Gustafsson
0a9b84a8a5 #include <lwres/netdb.h>, not lwres.h 2000-10-19 00:26:36 +00:00
Brian Wellington
e0425840a8 -p and -P were switched. 2000-10-18 22:28:42 +00:00
Michael Sawyer
c9093e6b1a Minor change, +sta should be +stats 2000-09-29 18:25:00 +00:00
Andreas Gustafsson
23bfeb8bb1 checkpoint 2000-09-28 22:36:33 +00:00
Andreas Gustafsson
ab38df2af4 Review, hack and slash (mostly slash) 2000-09-26 23:41:43 +00:00
Jim Reid
ddafe41410 Fixed some documentation errors caused by describing the aberrant behaviour of
threads in BSD/OS and mistakenly attributing that to all platforms.

Added a couple of paras on how lookups are performed.

Documented the difference n how trunctaed responses are handled.
2000-09-08 09:42:56 +00:00
Andreas Gustafsson
d782d0dc8d major rewrite 2000-09-07 16:36:29 +00:00
Michael Graff
346e6a3a23 touch up a comment 2000-09-06 21:56:20 +00:00
Michael Graff
db84234e52 add some quick text describing client- and server-side flow 2000-09-06 21:54:23 +00:00