Commit graph

282 commits

Author SHA1 Message Date
Matthijs Mekking
6f97bb6b1f Change nsec3param salt config to saltlen
Upon request from Mark, change the configuration of salt to salt
length.

Introduce a new function 'dns_zone_checknsec3aram' that can be used
upon reconfiguration to check if the existing NSEC3 parameters are
in sync with the configuration. If a salt is used that matches the
configured salt length, don't change the NSEC3 parameters.
2020-11-26 10:43:59 +01:00
Matthijs Mekking
f7ca96c805 Add kasp nsec3param configuration
Add configuration and documentation on how to enable NSEC3 when
using dnssec-policy for signing your zones.
2020-11-26 10:43:27 +01:00
Mark Andrews
9a224a3c27 add +dns64prefix to dig to display any DNS64 prefixes at IPV4ONLY.ARPA 2020-11-25 08:25:29 +11:00
Diego Fronza
1ba2215c29 Update ARM and other documents 2020-11-11 12:53:24 -03:00
Witold Kręcicki
d2a2804069 DoT test
Preliminary test for DNSoverTLS - add the dot-port template to system
tests, test a simple query to an authoritative.
2020-11-10 14:17:18 +01:00
Evan Hunt
8ed005f924 add parser support for TLS configuration options
This commit adds stub parser support and tests for:
- "tls" statement, specifying key and cert.
- an optional "tls" keyvalue in listen-on statements for DoT
  configuration.

Documentation for these options has also been added to the ARM, but
needs further work.
2020-11-10 14:16:49 +01:00
Evan Hunt
94b7988efb convert dig/host/nslookup to use the netmgr
use netmgr functions instead of isc_socket for dig, host, and
nslookup. note that `dig +unexpected` is not working.
2020-11-07 20:49:53 +01:00
Michał Kępień
43beb080fc Minor documentation formatting tweaks 2020-10-22 08:54:32 +02:00
Mark Andrews
92cdc7b6c7 Try to improve rrl timing
Add a +burst option to mdig so that we have a second to setup the
mdig calls then they run at the start of the next second.

RRL uses 'queries in a second' as a approximation to
'queries per second'. Getting the bursts of traffic to all happen in
the same second should prevent false negatives in the system test.

We now have a second to setup the traffic in.  Then the traffic should
be sent at the start of the next second.  If that still fails we
should move to +burst=<now+2> (further extend mdig) instead of the
implicit <now+1> as the trigger second.
2020-10-15 00:05:12 +00:00
Matthijs Mekking
e826facadb Add rndc dnssec -rollover command
This command is similar in arguments as -checkds so refactor the
'named_server_dnssec' function accordingly.  The only difference
are that:

- It does not take a "publish" or "withdrawn" argument.
- It requires the key id to be set (add a check to make sure).

Add tests that will trigger rollover immediately and one that
schedules a test in the future.
2020-10-05 10:53:45 +02:00
Ondřej Surý
a00ca65ae6 Remove the .key from the beginning of the line in rst file
The handling of . (dot) characted at the beginning of the line has
changed between the sphinx-doc versions, and it was constantly giving us
trouble when generating man pages when using different sphinx-doc.  This
commit just changes the source rst file, so there's no more . (dot) the
beginning of the line.
2020-09-30 21:12:15 +02:00
Mark Andrews
eeafbddccc regenerate ddns-confgen.8in 2020-09-30 15:52:54 +10:00
Matthijs Mekking
8beda7d2ea Add -expired flag to rndc dumpdb command
This flag is the same as -cache, but will use a different style format
that will also print expired entries (awaiting cleanup) from the cache.
2020-09-23 16:08:29 +02:00
Michał Kępień
5ae33351f2 Deprecate the "glue-cache" option
No issues with the glue cache feature have been reported since its
introduction in BIND 9.12.  As the rationale for introducing the
"glue-cache" option was to have a safety switch readily available in
case the glue cache turns out to cause problems, it is time to deprecate
the option.  Glue cache will be permanently enabled in a future release,
at which point the "glue-cache" option will be made obsolete.
2020-09-16 11:18:07 +02:00
Evan Hunt
dcee985b7f update all copyright headers to eliminate the typo 2020-09-14 16:20:40 -07:00
Mark Andrews
1d55bd943b 'dig +bufsize=0' no longer disables EDNS as a side effect.
Additionally 'dig +bufsize' restores the default EDNS buffer size.
2020-09-02 16:58:43 +02:00
Matthijs Mekking
d4c4f6a669 Add '-P ds' and '-D ds' to dnssec-settime
Add two more arguments to the dnssec-settime tool. '-P ds' sets the
time that the DS was published in the parent, '-D ds' sets the time
that the DS was removed from the parent (these times are not accurate,
but rely on the user to use them appropriately, and as long as the
time is not before actual publication/withdrawal, it is fine).

These new arguments are needed for the kasp system test. We want to
test when the next key event is once a DS is published, and now
that 'parent-registration-delay' is obsoleted, we need a different
approach to reliable test the timings.
2020-09-02 11:59:47 +02:00
Michal Nowak
56abe27b9e
Fix generated documentation
With Sphinx 3.2.1 line-leading period should be escaped.
2020-08-26 10:34:01 +02:00
Ondřej Surý
ca487a5db0 Sync the pregenerated files with their source counterparts 2020-08-24 14:44:05 +02:00
Mark Andrews
0b2555e8cf Address use after free between view, resolver and nta.
Hold a weak reference to the view so that it can't go away while
nta is performing its lookups.  Cancel nta timers once all external
references to the view have gone to prevent them triggering new work.
2020-08-11 11:00:49 +10:00
Matthijs Mekking
46fcd927e7 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'.
2020-08-07 11:26:09 +02:00
Matthijs Mekking
a25f49f153 Make 'parent-registration-delay' obsolete
With the introduction of 'checkds', the 'parent-registration-delay'
option becomes obsolete.
2020-08-07 11:26:09 +02:00
Matthijs Mekking
04d8fc0143 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'.
2020-08-07 11:26:09 +02:00
Ondřej Surý
ce53db34d6 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.
2020-08-04 10:50:31 +02:00
Ondřej Surý
4a8670ddaf Rebuild the documentation 2020-07-31 10:02:23 +02:00
Evan Hunt
3551d3ffd2 convert rndc and control channel to use netmgr
- updated libisccc to use netmgr events
- updated rndc to use isc_nm_tcpconnect() to establish connections
- updated control channel to use isc_nm_listentcp()

open issues:

- the control channel timeout was previously 60 seconds, but it is now
  overridden by the TCP idle timeout setting, which defaults to 30
  seconds. we should add a function that sets the timeout value for
  a specific listener socket, instead of always using the global value
  set in the netmgr. (for the moment, since 30 seconds is a reasonable
  timeout for the control channel, I'm not prioritizing this.)
- the netmgr currently has no support for UNIX-domain sockets; until
  this is addressed, it will not be possible to configure rndc to use
  them. we will need to either fix this or document the change in
  behavior.
2020-07-13 13:16:53 -07:00
Ondřej Surý
514ab2cc4f Fixup the manpages after ddns-confgen.rst -> tsig-keygen.rst rename
There were some missing bits in the other rst files and Makefile.am(s)
that didn't reflect the rename of the main document.  Also add
ddns-confgen.8 manpage.
2020-07-08 11:05:24 +02:00
Evan Hunt
ba52377b37 use 'tsig-keygen' as the primary name for the tool
'ddns-confgen' is now an alias for 'tsig-keygen', rather than
the other way around.
2020-07-06 01:41:52 -07:00
Ondřej Surý
9ab86d0da2 Update the generated files after the source manpages update 2020-07-02 10:53:16 +02:00
Suzanne Goldlust
e3e787bc14 Fix formatting of See Also section header 2020-07-01 23:45:04 +02:00
Evan Hunt
f619708bbf prevent "primaries" lists from having duplicate names
it is now an error to have two primaries lists with the same
name. this is true regardless of whether the "primaries" or
"masters" keywords were used to define them.
2020-07-01 11:11:34 -07:00
Ondřej Surý
c5b63e14bc Commit the regenerated rndc.conf.5in manual page 2020-07-01 12:14:29 +02:00
Matthijs Mekking
e273b95a8b Update notes, changes for #1612 2020-06-30 09:51:22 +02:00
Matthijs Mekking
e1ba1bea7c 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.
2020-06-30 09:51:04 +02:00
Ondřej Surý
36e4090c70 Update pregenerated dig.1in and rndc-confgen.8in 2020-06-22 14:08:53 +02:00
Ondřej Surý
28575abd93 Rebuild the manpages sources only when in maintainer mode
Similarly, the manpage sources will get rebuild only when in maintainer
mode because they require sphinx-build to be available locally and that
might not be always the case.
2020-06-22 14:08:53 +02:00
Michal Nowak
5bbc6dd7f1 Fix "make dist"
Make various adjustments necessary to enable "make dist" to build a BIND
source tarball whose contents are complete enough to build binaries, run
unit & system tests, and generate documentation on Unix systems.

Known outstanding issues:

  - "make distcheck" does not work yet.
  - Tests do not work for out-of-tree source-tarball-based builds.
  - Source tarballs are not complete enough for building on Windows.

All of the above will be addressed in due course.
2020-06-05 13:19:49 +02:00
Michal Nowak
4419606c9d Revise installation locations for BIND binaries
Move BIND binaries which are neither daemons nor administrative programs
to $bindir.  This results in only the following binaries being left in
$sbindir:

  - ddns-confgen
  - named
  - rndc
  - rndc-confgen
  - tsig-confgen
2020-06-04 13:19:23 +02:00
Ondřej Surý
1202fd912a Rewrite the statschannel traffic tests to pytest 2020-05-12 08:48:01 +02:00
Ondřej Surý
9fb6d11abb 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.
2020-05-07 16:02:56 +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
Michael Graff
1e92a4f7a4 specify which fields are set by what in the packet header 2000-09-06 20:54:44 +00:00
Andreas Gustafsson
0a04ba7b7b Bob says lwres_net_aton and lwres_net_pton were never intended to be
part of the public interface of the lwres library
2000-09-06 18:23:47 +00:00
Jim Reid
fa263add26 First draft of resolver(5) man page 2000-09-03 20:45:58 +00:00
Jim Reid
69f2a57302 First draft of dig manpage 2000-09-03 18:04:24 +00:00
Brian Wellington
a437acf787 Add -v 2000-08-30 20:43:28 +00:00
Andreas Gustafsson
17a28c1f02 403. [bug] host did not use the search list. 2000-08-22 17:02:49 +00:00
Andreas Gustafsson
413d5565ba document the named command line options in named.8, not README 2000-08-21 20:40:05 +00:00
Andreas Gustafsson
6992382575 cut-and-paste-o 2000-08-17 22:08:16 +00:00
Andreas Gustafsson
868c96e17f removed references to nonexistent
named.conf(5) and zonefile(5) man pages
2000-08-15 20:19:36 +00:00
Andreas Gustafsson
c45fa347b4 more editing 2000-08-15 20:15:49 +00:00
Andreas Gustafsson
49964c290c reviewed and edited; note that IPv6 reverse lookups are now
supported
2000-08-15 20:11:54 +00:00
Brian Wellington
f93d9c5a58 modify the keyfile description 2000-08-15 19:47:06 +00:00
Andreas Gustafsson
c193f5a1eb reviewed, edited 2000-08-15 19:40:40 +00:00
Andreas Gustafsson
0df41d7b0f more decrufting 2000-08-08 23:37:05 +00:00
David Lawrence
40f53fa8d9 Trailing whitespace trimmed. Perhaps running "perl util/spacewhack.pl in your
own CVS tree will help minimize CVS conflicts.  Maybe not.
Blame Graff for getting me to trim all trailing whitespace.
2000-08-01 01:33:37 +00:00
Brian Wellington
c1ee9be19b clean up the text relating to pseudorandom input. 2000-07-31 19:39:42 +00:00
Brian Wellington
529a6b5224 358. [cleanup] Rename the intermediate files used by the dnssec
programs.
2000-07-31 15:28:21 +00:00
David Lawrence
5f6b0ea19a somehow this got missed with the mega-update_copyrights run 2000-07-27 23:49:40 +00:00
David Lawrence
15a4474541 word wrap copyright notice at column 70 2000-07-27 09:55:03 +00:00
Andreas Gustafsson
7916c2f2b2 clarified 2000-07-26 21:36:43 +00:00
Brian Wellington
a1cbe5c5a1 The example omitted the -o option for the wrong reason. 2000-07-26 21:36:08 +00:00
Brian Wellington
10680f2169 The cycle text was even more confusing than it is now. 2000-07-26 20:58:11 +00:00
Andreas Gustafsson
6967adadcb minor clarifications 2000-07-26 19:13:18 +00:00
Andreas Gustafsson
4a9b6178ba incorrect use of plural 2000-07-26 18:52:05 +00:00
Brian Wellington
15ba758c3a minor tweaks 2000-07-26 00:47:17 +00:00
Andreas Gustafsson
d987e0d8e8 reviewed and edited; removed lwres intro material
that is better covered in lwres(3)
2000-07-17 17:49:25 +00:00
David Lawrence
3dae6c4675 minor cleanups from review 2000-07-12 19:39:49 +00:00
Jim Reid
df5918b068 incorporated Brian's review comments and corrections 2000-07-12 18:29:33 +00:00
Andreas Gustafsson
a8ea4d2e3f moved rndc.conf.5 from doc/man/misc to doc/man/bin
for inclusion in RC1 (by repository copy)
2000-07-12 17:41:24 +00:00
Andreas Gustafsson
0d3bf3c5f1 reviewed; removed requirement to always quote
host addresses
2000-07-12 17:37:57 +00:00
Jim Reid
94b7428468 first drafts of the nsupdate and host man pages 2000-07-12 17:17:03 +00:00
Andreas Gustafsson
00148ffb6b reviewed; made minor stylistic changes 2000-07-12 16:48:19 +00:00
Jim Reid
b9db5f75cf fixed some typos and incorrect troff macro calls
put the text into our (as yet undocumented) manpage canonical format
2000-07-12 13:49:07 +00:00
Andreas Gustafsson
52eae74966 reviewed and edited 2000-07-12 02:07:32 +00:00
David Lawrence
3734f3f1ba -k flag changed to -y to be compatible with dig and nsupdate.
(... since I have to update the ARM anyway ...)
2000-07-11 00:37:58 +00:00
David Lawrence
32d6b7bbfb use base64 for the secret; describe how base64 secrets can be made; clarify
the interaction of some of the statements and the command line;
clarify the double quote rules
2000-07-11 00:23:38 +00:00
David Lawrence
acc859e12c updated to describe current options 2000-07-10 23:04:42 +00:00
David Lawrence
a53efa1718 nrdc->rndc typo, uses TCP not UDP 2000-07-04 01:25:01 +00:00
Jim Reid
e4b125e8d6 first draft of rdnc.conf manpage 2000-06-29 06:14:18 +00:00
Jim Reid
65e5eed890 first draft of rdnc man page 2000-06-29 05:31:42 +00:00
Jim Reid
bb09af99a5 fixed some brokwn .Ar macro calls that should have been .Fl calls
tidied up some clumsy English and missing option intros.
2000-06-28 23:41:01 +00:00
Jim Reid
084d809e48 fixed some typos
removed references to ENI_ error codes because they're not
documented in RFC2133 and are defined in getnameinfo.c rather
than some include file anyway
2000-06-28 21:43:41 +00:00
Jim Reid
57584184fe incorporated Brian's corrections and improvements 2000-06-28 03:20:49 +00:00
Jim Reid
1b32c4783f minor corrections to -n option description as recommended by Brian 2000-06-28 02:51:46 +00:00
Jim Reid
25ad3a2a0a adding .so "man pages" for all the functions in the lib/isc/unix modules 2000-06-28 02:48:34 +00:00
Jim Reid
50310a47e9 fixed yet more silliness with incorrect .Nm macro calls 2000-06-28 02:40:45 +00:00
Jim Reid
438717d8cf fixed missing NAME section and broken Nm macro calls 2000-06-28 02:38:47 +00:00
Jim Reid
3d17651dd6 removed crap about internal functions that return statics and are
therefore not part of the external API
2000-06-28 02:35:04 +00:00
Jim Reid
221d9f7607 Tidy up of this cruft: man pages have been renamed isc_* with .3
suffixes and moved to the isc subdirectory
2000-06-27 22:06:54 +00:00
Jim Reid
a07cfacd85 initial draft of lwres manpages 2000-06-27 21:53:10 +00:00
Jim Reid
e1ff904c6f first draft of isc/unix API manpages 2000-06-27 21:51:45 +00:00
Jim Reid
5aeec9bb28 first draft of man pages on dnssec tools 2000-06-27 21:50:27 +00:00
Jim Reid
3b8403a20c first draft of man pages for lwresd and named 2000-06-27 21:49:15 +00:00
Jim Reid
48f3ddbf4a renamed from {dir,error,file,ipproto,netif,socket,stdio,stdtime,time}.man 2000-06-23 00:30:12 +00:00
Jim Reid
41bf69a3ce app.man renamed to app.3 2000-06-23 00:17:06 +00:00
David Lawrence
d0be1e954b update_copyrights 2000-06-22 01:01:45 +00:00
David Lawrence
18c6c7fb0f removed bogus man-style comment from start 2000-06-21 01:21:59 +00:00
Jim Reid
a88ba6982b Import of PRM 2000-06-01 03:19:06 +00:00