Compare commits
32
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
24eddb7679 | ||
|
|
3d280f238e | ||
|
|
43e566937e | ||
|
|
d55304ea29 | ||
|
|
dceabb547b | ||
|
|
258d8912d4 | ||
|
|
9b191a9a6b | ||
|
|
1e152250c1 | ||
|
|
243da5c407 | ||
|
|
732c7eaf1f | ||
|
|
edb6f5c2a8 | ||
|
|
ba46797f42 | ||
|
|
6d46fbb550 | ||
|
|
1c06e32a93 | ||
|
|
7b5abac4e9 | ||
|
|
30c6d4befd | ||
|
|
48ea0a317c | ||
|
|
bc4a4f7186 | ||
|
|
5841bd1783 | ||
|
|
4b55fd0d8a | ||
|
|
32ca49c437 | ||
|
|
c85a6a533f | ||
|
|
d61bb36061 | ||
|
|
56d48aa8a2 | ||
|
|
32b9631d1a | ||
|
|
0e1e295ddb | ||
|
|
8fffa3760d | ||
|
|
49eab869ba | ||
|
|
18b5f9dd92 | ||
|
|
cfb23c73f7 | ||
|
|
87e4e442d7 | ||
|
|
8447d2e80e |
-114
@@ -1,114 +0,0 @@
|
|||||||
;;; Directory Local Variables
|
|
||||||
;;; For more information see (info "(emacs) Directory Variables")
|
|
||||||
|
|
||||||
((c-mode .
|
|
||||||
((eval .
|
|
||||||
(set (make-local-variable 'directory-of-current-dir-locals-file)
|
|
||||||
(file-name-directory (locate-dominating-file default-directory ".dir-locals.el"))
|
|
||||||
)
|
|
||||||
)
|
|
||||||
(eval .
|
|
||||||
(set (make-local-variable 'include-directories)
|
|
||||||
(list
|
|
||||||
|
|
||||||
;; top directory
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "./"))
|
|
||||||
|
|
||||||
;; libisc
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/isc/unix/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/isc/pthreads/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/isc/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/isc"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/isc/netmgr"))
|
|
||||||
|
|
||||||
;; libdns
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/dns/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/dns"))
|
|
||||||
|
|
||||||
;; libisccc
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/isccc/include"))
|
|
||||||
|
|
||||||
;; libisccfg
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/isccfg/include"))
|
|
||||||
|
|
||||||
;; libns
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/ns/include"))
|
|
||||||
|
|
||||||
;; libirs
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/irs/include"))
|
|
||||||
|
|
||||||
;; libbind9
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "lib/bind9/include"))
|
|
||||||
|
|
||||||
;; bin
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/check"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/confgen/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/confgen"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/confgen/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/dig/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/named/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/named/unix/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/rndc/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/dnssec/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/named/include"))
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "bin/rndc/include"))
|
|
||||||
|
|
||||||
(expand-file-name "/usr/local/opt/openssl@1.1/include")
|
|
||||||
(expand-file-name "/usr/local/opt/libxml2/include/libxml2")
|
|
||||||
(expand-file-name "/usr/local/opt/json-c/include/json-c/")
|
|
||||||
(expand-file-name "/usr/local/include")
|
|
||||||
)
|
|
||||||
)
|
|
||||||
)
|
|
||||||
|
|
||||||
(eval setq flycheck-clang-include-path include-directories)
|
|
||||||
(eval setq flycheck-cppcheck-include-path include-directories)
|
|
||||||
(eval setq flycheck-gcc-include-path include-directories)
|
|
||||||
(eval setq flycheck-clang-args
|
|
||||||
(list
|
|
||||||
"-include"
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "config.h"))
|
|
||||||
)
|
|
||||||
)
|
|
||||||
(eval setq flycheck-gcc-args
|
|
||||||
(list
|
|
||||||
"-include"
|
|
||||||
(expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "config.h"))
|
|
||||||
)
|
|
||||||
)
|
|
||||||
(eval setq flycheck-cppcheck-args
|
|
||||||
(list
|
|
||||||
"--enable=all"
|
|
||||||
"--suppress=missingIncludeSystem"
|
|
||||||
(concat "-include=" (expand-file-name
|
|
||||||
(concat directory-of-current-dir-locals-file "config.h")))
|
|
||||||
)
|
|
||||||
)
|
|
||||||
)
|
|
||||||
))
|
|
||||||
+2
-9
@@ -1,10 +1,3 @@
|
|||||||
*.sln.in eol=crlf
|
*.sln.in eol=crlf
|
||||||
*.vcxproj.* eol=crlf
|
*.vcxproj.in eol=crlf
|
||||||
|
*.vcxproj.filters.in eol=crlf
|
||||||
.gitignore export-ignore
|
|
||||||
/conftools export-ignore
|
|
||||||
/doc/design export-ignore
|
|
||||||
/doc/dev export-ignore
|
|
||||||
/util/** export-ignore
|
|
||||||
/util/bindkeys.pl -export-ignore
|
|
||||||
/util/mksymtbl.pl -export-ignore
|
|
||||||
|
|||||||
+55
-54
@@ -1,63 +1,64 @@
|
|||||||
*-symtbl.c
|
Makefile
|
||||||
*.a
|
config.log
|
||||||
*.gcda
|
config.h
|
||||||
*.gcno
|
config.cache
|
||||||
*.la
|
config.status
|
||||||
*.lo
|
libtool
|
||||||
*.o
|
/isc-config.sh
|
||||||
*.orig
|
/configure.lineno
|
||||||
*.plist/ # ccc-analyzer store its results in .plist directories
|
autom4te.cache/
|
||||||
*.rej
|
*.rej
|
||||||
|
*.orig
|
||||||
|
*.o
|
||||||
|
*.lo
|
||||||
*.so
|
*.so
|
||||||
|
*.a
|
||||||
|
*.la
|
||||||
|
*.gcno
|
||||||
|
*.gcda
|
||||||
*_test
|
*_test
|
||||||
*.ipch # vscode/intellisense precompiled header
|
*-symtbl.c
|
||||||
*~
|
timestamp
|
||||||
|
ans.run
|
||||||
|
named.run
|
||||||
|
named.memstats
|
||||||
|
gen.dSYM/
|
||||||
.ccache/
|
.ccache/
|
||||||
.cproject
|
|
||||||
.deps/
|
.deps/
|
||||||
.dirstamp
|
.dirstamp
|
||||||
.libs/
|
.libs/
|
||||||
|
unit/atf-src/atf-c++/atf-c++.pc
|
||||||
|
unit/atf-src/atf-c/atf-c.pc
|
||||||
|
unit/atf-src/atf-c/defs.h
|
||||||
|
unit/atf-src/atf-c/detail/process_helpers
|
||||||
|
unit/atf-src/atf-config/atf-config
|
||||||
|
unit/atf-src/atf-report/atf-report
|
||||||
|
unit/atf-src/atf-report/fail_helper
|
||||||
|
unit/atf-src/atf-report/misc_helpers
|
||||||
|
unit/atf-src/atf-report/pass_helper
|
||||||
|
unit/atf-src/atf-run/atf-run
|
||||||
|
unit/atf-src/atf-run/bad_metadata_helper
|
||||||
|
unit/atf-src/atf-run/expect_helpers
|
||||||
|
unit/atf-src/atf-run/misc_helpers
|
||||||
|
unit/atf-src/atf-run/pass_helper
|
||||||
|
unit/atf-src/atf-run/several_tcs_helper
|
||||||
|
unit/atf-src/atf-run/zero_tcs_helper
|
||||||
|
unit/atf-src/atf-sh/atf-check
|
||||||
|
unit/atf-src/atf-sh/atf-sh
|
||||||
|
unit/atf-src/atf-sh/misc_helpers
|
||||||
|
unit/atf-src/atf-version/atf-version
|
||||||
|
unit/atf-src/atf-version/revision.h
|
||||||
|
unit/atf-src/atf-version/revision.h.stamp
|
||||||
|
unit/atf-src/bconfig.h
|
||||||
|
unit/atf-src/bootstrap/atconfig
|
||||||
|
unit/atf-src/doc/atf.7
|
||||||
|
unit/atf-src/stamp-h1
|
||||||
|
unit/atf-src/test-programs/c_helpers
|
||||||
|
unit/atf-src/test-programs/cpp_helpers
|
||||||
|
unit/atf-src/test-programs/sh_helpers
|
||||||
|
# ccc-analyzer store its results in .plist directories
|
||||||
|
*.plist/
|
||||||
|
*~
|
||||||
.project
|
.project
|
||||||
|
.cproject
|
||||||
.settings
|
.settings
|
||||||
/aclocal.m4
|
|
||||||
/ar-lib
|
|
||||||
/autom4te.cache/
|
|
||||||
/bind.keys.h
|
|
||||||
/compile
|
|
||||||
/config.cache
|
|
||||||
/config.guess
|
|
||||||
/config.h
|
|
||||||
/config.h.in
|
|
||||||
/config.log
|
|
||||||
/config.status
|
|
||||||
/config.sub
|
|
||||||
/configure
|
|
||||||
/configure.lineno
|
|
||||||
/depcomp
|
|
||||||
/install-sh
|
|
||||||
/isc-config.sh
|
|
||||||
/libltdl/*
|
|
||||||
/libtool
|
|
||||||
/ltmain.sh
|
|
||||||
/m4/libtool.m4
|
|
||||||
/m4/ltargz.m4
|
|
||||||
/m4/ltdl.m4
|
|
||||||
/m4/ltoptions.m4
|
|
||||||
/m4/ltsugar.m4
|
|
||||||
/m4/ltversion.m4
|
|
||||||
/m4/lt~obsolete.m4
|
|
||||||
/missing
|
|
||||||
/py-compile
|
|
||||||
/stamp-h1
|
|
||||||
/test-driver
|
|
||||||
Makefile
|
|
||||||
ans.run
|
|
||||||
gen.dSYM/
|
|
||||||
kyua.log
|
|
||||||
named.memstats
|
|
||||||
named.run
|
|
||||||
timestamp
|
|
||||||
/compile_commands.json
|
|
||||||
/cppcheck_html/
|
|
||||||
/cppcheck.results
|
|
||||||
/tsan
|
|
||||||
|
|||||||
+258
-1085
File diff suppressed because it is too large
Load Diff
@@ -1,65 +0,0 @@
|
|||||||
## Release Schedule
|
|
||||||
|
|
||||||
**Tagging Deadline:**
|
|
||||||
|
|
||||||
**Public Release:**
|
|
||||||
|
|
||||||
## Release Checklist
|
|
||||||
|
|
||||||
## 2 Working Days Before the Tagging Deadline
|
|
||||||
|
|
||||||
- [ ] ***(QA)*** Check whether all issues assigned to the release milestone are resolved[^1].
|
|
||||||
- [ ] ***(QA)*** Ensure that there are no outstanding merge requests in the private repository[^1] (Subscription Edition only).
|
|
||||||
- [ ] ***(QA)*** Ensure all merge requests marked for backporting have been indeed backported.
|
|
||||||
|
|
||||||
## Before the Tagging Deadline
|
|
||||||
|
|
||||||
- [ ] ***(QA)*** Inform Support/Marketing of impending release (and give estimated release dates).
|
|
||||||
- [ ] ***(QA)*** Check Perflab to ensure there has been no unexplained drop in performance for the versions being released.
|
|
||||||
- [ ] ***(SwEng)*** Update API files for libraries with new version information.
|
|
||||||
- [ ] ***(SwEng)*** Change software version and library versions in `configure.ac` (new major release only).
|
|
||||||
- [ ] ***(SwEng)*** Rebuild `configure` using Autoconf on `docs.isc.org`.
|
|
||||||
- [ ] ***(SwEng)*** Update `CHANGES`.
|
|
||||||
- [ ] ***(SwEng)*** Update `CHANGES.SE` (Subscription Edition only).
|
|
||||||
- [ ] ***(SwEng)*** Update `README.md`.
|
|
||||||
- [ ] ***(SwEng)*** Update `version`.
|
|
||||||
- [ ] ***(SwEng)*** Build documentation on `docs.isc.org`.
|
|
||||||
- [ ] ***(QA)*** Check that all the above steps were performed correctly.
|
|
||||||
- [ ] ***(QA)*** Check that the contents of release notes match the merge requests comprising the releases.
|
|
||||||
- [ ] ***(QA)*** Check that the formatting is correct for text, PDF, and HTML versions of release notes.
|
|
||||||
- [ ] ***(SwEng)*** Tag the releases[^2]. (Tags may only be pushed to the public repository for releases which are *not* security releases.)
|
|
||||||
- [ ] ***(SwEng)*** If this is the first tag for a release (e.g. beta), create a release branch named `release_v9_X_Y` to allow development to continue on the maintenance branch whilst release engineering continues.
|
|
||||||
|
|
||||||
## Before the ASN Deadline (for ASN Releases) or the Public Release Date (for Regular Releases)
|
|
||||||
|
|
||||||
- [ ] ***(QA)*** Verify GitLab CI results for the tags created and prepare a QA report for the releases to be published.
|
|
||||||
- [ ] ***(QA)*** Request signatures for the tarballs, providing their location and checksums.
|
|
||||||
- [ ] ***(Signers)*** Validate tarball checksums, sign tarballs, and upload signatures.
|
|
||||||
- [ ] ***(QA)*** Verify tarball signatures and check tarball checksums again.
|
|
||||||
- [ ] ***(Support)*** Pre-publish ASN and/or Subscription Edition tarballs so that packages can be built.
|
|
||||||
- [ ] ***(QA)*** Build and test ASN and/or Subscription Edition packages.
|
|
||||||
- [ ] ***(QA)*** Notify Support that the releases have been prepared.
|
|
||||||
- [ ] ***(Support)*** Send out ASNs (if applicable).
|
|
||||||
|
|
||||||
## On the Day of Public Release
|
|
||||||
|
|
||||||
- [ ] ***(Support)*** Wait for clearance from Security Officer to proceed with the public release (if applicable).
|
|
||||||
- [ ] ***(Support)*** Place tarballs in public location on FTP site.
|
|
||||||
- [ ] ***(Support)*** Publish links to downloads on ISC website.
|
|
||||||
- [ ] ***(Support)*** Write release email to *bind-announce*.
|
|
||||||
- [ ] ***(Support)*** Write email to *bind-users* (if a major release).
|
|
||||||
- [ ] ***(Support)*** Update tickets in case of waiting support customers.
|
|
||||||
- [ ] ***(QA)*** Build and test any outstanding private packages.
|
|
||||||
- [ ] ***(QA)*** Build public packages (`*.deb`, RPMs).
|
|
||||||
- [ ] ***(QA)*** Inform Marketing of the release.
|
|
||||||
- [ ] ***(QA)*** Update the internal [BIND release dates wiki page](https://wiki.isc.org/bin/view/Main/BindReleaseDates) when public announcement has been made.
|
|
||||||
- [ ] ***(Marketing)*** Post short note to Twitter.
|
|
||||||
- [ ] ***(Marketing)*** Update [Wikipedia entry for BIND](https://en.wikipedia.org/wiki/BIND).
|
|
||||||
- [ ] ***(Marketing)*** Write blog article (if a major release).
|
|
||||||
- [ ] ***(QA)*** Ensure all new tags are annotated and signed.
|
|
||||||
- [ ] ***(SwEng)*** Push tags for the published releases to the public repository.
|
|
||||||
- [ ] ***(SwEng)*** Merge the automatically prepared `prep 9.X.Y` commit which updates `version` and documentation on the release branch into the relevant maintenance branch (`v9_X`).
|
|
||||||
|
|
||||||
[^1]: If not, use the time remaining until the tagging deadline to ensure all outstanding issues are either resolved or moved to a different milestone.
|
|
||||||
|
|
||||||
[^2]: Preferred command line: `git tag -u <DEVELOPER_KEYID> -a -s -m "BIND 9.X.Y[alphatag]" v9_X_Y[alphatag]`, where `[alphatag]` is an optional string such as `b1`, `rc1`, etc.
|
|
||||||
@@ -0,0 +1,31 @@
|
|||||||
|
## Release Checklist
|
||||||
|
|
||||||
|
- [ ] (Manager) Check for the presence of a milestone for the release.
|
||||||
|
- If there is a milestone, are all the issues for the milestone resolved? (other than this checklist).
|
||||||
|
- [ ] (Manager) Inform Support/Marketing of impending release (and give estimated release dates).
|
||||||
|
- (SwEng) Prepare the sources for tarball generation.
|
||||||
|
- [ ] Ensure that there are no outstanding merge requests in the private repository (subscription version only).
|
||||||
|
- [ ] Update API files for libraries with new version information.
|
||||||
|
- [ ] Change software version and library versions in configure.in (new major release only).
|
||||||
|
- [ ] Ensure Kyua and ATF files are correct.
|
||||||
|
- [ ] Rebuild configure using autoconf on docs.isc.org.
|
||||||
|
- [ ] Update CHANGES.
|
||||||
|
- [ ] Update CHANGES.SE (subscription branch only).
|
||||||
|
- [ ] Update "version".
|
||||||
|
- [ ] Update "readme.md".
|
||||||
|
- [ ] Ensure the release notes are correct for this release (content, formatting, etc.).
|
||||||
|
- [ ] Build documentation on docs.isc.org.
|
||||||
|
- [ ] Commit changes and make sure the gitlab-ci tests are passing.
|
||||||
|
- [ ] Push the changes and tag ("alphatag" is an optional string such as "b1", "rc1" etc.). (```git tag -u <DEVELOPER_KEYID> -a -s -m "BIND 9.X.Y[alphatag]" v9_X_Y[alphatag]```)
|
||||||
|
- [ ] If this is the first tag for a release (e.g. beta), create a release branch named `release_v9_X_Y` (this allows development to continue on the release branch whilst release engineering continues).
|
||||||
|
- [ ] (SwEng) Run the "make release" Jenkins job to produce the tarballs and zips.
|
||||||
|
- [ ] (SwEng) Ask QA to sanity check the tarball and zips (passing to them the number of the Jenkins job).
|
||||||
|
- [ ] (QA) Sanity check the tarballs.
|
||||||
|
- [ ] (QA) Request the signature on the tarballs.
|
||||||
|
- [ ] (QA) Check signatures on tarballs.
|
||||||
|
- [ ] (QA) Tell Support to handle notification of release.
|
||||||
|
- [ ] (Support) Make tarballs and signatures available to download.
|
||||||
|
- [ ] (Manager) Update [https://wiki.isc.org/bin/view/Main/BindReleaseDates](BIND release dates page) when public announcement has been made.
|
||||||
|
- [ ] (Manager) Inform marketing of the release
|
||||||
|
|
||||||
|
- [ ] (SwEng) Update DEB and RPM packages
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
Content-Type: application/X-atf-atffile; version="1"
|
||||||
|
|
||||||
|
prop: test-suite = bind9
|
||||||
|
|
||||||
|
tp: lib
|
||||||
@@ -1,79 +0,0 @@
|
|||||||
CODE OF CONDUCT
|
|
||||||
|
|
||||||
BIND 9 Code of Conduct
|
|
||||||
|
|
||||||
Like the technical community as a whole, the BIND 9 team and community is
|
|
||||||
made up of a mixture of professionals and volunteers from all over the
|
|
||||||
world, working on every aspect of the mission - including mentorship,
|
|
||||||
teaching, and connecting people.
|
|
||||||
|
|
||||||
Diversity is one of our huge strengths, but it can also lead to
|
|
||||||
communication issues and unhappiness. To that end, we have a few ground
|
|
||||||
rules that we ask people to adhere to. This code applies equally to the
|
|
||||||
core development team, open source contributors and those seeking help and
|
|
||||||
guidance.
|
|
||||||
|
|
||||||
This isn't an exhaustive list of things that you can't do. Rather, take it
|
|
||||||
in the spirit in which it's intended - a guide to make it easier to enrich
|
|
||||||
all of us and the technical communities in which we participate.
|
|
||||||
|
|
||||||
This code of conduct applies to all spaces managed by the BIND 9 project
|
|
||||||
or Internet Systems Consortium. This includes chat, the mailing lists, the
|
|
||||||
issue tracker, and any other fora created by the project team which the
|
|
||||||
community uses for communication. In addition, violations of this code
|
|
||||||
outside these spaces may affect a person's ability to participate within
|
|
||||||
them.
|
|
||||||
|
|
||||||
If you believe someone is violating the code of conduct, we ask that you
|
|
||||||
report it by emailing conduct@isc.org. For more details please see our
|
|
||||||
Reporting Guidelines.
|
|
||||||
|
|
||||||
* Be friendly and patient.
|
|
||||||
* Be welcoming. We strive to be a community that welcomes and supports
|
|
||||||
people of all backgrounds and identities. This includes, but is not
|
|
||||||
limited to members of any race, ethnicity, culture, national origin,
|
|
||||||
colour, immigration status, social and economic class, educational
|
|
||||||
level, sex, sexual orientation, gender identity and expression, age,
|
|
||||||
size, family status, political belief, religion, and mental and
|
|
||||||
physical ability.
|
|
||||||
* Be considerate. Your work will be used by other people, and you in
|
|
||||||
turn will depend on the work of others. Any decision you take will
|
|
||||||
affect users and colleagues, and you should take those consequences
|
|
||||||
into account when making decisions. Remember that we're a world-wide
|
|
||||||
community, so you might not be communicating in someone else's primary
|
|
||||||
language.
|
|
||||||
* Be respectful. Not all of us will agree all the time, but disagreement
|
|
||||||
is no excuse for poor behavior and poor manners. We might all
|
|
||||||
experience some frustration now and then, but we cannot allow that
|
|
||||||
frustration to turn into a personal attack. It's important to remember
|
|
||||||
that a community where people feel uncomfortable or threatened is not
|
|
||||||
a productive one. Members of the BIND 9 community should be respectful
|
|
||||||
when dealing with other members as well as with people outside the
|
|
||||||
BIND 9 community.
|
|
||||||
* Be careful in the words that you choose. We are a community of
|
|
||||||
professionals, and we conduct ourselves professionally. Be kind to
|
|
||||||
others. Do not insult or put down other participants. Harassment and
|
|
||||||
other exclusionary behavior aren't acceptable. This includes, but is
|
|
||||||
not limited to:
|
|
||||||
+ Violent threats or language directed against another person.
|
|
||||||
+ Discriminatory jokes and language.
|
|
||||||
+ Posting sexually explicit or violent material.
|
|
||||||
+ Posting (or threatening to post) other people's personally
|
|
||||||
identifying information ("doxing").
|
|
||||||
+ Personal insults, especially those using racist or sexist terms.
|
|
||||||
+ Unwelcome sexual attention.
|
|
||||||
+ Advocating for, or encouraging, any of the above behavior.
|
|
||||||
+ Repeated harassment of others. In general, if someone asks you to
|
|
||||||
stop, then stop.
|
|
||||||
* When we disagree, try to understand why. Disagreements, both social
|
|
||||||
and technical, happen all the time and BIND 9 is no exception. It is
|
|
||||||
important that we resolve disagreements and differing views
|
|
||||||
constructively. Remember that we're different. The strength of BIND 9
|
|
||||||
comes from its varied community, people from a wide range of
|
|
||||||
backgrounds. Different people have different perspectives on issues.
|
|
||||||
Being unable to understand why someone holds a viewpoint doesn't mean
|
|
||||||
that they're wrong. Don't forget that it is human to err and blaming
|
|
||||||
each other doesn't get us anywhere. Instead, focus on helping to
|
|
||||||
resolve issues and learning from mistakes.
|
|
||||||
|
|
||||||
Original text courtesy of the Django Code of Conduct project.
|
|
||||||
@@ -1,71 +0,0 @@
|
|||||||
# BIND 9 Code of Conduct
|
|
||||||
|
|
||||||
Like the technical community as a whole, the BIND 9 team and community is made
|
|
||||||
up of a mixture of professionals and volunteers from all over the world, working
|
|
||||||
on every aspect of the mission - including mentorship, teaching, and connecting
|
|
||||||
people.
|
|
||||||
|
|
||||||
Diversity is one of our huge strengths, but it can also lead to communication
|
|
||||||
issues and unhappiness. To that end, we have a few ground rules that we ask
|
|
||||||
people to adhere to. This code applies equally to the core development team, open source contributors and those
|
|
||||||
seeking help and guidance.
|
|
||||||
|
|
||||||
This isn't an exhaustive list of things that you can't do. Rather, take it in
|
|
||||||
the spirit in which it's intended - a guide to make it easier to enrich all of
|
|
||||||
us and the technical communities in which we participate.
|
|
||||||
|
|
||||||
This code of conduct applies to all spaces managed by the BIND 9 project or
|
|
||||||
Internet Systems Consortium. This includes chat, the mailing lists, the issue
|
|
||||||
tracker, and any other fora created by the project team which the
|
|
||||||
community uses for communication. In addition, violations of this code outside
|
|
||||||
these spaces may affect a person's ability to participate within them.
|
|
||||||
|
|
||||||
If you believe someone is violating the code of conduct, we ask that you report
|
|
||||||
it by emailing [conduct@isc.org](conduct@isc.org). For more details please see
|
|
||||||
our [Reporting Guidelines](https://www.isc.org/conductreporting/).
|
|
||||||
|
|
||||||
* **Be friendly and patient.**
|
|
||||||
* **Be welcoming.** We strive to be a community that welcomes and supports
|
|
||||||
people of all backgrounds and identities. This includes, but is not limited to
|
|
||||||
members of any race, ethnicity, culture, national origin, colour, immigration
|
|
||||||
status, social and economic class, educational level, sex, sexual orientation,
|
|
||||||
gender identity and expression, age, size, family status, political belief,
|
|
||||||
religion, and mental and physical ability.
|
|
||||||
* **Be considerate.** Your work will be used by other people, and you in turn
|
|
||||||
will depend on the work of others. Any decision you take will affect users and
|
|
||||||
colleagues, and you should take those consequences into account when making
|
|
||||||
decisions. Remember that we're a world-wide community, so you might not be
|
|
||||||
communicating in someone else's primary language.
|
|
||||||
* **Be respectful.** Not all of us will agree all the time, but disagreement is
|
|
||||||
no excuse for poor behavior and poor manners. We might all experience some
|
|
||||||
frustration now and then, but we cannot allow that frustration to turn into a
|
|
||||||
personal attack. It's important to remember that a community where people feel
|
|
||||||
uncomfortable or threatened is not a productive one. Members of the BIND 9
|
|
||||||
community should be respectful when dealing with other members as well as with
|
|
||||||
people outside the BIND 9 community.
|
|
||||||
* **Be careful in the words that you choose.** We are a community of
|
|
||||||
professionals, and we conduct ourselves professionally. Be kind to others. Do
|
|
||||||
not insult or put down other participants. Harassment and other exclusionary
|
|
||||||
behavior aren't acceptable. This includes, but is not limited to:
|
|
||||||
* Violent threats or language directed against another person.
|
|
||||||
* Discriminatory jokes and language.
|
|
||||||
* Posting sexually explicit or violent material.
|
|
||||||
* Posting (or threatening to post) other people's personally identifying
|
|
||||||
information ("doxing").
|
|
||||||
* Personal insults, especially those using racist or sexist terms.
|
|
||||||
* Unwelcome sexual attention.
|
|
||||||
* Advocating for, or encouraging, any of the above behavior.
|
|
||||||
* Repeated harassment of others. In general, if someone asks you to stop, then
|
|
||||||
stop.
|
|
||||||
* **When we disagree, try to understand why.** Disagreements, both social and
|
|
||||||
technical, happen all the time and BIND 9 is no exception. It is important
|
|
||||||
that we resolve disagreements and differing views constructively. Remember
|
|
||||||
that we're different. The strength of BIND 9 comes from its varied community,
|
|
||||||
people from a wide range of backgrounds. Different people have different
|
|
||||||
perspectives on issues. Being unable to understand why someone holds a
|
|
||||||
viewpoint doesn't mean that they're wrong. Don't forget that it is human to
|
|
||||||
err and blaming each other doesn't get us anywhere. Instead, focus on helping
|
|
||||||
to resolve issues and learning from mistakes.
|
|
||||||
|
|
||||||
Original text courtesy of the [Django Code of Conduct](https://www.djangoproject.com/conduct/)
|
|
||||||
project.
|
|
||||||
@@ -1,5 +1,3 @@
|
|||||||
CONTRIBUTING
|
|
||||||
|
|
||||||
BIND Source Access and Contributor Guidelines
|
BIND Source Access and Contributor Guidelines
|
||||||
|
|
||||||
Feb 22, 2018
|
Feb 22, 2018
|
||||||
@@ -34,14 +32,6 @@ access to the source repository was restricted just as commit access was.
|
|||||||
That's now changing, with the opening of a public git mirror to the BIND
|
That's now changing, with the opening of a public git mirror to the BIND
|
||||||
source tree (see below).
|
source tree (see below).
|
||||||
|
|
||||||
At Internet Systems Consortium, we're committed to building communities
|
|
||||||
that are welcoming and inclusive; environments where people are encouraged
|
|
||||||
to share ideas, treat each other with respect, and collaborate towards the
|
|
||||||
best solutions. To reinforce our commitment, the Internet Systems
|
|
||||||
Consortium has adopted the Contributor Covenant version 1.4 as our Code of
|
|
||||||
Conduct for BIND 9 project, as well as for the conduct of our developers
|
|
||||||
throughout the industry.
|
|
||||||
|
|
||||||
Access to source code
|
Access to source code
|
||||||
|
|
||||||
Public BIND releases are always available from the ISC FTP site.
|
Public BIND releases are always available from the ISC FTP site.
|
||||||
|
|||||||
+1
-9
@@ -41,14 +41,6 @@ a release: read access to the source repository was restricted just
|
|||||||
as commit access was. That's now changing, with the opening of a
|
as commit access was. That's now changing, with the opening of a
|
||||||
public git mirror to the BIND source tree (see below).
|
public git mirror to the BIND source tree (see below).
|
||||||
|
|
||||||
At [Internet Systems Consortium](https://www.isc.org), we're committed to
|
|
||||||
building communities that are welcoming and inclusive; environments where people
|
|
||||||
are encouraged to share ideas, treat each other with respect, and collaborate
|
|
||||||
towards the best solutions. To reinforce our commitment, the [Internet Systems
|
|
||||||
Consortium](https://www.isc.org) has adopted the Contributor Covenant version
|
|
||||||
1.4 as our Code of Conduct for BIND 9 project, as well as for the conduct of our
|
|
||||||
developers throughout the industry.
|
|
||||||
|
|
||||||
### <a name="access"></a>Access to source code
|
### <a name="access"></a>Access to source code
|
||||||
|
|
||||||
Public BIND releases are always available from the
|
Public BIND releases are always available from the
|
||||||
@@ -116,7 +108,7 @@ ISC's Security Vulnerability Disclosure Policy is documented at [https://kb.isc.
|
|||||||
If you have a crash, you may want to consult
|
If you have a crash, you may want to consult
|
||||||
[‘What to do if your BIND or DHCP server has crashed.’](https://kb.isc.org/article/AA-00340/89/What-to-do-if-your-BIND-or-DHCP-server-has-crashed.html)
|
[‘What to do if your BIND or DHCP server has crashed.’](https://kb.isc.org/article/AA-00340/89/What-to-do-if-your-BIND-or-DHCP-server-has-crashed.html)
|
||||||
|
|
||||||
### <a name="contrib"></a>Contributing code
|
### <a name="bugs"></a>Contributing code
|
||||||
|
|
||||||
BIND is licensed under the
|
BIND is licensed under the
|
||||||
[Mozilla Public License 2.0](http://www.isc.org/downloads/software-support-policy/isc-license/).
|
[Mozilla Public License 2.0](http://www.isc.org/downloads/software-support-policy/isc-license/).
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
Copyright (C) 1996-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright (C) 1996-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
|
|
||||||
This Source Code Form is subject to the terms of the Mozilla Public
|
This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
License, v. 2.0. If a copy of the MPL was not distributed with this
|
License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -181,6 +181,67 @@ SUCH DAMAGE.
|
|||||||
|
|
||||||
-----------------------------------------------------------------------------
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Copyright (c) 1998 Doug Rabson
|
||||||
|
All rights reserved.
|
||||||
|
|
||||||
|
Redistribution and use in source and binary forms, with or without
|
||||||
|
modification, are permitted provided that the following conditions
|
||||||
|
are met:
|
||||||
|
1. Redistributions of source code must retain the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer.
|
||||||
|
2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer in the
|
||||||
|
documentation and/or other materials provided with the distribution.
|
||||||
|
|
||||||
|
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
||||||
|
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
||||||
|
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||||
|
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||||
|
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||||
|
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||||
|
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||||
|
SUCH DAMAGE.
|
||||||
|
|
||||||
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Copyright ((c)) 2002, Rice University
|
||||||
|
All rights reserved.
|
||||||
|
|
||||||
|
Redistribution and use in source and binary forms, with or without
|
||||||
|
modification, are permitted provided that the following conditions are
|
||||||
|
met:
|
||||||
|
|
||||||
|
* Redistributions of source code must retain the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer.
|
||||||
|
|
||||||
|
* Redistributions in binary form must reproduce the above
|
||||||
|
copyright notice, this list of conditions and the following
|
||||||
|
disclaimer in the documentation and/or other materials provided
|
||||||
|
with the distribution.
|
||||||
|
|
||||||
|
* Neither the name of Rice University (RICE) nor the names of its
|
||||||
|
contributors may be used to endorse or promote products derived
|
||||||
|
from this software without specific prior written permission.
|
||||||
|
|
||||||
|
|
||||||
|
This software is provided by RICE and the contributors on an "as is"
|
||||||
|
basis, without any representations or warranties of any kind, express
|
||||||
|
or implied including, but not limited to, representations or
|
||||||
|
warranties of non-infringement, merchantability or fitness for a
|
||||||
|
particular purpose. In no event shall RICE or contributors be liable
|
||||||
|
for any direct, indirect, incidental, special, exemplary, or
|
||||||
|
consequential damages (including, but not limited to, procurement of
|
||||||
|
substitute goods or services; loss of use, data, or profits; or
|
||||||
|
business interruption) however caused and on any theory of liability,
|
||||||
|
whether in contract, strict liability, or tort (including negligence
|
||||||
|
or otherwise) arising in any way out of the use of this software, even
|
||||||
|
if advised of the possibility of such damage.
|
||||||
|
|
||||||
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
Copyright (c) 1993 by Digital Equipment Corporation.
|
Copyright (c) 1993 by Digital Equipment Corporation.
|
||||||
|
|
||||||
Permission to use, copy, modify, and distribute this software for any
|
Permission to use, copy, modify, and distribute this software for any
|
||||||
@@ -201,6 +262,61 @@ SOFTWARE.
|
|||||||
|
|
||||||
-----------------------------------------------------------------------------
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Copyright 2000 Aaron D. Gifford. All rights reserved.
|
||||||
|
|
||||||
|
Redistribution and use in source and binary forms, with or without
|
||||||
|
modification, are permitted provided that the following conditions
|
||||||
|
are met:
|
||||||
|
1. Redistributions of source code must retain the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer.
|
||||||
|
2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer in the
|
||||||
|
documentation and/or other materials provided with the distribution.
|
||||||
|
3. Neither the name of the copyright holder nor the names of contributors
|
||||||
|
may be used to endorse or promote products derived from this software
|
||||||
|
without specific prior written permission.
|
||||||
|
|
||||||
|
THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) AND CONTRIBUTOR(S) ``AS IS'' AND
|
||||||
|
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) OR CONTRIBUTOR(S) BE LIABLE
|
||||||
|
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||||
|
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||||
|
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||||
|
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||||
|
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||||
|
SUCH DAMAGE.
|
||||||
|
|
||||||
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Copyright (c) 1998 Doug Rabson.
|
||||||
|
Copyright (c) 2001 Jake Burkholder.
|
||||||
|
All rights reserved.
|
||||||
|
|
||||||
|
Redistribution and use in source and binary forms, with or without
|
||||||
|
modification, are permitted provided that the following conditions
|
||||||
|
are met:
|
||||||
|
1. Redistributions of source code must retain the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer.
|
||||||
|
2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer in the
|
||||||
|
documentation and/or other materials provided with the distribution.
|
||||||
|
|
||||||
|
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
||||||
|
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
||||||
|
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||||
|
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||||
|
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||||
|
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||||
|
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||||
|
SUCH DAMAGE.
|
||||||
|
|
||||||
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
|
Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
|
||||||
All rights reserved.
|
All rights reserved.
|
||||||
|
|
||||||
@@ -247,6 +363,49 @@ SOFTWARE.
|
|||||||
|
|
||||||
-----------------------------------------------------------------------------
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Copyright (c) 2000-2002 Japan Network Information Center. All rights reserved.
|
||||||
|
|
||||||
|
By using this file, you agree to the terms and conditions set forth bellow.
|
||||||
|
|
||||||
|
LICENSE TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
The following License Terms and Conditions apply, unless a different
|
||||||
|
license is obtained from Japan Network Information Center ("JPNIC"),
|
||||||
|
a Japanese association, Kokusai-Kougyou-Kanda Bldg 6F, 2-3-4 Uchi-Kanda,
|
||||||
|
Chiyoda-ku, Tokyo 101-0047, Japan.
|
||||||
|
|
||||||
|
1. Use, Modification and Redistribution (including distribution of any
|
||||||
|
modified or derived work) in source and/or binary forms is permitted
|
||||||
|
under this License Terms and Conditions.
|
||||||
|
|
||||||
|
2. Redistribution of source code must retain the copyright notices as they
|
||||||
|
appear in each source code file, this License Terms and Conditions.
|
||||||
|
|
||||||
|
3. Redistribution in binary form must reproduce the Copyright Notice,
|
||||||
|
this License Terms and Conditions, in the documentation and/or other
|
||||||
|
materials provided with the distribution. For the purposes of binary
|
||||||
|
distribution the "Copyright Notice" refers to the following language:
|
||||||
|
"Copyright (c) 2000-2002 Japan Network Information Center. All rights
|
||||||
|
reserved."
|
||||||
|
|
||||||
|
4. The name of JPNIC may not be used to endorse or promote products
|
||||||
|
derived from this Software without specific prior written approval of
|
||||||
|
JPNIC.
|
||||||
|
|
||||||
|
5. Disclaimer/Limitation of Liability: THIS SOFTWARE IS PROVIDED BY JPNIC
|
||||||
|
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||||||
|
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
|
||||||
|
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JPNIC BE LIABLE
|
||||||
|
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||||
|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||||
|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
|
||||||
|
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
||||||
|
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
||||||
|
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
||||||
|
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
||||||
|
|
||||||
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
Copyright (C) 2004 Nominet, Ltd.
|
Copyright (C) 2004 Nominet, Ltd.
|
||||||
|
|
||||||
Permission to use, copy, modify, and distribute this software for any
|
Permission to use, copy, modify, and distribute this software for any
|
||||||
@@ -263,6 +422,24 @@ PERFORMANCE OF THIS SOFTWARE.
|
|||||||
|
|
||||||
-----------------------------------------------------------------------------
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Portions Copyright RSA Security Inc.
|
||||||
|
|
||||||
|
License to copy and use this software is granted provided that it is
|
||||||
|
identified as "RSA Security Inc. PKCS #11 Cryptographic Token Interface
|
||||||
|
(Cryptoki)" in all material mentioning or referencing this software.
|
||||||
|
|
||||||
|
License is also granted to make and use derivative works provided that
|
||||||
|
such works are identified as "derived from the RSA Security Inc. PKCS #11
|
||||||
|
Cryptographic Token Interface (Cryptoki)" in all material mentioning or
|
||||||
|
referencing the derived work.
|
||||||
|
|
||||||
|
RSA Security Inc. makes no representations concerning either the
|
||||||
|
merchantability of this software or the suitability of this software for
|
||||||
|
any particular purpose. It is provided "as is" without express or implied
|
||||||
|
warranty of any kind.
|
||||||
|
|
||||||
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
Copyright (c) 1996, David Mazieres <dm@uun.org>
|
Copyright (c) 1996, David Mazieres <dm@uun.org>
|
||||||
Copyright (c) 2008, Damien Miller <djm@openbsd.org>
|
Copyright (c) 2008, Damien Miller <djm@openbsd.org>
|
||||||
|
|
||||||
@@ -280,6 +457,54 @@ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|||||||
|
|
||||||
-----------------------------------------------------------------------------
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Copyright (c) 2000-2001 The OpenSSL Project. All rights reserved.
|
||||||
|
|
||||||
|
Redistribution and use in source and binary forms, with or without
|
||||||
|
modification, are permitted provided that the following conditions
|
||||||
|
are met:
|
||||||
|
|
||||||
|
1. Redistributions of source code must retain the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer.
|
||||||
|
|
||||||
|
2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer in
|
||||||
|
the documentation and/or other materials provided with the
|
||||||
|
distribution.
|
||||||
|
|
||||||
|
3. All advertising materials mentioning features or use of this
|
||||||
|
software must display the following acknowledgment:
|
||||||
|
"This product includes software developed by the OpenSSL Project
|
||||||
|
for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
|
||||||
|
|
||||||
|
4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
|
||||||
|
endorse or promote products derived from this software without
|
||||||
|
prior written permission. For written permission, please contact
|
||||||
|
licensing@OpenSSL.org.
|
||||||
|
|
||||||
|
5. Products derived from this software may not be called "OpenSSL"
|
||||||
|
nor may "OpenSSL" appear in their names without prior written
|
||||||
|
permission of the OpenSSL Project.
|
||||||
|
|
||||||
|
6. Redistributions of any form whatsoever must retain the following
|
||||||
|
acknowledgment:
|
||||||
|
"This product includes software developed by the OpenSSL Project
|
||||||
|
for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
|
||||||
|
|
||||||
|
THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
|
||||||
|
EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
|
||||||
|
ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
||||||
|
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
||||||
|
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
||||||
|
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||||
|
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||||
|
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||||
|
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
|
||||||
|
OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
|
||||||
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
Copyright (c) 1995, 1997, 1998 The NetBSD Foundation, Inc.
|
Copyright (c) 1995, 1997, 1998 The NetBSD Foundation, Inc.
|
||||||
All rights reserved.
|
All rights reserved.
|
||||||
|
|
||||||
|
|||||||
@@ -1,81 +1,5 @@
|
|||||||
HISTORY
|
|
||||||
|
|
||||||
Functional enhancements from prior major releases of BIND 9
|
Functional enhancements from prior major releases of BIND 9
|
||||||
|
|
||||||
BIND 9.14
|
|
||||||
|
|
||||||
BIND 9.14 (a stable branch based on the 9.13 development branch) includes
|
|
||||||
a number of changes from BIND 9.12 and earlier releases. New features
|
|
||||||
include:
|
|
||||||
|
|
||||||
* A new "plugin" mechanism has been added to allow query functionality
|
|
||||||
to be extended using dynamically loadable libraries. The "filter-aaaa"
|
|
||||||
feature has been removed from named and is now implemented as a
|
|
||||||
plugin.
|
|
||||||
* Socket and task code has been refactored to improve performance.
|
|
||||||
* QNAME minimization, as described in RFC 7816, is now supported.
|
|
||||||
* "Root key sentinel" support, enabling validating resolvers to indicate
|
|
||||||
via a special query which trust anchors are configured for the root
|
|
||||||
zone.
|
|
||||||
* Secondary zones can now be configured as "mirror" zones; their
|
|
||||||
contents are transferred in as with traditional slave zones, but are
|
|
||||||
subject to DNSSEC validation and are not treated as authoritative data
|
|
||||||
when answering. This makes it easier to configure a local copy of the
|
|
||||||
root zone as described in RFC 7706.
|
|
||||||
* The "validate-except" option allows configuration of domains below
|
|
||||||
which DNSSEC validation should not be performed.
|
|
||||||
* The default value of "dnssec-validation" is now "auto".
|
|
||||||
* IDNA2008 is now supported when linking with libidn2.
|
|
||||||
* "named -V" now outputs the default paths for files used by named and
|
|
||||||
other tools.
|
|
||||||
|
|
||||||
In addition, workarounds that were formerly in place to enable resolution
|
|
||||||
of domains whose authoritative servers did not respond to EDNS queries
|
|
||||||
have been removed. See https://dnsflagday.net for more details.
|
|
||||||
|
|
||||||
Cryptographic support has been modernized. BIND now uses the best
|
|
||||||
available pseudo-random number generator for the platform on which it's
|
|
||||||
built. Very old versions of OpenSSL are no longer supported. Cryptography
|
|
||||||
is now mandatory: building BIND without DNSSEC is no longer supported.
|
|
||||||
|
|
||||||
Special code to support certain legacy operating systems has also been
|
|
||||||
removed; see the file PLATFORMS.md for details of supported platforms. In
|
|
||||||
addition to OpenSSL, BIND now requires support for IPv6, threads, and
|
|
||||||
standard atomic operations provided by the C compiler.
|
|
||||||
|
|
||||||
BIND 9.12
|
|
||||||
|
|
||||||
BIND 9.12 includes a number of changes from BIND 9.11 and earlier
|
|
||||||
releases. New features include:
|
|
||||||
|
|
||||||
* named and related libraries have been substantially refactored for
|
|
||||||
improved query performance -- particularly on delegation heavy zones
|
|
||||||
-- and for improved readability, maintainability, and testability.
|
|
||||||
* Code implementing the name server query processing logic has been
|
|
||||||
moved into a new libns library, for easier testing and use in tools
|
|
||||||
other than named.
|
|
||||||
* Cached, validated NSEC and other records can now be used to synthesize
|
|
||||||
NXDOMAIN responses.
|
|
||||||
* The DNS Response Policy Service API (DNSRPS) is now supported.
|
|
||||||
* Setting 'max-journal-size default' now limits the size of journal
|
|
||||||
files to twice the size of the zone.
|
|
||||||
* dnstap-read -x prints a hex dump of the wire format of each logged DNS
|
|
||||||
message.
|
|
||||||
* dnstap output files can now be configured to roll automatically when
|
|
||||||
reaching a given size.
|
|
||||||
* Log file timestamps can now also be formatted in ISO 8601 (local) or
|
|
||||||
ISO 8601 (UTC) formats.
|
|
||||||
* Logging channels and dnstap output files can now be configured to use
|
|
||||||
a timestamp as the suffix when rolling to a new file.
|
|
||||||
* 'named-checkconf -l' lists zones found in named.conf.
|
|
||||||
* Added support for the EDNS Padding and Keepalive options.
|
|
||||||
* 'new-zones-directory' option sets the location where the configuration
|
|
||||||
data for zones added by rndc addzone is stored.
|
|
||||||
* The default key algorithm in rndc-confgen is now hmac-sha256.
|
|
||||||
* filter-aaaa-on-v4 and filter-aaaa-on-v6 options are now available by
|
|
||||||
default without a configure option.
|
|
||||||
* The obsolete isc-hmac-fixup command has been removed.
|
|
||||||
|
|
||||||
BIND 9.11
|
BIND 9.11
|
||||||
|
|
||||||
BIND 9.11.0 includes a number of changes from BIND 9.10 and earlier
|
BIND 9.11.0 includes a number of changes from BIND 9.10 and earlier
|
||||||
@@ -507,11 +431,11 @@ BIND 9.4.0
|
|||||||
* Detect duplicates of UDP queries we are recursing on and drop them.
|
* Detect duplicates of UDP queries we are recursing on and drop them.
|
||||||
New stats category "duplicates".
|
New stats category "duplicates".
|
||||||
* "USE INTERNAL MALLOC" is now runtime selectable.
|
* "USE INTERNAL MALLOC" is now runtime selectable.
|
||||||
* The lame cache is now done on a <qname,qclass,qtype> basis as some
|
* The lame cache is now done on a basis as some servers only appear to
|
||||||
servers only appear to be lame for certain query types.
|
be lame for certain query types.
|
||||||
* Limit the number of recursive clients that can be waiting for a single
|
* Limit the number of recursive clients that can be waiting for a single
|
||||||
query (<qname,qtype,qclass>) to resolve. New options clients-per-query
|
query () to resolve. New options clients-per-query and
|
||||||
and max-clients-per-query.
|
max-clients-per-query.
|
||||||
* dig: report the number of extra bytes still left in the packet after
|
* dig: report the number of extra bytes still left in the packet after
|
||||||
processing all the records.
|
processing all the records.
|
||||||
* Support for IPSECKEY rdata type.
|
* Support for IPSECKEY rdata type.
|
||||||
|
|||||||
+1
-76
@@ -10,81 +10,6 @@
|
|||||||
-->
|
-->
|
||||||
### Functional enhancements from prior major releases of BIND 9
|
### Functional enhancements from prior major releases of BIND 9
|
||||||
|
|
||||||
#### BIND 9.14
|
|
||||||
|
|
||||||
BIND 9.14 (a stable branch based on the 9.13 development branch)
|
|
||||||
includes a number of changes from BIND 9.12 and earlier releases.
|
|
||||||
New features include:
|
|
||||||
|
|
||||||
* A new "plugin" mechanism has been added to allow query functionality
|
|
||||||
to be extended using dynamically loadable libraries. The "filter-aaaa"
|
|
||||||
feature has been removed from named and is now implemented as a plugin.
|
|
||||||
* Socket and task code has been refactored to improve performance.
|
|
||||||
* QNAME minimization, as described in RFC 7816, is now supported.
|
|
||||||
* "Root key sentinel" support, enabling validating resolvers to indicate
|
|
||||||
via a special query which trust anchors are configured for the root zone.
|
|
||||||
* Secondary zones can now be configured as "mirror" zones; their contents
|
|
||||||
are transferred in as with traditional slave zones, but are subject to
|
|
||||||
DNSSEC validation and are not treated as authoritative data when
|
|
||||||
answering. This makes it easier to configure a local copy of the root
|
|
||||||
zone as described in RFC 7706.
|
|
||||||
* The "validate-except" option allows configuration of domains below which
|
|
||||||
DNSSEC validation should not be performed.
|
|
||||||
* The default value of "dnssec-validation" is now "auto".
|
|
||||||
* IDNA2008 is now supported when linking with `libidn2`.
|
|
||||||
* "named -V" now outputs the default paths for files used by named
|
|
||||||
and other tools.
|
|
||||||
|
|
||||||
In addition, workarounds that were formerly in place to enable resolution
|
|
||||||
of domains whose authoritative servers did not respond to EDNS queries
|
|
||||||
have been removed. See [https://dnsflagday.net](https://dnsflagday.net)
|
|
||||||
for more details.
|
|
||||||
|
|
||||||
Cryptographic support has been modernized. BIND now uses the
|
|
||||||
best available pseudo-random number generator for the platform on which
|
|
||||||
it's built. Very old versions of OpenSSL are no longer supported.
|
|
||||||
Cryptography is now mandatory: building BIND without DNSSEC is no
|
|
||||||
longer supported.
|
|
||||||
|
|
||||||
Special code to support certain legacy operating systems has also
|
|
||||||
been removed; see the file [PLATFORMS.md](PLATFORMS.md) for details
|
|
||||||
of supported platforms. In addition to OpenSSL, BIND now requires
|
|
||||||
support for IPv6, threads, and standard atomic operations provided
|
|
||||||
by the C compiler.
|
|
||||||
|
|
||||||
#### BIND 9.12
|
|
||||||
|
|
||||||
BIND 9.12 includes a number of changes from BIND 9.11 and earlier releases.
|
|
||||||
New features include:
|
|
||||||
|
|
||||||
* `named` and related libraries have been substantially refactored for
|
|
||||||
improved query performance -- particularly on delegation heavy zones --
|
|
||||||
and for improved readability, maintainability, and testability.
|
|
||||||
* Code implementing the name server query processing logic has been moved
|
|
||||||
into a new `libns` library, for easier testing and use in tools other
|
|
||||||
than `named`.
|
|
||||||
* Cached, validated NSEC and other records can now be used to synthesize
|
|
||||||
NXDOMAIN responses.
|
|
||||||
* The DNS Response Policy Service API (DNSRPS) is now supported.
|
|
||||||
* Setting `'max-journal-size default'` now limits the size of journal files
|
|
||||||
to twice the size of the zone.
|
|
||||||
* `dnstap-read -x` prints a hex dump of the wire format of each logged
|
|
||||||
DNS message.
|
|
||||||
* `dnstap` output files can now be configured to roll automatically when
|
|
||||||
reaching a given size.
|
|
||||||
* Log file timestamps can now also be formatted in ISO 8601 (local) or ISO
|
|
||||||
8601 (UTC) formats.
|
|
||||||
* Logging channels and `dnstap` output files can now be configured to use a
|
|
||||||
timestamp as the suffix when rolling to a new file.
|
|
||||||
* `'named-checkconf -l'` lists zones found in `named.conf`.
|
|
||||||
* Added support for the EDNS Padding and Keepalive options.
|
|
||||||
* 'new-zones-directory' option sets the location where the configuration
|
|
||||||
data for zones added by rndc addzone is stored.
|
|
||||||
* The default key algorithm in `rndc-confgen` is now hmac-sha256.
|
|
||||||
* `filter-aaaa-on-v4` and `filter-aaaa-on-v6` options are now available
|
|
||||||
by default without a configure option.
|
|
||||||
* The obsolete `isc-hmac-fixup` command has been removed.
|
|
||||||
|
|
||||||
#### BIND 9.11
|
#### BIND 9.11
|
||||||
|
|
||||||
BIND 9.11.0 includes a number of changes from BIND 9.10 and earlier
|
BIND 9.11.0 includes a number of changes from BIND 9.10 and earlier
|
||||||
@@ -150,7 +75,7 @@ releases. New features include:
|
|||||||
- "rndc modzone" reconfigures a single zone, without requiring the entire
|
- "rndc modzone" reconfigures a single zone, without requiring the entire
|
||||||
server to be reconfigured.
|
server to be reconfigured.
|
||||||
- "rndc showzone" displays the current configuration of a zone.
|
- "rndc showzone" displays the current configuration of a zone.
|
||||||
- "rndc managed-keys" can be used to check the status of RFC 5011 managed
|
- "rndc managed-keys" can be used to check the status of RFC 5001 managed
|
||||||
trust anchors, or to force trust anchors to be refreshed.
|
trust anchors, or to force trust anchors to be refreshed.
|
||||||
- "max-cache-size" can now be set to a percentage of available memory. The
|
- "max-cache-size" can now be set to a percentage of available memory. The
|
||||||
default is 90%.
|
default is 90%.
|
||||||
|
|||||||
+27
-14
@@ -14,11 +14,15 @@ top_builddir = @top_builddir@
|
|||||||
|
|
||||||
VERSION=@BIND9_VERSION@
|
VERSION=@BIND9_VERSION@
|
||||||
|
|
||||||
SUBDIRS = make lib fuzz bin doc
|
SUBDIRS = make unit lib fuzz bin doc
|
||||||
TARGETS =
|
TARGETS =
|
||||||
PREREQS = bind.keys.h
|
PREREQS = bind.keys.h
|
||||||
|
|
||||||
MANOBJS = README HISTORY OPTIONS CONTRIBUTING PLATFORMS CODE_OF_CONDUCT \
|
MANPAGES = isc-config.sh.1
|
||||||
|
|
||||||
|
HTMLPAGES = isc-config.sh.html
|
||||||
|
|
||||||
|
MANOBJS = README HISTORY OPTIONS CONTRIBUTING PLATFORMS \
|
||||||
${MANPAGES} ${HTMLPAGES}
|
${MANPAGES} ${HTMLPAGES}
|
||||||
|
|
||||||
@BIND9_MAKE_RULES@
|
@BIND9_MAKE_RULES@
|
||||||
@@ -31,7 +35,7 @@ bind.keys.h: ${top_srcdir}/bind.keys ${srcdir}/util/bindkeys.pl
|
|||||||
|
|
||||||
distclean::
|
distclean::
|
||||||
rm -f config.cache config.h config.log config.status TAGS
|
rm -f config.cache config.h config.log config.status TAGS
|
||||||
rm -f libtool configure.lineno
|
rm -f libtool isc-config.sh configure.lineno
|
||||||
rm -f util/conf.sh docutil/docbook2man-wrapper.sh
|
rm -f util/conf.sh docutil/docbook2man-wrapper.sh
|
||||||
|
|
||||||
# XXX we should clean libtool stuff too. Only do this after we add rules
|
# XXX we should clean libtool stuff too. Only do this after we add rules
|
||||||
@@ -50,11 +54,25 @@ installdirs:
|
|||||||
${DESTDIR}${localstatedir}/run ${DESTDIR}${sysconfdir}
|
${DESTDIR}${localstatedir}/run ${DESTDIR}${sysconfdir}
|
||||||
$(SHELL) ${top_srcdir}/mkinstalldirs ${DESTDIR}${mandir}/man1
|
$(SHELL) ${top_srcdir}/mkinstalldirs ${DESTDIR}${mandir}/man1
|
||||||
|
|
||||||
install:: installdirs
|
install:: isc-config.sh installdirs
|
||||||
|
${INSTALL_SCRIPT} isc-config.sh ${DESTDIR}${bindir}
|
||||||
|
rm -f ${DESTDIR}${bindir}/bind9-config
|
||||||
|
@LN@ ${DESTDIR}${bindir}/isc-config.sh ${DESTDIR}${bindir}/bind9-config
|
||||||
|
${INSTALL_DATA} ${top_srcdir}/isc-config.sh.1 ${DESTDIR}${mandir}/man1
|
||||||
|
rm -f ${DESTDIR}${mandir}/man1/bind9-config.1
|
||||||
|
@LN@ ${DESTDIR}${mandir}/man1/isc-config.sh.1 ${DESTDIR}${mandir}/man1/bind9-config.1
|
||||||
${INSTALL_DATA} ${top_srcdir}/bind.keys ${DESTDIR}${sysconfdir}
|
${INSTALL_DATA} ${top_srcdir}/bind.keys ${DESTDIR}${sysconfdir}
|
||||||
|
|
||||||
uninstall::
|
uninstall::
|
||||||
rm -f ${DESTDIR}${sysconfdir}/bind.keys
|
rm -f ${DESTDIR}${sysconfdir}/bind.keys
|
||||||
|
rm -f ${DESTDIR}${mandir}/man1/bind9-config.1
|
||||||
|
rm -f ${DESTDIR}${mandir}/man1/isc-config.sh.1
|
||||||
|
rm -f ${DESTDIR}${bindir}/bind9-config
|
||||||
|
rm -f ${DESTDIR}${bindir}/isc-config.sh
|
||||||
|
|
||||||
|
tags:
|
||||||
|
rm -f TAGS
|
||||||
|
find lib bin -name "*.[ch]" -print | @ETAGS@ -
|
||||||
|
|
||||||
test check:
|
test check:
|
||||||
@if test -n "`${PERL} ${top_srcdir}/bin/tests/system/testsock.pl 2>/dev/null || echo fail`"; then \
|
@if test -n "`${PERL} ${top_srcdir}/bin/tests/system/testsock.pl 2>/dev/null || echo fail`"; then \
|
||||||
@@ -79,32 +97,27 @@ test-force:
|
|||||||
exit $$status
|
exit $$status
|
||||||
|
|
||||||
README: README.md
|
README: README.md
|
||||||
${PANDOC} --email-obfuscation=none -s --metadata title="README" -f markdown-smart -t html README.md | \
|
${PANDOC} --email-obfuscation=none -s -t html README.md | \
|
||||||
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
||||||
sed -e '$${/^$$/d;}' > $@
|
sed -e '$${/^$$/d;}' > $@
|
||||||
|
|
||||||
HISTORY: HISTORY.md
|
HISTORY: HISTORY.md
|
||||||
${PANDOC} --email-obfuscation=none -s --metadata title="HISTORY" -f markdown-smart -t html HISTORY.md | \
|
${PANDOC} --email-obfuscation=none -s -t html HISTORY.md | \
|
||||||
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
||||||
sed -e '$${/^$$/d;}' > $@
|
sed -e '$${/^$$/d;}' > $@
|
||||||
|
|
||||||
OPTIONS: OPTIONS.md
|
OPTIONS: OPTIONS.md
|
||||||
${PANDOC} --email-obfuscation=none -s --metadata title="OPTIONS" -f markdown-smart -t html OPTIONS.md | \
|
${PANDOC} --email-obfuscation=none -s -t html OPTIONS.md | \
|
||||||
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
||||||
sed -e '$${/^$$/d;}' > $@
|
sed -e '$${/^$$/d;}' > $@
|
||||||
|
|
||||||
CONTRIBUTING: CONTRIBUTING.md
|
CONTRIBUTING: CONTRIBUTING.md
|
||||||
${PANDOC} --email-obfuscation=none -s --metadata title="CONTRIBUTING" -f markdown-smart -t html CONTRIBUTING.md | \
|
${PANDOC} --email-obfuscation=none -s -t html CONTRIBUTING.md | \
|
||||||
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
||||||
sed -e '$${/^$$/d;}' > $@
|
sed -e '$${/^$$/d;}' > $@
|
||||||
|
|
||||||
PLATFORMS: PLATFORMS.md
|
PLATFORMS: PLATFORMS.md
|
||||||
${PANDOC} --email-obfuscation=none -s --metadata title="PLATFORMS" -f markdown-smart -t html PLATFORMS.md | \
|
${PANDOC} --email-obfuscation=none -s -t html PLATFORMS.md | \
|
||||||
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
|
||||||
sed -e '$${/^$$/d;}' > $@
|
|
||||||
|
|
||||||
CODE_OF_CONDUCT: CODE_OF_CONDUCT.md
|
|
||||||
${PANDOC} --email-obfuscation=none -s --metadata title="CODE OF CONDUCT" -f markdown-smart -t html CODE_OF_CONDUCT.md | \
|
|
||||||
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
${W3M} -dump -cols 75 -O ascii -T text/html | \
|
||||||
sed -e '$${/^$$/d;}' > $@
|
sed -e '$${/^$$/d;}' > $@
|
||||||
|
|
||||||
|
|||||||
@@ -1,12 +1,10 @@
|
|||||||
OPTIONS
|
|
||||||
|
|
||||||
Setting the STD_CDEFINES environment variable before running configure can
|
Setting the STD_CDEFINES environment variable before running configure can
|
||||||
be used to enable certain compile-time options that are not explicitly
|
be used to enable certain compile-time options that are not explicitly
|
||||||
defined in configure.
|
defined in configure.
|
||||||
|
|
||||||
Some of these settings are:
|
Some of these settings are:
|
||||||
|
|
||||||
Setting Description
|
Setting Description
|
||||||
Overwrite memory with tag values when allocating
|
Overwrite memory with tag values when allocating
|
||||||
-DISC_MEM_DEFAULTFILL=1 or freeing it; this impairs performance but
|
-DISC_MEM_DEFAULTFILL=1 or freeing it; this impairs performance but
|
||||||
makes debugging of memory problems easier.
|
makes debugging of memory problems easier.
|
||||||
|
|||||||
@@ -1,32 +1,11 @@
|
|||||||
PLATFORMS
|
|
||||||
|
|
||||||
Supported platforms
|
Supported platforms
|
||||||
|
|
||||||
In general, this version of BIND will build and run on any POSIX-compliant
|
In general, this version of BIND will build and run on any POSIX-compliant
|
||||||
system with a C11-compliant C compiler, BSD-style sockets with
|
system with a C99-compliant C compiler, BSD-style sockets with
|
||||||
RFC-compliant IPv6 support, POSIX-compliant threads, the libuv
|
RFC-compliant IPv6 support, POSIX-compliant threads, and the OpenSSL
|
||||||
asynchronous I/O library, and the OpenSSL cryptography library.
|
cryptography library. Atomic operations support from the compiler is
|
||||||
|
needed, either in the form of builtin operations, C11 atomics or the
|
||||||
The following C11 features are used in BIND 9:
|
Interlocked family of functions on Windows.
|
||||||
|
|
||||||
* Atomic operations support from the compiler is needed, either in the
|
|
||||||
form of builtin operations, C11 atomics, or the Interlocked family of
|
|
||||||
functions on Windows.
|
|
||||||
|
|
||||||
* Thread Local Storage support from the compiler is needed, either in
|
|
||||||
the form of C11 _Thread_local/thread_local, the __thread GCC
|
|
||||||
extension, or the __declspec(thread) MSVC extension on Windows.
|
|
||||||
|
|
||||||
BIND 9.15 requires a fairly recent version of libuv (at least 1.x). For
|
|
||||||
some of the older systems listed below, you will have to install an
|
|
||||||
updated libuv package from sources such as EPEL, PPA, or other native
|
|
||||||
sources for updated packages. The other option is to build and install
|
|
||||||
libuv from source.
|
|
||||||
|
|
||||||
Certain optional BIND features have additional library dependencies. These
|
|
||||||
include libxml2 and libjson-c for statistics, libmaxminddb for
|
|
||||||
geolocation, libfstrm and libprotobuf-c for DNSTAP, and libidn2 for
|
|
||||||
internationalized domain name conversion.
|
|
||||||
|
|
||||||
ISC regularly tests BIND on many operating systems and architectures, but
|
ISC regularly tests BIND on many operating systems and architectures, but
|
||||||
lacks the resources to test all of them. Consequently, ISC is only able to
|
lacks the resources to test all of them. Consequently, ISC is only able to
|
||||||
@@ -34,66 +13,49 @@ offer support on a "best effort" basis for some.
|
|||||||
|
|
||||||
Regularly tested platforms
|
Regularly tested platforms
|
||||||
|
|
||||||
As of Dec 2019, BIND 9.15 is fully supported and regularly tested on the
|
As of May 2018, BIND 9.13 is tested on the following systems:
|
||||||
following systems:
|
|
||||||
|
|
||||||
* Debian 9, 10
|
* Debian 8, 9
|
||||||
* Ubuntu LTS 16.04, 18.04
|
* Ubuntu 16.04, 18.04
|
||||||
* Fedora 31
|
* Fedora 27, 28
|
||||||
* Red Hat Enterprise Linux / CentOS 7, 8
|
* Red Hat/CentOS 6, 7
|
||||||
* FreeBSD 11.3, 12.0
|
* FreeBSD 10.x, 11.x
|
||||||
* OpenBSD 6.5
|
* OpenBSD 6.3
|
||||||
* Alpine Linux
|
|
||||||
|
|
||||||
The amd64, i386, armhf and arm64 CPU architectures are all fully
|
The amd64, i386, armhf and arm64 CPU architectures are all fully
|
||||||
supported.
|
supported.
|
||||||
|
|
||||||
Best effort
|
Best effort
|
||||||
|
|
||||||
The following are platforms on which BIND is known to build and run. ISC
|
The following are platforms on which BIND is known to build and run, but
|
||||||
makes every effort to fix bugs on these platforms, but may be unable to do
|
on which it is not routinely tested. ISC makes every effort to fix bugs on
|
||||||
so quickly due to lack of hardware, less familiarity on the part of
|
these platforms, but may be unable to do so quickly due to lack of
|
||||||
engineering staff, and other constraints. With the exception of Windows
|
hardware, less familiarity on the part of engineering staff, and other
|
||||||
Server 2012 R2, none of these are tested regularly by ISC.
|
constraints.
|
||||||
|
|
||||||
* Windows Server 2012 R2, 2016 / x64
|
|
||||||
* Windows 10 / x64
|
* Windows 10 / x64
|
||||||
|
* Windows Server 2012 R2, 2016 / x64
|
||||||
* macOS 10.12+
|
* macOS 10.12+
|
||||||
* Solaris 11
|
* Solaris 10
|
||||||
|
* FreeBSD 12+
|
||||||
|
* OpenBSD 6.2
|
||||||
* NetBSD
|
* NetBSD
|
||||||
* Other Linux distributions still supported by their vendors, such as:
|
* Older or less popular Linux distributions still supported by their
|
||||||
+ Ubuntu 19.04+
|
vendors, such as:
|
||||||
|
+ Ubuntu 14.04, 18.10+
|
||||||
+ Gentoo
|
+ Gentoo
|
||||||
+ Arch Linux
|
+ ArchLinux
|
||||||
* OpenWRT/LEDE 17.01+
|
+ Alpine Linux
|
||||||
|
* OpenWRT/LEDE 17.0
|
||||||
* Other CPU architectures (mips, mipsel, sparc, ...)
|
* Other CPU architectures (mips, mipsel, sparc, ...)
|
||||||
|
|
||||||
Community maintained
|
|
||||||
|
|
||||||
These systems may not all have the required dependencies for building BIND
|
|
||||||
easily available, although it will be possible in many cases to compile
|
|
||||||
those directly from source. The community and interested parties may wish
|
|
||||||
to help with maintenance, and we welcome patch contributions, although we
|
|
||||||
cannot guarantee that we will accept them. All contributions will be
|
|
||||||
assessed against the risk of adverse effect on officially supported
|
|
||||||
platforms.
|
|
||||||
|
|
||||||
* Platforms past or close to their respective EOL dates, such as:
|
|
||||||
+ Ubuntu 14.04, 18.10
|
|
||||||
+ CentOS 6
|
|
||||||
+ Debian Jessie
|
|
||||||
+ FreeBSD 10.x
|
|
||||||
|
|
||||||
Unsupported platforms
|
Unsupported platforms
|
||||||
|
|
||||||
These are platforms on which BIND 9.15 is known not to build or run:
|
These are platforms on which BIND is known not to build or run:
|
||||||
|
|
||||||
* Platforms without at least OpenSSL 1.0.2
|
* Platforms without at least OpenSSL 1.0.2
|
||||||
* Windows 10 / x86
|
* Windows 10 / x86
|
||||||
* Windows Server 2012 and older
|
* Windows Server 2012 and older
|
||||||
* Solaris 10 and older
|
|
||||||
* Platforms that don't support IPv6 Advanced Socket API (RFC 3542)
|
* Platforms that don't support IPv6 Advanced Socket API (RFC 3542)
|
||||||
* Platforms that don't support atomic operations (via compiler or
|
* Platforms that don't support atomic operations (via compiler or
|
||||||
library)
|
library)
|
||||||
* Linux without NPTL (Native POSIX Thread Library)
|
|
||||||
* Platforms on which libuv cannot be compiled
|
|
||||||
|
|||||||
+58
-63
@@ -11,30 +11,11 @@
|
|||||||
## Supported platforms
|
## Supported platforms
|
||||||
|
|
||||||
In general, this version of BIND will build and run on any POSIX-compliant
|
In general, this version of BIND will build and run on any POSIX-compliant
|
||||||
system with a C11-compliant C compiler, BSD-style sockets with RFC-compliant
|
system with a C99-compliant C compiler, BSD-style sockets with RFC-compliant
|
||||||
IPv6 support, POSIX-compliant threads, the `libuv` asynchronous I/O library,
|
IPv6 support, POSIX-compliant threads, and the OpenSSL cryptography library.
|
||||||
and the OpenSSL cryptography library.
|
Atomic operations support from the compiler is needed, either in the form of
|
||||||
|
builtin operations, C11 atomics or the Interlocked family of functions on
|
||||||
The following C11 features are used in BIND 9:
|
Windows.
|
||||||
|
|
||||||
* Atomic operations support from the compiler is needed, either in the form of
|
|
||||||
builtin operations, C11 atomics, or the `Interlocked` family of functions on
|
|
||||||
Windows.
|
|
||||||
|
|
||||||
* Thread Local Storage support from the compiler is needed, either in the form
|
|
||||||
of C11 `_Thread_local`/`thread_local`, the `__thread` GCC extension, or
|
|
||||||
the `__declspec(thread)` MSVC extension on Windows.
|
|
||||||
|
|
||||||
BIND 9.15 requires a fairly recent version of `libuv` (at least 1.x). For
|
|
||||||
some of the older systems listed below, you will have to install an updated
|
|
||||||
`libuv` package from sources such as EPEL, PPA, or other native sources for
|
|
||||||
updated packages. The other option is to build and install `libuv` from
|
|
||||||
source.
|
|
||||||
|
|
||||||
Certain optional BIND features have additional library dependencies.
|
|
||||||
These include `libxml2` and `libjson-c` for statistics, `libmaxminddb` for
|
|
||||||
geolocation, `libfstrm` and `libprotobuf-c` for DNSTAP, and `libidn2` for
|
|
||||||
internationalized domain name conversion.
|
|
||||||
|
|
||||||
ISC regularly tests BIND on many operating systems and architectures, but
|
ISC regularly tests BIND on many operating systems and architectures, but
|
||||||
lacks the resources to test all of them. Consequently, ISC is only able to
|
lacks the resources to test all of them. Consequently, ISC is only able to
|
||||||
@@ -42,64 +23,78 @@ offer support on a "best effort" basis for some.
|
|||||||
|
|
||||||
### Regularly tested platforms
|
### Regularly tested platforms
|
||||||
|
|
||||||
As of Dec 2019, BIND 9.15 is fully supported and regularly tested on the
|
As of May 2018, BIND 9.13 is tested on the following systems:
|
||||||
following systems:
|
|
||||||
|
|
||||||
* Debian 9, 10
|
* Debian 8, 9
|
||||||
* Ubuntu LTS 16.04, 18.04
|
* Ubuntu 16.04, 18.04
|
||||||
* Fedora 31
|
* Fedora 27, 28
|
||||||
* Red Hat Enterprise Linux / CentOS 7, 8
|
* Red Hat/CentOS 6, 7
|
||||||
* FreeBSD 11.3, 12.0
|
* FreeBSD 10.x, 11.x
|
||||||
* OpenBSD 6.5
|
* OpenBSD 6.3
|
||||||
* Alpine Linux
|
|
||||||
|
|
||||||
The amd64, i386, armhf and arm64 CPU architectures are all fully supported.
|
The amd64, i386, armhf and arm64 CPU architectures are all fully supported.
|
||||||
|
|
||||||
### Best effort
|
### Best effort
|
||||||
|
|
||||||
The following are platforms on which BIND is known to build and run.
|
The following are platforms on which BIND is known to build and run,
|
||||||
ISC makes every effort to fix bugs on these platforms, but may be unable to
|
but on which it is not routinely tested. ISC makes every effort to fix bugs
|
||||||
do so quickly due to lack of hardware, less familiarity on the part of
|
on these platforms, but may be unable to do so quickly due to lack of
|
||||||
engineering staff, and other constraints. With the exception of Windows
|
hardware, less familiarity on the part of engineering staff, and other
|
||||||
Server 2012 R2, none of these are tested regularly by ISC.
|
constraints.
|
||||||
|
|
||||||
* Windows Server 2012 R2, 2016 / x64
|
|
||||||
* Windows 10 / x64
|
* Windows 10 / x64
|
||||||
|
* Windows Server 2012 R2, 2016 / x64
|
||||||
* macOS 10.12+
|
* macOS 10.12+
|
||||||
* Solaris 11
|
* Solaris 10
|
||||||
|
* FreeBSD 12+
|
||||||
|
* OpenBSD 6.2
|
||||||
* NetBSD
|
* NetBSD
|
||||||
* Other Linux distributions still supported by their vendors, such as:
|
* Older or less popular Linux distributions still supported by their vendors, such as:
|
||||||
* Ubuntu 19.04+
|
* Ubuntu 14.04, 18.10+
|
||||||
* Gentoo
|
* Gentoo
|
||||||
* Arch Linux
|
* ArchLinux
|
||||||
* OpenWRT/LEDE 17.01+
|
* Alpine Linux
|
||||||
|
* OpenWRT/LEDE 17.0
|
||||||
* Other CPU architectures (mips, mipsel, sparc, ...)
|
* Other CPU architectures (mips, mipsel, sparc, ...)
|
||||||
|
|
||||||
### Community maintained
|
|
||||||
|
|
||||||
These systems may not all have the required dependencies for building BIND
|
|
||||||
easily available, although it will be possible in many cases to compile
|
|
||||||
those directly from source. The community and interested parties may wish
|
|
||||||
to help with maintenance, and we welcome patch contributions, although we
|
|
||||||
cannot guarantee that we will accept them. All contributions will be
|
|
||||||
assessed against the risk of adverse effect on officially supported
|
|
||||||
platforms.
|
|
||||||
|
|
||||||
* Platforms past or close to their respective EOL dates, such as:
|
|
||||||
* Ubuntu 14.04, 18.10
|
|
||||||
* CentOS 6
|
|
||||||
* Debian Jessie
|
|
||||||
* FreeBSD 10.x
|
|
||||||
|
|
||||||
## Unsupported platforms
|
## Unsupported platforms
|
||||||
|
|
||||||
These are platforms on which BIND 9.15 is known *not* to build or run:
|
These are platforms on which BIND is known *not* to build or run:
|
||||||
|
|
||||||
* Platforms without at least OpenSSL 1.0.2
|
* Platforms without at least OpenSSL 1.0.2
|
||||||
* Windows 10 / x86
|
* Windows 10 / x86
|
||||||
* Windows Server 2012 and older
|
* Windows Server 2012 and older
|
||||||
* Solaris 10 and older
|
|
||||||
* Platforms that don't support IPv6 Advanced Socket API (RFC 3542)
|
* Platforms that don't support IPv6 Advanced Socket API (RFC 3542)
|
||||||
* Platforms that don't support atomic operations (via compiler or library)
|
* Platforms that don't support atomic operations (via compiler or library)
|
||||||
* Linux without NPTL (Native POSIX Thread Library)
|
* Linux without NPTL (Native POSIX Thread Library)
|
||||||
* Platforms on which `libuv` cannot be compiled
|
|
||||||
|
## Platform quirks
|
||||||
|
|
||||||
|
### ARM
|
||||||
|
|
||||||
|
If the compilation ends with following error:
|
||||||
|
|
||||||
|
```
|
||||||
|
Error: selected processor does not support `yield' in ARM mode
|
||||||
|
```
|
||||||
|
|
||||||
|
You will need to set `-march` compiler option to `native`, so the compiler
|
||||||
|
recognizes `yield` assembler instruction. The proper way to set `-march=native`
|
||||||
|
would be to put it into `CFLAGS`, e.g. run `./configure` like this:
|
||||||
|
`CFLAGS="-march=native -Os -g" ./configure` plus your usual options.
|
||||||
|
|
||||||
|
If that doesn't work, you can enforce the minimum CPU and FPU (taken from Debian
|
||||||
|
armhf documentation):
|
||||||
|
|
||||||
|
* The lowest worthwhile CPU implementation is Armv7-A, therefore the recommended
|
||||||
|
build option is `-march=armv7-a`.
|
||||||
|
|
||||||
|
* FPU should be set at VFPv3-D16 as they represent the miminum specification of
|
||||||
|
the processors to support here, therefore the recommended build option is
|
||||||
|
`-mfpu=vfpv3-d16`.
|
||||||
|
|
||||||
|
The configure command should look like this:
|
||||||
|
|
||||||
|
```
|
||||||
|
CFLAGS="-march=armv7-a -mfpu=vfpv3-d16 -Os -g" ./configure
|
||||||
|
```
|
||||||
|
|||||||
@@ -1,5 +1,3 @@
|
|||||||
README
|
|
||||||
|
|
||||||
BIND 9
|
BIND 9
|
||||||
|
|
||||||
Contents
|
Contents
|
||||||
@@ -7,15 +5,14 @@ Contents
|
|||||||
1. Introduction
|
1. Introduction
|
||||||
2. Reporting bugs and getting help
|
2. Reporting bugs and getting help
|
||||||
3. Contributing to BIND
|
3. Contributing to BIND
|
||||||
4. BIND 9.15 features
|
4. BIND 9.13 features
|
||||||
5. Building BIND
|
5. Building BIND
|
||||||
6. macOS
|
6. macOS
|
||||||
7. Dependencies
|
7. Compile-time options
|
||||||
8. Compile-time options
|
8. Automated testing
|
||||||
9. Automated testing
|
9. Documentation
|
||||||
10. Documentation
|
10. Change log
|
||||||
11. Change log
|
11. Acknowledgments
|
||||||
12. Acknowledgments
|
|
||||||
|
|
||||||
Introduction
|
Introduction
|
||||||
|
|
||||||
@@ -39,7 +36,7 @@ in versions 4 and 8. Internet Systems Consortium (https://www.isc.org), a
|
|||||||
501(c)(3) public benefit corporation dedicated to providing software and
|
501(c)(3) public benefit corporation dedicated to providing software and
|
||||||
services in support of the Internet infrastructure, developed BIND 9 and
|
services in support of the Internet infrastructure, developed BIND 9 and
|
||||||
is responsible for its ongoing maintenance and improvement. BIND is open
|
is responsible for its ongoing maintenance and improvement. BIND is open
|
||||||
source software licensed under the terms of the Mozilla Public License,
|
source software licenced under the terms of the Mozilla Public License,
|
||||||
version 2.0.
|
version 2.0.
|
||||||
|
|
||||||
For a summary of features introduced in past major releases of BIND, see
|
For a summary of features introduced in past major releases of BIND, see
|
||||||
@@ -48,8 +45,8 @@ the file HISTORY.
|
|||||||
For a detailed list of changes made throughout the history of BIND 9, see
|
For a detailed list of changes made throughout the history of BIND 9, see
|
||||||
the file CHANGES. See below for details on the CHANGES file format.
|
the file CHANGES. See below for details on the CHANGES file format.
|
||||||
|
|
||||||
For up-to-date versions and release notes, see https://www.isc.org/
|
For up-to-date release notes and errata, see http://www.isc.org/software/
|
||||||
download/.
|
bind9/releasenotes
|
||||||
|
|
||||||
For information about supported platforms, see PLATFORMS.
|
For information about supported platforms, see PLATFORMS.
|
||||||
|
|
||||||
@@ -71,9 +68,6 @@ If the bug you are reporting is a potential security issue, such as an
|
|||||||
assertion failure or other crash in named, please do NOT use GitLab to
|
assertion failure or other crash in named, please do NOT use GitLab to
|
||||||
report it. Instead, please send mail to security-officer@isc.org.
|
report it. Instead, please send mail to security-officer@isc.org.
|
||||||
|
|
||||||
For a general overview of ISC security policies, read the Knowledge Base
|
|
||||||
article at https://kb.isc.org/docs/aa-00861.
|
|
||||||
|
|
||||||
Professional support and training for BIND are available from ISC at
|
Professional support and training for BIND are available from ISC at
|
||||||
https://www.isc.org/support.
|
https://www.isc.org/support.
|
||||||
|
|
||||||
@@ -90,11 +84,10 @@ ISC maintains a public git repository for BIND; details can be found at
|
|||||||
http://www.isc.org/git/.
|
http://www.isc.org/git/.
|
||||||
|
|
||||||
Information for BIND contributors can be found in the following files: -
|
Information for BIND contributors can be found in the following files: -
|
||||||
General information: CONTRIBUTING.md - Code of Conduct: CODE_OF_CONDUCT.md
|
General information: CONTRIBUTING.md - BIND 9 code style: doc/dev/style.md
|
||||||
- BIND 9 code style: doc/dev/style.md - BIND architecture and developer
|
- BIND architecture and developer guide: doc/dev/dev.md
|
||||||
guide: doc/dev/dev.md
|
|
||||||
|
|
||||||
Patches for BIND may be submitted as merge requests in the ISC GitLab
|
Patches for BIND may be submitted as Merge Requests in the ISC GitLab
|
||||||
server at at https://gitlab.isc.org/isc-projects/bind9/merge_requests.
|
server at at https://gitlab.isc.org/isc-projects/bind9/merge_requests.
|
||||||
|
|
||||||
By default, external contributors don't have ability to fork BIND in the
|
By default, external contributors don't have ability to fork BIND in the
|
||||||
@@ -106,38 +99,56 @@ If you prefer, you may also submit code by opening a GitLab Issue and
|
|||||||
including your patch as an attachment, preferably generated by git
|
including your patch as an attachment, preferably generated by git
|
||||||
format-patch.
|
format-patch.
|
||||||
|
|
||||||
BIND 9.15 features
|
BIND 9.13 features
|
||||||
|
|
||||||
BIND 9.15 is the newest development branch of BIND 9. It includes a number
|
BIND 9.13 is the newest development branch of BIND 9. It includes a number
|
||||||
of changes from BIND 9.14 and earlier releases. New features include:
|
of changes from BIND 9.12 and earlier releases. New features include:
|
||||||
|
|
||||||
* New dnssec-policy statement to configure a key and signing policy for
|
* QNAME minimization, as described in RFC 7816, is now supported.
|
||||||
zones, enabling automatic key regeneration and rollover.
|
* "Root key sentinel" support, enabling validating resolvers to indicate
|
||||||
* New network manager based on libuv.
|
via a special query which trust anchors are configured for the root
|
||||||
* Added support for the new GeoIP2 geolocation API, libmaxminddb.
|
zone.
|
||||||
* Improved DNSSEC trust anchor configuration using the trust-anchors
|
* Secondary zones can now be configured as "mirror" zones; their
|
||||||
statement, permitting configuration of trust anchors in DS as well as
|
contents are transferred in as with traditional slave zones, but are
|
||||||
DNSKEY format.
|
subject to DNSSEC validation and are not treated as authoritative data
|
||||||
* YAML output for dig, mdig, and delv.
|
when answering. This makes it easier to configure a local copy of the
|
||||||
|
root zone as described in RFC 7706.
|
||||||
|
* The "validate-except" option allows configuration of domains below
|
||||||
|
which DNSSEC validation should not be performed.
|
||||||
|
* The default value of "dnssec-validation" is now "auto".
|
||||||
|
* IDNA2008 is now supported when linking with libidn2.
|
||||||
|
|
||||||
|
In addition, workarounds that were formerly in place to enable resolution
|
||||||
|
of domains whose authoritative servers did not respond to EDNS queries
|
||||||
|
have been removed. See https://dnsflagday.net for more details.
|
||||||
|
|
||||||
|
Cryptographic support has been modernized. BIND now uses the best
|
||||||
|
available pseudo-random number generator for the platform on which it's
|
||||||
|
built. Very old versions of OpenSSL are no longer supported. Cryptography
|
||||||
|
is now mandatory: building BIND without DNSSEC is now longer supported.
|
||||||
|
|
||||||
|
Special code to support certain legacy operating systems has also been
|
||||||
|
removed; see the file PLATFORMS.md for details of supported platforms. In
|
||||||
|
addition to OpenSSL, BIND now requires support for IPv6, threads, and
|
||||||
|
standard atomic operations provided by the C compiler.
|
||||||
|
|
||||||
Building BIND
|
Building BIND
|
||||||
|
|
||||||
Minimally, BIND requires a UNIX or Linux system with an ANSI C compiler,
|
Minimally, BIND requires a UNIX or Linux system with an ANSI C compiler,
|
||||||
basic POSIX support, and a 64-bit integer type. BIND also requires the
|
basic POSIX support, and a 64-bit integer type. Successful builds have
|
||||||
libuv asynchronous I/O library, and a cryptography provider library such
|
been observed on many versions of Linux and UNIX, including RedHat,
|
||||||
as OpenSSL or a hardware service module supporting PKCS#11. On Linux, BIND
|
Fedora, Debian, Ubuntu, SuSE, Slackware, FreeBSD, NetBSD, OpenBSD, Mac OS
|
||||||
requires the libcap library to set process privileges, though this
|
X, Solaris, HP-UX, and OpenWRT.
|
||||||
requirement can be overridden by disabling capability support at compile
|
|
||||||
time. See Compile-time options below for details on other libraries that
|
|
||||||
may be required to support optional features.
|
|
||||||
|
|
||||||
Successful builds have been observed on many versions of Linux and UNIX,
|
BIND requires a cryptography provider library such as OpenSSL or a
|
||||||
including RHEL/CentOS, Fedora, Debian, Ubuntu, SLES, openSUSE, Slackware,
|
hardware service module supporting PKCS#11. On Linux, BIND requires the
|
||||||
Alpine, FreeBSD, NetBSD, OpenBSD, macOS, Solaris, OpenIndiana, OmniOS CE,
|
libcap library to set process privileges, though this requirement can be
|
||||||
HP-UX, and OpenWRT.
|
overridden by disabling capability support at compile time. See
|
||||||
|
Compile-time options below for details on other libraries that may be
|
||||||
|
required to support optional features.
|
||||||
|
|
||||||
BIND is also available for Windows Server 2012 R2 and higher. See
|
BIND is also available for Windows 2008 and higher. See win32utils/
|
||||||
win32utils/build.txt for details on building for Windows systems.
|
readme1st.txt for details on building for Windows systems.
|
||||||
|
|
||||||
To build on a UNIX or Linux system, use:
|
To build on a UNIX or Linux system, use:
|
||||||
|
|
||||||
@@ -150,7 +161,7 @@ make depend. If you're using Emacs, you might find make tags helpful.
|
|||||||
Several environment variables that can be set before running configure
|
Several environment variables that can be set before running configure
|
||||||
will affect compilation:
|
will affect compilation:
|
||||||
|
|
||||||
Variable Description
|
Variable Description
|
||||||
CC The C compiler to use. configure tries to figure out the
|
CC The C compiler to use. configure tries to figure out the
|
||||||
right one for supported systems.
|
right one for supported systems.
|
||||||
C compiler flags. Defaults to include -g and/or -O2 as
|
C compiler flags. Defaults to include -g and/or -O2 as
|
||||||
@@ -165,33 +176,43 @@ STD_CDEFINES Defaults to empty string. For a list of possible settings,
|
|||||||
LDFLAGS Linker flags. Defaults to empty string.
|
LDFLAGS Linker flags. Defaults to empty string.
|
||||||
BUILD_CC Needed when cross-compiling: the native C compiler to use
|
BUILD_CC Needed when cross-compiling: the native C compiler to use
|
||||||
when building for the target system.
|
when building for the target system.
|
||||||
BUILD_CFLAGS CFLAGS for the target system during cross-compiling.
|
BUILD_CFLAGS Optional, used for cross-compiling
|
||||||
BUILD_CPPFLAGS CPPFLAGS for the target system during cross-compiling.
|
BUILD_CPPFLAGS
|
||||||
BUILD_LDFLAGS LDFLAGS for the target system during cross-compiling.
|
BUILD_LDFLAGS
|
||||||
BUILD_LIBS LIBS for the target system during cross-compiling.
|
BUILD_LIBS
|
||||||
|
|
||||||
macOS
|
macOS
|
||||||
|
|
||||||
Building on macOS assumes that the "Command Tools for Xcode" is installed.
|
Building on macOS assumes that the "Command Tools for Xcode" is installed.
|
||||||
This can be downloaded from https://developer.apple.com/download/more/ or
|
This can be downloaded from https://developer.apple.com/download/more/ or
|
||||||
if you have Xcode already installed you can run xcode-select --install.
|
if you have Xcode already installed you can run "xcode-select --install".
|
||||||
|
This will add /usr/include to the system and install the compiler and
|
||||||
Dependencies
|
other tools so that they can be easily found.
|
||||||
|
|
||||||
Portions of BIND that are written in Python, including dnssec-keymgr,
|
|
||||||
dnssec-coverage, dnssec-checkds, and some of the system tests, require the
|
|
||||||
argparse, ply and distutils.core modules to be available. argparse is a
|
|
||||||
standard module as of Python 2.7 and Python 3.2. ply is available from
|
|
||||||
https://pypi.python.org/pypi/ply. distutils.core is required for
|
|
||||||
installation.
|
|
||||||
|
|
||||||
Compile-time options
|
Compile-time options
|
||||||
|
|
||||||
To see a full list of configuration options, run configure --help.
|
To see a full list of configuration options, run configure --help.
|
||||||
|
|
||||||
|
On most platforms, BIND 9 is built with multithreading support, allowing
|
||||||
|
it to take advantage of multiple CPUs. You can configure this by
|
||||||
|
specifying --enable-threads or --disable-threads on the configure command
|
||||||
|
line. The default is to enable threads, except on some older operating
|
||||||
|
systems on which threads are known to have had problems in the past.
|
||||||
|
(Note: Prior to BIND 9.10, the default was to disable threads on Linux
|
||||||
|
systems; this has now been reversed. On Linux systems, the threaded build
|
||||||
|
is known to change BIND's behavior with respect to file permissions; it
|
||||||
|
may be necessary to specify a user with the -u option when running named.)
|
||||||
|
|
||||||
To build shared libraries, specify --with-libtool on the configure command
|
To build shared libraries, specify --with-libtool on the configure command
|
||||||
line.
|
line.
|
||||||
|
|
||||||
|
Certain compiled-in constants and default settings can be increased to
|
||||||
|
values better suited to large servers with abundant memory resources (e.g,
|
||||||
|
64-bit servers with 12G or more of memory) by specifying --with-tuning=
|
||||||
|
large on the configure command line. This can improve performance on big
|
||||||
|
servers, but will consume more memory and may degrade performance on
|
||||||
|
smaller systems.
|
||||||
|
|
||||||
For the server to support DNSSEC, you need to build it with crypto
|
For the server to support DNSSEC, you need to build it with crypto
|
||||||
support. To use OpenSSL, you should have OpenSSL 1.0.2e or newer
|
support. To use OpenSSL, you should have OpenSSL 1.0.2e or newer
|
||||||
installed. If the OpenSSL library is installed in a nonstandard location,
|
installed. If the OpenSSL library is installed in a nonstandard location,
|
||||||
@@ -201,12 +222,9 @@ operations, specify the path to the PKCS#11 provider library using
|
|||||||
--with-pkcs11=<PREFIX>, and configure BIND with --enable-native-pkcs11.
|
--with-pkcs11=<PREFIX>, and configure BIND with --enable-native-pkcs11.
|
||||||
|
|
||||||
To support the HTTP statistics channel, the server must be linked with at
|
To support the HTTP statistics channel, the server must be linked with at
|
||||||
least one of the following libraries: libxml2 http://xmlsoft.org or json-c
|
least one of the following: libxml2 http://xmlsoft.org or json-c https://
|
||||||
https://github.com/json-c/json-c. If these are installed at a nonstandard
|
github.com/json-c. If these are installed at a nonstandard location,
|
||||||
location, then:
|
specify the prefix using --with-libxml2=/prefix or --with-libjson=/prefix.
|
||||||
|
|
||||||
* for libxml2, specify the prefix using --with-libxml2=/prefix,
|
|
||||||
* for json-c, adjust PKG_CONFIG_PATH.
|
|
||||||
|
|
||||||
To support compression on the HTTP statistics channel, the server must be
|
To support compression on the HTTP statistics channel, the server must be
|
||||||
linked against libzlib. If this is installed in a nonstandard location,
|
linked against libzlib. If this is installed in a nonstandard location,
|
||||||
@@ -216,28 +234,26 @@ To support storing configuration data for runtime-added zones in an LMDB
|
|||||||
database, the server must be linked with liblmdb. If this is installed in
|
database, the server must be linked with liblmdb. If this is installed in
|
||||||
a nonstandard location, specify the prefix using with-lmdb=/prefix.
|
a nonstandard location, specify the prefix using with-lmdb=/prefix.
|
||||||
|
|
||||||
To support MaxMind GeoIP2 location-based ACLs, the server must be linked
|
To support GeoIP location-based ACLs, the server must be linked with
|
||||||
with libmaxminddb. This is turned on by default if the library is found;
|
libGeoIP. This is not turned on by default; BIND must be configured with
|
||||||
if the library is installed in a nonstandard location, specify the prefix
|
--with-geoip. If the library is installed in a nonstandard location,
|
||||||
using --with-maxminddb=/prefix. GeoIP2 support can be switched off with
|
specify the prefix using --with-geoip=/prefix.
|
||||||
--disable-geoip.
|
|
||||||
|
|
||||||
For DNSTAP packet logging, you must have installed libfstrm https://
|
For DNSTAP packet logging, you must have installed libfstrm https://
|
||||||
github.com/farsightsec/fstrm and libprotobuf-c https://
|
github.com/farsightsec/fstrm and libprotobuf-c https://
|
||||||
developers.google.com/protocol-buffers, and BIND must be configured with
|
developers.google.com/protocol-buffers, and BIND must be configured with
|
||||||
--enable-dnstap.
|
--enable-dnstap.
|
||||||
|
|
||||||
Certain compiled-in constants and default settings can be increased to
|
|
||||||
values better suited to large servers with abundant memory resources (e.g,
|
|
||||||
64-bit servers with 12G or more of memory) by specifying --with-tuning=
|
|
||||||
large on the configure command line. This can improve performance on big
|
|
||||||
servers, but will consume more memory and may degrade performance on
|
|
||||||
smaller systems.
|
|
||||||
|
|
||||||
On Linux, process capabilities are managed in user space using the libcap
|
On Linux, process capabilities are managed in user space using the libcap
|
||||||
library, which can be installed on most Linux systems via the libcap-dev
|
library, which can be installed on most Linux systems via the libcap-dev
|
||||||
or libcap-devel package. Process capability support can also be disabled
|
or libcap-devel module. Process capability support can also be disabled by
|
||||||
by configuring with --disable-linux-caps.
|
configuring with --disable-linux-caps.
|
||||||
|
|
||||||
|
Portions of BIND that are written in Python, including dnssec-keymgr,
|
||||||
|
dnssec-coverage, dnssec-checkds, and some of the system tests, require the
|
||||||
|
'argparse' and 'ply' modules to be available. 'argparse' is a standard
|
||||||
|
module as of Python 2.7 and Python 3.2. 'ply' is available from https://
|
||||||
|
pypi.python.org/pypi/ply.
|
||||||
|
|
||||||
On some platforms it is necessary to explicitly request large file support
|
On some platforms it is necessary to explicitly request large file support
|
||||||
to handle files bigger than 2GB. This can be done by using
|
to handle files bigger than 2GB. This can be done by using
|
||||||
@@ -248,18 +264,17 @@ specifying --enable-fixed-rrset or --disable-fixed-rrset on the configure
|
|||||||
command line. By default, fixed rrset-order is disabled to reduce memory
|
command line. By default, fixed rrset-order is disabled to reduce memory
|
||||||
footprint.
|
footprint.
|
||||||
|
|
||||||
The --enable-querytrace option causes named to log every step of
|
|
||||||
processing every query. This should only be enabled when debugging,
|
|
||||||
because it has a significant negative impact on query performance.
|
|
||||||
|
|
||||||
make install will install named and the various BIND 9 libraries. By
|
make install will install named and the various BIND 9 libraries. By
|
||||||
default, installation is into /usr/local, but this can be changed with the
|
default, installation is into /usr/local, but this can be changed with the
|
||||||
--prefix option when running configure.
|
--prefix option when running configure.
|
||||||
|
|
||||||
You may specify the option --sysconfdir to set the directory where
|
You may specify the option --sysconfdir to set the directory where
|
||||||
configuration files like named.conf go by default, and --localstatedir to
|
configuration files like named.conf go by default, and --localstatedir to
|
||||||
set the default parent directory of run/named.pid. --sysconfdir defaults
|
set the default parent directory of run/named.pid. For backwards
|
||||||
to $prefix/etc and --localstatedir defaults to $prefix/var.
|
compatibility with BIND 8, --sysconfdir defaults to /etc and
|
||||||
|
--localstatedir defaults to /var if no --prefix option is given. If there
|
||||||
|
is a --prefix option, sysconfdir defaults to $prefix/etc and localstatedir
|
||||||
|
defaults to $prefix/var.
|
||||||
|
|
||||||
Automated testing
|
Automated testing
|
||||||
|
|
||||||
@@ -271,18 +286,16 @@ ifconfig.sh up as root.
|
|||||||
|
|
||||||
Some tests require Perl and the Net::DNS and/or IO::Socket::INET6 modules,
|
Some tests require Perl and the Net::DNS and/or IO::Socket::INET6 modules,
|
||||||
and will be skipped if these are not available. Some tests require Python
|
and will be skipped if these are not available. Some tests require Python
|
||||||
and the dnspython module and will be skipped if these are not available.
|
and the 'dnspython' module and will be skipped if these are not available.
|
||||||
See bin/tests/system/README for further details.
|
See bin/tests/system/README for further details.
|
||||||
|
|
||||||
Unit tests are implemented using the CMocka unit testing framework. To
|
Unit tests are implemented using Automated Testing Framework (ATF). To run
|
||||||
build them, use configure --with-cmocka. Execution of tests is done by the
|
them, use configure --with-atf, then run make test or make unit.
|
||||||
Kyua test execution engine; if the kyua command is available, then unit
|
|
||||||
tests can be run via make test or make unit.
|
|
||||||
|
|
||||||
Documentation
|
Documentation
|
||||||
|
|
||||||
The BIND 9 Administrator Reference Manual is included with the source
|
The BIND 9 Administrator Reference Manual is included with the source
|
||||||
distribution, in DocBook XML, HTML, and PDF format, in the doc/arm
|
distribution, in DocBook XML, HTML and PDF format, in the doc/arm
|
||||||
directory.
|
directory.
|
||||||
|
|
||||||
Some of the programs in the BIND 9 distribution have man pages in their
|
Some of the programs in the BIND 9 distribution have man pages in their
|
||||||
@@ -302,7 +315,7 @@ development BIND 9 is included in the file CHANGES, with the most recent
|
|||||||
changes listed first. Change notes include tags indicating the category of
|
changes listed first. Change notes include tags indicating the category of
|
||||||
the change that was made; these categories are:
|
the change that was made; these categories are:
|
||||||
|
|
||||||
Category Description
|
Category Description
|
||||||
[func] New feature
|
[func] New feature
|
||||||
[bug] General bug fix
|
[bug] General bug fix
|
||||||
[security] Fix for a significant security flaw
|
[security] Fix for a significant security flaw
|
||||||
@@ -330,46 +343,26 @@ releases (i.e., those with version numbers ending in zero). Some new
|
|||||||
functionality may be backported to older releases on a case-by-case basis.
|
functionality may be backported to older releases on a case-by-case basis.
|
||||||
All other change types may be applied to all currently-supported releases.
|
All other change types may be applied to all currently-supported releases.
|
||||||
|
|
||||||
Bug report identifiers
|
|
||||||
|
|
||||||
Most notes in the CHANGES file include a reference to a bug report or
|
|
||||||
issue number. Prior to 2018, these were usually of the form [RT #NNN] and
|
|
||||||
referred to entries in the "bind9-bugs" RT database, which was not open to
|
|
||||||
the public. More recent entries use the form [GL #NNN] or, less often, [GL
|
|
||||||
!NNN], which, respectively, refer to issues or merge requests in the
|
|
||||||
GitLab database. Most of these are publicly readable, unless they include
|
|
||||||
information which is confidential or security sensitive.
|
|
||||||
|
|
||||||
To look up a GitLab issue by its number, use the URL https://
|
|
||||||
gitlab.isc.org/isc-projects/bind9/issues/NNN. To look up a merge request,
|
|
||||||
use https://gitlab.isc.org/isc-projects/bind9/merge_requests/NNN.
|
|
||||||
|
|
||||||
In rare cases, an issue or merge request number may be followed with the
|
|
||||||
letter "P". This indicates that the information is in the private ISC
|
|
||||||
GitLab instance, which is not visible to the public.
|
|
||||||
|
|
||||||
Acknowledgments
|
Acknowledgments
|
||||||
|
|
||||||
* The original development of BIND 9 was underwritten by the following
|
* The original development of BIND 9 was underwritten by the following
|
||||||
organizations:
|
organizations:
|
||||||
|
|
||||||
Sun Microsystems, Inc.
|
Sun Microsystems, Inc.
|
||||||
Hewlett Packard
|
Hewlett Packard
|
||||||
Compaq Computer Corporation
|
Compaq Computer Corporation
|
||||||
IBM
|
IBM
|
||||||
Process Software Corporation
|
Process Software Corporation
|
||||||
Silicon Graphics, Inc.
|
Silicon Graphics, Inc.
|
||||||
Network Associates, Inc.
|
Network Associates, Inc.
|
||||||
U.S. Defense Information Systems Agency
|
U.S. Defense Information Systems Agency
|
||||||
USENIX Association
|
USENIX Association
|
||||||
Stichting NLnet - NLnet Foundation
|
Stichting NLnet - NLnet Foundation
|
||||||
Nominum, Inc.
|
Nominum, Inc.
|
||||||
|
|
||||||
* This product includes software developed by the OpenSSL Project for
|
* This product includes software developed by the OpenSSL Project for
|
||||||
use in the OpenSSL Toolkit. http://www.OpenSSL.org/
|
use in the OpenSSL Toolkit. http://www.OpenSSL.org/
|
||||||
|
|
||||||
* This product includes cryptographic software written by Eric Young
|
* This product includes cryptographic software written by Eric Young
|
||||||
(eay@cryptsoft.com)
|
(eay@cryptsoft.com)
|
||||||
|
|
||||||
* This product includes software written by Tim Hudson
|
* This product includes software written by Tim Hudson
|
||||||
(tjh@cryptsoft.com)
|
(tjh@cryptsoft.com)
|
||||||
|
|||||||
@@ -15,10 +15,9 @@
|
|||||||
1. [Introduction](#intro)
|
1. [Introduction](#intro)
|
||||||
1. [Reporting bugs and getting help](#help)
|
1. [Reporting bugs and getting help](#help)
|
||||||
1. [Contributing to BIND](#contrib)
|
1. [Contributing to BIND](#contrib)
|
||||||
1. [BIND 9.15 features](#features)
|
1. [BIND 9.13 features](#features)
|
||||||
1. [Building BIND](#build)
|
1. [Building BIND](#build)
|
||||||
1. [macOS](#macos)
|
1. [macOS](#macos)
|
||||||
1. [Dependencies](#dependencies)
|
|
||||||
1. [Compile-time options](#opts)
|
1. [Compile-time options](#opts)
|
||||||
1. [Automated testing](#testing)
|
1. [Automated testing](#testing)
|
||||||
1. [Documentation](#doc)
|
1. [Documentation](#doc)
|
||||||
@@ -48,7 +47,7 @@ used in versions 4 and 8. Internet Systems Consortium
|
|||||||
corporation dedicated to providing software and services in support of the
|
corporation dedicated to providing software and services in support of the
|
||||||
Internet infrastructure, developed BIND 9 and is responsible for its
|
Internet infrastructure, developed BIND 9 and is responsible for its
|
||||||
ongoing maintenance and improvement. BIND is open source software
|
ongoing maintenance and improvement. BIND is open source software
|
||||||
licensed under the terms of the Mozilla Public License, version 2.0.
|
licenced under the terms of the Mozilla Public License, version 2.0.
|
||||||
|
|
||||||
For a summary of features introduced in past major releases of BIND,
|
For a summary of features introduced in past major releases of BIND,
|
||||||
see the file [HISTORY](HISTORY.md).
|
see the file [HISTORY](HISTORY.md).
|
||||||
@@ -57,8 +56,8 @@ For a detailed list of changes made throughout the history of BIND 9, see
|
|||||||
the file [CHANGES](CHANGES). See [below](#changes) for details on the
|
the file [CHANGES](CHANGES). See [below](#changes) for details on the
|
||||||
CHANGES file format.
|
CHANGES file format.
|
||||||
|
|
||||||
For up-to-date versions and release notes, see
|
For up-to-date release notes and errata, see
|
||||||
[https://www.isc.org/download/](https://www.isc.org/download/).
|
[http://www.isc.org/software/bind9/releasenotes](http://www.isc.org/software/bind9/releasenotes)
|
||||||
|
|
||||||
For information about supported platforms, see [PLATFORMS](PLATFORMS.md).
|
For information about supported platforms, see [PLATFORMS](PLATFORMS.md).
|
||||||
|
|
||||||
@@ -82,9 +81,6 @@ assertion failure or other crash in `named`, please do *NOT* use GitLab to
|
|||||||
report it. Instead, please send mail to
|
report it. Instead, please send mail to
|
||||||
[security-officer@isc.org](mailto:security-officer@isc.org).
|
[security-officer@isc.org](mailto:security-officer@isc.org).
|
||||||
|
|
||||||
For a general overview of ISC security policies, read the Knowledge Base
|
|
||||||
article at [https://kb.isc.org/docs/aa-00861](https://kb.isc.org/docs/aa-00861).
|
|
||||||
|
|
||||||
Professional support and training for BIND are available from
|
Professional support and training for BIND are available from
|
||||||
ISC at [https://www.isc.org/support](https://www.isc.org/support).
|
ISC at [https://www.isc.org/support](https://www.isc.org/support).
|
||||||
|
|
||||||
@@ -101,13 +97,12 @@ ISC maintains a public git repository for BIND; details can be found
|
|||||||
at [http://www.isc.org/git/](http://www.isc.org/git/).
|
at [http://www.isc.org/git/](http://www.isc.org/git/).
|
||||||
|
|
||||||
Information for BIND contributors can be found in the following files:
|
Information for BIND contributors can be found in the following files:
|
||||||
- General information: [CONTRIBUTING.md](CONTRIBUTING.md)
|
- General information: [CONTRIBUTING.md](CONTRIBUTING)
|
||||||
- Code of Conduct: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
|
|
||||||
- BIND 9 code style: [doc/dev/style.md](doc/dev/style.md)
|
- BIND 9 code style: [doc/dev/style.md](doc/dev/style.md)
|
||||||
- BIND architecture and developer guide: [doc/dev/dev.md](doc/dev/dev.md)
|
- BIND architecture and developer guide: [doc/dev/dev.md](doc/dev/dev.md)
|
||||||
|
|
||||||
Patches for BIND may be submitted as
|
Patches for BIND may be submitted as
|
||||||
[merge requests](https://gitlab.isc.org/isc-projects/bind9/merge_requests)
|
[Merge Requests](https://gitlab.isc.org/isc-projects/bind9/merge_requests)
|
||||||
in the [ISC GitLab server](https://gitlab.isc.org) at
|
in the [ISC GitLab server](https://gitlab.isc.org) at
|
||||||
at [https://gitlab.isc.org/isc-projects/bind9/merge_requests](https://gitlab.isc.org/isc-projects/bind9/merge_requests).
|
at [https://gitlab.isc.org/isc-projects/bind9/merge_requests](https://gitlab.isc.org/isc-projects/bind9/merge_requests).
|
||||||
|
|
||||||
@@ -121,40 +116,59 @@ If you prefer, you may also submit code by opening a
|
|||||||
including your patch as an attachment, preferably generated by
|
including your patch as an attachment, preferably generated by
|
||||||
`git format-patch`.
|
`git format-patch`.
|
||||||
|
|
||||||
### <a name="features"/> BIND 9.15 features
|
### <a name="features"/> BIND 9.13 features
|
||||||
|
|
||||||
BIND 9.15 is the newest development branch of BIND 9. It includes a
|
BIND 9.13 is the newest development branch of BIND 9. It includes a
|
||||||
number of changes from BIND 9.14 and earlier releases. New features
|
number of changes from BIND 9.12 and earlier releases. New features
|
||||||
include:
|
include:
|
||||||
|
|
||||||
* New `dnssec-policy` statement to configure a key and signing policy
|
* QNAME minimization, as described in RFC 7816, is now supported.
|
||||||
for zones, enabling automatic key regeneration and rollover.
|
* "Root key sentinel" support, enabling validating resolvers to indicate
|
||||||
* New network manager based on libuv.
|
via a special query which trust anchors are configured for the root zone.
|
||||||
* Added support for the new GeoIP2 geolocation API, `libmaxminddb`.
|
* Secondary zones can now be configured as "mirror" zones; their contents
|
||||||
* Improved DNSSEC trust anchor configuration using the `trust-anchors`
|
are transferred in as with traditional slave zones, but are subject to
|
||||||
statement, permitting configuration of trust anchors in DS as well as
|
DNSSEC validation and are not treated as authoritative data when
|
||||||
DNSKEY format.
|
answering. This makes it easier to configure a local copy of the root
|
||||||
* YAML output for `dig`, `mdig`, and `delv`.
|
zone as described in RFC 7706.
|
||||||
|
* The "validate-except" option allows configuration of domains below which
|
||||||
|
DNSSEC validation should not be performed.
|
||||||
|
* The default value of "dnssec-validation" is now "auto".
|
||||||
|
* IDNA2008 is now supported when linking with `libidn2`.
|
||||||
|
|
||||||
|
In addition, workarounds that were formerly in place to enable resolution
|
||||||
|
of domains whose authoritative servers did not respond to EDNS queries
|
||||||
|
have been removed. See [https://dnsflagday.net](https://dnsflagday.net)
|
||||||
|
for more details.
|
||||||
|
|
||||||
|
Cryptographic support has been modernized. BIND now uses the
|
||||||
|
best available pseudo-random number generator for the platform on which
|
||||||
|
it's built. Very old versions of OpenSSL are no longer supported.
|
||||||
|
Cryptography is now mandatory: building BIND without DNSSEC is now
|
||||||
|
longer supported.
|
||||||
|
|
||||||
|
Special code to support certain legacy operating systems has also
|
||||||
|
been removed; see the file [PLATFORMS.md](PLATFORMS.md) for details
|
||||||
|
of supported platforms. In addition to OpenSSL, BIND now requires
|
||||||
|
support for IPv6, threads, and standard atomic operations provided
|
||||||
|
by the C compiler.
|
||||||
|
|
||||||
### <a name="build"/> Building BIND
|
### <a name="build"/> Building BIND
|
||||||
|
|
||||||
Minimally, BIND requires a UNIX or Linux system with an ANSI C compiler,
|
Minimally, BIND requires a UNIX or Linux system with an ANSI C compiler,
|
||||||
basic POSIX support, and a 64-bit integer type. BIND also requires the
|
basic POSIX support, and a 64-bit integer type. Successful builds have been
|
||||||
`libuv` asynchronous I/O library, and a cryptography provider library
|
observed on many versions of Linux and UNIX, including RedHat, Fedora,
|
||||||
such as OpenSSL or a hardware service module supporting PKCS#11. On
|
Debian, Ubuntu, SuSE, Slackware, FreeBSD, NetBSD, OpenBSD, Mac OS X,
|
||||||
Linux, BIND requires the `libcap` library to set process privileges,
|
Solaris, HP-UX, and OpenWRT.
|
||||||
though this requirement can be overridden by disabling capability
|
|
||||||
support at compile time. See [Compile-time options](#opts) below
|
|
||||||
for details on other libraries that may be required to support
|
|
||||||
optional features.
|
|
||||||
|
|
||||||
Successful builds have been observed on many versions of Linux and
|
BIND requires a cryptography provider library such as OpenSSL or a
|
||||||
UNIX, including RHEL/CentOS, Fedora, Debian, Ubuntu, SLES, openSUSE,
|
hardware service module supporting PKCS#11. On Linux, BIND requires
|
||||||
Slackware, Alpine, FreeBSD, NetBSD, OpenBSD, macOS, Solaris,
|
the `libcap` library to set process privileges, though this requirement
|
||||||
OpenIndiana, OmniOS CE, HP-UX, and OpenWRT.
|
can be overridden by disabling capability support at compile time.
|
||||||
|
See [Compile-time options](#opts) below for details on other libraries
|
||||||
|
that may be required to support optional features.
|
||||||
|
|
||||||
BIND is also available for Windows Server 2012 R2 and higher. See
|
BIND is also available for Windows 2008 and higher. See
|
||||||
`win32utils/build.txt` for details on building for Windows
|
`win32utils/readme1st.txt` for details on building for Windows
|
||||||
systems.
|
systems.
|
||||||
|
|
||||||
To build on a UNIX or Linux system, use:
|
To build on a UNIX or Linux system, use:
|
||||||
@@ -176,34 +190,44 @@ affect compilation:
|
|||||||
|`STD_CDEFINES`|Any additional preprocessor symbols you want defined. Defaults to empty string. For a list of possible settings, see the file [OPTIONS](OPTIONS.md).|
|
|`STD_CDEFINES`|Any additional preprocessor symbols you want defined. Defaults to empty string. For a list of possible settings, see the file [OPTIONS](OPTIONS.md).|
|
||||||
|`LDFLAGS`|Linker flags. Defaults to empty string.|
|
|`LDFLAGS`|Linker flags. Defaults to empty string.|
|
||||||
|`BUILD_CC`|Needed when cross-compiling: the native C compiler to use when building for the target system.|
|
|`BUILD_CC`|Needed when cross-compiling: the native C compiler to use when building for the target system.|
|
||||||
|`BUILD_CFLAGS`|`CFLAGS` for the target system during cross-compiling.|
|
|`BUILD_CFLAGS`|Optional, used for cross-compiling|
|
||||||
|`BUILD_CPPFLAGS`|`CPPFLAGS` for the target system during cross-compiling.|
|
|`BUILD_CPPFLAGS`||
|
||||||
|`BUILD_LDFLAGS`|`LDFLAGS` for the target system during cross-compiling.|
|
|`BUILD_LDFLAGS`||
|
||||||
|`BUILD_LIBS`|`LIBS` for the target system during cross-compiling.|
|
|`BUILD_LIBS`||
|
||||||
|
|
||||||
#### <a name="macos"> macOS
|
#### <a name="macos"> macOS
|
||||||
|
|
||||||
Building on macOS assumes that the "Command Tools for Xcode" is installed.
|
Building on macOS assumes that the "Command Tools for Xcode" is installed.
|
||||||
This can be downloaded from [https://developer.apple.com/download/more/](https://developer.apple.com/download/more/)
|
This can be downloaded from https://developer.apple.com/download/more/
|
||||||
or if you have Xcode already installed you can run `xcode-select --install`.
|
or if you have Xcode already installed you can run "xcode-select --install".
|
||||||
|
This will add /usr/include to the system and install the compiler and other
|
||||||
|
tools so that they can be easily found.
|
||||||
|
|
||||||
### <a name="dependencies"/> Dependencies
|
|
||||||
|
|
||||||
Portions of BIND that are written in Python, including
|
|
||||||
`dnssec-keymgr`, `dnssec-coverage`, `dnssec-checkds`, and some of the
|
|
||||||
system tests, require the `argparse`, `ply` and `distutils.core` modules
|
|
||||||
to be available.
|
|
||||||
`argparse` is a standard module as of Python 2.7 and Python 3.2.
|
|
||||||
`ply` is available from [https://pypi.python.org/pypi/ply](https://pypi.python.org/pypi/ply).
|
|
||||||
`distutils.core` is required for installation.
|
|
||||||
|
|
||||||
#### <a name="opts"/> Compile-time options
|
#### <a name="opts"/> Compile-time options
|
||||||
|
|
||||||
To see a full list of configuration options, run `configure --help`.
|
To see a full list of configuration options, run `configure --help`.
|
||||||
|
|
||||||
|
On most platforms, BIND 9 is built with multithreading support, allowing it
|
||||||
|
to take advantage of multiple CPUs. You can configure this by specifying
|
||||||
|
`--enable-threads` or `--disable-threads` on the `configure` command line.
|
||||||
|
The default is to enable threads, except on some older operating systems on
|
||||||
|
which threads are known to have had problems in the past. (Note: Prior to
|
||||||
|
BIND 9.10, the default was to disable threads on Linux systems; this has
|
||||||
|
now been reversed. On Linux systems, the threaded build is known to change
|
||||||
|
BIND's behavior with respect to file permissions; it may be necessary to
|
||||||
|
specify a user with the -u option when running `named`.)
|
||||||
|
|
||||||
To build shared libraries, specify `--with-libtool` on the `configure`
|
To build shared libraries, specify `--with-libtool` on the `configure`
|
||||||
command line.
|
command line.
|
||||||
|
|
||||||
|
Certain compiled-in constants and default settings can be increased to
|
||||||
|
values better suited to large servers with abundant memory resources (e.g,
|
||||||
|
64-bit servers with 12G or more of memory) by specifying
|
||||||
|
`--with-tuning=large` on the `configure` command line. This can improve
|
||||||
|
performance on big servers, but will consume more memory and may degrade
|
||||||
|
performance on smaller systems.
|
||||||
|
|
||||||
For the server to support DNSSEC, you need to build it with crypto support.
|
For the server to support DNSSEC, you need to build it with crypto support.
|
||||||
To use OpenSSL, you should have OpenSSL 1.0.2e or newer installed. If the
|
To use OpenSSL, you should have OpenSSL 1.0.2e or newer installed. If the
|
||||||
OpenSSL library is installed in a nonstandard location, specify the prefix
|
OpenSSL library is installed in a nonstandard location, specify the prefix
|
||||||
@@ -213,46 +237,42 @@ path to the PKCS#11 provider library using `--with-pkcs11=<PREFIX>`, and
|
|||||||
configure BIND with `--enable-native-pkcs11`.
|
configure BIND with `--enable-native-pkcs11`.
|
||||||
|
|
||||||
To support the HTTP statistics channel, the server must be linked with at
|
To support the HTTP statistics channel, the server must be linked with at
|
||||||
least one of the following libraries: `libxml2`
|
least one of the following: libxml2
|
||||||
[http://xmlsoft.org](http://xmlsoft.org) or `json-c`
|
[http://xmlsoft.org](http://xmlsoft.org) or json-c
|
||||||
[https://github.com/json-c/json-c](https://github.com/json-c/json-c).
|
[https://github.com/json-c](https://github.com/json-c). If these are
|
||||||
If these are installed at a nonstandard location, then:
|
installed at a nonstandard location, specify the prefix using
|
||||||
|
`--with-libxml2=/prefix` or `--with-libjson=/prefix`.
|
||||||
* for `libxml2`, specify the prefix using `--with-libxml2=/prefix`,
|
|
||||||
* for `json-c`, adjust `PKG_CONFIG_PATH`.
|
|
||||||
|
|
||||||
To support compression on the HTTP statistics channel, the server must be
|
To support compression on the HTTP statistics channel, the server must be
|
||||||
linked against `libzlib`. If this is installed in a nonstandard location,
|
linked against libzlib. If this is installed in a nonstandard location,
|
||||||
specify the prefix using `--with-zlib=/prefix`.
|
specify the prefix using `--with-zlib=/prefix`.
|
||||||
|
|
||||||
To support storing configuration data for runtime-added zones in an LMDB
|
To support storing configuration data for runtime-added zones in an LMDB
|
||||||
database, the server must be linked with liblmdb. If this is installed in a
|
database, the server must be linked with liblmdb. If this is installed in a
|
||||||
nonstandard location, specify the prefix using `with-lmdb=/prefix`.
|
nonstandard location, specify the prefix using `with-lmdb=/prefix`.
|
||||||
|
|
||||||
To support MaxMind GeoIP2 location-based ACLs, the server must be linked
|
To support GeoIP location-based ACLs, the server must be linked with
|
||||||
with `libmaxminddb`. This is turned on by default if the library is
|
libGeoIP. This is not turned on by default; BIND must be configured with
|
||||||
found; if the library is installed in a nonstandard location,
|
`--with-geoip`. If the library is installed in a nonstandard location,
|
||||||
specify the prefix using `--with-maxminddb=/prefix`. GeoIP2 support
|
specify the prefix using `--with-geoip=/prefix`.
|
||||||
can be switched off with `--disable-geoip`.
|
|
||||||
|
|
||||||
For DNSTAP packet logging, you must have installed `libfstrm`
|
For DNSTAP packet logging, you must have installed libfstrm
|
||||||
[https://github.com/farsightsec/fstrm](https://github.com/farsightsec/fstrm)
|
[https://github.com/farsightsec/fstrm](https://github.com/farsightsec/fstrm)
|
||||||
and `libprotobuf-c`
|
and libprotobuf-c
|
||||||
[https://developers.google.com/protocol-buffers](https://developers.google.com/protocol-buffers),
|
[https://developers.google.com/protocol-buffers](https://developers.google.com/protocol-buffers),
|
||||||
and BIND must be configured with `--enable-dnstap`.
|
and BIND must be configured with `--enable-dnstap`.
|
||||||
|
|
||||||
Certain compiled-in constants and default settings can be increased to
|
|
||||||
values better suited to large servers with abundant memory resources (e.g,
|
|
||||||
64-bit servers with 12G or more of memory) by specifying
|
|
||||||
`--with-tuning=large` on the `configure` command line. This can improve
|
|
||||||
performance on big servers, but will consume more memory and may degrade
|
|
||||||
performance on smaller systems.
|
|
||||||
|
|
||||||
On Linux, process capabilities are managed in user space using
|
On Linux, process capabilities are managed in user space using
|
||||||
the `libcap` library, which can be installed on most Linux systems via
|
the `libcap` library, which can be installed on most Linux systems via
|
||||||
the `libcap-dev` or `libcap-devel` package. Process capability support can
|
the `libcap-dev` or `libcap-devel` module. Process capability support can
|
||||||
also be disabled by configuring with `--disable-linux-caps`.
|
also be disabled by configuring with `--disable-linux-caps`.
|
||||||
|
|
||||||
|
Portions of BIND that are written in Python, including
|
||||||
|
`dnssec-keymgr`, `dnssec-coverage`, `dnssec-checkds`, and some of the
|
||||||
|
system tests, require the 'argparse' and 'ply' modules to be available.
|
||||||
|
'argparse' is a standard module as of Python 2.7 and Python 3.2.
|
||||||
|
'ply' is available from [https://pypi.python.org/pypi/ply](https://pypi.python.org/pypi/ply).
|
||||||
|
|
||||||
On some platforms it is necessary to explicitly request large file support
|
On some platforms it is necessary to explicitly request large file support
|
||||||
to handle files bigger than 2GB. This can be done by using
|
to handle files bigger than 2GB. This can be done by using
|
||||||
`--enable-largefile` on the `configure` command line.
|
`--enable-largefile` on the `configure` command line.
|
||||||
@@ -262,18 +282,17 @@ specifying `--enable-fixed-rrset` or `--disable-fixed-rrset` on the
|
|||||||
configure command line. By default, fixed rrset-order is disabled to
|
configure command line. By default, fixed rrset-order is disabled to
|
||||||
reduce memory footprint.
|
reduce memory footprint.
|
||||||
|
|
||||||
The `--enable-querytrace` option causes `named` to log every step of
|
|
||||||
processing every query. This should only be enabled when debugging, because
|
|
||||||
it has a significant negative impact on query performance.
|
|
||||||
|
|
||||||
`make install` will install `named` and the various BIND 9 libraries. By
|
`make install` will install `named` and the various BIND 9 libraries. By
|
||||||
default, installation is into /usr/local, but this can be changed with the
|
default, installation is into /usr/local, but this can be changed with the
|
||||||
`--prefix` option when running `configure`.
|
`--prefix` option when running `configure`.
|
||||||
|
|
||||||
You may specify the option `--sysconfdir` to set the directory where
|
You may specify the option `--sysconfdir` to set the directory where
|
||||||
configuration files like `named.conf` go by default, and `--localstatedir`
|
configuration files like `named.conf` go by default, and `--localstatedir`
|
||||||
to set the default parent directory of `run/named.pid`. `--sysconfdir`
|
to set the default parent directory of `run/named.pid`. For backwards
|
||||||
defaults to `$prefix/etc` and `--localstatedir` defaults to `$prefix/var`.
|
compatibility with BIND 8, `--sysconfdir` defaults to `/etc` and
|
||||||
|
`--localstatedir` defaults to `/var` if no `--prefix` option is given. If
|
||||||
|
there is a `--prefix` option, sysconfdir defaults to `$prefix/etc` and
|
||||||
|
localstatedir defaults to `$prefix/var`.
|
||||||
|
|
||||||
### <a name="testing"/> Automated testing
|
### <a name="testing"/> Automated testing
|
||||||
|
|
||||||
@@ -283,21 +302,19 @@ multiple servers to run locally and communicate with one another). These
|
|||||||
IP addresses can be configured by running the command
|
IP addresses can be configured by running the command
|
||||||
`bin/tests/system/ifconfig.sh up` as root.
|
`bin/tests/system/ifconfig.sh up` as root.
|
||||||
|
|
||||||
Some tests require Perl and the `Net::DNS` and/or `IO::Socket::INET6` modules,
|
Some tests require Perl and the Net::DNS and/or IO::Socket::INET6 modules,
|
||||||
and will be skipped if these are not available. Some tests require Python
|
and will be skipped if these are not available. Some tests require Python
|
||||||
and the `dnspython` module and will be skipped if these are not available.
|
and the 'dnspython' module and will be skipped if these are not available.
|
||||||
See bin/tests/system/README for further details.
|
See bin/tests/system/README for further details.
|
||||||
|
|
||||||
Unit tests are implemented using the [CMocka unit testing framework](https://cmocka.org/).
|
Unit tests are implemented using Automated Testing Framework (ATF).
|
||||||
To build them, use `configure --with-cmocka`. Execution of tests is done
|
To run them, use `configure --with-atf`, then run `make test` or
|
||||||
by the [Kyua test execution engine](https://github.com/jmmv/kyua); if the
|
`make unit`.
|
||||||
`kyua` command is available, then unit tests can be run via `make test`
|
|
||||||
or `make unit`.
|
|
||||||
|
|
||||||
### <a name="doc"/> Documentation
|
### <a name="doc"/> Documentation
|
||||||
|
|
||||||
The *BIND 9 Administrator Reference Manual* is included with the source
|
The *BIND 9 Administrator Reference Manual* is included with the source
|
||||||
distribution, in DocBook XML, HTML, and PDF format, in the `doc/arm`
|
distribution, in DocBook XML, HTML and PDF format, in the `doc/arm`
|
||||||
directory.
|
directory.
|
||||||
|
|
||||||
Some of the programs in the BIND 9 distribution have man pages in their
|
Some of the programs in the BIND 9 distribution have man pages in their
|
||||||
@@ -340,25 +357,6 @@ releases (i.e., those with version numbers ending in zero). Some new
|
|||||||
functionality may be backported to older releases on a case-by-case basis.
|
functionality may be backported to older releases on a case-by-case basis.
|
||||||
All other change types may be applied to all currently-supported releases.
|
All other change types may be applied to all currently-supported releases.
|
||||||
|
|
||||||
#### Bug report identifiers
|
|
||||||
|
|
||||||
Most notes in the CHANGES file include a reference to a bug report or
|
|
||||||
issue number. Prior to 2018, these were usually of the form `[RT #NNN]`
|
|
||||||
and referred to entries in the "bind9-bugs" RT database, which was not open
|
|
||||||
to the public. More recent entries use the form `[GL #NNN]` or, less often,
|
|
||||||
`[GL !NNN]`, which, respectively, refer to issues or merge requests in the
|
|
||||||
GitLab database. Most of these are publicly readable, unless they include
|
|
||||||
information which is confidential or security sensitive.
|
|
||||||
|
|
||||||
To look up a GitLab issue by its number, use the URL
|
|
||||||
[https://gitlab.isc.org/isc-projects/bind9/issues/NNN](https://gitlab.isc.org/isc-projects/bind9/issues).
|
|
||||||
To look up a merge request, use
|
|
||||||
[https://gitlab.isc.org/isc-projects/bind9/merge_requests/NNN](https://gitlab.isc.org/isc-projects/bind9/merge_requests).
|
|
||||||
|
|
||||||
In rare cases, an issue or merge request number may be followed with the
|
|
||||||
letter "P". This indicates that the information is in the private ISC
|
|
||||||
GitLab instance, which is not visible to the public.
|
|
||||||
|
|
||||||
### <a name="ack"/> Acknowledgments
|
### <a name="ack"/> Acknowledgments
|
||||||
|
|
||||||
* The original development of BIND 9 was underwritten by the
|
* The original development of BIND 9 was underwritten by the
|
||||||
|
|||||||
Vendored
-90
@@ -288,98 +288,8 @@ AS_VAR_COPY([$1], [pkg_cv_][$1])
|
|||||||
AS_VAR_IF([$1], [""], [$5], [$4])dnl
|
AS_VAR_IF([$1], [""], [$5], [$4])dnl
|
||||||
])dnl PKG_CHECK_VAR
|
])dnl PKG_CHECK_VAR
|
||||||
|
|
||||||
# AM_CONDITIONAL -*- Autoconf -*-
|
|
||||||
|
|
||||||
# Copyright (C) 1997-2018 Free Software Foundation, Inc.
|
|
||||||
#
|
|
||||||
# This file is free software; the Free Software Foundation
|
|
||||||
# gives unlimited permission to copy and/or distribute it,
|
|
||||||
# with or without modifications, as long as this notice is preserved.
|
|
||||||
|
|
||||||
# AM_CONDITIONAL(NAME, SHELL-CONDITION)
|
|
||||||
# -------------------------------------
|
|
||||||
# Define a conditional.
|
|
||||||
AC_DEFUN([AM_CONDITIONAL],
|
|
||||||
[AC_PREREQ([2.52])dnl
|
|
||||||
m4_if([$1], [TRUE], [AC_FATAL([$0: invalid condition: $1])],
|
|
||||||
[$1], [FALSE], [AC_FATAL([$0: invalid condition: $1])])dnl
|
|
||||||
AC_SUBST([$1_TRUE])dnl
|
|
||||||
AC_SUBST([$1_FALSE])dnl
|
|
||||||
_AM_SUBST_NOTMAKE([$1_TRUE])dnl
|
|
||||||
_AM_SUBST_NOTMAKE([$1_FALSE])dnl
|
|
||||||
m4_define([_AM_COND_VALUE_$1], [$2])dnl
|
|
||||||
if $2; then
|
|
||||||
$1_TRUE=
|
|
||||||
$1_FALSE='#'
|
|
||||||
else
|
|
||||||
$1_TRUE='#'
|
|
||||||
$1_FALSE=
|
|
||||||
fi
|
|
||||||
AC_CONFIG_COMMANDS_PRE(
|
|
||||||
[if test -z "${$1_TRUE}" && test -z "${$1_FALSE}"; then
|
|
||||||
AC_MSG_ERROR([[conditional "$1" was never defined.
|
|
||||||
Usually this means the macro was only invoked conditionally.]])
|
|
||||||
fi])])
|
|
||||||
|
|
||||||
# Add --enable-maintainer-mode option to configure. -*- Autoconf -*-
|
|
||||||
# From Jim Meyering
|
|
||||||
|
|
||||||
# Copyright (C) 1996-2018 Free Software Foundation, Inc.
|
|
||||||
#
|
|
||||||
# This file is free software; the Free Software Foundation
|
|
||||||
# gives unlimited permission to copy and/or distribute it,
|
|
||||||
# with or without modifications, as long as this notice is preserved.
|
|
||||||
|
|
||||||
# AM_MAINTAINER_MODE([DEFAULT-MODE])
|
|
||||||
# ----------------------------------
|
|
||||||
# Control maintainer-specific portions of Makefiles.
|
|
||||||
# Default is to disable them, unless 'enable' is passed literally.
|
|
||||||
# For symmetry, 'disable' may be passed as well. Anyway, the user
|
|
||||||
# can override the default with the --enable/--disable switch.
|
|
||||||
AC_DEFUN([AM_MAINTAINER_MODE],
|
|
||||||
[m4_case(m4_default([$1], [disable]),
|
|
||||||
[enable], [m4_define([am_maintainer_other], [disable])],
|
|
||||||
[disable], [m4_define([am_maintainer_other], [enable])],
|
|
||||||
[m4_define([am_maintainer_other], [enable])
|
|
||||||
m4_warn([syntax], [unexpected argument to AM@&t@_MAINTAINER_MODE: $1])])
|
|
||||||
AC_MSG_CHECKING([whether to enable maintainer-specific portions of Makefiles])
|
|
||||||
dnl maintainer-mode's default is 'disable' unless 'enable' is passed
|
|
||||||
AC_ARG_ENABLE([maintainer-mode],
|
|
||||||
[AS_HELP_STRING([--]am_maintainer_other[-maintainer-mode],
|
|
||||||
am_maintainer_other[ make rules and dependencies not useful
|
|
||||||
(and sometimes confusing) to the casual installer])],
|
|
||||||
[USE_MAINTAINER_MODE=$enableval],
|
|
||||||
[USE_MAINTAINER_MODE=]m4_if(am_maintainer_other, [enable], [no], [yes]))
|
|
||||||
AC_MSG_RESULT([$USE_MAINTAINER_MODE])
|
|
||||||
AM_CONDITIONAL([MAINTAINER_MODE], [test $USE_MAINTAINER_MODE = yes])
|
|
||||||
MAINT=$MAINTAINER_MODE_TRUE
|
|
||||||
AC_SUBST([MAINT])dnl
|
|
||||||
]
|
|
||||||
)
|
|
||||||
|
|
||||||
# Copyright (C) 2006-2018 Free Software Foundation, Inc.
|
|
||||||
#
|
|
||||||
# This file is free software; the Free Software Foundation
|
|
||||||
# gives unlimited permission to copy and/or distribute it,
|
|
||||||
# with or without modifications, as long as this notice is preserved.
|
|
||||||
|
|
||||||
# _AM_SUBST_NOTMAKE(VARIABLE)
|
|
||||||
# ---------------------------
|
|
||||||
# Prevent Automake from outputting VARIABLE = @VARIABLE@ in Makefile.in.
|
|
||||||
# This macro is traced by Automake.
|
|
||||||
AC_DEFUN([_AM_SUBST_NOTMAKE])
|
|
||||||
|
|
||||||
# AM_SUBST_NOTMAKE(VARIABLE)
|
|
||||||
# --------------------------
|
|
||||||
# Public sister of _AM_SUBST_NOTMAKE.
|
|
||||||
AC_DEFUN([AM_SUBST_NOTMAKE], [_AM_SUBST_NOTMAKE($@)])
|
|
||||||
|
|
||||||
m4_include([m4/ax_check_compile_flag.m4])
|
|
||||||
m4_include([m4/ax_check_openssl.m4])
|
m4_include([m4/ax_check_openssl.m4])
|
||||||
m4_include([m4/ax_posix_shell.m4])
|
|
||||||
m4_include([m4/ax_pthread.m4])
|
m4_include([m4/ax_pthread.m4])
|
||||||
m4_include([m4/ax_restore_flags.m4])
|
|
||||||
m4_include([m4/ax_save_flags.m4])
|
|
||||||
m4_include([m4/libtool.m4])
|
m4_include([m4/libtool.m4])
|
||||||
m4_include([m4/ltoptions.m4])
|
m4_include([m4/ltoptions.m4])
|
||||||
m4_include([m4/ltsugar.m4])
|
m4_include([m4/ltsugar.m4])
|
||||||
|
|||||||
+1
-1
@@ -12,7 +12,7 @@ VPATH = @srcdir@
|
|||||||
top_srcdir = @top_srcdir@
|
top_srcdir = @top_srcdir@
|
||||||
|
|
||||||
SUBDIRS = named rndc dig delv dnssec tools nsupdate check confgen \
|
SUBDIRS = named rndc dig delv dnssec tools nsupdate check confgen \
|
||||||
@NZD_TOOLS@ @PYTHON_TOOLS@ @PKCS11_TOOLS@ plugins tests
|
@NZD_TOOLS@ @PYTHON_TOOLS@ @PKCS11_TOOLS@ tests
|
||||||
TARGETS =
|
TARGETS =
|
||||||
|
|
||||||
@BIND9_MAKE_RULES@
|
@BIND9_MAKE_RULES@
|
||||||
|
|||||||
@@ -16,16 +16,15 @@ VERSION=@BIND9_VERSION@
|
|||||||
@BIND9_MAKE_INCLUDES@
|
@BIND9_MAKE_INCLUDES@
|
||||||
|
|
||||||
CINCLUDES = ${NS_INCLUDES} ${BIND9_INCLUDES} ${DNS_INCLUDES} ${ISCCFG_INCLUDES} \
|
CINCLUDES = ${NS_INCLUDES} ${BIND9_INCLUDES} ${DNS_INCLUDES} ${ISCCFG_INCLUDES} \
|
||||||
${ISC_INCLUDES} \
|
${ISC_INCLUDES} @OPENSSL_INCLUDES@
|
||||||
${OPENSSL_CFLAGS}
|
|
||||||
|
|
||||||
CDEFINES = -DNAMED_CONFFILE=\"${sysconfdir}/named.conf\"
|
CDEFINES = -DNAMED_CONFFILE=\"${sysconfdir}/named.conf\"
|
||||||
CWARNINGS =
|
CWARNINGS =
|
||||||
|
|
||||||
DNSLIBS = ../../lib/dns/libdns.@A@ ${MAXMINDDB_LIBS} @DNS_CRYPTO_LIBS@
|
DNSLIBS = ../../lib/dns/libdns.@A@ @DNS_CRYPTO_LIBS@
|
||||||
ISCCFGLIBS = ../../lib/isccfg/libisccfg.@A@
|
ISCCFGLIBS = ../../lib/isccfg/libisccfg.@A@
|
||||||
ISCLIBS = ../../lib/isc/libisc.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
ISCLIBS = ../../lib/isc/libisc.@A@ @OPENSSL_LIBS@
|
||||||
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ @OPENSSL_LIBS@
|
||||||
BIND9LIBS = ../../lib/bind9/libbind9.@A@
|
BIND9LIBS = ../../lib/bind9/libbind9.@A@
|
||||||
NSLIBS = ../../lib/ns/libns.@A@
|
NSLIBS = ../../lib/ns/libns.@A@
|
||||||
|
|
||||||
@@ -67,7 +66,7 @@ named-checkzone.@O@: named-checkzone.c
|
|||||||
named-checkconf@EXEEXT@: named-checkconf.@O@ check-tool.@O@ ${ISCDEPLIBS} \
|
named-checkconf@EXEEXT@: named-checkconf.@O@ check-tool.@O@ ${ISCDEPLIBS} \
|
||||||
${NSDEPENDLIBS} ${DNSDEPLIBS} ${ISCCFGDEPLIBS} ${BIND9DEPLIBS}
|
${NSDEPENDLIBS} ${DNSDEPLIBS} ${ISCCFGDEPLIBS} ${BIND9DEPLIBS}
|
||||||
export BASEOBJS="named-checkconf.@O@ check-tool.@O@"; \
|
export BASEOBJS="named-checkconf.@O@ check-tool.@O@"; \
|
||||||
export LIBS0="${BIND9LIBS} ${NSLIBS} ${ISCCFGLIBS} ${DNSLIBS}"; \
|
export LIBS0="${NSLIBS} ${BIND9LIBS} ${ISCCFGLIBS} ${DNSLIBS}"; \
|
||||||
${FINALBUILDCMD}
|
${FINALBUILDCMD}
|
||||||
|
|
||||||
named-checkzone@EXEEXT@: named-checkzone.@O@ check-tool.@O@ ${ISCDEPLIBS} \
|
named-checkzone@EXEEXT@: named-checkzone.@O@ check-tool.@O@ ${ISCDEPLIBS} \
|
||||||
|
|||||||
@@ -12,6 +12,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdio.h>
|
#include <stdio.h>
|
||||||
#include <inttypes.h>
|
#include <inttypes.h>
|
||||||
@@ -127,7 +129,9 @@ add(char *key, int value) {
|
|||||||
isc_symvalue_t symvalue;
|
isc_symvalue_t symvalue;
|
||||||
|
|
||||||
if (sym_mctx == NULL) {
|
if (sym_mctx == NULL) {
|
||||||
isc_mem_create(&sym_mctx);
|
result = isc_mem_create(0, 0, &sym_mctx);
|
||||||
|
if (result != ISC_R_SUCCESS)
|
||||||
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (symtab == NULL) {
|
if (symtab == NULL) {
|
||||||
@@ -138,6 +142,8 @@ add(char *key, int value) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
key = isc_mem_strdup(sym_mctx, key);
|
key = isc_mem_strdup(sym_mctx, key);
|
||||||
|
if (key == NULL)
|
||||||
|
return;
|
||||||
|
|
||||||
symvalue.as_pointer = NULL;
|
symvalue.as_pointer = NULL;
|
||||||
result = isc_symtab_define(symtab, key, value, symvalue,
|
result = isc_symtab_define(symtab, key, value, symvalue,
|
||||||
@@ -662,7 +668,7 @@ load_zone(isc_mem_t *mctx, const char *zonename, const char *filename,
|
|||||||
origin = dns_fixedname_initname(&fixorigin);
|
origin = dns_fixedname_initname(&fixorigin);
|
||||||
CHECK(dns_name_fromtext(origin, &buffer, dns_rootname, 0, NULL));
|
CHECK(dns_name_fromtext(origin, &buffer, dns_rootname, 0, NULL));
|
||||||
CHECK(dns_zone_setorigin(zone, origin));
|
CHECK(dns_zone_setorigin(zone, origin));
|
||||||
dns_zone_setdbtype(zone, 1, (const char * const *) dbtype);
|
CHECK(dns_zone_setdbtype(zone, 1, (const char * const *) dbtype));
|
||||||
CHECK(dns_zone_setfile(zone, filename, fileformat,
|
CHECK(dns_zone_setfile(zone, filename, fileformat,
|
||||||
&dns_master_style_default));
|
&dns_master_style_default));
|
||||||
if (journal != NULL)
|
if (journal != NULL)
|
||||||
@@ -716,7 +722,7 @@ dump_zone(const char *zonename, dns_zone_t *zone, const char *filename,
|
|||||||
FILE *output = stdout;
|
FILE *output = stdout;
|
||||||
const char *flags;
|
const char *flags;
|
||||||
|
|
||||||
flags = (fileformat == dns_masterformat_text) ? "w" : "wb";
|
flags = (fileformat == dns_masterformat_text) ? "w+" : "wb+";
|
||||||
|
|
||||||
if (debug) {
|
if (debug) {
|
||||||
if (filename != NULL && strcmp(filename, "-") != 0)
|
if (filename != NULL && strcmp(filename, "-") != 0)
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2000-2002, 2004, 2005, 2007, 2009, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2000-2002, 2004, 2005, 2007, 2009, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -39,7 +39,7 @@
|
|||||||
named-checkconf \- named configuration file syntax checking tool
|
named-checkconf \- named configuration file syntax checking tool
|
||||||
.SH "SYNOPSIS"
|
.SH "SYNOPSIS"
|
||||||
.HP \w'\fBnamed\-checkconf\fR\ 'u
|
.HP \w'\fBnamed\-checkconf\fR\ 'u
|
||||||
\fBnamed\-checkconf\fR [\fB\-chjlvz\fR] [\fB\-p\fR\ [\fB\-x\fR\ ]] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] {filename}
|
\fBnamed\-checkconf\fR [\fB\-hjlvz\fR] [\fB\-p\fR\ [\fB\-x\fR\ ]] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] {filename}
|
||||||
.SH "DESCRIPTION"
|
.SH "DESCRIPTION"
|
||||||
.PP
|
.PP
|
||||||
\fBnamed\-checkconf\fR
|
\fBnamed\-checkconf\fR
|
||||||
@@ -79,18 +79,6 @@ When loading a zonefile read the journal if it exists\&.
|
|||||||
List all the configured zones\&. Each line of output contains the zone name, class (e\&.g\&. IN), view, and type (e\&.g\&. master or slave)\&.
|
List all the configured zones\&. Each line of output contains the zone name, class (e\&.g\&. IN), view, and type (e\&.g\&. master or slave)\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-c
|
|
||||||
.RS 4
|
|
||||||
Check "core" configuration only\&. This suppresses the loading of plugin modules, and causes all parameters to
|
|
||||||
\fBplugin\fR
|
|
||||||
statements to be ignored\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-i
|
|
||||||
.RS 4
|
|
||||||
Ignore warnings on deprecated options\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-p
|
\-p
|
||||||
.RS 4
|
.RS 4
|
||||||
Print out the
|
Print out the
|
||||||
@@ -148,5 +136,5 @@ BIND 9 Administrator Reference Manual\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2000-2002, 2004, 2005, 2007, 2009, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2000-2002, 2004, 2005, 2007, 2009, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
+20
-48
@@ -12,6 +12,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <errno.h>
|
#include <errno.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
@@ -28,7 +30,6 @@
|
|||||||
#include <isc/util.h>
|
#include <isc/util.h>
|
||||||
|
|
||||||
#include <isccfg/namedconf.h>
|
#include <isccfg/namedconf.h>
|
||||||
#include <isccfg/grammar.h>
|
|
||||||
|
|
||||||
#include <bind9/check.h>
|
#include <bind9/check.h>
|
||||||
|
|
||||||
@@ -45,8 +46,6 @@
|
|||||||
|
|
||||||
static const char *program = "named-checkconf";
|
static const char *program = "named-checkconf";
|
||||||
|
|
||||||
static bool loadplugins = true;
|
|
||||||
|
|
||||||
isc_log_t *logc = NULL;
|
isc_log_t *logc = NULL;
|
||||||
|
|
||||||
#define CHECK(r)\
|
#define CHECK(r)\
|
||||||
@@ -62,7 +61,7 @@ usage(void) ISC_PLATFORM_NORETURN_POST;
|
|||||||
|
|
||||||
static void
|
static void
|
||||||
usage(void) {
|
usage(void) {
|
||||||
fprintf(stderr, "usage: %s [-chijlvz] [-p [-x]] [-t directory] "
|
fprintf(stderr, "usage: %s [-hjlvz] [-p [-x]] [-t directory] "
|
||||||
"[named.conf]\n", program);
|
"[named.conf]\n", program);
|
||||||
exit(1);
|
exit(1);
|
||||||
}
|
}
|
||||||
@@ -283,10 +282,8 @@ configure_zone(const char *vclass, const char *view,
|
|||||||
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
||||||
zone_options &= ~DNS_ZONEOPT_CHECKDUPRR;
|
zone_options &= ~DNS_ZONEOPT_CHECKDUPRR;
|
||||||
zone_options &= ~DNS_ZONEOPT_CHECKDUPRRFAIL;
|
zone_options &= ~DNS_ZONEOPT_CHECKDUPRRFAIL;
|
||||||
} else {
|
} else
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
|
||||||
} else {
|
} else {
|
||||||
zone_options |= DNS_ZONEOPT_CHECKDUPRR;
|
zone_options |= DNS_ZONEOPT_CHECKDUPRR;
|
||||||
zone_options &= ~DNS_ZONEOPT_CHECKDUPRRFAIL;
|
zone_options &= ~DNS_ZONEOPT_CHECKDUPRRFAIL;
|
||||||
@@ -303,10 +300,8 @@ configure_zone(const char *vclass, const char *view,
|
|||||||
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
||||||
zone_options &= ~DNS_ZONEOPT_CHECKMX;
|
zone_options &= ~DNS_ZONEOPT_CHECKMX;
|
||||||
zone_options &= ~DNS_ZONEOPT_CHECKMXFAIL;
|
zone_options &= ~DNS_ZONEOPT_CHECKMXFAIL;
|
||||||
} else {
|
} else
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
|
||||||
} else {
|
} else {
|
||||||
zone_options |= DNS_ZONEOPT_CHECKMX;
|
zone_options |= DNS_ZONEOPT_CHECKMX;
|
||||||
zone_options &= ~DNS_ZONEOPT_CHECKMXFAIL;
|
zone_options &= ~DNS_ZONEOPT_CHECKMXFAIL;
|
||||||
@@ -332,10 +327,8 @@ configure_zone(const char *vclass, const char *view,
|
|||||||
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
||||||
zone_options |= DNS_ZONEOPT_WARNMXCNAME;
|
zone_options |= DNS_ZONEOPT_WARNMXCNAME;
|
||||||
zone_options |= DNS_ZONEOPT_IGNOREMXCNAME;
|
zone_options |= DNS_ZONEOPT_IGNOREMXCNAME;
|
||||||
} else {
|
} else
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
|
||||||
} else {
|
} else {
|
||||||
zone_options |= DNS_ZONEOPT_WARNMXCNAME;
|
zone_options |= DNS_ZONEOPT_WARNMXCNAME;
|
||||||
zone_options &= ~DNS_ZONEOPT_IGNOREMXCNAME;
|
zone_options &= ~DNS_ZONEOPT_IGNOREMXCNAME;
|
||||||
@@ -352,10 +345,8 @@ configure_zone(const char *vclass, const char *view,
|
|||||||
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
||||||
zone_options |= DNS_ZONEOPT_WARNSRVCNAME;
|
zone_options |= DNS_ZONEOPT_WARNSRVCNAME;
|
||||||
zone_options |= DNS_ZONEOPT_IGNORESRVCNAME;
|
zone_options |= DNS_ZONEOPT_IGNORESRVCNAME;
|
||||||
} else {
|
} else
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
|
||||||
} else {
|
} else {
|
||||||
zone_options |= DNS_ZONEOPT_WARNSRVCNAME;
|
zone_options |= DNS_ZONEOPT_WARNSRVCNAME;
|
||||||
zone_options &= ~DNS_ZONEOPT_IGNORESRVCNAME;
|
zone_options &= ~DNS_ZONEOPT_IGNORESRVCNAME;
|
||||||
@@ -375,10 +366,8 @@ configure_zone(const char *vclass, const char *view,
|
|||||||
zone_options |= DNS_ZONEOPT_CHECKSPF;
|
zone_options |= DNS_ZONEOPT_CHECKSPF;
|
||||||
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
||||||
zone_options &= ~DNS_ZONEOPT_CHECKSPF;
|
zone_options &= ~DNS_ZONEOPT_CHECKSPF;
|
||||||
} else {
|
} else
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
|
||||||
} else {
|
} else {
|
||||||
zone_options |= DNS_ZONEOPT_CHECKSPF;
|
zone_options |= DNS_ZONEOPT_CHECKSPF;
|
||||||
}
|
}
|
||||||
@@ -394,10 +383,8 @@ configure_zone(const char *vclass, const char *view,
|
|||||||
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
} else if (strcasecmp(cfg_obj_asstring(obj), "ignore") == 0) {
|
||||||
zone_options &= ~DNS_ZONEOPT_CHECKNAMES;
|
zone_options &= ~DNS_ZONEOPT_CHECKNAMES;
|
||||||
zone_options &= ~DNS_ZONEOPT_CHECKNAMESFAIL;
|
zone_options &= ~DNS_ZONEOPT_CHECKNAMESFAIL;
|
||||||
} else {
|
} else
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
|
||||||
} else {
|
} else {
|
||||||
zone_options |= DNS_ZONEOPT_CHECKNAMES;
|
zone_options |= DNS_ZONEOPT_CHECKNAMES;
|
||||||
zone_options |= DNS_ZONEOPT_CHECKNAMESFAIL;
|
zone_options |= DNS_ZONEOPT_CHECKNAMESFAIL;
|
||||||
@@ -407,21 +394,19 @@ configure_zone(const char *vclass, const char *view,
|
|||||||
fmtobj = NULL;
|
fmtobj = NULL;
|
||||||
if (get_maps(maps, "masterfile-format", &fmtobj)) {
|
if (get_maps(maps, "masterfile-format", &fmtobj)) {
|
||||||
const char *masterformatstr = cfg_obj_asstring(fmtobj);
|
const char *masterformatstr = cfg_obj_asstring(fmtobj);
|
||||||
if (strcasecmp(masterformatstr, "text") == 0) {
|
if (strcasecmp(masterformatstr, "text") == 0)
|
||||||
masterformat = dns_masterformat_text;
|
masterformat = dns_masterformat_text;
|
||||||
} else if (strcasecmp(masterformatstr, "raw") == 0) {
|
else if (strcasecmp(masterformatstr, "raw") == 0)
|
||||||
masterformat = dns_masterformat_raw;
|
masterformat = dns_masterformat_raw;
|
||||||
} else if (strcasecmp(masterformatstr, "map") == 0) {
|
else if (strcasecmp(masterformatstr, "map") == 0)
|
||||||
masterformat = dns_masterformat_map;
|
masterformat = dns_masterformat_map;
|
||||||
} else {
|
else
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
obj = NULL;
|
obj = NULL;
|
||||||
if (get_maps(maps, "max-zone-ttl", &obj)) {
|
if (get_maps(maps, "max-zone-ttl", &obj)) {
|
||||||
maxttl = cfg_obj_asduration(obj);
|
maxttl = cfg_obj_asuint32(obj);
|
||||||
zone_options |= DNS_ZONEOPT_CHECKTTL;
|
zone_options |= DNS_ZONEOPT_CHECKTTL;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -556,7 +541,6 @@ main(int argc, char **argv) {
|
|||||||
bool load_zones = false;
|
bool load_zones = false;
|
||||||
bool list_zones = false;
|
bool list_zones = false;
|
||||||
bool print = false;
|
bool print = false;
|
||||||
bool nodeprecate = false;
|
|
||||||
unsigned int flags = 0;
|
unsigned int flags = 0;
|
||||||
|
|
||||||
isc_commandline_errprint = false;
|
isc_commandline_errprint = false;
|
||||||
@@ -564,7 +548,7 @@ main(int argc, char **argv) {
|
|||||||
/*
|
/*
|
||||||
* Process memory debugging argument first.
|
* Process memory debugging argument first.
|
||||||
*/
|
*/
|
||||||
#define CMDLINE_FLAGS "cdhijlm:t:pvxz"
|
#define CMDLINE_FLAGS "dhjlm:t:pvxz"
|
||||||
while ((c = isc_commandline_parse(argc, argv, CMDLINE_FLAGS)) != -1) {
|
while ((c = isc_commandline_parse(argc, argv, CMDLINE_FLAGS)) != -1) {
|
||||||
switch (c) {
|
switch (c) {
|
||||||
case 'm':
|
case 'm':
|
||||||
@@ -585,22 +569,14 @@ main(int argc, char **argv) {
|
|||||||
}
|
}
|
||||||
isc_commandline_reset = true;
|
isc_commandline_reset = true;
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
RUNTIME_CHECK(isc_mem_create(0, 0, &mctx) == ISC_R_SUCCESS);
|
||||||
|
|
||||||
while ((c = isc_commandline_parse(argc, argv, CMDLINE_FLAGS)) != EOF) {
|
while ((c = isc_commandline_parse(argc, argv, CMDLINE_FLAGS)) != EOF) {
|
||||||
switch (c) {
|
switch (c) {
|
||||||
case 'c':
|
|
||||||
loadplugins = false;
|
|
||||||
break;
|
|
||||||
|
|
||||||
case 'd':
|
case 'd':
|
||||||
debug++;
|
debug++;
|
||||||
break;
|
break;
|
||||||
|
|
||||||
case 'i':
|
|
||||||
nodeprecate = true;
|
|
||||||
break;
|
|
||||||
|
|
||||||
case 'j':
|
case 'j':
|
||||||
nomerge = false;
|
nomerge = false;
|
||||||
break;
|
break;
|
||||||
@@ -681,21 +657,15 @@ main(int argc, char **argv) {
|
|||||||
|
|
||||||
RUNTIME_CHECK(cfg_parser_create(mctx, logc, &parser) == ISC_R_SUCCESS);
|
RUNTIME_CHECK(cfg_parser_create(mctx, logc, &parser) == ISC_R_SUCCESS);
|
||||||
|
|
||||||
if (nodeprecate) {
|
|
||||||
cfg_parser_setflags(parser, CFG_PCTX_NODEPRECATED, true);
|
|
||||||
}
|
|
||||||
cfg_parser_setcallback(parser, directory_callback, NULL);
|
cfg_parser_setcallback(parser, directory_callback, NULL);
|
||||||
|
|
||||||
if (cfg_parse_file(parser, conffile, &cfg_type_namedconf, &config) !=
|
if (cfg_parse_file(parser, conffile, &cfg_type_namedconf, &config) !=
|
||||||
ISC_R_SUCCESS)
|
ISC_R_SUCCESS)
|
||||||
{
|
|
||||||
exit(1);
|
exit(1);
|
||||||
}
|
|
||||||
|
|
||||||
result = bind9_check_namedconf(config, loadplugins, logc, mctx);
|
result = bind9_check_namedconf(config, logc, mctx);
|
||||||
if (result != ISC_R_SUCCESS) {
|
if (result != ISC_R_SUCCESS)
|
||||||
exit_status = 1;
|
exit_status = 1;
|
||||||
}
|
|
||||||
|
|
||||||
if (result == ISC_R_SUCCESS && (load_zones || list_zones)) {
|
if (result == ISC_R_SUCCESS && (load_zones || list_zones)) {
|
||||||
result = load_zones_fromconfig(config, mctx, list_zones);
|
result = load_zones_fromconfig(config, mctx, list_zones);
|
||||||
@@ -709,6 +679,8 @@ main(int argc, char **argv) {
|
|||||||
|
|
||||||
cfg_parser_destroy(&parser);
|
cfg_parser_destroy(&parser);
|
||||||
|
|
||||||
|
dns_name_destroy();
|
||||||
|
|
||||||
isc_log_destroy(&logc);
|
isc_log_destroy(&logc);
|
||||||
|
|
||||||
isc_mem_destroy(&mctx);
|
isc_mem_destroy(&mctx);
|
||||||
|
|||||||
@@ -40,8 +40,6 @@
|
|||||||
<year>2015</year>
|
<year>2015</year>
|
||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
@@ -54,7 +52,7 @@
|
|||||||
<refsynopsisdiv>
|
<refsynopsisdiv>
|
||||||
<cmdsynopsis sepchar=" ">
|
<cmdsynopsis sepchar=" ">
|
||||||
<command>named-checkconf</command>
|
<command>named-checkconf</command>
|
||||||
<arg choice="opt" rep="norepeat"><option>-chjlvz</option></arg>
|
<arg choice="opt" rep="norepeat"><option>-hjlvz</option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-p</option>
|
<arg choice="opt" rep="norepeat"><option>-p</option>
|
||||||
<arg choice="opt" rep="norepeat"><option>-x</option>
|
<arg choice="opt" rep="norepeat"><option>-x</option>
|
||||||
</arg></arg>
|
</arg></arg>
|
||||||
@@ -116,26 +114,6 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-c</term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Check "core" configuration only. This suppresses the loading
|
|
||||||
of plugin modules, and causes all parameters to
|
|
||||||
<command>plugin</command> statements to be ignored.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-i</term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Ignore warnings on deprecated options.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-p</term>
|
<term>-p</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2000-2002, 2004, 2005, 2007, 2009, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2000-2002, 2004, 2005, 2007, 2009, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -33,7 +33,7 @@
|
|||||||
<h2>Synopsis</h2>
|
<h2>Synopsis</h2>
|
||||||
<div class="cmdsynopsis"><p>
|
<div class="cmdsynopsis"><p>
|
||||||
<code class="command">named-checkconf</code>
|
<code class="command">named-checkconf</code>
|
||||||
[<code class="option">-chjlvz</code>]
|
[<code class="option">-hjlvz</code>]
|
||||||
[<code class="option">-p</code>
|
[<code class="option">-p</code>
|
||||||
[<code class="option">-x</code>
|
[<code class="option">-x</code>
|
||||||
]]
|
]]
|
||||||
@@ -88,20 +88,6 @@
|
|||||||
(e.g. master or slave).
|
(e.g. master or slave).
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-c</span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Check "core" configuration only. This suppresses the loading
|
|
||||||
of plugin modules, and causes all parameters to
|
|
||||||
<span class="command"><strong>plugin</strong></span> statements to be ignored.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-i</span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Ignore warnings on deprecated options.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-p</span></dt>
|
<dt><span class="term">-p</span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2000-2002, 2004-2007, 2009-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2000-2002, 2004-2007, 2009-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -325,5 +325,5 @@ BIND 9 Administrator Reference Manual\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2000-2002, 2004-2007, 2009-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2000-2002, 2004-2007, 2009-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
@@ -12,6 +12,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
#include <inttypes.h>
|
#include <inttypes.h>
|
||||||
@@ -85,9 +87,9 @@ usage(void) {
|
|||||||
|
|
||||||
static void
|
static void
|
||||||
destroy(void) {
|
destroy(void) {
|
||||||
if (zone != NULL) {
|
if (zone != NULL)
|
||||||
dns_zone_detach(&zone);
|
dns_zone_detach(&zone);
|
||||||
}
|
dns_name_destroy();
|
||||||
}
|
}
|
||||||
|
|
||||||
/*% main processing routine */
|
/*% main processing routine */
|
||||||
@@ -137,14 +139,12 @@ main(int argc, char **argv) {
|
|||||||
#define PROGCMP(X) \
|
#define PROGCMP(X) \
|
||||||
(strcasecmp(prog_name, X) == 0 || strcasecmp(prog_name, X ".exe") == 0)
|
(strcasecmp(prog_name, X) == 0 || strcasecmp(prog_name, X ".exe") == 0)
|
||||||
|
|
||||||
if (PROGCMP("named-checkzone")) {
|
if (PROGCMP("named-checkzone"))
|
||||||
progmode = progmode_check;
|
progmode = progmode_check;
|
||||||
} else if (PROGCMP("named-compilezone")) {
|
else if (PROGCMP("named-compilezone"))
|
||||||
progmode = progmode_compile;
|
progmode = progmode_compile;
|
||||||
} else {
|
else
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Compilation specific defaults */
|
/* Compilation specific defaults */
|
||||||
if (progmode == progmode_compile) {
|
if (progmode == progmode_compile) {
|
||||||
@@ -517,7 +517,7 @@ main(int argc, char **argv) {
|
|||||||
InitSockets();
|
InitSockets();
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
RUNTIME_CHECK(isc_mem_create(0, 0, &mctx) == ISC_R_SUCCESS);
|
||||||
if (!quiet)
|
if (!quiet)
|
||||||
RUNTIME_CHECK(setup_logging(mctx, errout, &lctx)
|
RUNTIME_CHECK(setup_logging(mctx, errout, &lctx)
|
||||||
== ISC_R_SUCCESS);
|
== ISC_R_SUCCESS);
|
||||||
|
|||||||
@@ -43,8 +43,6 @@
|
|||||||
<year>2015</year>
|
<year>2015</year>
|
||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2000-2002, 2004-2007, 2009-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2000-2002, 2004-2007, 2009-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{03A96113-CB14-43AA-AEB2-48950E3915C5}</ProjectGuid>
|
<ProjectGuid>{03A96113-CB14-43AA-AEB2-48950E3915C5}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>checkconf</RootNamespace>
|
<RootNamespace>checkconf</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -65,7 +62,6 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
@@ -93,7 +89,6 @@
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -17,21 +17,18 @@
|
|||||||
<ProjectGuid>{2C1F7096-C5B5-48D4-846F-A7ACA454335D}</ProjectGuid>
|
<ProjectGuid>{2C1F7096-C5B5-48D4-846F-A7ACA454335D}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>checktool</RootNamespace>
|
<RootNamespace>checktool</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>StaticLibrary</ConfigurationType>
|
<ConfigurationType>StaticLibrary</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>StaticLibrary</ConfigurationType>
|
<ConfigurationType>StaticLibrary</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -68,7 +65,6 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\ns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\ns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
@@ -92,7 +88,6 @@
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\ns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\ns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{66028555-7DD5-4016-B601-9EF9A1EE8BFA}</ProjectGuid>
|
<ProjectGuid>{66028555-7DD5-4016-B601-9EF9A1EE8BFA}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>checkzone</RootNamespace>
|
<RootNamespace>checkzone</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -65,16 +62,15 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
<Link>
|
<Link>
|
||||||
<SubSystem>Console</SubSystem>
|
<SubSystem>Console</SubSystem>
|
||||||
<GenerateDebugInformation>true</GenerateDebugInformation>
|
<GenerateDebugInformation>true</GenerateDebugInformation>
|
||||||
<OutputFile>..\..\..\Build\$(Configuration)\$(TargetName)$(TargetExt)</OutputFile>
|
<OutputFile>..\..\..\Build\$(Configuration)\$(TargetName)$(TargetExt)</OutputFile>
|
||||||
<AdditionalLibraryDirectories>$(Configuration);..\..\..\lib\isc\win32\$(Configuration);..\..\..\lib\dns\win32\$(Configuration);..\..\..\lib\isccfg\win32\$(Configuration);..\..\..\lib\ns\win32\$(Configuration);%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
|
<AdditionalLibraryDirectories>$(Configuration);..\..\..\lib\isc\win32\$(Configuration);..\..\..\lib\dns\win32\$(Configuration);..\..\..\lib\isccfg\win32\$(Configuration);..\..\..\lib\bind9\win32\$(Configuration);..\..\..\lib\ns\win32\$(Configuration);%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
|
||||||
<AdditionalDependencies>@OPENSSL_LIB@checktool.lib;libisc.lib;libdns.lib;libisccfg.lib;libns.lib;ws2_32.lib;%(AdditionalDependencies)</AdditionalDependencies>
|
<AdditionalDependencies>@OPENSSL_LIB@checktool.lib;libisc.lib;libdns.lib;libisccfg.lib;libbind9.lib;libns.lib;ws2_32.lib;%(AdditionalDependencies)</AdditionalDependencies>
|
||||||
</Link>
|
</Link>
|
||||||
<PostBuildEvent>
|
<PostBuildEvent>
|
||||||
<Command>cd ..\..\..\Build\$(Configuration)
|
<Command>cd ..\..\..\Build\$(Configuration)
|
||||||
@@ -99,8 +95,7 @@ copy /Y named-checkzone.ilk named-compilezone.ilk
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
<Link>
|
<Link>
|
||||||
@@ -109,8 +104,8 @@ copy /Y named-checkzone.ilk named-compilezone.ilk
|
|||||||
<EnableCOMDATFolding>true</EnableCOMDATFolding>
|
<EnableCOMDATFolding>true</EnableCOMDATFolding>
|
||||||
<OptimizeReferences>true</OptimizeReferences>
|
<OptimizeReferences>true</OptimizeReferences>
|
||||||
<OutputFile>..\..\..\Build\$(Configuration)\$(TargetName)$(TargetExt)</OutputFile>
|
<OutputFile>..\..\..\Build\$(Configuration)\$(TargetName)$(TargetExt)</OutputFile>
|
||||||
<AdditionalLibraryDirectories>$(Configuration);..\..\..\lib\isc\win32\$(Configuration);..\..\..\lib\dns\win32\$(Configuration);..\..\..\lib\isccfg\win32\$(Configuration);..\..\..\lib\ns\win32\$(Configuration);%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
|
<AdditionalLibraryDirectories>$(Configuration);..\..\..\lib\isc\win32\$(Configuration);..\..\..\lib\dns\win32\$(Configuration);..\..\..\lib\isccfg\win32\$(Configuration);..\..\..\lib\bind9\win32\$(Configuration);..\..\..\lib\ns\win32\$(Configuration);%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
|
||||||
<AdditionalDependencies>@OPENSSL_LIB@checktool.lib;libisc.lib;libdns.lib;libisccfg.lib;libns.lib;ws2_32.lib;%(AdditionalDependencies)</AdditionalDependencies>
|
<AdditionalDependencies>@OPENSSL_LIB@checktool.lib;libisc.lib;libdns.lib;libisccfg.lib;libbind9.lib;libns.lib;ws2_32.lib;%(AdditionalDependencies)</AdditionalDependencies>
|
||||||
<LinkTimeCodeGeneration>Default</LinkTimeCodeGeneration>
|
<LinkTimeCodeGeneration>Default</LinkTimeCodeGeneration>
|
||||||
</Link>
|
</Link>
|
||||||
<PostBuildEvent>
|
<PostBuildEvent>
|
||||||
|
|||||||
@@ -27,9 +27,9 @@ CWARNINGS =
|
|||||||
|
|
||||||
ISCCFGLIBS = ../../lib/isccfg/libisccfg.@A@
|
ISCCFGLIBS = ../../lib/isccfg/libisccfg.@A@
|
||||||
ISCCCLIBS = ../../lib/isccc/libisccc.@A@
|
ISCCCLIBS = ../../lib/isccc/libisccc.@A@
|
||||||
ISCLIBS = ../../lib/isc/libisc.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
ISCLIBS = ../../lib/isc/libisc.@A@ @OPENSSL_LIBS@
|
||||||
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ @OPENSSL_LIBS@
|
||||||
DNSLIBS = ../../lib/dns/libdns.@A@ ${MAXMINDDB_LIBS} @DNS_CRYPTO_LIBS@
|
DNSLIBS = ../../lib/dns/libdns.@A@ @DNS_CRYPTO_LIBS@
|
||||||
BIND9LIBS = ../../lib/bind9/libbind9.@A@
|
BIND9LIBS = ../../lib/bind9/libbind9.@A@
|
||||||
|
|
||||||
ISCCFGDEPLIBS = ../../lib/isccfg/libisccfg.@A@
|
ISCCFGDEPLIBS = ../../lib/isccfg/libisccfg.@A@
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2009, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2009, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -144,5 +144,5 @@ BIND 9 Administrator Reference Manual\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2009, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2009, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
@@ -17,6 +17,8 @@
|
|||||||
* and the corresponding key and update-policy statements in named.conf.
|
* and the corresponding key and update-policy statements in named.conf.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <stdarg.h>
|
#include <stdarg.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
@@ -123,12 +125,10 @@ main(int argc, char **argv) {
|
|||||||
if (PROGCMP("tsig-keygen")) {
|
if (PROGCMP("tsig-keygen")) {
|
||||||
progmode = progmode_keygen;
|
progmode = progmode_keygen;
|
||||||
quiet = true;
|
quiet = true;
|
||||||
} else if (PROGCMP("ddns-confgen")) {
|
} else if (PROGCMP("ddns-confgen"))
|
||||||
progmode = progmode_confgen;
|
progmode = progmode_confgen;
|
||||||
} else {
|
else
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
|
||||||
|
|
||||||
isc_commandline_errprint = false;
|
isc_commandline_errprint = false;
|
||||||
|
|
||||||
@@ -207,7 +207,7 @@ main(int argc, char **argv) {
|
|||||||
/* Use canonical algorithm name */
|
/* Use canonical algorithm name */
|
||||||
algname = alg_totext(alg);
|
algname = alg_totext(alg);
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
DO("create memory context", isc_mem_create(0, 0, &mctx));
|
||||||
|
|
||||||
if (keyname == NULL) {
|
if (keyname == NULL) {
|
||||||
const char *suffix = NULL;
|
const char *suffix = NULL;
|
||||||
@@ -222,6 +222,8 @@ main(int argc, char **argv) {
|
|||||||
if (suffix != NULL) {
|
if (suffix != NULL) {
|
||||||
len = strlen(keyname) + strlen(suffix) + 2;
|
len = strlen(keyname) + strlen(suffix) + 2;
|
||||||
keybuf = isc_mem_get(mctx, len);
|
keybuf = isc_mem_get(mctx, len);
|
||||||
|
if (keybuf == NULL)
|
||||||
|
fatal("failed to allocate memory for keyname");
|
||||||
snprintf(keybuf, len, "%s.%s", keyname, suffix);
|
snprintf(keybuf, len, "%s.%s", keyname, suffix);
|
||||||
keyname = (const char *) keybuf;
|
keyname = (const char *) keybuf;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -37,8 +37,6 @@
|
|||||||
<year>2015</year>
|
<year>2015</year>
|
||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2009, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2009, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
|||||||
@@ -12,6 +12,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
#include <stdarg.h>
|
#include <stdarg.h>
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2001, 2003-2005, 2007, 2009, 2013-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2001, 2003-2005, 2007, 2009, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -206,5 +206,5 @@ BIND 9 Administrator Reference Manual\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2001, 2003-2005, 2007, 2009, 2013-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2001, 2003-2005, 2007, 2009, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
@@ -20,6 +20,8 @@
|
|||||||
* controls statement altogether.
|
* controls statement altogether.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <stdarg.h>
|
#include <stdarg.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
@@ -209,7 +211,7 @@ main(int argc, char **argv) {
|
|||||||
keysize = alg_bits(alg);
|
keysize = alg_bits(alg);
|
||||||
algname = alg_totext(alg);
|
algname = alg_totext(alg);
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
DO("create memory context", isc_mem_create(0, 0, &mctx));
|
||||||
isc_buffer_init(&key_txtbuffer, &key_txtsecret, sizeof(key_txtsecret));
|
isc_buffer_init(&key_txtbuffer, &key_txtsecret, sizeof(key_txtsecret));
|
||||||
|
|
||||||
generate_key(mctx, alg, keysize, &key_txtbuffer);
|
generate_key(mctx, alg, keysize, &key_txtbuffer);
|
||||||
@@ -222,6 +224,8 @@ main(int argc, char **argv) {
|
|||||||
char *buf;
|
char *buf;
|
||||||
len = strlen(chrootdir) + strlen(keyfile) + 2;
|
len = strlen(chrootdir) + strlen(keyfile) + 2;
|
||||||
buf = isc_mem_get(mctx, len);
|
buf = isc_mem_get(mctx, len);
|
||||||
|
if (buf == NULL)
|
||||||
|
fatal("isc_mem_get(%d) failed\n", len);
|
||||||
snprintf(buf, len, "%s%s%s", chrootdir,
|
snprintf(buf, len, "%s%s%s", chrootdir,
|
||||||
(*keyfile != '/') ? "/" : "", keyfile);
|
(*keyfile != '/') ? "/" : "", keyfile);
|
||||||
|
|
||||||
|
|||||||
@@ -44,8 +44,6 @@
|
|||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2017</year>
|
<year>2017</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2001, 2003-2005, 2007, 2009, 2013-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2001, 2003-2005, 2007, 2009, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
|||||||
@@ -12,6 +12,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <confgen/os.h>
|
#include <confgen/os.h>
|
||||||
|
|
||||||
#include <fcntl.h>
|
#include <fcntl.h>
|
||||||
|
|||||||
@@ -12,6 +12,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <stdarg.h>
|
#include <stdarg.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{64964B03-4815-41F0-9057-E766A94AF197}</ProjectGuid>
|
<ProjectGuid>{64964B03-4815-41F0-9057-E766A94AF197}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>confgentool</RootNamespace>
|
<RootNamespace>confgentool</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>StaticLibrary</ConfigurationType>
|
<ConfigurationType>StaticLibrary</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>StaticLibrary</ConfigurationType>
|
<ConfigurationType>StaticLibrary</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -63,7 +60,6 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
@@ -88,7 +84,6 @@
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{1EA4FC64-F33B-4A50-970A-EA052BBE9CF1}</ProjectGuid>
|
<ProjectGuid>{1EA4FC64-F33B-4A50-970A-EA052BBE9CF1}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>ddnsconfgen</RootNamespace>
|
<RootNamespace>ddnsconfgen</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -65,7 +62,6 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\isccc\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\isccc\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
@@ -99,7 +95,6 @@ copy /Y ddns-confgen.ilk tsig-keygen.ilk
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\isccc\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\isccc\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
|||||||
@@ -9,6 +9,9 @@
|
|||||||
* information regarding copyright ownership.
|
* information regarding copyright ownership.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <confgen/os.h>
|
#include <confgen/os.h>
|
||||||
|
|
||||||
#include <fcntl.h>
|
#include <fcntl.h>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{1E2C1635-3093-4D59-80E7-4743AC10F22F}</ProjectGuid>
|
<ProjectGuid>{1E2C1635-3093-4D59-80E7-4743AC10F22F}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>rndcconfgen</RootNamespace>
|
<RootNamespace>rndcconfgen</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -65,7 +62,6 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\isccc\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\isccc\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
@@ -93,7 +89,6 @@
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\isccc\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\dns\include;..\..\..\lib\isccc\include;..\..\..\lib\isccfg\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
|||||||
@@ -16,17 +16,16 @@ VERSION=@BIND9_VERSION@
|
|||||||
@BIND9_MAKE_INCLUDES@
|
@BIND9_MAKE_INCLUDES@
|
||||||
|
|
||||||
CINCLUDES = -I${srcdir}/include ${DNS_INCLUDES} ${ISC_INCLUDES} \
|
CINCLUDES = -I${srcdir}/include ${DNS_INCLUDES} ${ISC_INCLUDES} \
|
||||||
${IRS_INCLUDES} ${ISCCFG_INCLUDES} \
|
${IRS_INCLUDES} ${ISCCFG_INCLUDES} @OPENSSL_INCLUDES@
|
||||||
${OPENSSL_CFLAGS}
|
|
||||||
|
|
||||||
CDEFINES = -DVERSION=\"${VERSION}\" \
|
CDEFINES = -DVERSION=\"${VERSION}\" \
|
||||||
-DSYSCONFDIR=\"${sysconfdir}\"
|
-DSYSCONFDIR=\"${sysconfdir}\"
|
||||||
CWARNINGS =
|
CWARNINGS =
|
||||||
|
|
||||||
ISCCFGLIBS = ../../lib/isccfg/libisccfg.@A@
|
ISCCFGLIBS = ../../lib/isccfg/libisccfg.@A@
|
||||||
DNSLIBS = ../../lib/dns/libdns.@A@ ${MAXMINDDB_LIBS} @DNS_CRYPTO_LIBS@
|
DNSLIBS = ../../lib/dns/libdns.@A@ @DNS_CRYPTO_LIBS@
|
||||||
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ @OPENSSL_LIBS@
|
||||||
ISCLIBS = ../../lib/isc/libisc.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
ISCLIBS = ../../lib/isc/libisc.@A@ @OPENSSL_LIBS@
|
||||||
IRSLIBS = ../../lib/irs/libirs.@A@
|
IRSLIBS = ../../lib/irs/libirs.@A@
|
||||||
|
|
||||||
ISCCFGDEPLIBS = ../../lib/isccfg/libisccfg.@A@
|
ISCCFGDEPLIBS = ../../lib/isccfg/libisccfg.@A@
|
||||||
|
|||||||
+24
-20
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -53,7 +53,7 @@ is a tool for sending DNS queries and validating the results, using the same int
|
|||||||
\fBnamed\fR\&.
|
\fBnamed\fR\&.
|
||||||
.PP
|
.PP
|
||||||
\fBdelv\fR
|
\fBdelv\fR
|
||||||
will send to a specified name server all queries needed to fetch and validate the requested data; this includes the original requested query, subsequent queries to follow CNAME or DNAME chains, and queries for DNSKEY and DS records to establish a chain of trust for DNSSEC validation\&. It does not perform iterative resolution, but simulates the behavior of a name server configured for DNSSEC validating and forwarding\&.
|
will send to a specified name server all queries needed to fetch and validate the requested data; this includes the original requested query, subsequent queries to follow CNAME or DNAME chains, and queries for DNSKEY, DS and DLV records to establish a chain of trust for DNSSEC validation\&. It does not perform iterative resolution, but simulates the behavior of a name server configured for DNSSEC validating and forwarding\&.
|
||||||
.PP
|
.PP
|
||||||
By default, responses are validated using built\-in DNSSEC trust anchor for the root zone ("\&.")\&. Records returned by
|
By default, responses are validated using built\-in DNSSEC trust anchor for the root zone ("\&.")\&. Records returned by
|
||||||
\fBdelv\fR
|
\fBdelv\fR
|
||||||
@@ -139,21 +139,21 @@ BIND
|
|||||||
.sp
|
.sp
|
||||||
Keys that do not match the root zone name are ignored\&. An alternate key name can be specified using the
|
Keys that do not match the root zone name are ignored\&. An alternate key name can be specified using the
|
||||||
\fB+root=NAME\fR
|
\fB+root=NAME\fR
|
||||||
options\&.
|
options\&. DNSSEC Lookaside Validation can also be turned on by using the
|
||||||
|
\fB+dlv=NAME\fR
|
||||||
|
to specify the name of a zone containing DLV records\&.
|
||||||
.sp
|
.sp
|
||||||
Note: When reading the trust anchor file,
|
Note: When reading the trust anchor file,
|
||||||
\fBdelv\fR
|
\fBdelv\fR
|
||||||
treats
|
treats
|
||||||
\fBtrust\-anchors\fR\fBinitial\-key\fR
|
\fBmanaged\-keys\fR
|
||||||
and
|
statements and
|
||||||
\fBstatic\-key\fR
|
\fBtrusted\-keys\fR
|
||||||
entries identically\&. That is, even if a key is configured with
|
statements identically\&. That is, for a managed key, it is the
|
||||||
\fBinitial\-key\fR, indicating that it is meant to be used only as an initializing key for RFC 5011 key maintenance, it is still treated by
|
\fIinitial\fR
|
||||||
|
key that is trusted; RFC 5011 key management is not supported\&.
|
||||||
\fBdelv\fR
|
\fBdelv\fR
|
||||||
as if it had been configured as a
|
will not consult the managed\-keys database maintained by
|
||||||
\fBstatic\-key\fR\&.
|
|
||||||
\fBdelv\fR
|
|
||||||
does not consult the managed keys database maintained by
|
|
||||||
\fBnamed\fR\&. This means that if either of the keys in
|
\fBnamed\fR\&. This means that if either of the keys in
|
||||||
/etc/bind\&.keys
|
/etc/bind\&.keys
|
||||||
is revoked and rolled over, it will be necessary to update
|
is revoked and rolled over, it will be necessary to update
|
||||||
@@ -390,16 +390,25 @@ output\&. The default is to do so\&. Note that (unlike in
|
|||||||
control whether to request DNSSEC records or whether to validate them\&. DNSSEC records are always requested, and validation will always occur unless suppressed by the use of
|
control whether to request DNSSEC records or whether to validate them\&. DNSSEC records are always requested, and validation will always occur unless suppressed by the use of
|
||||||
\fB\-i\fR
|
\fB\-i\fR
|
||||||
or
|
or
|
||||||
\fB+noroot\fR\&.
|
\fB+noroot\fR
|
||||||
|
and
|
||||||
|
\fB+nodlv\fR\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]root[=ROOT]\fR
|
\fB+[no]root[=ROOT]\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Indicates whether to perform conventional DNSSEC validation, and if so, specifies the name of a trust anchor\&. The default is to validate using a trust anchor of "\&." (the root zone), for which there is a built\-in key\&. If specifying a different trust anchor, then
|
Indicates whether to perform conventional (non\-lookaside) DNSSEC validation, and if so, specifies the name of a trust anchor\&. The default is to validate using a trust anchor of "\&." (the root zone), for which there is a built\-in key\&. If specifying a different trust anchor, then
|
||||||
\fB\-a\fR
|
\fB\-a\fR
|
||||||
must be used to specify a file containing the key\&.
|
must be used to specify a file containing the key\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
|
\fB+[no]dlv[=DLV]\fR
|
||||||
|
.RS 4
|
||||||
|
Indicates whether to perform DNSSEC lookaside validation, and if so, specifies the name of the DLV trust anchor\&. The
|
||||||
|
\fB\-a\fR
|
||||||
|
option must also be used to specify a file containing the DLV key\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
\fB+[no]tcp\fR
|
\fB+[no]tcp\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Controls whether to use TCP when sending queries\&. The default is to use UDP unless a truncated response has been received\&.
|
Controls whether to use TCP when sending queries\&. The default is to use UDP unless a truncated response has been received\&.
|
||||||
@@ -409,11 +418,6 @@ Controls whether to use TCP when sending queries\&. The default is to use UDP un
|
|||||||
.RS 4
|
.RS 4
|
||||||
Print all RDATA in unknown RR type presentation format (RFC 3597)\&. The default is to print RDATA for known types in the type\*(Aqs presentation format\&.
|
Print all RDATA in unknown RR type presentation format (RFC 3597)\&. The default is to print RDATA for known types in the type\*(Aqs presentation format\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
|
||||||
\fB+[no]yaml\fR
|
|
||||||
.RS 4
|
|
||||||
Print response data in YAML format\&.
|
|
||||||
.RE
|
|
||||||
.SH "FILES"
|
.SH "FILES"
|
||||||
.PP
|
.PP
|
||||||
/etc/bind\&.keys
|
/etc/bind\&.keys
|
||||||
@@ -433,5 +437,5 @@ RFC5155\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
+194
-342
@@ -9,6 +9,7 @@
|
|||||||
* information regarding copyright ownership.
|
* information regarding copyright ownership.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
#include <bind.keys.h>
|
#include <bind.keys.h>
|
||||||
|
|
||||||
#ifndef WIN32
|
#ifndef WIN32
|
||||||
@@ -33,10 +34,8 @@
|
|||||||
#include <isc/app.h>
|
#include <isc/app.h>
|
||||||
#include <isc/base64.h>
|
#include <isc/base64.h>
|
||||||
#include <isc/buffer.h>
|
#include <isc/buffer.h>
|
||||||
#include <isc/hex.h>
|
|
||||||
#include <isc/lib.h>
|
#include <isc/lib.h>
|
||||||
#include <isc/log.h>
|
#include <isc/log.h>
|
||||||
#include <isc/md.h>
|
|
||||||
#include <isc/mem.h>
|
#include <isc/mem.h>
|
||||||
#ifdef WIN32
|
#ifdef WIN32
|
||||||
#include <isc/ntpaths.h>
|
#include <isc/ntpaths.h>
|
||||||
@@ -113,8 +112,7 @@ static bool
|
|||||||
nottl = false,
|
nottl = false,
|
||||||
multiline = false,
|
multiline = false,
|
||||||
short_form = false,
|
short_form = false,
|
||||||
print_unknown_format = false,
|
print_unknown_format = false;
|
||||||
yaml = false;
|
|
||||||
|
|
||||||
static bool
|
static bool
|
||||||
resolve_trace = false,
|
resolve_trace = false,
|
||||||
@@ -128,19 +126,21 @@ static bool
|
|||||||
static bool
|
static bool
|
||||||
cdflag = false,
|
cdflag = false,
|
||||||
no_sigs = false,
|
no_sigs = false,
|
||||||
root_validation = true;
|
root_validation = true,
|
||||||
|
dlv_validation = true;
|
||||||
|
|
||||||
static bool use_tcp = false;
|
static bool use_tcp = false;
|
||||||
|
|
||||||
static char *anchorfile = NULL;
|
static char *anchorfile = NULL;
|
||||||
static char *trust_anchor = NULL;
|
static char *trust_anchor = NULL;
|
||||||
static int num_keys = 0;
|
static char *dlv_anchor = NULL;
|
||||||
|
static int trusted_keys = 0;
|
||||||
|
|
||||||
static dns_fixedname_t afn;
|
static dns_fixedname_t afn, dfn;
|
||||||
static dns_name_t *anchor_name = NULL;
|
static dns_name_t *anchor_name = NULL, *dlv_name = NULL;
|
||||||
|
|
||||||
/* Default bind.keys contents */
|
/* Default bind.keys contents */
|
||||||
static char anchortext[] = TRUST_ANCHORS;
|
static char anchortext[] = MANAGED_KEYS;
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Static function prototypes
|
* Static function prototypes
|
||||||
@@ -160,44 +160,42 @@ usage(void) {
|
|||||||
" q-class is one of (in,hs,ch,...) [default: in]\n"
|
" q-class is one of (in,hs,ch,...) [default: in]\n"
|
||||||
" q-type is one of (a,any,mx,ns,soa,hinfo,axfr,txt,...) [default:a]\n"
|
" q-type is one of (a,any,mx,ns,soa,hinfo,axfr,txt,...) [default:a]\n"
|
||||||
" q-opt is one of:\n"
|
" q-opt is one of:\n"
|
||||||
" -4 (use IPv4 query transport only)\n"
|
" -x dot-notation (shortcut for reverse lookups)\n"
|
||||||
" -6 (use IPv6 query transport only)\n"
|
|
||||||
" -a anchor-file (specify root trust anchor)\n"
|
|
||||||
" -b address[#port] (bind to source address/port)\n"
|
|
||||||
" -c class (option included for compatibility;\n"
|
|
||||||
" -d level (set debugging level)\n"
|
" -d level (set debugging level)\n"
|
||||||
" -h (print help and exit)\n"
|
" -a anchor-file (specify root and dlv trust anchors)\n"
|
||||||
" -i (disable DNSSEC validation)\n"
|
" -b address[#port] (bind to source address/port)\n"
|
||||||
" -m (enable memory usage debugging)\n"
|
|
||||||
" -p port (specify port number)\n"
|
" -p port (specify port number)\n"
|
||||||
" -q name (specify query name)\n"
|
" -q name (specify query name)\n"
|
||||||
" -t type (specify query type)\n"
|
" -t type (specify query type)\n"
|
||||||
|
" -c class (option included for compatibility;\n"
|
||||||
" only IN is supported)\n"
|
" only IN is supported)\n"
|
||||||
" -v (print version and exit)\n"
|
" -4 (use IPv4 query transport only)\n"
|
||||||
" -x dot-notation (shortcut for reverse lookups)\n"
|
" -6 (use IPv6 query transport only)\n"
|
||||||
|
" -i (disable DNSSEC validation)\n"
|
||||||
|
" -m (enable memory usage debugging)\n"
|
||||||
" d-opt is of the form +keyword[=value], where keyword is:\n"
|
" d-opt is of the form +keyword[=value], where keyword is:\n"
|
||||||
" +[no]all (Set or clear all display flags)\n"
|
" +[no]all (Set or clear all display flags)\n"
|
||||||
" +[no]class (Control display of class)\n"
|
" +[no]class (Control display of class)\n"
|
||||||
" +[no]comments (Control display of comment lines)\n"
|
|
||||||
" +[no]crypto (Control display of cryptographic\n"
|
" +[no]crypto (Control display of cryptographic\n"
|
||||||
" fields in records)\n"
|
" fields in records)\n"
|
||||||
" +[no]dlv (Obsolete)\n"
|
|
||||||
" +[no]dnssec (Display DNSSEC records)\n"
|
|
||||||
" +[no]mtrace (Trace messages received)\n"
|
|
||||||
" +[no]multiline (Print records in an expanded format)\n"
|
" +[no]multiline (Print records in an expanded format)\n"
|
||||||
" +[no]root (DNSSEC validation trust anchor)\n"
|
" +[no]comments (Control display of comment lines)\n"
|
||||||
" +[no]rrcomments (Control display of per-record "
|
" +[no]rrcomments (Control display of per-record "
|
||||||
"comments)\n"
|
"comments)\n"
|
||||||
" +[no]rtrace (Trace resolver fetches)\n"
|
" +[no]unknownformat (Print RDATA in RFC 3597 \"unknown\" format)\n"
|
||||||
" +[no]short (Short form answer)\n"
|
" +[no]short (Short form answer)\n"
|
||||||
" +[no]split=## (Split hex/base64 fields into chunks)\n"
|
" +[no]split=## (Split hex/base64 fields into chunks)\n"
|
||||||
" +[no]tcp (TCP mode)\n"
|
" +[no]tcp (TCP mode)\n"
|
||||||
" +[no]ttl (Control display of ttls in records)\n"
|
" +[no]ttl (Control display of ttls in records)\n"
|
||||||
" +[no]trust (Control display of trust level)\n"
|
" +[no]trust (Control display of trust level)\n"
|
||||||
" +[no]unknownformat (Print RDATA in RFC 3597 "
|
" +[no]rtrace (Trace resolver fetches)\n"
|
||||||
"\"unknown\" format)\n"
|
" +[no]mtrace (Trace messages received)\n"
|
||||||
" +[no]vtrace (Trace validation process)\n"
|
" +[no]vtrace (Trace validation process)\n"
|
||||||
" +[no]yaml (Present the results as YAML)\n",
|
" +[no]dlv (DNSSEC lookaside validation anchor)\n"
|
||||||
|
" +[no]root (DNSSEC validation trust anchor)\n"
|
||||||
|
" +[no]dnssec (Display DNSSEC records)\n"
|
||||||
|
" -h (print help and exit)\n"
|
||||||
|
" -v (print version and exit)\n",
|
||||||
stderr);
|
stderr);
|
||||||
exit(1);
|
exit(1);
|
||||||
}
|
}
|
||||||
@@ -357,80 +355,53 @@ setup_logging(FILE *errout) {
|
|||||||
|
|
||||||
static void
|
static void
|
||||||
print_status(dns_rdataset_t *rdataset) {
|
print_status(dns_rdataset_t *rdataset) {
|
||||||
char buf[1024] = { 0 };
|
const char *astr = "", *tstr = "";
|
||||||
|
|
||||||
REQUIRE(rdataset != NULL);
|
REQUIRE(rdataset != NULL);
|
||||||
|
|
||||||
if (!showtrust || !dns_rdataset_isassociated(rdataset)) {
|
if (!showtrust || !dns_rdataset_isassociated(rdataset))
|
||||||
return;
|
return;
|
||||||
}
|
|
||||||
|
|
||||||
buf[0] = '\0';
|
if ((rdataset->attributes & DNS_RDATASETATTR_NEGATIVE) != 0)
|
||||||
|
astr = "negative response, ";
|
||||||
if ((rdataset->attributes & DNS_RDATASETATTR_NEGATIVE) != 0) {
|
|
||||||
strlcat(buf, "negative response", sizeof(buf));
|
|
||||||
strlcat(buf, (yaml ? "_" : ", "), sizeof(buf));
|
|
||||||
}
|
|
||||||
|
|
||||||
switch (rdataset->trust) {
|
switch (rdataset->trust) {
|
||||||
case dns_trust_none:
|
case dns_trust_none:
|
||||||
strlcat(buf, "untrusted", sizeof(buf));
|
tstr = "untrusted";
|
||||||
break;
|
break;
|
||||||
case dns_trust_pending_additional:
|
case dns_trust_pending_additional:
|
||||||
strlcat(buf, "signed additional data", sizeof(buf));
|
tstr = "signed additional data, pending validation";
|
||||||
if (!yaml) {
|
|
||||||
strlcat(buf, ", ", sizeof(buf));
|
|
||||||
}
|
|
||||||
strlcat(buf, "pending validation", sizeof(buf));
|
|
||||||
break;
|
break;
|
||||||
case dns_trust_pending_answer:
|
case dns_trust_pending_answer:
|
||||||
strlcat(buf, "signed answer", sizeof(buf));
|
tstr = "signed answer, pending validation";
|
||||||
if (!yaml) {
|
|
||||||
strlcat(buf, ", ", sizeof(buf));
|
|
||||||
}
|
|
||||||
strlcat(buf, "pending validation", sizeof(buf));
|
|
||||||
break;
|
break;
|
||||||
case dns_trust_additional:
|
case dns_trust_additional:
|
||||||
strlcat(buf, "unsigned additional data", sizeof(buf));
|
tstr = "unsigned additional data";
|
||||||
break;
|
break;
|
||||||
case dns_trust_glue:
|
case dns_trust_glue:
|
||||||
strlcat(buf, "glue data", sizeof(buf));
|
tstr = "glue data";
|
||||||
break;
|
break;
|
||||||
case dns_trust_answer:
|
case dns_trust_answer:
|
||||||
if (root_validation) {
|
if (root_validation || dlv_validation)
|
||||||
strlcat(buf, "unsigned answer", sizeof(buf));
|
tstr = "unsigned answer";
|
||||||
} else {
|
else
|
||||||
strlcat(buf, "answer not validated", sizeof(buf));
|
tstr = "answer not validated";
|
||||||
}
|
|
||||||
break;
|
break;
|
||||||
case dns_trust_authauthority:
|
case dns_trust_authauthority:
|
||||||
strlcat(buf, "authority data", sizeof(buf));
|
tstr = "authority data";
|
||||||
break;
|
break;
|
||||||
case dns_trust_authanswer:
|
case dns_trust_authanswer:
|
||||||
strlcat(buf, "authoritative", sizeof(buf));
|
tstr = "authoritative";
|
||||||
break;
|
break;
|
||||||
case dns_trust_secure:
|
case dns_trust_secure:
|
||||||
strlcat(buf, "fully validated", sizeof(buf));
|
tstr = "fully validated";
|
||||||
break;
|
break;
|
||||||
case dns_trust_ultimate:
|
case dns_trust_ultimate:
|
||||||
strlcat(buf, "ultimate trust", sizeof(buf));
|
tstr = "ultimate trust";
|
||||||
break;
|
break;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (yaml) {
|
printf("; %s%s\n", astr, tstr);
|
||||||
char *p;
|
|
||||||
|
|
||||||
/* Convert spaces to underscores for YAML */
|
|
||||||
for (p = buf; p != NULL && *p != '\0'; p++) {
|
|
||||||
if (*p == ' ') {
|
|
||||||
*p = '_';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
printf(" - %s:\n", buf);
|
|
||||||
} else {
|
|
||||||
printf("; %s\n", buf);
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
static isc_result_t
|
static isc_result_t
|
||||||
@@ -457,9 +428,8 @@ printdata(dns_rdataset_t *rdataset, dns_name_t *owner,
|
|||||||
return (ISC_R_SUCCESS);
|
return (ISC_R_SUCCESS);
|
||||||
|
|
||||||
if (first || rdataset->trust != trust) {
|
if (first || rdataset->trust != trust) {
|
||||||
if (!first && showtrust && !short_form && !yaml) {
|
if (!first && showtrust && !short_form)
|
||||||
putchar('\n');
|
putchar('\n');
|
||||||
}
|
|
||||||
print_status(rdataset);
|
print_status(rdataset);
|
||||||
trust = rdataset->trust;
|
trust = rdataset->trust;
|
||||||
first = false;
|
first = false;
|
||||||
@@ -467,6 +437,8 @@ printdata(dns_rdataset_t *rdataset, dns_name_t *owner,
|
|||||||
|
|
||||||
do {
|
do {
|
||||||
t = isc_mem_get(mctx, len);
|
t = isc_mem_get(mctx, len);
|
||||||
|
if (t == NULL)
|
||||||
|
return (ISC_R_NOMEMORY);
|
||||||
|
|
||||||
isc_buffer_init(&target, t, len);
|
isc_buffer_init(&target, t, len);
|
||||||
if (short_form) {
|
if (short_form) {
|
||||||
@@ -498,17 +470,12 @@ printdata(dns_rdataset_t *rdataset, dns_name_t *owner,
|
|||||||
dns_rdata_reset(&rdata);
|
dns_rdata_reset(&rdata);
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
dns_indent_t indent = { " ", 2 };
|
if ((rdataset->attributes &
|
||||||
if (!yaml && (rdataset->attributes &
|
DNS_RDATASETATTR_NEGATIVE) != 0)
|
||||||
DNS_RDATASETATTR_NEGATIVE) != 0)
|
|
||||||
{
|
|
||||||
isc_buffer_putstr(&target, "; ");
|
isc_buffer_putstr(&target, "; ");
|
||||||
}
|
|
||||||
result = dns_master_rdatasettotext(owner, rdataset,
|
result = dns_master_rdatasettotext(owner, rdataset,
|
||||||
style,
|
style, &target);
|
||||||
yaml ? &indent :
|
|
||||||
NULL,
|
|
||||||
&target);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
if (result == ISC_R_NOSPACE) {
|
if (result == ISC_R_NOSPACE) {
|
||||||
@@ -535,53 +502,41 @@ setup_style(dns_master_style_t **stylep) {
|
|||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
dns_master_style_t *style = NULL;
|
dns_master_style_t *style = NULL;
|
||||||
|
|
||||||
REQUIRE(stylep != NULL && *stylep == NULL);
|
REQUIRE(stylep != NULL || *stylep == NULL);
|
||||||
|
|
||||||
styleflags |= DNS_STYLEFLAG_REL_OWNER;
|
styleflags |= DNS_STYLEFLAG_REL_OWNER;
|
||||||
if (yaml) {
|
if (showcomments)
|
||||||
styleflags |= DNS_STYLEFLAG_YAML;
|
styleflags |= DNS_STYLEFLAG_COMMENT;
|
||||||
} else {
|
if (print_unknown_format)
|
||||||
if (showcomments) {
|
styleflags |= DNS_STYLEFLAG_UNKNOWNFORMAT;
|
||||||
styleflags |= DNS_STYLEFLAG_COMMENT;
|
if (rrcomments)
|
||||||
}
|
styleflags |= DNS_STYLEFLAG_RRCOMMENT;
|
||||||
if (print_unknown_format) {
|
if (nottl)
|
||||||
styleflags |= DNS_STYLEFLAG_UNKNOWNFORMAT;
|
styleflags |= DNS_STYLEFLAG_NO_TTL;
|
||||||
}
|
if (noclass)
|
||||||
if (rrcomments) {
|
styleflags |= DNS_STYLEFLAG_NO_CLASS;
|
||||||
styleflags |= DNS_STYLEFLAG_RRCOMMENT;
|
if (nocrypto)
|
||||||
}
|
styleflags |= DNS_STYLEFLAG_NOCRYPTO;
|
||||||
if (nottl) {
|
if (multiline) {
|
||||||
styleflags |= DNS_STYLEFLAG_NO_TTL;
|
styleflags |= DNS_STYLEFLAG_MULTILINE;
|
||||||
}
|
styleflags |= DNS_STYLEFLAG_COMMENT;
|
||||||
if (noclass) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_NO_CLASS;
|
|
||||||
}
|
|
||||||
if (nocrypto) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_NOCRYPTO;
|
|
||||||
}
|
|
||||||
if (multiline) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_MULTILINE;
|
|
||||||
styleflags |= DNS_STYLEFLAG_COMMENT;
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
if (multiline || (nottl && noclass)) {
|
if (multiline || (nottl && noclass))
|
||||||
result = dns_master_stylecreate(&style, styleflags,
|
result = dns_master_stylecreate(&style, styleflags,
|
||||||
24, 24, 24, 32, 80, 8,
|
24, 24, 24, 32, 80, 8,
|
||||||
splitwidth, mctx);
|
splitwidth, mctx);
|
||||||
} else if (nottl || noclass) {
|
else if (nottl || noclass)
|
||||||
result = dns_master_stylecreate(&style, styleflags,
|
result = dns_master_stylecreate(&style, styleflags,
|
||||||
24, 24, 32, 40, 80, 8,
|
24, 24, 32, 40, 80, 8,
|
||||||
splitwidth, mctx);
|
splitwidth, mctx);
|
||||||
} else {
|
else
|
||||||
result = dns_master_stylecreate(&style, styleflags,
|
result = dns_master_stylecreate(&style, styleflags,
|
||||||
24, 32, 40, 48, 80, 8,
|
24, 32, 40, 48, 80, 8,
|
||||||
splitwidth, mctx);
|
splitwidth, mctx);
|
||||||
}
|
|
||||||
|
|
||||||
if (result == ISC_R_SUCCESS) {
|
if (result == ISC_R_SUCCESS)
|
||||||
*stylep = style;
|
*stylep = style;
|
||||||
}
|
|
||||||
return (result);
|
return (result);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -612,161 +567,83 @@ convert_name(dns_fixedname_t *fn, dns_name_t **name, const char *text) {
|
|||||||
|
|
||||||
static isc_result_t
|
static isc_result_t
|
||||||
key_fromconfig(const cfg_obj_t *key, dns_client_t *client) {
|
key_fromconfig(const cfg_obj_t *key, dns_client_t *client) {
|
||||||
dns_rdata_dnskey_t dnskey;
|
dns_rdata_dnskey_t keystruct;
|
||||||
dns_rdata_ds_t ds;
|
uint32_t flags, proto, alg;
|
||||||
uint32_t rdata1, rdata2, rdata3;
|
const char *keystr, *keynamestr;
|
||||||
const char *datastr = NULL, *keynamestr = NULL, *atstr = NULL;
|
unsigned char keydata[4096];
|
||||||
unsigned char data[4096];
|
isc_buffer_t keydatabuf;
|
||||||
isc_buffer_t databuf;
|
|
||||||
unsigned char rrdata[4096];
|
unsigned char rrdata[4096];
|
||||||
isc_buffer_t rrdatabuf;
|
isc_buffer_t rrdatabuf;
|
||||||
isc_region_t r;
|
isc_region_t r;
|
||||||
dns_fixedname_t fkeyname;
|
dns_fixedname_t fkeyname;
|
||||||
dns_name_t *keyname;
|
dns_name_t *keyname;
|
||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
bool match_root = false;
|
bool match_root = false, match_dlv = false;
|
||||||
enum {
|
|
||||||
INITIAL_KEY,
|
|
||||||
STATIC_KEY,
|
|
||||||
INITIAL_DS,
|
|
||||||
STATIC_DS,
|
|
||||||
TRUSTED
|
|
||||||
} anchortype;
|
|
||||||
|
|
||||||
keynamestr = cfg_obj_asstring(cfg_tuple_get(key, "name"));
|
keynamestr = cfg_obj_asstring(cfg_tuple_get(key, "name"));
|
||||||
CHECK(convert_name(&fkeyname, &keyname, keynamestr));
|
CHECK(convert_name(&fkeyname, &keyname, keynamestr));
|
||||||
|
|
||||||
if (!root_validation) {
|
if (!root_validation && !dlv_validation)
|
||||||
return (ISC_R_SUCCESS);
|
return (ISC_R_SUCCESS);
|
||||||
}
|
|
||||||
|
|
||||||
if (anchor_name) {
|
if (anchor_name)
|
||||||
match_root = dns_name_equal(keyname, anchor_name);
|
match_root = dns_name_equal(keyname, anchor_name);
|
||||||
}
|
if (dlv_name)
|
||||||
|
match_dlv = dns_name_equal(keyname, dlv_name);
|
||||||
|
|
||||||
if (!match_root) {
|
if (!match_root && !match_dlv)
|
||||||
return (ISC_R_SUCCESS);
|
return (ISC_R_SUCCESS);
|
||||||
}
|
if ((!root_validation && match_root) || (!dlv_validation && match_dlv))
|
||||||
|
|
||||||
if (!root_validation) {
|
|
||||||
return (ISC_R_SUCCESS);
|
return (ISC_R_SUCCESS);
|
||||||
}
|
|
||||||
|
|
||||||
delv_log(ISC_LOG_DEBUG(3), "adding trust anchor %s", trust_anchor);
|
if (match_root)
|
||||||
|
delv_log(ISC_LOG_DEBUG(3), "adding trust anchor %s",
|
||||||
|
trust_anchor);
|
||||||
|
if (match_dlv)
|
||||||
|
delv_log(ISC_LOG_DEBUG(3), "adding DLV trust anchor %s",
|
||||||
|
dlv_anchor);
|
||||||
|
|
||||||
/* if DNSKEY, flags; if DS, key tag */
|
flags = cfg_obj_asuint32(cfg_tuple_get(key, "flags"));
|
||||||
rdata1 = cfg_obj_asuint32(cfg_tuple_get(key, "rdata1"));
|
proto = cfg_obj_asuint32(cfg_tuple_get(key, "protocol"));
|
||||||
|
alg = cfg_obj_asuint32(cfg_tuple_get(key, "algorithm"));
|
||||||
|
|
||||||
/* if DNSKEY, protocol; if DS, algorithm */
|
keystruct.common.rdclass = dns_rdataclass_in;
|
||||||
rdata2 = cfg_obj_asuint32(cfg_tuple_get(key, "rdata2"));
|
keystruct.common.rdtype = dns_rdatatype_dnskey;
|
||||||
|
/*
|
||||||
|
* The key data in keystruct is not dynamically allocated.
|
||||||
|
*/
|
||||||
|
keystruct.mctx = NULL;
|
||||||
|
|
||||||
/* if DNSKEY, algorithm; if DS, digest type */
|
ISC_LINK_INIT(&keystruct.common, link);
|
||||||
rdata3 = cfg_obj_asuint32(cfg_tuple_get(key, "rdata3"));
|
|
||||||
|
|
||||||
/* What type of trust anchor is this? */
|
if (flags > 0xffff)
|
||||||
atstr = cfg_obj_asstring(cfg_tuple_get(key, "anchortype"));
|
CHECK(ISC_R_RANGE);
|
||||||
if (strcasecmp(atstr, "static-key") == 0) {
|
if (proto > 0xff)
|
||||||
anchortype = STATIC_KEY;
|
CHECK(ISC_R_RANGE);
|
||||||
} else if (strcasecmp(atstr, "static-ds") == 0) {
|
if (alg > 0xff)
|
||||||
anchortype = STATIC_DS;
|
CHECK(ISC_R_RANGE);
|
||||||
} else if (strcasecmp(atstr, "initial-key") == 0) {
|
|
||||||
anchortype = INITIAL_KEY;
|
|
||||||
} else if (strcasecmp(atstr, "initial-ds") == 0) {
|
|
||||||
anchortype = INITIAL_DS;
|
|
||||||
} else {
|
|
||||||
delv_log(ISC_LOG_ERROR,
|
|
||||||
"key '%s': invalid initialization method '%s'",
|
|
||||||
keynamestr, atstr);
|
|
||||||
result = ISC_R_FAILURE;
|
|
||||||
goto cleanup;
|
|
||||||
}
|
|
||||||
|
|
||||||
isc_buffer_init(&databuf, data, sizeof(data));
|
keystruct.flags = (uint16_t)flags;
|
||||||
|
keystruct.protocol = (uint8_t)proto;
|
||||||
|
keystruct.algorithm = (uint8_t)alg;
|
||||||
|
|
||||||
|
isc_buffer_init(&keydatabuf, keydata, sizeof(keydata));
|
||||||
isc_buffer_init(&rrdatabuf, rrdata, sizeof(rrdata));
|
isc_buffer_init(&rrdatabuf, rrdata, sizeof(rrdata));
|
||||||
|
|
||||||
if (rdata1 > 0xffff) {
|
keystr = cfg_obj_asstring(cfg_tuple_get(key, "key"));
|
||||||
CHECK(ISC_R_RANGE);
|
CHECK(isc_base64_decodestring(keystr, &keydatabuf));
|
||||||
}
|
isc_buffer_usedregion(&keydatabuf, &r);
|
||||||
if (rdata2 > 0xff) {
|
keystruct.datalen = r.length;
|
||||||
CHECK(ISC_R_RANGE);
|
keystruct.data = r.base;
|
||||||
}
|
|
||||||
if (rdata3 > 0xff) {
|
|
||||||
CHECK(ISC_R_RANGE);
|
|
||||||
}
|
|
||||||
|
|
||||||
switch (anchortype) {
|
CHECK(dns_rdata_fromstruct(NULL,
|
||||||
case STATIC_KEY:
|
keystruct.common.rdclass,
|
||||||
case INITIAL_KEY:
|
keystruct.common.rdtype,
|
||||||
case TRUSTED:
|
&keystruct, &rrdatabuf));
|
||||||
dnskey.common.rdclass = dns_rdataclass_in;
|
|
||||||
dnskey.common.rdtype = dns_rdatatype_dnskey;
|
|
||||||
dnskey.mctx = NULL;
|
|
||||||
|
|
||||||
ISC_LINK_INIT(&dnskey.common, link);
|
CHECK(dns_client_addtrustedkey(client, dns_rdataclass_in,
|
||||||
|
keyname, &rrdatabuf));
|
||||||
dnskey.flags = (uint16_t)rdata1;
|
trusted_keys++;
|
||||||
dnskey.protocol = (uint8_t)rdata2;
|
|
||||||
dnskey.algorithm = (uint8_t)rdata3;
|
|
||||||
|
|
||||||
datastr = cfg_obj_asstring(cfg_tuple_get(key, "data"));
|
|
||||||
CHECK(isc_base64_decodestring(datastr, &databuf));
|
|
||||||
isc_buffer_usedregion(&databuf, &r);
|
|
||||||
dnskey.datalen = r.length;
|
|
||||||
dnskey.data = r.base;
|
|
||||||
|
|
||||||
CHECK(dns_rdata_fromstruct(NULL, dnskey.common.rdclass,
|
|
||||||
dnskey.common.rdtype,
|
|
||||||
&dnskey, &rrdatabuf));
|
|
||||||
CHECK(dns_client_addtrustedkey(client, dns_rdataclass_in,
|
|
||||||
dns_rdatatype_dnskey,
|
|
||||||
keyname, &rrdatabuf));
|
|
||||||
break;
|
|
||||||
case INITIAL_DS:
|
|
||||||
case STATIC_DS:
|
|
||||||
ds.common.rdclass = dns_rdataclass_in;
|
|
||||||
ds.common.rdtype = dns_rdatatype_ds;
|
|
||||||
ds.mctx = NULL;
|
|
||||||
|
|
||||||
ISC_LINK_INIT(&ds.common, link);
|
|
||||||
|
|
||||||
ds.key_tag = (uint16_t)rdata1;
|
|
||||||
ds.algorithm = (uint8_t)rdata2;
|
|
||||||
ds.digest_type = (uint8_t)rdata3;
|
|
||||||
|
|
||||||
datastr = cfg_obj_asstring(cfg_tuple_get(key, "data"));
|
|
||||||
CHECK(isc_hex_decodestring(datastr, &databuf));
|
|
||||||
isc_buffer_usedregion(&databuf, &r);
|
|
||||||
|
|
||||||
switch (ds.digest_type) {
|
|
||||||
case DNS_DSDIGEST_SHA1:
|
|
||||||
if (r.length != ISC_SHA1_DIGESTLENGTH) {
|
|
||||||
CHECK(ISC_R_UNEXPECTEDEND);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case DNS_DSDIGEST_SHA256:
|
|
||||||
if (r.length != ISC_SHA256_DIGESTLENGTH) {
|
|
||||||
CHECK(ISC_R_UNEXPECTEDEND);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case DNS_DSDIGEST_SHA384:
|
|
||||||
if (r.length != ISC_SHA384_DIGESTLENGTH) {
|
|
||||||
CHECK(ISC_R_UNEXPECTEDEND);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
ds.length = r.length;
|
|
||||||
ds.digest = r.base;
|
|
||||||
|
|
||||||
CHECK(dns_rdata_fromstruct(NULL, ds.common.rdclass,
|
|
||||||
ds.common.rdtype,
|
|
||||||
&ds, &rrdatabuf));
|
|
||||||
CHECK(dns_client_addtrustedkey(client, dns_rdataclass_in,
|
|
||||||
dns_rdatatype_ds,
|
|
||||||
keyname, &rrdatabuf));
|
|
||||||
};
|
|
||||||
|
|
||||||
num_keys++;
|
|
||||||
|
|
||||||
cleanup:
|
cleanup:
|
||||||
if (result == DST_R_NOCRYPTO)
|
if (result == DST_R_NOCRYPTO)
|
||||||
@@ -817,15 +694,13 @@ static isc_result_t
|
|||||||
setup_dnsseckeys(dns_client_t *client) {
|
setup_dnsseckeys(dns_client_t *client) {
|
||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
cfg_parser_t *parser = NULL;
|
cfg_parser_t *parser = NULL;
|
||||||
const cfg_obj_t *trusted_keys = NULL;
|
const cfg_obj_t *keys = NULL;
|
||||||
const cfg_obj_t *managed_keys = NULL;
|
const cfg_obj_t *managed_keys = NULL;
|
||||||
const cfg_obj_t *trust_anchors = NULL;
|
|
||||||
cfg_obj_t *bindkeys = NULL;
|
cfg_obj_t *bindkeys = NULL;
|
||||||
const char *filename = anchorfile;
|
const char *filename = anchorfile;
|
||||||
|
|
||||||
if (!root_validation) {
|
if (!root_validation && !dlv_validation)
|
||||||
return (ISC_R_SUCCESS);
|
return (ISC_R_SUCCESS);
|
||||||
}
|
|
||||||
|
|
||||||
if (filename == NULL) {
|
if (filename == NULL) {
|
||||||
#ifndef WIN32
|
#ifndef WIN32
|
||||||
@@ -840,27 +715,27 @@ setup_dnsseckeys(dns_client_t *client) {
|
|||||||
|
|
||||||
if (trust_anchor == NULL) {
|
if (trust_anchor == NULL) {
|
||||||
trust_anchor = isc_mem_strdup(mctx, ".");
|
trust_anchor = isc_mem_strdup(mctx, ".");
|
||||||
|
if (trust_anchor == NULL)
|
||||||
|
fatal("out of memory");
|
||||||
}
|
}
|
||||||
|
|
||||||
if (trust_anchor != NULL) {
|
if (trust_anchor != NULL)
|
||||||
CHECK(convert_name(&afn, &anchor_name, trust_anchor));
|
CHECK(convert_name(&afn, &anchor_name, trust_anchor));
|
||||||
}
|
if (dlv_anchor != NULL)
|
||||||
|
CHECK(convert_name(&dfn, &dlv_name, dlv_anchor));
|
||||||
|
|
||||||
CHECK(cfg_parser_create(mctx, dns_lctx, &parser));
|
CHECK(cfg_parser_create(mctx, dns_lctx, &parser));
|
||||||
|
|
||||||
if (access(filename, R_OK) != 0) {
|
if (access(filename, R_OK) != 0) {
|
||||||
if (anchorfile != NULL) {
|
if (anchorfile != NULL)
|
||||||
fatal("Unable to read key file '%s'", anchorfile);
|
fatal("Unable to read key file '%s'", anchorfile);
|
||||||
}
|
|
||||||
} else {
|
} else {
|
||||||
result = cfg_parse_file(parser, filename,
|
result = cfg_parse_file(parser, filename,
|
||||||
&cfg_type_bindkeys, &bindkeys);
|
&cfg_type_bindkeys, &bindkeys);
|
||||||
if (result != ISC_R_SUCCESS) {
|
if (result != ISC_R_SUCCESS)
|
||||||
if (anchorfile != NULL) {
|
if (anchorfile != NULL)
|
||||||
fatal("Unable to load keys from '%s'",
|
fatal("Unable to load keys from '%s'",
|
||||||
anchorfile);
|
anchorfile);
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
if (bindkeys == NULL) {
|
if (bindkeys == NULL) {
|
||||||
@@ -868,44 +743,32 @@ setup_dnsseckeys(dns_client_t *client) {
|
|||||||
|
|
||||||
isc_buffer_init(&b, anchortext, sizeof(anchortext) - 1);
|
isc_buffer_init(&b, anchortext, sizeof(anchortext) - 1);
|
||||||
isc_buffer_add(&b, sizeof(anchortext) - 1);
|
isc_buffer_add(&b, sizeof(anchortext) - 1);
|
||||||
result = cfg_parse_buffer(parser, &b, NULL, 0,
|
result = cfg_parse_buffer(parser, &b, &cfg_type_bindkeys,
|
||||||
&cfg_type_bindkeys, 0, &bindkeys);
|
&bindkeys);
|
||||||
if (result != ISC_R_SUCCESS) {
|
if (result != ISC_R_SUCCESS)
|
||||||
fatal("Unable to parse built-in keys");
|
fatal("Unable to parse built-in keys");
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
INSIST(bindkeys != NULL);
|
INSIST(bindkeys != NULL);
|
||||||
cfg_map_get(bindkeys, "trusted-keys", &trusted_keys);
|
cfg_map_get(bindkeys, "trusted-keys", &keys);
|
||||||
cfg_map_get(bindkeys, "managed-keys", &managed_keys);
|
cfg_map_get(bindkeys, "managed-keys", &managed_keys);
|
||||||
cfg_map_get(bindkeys, "trust-anchors", &trust_anchors);
|
|
||||||
|
|
||||||
if (trusted_keys != NULL) {
|
if (keys != NULL)
|
||||||
CHECK(load_keys(trusted_keys, client));
|
CHECK(load_keys(keys, client));
|
||||||
}
|
if (managed_keys != NULL)
|
||||||
if (managed_keys != NULL) {
|
|
||||||
CHECK(load_keys(managed_keys, client));
|
CHECK(load_keys(managed_keys, client));
|
||||||
}
|
|
||||||
if (trust_anchors != NULL) {
|
|
||||||
CHECK(load_keys(trust_anchors, client));
|
|
||||||
}
|
|
||||||
result = ISC_R_SUCCESS;
|
result = ISC_R_SUCCESS;
|
||||||
|
|
||||||
if (num_keys == 0) {
|
if (trusted_keys == 0)
|
||||||
fatal("No trusted keys were loaded");
|
fatal("No trusted keys were loaded");
|
||||||
}
|
|
||||||
|
if (dlv_validation)
|
||||||
|
dns_client_setdlv(client, dns_rdataclass_in, dlv_anchor);
|
||||||
|
|
||||||
cleanup:
|
cleanup:
|
||||||
if (bindkeys != NULL) {
|
if (result != ISC_R_SUCCESS)
|
||||||
cfg_obj_destroy(parser, &bindkeys);
|
|
||||||
}
|
|
||||||
if (parser != NULL) {
|
|
||||||
cfg_parser_destroy(&parser);
|
|
||||||
}
|
|
||||||
if (result != ISC_R_SUCCESS) {
|
|
||||||
delv_log(ISC_LOG_ERROR, "setup_dnsseckeys: %s",
|
delv_log(ISC_LOG_ERROR, "setup_dnsseckeys: %s",
|
||||||
isc_result_totext(result));
|
isc_result_totext(result));
|
||||||
}
|
|
||||||
return (result);
|
return (result);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -932,6 +795,8 @@ addserver(dns_client_t *client) {
|
|||||||
fatal("Use of IPv4 disabled by -6");
|
fatal("Use of IPv4 disabled by -6");
|
||||||
}
|
}
|
||||||
sa = isc_mem_get(mctx, sizeof(*sa));
|
sa = isc_mem_get(mctx, sizeof(*sa));
|
||||||
|
if (sa == NULL)
|
||||||
|
return (ISC_R_NOMEMORY);
|
||||||
ISC_LINK_INIT(sa, link);
|
ISC_LINK_INIT(sa, link);
|
||||||
isc_sockaddr_fromin(sa, &in4, destport);
|
isc_sockaddr_fromin(sa, &in4, destport);
|
||||||
ISC_LIST_APPEND(servers, sa, link);
|
ISC_LIST_APPEND(servers, sa, link);
|
||||||
@@ -940,6 +805,8 @@ addserver(dns_client_t *client) {
|
|||||||
fatal("Use of IPv6 disabled by -4");
|
fatal("Use of IPv6 disabled by -4");
|
||||||
}
|
}
|
||||||
sa = isc_mem_get(mctx, sizeof(*sa));
|
sa = isc_mem_get(mctx, sizeof(*sa));
|
||||||
|
if (sa == NULL)
|
||||||
|
return (ISC_R_NOMEMORY);
|
||||||
ISC_LINK_INIT(sa, link);
|
ISC_LINK_INIT(sa, link);
|
||||||
isc_sockaddr_fromin6(sa, &in6, destport);
|
isc_sockaddr_fromin6(sa, &in6, destport);
|
||||||
ISC_LIST_APPEND(servers, sa, link);
|
ISC_LIST_APPEND(servers, sa, link);
|
||||||
@@ -967,6 +834,10 @@ addserver(dns_client_t *client) {
|
|||||||
cur->ai_family != AF_INET6)
|
cur->ai_family != AF_INET6)
|
||||||
continue;
|
continue;
|
||||||
sa = isc_mem_get(mctx, sizeof(*sa));
|
sa = isc_mem_get(mctx, sizeof(*sa));
|
||||||
|
if (sa == NULL) {
|
||||||
|
result = ISC_R_NOMEMORY;
|
||||||
|
break;
|
||||||
|
}
|
||||||
memset(sa, 0, sizeof(*sa));
|
memset(sa, 0, sizeof(*sa));
|
||||||
ISC_LINK_INIT(sa, link);
|
ISC_LINK_INIT(sa, link);
|
||||||
memmove(&sa->type, cur->ai_addr, cur->ai_addrlen);
|
memmove(&sa->type, cur->ai_addr, cur->ai_addrlen);
|
||||||
@@ -1039,6 +910,10 @@ findserver(dns_client_t *client) {
|
|||||||
struct in_addr localhost;
|
struct in_addr localhost;
|
||||||
localhost.s_addr = htonl(INADDR_LOOPBACK);
|
localhost.s_addr = htonl(INADDR_LOOPBACK);
|
||||||
sa = isc_mem_get(mctx, sizeof(*sa));
|
sa = isc_mem_get(mctx, sizeof(*sa));
|
||||||
|
if (sa == NULL) {
|
||||||
|
result = ISC_R_NOMEMORY;
|
||||||
|
goto cleanup;
|
||||||
|
}
|
||||||
isc_sockaddr_fromin(sa, &localhost, destport);
|
isc_sockaddr_fromin(sa, &localhost, destport);
|
||||||
|
|
||||||
ISC_LINK_INIT(sa, link);
|
ISC_LINK_INIT(sa, link);
|
||||||
@@ -1047,6 +922,10 @@ findserver(dns_client_t *client) {
|
|||||||
|
|
||||||
if (use_ipv6) {
|
if (use_ipv6) {
|
||||||
sa = isc_mem_get(mctx, sizeof(*sa));
|
sa = isc_mem_get(mctx, sizeof(*sa));
|
||||||
|
if (sa == NULL) {
|
||||||
|
result = ISC_R_NOMEMORY;
|
||||||
|
goto cleanup;
|
||||||
|
}
|
||||||
isc_sockaddr_fromin6(sa, &in6addr_loopback, destport);
|
isc_sockaddr_fromin6(sa, &in6addr_loopback, destport);
|
||||||
|
|
||||||
ISC_LINK_INIT(sa, link);
|
ISC_LINK_INIT(sa, link);
|
||||||
@@ -1142,10 +1021,13 @@ plus_option(char *option) {
|
|||||||
switch (cmd[1]) {
|
switch (cmd[1]) {
|
||||||
case 'l': /* dlv */
|
case 'l': /* dlv */
|
||||||
FULLCHECK("dlv");
|
FULLCHECK("dlv");
|
||||||
if (state) {
|
if (state && no_sigs)
|
||||||
fprintf(stderr, "Invalid option: "
|
break;
|
||||||
"+dlv is obsolete\n");
|
dlv_validation = state;
|
||||||
exit(1);
|
if (value != NULL) {
|
||||||
|
dlv_anchor = isc_mem_strdup(mctx, value);
|
||||||
|
if (dlv_anchor == NULL)
|
||||||
|
fatal("out of memory");
|
||||||
}
|
}
|
||||||
break;
|
break;
|
||||||
case 'n': /* dnssec */
|
case 'n': /* dnssec */
|
||||||
@@ -1180,6 +1062,8 @@ plus_option(char *option) {
|
|||||||
root_validation = state;
|
root_validation = state;
|
||||||
if (value != NULL) {
|
if (value != NULL) {
|
||||||
trust_anchor = isc_mem_strdup(mctx, value);
|
trust_anchor = isc_mem_strdup(mctx, value);
|
||||||
|
if (trust_anchor == NULL)
|
||||||
|
fatal("out of memory");
|
||||||
}
|
}
|
||||||
break;
|
break;
|
||||||
case 'r': /* rrcomments */
|
case 'r': /* rrcomments */
|
||||||
@@ -1267,13 +1151,6 @@ plus_option(char *option) {
|
|||||||
if (state)
|
if (state)
|
||||||
resolve_trace = state;
|
resolve_trace = state;
|
||||||
break;
|
break;
|
||||||
case 'y': /* yaml */
|
|
||||||
FULLCHECK("yaml");
|
|
||||||
yaml = state;
|
|
||||||
if (state) {
|
|
||||||
rrcomments = false;
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
default:
|
default:
|
||||||
invalid_option:
|
invalid_option:
|
||||||
/*
|
/*
|
||||||
@@ -1290,8 +1167,6 @@ plus_option(char *option) {
|
|||||||
* options: "46a:b:c:d:himp:q:t:vx:";
|
* options: "46a:b:c:d:himp:q:t:vx:";
|
||||||
*/
|
*/
|
||||||
static const char *single_dash_opts = "46himv";
|
static const char *single_dash_opts = "46himv";
|
||||||
static const char *dash_opts = "46abcdhimpqtvx";
|
|
||||||
|
|
||||||
static bool
|
static bool
|
||||||
dash_option(char *option, char *next, bool *open_type_class) {
|
dash_option(char *option, char *next, bool *open_type_class) {
|
||||||
char opt, *value;
|
char opt, *value;
|
||||||
@@ -1337,6 +1212,7 @@ dash_option(char *option, char *next, bool *open_type_class) {
|
|||||||
/* NOTREACHED */
|
/* NOTREACHED */
|
||||||
case 'i':
|
case 'i':
|
||||||
no_sigs = true;
|
no_sigs = true;
|
||||||
|
dlv_validation = false;
|
||||||
root_validation = false;
|
root_validation = false;
|
||||||
break;
|
break;
|
||||||
case 'm':
|
case 'm':
|
||||||
@@ -1348,7 +1224,6 @@ dash_option(char *option, char *next, bool *open_type_class) {
|
|||||||
/* NOTREACHED */
|
/* NOTREACHED */
|
||||||
default:
|
default:
|
||||||
INSIST(0);
|
INSIST(0);
|
||||||
ISC_UNREACHABLE();
|
|
||||||
}
|
}
|
||||||
if (strlen(option) > 1U)
|
if (strlen(option) > 1U)
|
||||||
option = &option[1];
|
option = &option[1];
|
||||||
@@ -1368,6 +1243,8 @@ dash_option(char *option, char *next, bool *open_type_class) {
|
|||||||
switch (opt) {
|
switch (opt) {
|
||||||
case 'a':
|
case 'a':
|
||||||
anchorfile = isc_mem_strdup(mctx, value);
|
anchorfile = isc_mem_strdup(mctx, value);
|
||||||
|
if (anchorfile == NULL)
|
||||||
|
fatal("out of memory");
|
||||||
return (value_from_next);
|
return (value_from_next);
|
||||||
case 'b':
|
case 'b':
|
||||||
hash = strchr(value, '#');
|
hash = strchr(value, '#');
|
||||||
@@ -1431,6 +1308,8 @@ dash_option(char *option, char *next, bool *open_type_class) {
|
|||||||
isc_mem_free(mctx, curqname);
|
isc_mem_free(mctx, curqname);
|
||||||
}
|
}
|
||||||
curqname = isc_mem_strdup(mctx, value);
|
curqname = isc_mem_strdup(mctx, value);
|
||||||
|
if (curqname == NULL)
|
||||||
|
fatal("out of memory");
|
||||||
return (value_from_next);
|
return (value_from_next);
|
||||||
case 't':
|
case 't':
|
||||||
*open_type_class = false;
|
*open_type_class = false;
|
||||||
@@ -1458,6 +1337,8 @@ dash_option(char *option, char *next, bool *open_type_class) {
|
|||||||
warn("extra query name");
|
warn("extra query name");
|
||||||
}
|
}
|
||||||
curqname = isc_mem_strdup(mctx, textname);
|
curqname = isc_mem_strdup(mctx, textname);
|
||||||
|
if (curqname == NULL)
|
||||||
|
fatal("out of memory");
|
||||||
if (typeset)
|
if (typeset)
|
||||||
warn("extra query type");
|
warn("extra query type");
|
||||||
qtype = dns_rdatatype_ptr;
|
qtype = dns_rdatatype_ptr;
|
||||||
@@ -1486,10 +1367,8 @@ preparse_args(int argc, char **argv) {
|
|||||||
char *option;
|
char *option;
|
||||||
|
|
||||||
for (argc--, argv++; argc > 0; argc--, argv++) {
|
for (argc--, argv++; argc > 0; argc--, argv++) {
|
||||||
if (argv[0][0] != '-') {
|
if (argv[0][0] != '-')
|
||||||
continue;
|
continue;
|
||||||
}
|
|
||||||
|
|
||||||
option = &argv[0][1];
|
option = &argv[0][1];
|
||||||
while (strpbrk(option, single_dash_opts) == &option[0]) {
|
while (strpbrk(option, single_dash_opts) == &option[0]) {
|
||||||
switch (option[0]) {
|
switch (option[0]) {
|
||||||
@@ -1512,27 +1391,6 @@ preparse_args(int argc, char **argv) {
|
|||||||
}
|
}
|
||||||
option = &option[1];
|
option = &option[1];
|
||||||
}
|
}
|
||||||
|
|
||||||
if (strlen(option) == 0U) {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Look for dash value option. */
|
|
||||||
if (strpbrk(option, dash_opts) != &option[0] ||
|
|
||||||
strlen(option) > 1U)
|
|
||||||
{
|
|
||||||
/* Error or value in option. */
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Dash value is next argument so we need to skip it. */
|
|
||||||
argc--;
|
|
||||||
argv++;
|
|
||||||
|
|
||||||
/* Handle missing argument */
|
|
||||||
if (argc == 0) {
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -1604,6 +1462,8 @@ parse_args(int argc, char **argv) {
|
|||||||
|
|
||||||
if (curqname == NULL) {
|
if (curqname == NULL) {
|
||||||
curqname = isc_mem_strdup(mctx, argv[0]);
|
curqname = isc_mem_strdup(mctx, argv[0]);
|
||||||
|
if (curqname == NULL)
|
||||||
|
fatal("out of memory");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1617,6 +1477,8 @@ parse_args(int argc, char **argv) {
|
|||||||
|
|
||||||
if (curqname == NULL) {
|
if (curqname == NULL) {
|
||||||
qname = isc_mem_strdup(mctx, ".");
|
qname = isc_mem_strdup(mctx, ".");
|
||||||
|
if (qname == NULL)
|
||||||
|
fatal("out of memory");
|
||||||
|
|
||||||
if (!typeset)
|
if (!typeset)
|
||||||
qtype = dns_rdatatype_ns;
|
qtype = dns_rdatatype_ns;
|
||||||
@@ -1700,7 +1562,6 @@ main(int argc, char *argv[]) {
|
|||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
dns_fixedname_t qfn;
|
dns_fixedname_t qfn;
|
||||||
dns_name_t *query_name, *response_name;
|
dns_name_t *query_name, *response_name;
|
||||||
char namestr[DNS_NAME_FORMATSIZE];
|
|
||||||
dns_rdataset_t *rdataset;
|
dns_rdataset_t *rdataset;
|
||||||
dns_namelist_t namelist;
|
dns_namelist_t namelist;
|
||||||
unsigned int resopt, clopt;
|
unsigned int resopt, clopt;
|
||||||
@@ -1724,12 +1585,14 @@ main(int argc, char *argv[]) {
|
|||||||
if (result != ISC_R_SUCCESS)
|
if (result != ISC_R_SUCCESS)
|
||||||
fatal("dns_lib_init failed: %d", result);
|
fatal("dns_lib_init failed: %d", result);
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
result = isc_mem_create(0, 0, &mctx);
|
||||||
|
if (result != ISC_R_SUCCESS)
|
||||||
|
fatal("failed to create mctx");
|
||||||
|
|
||||||
CHECK(isc_appctx_create(mctx, &actx));
|
CHECK(isc_appctx_create(mctx, &actx));
|
||||||
CHECK(isc_taskmgr_createinctx(mctx, 1, 0, &taskmgr));
|
CHECK(isc_taskmgr_createinctx(mctx, actx, 1, 0, &taskmgr));
|
||||||
CHECK(isc_socketmgr_createinctx(mctx, &socketmgr));
|
CHECK(isc_socketmgr_createinctx(mctx, actx, &socketmgr));
|
||||||
CHECK(isc_timermgr_createinctx(mctx, &timermgr));
|
CHECK(isc_timermgr_createinctx(mctx, actx, &timermgr));
|
||||||
|
|
||||||
parse_args(argc, argv);
|
parse_args(argc, argv);
|
||||||
|
|
||||||
@@ -1770,35 +1633,22 @@ main(int argc, char *argv[]) {
|
|||||||
|
|
||||||
/* Set up resolution options */
|
/* Set up resolution options */
|
||||||
resopt = DNS_CLIENTRESOPT_ALLOWRUN | DNS_CLIENTRESOPT_NOCDFLAG;
|
resopt = DNS_CLIENTRESOPT_ALLOWRUN | DNS_CLIENTRESOPT_NOCDFLAG;
|
||||||
if (no_sigs) {
|
if (no_sigs)
|
||||||
resopt |= DNS_CLIENTRESOPT_NODNSSEC;
|
resopt |= DNS_CLIENTRESOPT_NODNSSEC;
|
||||||
}
|
if (!root_validation && !dlv_validation)
|
||||||
if (!root_validation) {
|
|
||||||
resopt |= DNS_CLIENTRESOPT_NOVALIDATE;
|
resopt |= DNS_CLIENTRESOPT_NOVALIDATE;
|
||||||
}
|
if (cdflag)
|
||||||
if (cdflag) {
|
|
||||||
resopt &= ~DNS_CLIENTRESOPT_NOCDFLAG;
|
resopt &= ~DNS_CLIENTRESOPT_NOCDFLAG;
|
||||||
}
|
if (use_tcp)
|
||||||
if (use_tcp) {
|
|
||||||
resopt |= DNS_CLIENTRESOPT_TCP;
|
resopt |= DNS_CLIENTRESOPT_TCP;
|
||||||
}
|
|
||||||
|
|
||||||
/* Perform resolution */
|
/* Perform resolution */
|
||||||
ISC_LIST_INIT(namelist);
|
ISC_LIST_INIT(namelist);
|
||||||
result = dns_client_resolve(client, query_name, dns_rdataclass_in,
|
result = dns_client_resolve(client, query_name, dns_rdataclass_in,
|
||||||
qtype, resopt, &namelist);
|
qtype, resopt, &namelist);
|
||||||
if (result != ISC_R_SUCCESS && !yaml) {
|
if (result != ISC_R_SUCCESS)
|
||||||
delv_log(ISC_LOG_ERROR, "resolution failed: %s",
|
delv_log(ISC_LOG_ERROR, "resolution failed: %s",
|
||||||
isc_result_totext(result));
|
isc_result_totext(result));
|
||||||
}
|
|
||||||
|
|
||||||
if (yaml) {
|
|
||||||
printf("type: DELV_RESULT\n");
|
|
||||||
dns_name_format(query_name, namestr, sizeof(namestr));
|
|
||||||
printf("query_name: %s\n", namestr);
|
|
||||||
printf("status: %s\n", isc_result_totext(result));
|
|
||||||
printf("records:\n");
|
|
||||||
}
|
|
||||||
|
|
||||||
for (response_name = ISC_LIST_HEAD(namelist);
|
for (response_name = ISC_LIST_HEAD(namelist);
|
||||||
response_name != NULL;
|
response_name != NULL;
|
||||||
@@ -1815,6 +1665,8 @@ main(int argc, char *argv[]) {
|
|||||||
dns_client_freeresanswer(client, &namelist);
|
dns_client_freeresanswer(client, &namelist);
|
||||||
|
|
||||||
cleanup:
|
cleanup:
|
||||||
|
if (dlv_anchor != NULL)
|
||||||
|
isc_mem_free(mctx, dlv_anchor);
|
||||||
if (trust_anchor != NULL)
|
if (trust_anchor != NULL)
|
||||||
isc_mem_free(mctx, trust_anchor);
|
isc_mem_free(mctx, trust_anchor);
|
||||||
if (anchorfile != NULL)
|
if (anchorfile != NULL)
|
||||||
|
|||||||
+28
-27
@@ -39,8 +39,6 @@
|
|||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2017</year>
|
<year>2017</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
@@ -97,7 +95,7 @@
|
|||||||
<command>delv</command> will send to a specified name server all
|
<command>delv</command> will send to a specified name server all
|
||||||
queries needed to fetch and validate the requested data; this
|
queries needed to fetch and validate the requested data; this
|
||||||
includes the original requested query, subsequent queries to follow
|
includes the original requested query, subsequent queries to follow
|
||||||
CNAME or DNAME chains, and queries for DNSKEY and DS records
|
CNAME or DNAME chains, and queries for DNSKEY, DS and DLV records
|
||||||
to establish a chain of trust for DNSSEC validation.
|
to establish a chain of trust for DNSSEC validation.
|
||||||
It does not perform iterative resolution, but simulates the
|
It does not perform iterative resolution, but simulates the
|
||||||
behavior of a name server configured for DNSSEC validating and
|
behavior of a name server configured for DNSSEC validating and
|
||||||
@@ -212,21 +210,21 @@
|
|||||||
<para>
|
<para>
|
||||||
Keys that do not match the root zone name are ignored.
|
Keys that do not match the root zone name are ignored.
|
||||||
An alternate key name can be specified using the
|
An alternate key name can be specified using the
|
||||||
<option>+root=NAME</option> options.
|
<option>+root=NAME</option> options. DNSSEC Lookaside
|
||||||
|
Validation can also be turned on by using the
|
||||||
|
<option>+dlv=NAME</option> to specify the name of a
|
||||||
|
zone containing DLV records.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Note: When reading the trust anchor file,
|
Note: When reading the trust anchor file,
|
||||||
<command>delv</command> treats <option>trust-anchors</option>
|
<command>delv</command> treats <option>managed-keys</option>
|
||||||
<option>initial-key</option> and <option>static-key</option>
|
statements and <option>trusted-keys</option> statements
|
||||||
entries identically. That is, even if a key is configured
|
identically. That is, for a managed key, it is the
|
||||||
with <command>initial-key</command>, indicating that it is
|
<emphasis>initial</emphasis> key that is trusted; RFC 5011
|
||||||
meant to be used only as an initializing key for RFC 5011
|
key management is not supported. <command>delv</command>
|
||||||
key maintenance, it is still treated by <command>delv</command>
|
will not consult the managed-keys database maintained by
|
||||||
as if it had been configured as a <command>static-key</command>.
|
<command>named</command>. This means that if either of the
|
||||||
<command>delv</command> does not consult the managed keys
|
keys in <filename>/etc/bind.keys</filename> is revoked
|
||||||
database maintained by <command>named</command>. This means
|
|
||||||
that if either of the keys in
|
|
||||||
<filename>/etc/bind.keys</filename> is revoked
|
|
||||||
and rolled over, it will be necessary to update
|
and rolled over, it will be necessary to update
|
||||||
<filename>/etc/bind.keys</filename> to use DNSSEC
|
<filename>/etc/bind.keys</filename> to use DNSSEC
|
||||||
validation in <command>delv</command>.
|
validation in <command>delv</command>.
|
||||||
@@ -618,7 +616,8 @@
|
|||||||
request DNSSEC records or whether to validate them.
|
request DNSSEC records or whether to validate them.
|
||||||
DNSSEC records are always requested, and validation
|
DNSSEC records are always requested, and validation
|
||||||
will always occur unless suppressed by the use of
|
will always occur unless suppressed by the use of
|
||||||
<option>-i</option> or <option>+noroot</option>.
|
<option>-i</option> or <option>+noroot</option> and
|
||||||
|
<option>+nodlv</option>.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -627,7 +626,7 @@
|
|||||||
<term><option>+[no]root[=ROOT]</option></term>
|
<term><option>+[no]root[=ROOT]</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Indicates whether to perform conventional
|
Indicates whether to perform conventional (non-lookaside)
|
||||||
DNSSEC validation, and if so, specifies the
|
DNSSEC validation, and if so, specifies the
|
||||||
name of a trust anchor. The default is to validate using
|
name of a trust anchor. The default is to validate using
|
||||||
a trust anchor of "." (the root zone), for which there is
|
a trust anchor of "." (the root zone), for which there is
|
||||||
@@ -638,6 +637,18 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><option>+[no]dlv[=DLV]</option></term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Indicates whether to perform DNSSEC lookaside validation,
|
||||||
|
and if so, specifies the name of the DLV trust anchor.
|
||||||
|
The <option>-a</option> option must also be used to specify
|
||||||
|
a file containing the DLV key.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><option>+[no]tcp</option></term>
|
<term><option>+[no]tcp</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
@@ -659,16 +670,6 @@
|
|||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><option>+[no]yaml</option></term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Print response data in YAML format.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
</variablelist>
|
</variablelist>
|
||||||
|
|
||||||
</para>
|
</para>
|
||||||
|
|||||||
+26
-22
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -83,7 +83,7 @@
|
|||||||
<span class="command"><strong>delv</strong></span> will send to a specified name server all
|
<span class="command"><strong>delv</strong></span> will send to a specified name server all
|
||||||
queries needed to fetch and validate the requested data; this
|
queries needed to fetch and validate the requested data; this
|
||||||
includes the original requested query, subsequent queries to follow
|
includes the original requested query, subsequent queries to follow
|
||||||
CNAME or DNAME chains, and queries for DNSKEY and DS records
|
CNAME or DNAME chains, and queries for DNSKEY, DS and DLV records
|
||||||
to establish a chain of trust for DNSSEC validation.
|
to establish a chain of trust for DNSSEC validation.
|
||||||
It does not perform iterative resolution, but simulates the
|
It does not perform iterative resolution, but simulates the
|
||||||
behavior of a name server configured for DNSSEC validating and
|
behavior of a name server configured for DNSSEC validating and
|
||||||
@@ -193,21 +193,21 @@
|
|||||||
<p>
|
<p>
|
||||||
Keys that do not match the root zone name are ignored.
|
Keys that do not match the root zone name are ignored.
|
||||||
An alternate key name can be specified using the
|
An alternate key name can be specified using the
|
||||||
<code class="option">+root=NAME</code> options.
|
<code class="option">+root=NAME</code> options. DNSSEC Lookaside
|
||||||
|
Validation can also be turned on by using the
|
||||||
|
<code class="option">+dlv=NAME</code> to specify the name of a
|
||||||
|
zone containing DLV records.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
Note: When reading the trust anchor file,
|
Note: When reading the trust anchor file,
|
||||||
<span class="command"><strong>delv</strong></span> treats <code class="option">trust-anchors</code>
|
<span class="command"><strong>delv</strong></span> treats <code class="option">managed-keys</code>
|
||||||
<code class="option">initial-key</code> and <code class="option">static-key</code>
|
statements and <code class="option">trusted-keys</code> statements
|
||||||
entries identically. That is, even if a key is configured
|
identically. That is, for a managed key, it is the
|
||||||
with <span class="command"><strong>initial-key</strong></span>, indicating that it is
|
<span class="emphasis"><em>initial</em></span> key that is trusted; RFC 5011
|
||||||
meant to be used only as an initializing key for RFC 5011
|
key management is not supported. <span class="command"><strong>delv</strong></span>
|
||||||
key maintenance, it is still treated by <span class="command"><strong>delv</strong></span>
|
will not consult the managed-keys database maintained by
|
||||||
as if it had been configured as a <span class="command"><strong>static-key</strong></span>.
|
<span class="command"><strong>named</strong></span>. This means that if either of the
|
||||||
<span class="command"><strong>delv</strong></span> does not consult the managed keys
|
keys in <code class="filename">/etc/bind.keys</code> is revoked
|
||||||
database maintained by <span class="command"><strong>named</strong></span>. This means
|
|
||||||
that if either of the keys in
|
|
||||||
<code class="filename">/etc/bind.keys</code> is revoked
|
|
||||||
and rolled over, it will be necessary to update
|
and rolled over, it will be necessary to update
|
||||||
<code class="filename">/etc/bind.keys</code> to use DNSSEC
|
<code class="filename">/etc/bind.keys</code> to use DNSSEC
|
||||||
validation in <span class="command"><strong>delv</strong></span>.
|
validation in <span class="command"><strong>delv</strong></span>.
|
||||||
@@ -517,13 +517,14 @@
|
|||||||
request DNSSEC records or whether to validate them.
|
request DNSSEC records or whether to validate them.
|
||||||
DNSSEC records are always requested, and validation
|
DNSSEC records are always requested, and validation
|
||||||
will always occur unless suppressed by the use of
|
will always occur unless suppressed by the use of
|
||||||
<code class="option">-i</code> or <code class="option">+noroot</code>.
|
<code class="option">-i</code> or <code class="option">+noroot</code> and
|
||||||
|
<code class="option">+nodlv</code>.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]root[=ROOT]</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]root[=ROOT]</code></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Indicates whether to perform conventional
|
Indicates whether to perform conventional (non-lookaside)
|
||||||
DNSSEC validation, and if so, specifies the
|
DNSSEC validation, and if so, specifies the
|
||||||
name of a trust anchor. The default is to validate using
|
name of a trust anchor. The default is to validate using
|
||||||
a trust anchor of "." (the root zone), for which there is
|
a trust anchor of "." (the root zone), for which there is
|
||||||
@@ -532,6 +533,15 @@
|
|||||||
containing the key.
|
containing the key.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
|
<dt><span class="term"><code class="option">+[no]dlv[=DLV]</code></span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Indicates whether to perform DNSSEC lookaside validation,
|
||||||
|
and if so, specifies the name of the DLV trust anchor.
|
||||||
|
The <code class="option">-a</code> option must also be used to specify
|
||||||
|
a file containing the DLV key.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]tcp</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]tcp</code></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
@@ -548,12 +558,6 @@
|
|||||||
in the type's presentation format.
|
in the type's presentation format.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]yaml</code></span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Print response data in YAML format.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
</dl></div>
|
</dl></div>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{BE172EFE-C1DC-4812-BFB9-8C5F8ADB7E9F}</ProjectGuid>
|
<ProjectGuid>{BE172EFE-C1DC-4812-BFB9-8C5F8ADB7E9F}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>delv</RootNamespace>
|
<RootNamespace>delv</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -63,8 +60,7 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
<AdditionalIncludeDirectories>..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@GEOIP_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\win32\include;..\..\..\lib\dns\include;..\..\..\lib\irs\win32\include;..\..\..\lib\irs\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@GEOIP_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\win32\include;..\..\..\lib\dns\include;..\..\..\lib\irs\win32\include;..\..\..\lib\irs\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
<Link>
|
<Link>
|
||||||
@@ -91,8 +87,7 @@
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
<AdditionalIncludeDirectories>..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@GEOIP_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\win32\include;..\..\..\lib\dns\include;..\..\..\lib\irs\win32\include;..\..\..\lib\irs\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@GEOIP_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\win32\include;..\..\..\lib\dns\include;..\..\..\lib\irs\win32\include;..\..\..\lib\irs\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
<Link>
|
<Link>
|
||||||
|
|||||||
+4
-5
@@ -19,17 +19,16 @@ READLINE_LIB = @READLINE_LIB@
|
|||||||
|
|
||||||
CINCLUDES = -I${srcdir}/include ${DNS_INCLUDES} \
|
CINCLUDES = -I${srcdir}/include ${DNS_INCLUDES} \
|
||||||
${BIND9_INCLUDES} ${ISC_INCLUDES} \
|
${BIND9_INCLUDES} ${ISC_INCLUDES} \
|
||||||
${IRS_INCLUDES} ${ISCCFG_INCLUDES} @LIBIDN2_CFLAGS@ \
|
${IRS_INCLUDES} ${ISCCFG_INCLUDES} @LIBIDN2_CFLAGS@ @OPENSSL_INCLUDES@
|
||||||
${OPENSSL_CFLAGS}
|
|
||||||
|
|
||||||
CDEFINES = -DVERSION=\"${VERSION}\"
|
CDEFINES = -DVERSION=\"${VERSION}\"
|
||||||
CWARNINGS =
|
CWARNINGS =
|
||||||
|
|
||||||
ISCCFGLIBS = ../../lib/isccfg/libisccfg.@A@
|
ISCCFGLIBS = ../../lib/isccfg/libisccfg.@A@
|
||||||
DNSLIBS = ../../lib/dns/libdns.@A@ ${MAXMINDDB_LIBS} @DNS_CRYPTO_LIBS@
|
DNSLIBS = ../../lib/dns/libdns.@A@ @DNS_CRYPTO_LIBS@
|
||||||
BIND9LIBS = ../../lib/bind9/libbind9.@A@
|
BIND9LIBS = ../../lib/bind9/libbind9.@A@
|
||||||
ISCLIBS = ../../lib/isc/libisc.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
ISCLIBS = ../../lib/isc/libisc.@A@ @OPENSSL_LIBS@
|
||||||
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ @OPENSSL_LIBS@
|
||||||
IRSLIBS = ../../lib/irs/libirs.@A@
|
IRSLIBS = ../../lib/irs/libirs.@A@
|
||||||
|
|
||||||
ISCCFGDEPLIBS = ../../lib/isccfg/libisccfg.@A@
|
ISCCFGDEPLIBS = ../../lib/isccfg/libisccfg.@A@
|
||||||
|
|||||||
+24
-57
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2000-2011, 2013-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2000-2011, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -74,9 +74,7 @@ will perform an NS query for "\&." (the root)\&.
|
|||||||
It is possible to set per\-user defaults for
|
It is possible to set per\-user defaults for
|
||||||
\fBdig\fR
|
\fBdig\fR
|
||||||
via
|
via
|
||||||
${HOME}/\&.digrc\&. This file is read and any options in it are applied before the command line arguments\&. The
|
${HOME}/\&.digrc\&. This file is read and any options in it are applied before the command line arguments\&.
|
||||||
\fB\-r\fR
|
|
||||||
option disables this feature, for scripts that need predictable behaviour\&.
|
|
||||||
.PP
|
.PP
|
||||||
The IN and CH class names overlap with the IN and CH top level domain names\&. Either use the
|
The IN and CH class names overlap with the IN and CH top level domain names\&. Either use the
|
||||||
\fB\-t\fR
|
\fB\-t\fR
|
||||||
@@ -176,6 +174,11 @@ reads a list of lookup requests to process from the given
|
|||||||
using the command\-line interface\&.
|
using the command\-line interface\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
|
\-i
|
||||||
|
.RS 4
|
||||||
|
Do reverse IPv6 lookups using the obsolete RFC 1886 IP6\&.INT domain, which is no longer in use\&. Obsolete bit string label queries (RFC 2874) are not attempted\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
\-k \fIkeyfile\fR
|
\-k \fIkeyfile\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Sign queries using TSIG using a key read from the given file\&. Key files can be generated using
|
Sign queries using TSIG using a key read from the given file\&. Key files can be generated using
|
||||||
@@ -205,12 +208,6 @@ The domain name to query\&. This is useful to distinguish the
|
|||||||
from other arguments\&.
|
from other arguments\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-r
|
|
||||||
.RS 4
|
|
||||||
Do not read options from
|
|
||||||
${HOME}/\&.digrc\&. This is useful for scripts that need predictable behaviour\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-t \fItype\fR
|
\-t \fItype\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
The resource record type to query\&. It can be any valid query type\&. If it is a resource record type supported in BIND 9, it can be given by the type mnemonic (such as "NS" or "AAAA")\&. The default query type is "A", unless the
|
The resource record type to query\&. It can be any valid query type\&. If it is a resource record type supported in BIND 9, it can be given by the type mnemonic (such as "NS" or "AAAA")\&. The default query type is "A", unless the
|
||||||
@@ -249,7 +246,9 @@ arguments\&.
|
|||||||
\fBdig\fR
|
\fBdig\fR
|
||||||
automatically performs a lookup for a name like
|
automatically performs a lookup for a name like
|
||||||
94\&.2\&.0\&.192\&.in\-addr\&.arpa
|
94\&.2\&.0\&.192\&.in\-addr\&.arpa
|
||||||
and sets the query type and class to PTR and IN respectively\&. IPv6 addresses are looked up using nibble format under the IP6\&.ARPA domain\&.
|
and sets the query type and class to PTR and IN respectively\&. IPv6 addresses are looked up using nibble format under the IP6\&.ARPA domain (but see also the
|
||||||
|
\fB\-i\fR
|
||||||
|
option)\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-y \fI[hmac:]\fR\fIkeyname:secret\fR
|
\-y \fI[hmac:]\fR\fIkeyname:secret\fR
|
||||||
@@ -361,20 +360,14 @@ Display [do not display] the CLASS when printing the record\&.
|
|||||||
.PP
|
.PP
|
||||||
\fB+[no]cmd\fR
|
\fB+[no]cmd\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Toggles the printing of the initial comment in the output, identifying the version of
|
Toggles the printing of the initial comment in the output identifying the version of
|
||||||
\fBdig\fR
|
\fBdig\fR
|
||||||
and the query options that have been applied\&. This option always has global effect; it cannot be set globally and then overridden on a per\-lookup basis\&. The default is to print this comment\&.
|
and the query options that have been applied\&. This comment is printed by default\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]comments\fR
|
\fB+[no]comments\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Toggles the display of some comment lines in the output, containing information about the packet header and OPT pseudosection, and the names of the response section\&. The default is to print these comments\&.
|
Toggle the display of comment lines in the output\&. The default is to print comments\&.
|
||||||
.sp
|
|
||||||
Other types of comments in the output are not affected by this option, but can be controlled using other command line switches\&. These include
|
|
||||||
\fB+[no]cmd\fR,
|
|
||||||
\fB+[no]question\fR,
|
|
||||||
\fB+[no]stats\fR, and
|
|
||||||
\fB+[no]rrcomments\fR\&.
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]cookie\fR\fB[=####]\fR
|
\fB+[no]cookie\fR\fB[=####]\fR
|
||||||
@@ -456,11 +449,6 @@ clears the EDNS options to be sent\&.
|
|||||||
Send an EDNS Expire option\&.
|
Send an EDNS Expire option\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]expandaaaa\fR
|
|
||||||
.RS 4
|
|
||||||
When printing AAAA record print all zero nibbles rather than the default RFC 5952 preferred presentation format\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\fB+[no]fail\fR
|
\fB+[no]fail\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Do not try the next server if you receive a SERVFAIL\&. The default is to not try the next server which is the reverse of normal stub resolver behavior\&.
|
Do not try the next server if you receive a SERVFAIL\&. The default is to not try the next server which is the reverse of normal stub resolver behavior\&.
|
||||||
@@ -480,16 +468,12 @@ option is enabled\&. If short form answers are requested, the default is not to
|
|||||||
.PP
|
.PP
|
||||||
\fB+[no]idnin\fR
|
\fB+[no]idnin\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Process [do not process] IDN domain names on input\&. This requires IDN SUPPORT to have been enabled at compile time\&.
|
Process [do not process] IDN domain names on input\&. This requires IDN SUPPORT to have been enabled at compile time\&. The default is to process IDN input\&.
|
||||||
.sp
|
|
||||||
The default is to process IDN input when standard output is a tty\&. The IDN processing on input is disabled when dig output is redirected to files, pipes, and other non\-tty file descriptors\&.
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]idnout\fR
|
\fB+[no]idnout\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Convert [do not convert] puny code on output\&. This requires IDN SUPPORT to have been enabled at compile time\&.
|
Convert [do not convert] puny code on output\&. This requires IDN SUPPORT to have been enabled at compile time\&. The default is to convert output\&.
|
||||||
.sp
|
|
||||||
The default is to process puny code on output when standard output is a tty\&. The puny code processing on output is disabled when dig output is redirected to files, pipes, and other non\-tty file descriptors\&.
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]ignore\fR
|
\fB+[no]ignore\fR
|
||||||
@@ -572,12 +556,12 @@ would cause a 48\-byte query to be padded to 64 bytes\&. The default block size
|
|||||||
.PP
|
.PP
|
||||||
\fB+[no]qr\fR
|
\fB+[no]qr\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Toggles the display of the query message as it is sent\&. By default, the query is not printed\&.
|
Print [do not print] the query as it is sent\&. By default, the query is not printed\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]question\fR
|
\fB+[no]question\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Toggles the display of the question section of a query when an answer is returned\&. The default is to print the question section as a comment\&.
|
Print [do not print] the question section of a query when an answer is returned\&. The default is to print the question section as a comment\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]raflag\fR
|
\fB+[no]raflag\fR
|
||||||
@@ -595,11 +579,11 @@ A synonym for
|
|||||||
.RS 4
|
.RS 4
|
||||||
Toggle the setting of the RD (recursion desired) bit in the query\&. This bit is set by default, which means
|
Toggle the setting of the RD (recursion desired) bit in the query\&. This bit is set by default, which means
|
||||||
\fBdig\fR
|
\fBdig\fR
|
||||||
normally sends recursive queries\&. Recursion is automatically disabled when using the
|
normally sends recursive queries\&. Recursion is automatically disabled when the
|
||||||
\fI+nssearch\fR
|
\fI+nssearch\fR
|
||||||
option, and when using
|
or
|
||||||
\fI+trace\fR
|
\fI+trace\fR
|
||||||
except for an initial recursive query to get the list of root servers\&.
|
query options are used\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+retry=T\fR
|
\fB+retry=T\fR
|
||||||
@@ -630,7 +614,7 @@ determines if the name will be treated as relative or not and hence whether a se
|
|||||||
.PP
|
.PP
|
||||||
\fB+[no]short\fR
|
\fB+[no]short\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Provide a terse answer\&. The default is to print the answer in a verbose form\&. This option always has global effect; it cannot be set globally and then overridden on a per\-lookup basis\&.
|
Provide a terse answer\&. The default is to print the answer in a verbose form\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]showsearch\fR
|
\fB+[no]showsearch\fR
|
||||||
@@ -660,7 +644,7 @@ causes fields not to be split at all\&. The default is 56 characters, or 44 char
|
|||||||
.PP
|
.PP
|
||||||
\fB+[no]stats\fR
|
\fB+[no]stats\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Toggles the printing of statistics: when the query was made, the size of the reply and so on\&. The default behavior is to print the query statistics as a comment after each lookup\&.
|
This query option toggles the printing of statistics: when the query was made, the size of the reply and so on\&. The default behavior is to print the query statistics\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]subnet=addr[/prefix\-length]\fR
|
\fB+[no]subnet=addr[/prefix\-length]\fR
|
||||||
@@ -744,13 +728,6 @@ Display [do not display] the TTL when printing the record\&.
|
|||||||
Display [do not display] the TTL in friendly human\-readable time units of "s", "m", "h", "d", and "w", representing seconds, minutes, hours, days and weeks\&. Implies +ttlid\&.
|
Display [do not display] the TTL in friendly human\-readable time units of "s", "m", "h", "d", and "w", representing seconds, minutes, hours, days and weeks\&. Implies +ttlid\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]unexpected\fR
|
|
||||||
.RS 4
|
|
||||||
Accept [do not accept] answers from unexpected sources\&. By default,
|
|
||||||
\fBdig\fR
|
|
||||||
won\*(Aqt accept a reply from a source other than the one to which it sent the query\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\fB+[no]unknownformat\fR
|
\fB+[no]unknownformat\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Print all RDATA in unknown RR type presentation format (RFC 3597)\&. The default is to print RDATA for known types in the type\*(Aqs presentation format\&.
|
Print all RDATA in unknown RR type presentation format (RFC 3597)\&. The default is to print RDATA for known types in the type\*(Aqs presentation format\&.
|
||||||
@@ -763,13 +740,6 @@ Use [do not use] TCP when querying name servers\&. This alternate syntax to
|
|||||||
is provided for backwards compatibility\&. The "vc" stands for "virtual circuit"\&.
|
is provided for backwards compatibility\&. The "vc" stands for "virtual circuit"\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB+[no]yaml\fR
|
|
||||||
.RS 4
|
|
||||||
Print the responses (and, if
|
|
||||||
\fB+qr\fR
|
|
||||||
is in use, also the outgoing queries) in a detailed YAML format\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\fB+[no]zflag\fR
|
\fB+[no]zflag\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Set [do not set] the last unassigned DNS header flag in a DNS query\&. This flag is off by default\&.
|
Set [do not set] the last unassigned DNS header flag in a DNS query\&. This flag is off by default\&.
|
||||||
@@ -825,10 +795,7 @@ has been built with IDN (internationalized domain name) support, it can accept a
|
|||||||
appropriately converts character encoding of domain name before sending a request to DNS server or displaying a reply from the server\&. If you\*(Aqd like to turn off the IDN support for some reason, use parameters
|
appropriately converts character encoding of domain name before sending a request to DNS server or displaying a reply from the server\&. If you\*(Aqd like to turn off the IDN support for some reason, use parameters
|
||||||
\fI+noidnin\fR
|
\fI+noidnin\fR
|
||||||
and
|
and
|
||||||
\fI+noidnout\fR
|
\fI+noidnout\fR\&.
|
||||||
or define the
|
|
||||||
\fBIDN_DISABLE\fR
|
|
||||||
environment variable\&.
|
|
||||||
.SH "FILES"
|
.SH "FILES"
|
||||||
.PP
|
.PP
|
||||||
/etc/resolv\&.conf
|
/etc/resolv\&.conf
|
||||||
@@ -849,5 +816,5 @@ There are probably too many query options\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2000-2011, 2013-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2000-2011, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
+86
-369
@@ -11,6 +11,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <inttypes.h>
|
#include <inttypes.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
@@ -54,7 +56,7 @@
|
|||||||
|
|
||||||
dig_lookup_t *default_lookup = NULL;
|
dig_lookup_t *default_lookup = NULL;
|
||||||
|
|
||||||
static atomic_uintptr_t batchname = ATOMIC_VAR_INIT(0);
|
static char *batchname = NULL;
|
||||||
static FILE *batchfp = NULL;
|
static FILE *batchfp = NULL;
|
||||||
static char *argv0;
|
static char *argv0;
|
||||||
static int addresscount = 0;
|
static int addresscount = 0;
|
||||||
@@ -63,8 +65,8 @@ static char domainopt[DNS_NAME_MAXTEXT];
|
|||||||
static char hexcookie[81];
|
static char hexcookie[81];
|
||||||
|
|
||||||
static bool short_form = false, printcmd = true,
|
static bool short_form = false, printcmd = true,
|
||||||
plusquest = false, pluscomm = false,
|
ip6_int = false, plusquest = false, pluscomm = false,
|
||||||
ipv4only = false, ipv6only = false, digrc = true;
|
ipv4only = false, ipv6only = false;
|
||||||
static uint32_t splitwidth = 0xffffffff;
|
static uint32_t splitwidth = 0xffffffff;
|
||||||
|
|
||||||
/*% opcode text */
|
/*% opcode text */
|
||||||
@@ -151,11 +153,11 @@ help(void) {
|
|||||||
" -b address[#port] (bind to source address/port)\n"
|
" -b address[#port] (bind to source address/port)\n"
|
||||||
" -c class (specify query class)\n"
|
" -c class (specify query class)\n"
|
||||||
" -f filename (batch mode)\n"
|
" -f filename (batch mode)\n"
|
||||||
|
" -i (use IP6.INT for IPv6 reverse lookups)\n"
|
||||||
" -k keyfile (specify tsig key file)\n"
|
" -k keyfile (specify tsig key file)\n"
|
||||||
" -m (enable memory usage debugging)\n"
|
" -m (enable memory usage debugging)\n"
|
||||||
" -p port (specify port number)\n"
|
" -p port (specify port number)\n"
|
||||||
" -q name (specify query name)\n"
|
" -q name (specify query name)\n"
|
||||||
" -r (do not read ~/.digrc)\n"
|
|
||||||
" -t type (specify query type)\n"
|
" -t type (specify query type)\n"
|
||||||
" -u (display times in usec instead of msec)\n"
|
" -u (display times in usec instead of msec)\n"
|
||||||
" -x dot-notation (shortcut for reverse lookups)\n"
|
" -x dot-notation (shortcut for reverse lookups)\n"
|
||||||
@@ -173,13 +175,11 @@ help(void) {
|
|||||||
" +bufsize=### (Set EDNS0 Max UDP packet size)\n"
|
" +bufsize=### (Set EDNS0 Max UDP packet size)\n"
|
||||||
" +[no]cdflag (Set checking disabled flag in query)\n"
|
" +[no]cdflag (Set checking disabled flag in query)\n"
|
||||||
" +[no]class (Control display of class in records)\n"
|
" +[no]class (Control display of class in records)\n"
|
||||||
" +[no]cmd (Control display of command line -\n"
|
" +[no]cmd (Control display of command line)\n"
|
||||||
" global option)\n"
|
" +[no]comments (Control display of comment lines)\n"
|
||||||
" +[no]comments (Control display of packet header\n"
|
|
||||||
" and section name comments)\n"
|
|
||||||
" +[no]cookie (Add a COOKIE option to the request)\n"
|
" +[no]cookie (Add a COOKIE option to the request)\n"
|
||||||
" +[no]crypto (Control display of cryptographic\n"
|
" +[no]crypto (Control display of cryptographic "
|
||||||
" fields in records)\n"
|
"fields in records)\n"
|
||||||
" +[no]defname (Use search list (+[no]search))\n"
|
" +[no]defname (Use search list (+[no]search))\n"
|
||||||
" +[no]dnssec (Request DNSSEC records)\n"
|
" +[no]dnssec (Request DNSSEC records)\n"
|
||||||
" +domain=### (Set default domainname)\n"
|
" +domain=### (Set default domainname)\n"
|
||||||
@@ -189,20 +189,15 @@ help(void) {
|
|||||||
" +[no]ednsnegotiation (Set EDNS version negotiation)\n"
|
" +[no]ednsnegotiation (Set EDNS version negotiation)\n"
|
||||||
" +ednsopt=###[:value] (Send specified EDNS option)\n"
|
" +ednsopt=###[:value] (Send specified EDNS option)\n"
|
||||||
" +noednsopt (Clear list of +ednsopt options)\n"
|
" +noednsopt (Clear list of +ednsopt options)\n"
|
||||||
" +[no]expandaaaa (Expand AAAA records)\n"
|
|
||||||
" +[no]expire (Request time to expire)\n"
|
" +[no]expire (Request time to expire)\n"
|
||||||
" +[no]fail (Don't try next server on SERVFAIL)\n"
|
" +[no]fail (Don't try next server on SERVFAIL)\n"
|
||||||
" +[no]header-only (Send query without a question section)\n"
|
" +[no]header-only (Send query without a question section)\n"
|
||||||
" +[no]identify (ID responders in short answers)\n"
|
" +[no]identify (ID responders in short answers)\n"
|
||||||
#ifdef HAVE_LIBIDN2
|
" +[no]idnin (Parse IDN names)\n"
|
||||||
" +[no]idnin (Parse IDN names [default=on on tty])\n"
|
" +[no]idnout (Convert IDN response)\n"
|
||||||
" +[no]idnout (Convert IDN response "
|
|
||||||
"[default=on on tty])\n"
|
|
||||||
#endif
|
|
||||||
" +[no]ignore (Don't revert to TCP for TC responses.)\n"
|
" +[no]ignore (Don't revert to TCP for TC responses.)\n"
|
||||||
" +[no]keepalive (Request EDNS TCP keepalive)\n"
|
" +[no]keepalive (Request EDNS TCP keepalive)\n"
|
||||||
" +[no]keepopen (Keep the TCP socket open between "
|
" +[no]keepopen (Keep the TCP socket open between queries)\n"
|
||||||
"queries)\n"
|
|
||||||
" +[no]mapped (Allow mapped IPv4 over IPv6)\n"
|
" +[no]mapped (Allow mapped IPv4 over IPv6)\n"
|
||||||
" +[no]multiline (Print records in an expanded format)\n"
|
" +[no]multiline (Print records in an expanded format)\n"
|
||||||
" +ndots=### (Set search NDOTS value)\n"
|
" +ndots=### (Set search NDOTS value)\n"
|
||||||
@@ -221,7 +216,7 @@ help(void) {
|
|||||||
"comments)\n"
|
"comments)\n"
|
||||||
" +[no]search (Set whether to use searchlist)\n"
|
" +[no]search (Set whether to use searchlist)\n"
|
||||||
" +[no]short (Display nothing except short\n"
|
" +[no]short (Display nothing except short\n"
|
||||||
" form of answers - global option)\n"
|
" form of answer)\n"
|
||||||
" +[no]showsearch (Search with intermediate results)\n"
|
" +[no]showsearch (Search with intermediate results)\n"
|
||||||
" +[no]split=## (Split hex/base64 fields into chunks)\n"
|
" +[no]split=## (Split hex/base64 fields into chunks)\n"
|
||||||
" +[no]stats (Control display of statistics)\n"
|
" +[no]stats (Control display of statistics)\n"
|
||||||
@@ -229,17 +224,12 @@ help(void) {
|
|||||||
" +[no]tcflag (Set TC flag in query (+[no]tcflag))\n"
|
" +[no]tcflag (Set TC flag in query (+[no]tcflag))\n"
|
||||||
" +[no]tcp (TCP mode (+[no]vc))\n"
|
" +[no]tcp (TCP mode (+[no]vc))\n"
|
||||||
" +timeout=### (Set query timeout) [5]\n"
|
" +timeout=### (Set query timeout) [5]\n"
|
||||||
" +[no]trace (Trace delegation down from root "
|
" +[no]trace (Trace delegation down from root [+dnssec])\n"
|
||||||
"[+dnssec])\n"
|
|
||||||
" +tries=### (Set number of UDP attempts) [3]\n"
|
" +tries=### (Set number of UDP attempts) [3]\n"
|
||||||
" +[no]ttlid (Control display of ttls in records)\n"
|
" +[no]ttlid (Control display of ttls in records)\n"
|
||||||
" +[no]ttlunits (Display TTLs in human-readable units)\n"
|
" +[no]ttlunits (Display TTLs in human-readable units)\n"
|
||||||
" +[no]unexpected (Print replies from unexpected sources\n"
|
" +[no]unknownformat (Print RDATA in RFC 3597 \"unknown\" format)\n"
|
||||||
" default=off)\n"
|
|
||||||
" +[no]unknownformat (Print RDATA in RFC 3597 \"unknown\" "
|
|
||||||
"format)\n"
|
|
||||||
" +[no]vc (TCP mode (+[no]tcp))\n"
|
" +[no]vc (TCP mode (+[no]tcp))\n"
|
||||||
" +[no]yaml (Present the results as YAML)\n"
|
|
||||||
" +[no]zflag (Set Z flag in query)\n"
|
" +[no]zflag (Set Z flag in query)\n"
|
||||||
" global d-opts and servers (before host name) affect all queries.\n"
|
" global d-opts and servers (before host name) affect all queries.\n"
|
||||||
" local d-opts and servers (after host name) affect only that lookup.\n"
|
" local d-opts and servers (after host name) affect only that lookup.\n"
|
||||||
@@ -265,11 +255,7 @@ received(unsigned int bytes, isc_sockaddr_t *from, dig_query_t *query) {
|
|||||||
|
|
||||||
isc_sockaddr_format(from, fromtext, sizeof(fromtext));
|
isc_sockaddr_format(from, fromtext, sizeof(fromtext));
|
||||||
|
|
||||||
if (short_form || yaml) {
|
if (query->lookup->stats && !short_form) {
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (query->lookup->stats) {
|
|
||||||
diff = isc_time_microdiff(&query->time_recv, &query->time_sent);
|
diff = isc_time_microdiff(&query->time_recv, &query->time_sent);
|
||||||
if (query->lookup->use_usec)
|
if (query->lookup->use_usec)
|
||||||
printf(";; Query time: %ld usec\n", (long) diff);
|
printf(";; Query time: %ld usec\n", (long) diff);
|
||||||
@@ -290,15 +276,11 @@ received(unsigned int bytes, isc_sockaddr_t *from, dig_query_t *query) {
|
|||||||
*/
|
*/
|
||||||
if (wcsftime(time_str, sizeof(time_str)/sizeof(time_str[0]),
|
if (wcsftime(time_str, sizeof(time_str)/sizeof(time_str[0]),
|
||||||
L"%a %b %d %H:%M:%S %Z %Y", &tmnow) > 0U)
|
L"%a %b %d %H:%M:%S %Z %Y", &tmnow) > 0U)
|
||||||
{
|
|
||||||
printf(";; WHEN: %ls\n", time_str);
|
printf(";; WHEN: %ls\n", time_str);
|
||||||
}
|
|
||||||
#else
|
#else
|
||||||
if (strftime(time_str, sizeof(time_str),
|
if (strftime(time_str, sizeof(time_str),
|
||||||
"%a %b %d %H:%M:%S %Z %Y", &tmnow) > 0U)
|
"%a %b %d %H:%M:%S %Z %Y", &tmnow) > 0U)
|
||||||
{
|
|
||||||
printf(";; WHEN: %s\n", time_str);
|
printf(";; WHEN: %s\n", time_str);
|
||||||
}
|
|
||||||
#endif
|
#endif
|
||||||
if (query->lookup->doing_xfr) {
|
if (query->lookup->doing_xfr) {
|
||||||
printf(";; XFR size: %u records (messages %u, "
|
printf(";; XFR size: %u records (messages %u, "
|
||||||
@@ -309,32 +291,30 @@ received(unsigned int bytes, isc_sockaddr_t *from, dig_query_t *query) {
|
|||||||
printf(";; MSG SIZE rcvd: %u\n", bytes);
|
printf(";; MSG SIZE rcvd: %u\n", bytes);
|
||||||
}
|
}
|
||||||
if (tsigkey != NULL) {
|
if (tsigkey != NULL) {
|
||||||
if (!validated) {
|
if (!validated)
|
||||||
puts(";; WARNING -- Some TSIG could not "
|
puts(";; WARNING -- Some TSIG could not "
|
||||||
"be validated");
|
"be validated");
|
||||||
}
|
|
||||||
}
|
}
|
||||||
if ((tsigkey == NULL) && (keysecret[0] != 0)) {
|
if ((tsigkey == NULL) && (keysecret[0] != 0)) {
|
||||||
puts(";; WARNING -- TSIG key was not used.");
|
puts(";; WARNING -- TSIG key was not used.");
|
||||||
}
|
}
|
||||||
puts("");
|
puts("");
|
||||||
} else if (query->lookup->identify) {
|
} else if (query->lookup->identify && !short_form) {
|
||||||
diff = isc_time_microdiff(&query->time_recv, &query->time_sent);
|
diff = isc_time_microdiff(&query->time_recv, &query->time_sent);
|
||||||
if (query->lookup->use_usec) {
|
if (query->lookup->use_usec)
|
||||||
printf(";; Received %" PRIu64 " bytes "
|
printf(";; Received %" PRIu64 " bytes "
|
||||||
"from %s(%s) in %ld us\n\n",
|
"from %s(%s) in %ld us\n\n",
|
||||||
query->lookup->doing_xfr
|
query->lookup->doing_xfr
|
||||||
? query->byte_count
|
? query->byte_count
|
||||||
: (uint64_t)bytes,
|
: (uint64_t)bytes,
|
||||||
fromtext, query->userarg, (long) diff);
|
fromtext, query->userarg, (long) diff);
|
||||||
} else {
|
else
|
||||||
printf(";; Received %" PRIu64 " bytes "
|
printf(";; Received %" PRIu64 " bytes "
|
||||||
"from %s(%s) in %ld ms\n\n",
|
"from %s(%s) in %ld ms\n\n",
|
||||||
query->lookup->doing_xfr
|
query->lookup->doing_xfr
|
||||||
? query->byte_count
|
? query->byte_count
|
||||||
: (uint64_t)bytes,
|
: (uint64_t)bytes,
|
||||||
fromtext, query->userarg, (long) diff / 1000);
|
fromtext, query->userarg, (long) diff / 1000);
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -373,24 +353,20 @@ say_message(dns_rdata_t *rdata, dig_query_t *query, isc_buffer_t *buf) {
|
|||||||
styleflags |= DNS_STYLEFLAG_NOCRYPTO;
|
styleflags |= DNS_STYLEFLAG_NOCRYPTO;
|
||||||
if (query->lookup->print_unknown_format)
|
if (query->lookup->print_unknown_format)
|
||||||
styleflags |= DNS_STYLEFLAG_UNKNOWNFORMAT;
|
styleflags |= DNS_STYLEFLAG_UNKNOWNFORMAT;
|
||||||
if (query->lookup->expandaaaa)
|
|
||||||
styleflags |= DNS_STYLEFLAG_EXPANDAAAA;
|
|
||||||
result = dns_rdata_tofmttext(rdata, NULL, styleflags, 0,
|
result = dns_rdata_tofmttext(rdata, NULL, styleflags, 0,
|
||||||
splitwidth, " ", buf);
|
splitwidth, " ", buf);
|
||||||
if (result == ISC_R_NOSPACE) {
|
if (result == ISC_R_NOSPACE)
|
||||||
return (result);
|
return (result);
|
||||||
}
|
|
||||||
check_result(result, "dns_rdata_totext");
|
check_result(result, "dns_rdata_totext");
|
||||||
if (query->lookup->identify) {
|
if (query->lookup->identify) {
|
||||||
|
|
||||||
diff = isc_time_microdiff(&query->time_recv, &query->time_sent);
|
diff = isc_time_microdiff(&query->time_recv, &query->time_sent);
|
||||||
ADD_STRING(buf, " from server ");
|
ADD_STRING(buf, " from server ");
|
||||||
ADD_STRING(buf, query->servname);
|
ADD_STRING(buf, query->servname);
|
||||||
if (query->lookup->use_usec) {
|
if (query->lookup->use_usec) {
|
||||||
snprintf(store, sizeof(store),
|
snprintf(store, sizeof(store), " in %" PRIu64 " us.", diff);
|
||||||
" in %" PRIu64 " us.", diff);
|
|
||||||
} else {
|
} else {
|
||||||
snprintf(store, sizeof(store),
|
snprintf(store, sizeof(store), " in %" PRIu64 " ms.", diff / 1000);
|
||||||
" in %" PRIu64 " ms.", diff / 1000);
|
|
||||||
}
|
}
|
||||||
ADD_STRING(buf, store);
|
ADD_STRING(buf, store);
|
||||||
}
|
}
|
||||||
@@ -430,7 +406,8 @@ short_answer(dns_message_t *msg, dns_messagetextflag_t flags,
|
|||||||
loopresult = dns_rdataset_first(rdataset);
|
loopresult = dns_rdataset_first(rdataset);
|
||||||
while (loopresult == ISC_R_SUCCESS) {
|
while (loopresult == ISC_R_SUCCESS) {
|
||||||
dns_rdataset_current(rdataset, &rdata);
|
dns_rdataset_current(rdataset, &rdata);
|
||||||
result = say_message(&rdata, query, buf);
|
result = say_message(&rdata, query,
|
||||||
|
buf);
|
||||||
if (result == ISC_R_NOSPACE)
|
if (result == ISC_R_NOSPACE)
|
||||||
return (result);
|
return (result);
|
||||||
check_result(result, "say_message");
|
check_result(result, "say_message");
|
||||||
@@ -472,85 +449,60 @@ isdotlocal(dns_message_t *msg) {
|
|||||||
* Callback from dighost.c to print the reply from a server
|
* Callback from dighost.c to print the reply from a server
|
||||||
*/
|
*/
|
||||||
static isc_result_t
|
static isc_result_t
|
||||||
printmessage(dig_query_t *query, const isc_buffer_t *msgbuf,
|
printmessage(dig_query_t *query, dns_message_t *msg, bool headers) {
|
||||||
dns_message_t *msg, bool headers)
|
|
||||||
{
|
|
||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
dns_messagetextflag_t flags;
|
dns_messagetextflag_t flags;
|
||||||
isc_buffer_t *buf = NULL;
|
isc_buffer_t *buf = NULL;
|
||||||
unsigned int len = OUTPUTBUF;
|
unsigned int len = OUTPUTBUF;
|
||||||
dns_master_style_t *style = NULL;
|
dns_master_style_t *style = NULL;
|
||||||
unsigned int styleflags = 0;
|
unsigned int styleflags = 0;
|
||||||
bool isquery = (msg == query->lookup->sendmsg);
|
|
||||||
|
|
||||||
UNUSED(msgbuf);
|
|
||||||
|
|
||||||
styleflags |= DNS_STYLEFLAG_REL_OWNER;
|
styleflags |= DNS_STYLEFLAG_REL_OWNER;
|
||||||
if (yaml) {
|
if (query->lookup->comments)
|
||||||
msg->indent.string = " ";
|
styleflags |= DNS_STYLEFLAG_COMMENT;
|
||||||
msg->indent.count = 3;
|
if (query->lookup->print_unknown_format)
|
||||||
styleflags |= DNS_STYLEFLAG_YAML;
|
styleflags |= DNS_STYLEFLAG_UNKNOWNFORMAT;
|
||||||
} else {
|
/* Turn on rrcomments if explicitly enabled */
|
||||||
if (query->lookup->comments) {
|
if (query->lookup->rrcomments > 0)
|
||||||
styleflags |= DNS_STYLEFLAG_COMMENT;
|
styleflags |= DNS_STYLEFLAG_RRCOMMENT;
|
||||||
}
|
if (query->lookup->ttlunits)
|
||||||
if (query->lookup->print_unknown_format) {
|
styleflags |= DNS_STYLEFLAG_TTL_UNITS;
|
||||||
styleflags |= DNS_STYLEFLAG_UNKNOWNFORMAT;
|
if (query->lookup->nottl)
|
||||||
}
|
styleflags |= DNS_STYLEFLAG_NO_TTL;
|
||||||
/* Turn on rrcomments if explicitly enabled */
|
if (query->lookup->noclass)
|
||||||
if (query->lookup->rrcomments > 0) {
|
styleflags |= DNS_STYLEFLAG_NO_CLASS;
|
||||||
|
if (query->lookup->nocrypto)
|
||||||
|
styleflags |= DNS_STYLEFLAG_NOCRYPTO;
|
||||||
|
if (query->lookup->multiline) {
|
||||||
|
styleflags |= DNS_STYLEFLAG_OMIT_OWNER;
|
||||||
|
styleflags |= DNS_STYLEFLAG_OMIT_CLASS;
|
||||||
|
styleflags |= DNS_STYLEFLAG_REL_DATA;
|
||||||
|
styleflags |= DNS_STYLEFLAG_OMIT_TTL;
|
||||||
|
styleflags |= DNS_STYLEFLAG_TTL;
|
||||||
|
styleflags |= DNS_STYLEFLAG_MULTILINE;
|
||||||
|
/* Turn on rrcomments unless explicitly disabled */
|
||||||
|
if (query->lookup->rrcomments >= 0)
|
||||||
styleflags |= DNS_STYLEFLAG_RRCOMMENT;
|
styleflags |= DNS_STYLEFLAG_RRCOMMENT;
|
||||||
}
|
|
||||||
if (query->lookup->ttlunits) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_TTL_UNITS;
|
|
||||||
}
|
|
||||||
if (query->lookup->nottl) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_NO_TTL;
|
|
||||||
}
|
|
||||||
if (query->lookup->noclass) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_NO_CLASS;
|
|
||||||
}
|
|
||||||
if (query->lookup->nocrypto) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_NOCRYPTO;
|
|
||||||
}
|
|
||||||
if (query->lookup->expandaaaa) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_EXPANDAAAA;
|
|
||||||
}
|
|
||||||
if (query->lookup->multiline) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_OMIT_OWNER;
|
|
||||||
styleflags |= DNS_STYLEFLAG_OMIT_CLASS;
|
|
||||||
styleflags |= DNS_STYLEFLAG_REL_DATA;
|
|
||||||
styleflags |= DNS_STYLEFLAG_OMIT_TTL;
|
|
||||||
styleflags |= DNS_STYLEFLAG_TTL;
|
|
||||||
styleflags |= DNS_STYLEFLAG_MULTILINE;
|
|
||||||
/* Turn on rrcomments unless explicitly disabled */
|
|
||||||
if (query->lookup->rrcomments >= 0) {
|
|
||||||
styleflags |= DNS_STYLEFLAG_RRCOMMENT;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
if (query->lookup->multiline ||
|
if (query->lookup->multiline ||
|
||||||
(query->lookup->nottl && query->lookup->noclass))
|
(query->lookup->nottl && query->lookup->noclass))
|
||||||
{
|
|
||||||
result = dns_master_stylecreate(&style, styleflags,
|
result = dns_master_stylecreate(&style, styleflags,
|
||||||
24, 24, 24, 32, 80, 8,
|
24, 24, 24, 32, 80, 8,
|
||||||
splitwidth, mctx);
|
splitwidth, mctx);
|
||||||
} else if (query->lookup->nottl || query->lookup->noclass) {
|
else if (query->lookup->nottl || query->lookup->noclass)
|
||||||
result = dns_master_stylecreate(&style, styleflags,
|
result = dns_master_stylecreate(&style, styleflags,
|
||||||
24, 24, 32, 40, 80, 8,
|
24, 24, 32, 40, 80, 8,
|
||||||
splitwidth, mctx);
|
splitwidth, mctx);
|
||||||
} else {
|
else
|
||||||
result = dns_master_stylecreate(&style, styleflags,
|
result = dns_master_stylecreate(&style, styleflags,
|
||||||
24, 32, 40, 48, 80, 8,
|
24, 32, 40, 48, 80, 8,
|
||||||
splitwidth, mctx);
|
splitwidth, mctx);
|
||||||
}
|
|
||||||
check_result(result, "dns_master_stylecreate");
|
check_result(result, "dns_master_stylecreate");
|
||||||
|
|
||||||
if (query->lookup->cmdline[0] != 0) {
|
if (query->lookup->cmdline[0] != 0) {
|
||||||
if (!short_form && printcmd) {
|
if (!short_form)
|
||||||
fputs(query->lookup->cmdline, stdout);
|
fputs(query->lookup->cmdline, stdout);
|
||||||
}
|
query->lookup->cmdline[0]=0;
|
||||||
query->lookup->cmdline[0] = '\0';
|
|
||||||
}
|
}
|
||||||
debug("printmessage(%s %s %s)", headers ? "headers" : "noheaders",
|
debug("printmessage(%s %s %s)", headers ? "headers" : "noheaders",
|
||||||
query->lookup->comments ? "comments" : "nocomments",
|
query->lookup->comments ? "comments" : "nocomments",
|
||||||
@@ -571,110 +523,13 @@ printmessage(dig_query_t *query, const isc_buffer_t *msgbuf,
|
|||||||
result = isc_buffer_allocate(mctx, &buf, len);
|
result = isc_buffer_allocate(mctx, &buf, len);
|
||||||
check_result(result, "isc_buffer_allocate");
|
check_result(result, "isc_buffer_allocate");
|
||||||
|
|
||||||
if (yaml) {
|
if (query->lookup->comments && !short_form) {
|
||||||
enum { Q = 0x1, R = 0x2 }; /* Q:query; R:ecursive */
|
if (query->lookup->cmdline[0] != 0)
|
||||||
unsigned int tflag = 0;
|
|
||||||
isc_sockaddr_t saddr;
|
|
||||||
char sockstr[ISC_SOCKADDR_FORMATSIZE];
|
|
||||||
uint16_t sport;
|
|
||||||
char *hash;
|
|
||||||
int pf;
|
|
||||||
|
|
||||||
printf("-\n");
|
|
||||||
printf(" type: MESSAGE\n");
|
|
||||||
printf(" message:\n");
|
|
||||||
|
|
||||||
if (isquery) {
|
|
||||||
tflag |= Q;
|
|
||||||
if ((msg->flags & DNS_MESSAGEFLAG_RD) != 0) {
|
|
||||||
tflag |= R;
|
|
||||||
}
|
|
||||||
} else if (((msg->flags & DNS_MESSAGEFLAG_RD) != 0) &&
|
|
||||||
((msg->flags & DNS_MESSAGEFLAG_RA) != 0))
|
|
||||||
{
|
|
||||||
tflag |= R;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (tflag == (Q|R)) {
|
|
||||||
printf(" type: RECURSIVE_QUERY\n");
|
|
||||||
} else if (tflag == Q) {
|
|
||||||
printf(" type: AUTH_QUERY\n");
|
|
||||||
} else if (tflag == R) {
|
|
||||||
printf(" type: RECURSIVE_RESPONSE\n");
|
|
||||||
} else {
|
|
||||||
printf(" type: AUTH_RESPONSE\n");
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!isc_time_isepoch(&query->time_sent)) {
|
|
||||||
char tbuf[100];
|
|
||||||
isc_time_formatISO8601ms(&query->time_sent,
|
|
||||||
tbuf, sizeof(tbuf));
|
|
||||||
printf(" query_time: !!timestamp %s\n", tbuf);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!isquery && !isc_time_isepoch(&query->time_recv)) {
|
|
||||||
char tbuf[100];
|
|
||||||
isc_time_formatISO8601ms(&query->time_recv,
|
|
||||||
tbuf, sizeof(tbuf));
|
|
||||||
printf(" response_time: !!timestamp %s\n", tbuf);
|
|
||||||
}
|
|
||||||
|
|
||||||
printf(" message_size: %ub\n",
|
|
||||||
isc_buffer_usedlength(msgbuf));
|
|
||||||
|
|
||||||
pf = isc_sockaddr_pf(&query->sockaddr);
|
|
||||||
if (pf == PF_INET || pf == PF_INET6) {
|
|
||||||
printf(" socket_family: %s\n",
|
|
||||||
pf == PF_INET ? "INET" : "INET6");
|
|
||||||
|
|
||||||
printf(" socket_protocol: %s\n",
|
|
||||||
query->lookup->tcp_mode ? "TCP" : "UDP");
|
|
||||||
|
|
||||||
sport = isc_sockaddr_getport(&query->sockaddr);
|
|
||||||
isc_sockaddr_format(&query->sockaddr,
|
|
||||||
sockstr, sizeof(sockstr));
|
|
||||||
hash = strchr(sockstr, '#');
|
|
||||||
if (hash != NULL) {
|
|
||||||
*hash = '\0';
|
|
||||||
}
|
|
||||||
if (strcmp(sockstr, "::") == 0) {
|
|
||||||
strlcat(sockstr, "0", sizeof(sockstr));
|
|
||||||
}
|
|
||||||
|
|
||||||
printf(" response_address: %s\n", sockstr);
|
|
||||||
printf(" response_port: %u\n", sport);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (query->sock != NULL &&
|
|
||||||
isc_socket_getsockname(query->sock, &saddr)
|
|
||||||
== ISC_R_SUCCESS)
|
|
||||||
{
|
|
||||||
sport = isc_sockaddr_getport(&saddr);
|
|
||||||
isc_sockaddr_format(&saddr, sockstr, sizeof(sockstr));
|
|
||||||
hash = strchr(sockstr, '#');
|
|
||||||
if (hash != NULL) {
|
|
||||||
*hash = '\0';
|
|
||||||
}
|
|
||||||
if (strcmp(sockstr, "::") == 0) {
|
|
||||||
strlcat(sockstr, "0", sizeof(sockstr));
|
|
||||||
}
|
|
||||||
|
|
||||||
printf(" query_address: %s\n", sockstr);
|
|
||||||
printf(" query_port: %u\n", sport);
|
|
||||||
}
|
|
||||||
|
|
||||||
printf(" %s:\n", isquery ? "query_message_data"
|
|
||||||
: "response_message_data");
|
|
||||||
result = dns_message_headertotext(msg, style, flags, buf);
|
|
||||||
} else if (query->lookup->comments && !short_form) {
|
|
||||||
if (query->lookup->cmdline[0] != '\0' && printcmd) {
|
|
||||||
printf("; %s\n", query->lookup->cmdline);
|
printf("; %s\n", query->lookup->cmdline);
|
||||||
}
|
if (msg == query->lookup->sendmsg)
|
||||||
if (msg == query->lookup->sendmsg) {
|
|
||||||
printf(";; Sending:\n");
|
printf(";; Sending:\n");
|
||||||
} else {
|
else
|
||||||
printf(";; Got answer:\n");
|
printf(";; Got answer:\n");
|
||||||
}
|
|
||||||
|
|
||||||
if (headers) {
|
if (headers) {
|
||||||
if (isdotlocal(msg)) {
|
if (isdotlocal(msg)) {
|
||||||
@@ -819,9 +674,8 @@ buftoosmall:
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if (headers && query->lookup->comments && !short_form && !yaml) {
|
if (headers && query->lookup->comments && !short_form)
|
||||||
printf("\n");
|
printf("\n");
|
||||||
}
|
|
||||||
|
|
||||||
printf("%.*s", (int)isc_buffer_usedlength(buf),
|
printf("%.*s", (int)isc_buffer_usedlength(buf),
|
||||||
(char *)isc_buffer_base(buf));
|
(char *)isc_buffer_base(buf));
|
||||||
@@ -1180,24 +1034,8 @@ plus_option(char *option, bool is_batchfile,
|
|||||||
}
|
}
|
||||||
break;
|
break;
|
||||||
case 'x':
|
case 'x':
|
||||||
switch (cmd[2]) {
|
FULLCHECK("expire");
|
||||||
case 'p':
|
lookup->expire = state;
|
||||||
switch(cmd[3]) {
|
|
||||||
case 'a':
|
|
||||||
FULLCHECK("expandaaaa");
|
|
||||||
lookup->expandaaaa = state;
|
|
||||||
break;
|
|
||||||
case 'i':
|
|
||||||
FULLCHECK("expire");
|
|
||||||
lookup->expire = state;
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
goto invalid_option;
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
goto invalid_option;
|
|
||||||
}
|
|
||||||
break;
|
break;
|
||||||
default:
|
default:
|
||||||
goto invalid_option;
|
goto invalid_option;
|
||||||
@@ -1605,7 +1443,7 @@ plus_option(char *option, bool is_batchfile,
|
|||||||
lookup->trace = state;
|
lookup->trace = state;
|
||||||
lookup->trace_root = state;
|
lookup->trace_root = state;
|
||||||
if (state) {
|
if (state) {
|
||||||
lookup->recurse = true;
|
lookup->recurse = false;
|
||||||
lookup->identify = true;
|
lookup->identify = true;
|
||||||
lookup->comments = false;
|
lookup->comments = false;
|
||||||
lookup->rrcomments = 0;
|
lookup->rrcomments = 0;
|
||||||
@@ -1669,25 +1507,8 @@ plus_option(char *option, bool is_batchfile,
|
|||||||
}
|
}
|
||||||
break;
|
break;
|
||||||
case 'u':
|
case 'u':
|
||||||
switch (cmd[1]) {
|
FULLCHECK("unknownformat");
|
||||||
case 'n':
|
lookup->print_unknown_format = state;
|
||||||
switch (cmd[2]) {
|
|
||||||
case 'e':
|
|
||||||
FULLCHECK("unexpected");
|
|
||||||
lookup->accept_reply_unexpected_src = state;
|
|
||||||
break;
|
|
||||||
case 'k':
|
|
||||||
FULLCHECK("unknownformat");
|
|
||||||
lookup->print_unknown_format = state;
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
goto invalid_option;
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
goto invalid_option;
|
|
||||||
}
|
|
||||||
|
|
||||||
break;
|
break;
|
||||||
case 'v':
|
case 'v':
|
||||||
FULLCHECK("vc");
|
FULLCHECK("vc");
|
||||||
@@ -1696,15 +1517,6 @@ plus_option(char *option, bool is_batchfile,
|
|||||||
lookup->tcp_mode_set = true;
|
lookup->tcp_mode_set = true;
|
||||||
}
|
}
|
||||||
break;
|
break;
|
||||||
case 'y': /* yaml */
|
|
||||||
FULLCHECK("yaml");
|
|
||||||
yaml = state;
|
|
||||||
if (state) {
|
|
||||||
printcmd = false;
|
|
||||||
lookup->stats = false;
|
|
||||||
lookup->rrcomments = -1;
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case 'z': /* zflag */
|
case 'z': /* zflag */
|
||||||
FULLCHECK("zflag");
|
FULLCHECK("zflag");
|
||||||
lookup->zflag = state;
|
lookup->zflag = state;
|
||||||
@@ -1730,8 +1542,8 @@ plus_option(char *option, bool is_batchfile,
|
|||||||
/*%
|
/*%
|
||||||
* #true returned if value was used
|
* #true returned if value was used
|
||||||
*/
|
*/
|
||||||
static const char *single_dash_opts = "46dhimnruv";
|
static const char *single_dash_opts = "46dhimnuv";
|
||||||
static const char *dash_opts = "46bcdfhikmnpqrtvyx";
|
static const char *dash_opts = "46bcdfhikmnptvyx";
|
||||||
static bool
|
static bool
|
||||||
dash_option(char *option, char *next, dig_lookup_t **lookup,
|
dash_option(char *option, char *next, dig_lookup_t **lookup,
|
||||||
bool *open_type_class, bool *need_clone,
|
bool *open_type_class, bool *need_clone,
|
||||||
@@ -1794,7 +1606,7 @@ dash_option(char *option, char *next, dig_lookup_t **lookup,
|
|||||||
exit(0);
|
exit(0);
|
||||||
break;
|
break;
|
||||||
case 'i':
|
case 'i':
|
||||||
/* deprecated */
|
ip6_int = true;
|
||||||
break;
|
break;
|
||||||
case 'm': /* memdebug */
|
case 'm': /* memdebug */
|
||||||
/* memdebug is handled in preparse_args() */
|
/* memdebug is handled in preparse_args() */
|
||||||
@@ -1802,10 +1614,6 @@ dash_option(char *option, char *next, dig_lookup_t **lookup,
|
|||||||
case 'n':
|
case 'n':
|
||||||
/* deprecated */
|
/* deprecated */
|
||||||
break;
|
break;
|
||||||
case 'r':
|
|
||||||
debug("digrc (late)");
|
|
||||||
digrc = false;
|
|
||||||
break;
|
|
||||||
case 'u':
|
case 'u':
|
||||||
(*lookup)->use_usec = true;
|
(*lookup)->use_usec = true;
|
||||||
break;
|
break;
|
||||||
@@ -1874,7 +1682,7 @@ dash_option(char *option, char *next, dig_lookup_t **lookup,
|
|||||||
value);
|
value);
|
||||||
return (value_from_next);
|
return (value_from_next);
|
||||||
case 'f':
|
case 'f':
|
||||||
atomic_store(&batchname, (uintptr_t)value);
|
batchname = value;
|
||||||
return (value_from_next);
|
return (value_from_next);
|
||||||
case 'k':
|
case 'k':
|
||||||
strlcpy(keyfile, value, sizeof(keyfile));
|
strlcpy(keyfile, value, sizeof(keyfile));
|
||||||
@@ -1979,12 +1787,13 @@ dash_option(char *option, char *next, dig_lookup_t **lookup,
|
|||||||
*lookup = clone_lookup(default_lookup, true);
|
*lookup = clone_lookup(default_lookup, true);
|
||||||
*need_clone = true;
|
*need_clone = true;
|
||||||
if (get_reverse(textname, sizeof(textname), value,
|
if (get_reverse(textname, sizeof(textname), value,
|
||||||
false) == ISC_R_SUCCESS) {
|
ip6_int, false) == ISC_R_SUCCESS) {
|
||||||
strlcpy((*lookup)->textname, textname,
|
strlcpy((*lookup)->textname, textname,
|
||||||
sizeof((*lookup)->textname));
|
sizeof((*lookup)->textname));
|
||||||
debug("looking up %s", (*lookup)->textname);
|
debug("looking up %s", (*lookup)->textname);
|
||||||
(*lookup)->trace_root = ((*lookup)->trace ||
|
(*lookup)->trace_root = ((*lookup)->trace ||
|
||||||
(*lookup)->ns_search_only);
|
(*lookup)->ns_search_only);
|
||||||
|
(*lookup)->ip6_int = ip6_int;
|
||||||
if (!(*lookup)->rdtypeset)
|
if (!(*lookup)->rdtypeset)
|
||||||
(*lookup)->rdtype = dns_rdatatype_ptr;
|
(*lookup)->rdtype = dns_rdatatype_ptr;
|
||||||
if (!(*lookup)->rdclassset)
|
if (!(*lookup)->rdclassset)
|
||||||
@@ -2032,23 +1841,11 @@ preparse_args(int argc, char **argv) {
|
|||||||
option = &rv[0][1];
|
option = &rv[0][1];
|
||||||
while (strpbrk(option, single_dash_opts) == &option[0]) {
|
while (strpbrk(option, single_dash_opts) == &option[0]) {
|
||||||
switch (option[0]) {
|
switch (option[0]) {
|
||||||
case 'd':
|
|
||||||
/* For debugging early startup */
|
|
||||||
debugging = true;
|
|
||||||
break;
|
|
||||||
case 'm':
|
case 'm':
|
||||||
memdebugging = true;
|
memdebugging = true;
|
||||||
isc_mem_debugging = ISC_MEM_DEBUGTRACE |
|
isc_mem_debugging = ISC_MEM_DEBUGTRACE |
|
||||||
ISC_MEM_DEBUGRECORD;
|
ISC_MEM_DEBUGRECORD;
|
||||||
break;
|
break;
|
||||||
case 'r':
|
|
||||||
/*
|
|
||||||
* Must be done early, because ~/.digrc
|
|
||||||
* is read before command line parsing
|
|
||||||
*/
|
|
||||||
debug("digrc (early)");
|
|
||||||
digrc = false;
|
|
||||||
break;
|
|
||||||
case '4':
|
case '4':
|
||||||
if (ipv6only)
|
if (ipv6only)
|
||||||
fatal("only one of -4 and -6 allowed");
|
fatal("only one of -4 and -6 allowed");
|
||||||
@@ -2062,20 +1859,6 @@ preparse_args(int argc, char **argv) {
|
|||||||
}
|
}
|
||||||
option = &option[1];
|
option = &option[1];
|
||||||
}
|
}
|
||||||
if (strlen(option) == 0U) {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
/* Look for dash value option. */
|
|
||||||
if (strpbrk(option, dash_opts) != &option[0] ||
|
|
||||||
strlen(option) > 1U) {
|
|
||||||
/* Error or value in option. */
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
/* Dash value is next argument so we need to skip it. */
|
|
||||||
rc--, rv++;
|
|
||||||
/* Handle missing argument */
|
|
||||||
if (rc == 0)
|
|
||||||
break;
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -2142,9 +1925,8 @@ parse_args(bool is_batchfile, bool config_only,
|
|||||||
*/
|
*/
|
||||||
INSIST(batchfp == NULL);
|
INSIST(batchfp == NULL);
|
||||||
homedir = getenv("HOME");
|
homedir = getenv("HOME");
|
||||||
if (homedir != NULL && digrc) {
|
if (homedir != NULL) {
|
||||||
unsigned int n;
|
unsigned int n;
|
||||||
debug("digrc (open)");
|
|
||||||
n = snprintf(rcfile, sizeof(rcfile), "%s/.digrc",
|
n = snprintf(rcfile, sizeof(rcfile), "%s/.digrc",
|
||||||
homedir);
|
homedir);
|
||||||
if (n < sizeof(rcfile)) {
|
if (n < sizeof(rcfile)) {
|
||||||
@@ -2327,15 +2109,13 @@ parse_args(bool is_batchfile, bool config_only,
|
|||||||
* first entry, then trust the callback in dighost_shutdown
|
* first entry, then trust the callback in dighost_shutdown
|
||||||
* to get the rest
|
* to get the rest
|
||||||
*/
|
*/
|
||||||
char *filename = (char *)atomic_load(&batchname);
|
if ((batchname != NULL) && !(is_batchfile)) {
|
||||||
if ((filename != NULL) && !(is_batchfile)) {
|
if (strcmp(batchname, "-") == 0)
|
||||||
if (strcmp(filename, "-") == 0) {
|
|
||||||
batchfp = stdin;
|
batchfp = stdin;
|
||||||
} else {
|
else
|
||||||
batchfp = fopen(filename, "r");
|
batchfp = fopen(batchname, "r");
|
||||||
}
|
|
||||||
if (batchfp == NULL) {
|
if (batchfp == NULL) {
|
||||||
perror(filename);
|
perror(batchname);
|
||||||
if (exitcode < 8)
|
if (exitcode < 8)
|
||||||
exitcode = 8;
|
exitcode = 8;
|
||||||
fatal("couldn't open specified batch file");
|
fatal("couldn't open specified batch file");
|
||||||
@@ -2390,14 +2170,14 @@ query_finished(void) {
|
|||||||
int bargc;
|
int bargc;
|
||||||
char *bargv[16];
|
char *bargv[16];
|
||||||
|
|
||||||
if (atomic_load(&batchname) == 0) {
|
if (batchname == NULL) {
|
||||||
isc_app_shutdown();
|
isc_app_shutdown();
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
fflush(stdout);
|
fflush(stdout);
|
||||||
if (feof(batchfp)) {
|
if (feof(batchfp)) {
|
||||||
atomic_store(&batchname, 0);
|
batchname = NULL;
|
||||||
isc_app_shutdown();
|
isc_app_shutdown();
|
||||||
if (batchfp != stdin)
|
if (batchfp != stdin)
|
||||||
fclose(batchfp);
|
fclose(batchfp);
|
||||||
@@ -2411,7 +2191,7 @@ query_finished(void) {
|
|||||||
parse_args(true, false, bargc, (char **)bargv);
|
parse_args(true, false, bargc, (char **)bargv);
|
||||||
start_lookup();
|
start_lookup();
|
||||||
} else {
|
} else {
|
||||||
atomic_store(&batchname, 0);
|
batchname = NULL;
|
||||||
if (batchfp != stdin)
|
if (batchfp != stdin)
|
||||||
fclose(batchfp);
|
fclose(batchfp);
|
||||||
isc_app_shutdown();
|
isc_app_shutdown();
|
||||||
@@ -2419,67 +2199,8 @@ query_finished(void) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
static void
|
void dig_setup(int argc, char **argv)
|
||||||
dig_error(const char *format, ...) {
|
{
|
||||||
va_list args;
|
|
||||||
|
|
||||||
if (yaml) {
|
|
||||||
printf("-\n");
|
|
||||||
printf(" type: DIG_ERROR\n");
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Print an indent before a literal block quote.
|
|
||||||
* Note: this will break if used to print more than
|
|
||||||
* one line of text as only the first line would be
|
|
||||||
* indented.
|
|
||||||
*/
|
|
||||||
printf(" message: |\n");
|
|
||||||
printf(" ");
|
|
||||||
} else {
|
|
||||||
printf(";; ");
|
|
||||||
}
|
|
||||||
|
|
||||||
va_start(args, format);
|
|
||||||
vprintf(format, args);
|
|
||||||
va_end(args);
|
|
||||||
|
|
||||||
if (!yaml) {
|
|
||||||
printf("\n");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
static void
|
|
||||||
dig_warning(const char *format, ...) {
|
|
||||||
va_list args;
|
|
||||||
|
|
||||||
if (!yaml) {
|
|
||||||
printf(";; ");
|
|
||||||
|
|
||||||
va_start(args, format);
|
|
||||||
vprintf(format, args);
|
|
||||||
va_end(args);
|
|
||||||
|
|
||||||
printf("\n");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
static void
|
|
||||||
dig_comments(dig_lookup_t *lookup, const char *format, ...) {
|
|
||||||
va_list args;
|
|
||||||
|
|
||||||
if (lookup->comments && !yaml) {
|
|
||||||
printf(";; ");
|
|
||||||
|
|
||||||
va_start(args, format);
|
|
||||||
vprintf(format, args);
|
|
||||||
va_end(args);
|
|
||||||
|
|
||||||
printf("\n");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
void
|
|
||||||
dig_setup(int argc, char **argv) {
|
|
||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
|
|
||||||
ISC_LIST_INIT(lookup_list);
|
ISC_LIST_INIT(lookup_list);
|
||||||
@@ -2493,9 +2214,6 @@ dig_setup(int argc, char **argv) {
|
|||||||
dighost_received = received;
|
dighost_received = received;
|
||||||
dighost_trying = trying;
|
dighost_trying = trying;
|
||||||
dighost_shutdown = query_finished;
|
dighost_shutdown = query_finished;
|
||||||
dighost_error = dig_error;
|
|
||||||
dighost_warning = dig_warning;
|
|
||||||
dighost_comments = dig_comments;
|
|
||||||
|
|
||||||
progname = argv[0];
|
progname = argv[0];
|
||||||
preparse_args(argc, argv);
|
preparse_args(argc, argv);
|
||||||
@@ -2541,11 +2259,10 @@ void dig_query_start()
|
|||||||
void
|
void
|
||||||
dig_shutdown() {
|
dig_shutdown() {
|
||||||
destroy_lookup(default_lookup);
|
destroy_lookup(default_lookup);
|
||||||
if (atomic_load(&batchname) != 0) {
|
if (batchname != NULL) {
|
||||||
if (batchfp != stdin) {
|
if (batchfp != stdin)
|
||||||
fclose(batchfp);
|
fclose(batchfp);
|
||||||
}
|
batchname = NULL;
|
||||||
atomic_store(&batchname, 0);
|
|
||||||
}
|
}
|
||||||
cancel_all();
|
cancel_all();
|
||||||
destroy_libs();
|
destroy_libs();
|
||||||
|
|||||||
+33
-92
@@ -52,8 +52,6 @@
|
|||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2017</year>
|
<year>2017</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
@@ -133,10 +131,9 @@
|
|||||||
|
|
||||||
<para>
|
<para>
|
||||||
It is possible to set per-user defaults for <command>dig</command> via
|
It is possible to set per-user defaults for <command>dig</command> via
|
||||||
<filename>${HOME}/.digrc</filename>. This file is read and any
|
<filename>${HOME}/.digrc</filename>. This file is read and
|
||||||
options in it are applied before the command line arguments.
|
any options in it
|
||||||
The <option>-r</option> option disables this feature, for
|
are applied before the command line arguments.
|
||||||
scripts that need predictable behaviour.
|
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
@@ -274,6 +271,17 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>-i</term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Do reverse IPv6 lookups using the obsolete RFC 1886 IP6.INT
|
||||||
|
domain, which is no longer in use. Obsolete bit string
|
||||||
|
label queries (RFC 2874) are not attempted.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-k <replaceable class="parameter">keyfile</replaceable></term>
|
<term>-k <replaceable class="parameter">keyfile</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
@@ -326,16 +334,6 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-r</term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Do not read options from <filename>${HOME}/.digrc</filename>.
|
|
||||||
This is useful for scripts that need predictable behaviour.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-t <replaceable class="parameter">type</replaceable></term>
|
<term>-t <replaceable class="parameter">type</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
@@ -396,7 +394,8 @@
|
|||||||
<literal>94.2.0.192.in-addr.arpa</literal> and sets the
|
<literal>94.2.0.192.in-addr.arpa</literal> and sets the
|
||||||
query type and class to PTR and IN respectively. IPv6
|
query type and class to PTR and IN respectively. IPv6
|
||||||
addresses are looked up using nibble format under the
|
addresses are looked up using nibble format under the
|
||||||
IP6.ARPA domain.
|
IP6.ARPA domain (but see also the <option>-i</option>
|
||||||
|
option).
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -594,11 +593,9 @@
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Toggles the printing of the initial comment in the
|
Toggles the printing of the initial comment in the
|
||||||
output, identifying the version of <command>dig</command>
|
output identifying the version of <command>dig</command>
|
||||||
and the query options that have been applied. This option
|
and the query options that have been applied. This
|
||||||
always has global effect; it cannot be set globally
|
comment is printed by default.
|
||||||
and then overridden on a per-lookup basis. The default
|
|
||||||
is to print this comment.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -607,18 +604,8 @@
|
|||||||
<term><option>+[no]comments</option></term>
|
<term><option>+[no]comments</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Toggles the display of some comment lines in the output,
|
Toggle the display of comment lines in the output.
|
||||||
containing information about the packet header and
|
The default is to print comments.
|
||||||
OPT pseudosection, and the names of the response
|
|
||||||
section. The default is to print these comments.
|
|
||||||
</para>
|
|
||||||
<para>
|
|
||||||
Other types of comments in the output are not affected by
|
|
||||||
this option, but can be controlled using other command
|
|
||||||
line switches. These include <command>+[no]cmd</command>,
|
|
||||||
<command>+[no]question</command>,
|
|
||||||
<command>+[no]stats</command>, and
|
|
||||||
<command>+[no]rrcomments</command>.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -760,16 +747,6 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><option>+[no]expandaaaa</option></term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
When printing AAAA record print all zero nibbles rather
|
|
||||||
than the default RFC 5952 preferred presentation format.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><option>+[no]fail</option></term>
|
<term><option>+[no]fail</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
@@ -812,13 +789,7 @@
|
|||||||
<para>
|
<para>
|
||||||
Process [do not process] IDN domain names on input.
|
Process [do not process] IDN domain names on input.
|
||||||
This requires IDN SUPPORT to have been enabled at
|
This requires IDN SUPPORT to have been enabled at
|
||||||
compile time.
|
compile time. The default is to process IDN input.
|
||||||
</para>
|
|
||||||
<para>
|
|
||||||
The default is to process IDN input when standard output
|
|
||||||
is a tty. The IDN processing on input is disabled when
|
|
||||||
dig output is redirected to files, pipes, and other
|
|
||||||
non-tty file descriptors.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -829,13 +800,7 @@
|
|||||||
<para>
|
<para>
|
||||||
Convert [do not convert] puny code on output.
|
Convert [do not convert] puny code on output.
|
||||||
This requires IDN SUPPORT to have been enabled at
|
This requires IDN SUPPORT to have been enabled at
|
||||||
compile time.
|
compile time. The default is to convert output.
|
||||||
</para>
|
|
||||||
<para>
|
|
||||||
The default is to process puny code on output when
|
|
||||||
standard output is a tty. The puny code processing on
|
|
||||||
output is disabled when dig output is redirected to
|
|
||||||
files, pipes, and other non-tty file descriptors.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -978,8 +943,8 @@
|
|||||||
<term><option>+[no]qr</option></term>
|
<term><option>+[no]qr</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Toggles the display of the query message as it is sent.
|
Print [do not print] the query as it is sent. By
|
||||||
By default, the query is not printed.
|
default, the query is not printed.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -988,7 +953,7 @@
|
|||||||
<term><option>+[no]question</option></term>
|
<term><option>+[no]question</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Toggles the display of the question section of a query
|
Print [do not print] the question section of a query
|
||||||
when an answer is returned. The default is to print
|
when an answer is returned. The default is to print
|
||||||
the question section as a comment.
|
the question section as a comment.
|
||||||
</para>
|
</para>
|
||||||
@@ -1023,10 +988,8 @@
|
|||||||
in the query. This bit is set by default, which means
|
in the query. This bit is set by default, which means
|
||||||
<command>dig</command> normally sends recursive
|
<command>dig</command> normally sends recursive
|
||||||
queries. Recursion is automatically disabled when
|
queries. Recursion is automatically disabled when
|
||||||
using the <parameter>+nssearch</parameter> option, and
|
the <parameter>+nssearch</parameter> or
|
||||||
when using <parameter>+trace</parameter> except for
|
<parameter>+trace</parameter> query options are used.
|
||||||
an initial recursive query to get the list of root
|
|
||||||
servers.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -1079,9 +1042,7 @@
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Provide a terse answer. The default is to print the
|
Provide a terse answer. The default is to print the
|
||||||
answer in a verbose form. This option always has global
|
answer in a verbose form.
|
||||||
effect; it cannot be set globally and then overridden on
|
|
||||||
a per-lookup basis.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -1126,9 +1087,10 @@
|
|||||||
<term><option>+[no]stats</option></term>
|
<term><option>+[no]stats</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Toggles the printing of statistics: when the query was made,
|
This query option toggles the printing of statistics:
|
||||||
the size of the reply and so on. The default behavior is to
|
when the query was made, the size of the reply and
|
||||||
print the query statistics as a comment after each lookup.
|
so on. The default behavior is to print the query
|
||||||
|
statistics.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -1270,17 +1232,6 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><option>+[no]unexpected</option></term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Accept [do not accept] answers from unexpected sources. By
|
|
||||||
default, <command>dig</command> won't accept a reply from a
|
|
||||||
source other than the one to which it sent the query.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><option>+[no]unknownformat</option></term>
|
<term><option>+[no]unknownformat</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
@@ -1304,16 +1255,6 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><option>+[no]yaml</option></term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Print the responses (and, if <option>+qr</option> is in use,
|
|
||||||
also the outgoing queries) in a detailed YAML format.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><option>+[no]zflag</option></term>
|
<term><option>+[no]zflag</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
|
|||||||
+32
-82
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2000-2011, 2013-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2000-2011, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -106,10 +106,9 @@
|
|||||||
|
|
||||||
<p>
|
<p>
|
||||||
It is possible to set per-user defaults for <span class="command"><strong>dig</strong></span> via
|
It is possible to set per-user defaults for <span class="command"><strong>dig</strong></span> via
|
||||||
<code class="filename">${HOME}/.digrc</code>. This file is read and any
|
<code class="filename">${HOME}/.digrc</code>. This file is read and
|
||||||
options in it are applied before the command line arguments.
|
any options in it
|
||||||
The <code class="option">-r</code> option disables this feature, for
|
are applied before the command line arguments.
|
||||||
scripts that need predictable behaviour.
|
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
@@ -228,6 +227,14 @@
|
|||||||
<span class="command"><strong>dig</strong></span> using the command-line interface.
|
<span class="command"><strong>dig</strong></span> using the command-line interface.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
|
<dt><span class="term">-i</span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Do reverse IPv6 lookups using the obsolete RFC 1886 IP6.INT
|
||||||
|
domain, which is no longer in use. Obsolete bit string
|
||||||
|
label queries (RFC 2874) are not attempted.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
<dt><span class="term">-k <em class="replaceable"><code>keyfile</code></em></span></dt>
|
<dt><span class="term">-k <em class="replaceable"><code>keyfile</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
@@ -267,13 +274,6 @@
|
|||||||
the <em class="parameter"><code>name</code></em> from other arguments.
|
the <em class="parameter"><code>name</code></em> from other arguments.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-r</span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Do not read options from <code class="filename">${HOME}/.digrc</code>.
|
|
||||||
This is useful for scripts that need predictable behaviour.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-t <em class="replaceable"><code>type</code></em></span></dt>
|
<dt><span class="term">-t <em class="replaceable"><code>type</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
@@ -324,7 +324,8 @@
|
|||||||
<code class="literal">94.2.0.192.in-addr.arpa</code> and sets the
|
<code class="literal">94.2.0.192.in-addr.arpa</code> and sets the
|
||||||
query type and class to PTR and IN respectively. IPv6
|
query type and class to PTR and IN respectively. IPv6
|
||||||
addresses are looked up using nibble format under the
|
addresses are looked up using nibble format under the
|
||||||
IP6.ARPA domain.
|
IP6.ARPA domain (but see also the <code class="option">-i</code>
|
||||||
|
option).
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-y <em class="replaceable"><code>[<span class="optional">hmac:</span>]keyname:secret</code></em></span></dt>
|
<dt><span class="term">-y <em class="replaceable"><code>[<span class="optional">hmac:</span>]keyname:secret</code></em></span></dt>
|
||||||
@@ -481,28 +482,16 @@
|
|||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Toggles the printing of the initial comment in the
|
Toggles the printing of the initial comment in the
|
||||||
output, identifying the version of <span class="command"><strong>dig</strong></span>
|
output identifying the version of <span class="command"><strong>dig</strong></span>
|
||||||
and the query options that have been applied. This option
|
and the query options that have been applied. This
|
||||||
always has global effect; it cannot be set globally
|
comment is printed by default.
|
||||||
and then overridden on a per-lookup basis. The default
|
|
||||||
is to print this comment.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]comments</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]comments</code></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Toggles the display of some comment lines in the output,
|
Toggle the display of comment lines in the output.
|
||||||
containing information about the packet header and
|
The default is to print comments.
|
||||||
OPT pseudosection, and the names of the response
|
|
||||||
section. The default is to print these comments.
|
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
Other types of comments in the output are not affected by
|
|
||||||
this option, but can be controlled using other command
|
|
||||||
line switches. These include <span class="command"><strong>+[no]cmd</strong></span>,
|
|
||||||
<span class="command"><strong>+[no]question</strong></span>,
|
|
||||||
<span class="command"><strong>+[no]stats</strong></span>, and
|
|
||||||
<span class="command"><strong>+[no]rrcomments</strong></span>.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]cookie[<span class="optional">=####</span>]</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]cookie[<span class="optional">=####</span>]</code></span></dt>
|
||||||
@@ -610,13 +599,6 @@
|
|||||||
Send an EDNS Expire option.
|
Send an EDNS Expire option.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]expandaaaa</code></span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
When printing AAAA record print all zero nibbles rather
|
|
||||||
than the default RFC 5952 preferred presentation format.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term"><code class="option">+[no]fail</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]fail</code></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
@@ -649,13 +631,7 @@
|
|||||||
<p>
|
<p>
|
||||||
Process [do not process] IDN domain names on input.
|
Process [do not process] IDN domain names on input.
|
||||||
This requires IDN SUPPORT to have been enabled at
|
This requires IDN SUPPORT to have been enabled at
|
||||||
compile time.
|
compile time. The default is to process IDN input.
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
The default is to process IDN input when standard output
|
|
||||||
is a tty. The IDN processing on input is disabled when
|
|
||||||
dig output is redirected to files, pipes, and other
|
|
||||||
non-tty file descriptors.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]idnout</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]idnout</code></span></dt>
|
||||||
@@ -663,13 +639,7 @@
|
|||||||
<p>
|
<p>
|
||||||
Convert [do not convert] puny code on output.
|
Convert [do not convert] puny code on output.
|
||||||
This requires IDN SUPPORT to have been enabled at
|
This requires IDN SUPPORT to have been enabled at
|
||||||
compile time.
|
compile time. The default is to convert output.
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
The default is to process puny code on output when
|
|
||||||
standard output is a tty. The puny code processing on
|
|
||||||
output is disabled when dig output is redirected to
|
|
||||||
files, pipes, and other non-tty file descriptors.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]ignore</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]ignore</code></span></dt>
|
||||||
@@ -776,14 +746,14 @@
|
|||||||
<dt><span class="term"><code class="option">+[no]qr</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]qr</code></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Toggles the display of the query message as it is sent.
|
Print [do not print] the query as it is sent. By
|
||||||
By default, the query is not printed.
|
default, the query is not printed.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]question</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]question</code></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Toggles the display of the question section of a query
|
Print [do not print] the question section of a query
|
||||||
when an answer is returned. The default is to print
|
when an answer is returned. The default is to print
|
||||||
the question section as a comment.
|
the question section as a comment.
|
||||||
</p>
|
</p>
|
||||||
@@ -809,10 +779,8 @@
|
|||||||
in the query. This bit is set by default, which means
|
in the query. This bit is set by default, which means
|
||||||
<span class="command"><strong>dig</strong></span> normally sends recursive
|
<span class="command"><strong>dig</strong></span> normally sends recursive
|
||||||
queries. Recursion is automatically disabled when
|
queries. Recursion is automatically disabled when
|
||||||
using the <em class="parameter"><code>+nssearch</code></em> option, and
|
the <em class="parameter"><code>+nssearch</code></em> or
|
||||||
when using <em class="parameter"><code>+trace</code></em> except for
|
<em class="parameter"><code>+trace</code></em> query options are used.
|
||||||
an initial recursive query to get the list of root
|
|
||||||
servers.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+retry=T</code></span></dt>
|
<dt><span class="term"><code class="option">+retry=T</code></span></dt>
|
||||||
@@ -853,9 +821,7 @@
|
|||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Provide a terse answer. The default is to print the
|
Provide a terse answer. The default is to print the
|
||||||
answer in a verbose form. This option always has global
|
answer in a verbose form.
|
||||||
effect; it cannot be set globally and then overridden on
|
|
||||||
a per-lookup basis.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]showsearch</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]showsearch</code></span></dt>
|
||||||
@@ -888,9 +854,10 @@
|
|||||||
<dt><span class="term"><code class="option">+[no]stats</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]stats</code></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Toggles the printing of statistics: when the query was made,
|
This query option toggles the printing of statistics:
|
||||||
the size of the reply and so on. The default behavior is to
|
when the query was made, the size of the reply and
|
||||||
print the query statistics as a comment after each lookup.
|
so on. The default behavior is to print the query
|
||||||
|
statistics.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]subnet=addr[/prefix-length]</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]subnet=addr[/prefix-length]</code></span></dt>
|
||||||
@@ -1000,14 +967,6 @@
|
|||||||
seconds, minutes, hours, days and weeks. Implies +ttlid.
|
seconds, minutes, hours, days and weeks. Implies +ttlid.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]unexpected</code></span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Accept [do not accept] answers from unexpected sources. By
|
|
||||||
default, <span class="command"><strong>dig</strong></span> won't accept a reply from a
|
|
||||||
source other than the one to which it sent the query.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term"><code class="option">+[no]unknownformat</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]unknownformat</code></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
@@ -1025,13 +984,6 @@
|
|||||||
stands for "virtual circuit".
|
stands for "virtual circuit".
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term"><code class="option">+[no]yaml</code></span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Print the responses (and, if <code class="option">+qr</code> is in use,
|
|
||||||
also the outgoing queries) in a detailed YAML format.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term"><code class="option">+[no]zflag</code></span></dt>
|
<dt><span class="term"><code class="option">+[no]zflag</code></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
@@ -1109,9 +1061,7 @@ dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
|
|||||||
reply from the server.
|
reply from the server.
|
||||||
If you'd like to turn off the IDN support for some reason, use
|
If you'd like to turn off the IDN support for some reason, use
|
||||||
parameters <em class="parameter"><code>+noidnin</code></em> and
|
parameters <em class="parameter"><code>+noidnin</code></em> and
|
||||||
<em class="parameter"><code>+noidnout</code></em> or define
|
<em class="parameter"><code>+noidnout</code></em>.
|
||||||
the <code class="envar">IDN_DISABLE</code> environment variable.
|
|
||||||
|
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
+311
-421
File diff suppressed because it is too large
Load Diff
+8
-3
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2000-2002, 2004, 2005, 2007-2009, 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2000-2002, 2004, 2005, 2007-2009, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -112,6 +112,11 @@ Print debugging traces\&. Equivalent to the
|
|||||||
verbose option\&.
|
verbose option\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
|
\-i
|
||||||
|
.RS 4
|
||||||
|
Obsolete\&. Use the IP6\&.INT domain for reverse lookups of IPv6 addresses as defined in RFC1886 and deprecated in RFC4159\&. The default is to use IP6\&.ARPA as specified in RFC3596\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
\-l
|
\-l
|
||||||
.RS 4
|
.RS 4
|
||||||
List zone: The
|
List zone: The
|
||||||
@@ -252,7 +257,7 @@ If
|
|||||||
\fBhost\fR
|
\fBhost\fR
|
||||||
has been built with IDN (internationalized domain name) support, it can accept and display non\-ASCII domain names\&.
|
has been built with IDN (internationalized domain name) support, it can accept and display non\-ASCII domain names\&.
|
||||||
\fBhost\fR
|
\fBhost\fR
|
||||||
appropriately converts character encoding of domain name before sending a request to DNS server or displaying a reply from the server\&. If you\*(Aqd like to turn off the IDN support for some reason, define the
|
appropriately converts character encoding of domain name before sending a request to DNS server or displaying a reply from the server\&. If you\*(Aqd like to turn off the IDN support for some reason, defines the
|
||||||
\fBIDN_DISABLE\fR
|
\fBIDN_DISABLE\fR
|
||||||
environment variable\&. The IDN support is disabled if the variable is set when
|
environment variable\&. The IDN support is disabled if the variable is set when
|
||||||
\fBhost\fR
|
\fBhost\fR
|
||||||
@@ -269,5 +274,5 @@ runs\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2000-2002, 2004, 2005, 2007-2009, 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2000-2002, 2004, 2005, 2007-2009, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
+18
-20
@@ -11,6 +11,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <inttypes.h>
|
#include <inttypes.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
@@ -141,6 +143,7 @@ show_usage(void) {
|
|||||||
" -c specifies query class for non-IN data\n"
|
" -c specifies query class for non-IN data\n"
|
||||||
" -C compares SOA records on authoritative nameservers\n"
|
" -C compares SOA records on authoritative nameservers\n"
|
||||||
" -d is equivalent to -v\n"
|
" -d is equivalent to -v\n"
|
||||||
|
" -i IP6.INT reverse lookups\n"
|
||||||
" -l lists all hosts in a domain, using AXFR\n"
|
" -l lists all hosts in a domain, using AXFR\n"
|
||||||
" -m set memory debugging flag (trace|record|usage)\n"
|
" -m set memory debugging flag (trace|record|usage)\n"
|
||||||
" -N changes the number of dots allowed before root lookup is done\n"
|
" -N changes the number of dots allowed before root lookup is done\n"
|
||||||
@@ -149,7 +152,6 @@ show_usage(void) {
|
|||||||
" -s a SERVFAIL response should stop query\n"
|
" -s a SERVFAIL response should stop query\n"
|
||||||
" -t specifies the query type\n"
|
" -t specifies the query type\n"
|
||||||
" -T enables TCP/IP mode\n"
|
" -T enables TCP/IP mode\n"
|
||||||
" -U enables UDP mode\n"
|
|
||||||
" -v enables verbose output\n"
|
" -v enables verbose output\n"
|
||||||
" -V print version number and exit\n"
|
" -V print version number and exit\n"
|
||||||
" -w specifies to wait forever for a reply\n"
|
" -w specifies to wait forever for a reply\n"
|
||||||
@@ -394,22 +396,19 @@ chase_cnamechain(dns_message_t *msg, dns_name_t *qname) {
|
|||||||
dns_rdataset_current(rdataset, &rdata);
|
dns_rdataset_current(rdataset, &rdata);
|
||||||
result = dns_rdata_tostruct(&rdata, &cname, NULL);
|
result = dns_rdata_tostruct(&rdata, &cname, NULL);
|
||||||
check_result(result, "dns_rdata_tostruct");
|
check_result(result, "dns_rdata_tostruct");
|
||||||
dns_name_copynf(&cname.cname, qname);
|
dns_name_copy(&cname.cname, qname, NULL);
|
||||||
dns_rdata_freestruct(&cname);
|
dns_rdata_freestruct(&cname);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
static isc_result_t
|
static isc_result_t
|
||||||
printmessage(dig_query_t *query, const isc_buffer_t *msgbuf,
|
printmessage(dig_query_t *query, dns_message_t *msg, bool headers) {
|
||||||
dns_message_t *msg, bool headers)
|
|
||||||
{
|
|
||||||
bool did_flag = false;
|
bool did_flag = false;
|
||||||
dns_rdataset_t *opt, *tsig = NULL;
|
dns_rdataset_t *opt, *tsig = NULL;
|
||||||
const dns_name_t *tsigname;
|
const dns_name_t *tsigname;
|
||||||
isc_result_t result = ISC_R_SUCCESS;
|
isc_result_t result = ISC_R_SUCCESS;
|
||||||
int force_error;
|
int force_error;
|
||||||
|
|
||||||
UNUSED(msgbuf);
|
|
||||||
UNUSED(headers);
|
UNUSED(headers);
|
||||||
|
|
||||||
/*
|
/*
|
||||||
@@ -456,7 +455,7 @@ printmessage(dig_query_t *query, const isc_buffer_t *msgbuf,
|
|||||||
|
|
||||||
/* Add AAAA and MX lookups. */
|
/* Add AAAA and MX lookups. */
|
||||||
name = dns_fixedname_initname(&fixed);
|
name = dns_fixedname_initname(&fixed);
|
||||||
dns_name_copynf(query->lookup->name, name);
|
dns_name_copy(query->lookup->name, name, NULL);
|
||||||
chase_cnamechain(msg, name);
|
chase_cnamechain(msg, name);
|
||||||
dns_name_format(name, namestr, sizeof(namestr));
|
dns_name_format(name, namestr, sizeof(namestr));
|
||||||
lookup = clone_lookup(query->lookup, false);
|
lookup = clone_lookup(query->lookup, false);
|
||||||
@@ -626,29 +625,28 @@ pre_parse_args(int argc, char **argv) {
|
|||||||
case 'a': break;
|
case 'a': break;
|
||||||
case 'A': break;
|
case 'A': break;
|
||||||
case 'c': break;
|
case 'c': break;
|
||||||
case 'C': break;
|
|
||||||
case 'd': break;
|
case 'd': break;
|
||||||
case 'D':
|
|
||||||
if (debugging)
|
|
||||||
debugtiming = true;
|
|
||||||
debugging = true;
|
|
||||||
break;
|
|
||||||
case 'i': break;
|
case 'i': break;
|
||||||
case 'l': break;
|
case 'l': break;
|
||||||
case 'n': break;
|
case 'n': break;
|
||||||
case 'N': break;
|
|
||||||
case 'r': break;
|
case 'r': break;
|
||||||
case 'R': break;
|
|
||||||
case 's': break;
|
case 's': break;
|
||||||
case 't': break;
|
case 't': break;
|
||||||
case 'T': break;
|
|
||||||
case 'U': break;
|
|
||||||
case 'v': break;
|
case 'v': break;
|
||||||
case 'V':
|
case 'V':
|
||||||
version();
|
version();
|
||||||
exit(0);
|
exit(0);
|
||||||
break;
|
break;
|
||||||
case 'w': break;
|
case 'w': break;
|
||||||
|
case 'C': break;
|
||||||
|
case 'D':
|
||||||
|
if (debugging)
|
||||||
|
debugtiming = true;
|
||||||
|
debugging = true;
|
||||||
|
break;
|
||||||
|
case 'N': break;
|
||||||
|
case 'R': break;
|
||||||
|
case 'T': break;
|
||||||
case 'W': break;
|
case 'W': break;
|
||||||
default:
|
default:
|
||||||
show_usage();
|
show_usage();
|
||||||
@@ -764,7 +762,7 @@ parse_args(bool is_batchfile, int argc, char **argv) {
|
|||||||
default_lookups = false;
|
default_lookups = false;
|
||||||
break;
|
break;
|
||||||
case 'i':
|
case 'i':
|
||||||
/* deprecated */
|
lookup->ip6_int = true;
|
||||||
break;
|
break;
|
||||||
case 'n':
|
case 'n':
|
||||||
/* deprecated */
|
/* deprecated */
|
||||||
@@ -843,8 +841,8 @@ parse_args(bool is_batchfile, int argc, char **argv) {
|
|||||||
check_ra = true;
|
check_ra = true;
|
||||||
|
|
||||||
lookup->pending = false;
|
lookup->pending = false;
|
||||||
if (get_reverse(store, sizeof(store), hostname, true)
|
if (get_reverse(store, sizeof(store), hostname,
|
||||||
== ISC_R_SUCCESS) {
|
lookup->ip6_int, true) == ISC_R_SUCCESS) {
|
||||||
strlcpy(lookup->textname, store, sizeof(lookup->textname));
|
strlcpy(lookup->textname, store, sizeof(lookup->textname));
|
||||||
lookup->rdtype = dns_rdatatype_ptr;
|
lookup->rdtype = dns_rdatatype_ptr;
|
||||||
lookup->rdtypeset = true;
|
lookup->rdtypeset = true;
|
||||||
|
|||||||
+12
-2
@@ -47,8 +47,6 @@
|
|||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2017</year>
|
<year>2017</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
@@ -181,6 +179,18 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>-i</term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Obsolete.
|
||||||
|
Use the IP6.INT domain for reverse lookups of IPv6
|
||||||
|
addresses as defined in RFC1886 and deprecated in RFC4159.
|
||||||
|
The default is to use IP6.ARPA as specified in RFC3596.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-l</term>
|
<term>-l</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
|
|||||||
+11
-2
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2000-2002, 2004, 2005, 2007-2009, 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2000-2002, 2004, 2005, 2007-2009, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -138,6 +138,15 @@
|
|||||||
Equivalent to the <code class="option">-v</code> verbose option.
|
Equivalent to the <code class="option">-v</code> verbose option.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
|
<dt><span class="term">-i</span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Obsolete.
|
||||||
|
Use the IP6.INT domain for reverse lookups of IPv6
|
||||||
|
addresses as defined in RFC1886 and deprecated in RFC4159.
|
||||||
|
The default is to use IP6.ARPA as specified in RFC3596.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
<dt><span class="term">-l</span></dt>
|
<dt><span class="term">-l</span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
@@ -302,7 +311,7 @@
|
|||||||
<span class="command"><strong>host</strong></span> appropriately converts character encoding of
|
<span class="command"><strong>host</strong></span> appropriately converts character encoding of
|
||||||
domain name before sending a request to DNS server or displaying a
|
domain name before sending a request to DNS server or displaying a
|
||||||
reply from the server.
|
reply from the server.
|
||||||
If you'd like to turn off the IDN support for some reason, define
|
If you'd like to turn off the IDN support for some reason, defines
|
||||||
the <code class="envar">IDN_DISABLE</code> environment variable.
|
the <code class="envar">IDN_DISABLE</code> environment variable.
|
||||||
The IDN support is disabled if the variable is set when
|
The IDN support is disabled if the variable is set when
|
||||||
<span class="command"><strong>host</strong></span> runs.
|
<span class="command"><strong>host</strong></span> runs.
|
||||||
|
|||||||
+15
-40
@@ -26,7 +26,6 @@
|
|||||||
#include <isc/formatcheck.h>
|
#include <isc/formatcheck.h>
|
||||||
#include <isc/lang.h>
|
#include <isc/lang.h>
|
||||||
#include <isc/list.h>
|
#include <isc/list.h>
|
||||||
#include <isc/magic.h>
|
|
||||||
#include <isc/mem.h>
|
#include <isc/mem.h>
|
||||||
#include <isc/print.h>
|
#include <isc/print.h>
|
||||||
#include <isc/sockaddr.h>
|
#include <isc/sockaddr.h>
|
||||||
@@ -82,11 +81,6 @@ typedef struct dig_server dig_server_t;
|
|||||||
typedef ISC_LIST(dig_server_t) dig_serverlist_t;
|
typedef ISC_LIST(dig_server_t) dig_serverlist_t;
|
||||||
typedef struct dig_searchlist dig_searchlist_t;
|
typedef struct dig_searchlist dig_searchlist_t;
|
||||||
|
|
||||||
#define DIG_QUERY_MAGIC ISC_MAGIC('D','i','g','q')
|
|
||||||
|
|
||||||
#define DIG_VALID_QUERY(x) ISC_MAGIC_VALID((x), DIG_QUERY_MAGIC)
|
|
||||||
|
|
||||||
|
|
||||||
/*% The dig_lookup structure */
|
/*% The dig_lookup structure */
|
||||||
struct dig_lookup {
|
struct dig_lookup {
|
||||||
bool
|
bool
|
||||||
@@ -109,6 +103,7 @@ struct dig_lookup {
|
|||||||
trace_root, /*% initial query for either +trace or +nssearch */
|
trace_root, /*% initial query for either +trace or +nssearch */
|
||||||
tcp_mode,
|
tcp_mode,
|
||||||
tcp_mode_set,
|
tcp_mode_set,
|
||||||
|
ip6_int,
|
||||||
comments,
|
comments,
|
||||||
stats,
|
stats,
|
||||||
section_question,
|
section_question,
|
||||||
@@ -140,10 +135,7 @@ struct dig_lookup {
|
|||||||
ttlunits,
|
ttlunits,
|
||||||
idnin,
|
idnin,
|
||||||
idnout,
|
idnout,
|
||||||
expandaaaa,
|
qr;
|
||||||
qr,
|
|
||||||
accept_reply_unexpected_src; /*% print replies from unexpected
|
|
||||||
sources. */
|
|
||||||
char textname[MXNAME]; /*% Name we're going to be looking up */
|
char textname[MXNAME]; /*% Name we're going to be looking up */
|
||||||
char cmdline[MXNAME];
|
char cmdline[MXNAME];
|
||||||
dns_rdatatype_t rdtype;
|
dns_rdatatype_t rdtype;
|
||||||
@@ -193,7 +185,6 @@ struct dig_lookup {
|
|||||||
|
|
||||||
/*% The dig_query structure */
|
/*% The dig_query structure */
|
||||||
struct dig_query {
|
struct dig_query {
|
||||||
unsigned int magic;
|
|
||||||
dig_lookup_t *lookup;
|
dig_lookup_t *lookup;
|
||||||
bool waiting_connect,
|
bool waiting_connect,
|
||||||
pending_free,
|
pending_free,
|
||||||
@@ -212,12 +203,15 @@ struct dig_query {
|
|||||||
bool ixfr_axfr;
|
bool ixfr_axfr;
|
||||||
char *servname;
|
char *servname;
|
||||||
char *userarg;
|
char *userarg;
|
||||||
|
isc_bufferlist_t sendlist,
|
||||||
|
recvlist,
|
||||||
|
lengthlist;
|
||||||
isc_buffer_t recvbuf,
|
isc_buffer_t recvbuf,
|
||||||
lengthbuf,
|
lengthbuf,
|
||||||
tmpsendbuf,
|
slbuf;
|
||||||
sendbuf;
|
char *recvspace,
|
||||||
char *recvspace, *tmpsendspace,
|
lengthspace[4],
|
||||||
lengthspace[4];
|
slspace[4];
|
||||||
isc_socket_t *sock;
|
isc_socket_t *sock;
|
||||||
ISC_LINK(dig_query_t) link;
|
ISC_LINK(dig_query_t) link;
|
||||||
ISC_LINK(dig_query_t) clink;
|
ISC_LINK(dig_query_t) clink;
|
||||||
@@ -225,6 +219,7 @@ struct dig_query {
|
|||||||
isc_time_t time_sent;
|
isc_time_t time_sent;
|
||||||
isc_time_t time_recv;
|
isc_time_t time_recv;
|
||||||
uint64_t byte_count;
|
uint64_t byte_count;
|
||||||
|
isc_buffer_t sendbuf;
|
||||||
isc_timer_t *timer;
|
isc_timer_t *timer;
|
||||||
};
|
};
|
||||||
|
|
||||||
@@ -252,7 +247,7 @@ extern dig_searchlistlist_t search_list;
|
|||||||
extern unsigned int extrabytes;
|
extern unsigned int extrabytes;
|
||||||
|
|
||||||
extern bool check_ra, have_ipv4, have_ipv6, specified_source,
|
extern bool check_ra, have_ipv4, have_ipv6, specified_source,
|
||||||
usesearch, showsearch, yaml;
|
usesearch, showsearch;
|
||||||
extern in_port_t port;
|
extern in_port_t port;
|
||||||
extern unsigned int timeout;
|
extern unsigned int timeout;
|
||||||
extern isc_mem_t *mctx;
|
extern isc_mem_t *mctx;
|
||||||
@@ -289,7 +284,8 @@ int
|
|||||||
getaddresses(dig_lookup_t *lookup, const char *host, isc_result_t *resultp);
|
getaddresses(dig_lookup_t *lookup, const char *host, isc_result_t *resultp);
|
||||||
|
|
||||||
isc_result_t
|
isc_result_t
|
||||||
get_reverse(char *reverse, size_t len, char *value, bool strict);
|
get_reverse(char *reverse, size_t len, char *value, bool ip6_int,
|
||||||
|
bool strict);
|
||||||
|
|
||||||
ISC_PLATFORM_NORETURN_PRE void
|
ISC_PLATFORM_NORETURN_PRE void
|
||||||
fatal(const char *format, ...)
|
fatal(const char *format, ...)
|
||||||
@@ -382,34 +378,13 @@ set_search_domain(char *domain);
|
|||||||
* then assigned to the appropriate function pointer
|
* then assigned to the appropriate function pointer
|
||||||
*/
|
*/
|
||||||
extern isc_result_t
|
extern isc_result_t
|
||||||
(*dighost_printmessage)(dig_query_t *query, const isc_buffer_t *msgbuf,
|
(*dighost_printmessage)(dig_query_t *query, dns_message_t *msg, bool headers);
|
||||||
dns_message_t *msg, bool headers);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Print an error message in the appropriate format.
|
|
||||||
*/
|
|
||||||
extern void
|
|
||||||
(*dighost_error)(const char *format, ...);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Print a warning message in the appropriate format.
|
|
||||||
*/
|
|
||||||
extern void
|
|
||||||
(*dighost_warning)(const char *format, ...);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Print a comment in the appropriate format.
|
|
||||||
*/
|
|
||||||
extern void
|
|
||||||
(*dighost_comments)(dig_lookup_t *lookup, const char *format, ...);
|
|
||||||
|
|
||||||
/*%<
|
/*%<
|
||||||
* Print the final result of the lookup.
|
* Print the final result of the lookup.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
extern void
|
extern void
|
||||||
(*dighost_received)(unsigned int bytes, isc_sockaddr_t *from,
|
(*dighost_received)(unsigned int bytes, isc_sockaddr_t *from, dig_query_t *query);
|
||||||
dig_query_t *query);
|
|
||||||
/*%<
|
/*%<
|
||||||
* Print a message about where and when the response
|
* Print a message about where and when the response
|
||||||
* was received from, like the final comment in the
|
* was received from, like the final comment in the
|
||||||
|
|||||||
+2
-13
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2004-2007, 2010, 2013-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2004-2007, 2010, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -277,17 +277,6 @@ Try the next nameserver if a nameserver responds with SERVFAIL or a referral (no
|
|||||||
.PP
|
.PP
|
||||||
\fBnslookup\fR
|
\fBnslookup\fR
|
||||||
returns with an exit status of 1 if any query failed, and 0 otherwise\&.
|
returns with an exit status of 1 if any query failed, and 0 otherwise\&.
|
||||||
.SH "IDN SUPPORT"
|
|
||||||
.PP
|
|
||||||
If
|
|
||||||
\fBnslookup\fR
|
|
||||||
has been built with IDN (internationalized domain name) support, it can accept and display non\-ASCII domain names\&.
|
|
||||||
\fBnslookup\fR
|
|
||||||
appropriately converts character encoding of domain name before sending a request to DNS server or displaying a reply from the server\&. If you\*(Aqd like to turn off the IDN support for some reason, define the
|
|
||||||
\fBIDN_DISABLE\fR
|
|
||||||
environment variable\&. The IDN support is disabled if the variable is set when
|
|
||||||
\fBnslookup\fR
|
|
||||||
runs or when the standard output is not a tty\&.
|
|
||||||
.SH "FILES"
|
.SH "FILES"
|
||||||
.PP
|
.PP
|
||||||
/etc/resolv\&.conf
|
/etc/resolv\&.conf
|
||||||
@@ -301,5 +290,5 @@ runs or when the standard output is not a tty\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2004-2007, 2010, 2013-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2004-2007, 2010, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
+16
-31
@@ -9,6 +9,8 @@
|
|||||||
* information regarding copyright ownership.
|
* information regarding copyright ownership.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <inttypes.h>
|
#include <inttypes.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
@@ -423,27 +425,22 @@ chase_cnamechain(dns_message_t *msg, dns_name_t *qname) {
|
|||||||
dns_rdataset_current(rdataset, &rdata);
|
dns_rdataset_current(rdataset, &rdata);
|
||||||
result = dns_rdata_tostruct(&rdata, &cname, NULL);
|
result = dns_rdata_tostruct(&rdata, &cname, NULL);
|
||||||
check_result(result, "dns_rdata_tostruct");
|
check_result(result, "dns_rdata_tostruct");
|
||||||
dns_name_copynf(&cname.cname, qname);
|
dns_name_copy(&cname.cname, qname, NULL);
|
||||||
dns_rdata_freestruct(&cname);
|
dns_rdata_freestruct(&cname);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
static isc_result_t
|
static isc_result_t
|
||||||
printmessage(dig_query_t *query, const isc_buffer_t *msgbuf,
|
printmessage(dig_query_t *query, dns_message_t *msg, bool headers) {
|
||||||
dns_message_t *msg, bool headers)
|
|
||||||
{
|
|
||||||
char servtext[ISC_SOCKADDR_FORMATSIZE];
|
char servtext[ISC_SOCKADDR_FORMATSIZE];
|
||||||
|
|
||||||
UNUSED(msgbuf);
|
|
||||||
|
|
||||||
/* I've we've gotten this far, we've reached a server. */
|
/* I've we've gotten this far, we've reached a server. */
|
||||||
query_error = 0;
|
query_error = 0;
|
||||||
|
|
||||||
debug("printmessage()");
|
debug("printmessage()");
|
||||||
|
|
||||||
if(!default_lookups || query->lookup->rdtype == dns_rdatatype_a) {
|
if(!default_lookups || query->lookup->rdtype == dns_rdatatype_a) {
|
||||||
isc_sockaddr_format(&query->sockaddr, servtext,
|
isc_sockaddr_format(&query->sockaddr, servtext, sizeof(servtext));
|
||||||
sizeof(servtext));
|
|
||||||
printf("Server:\t\t%s\n", query->userarg);
|
printf("Server:\t\t%s\n", query->userarg);
|
||||||
printf("Address:\t%s\n", servtext);
|
printf("Address:\t%s\n", servtext);
|
||||||
|
|
||||||
@@ -481,7 +478,7 @@ printmessage(dig_query_t *query, const isc_buffer_t *msgbuf,
|
|||||||
|
|
||||||
/* Add AAAA lookup. */
|
/* Add AAAA lookup. */
|
||||||
name = dns_fixedname_initname(&fixed);
|
name = dns_fixedname_initname(&fixed);
|
||||||
dns_name_copynf(query->lookup->name, name);
|
dns_name_copy(query->lookup->name, name, NULL);
|
||||||
chase_cnamechain(msg, name);
|
chase_cnamechain(msg, name);
|
||||||
dns_name_format(name, namestr, sizeof(namestr));
|
dns_name_format(name, namestr, sizeof(namestr));
|
||||||
lookup = clone_lookup(query->lookup, false);
|
lookup = clone_lookup(query->lookup, false);
|
||||||
@@ -775,7 +772,7 @@ addlookup(char *opt) {
|
|||||||
rdclass = dns_rdataclass_in;
|
rdclass = dns_rdataclass_in;
|
||||||
}
|
}
|
||||||
lookup = make_empty_lookup();
|
lookup = make_empty_lookup();
|
||||||
if (get_reverse(store, sizeof(store), opt, true)
|
if (get_reverse(store, sizeof(store), opt, lookup->ip6_int, true)
|
||||||
== ISC_R_SUCCESS) {
|
== ISC_R_SUCCESS) {
|
||||||
strlcpy(lookup->textname, store, sizeof(lookup->textname));
|
strlcpy(lookup->textname, store, sizeof(lookup->textname));
|
||||||
lookup->rdtype = dns_rdatatype_ptr;
|
lookup->rdtype = dns_rdatatype_ptr;
|
||||||
@@ -855,6 +852,8 @@ get_next_command(void) {
|
|||||||
|
|
||||||
fflush(stdout);
|
fflush(stdout);
|
||||||
buf = isc_mem_allocate(mctx, COMMSIZE);
|
buf = isc_mem_allocate(mctx, COMMSIZE);
|
||||||
|
if (buf == NULL)
|
||||||
|
fatal("memory allocation failure");
|
||||||
isc_app_block();
|
isc_app_block();
|
||||||
if (interactive) {
|
if (interactive) {
|
||||||
#ifdef HAVE_READLINE
|
#ifdef HAVE_READLINE
|
||||||
@@ -880,29 +879,12 @@ get_next_command(void) {
|
|||||||
isc_mem_free(mctx, buf);
|
isc_mem_free(mctx, buf);
|
||||||
}
|
}
|
||||||
|
|
||||||
ISC_PLATFORM_NORETURN_PRE static void
|
|
||||||
usage(void) ISC_PLATFORM_NORETURN_POST;
|
|
||||||
|
|
||||||
static void
|
|
||||||
usage(void) {
|
|
||||||
fprintf(stderr, "Usage:\n");
|
|
||||||
fprintf(stderr,
|
|
||||||
" nslookup [-opt ...] # interactive mode using default server\n");
|
|
||||||
fprintf(stderr,
|
|
||||||
" nslookup [-opt ...] - server # interactive mode using 'server'\n");
|
|
||||||
fprintf(stderr,
|
|
||||||
" nslookup [-opt ...] host # just look up 'host' using default server\n");
|
|
||||||
fprintf(stderr,
|
|
||||||
" nslookup [-opt ...] host server # just look up 'host' using 'server'\n");
|
|
||||||
exit(1);
|
|
||||||
}
|
|
||||||
|
|
||||||
static void
|
static void
|
||||||
parse_args(int argc, char **argv) {
|
parse_args(int argc, char **argv) {
|
||||||
bool have_lookup = false;
|
bool have_lookup = false;
|
||||||
|
|
||||||
usesearch = true;
|
usesearch = true;
|
||||||
for (argc--, argv++; argc > 0 && argv[0] != NULL; argc--, argv++) {
|
for (argc--, argv++; argc > 0; argc--, argv++) {
|
||||||
debug("main parsing %s", argv[0]);
|
debug("main parsing %s", argv[0]);
|
||||||
if (argv[0][0] == '-') {
|
if (argv[0][0] == '-') {
|
||||||
if (strncasecmp(argv[0], "-ver", 4) == 0) {
|
if (strncasecmp(argv[0], "-ver", 4) == 0) {
|
||||||
@@ -918,9 +900,6 @@ parse_args(int argc, char **argv) {
|
|||||||
in_use = true;
|
in_use = true;
|
||||||
addlookup(argv[0]);
|
addlookup(argv[0]);
|
||||||
} else {
|
} else {
|
||||||
if (argv[1] != NULL) {
|
|
||||||
usage();
|
|
||||||
}
|
|
||||||
set_nameserver(argv[0]);
|
set_nameserver(argv[0]);
|
||||||
check_ra = false;
|
check_ra = false;
|
||||||
}
|
}
|
||||||
@@ -944,6 +923,12 @@ flush_lookup_list(void) {
|
|||||||
ISC_SOCKCANCEL_ALL);
|
ISC_SOCKCANCEL_ALL);
|
||||||
isc_socket_detach(&q->sock);
|
isc_socket_detach(&q->sock);
|
||||||
}
|
}
|
||||||
|
if (ISC_LINK_LINKED(&q->recvbuf, link))
|
||||||
|
ISC_LIST_DEQUEUE(q->recvlist, &q->recvbuf,
|
||||||
|
link);
|
||||||
|
if (ISC_LINK_LINKED(&q->lengthbuf, link))
|
||||||
|
ISC_LIST_DEQUEUE(q->lengthlist, &q->lengthbuf,
|
||||||
|
link);
|
||||||
isc_buffer_invalidate(&q->recvbuf);
|
isc_buffer_invalidate(&q->recvbuf);
|
||||||
isc_buffer_invalidate(&q->lengthbuf);
|
isc_buffer_invalidate(&q->lengthbuf);
|
||||||
qp = q;
|
qp = q;
|
||||||
|
|||||||
+23
-32
@@ -71,8 +71,6 @@
|
|||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2017</year>
|
<year>2017</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
@@ -308,7 +306,7 @@ nslookup -query=hinfo -timeout=10
|
|||||||
The class specifies the protocol group of the information.
|
The class specifies the protocol group of the information.
|
||||||
|
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
(Default = IN; abbreviation = cl)
|
(Default = IN; abbreviation = cl)
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@@ -318,10 +316,10 @@ nslookup -query=hinfo -timeout=10
|
|||||||
<term><constant><replaceable><optional>no</optional></replaceable>debug</constant></term>
|
<term><constant><replaceable><optional>no</optional></replaceable>debug</constant></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Turn on or off the display of the full response packet and
|
Turn on or off the display of the full response packet and
|
||||||
any intermediate response packets when searching.
|
any intermediate response packets when searching.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
(Default = nodebug; abbreviation = <optional>no</optional>deb)
|
(Default = nodebug; abbreviation = <optional>no</optional>deb)
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@@ -332,9 +330,9 @@ nslookup -query=hinfo -timeout=10
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Turn debugging mode on or off. This displays more about
|
Turn debugging mode on or off. This displays more about
|
||||||
what nslookup is doing.
|
what nslookup is doing.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
(Default = nod2)
|
(Default = nod2)
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@@ -358,7 +356,7 @@ nslookup -query=hinfo -timeout=10
|
|||||||
names in the domain search list to the request until an
|
names in the domain search list to the request until an
|
||||||
answer is received.
|
answer is received.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
(Default = search)
|
(Default = search)
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@@ -370,7 +368,7 @@ nslookup -query=hinfo -timeout=10
|
|||||||
<para>
|
<para>
|
||||||
Change the default TCP/UDP name server port to <replaceable>value</replaceable>.
|
Change the default TCP/UDP name server port to <replaceable>value</replaceable>.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
(Default = 53; abbreviation = po)
|
(Default = 53; abbreviation = po)
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@@ -389,15 +387,9 @@ nslookup -query=hinfo -timeout=10
|
|||||||
<para>
|
<para>
|
||||||
Change the type of the information query.
|
Change the type of the information query.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
(Default = A and then AAAA; abbreviations = q, ty)
|
(Default = A; abbreviations = q, ty)
|
||||||
</para>
|
</para>
|
||||||
<para>
|
|
||||||
<emphasis role="bold">Note:</emphasis> It is
|
|
||||||
only possible to specify one query type, only
|
|
||||||
the default behavior looks up both when an
|
|
||||||
alternative is not specified.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
@@ -409,7 +401,7 @@ nslookup -query=hinfo -timeout=10
|
|||||||
have the
|
have the
|
||||||
information.
|
information.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
(Default = recurse; abbreviation = [no]rec)
|
(Default = recurse; abbreviation = [no]rec)
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@@ -419,9 +411,9 @@ nslookup -query=hinfo -timeout=10
|
|||||||
<term><constant>ndots=</constant><replaceable>number</replaceable></term>
|
<term><constant>ndots=</constant><replaceable>number</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Set the number of dots (label separators) in a domain
|
Set the number of dots (label separators) in a domain
|
||||||
that will disable searching. Absolute names always
|
that will disable searching. Absolute names always
|
||||||
stop searching.
|
stop searching.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -452,7 +444,7 @@ nslookup -query=hinfo -timeout=10
|
|||||||
Always use a virtual circuit when sending requests to the
|
Always use a virtual circuit when sending requests to the
|
||||||
server.
|
server.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
(Default = novc)
|
(Default = novc)
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@@ -462,15 +454,15 @@ nslookup -query=hinfo -timeout=10
|
|||||||
<term><constant><replaceable><optional>no</optional></replaceable>fail</constant></term>
|
<term><constant><replaceable><optional>no</optional></replaceable>fail</constant></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Try the next nameserver if a nameserver responds with
|
Try the next nameserver if a nameserver responds with
|
||||||
SERVFAIL or a referral (nofail) or terminate query
|
SERVFAIL or a referral (nofail) or terminate query
|
||||||
(fail) on such a response.
|
(fail) on such a response.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
(Default = nofail)
|
(Default = nofail)
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
</variablelist>
|
</variablelist>
|
||||||
</para>
|
</para>
|
||||||
@@ -497,8 +489,7 @@ nslookup -query=hinfo -timeout=10
|
|||||||
If you'd like to turn off the IDN support for some reason, define
|
If you'd like to turn off the IDN support for some reason, define
|
||||||
the <envar>IDN_DISABLE</envar> environment variable.
|
the <envar>IDN_DISABLE</envar> environment variable.
|
||||||
The IDN support is disabled if the variable is set when
|
The IDN support is disabled if the variable is set when
|
||||||
<command>nslookup</command> runs or when the standard output is not
|
<command>nslookup</command> runs.
|
||||||
a tty.
|
|
||||||
</para>
|
</para>
|
||||||
</refsection>
|
</refsection>
|
||||||
|
|
||||||
|
|||||||
+3
-20
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2004-2007, 2010, 2013-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2004-2007, 2010, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -362,31 +362,14 @@ nslookup -query=hinfo -timeout=10
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="refsection">
|
<div class="refsection">
|
||||||
<a name="id-1.11"></a><h2>IDN SUPPORT</h2>
|
<a name="id-1.11"></a><h2>FILES</h2>
|
||||||
|
|
||||||
<p>
|
|
||||||
If <span class="command"><strong>nslookup</strong></span> has been built with IDN (internationalized
|
|
||||||
domain name) support, it can accept and display non-ASCII domain names.
|
|
||||||
<span class="command"><strong>nslookup</strong></span> appropriately converts character encoding of
|
|
||||||
domain name before sending a request to DNS server or displaying a
|
|
||||||
reply from the server.
|
|
||||||
If you'd like to turn off the IDN support for some reason, define
|
|
||||||
the <code class="envar">IDN_DISABLE</code> environment variable.
|
|
||||||
The IDN support is disabled if the variable is set when
|
|
||||||
<span class="command"><strong>nslookup</strong></span> runs or when the standard output is not
|
|
||||||
a tty.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<div class="refsection">
|
|
||||||
<a name="id-1.12"></a><h2>FILES</h2>
|
|
||||||
|
|
||||||
<p><code class="filename">/etc/resolv.conf</code>
|
<p><code class="filename">/etc/resolv.conf</code>
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="refsection">
|
<div class="refsection">
|
||||||
<a name="id-1.13"></a><h2>SEE ALSO</h2>
|
<a name="id-1.12"></a><h2>SEE ALSO</h2>
|
||||||
|
|
||||||
<p><span class="citerefentry">
|
<p><span class="citerefentry">
|
||||||
<span class="refentrytitle">dig</span>(1)
|
<span class="refentrytitle">dig</span>(1)
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{F938F9B8-D395-4A40-BEC7-0122D289C692}</ProjectGuid>
|
<ProjectGuid>{F938F9B8-D395-4A40-BEC7-0122D289C692}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>dig</RootNamespace>
|
<RootNamespace>dig</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -63,7 +60,6 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
@@ -91,7 +87,6 @@
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{140DE800-E552-43CC-B0C7-A33A92E368CA}</ProjectGuid>
|
<ProjectGuid>{140DE800-E552-43CC-B0C7-A33A92E368CA}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>dighost</RootNamespace>
|
<RootNamespace>dighost</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>StaticLibrary</ConfigurationType>
|
<ConfigurationType>StaticLibrary</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>StaticLibrary</ConfigurationType>
|
<ConfigurationType>StaticLibrary</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -63,7 +60,6 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\irs\include;..\..\..\lib\irs\win32\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\irs\include;..\..\..\lib\irs\win32\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
@@ -89,7 +85,6 @@
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\irs\include;..\..\..\lib\irs\win32\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\include;..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\irs\include;..\..\..\lib\irs\win32\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{BA1048A8-6961-4A20-BE12-08BE20611C9D}</ProjectGuid>
|
<ProjectGuid>{BA1048A8-6961-4A20-BE12-08BE20611C9D}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>host</RootNamespace>
|
<RootNamespace>host</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -63,7 +60,6 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
@@ -91,7 +87,6 @@
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@IDN_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<Project DefaultTargets="Build" ToolsVersion="@TOOLS_VERSION@" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
|
||||||
<ItemGroup Label="ProjectConfigurations">
|
<ItemGroup Label="ProjectConfigurations">
|
||||||
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
<ProjectConfiguration Include="Debug|@PLATFORM@">
|
||||||
<Configuration>Debug</Configuration>
|
<Configuration>Debug</Configuration>
|
||||||
@@ -14,21 +14,18 @@
|
|||||||
<ProjectGuid>{C15A6E1A-94CE-4686-99F9-6BC5FD623EB5}</ProjectGuid>
|
<ProjectGuid>{C15A6E1A-94CE-4686-99F9-6BC5FD623EB5}</ProjectGuid>
|
||||||
<Keyword>Win32Proj</Keyword>
|
<Keyword>Win32Proj</Keyword>
|
||||||
<RootNamespace>nslookup</RootNamespace>
|
<RootNamespace>nslookup</RootNamespace>
|
||||||
@WINDOWS_TARGET_PLATFORM_VERSION@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>true</UseDebugLibraries>
|
<UseDebugLibraries>true</UseDebugLibraries>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'" Label="Configuration">
|
||||||
<ConfigurationType>Application</ConfigurationType>
|
<ConfigurationType>Application</ConfigurationType>
|
||||||
<UseDebugLibraries>false</UseDebugLibraries>
|
<UseDebugLibraries>false</UseDebugLibraries>
|
||||||
<WholeProgramOptimization>true</WholeProgramOptimization>
|
<WholeProgramOptimization>true</WholeProgramOptimization>
|
||||||
<CharacterSet>MultiByte</CharacterSet>
|
<CharacterSet>MultiByte</CharacterSet>
|
||||||
@PLATFORM_TOOLSET@
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
|
||||||
<ImportGroup Label="ExtensionSettings">
|
<ImportGroup Label="ExtensionSettings">
|
||||||
@@ -63,7 +60,6 @@
|
|||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<BrowseInformation>true</BrowseInformation>
|
<BrowseInformation>true</BrowseInformation>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@READLINE_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\irs\include;..\..\..\lib\irs\win32\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@READLINE_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\irs\include;..\..\..\lib\irs\win32\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
@@ -91,7 +87,6 @@
|
|||||||
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
<AssemblerListingLocation>.\$(Configuration)\</AssemblerListingLocation>
|
||||||
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
<ObjectFileName>.\$(Configuration)\</ObjectFileName>
|
||||||
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
<ProgramDataBaseFileName>$(OutDir)$(TargetName).pdb</ProgramDataBaseFileName>
|
||||||
<ForcedIncludeFiles>..\..\..\config.h</ForcedIncludeFiles>
|
|
||||||
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@READLINE_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\irs\include;..\..\..\lib\irs\win32\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
<AdditionalIncludeDirectories>.\;..\include;..\..\..\;@LIBXML2_INC@@OPENSSL_INC@@READLINE_INC@..\..\..\lib\isc\win32;..\..\..\lib\isc\win32\include;..\..\..\lib\isc\include;..\..\..\lib\isccfg\include;..\..\..\lib\irs\include;..\..\..\lib\irs\win32\include;..\..\..\lib\dns\include;..\..\..\lib\bind9\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
|
||||||
<CompileAs>CompileAsC</CompileAs>
|
<CompileAs>CompileAsC</CompileAs>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
|||||||
+9
-12
@@ -15,26 +15,23 @@ VERSION=@BIND9_VERSION@
|
|||||||
|
|
||||||
@BIND9_MAKE_INCLUDES@
|
@BIND9_MAKE_INCLUDES@
|
||||||
|
|
||||||
CINCLUDES = ${DNS_INCLUDES} ${ISC_INCLUDES} ${ISCCFG_INCLUDES} \
|
CINCLUDES = ${DNS_INCLUDES} ${ISC_INCLUDES} @OPENSSL_INCLUDES@
|
||||||
${OPENSSL_CFLAGS}
|
|
||||||
|
|
||||||
CDEFINES = -DVERSION=\"${VERSION}\" -DNAMED_CONFFILE=\"${sysconfdir}/named.conf\"
|
CDEFINES = -DVERSION=\"${VERSION}\"
|
||||||
CWARNINGS =
|
CWARNINGS =
|
||||||
|
|
||||||
DNSLIBS = ../../lib/dns/libdns.@A@ ${MAXMINDDB_LIBS} @DNS_CRYPTO_LIBS@
|
DNSLIBS = ../../lib/dns/libdns.@A@ @DNS_CRYPTO_LIBS@
|
||||||
ISCCFGLIBS = ../../lib/isccfg/libisccfg.@A@
|
ISCLIBS = ../../lib/isc/libisc.@A@ @OPENSSL_LIBS@
|
||||||
ISCLIBS = ../../lib/isc/libisc.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ @OPENSSL_LIBS@
|
||||||
ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@ ${OPENSSL_LIBS} ${JSON_C_LIBS} ${LIBXML2_LIBS}
|
|
||||||
|
|
||||||
DNSDEPLIBS = ../../lib/dns/libdns.@A@
|
DNSDEPLIBS = ../../lib/dns/libdns.@A@
|
||||||
ISCDEPLIBS = ../../lib/isc/libisc.@A@
|
ISCDEPLIBS = ../../lib/isc/libisc.@A@
|
||||||
ISCCFGDEPLIBS = ../../lib/isccfg/libisccfg.@A@
|
|
||||||
|
|
||||||
DEPLIBS = ${DNSDEPLIBS} ${ISCCFGDEPLIBS} ${ISCDEPLIBS}
|
DEPLIBS = ${DNSDEPLIBS} ${ISCDEPLIBS}
|
||||||
|
|
||||||
LIBS = ${DNSLIBS} ${ISCCFGLIBS} ${ISCLIBS} @LIBS@
|
LIBS = ${DNSLIBS} ${ISCLIBS} @LIBS@
|
||||||
|
|
||||||
NOSYMLIBS = ${DNSLIBS} ${ISCCFGLIBS} ${ISCNOSYMLIBS} @LIBS@
|
NOSYMLIBS = ${DNSLIBS} ${ISCNOSYMLIBS} @LIBS@
|
||||||
|
|
||||||
# Alphabetically
|
# Alphabetically
|
||||||
TARGETS = dnssec-cds@EXEEXT@ dnssec-dsfromkey@EXEEXT@ \
|
TARGETS = dnssec-cds@EXEEXT@ dnssec-dsfromkey@EXEEXT@ \
|
||||||
@@ -50,7 +47,7 @@ SRCS = dnssec-cds.c dnssec-dsfromkey.c dnssec-importkey.c \
|
|||||||
dnssec-settime.c dnssec-signzone.c dnssec-verify.c \
|
dnssec-settime.c dnssec-signzone.c dnssec-verify.c \
|
||||||
dnssectool.c
|
dnssectool.c
|
||||||
|
|
||||||
MANPAGES = dnssec-cds.8 dnssec-dsfromkey.8 dnssec-importkey.8 \
|
MANPAGES = dnssec-cds.8 dnssec-dsfromkey.8 dnssec-importkey.8 \
|
||||||
dnssec-keyfromlabel.8 dnssec-keygen.8 dnssec-revoke.8 \
|
dnssec-keyfromlabel.8 dnssec-keygen.8 dnssec-revoke.8 \
|
||||||
dnssec-settime.8 dnssec-signzone.8 dnssec-verify.8
|
dnssec-settime.8 dnssec-signzone.8 dnssec-verify.8
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2017-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2017, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -102,7 +102,7 @@ Specify a digest algorithm to use when converting CDNSKEY records to DS records\
|
|||||||
.sp
|
.sp
|
||||||
The
|
The
|
||||||
\fIalgorithm\fR
|
\fIalgorithm\fR
|
||||||
must be one of SHA\-1, SHA\-256, or SHA\-384\&. These values are case insensitive, and the hyphen may be omitted\&. If no algorithm is specified, the default is SHA\-256\&.
|
must be one of SHA\-1 (SHA1), SHA\-256 (SHA256), or SHA\-384 (SHA384)\&. These values are case insensitive\&. If no algorithm is specified, the default is SHA\-256\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-c \fIclass\fR
|
\-c \fIclass\fR
|
||||||
@@ -293,5 +293,5 @@ RFC 7344\&.
|
|||||||
.RE
|
.RE
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2017-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2017, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
+85
-12
@@ -16,6 +16,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <errno.h>
|
#include <errno.h>
|
||||||
#include <inttypes.h>
|
#include <inttypes.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
@@ -59,7 +61,12 @@
|
|||||||
|
|
||||||
#include "dnssectool.h"
|
#include "dnssectool.h"
|
||||||
|
|
||||||
|
#ifndef PATH_MAX
|
||||||
|
#define PATH_MAX 1024 /* WIN32, and others don't define this. */
|
||||||
|
#endif
|
||||||
|
|
||||||
const char *program = "dnssec-cds";
|
const char *program = "dnssec-cds";
|
||||||
|
int verbose;
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Infrastructure
|
* Infrastructure
|
||||||
@@ -75,6 +82,12 @@ static dns_fixedname_t fixed;
|
|||||||
static dns_name_t *name = NULL;
|
static dns_name_t *name = NULL;
|
||||||
static dns_rdataclass_t rdclass = dns_rdataclass_in;
|
static dns_rdataclass_t rdclass = dns_rdataclass_in;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* List of digest types used by ds_from_cdnskey(), filled in by add_dtype()
|
||||||
|
* from -a arguments. The size of the array is an arbitrary limit.
|
||||||
|
*/
|
||||||
|
static uint8_t dtype[8];
|
||||||
|
|
||||||
static const char *startstr = NULL; /* from which we derive notbefore */
|
static const char *startstr = NULL; /* from which we derive notbefore */
|
||||||
static isc_stdtime_t notbefore = 0; /* restrict sig inception times */
|
static isc_stdtime_t notbefore = 0; /* restrict sig inception times */
|
||||||
static dns_rdata_rrsig_t oldestsig; /* for recording inception time */
|
static dns_rdata_rrsig_t oldestsig; /* for recording inception time */
|
||||||
@@ -116,7 +129,7 @@ static int nkey; /* number of child zone DNSKEY records */
|
|||||||
typedef struct keyinfo {
|
typedef struct keyinfo {
|
||||||
dns_rdata_t rdata;
|
dns_rdata_t rdata;
|
||||||
dst_key_t *dst;
|
dst_key_t *dst;
|
||||||
dns_secalg_t algo;
|
uint8_t algo;
|
||||||
dns_keytag_t tag;
|
dns_keytag_t tag;
|
||||||
} keyinfo_t;
|
} keyinfo_t;
|
||||||
|
|
||||||
@@ -150,8 +163,8 @@ verbose_time(int level, const char *msg, isc_stdtime_t time) {
|
|||||||
if (verbose < 3) {
|
if (verbose < 3) {
|
||||||
vbprintf(level, "%s %s\n", msg, timestr);
|
vbprintf(level, "%s %s\n", msg, timestr);
|
||||||
} else {
|
} else {
|
||||||
vbprintf(level, "%s %s (%" PRIu32 ")\n",
|
vbprintf(level, "%s %s (%lld)\n",
|
||||||
msg, timestr, time);
|
msg, timestr, (long long)time);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -372,7 +385,7 @@ formatset(dns_rdataset_t *rdataset) {
|
|||||||
|
|
||||||
result = isc_buffer_allocate(mctx, &buf, MAX_CDS_RDATA_TEXT_SIZE);
|
result = isc_buffer_allocate(mctx, &buf, MAX_CDS_RDATA_TEXT_SIZE);
|
||||||
check_result(result, "printing DS records");
|
check_result(result, "printing DS records");
|
||||||
result = dns_master_rdatasettotext(name, rdataset, style, NULL, buf);
|
result = dns_master_rdatasettotext(name, rdataset, style, buf);
|
||||||
|
|
||||||
if ((result == ISC_R_SUCCESS) && isc_buffer_availablelength(buf) < 1) {
|
if ((result == ISC_R_SUCCESS) && isc_buffer_availablelength(buf) < 1) {
|
||||||
result = ISC_R_NOSPACE;
|
result = ISC_R_NOSPACE;
|
||||||
@@ -469,6 +482,7 @@ match_key_dsset(keyinfo_t *ki, dns_rdataset_t *dsset, strictness_t strictness)
|
|||||||
dns_rdata_ds_t ds;
|
dns_rdata_ds_t ds;
|
||||||
dns_rdata_t dsrdata = DNS_RDATA_INIT;
|
dns_rdata_t dsrdata = DNS_RDATA_INIT;
|
||||||
dns_rdata_t newdsrdata = DNS_RDATA_INIT;
|
dns_rdata_t newdsrdata = DNS_RDATA_INIT;
|
||||||
|
dns_rdatatype_t keytype;
|
||||||
bool c;
|
bool c;
|
||||||
|
|
||||||
dns_rdataset_current(dsset, &dsrdata);
|
dns_rdataset_current(dsset, &dsrdata);
|
||||||
@@ -479,8 +493,12 @@ match_key_dsset(keyinfo_t *ki, dns_rdataset_t *dsset, strictness_t strictness)
|
|||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/* allow for both DNSKEY and CDNSKEY */
|
||||||
|
keytype = ki->rdata.type;
|
||||||
|
ki->rdata.type = dns_rdatatype_dnskey;
|
||||||
result = dns_ds_buildrdata(name, &ki->rdata, ds.digest_type,
|
result = dns_ds_buildrdata(name, &ki->rdata, ds.digest_type,
|
||||||
dsbuf, &newdsrdata);
|
dsbuf, &newdsrdata);
|
||||||
|
ki->rdata.type = keytype;
|
||||||
if (result != ISC_R_SUCCESS) {
|
if (result != ISC_R_SUCCESS) {
|
||||||
vbprintf(3, "dns_ds_buildrdata("
|
vbprintf(3, "dns_ds_buildrdata("
|
||||||
"keytag=%d, algo=%d, digest=%d): %s\n",
|
"keytag=%d, algo=%d, digest=%d): %s\n",
|
||||||
@@ -530,6 +548,9 @@ match_keyset_dsset(dns_rdataset_t *keyset, dns_rdataset_t *dsset,
|
|||||||
nkey = dns_rdataset_count(keyset);
|
nkey = dns_rdataset_count(keyset);
|
||||||
|
|
||||||
keytable = isc_mem_get(mctx, sizeof(keyinfo_t) * nkey);
|
keytable = isc_mem_get(mctx, sizeof(keyinfo_t) * nkey);
|
||||||
|
if (keytable == NULL) {
|
||||||
|
fatal("out of memory");
|
||||||
|
}
|
||||||
|
|
||||||
for (result = dns_rdataset_first(keyset), i = 0;
|
for (result = dns_rdataset_first(keyset), i = 0;
|
||||||
result == ISC_R_SUCCESS;
|
result == ISC_R_SUCCESS;
|
||||||
@@ -552,7 +573,7 @@ match_keyset_dsset(dns_rdataset_t *keyset, dns_rdataset_t *dsset,
|
|||||||
ki->algo = dnskey.algorithm;
|
ki->algo = dnskey.algorithm;
|
||||||
|
|
||||||
dns_rdata_toregion(keyrdata, &r);
|
dns_rdata_toregion(keyrdata, &r);
|
||||||
ki->tag = dst_region_computeid(&r);
|
ki->tag = dst_region_computeid(&r, ki->algo);
|
||||||
|
|
||||||
ki->dst = NULL;
|
ki->dst = NULL;
|
||||||
if (!match_key_dsset(ki, dsset, strictness)) {
|
if (!match_key_dsset(ki, dsset, strictness)) {
|
||||||
@@ -598,15 +619,19 @@ free_keytable(keyinfo_t **keytable_p) {
|
|||||||
* otherwise the key algorithm. This is used by the signature coverage
|
* otherwise the key algorithm. This is used by the signature coverage
|
||||||
* check functions below.
|
* check functions below.
|
||||||
*/
|
*/
|
||||||
static dns_secalg_t *
|
static uint8_t *
|
||||||
matching_sigs(keyinfo_t *keytbl, dns_rdataset_t *rdataset,
|
matching_sigs(keyinfo_t *keytbl, dns_rdataset_t *rdataset,
|
||||||
dns_rdataset_t *sigset)
|
dns_rdataset_t *sigset)
|
||||||
{
|
{
|
||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
dns_secalg_t *algo;
|
uint8_t *algo;
|
||||||
int i;
|
int i;
|
||||||
|
|
||||||
algo = isc_mem_get(mctx, nkey);
|
algo = isc_mem_get(mctx, nkey);
|
||||||
|
if (algo == NULL) {
|
||||||
|
fatal("allocating RRSIG/DNSKEY match list: %s",
|
||||||
|
isc_result_totext(ISC_R_NOMEMORY));
|
||||||
|
}
|
||||||
memset(algo, 0, nkey);
|
memset(algo, 0, nkey);
|
||||||
|
|
||||||
for (result = dns_rdataset_first(sigset);
|
for (result = dns_rdataset_first(sigset);
|
||||||
@@ -682,7 +707,7 @@ matching_sigs(keyinfo_t *keytbl, dns_rdataset_t *rdataset,
|
|||||||
* fetched from the child zone, any working signature is enough.
|
* fetched from the child zone, any working signature is enough.
|
||||||
*/
|
*/
|
||||||
static bool
|
static bool
|
||||||
signed_loose(dns_secalg_t *algo) {
|
signed_loose(uint8_t *algo) {
|
||||||
bool ok = false;
|
bool ok = false;
|
||||||
int i;
|
int i;
|
||||||
for (i = 0; i < nkey; i++) {
|
for (i = 0; i < nkey; i++) {
|
||||||
@@ -701,7 +726,7 @@ signed_loose(dns_secalg_t *algo) {
|
|||||||
* RRset.
|
* RRset.
|
||||||
*/
|
*/
|
||||||
static bool
|
static bool
|
||||||
signed_strict(dns_rdataset_t *dsset, dns_secalg_t *algo) {
|
signed_strict(dns_rdataset_t *dsset, uint8_t *algo) {
|
||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
bool all_ok = true;
|
bool all_ok = true;
|
||||||
|
|
||||||
@@ -740,6 +765,10 @@ rdata_get(void) {
|
|||||||
dns_rdata_t *rdata;
|
dns_rdata_t *rdata;
|
||||||
|
|
||||||
rdata = isc_mem_get(mctx, sizeof(*rdata));
|
rdata = isc_mem_get(mctx, sizeof(*rdata));
|
||||||
|
if (rdata == NULL) {
|
||||||
|
fatal("allocating DS rdata: %s",
|
||||||
|
isc_result_totext(ISC_R_NOMEMORY));
|
||||||
|
}
|
||||||
dns_rdata_init(rdata);
|
dns_rdata_init(rdata);
|
||||||
|
|
||||||
return (rdata);
|
return (rdata);
|
||||||
@@ -797,6 +826,7 @@ ds_from_cdnskey(dns_rdatalist_t *dslist, isc_buffer_t *buf,
|
|||||||
return (ISC_R_NOSPACE);
|
return (ISC_R_NOSPACE);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
cdnskey->type = dns_rdatatype_dnskey;
|
||||||
rdata = rdata_get();
|
rdata = rdata_get();
|
||||||
result = dns_ds_buildrdata(name, cdnskey, dtype[i],
|
result = dns_ds_buildrdata(name, cdnskey, dtype[i],
|
||||||
r.base, rdata);
|
r.base, rdata);
|
||||||
@@ -814,6 +844,34 @@ ds_from_cdnskey(dns_rdatalist_t *dslist, isc_buffer_t *buf,
|
|||||||
return (ISC_R_SUCCESS);
|
return (ISC_R_SUCCESS);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* For sorting the digest types so that DS records generated
|
||||||
|
* from CDNSKEY records are in canonical order.
|
||||||
|
*/
|
||||||
|
static int
|
||||||
|
cmp_dtype(const void *ap, const void *bp) {
|
||||||
|
int a = *(const uint8_t *)ap;
|
||||||
|
int b = *(const uint8_t *)bp;
|
||||||
|
return (a - b);
|
||||||
|
}
|
||||||
|
|
||||||
|
static void
|
||||||
|
add_dtype(const char *dn) {
|
||||||
|
uint8_t dt;
|
||||||
|
unsigned i, n;
|
||||||
|
|
||||||
|
dt = strtodsdigest(dn);
|
||||||
|
n = sizeof(dtype)/sizeof(dtype[0]);
|
||||||
|
for (i = 0; i < n; i++) {
|
||||||
|
if (dtype[i] == 0 || dtype[i] == dt) {
|
||||||
|
dtype[i] = dt;
|
||||||
|
qsort(dtype, i+1, 1, cmp_dtype);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
fatal("too many -a digest type arguments");
|
||||||
|
}
|
||||||
|
|
||||||
static void
|
static void
|
||||||
make_new_ds_set(ds_maker_func_t *ds_from_rdata,
|
make_new_ds_set(ds_maker_func_t *ds_from_rdata,
|
||||||
uint32_t ttl, dns_rdataset_t *rdset)
|
uint32_t ttl, dns_rdataset_t *rdset)
|
||||||
@@ -824,6 +882,10 @@ make_new_ds_set(ds_maker_func_t *ds_from_rdata,
|
|||||||
dns_rdatalist_t *dslist;
|
dns_rdatalist_t *dslist;
|
||||||
|
|
||||||
dslist = isc_mem_get(mctx, sizeof(*dslist));
|
dslist = isc_mem_get(mctx, sizeof(*dslist));
|
||||||
|
if (dslist == NULL) {
|
||||||
|
fatal("allocating new DS list: %s",
|
||||||
|
isc_result_totext(ISC_R_NOMEMORY));
|
||||||
|
}
|
||||||
|
|
||||||
dns_rdatalist_init(dslist);
|
dns_rdatalist_init(dslist);
|
||||||
dslist->rdclass = rdclass;
|
dslist->rdclass = rdclass;
|
||||||
@@ -880,7 +942,7 @@ consistent_digests(dns_rdataset_t *dsset) {
|
|||||||
dns_rdata_t *arrdata;
|
dns_rdata_t *arrdata;
|
||||||
dns_rdata_ds_t *ds;
|
dns_rdata_ds_t *ds;
|
||||||
dns_keytag_t key_tag;
|
dns_keytag_t key_tag;
|
||||||
dns_secalg_t algorithm;
|
uint8_t algorithm;
|
||||||
bool match;
|
bool match;
|
||||||
int i, j, n, d;
|
int i, j, n, d;
|
||||||
|
|
||||||
@@ -892,6 +954,10 @@ consistent_digests(dns_rdataset_t *dsset) {
|
|||||||
n = dns_rdataset_count(dsset);
|
n = dns_rdataset_count(dsset);
|
||||||
|
|
||||||
arrdata = isc_mem_get(mctx, n * sizeof(dns_rdata_t));
|
arrdata = isc_mem_get(mctx, n * sizeof(dns_rdata_t));
|
||||||
|
if (arrdata == NULL) {
|
||||||
|
fatal("allocating DS rdata array: %s",
|
||||||
|
isc_result_totext(ISC_R_NOMEMORY));
|
||||||
|
}
|
||||||
|
|
||||||
for (result = dns_rdataset_first(dsset), i = 0;
|
for (result = dns_rdataset_first(dsset), i = 0;
|
||||||
result == ISC_R_SUCCESS;
|
result == ISC_R_SUCCESS;
|
||||||
@@ -907,6 +973,10 @@ consistent_digests(dns_rdataset_t *dsset) {
|
|||||||
* Convert sorted arrdata to more accessible format
|
* Convert sorted arrdata to more accessible format
|
||||||
*/
|
*/
|
||||||
ds = isc_mem_get(mctx, n * sizeof(dns_rdata_ds_t));
|
ds = isc_mem_get(mctx, n * sizeof(dns_rdata_ds_t));
|
||||||
|
if (ds == NULL) {
|
||||||
|
fatal("allocating unpacked DS array: %s",
|
||||||
|
isc_result_totext(ISC_R_NOMEMORY));
|
||||||
|
}
|
||||||
|
|
||||||
for (i = 0; i < n; i++) {
|
for (i = 0; i < n; i++) {
|
||||||
result = dns_rdata_tostruct(&arrdata[i], &ds[i], NULL);
|
result = dns_rdata_tostruct(&arrdata[i], &ds[i], NULL);
|
||||||
@@ -1074,7 +1144,10 @@ main(int argc, char *argv[]) {
|
|||||||
int ch;
|
int ch;
|
||||||
char *endp;
|
char *endp;
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
result = isc_mem_create(0, 0, &mctx);
|
||||||
|
if (result != ISC_R_SUCCESS) {
|
||||||
|
fatal("out of memory");
|
||||||
|
}
|
||||||
|
|
||||||
#if USE_PKCS11
|
#if USE_PKCS11
|
||||||
pk11_result_register();
|
pk11_result_register();
|
||||||
@@ -1087,7 +1160,7 @@ main(int argc, char *argv[]) {
|
|||||||
while ((ch = isc_commandline_parse(argc, argv, OPTIONS)) != -1) {
|
while ((ch = isc_commandline_parse(argc, argv, OPTIONS)) != -1) {
|
||||||
switch (ch) {
|
switch (ch) {
|
||||||
case 'a':
|
case 'a':
|
||||||
add_dtype(strtodsdigest(isc_commandline_argument));
|
add_dtype(isc_commandline_argument);
|
||||||
break;
|
break;
|
||||||
case 'c':
|
case 'c':
|
||||||
rdclass = strtoclass(isc_commandline_argument);
|
rdclass = strtoclass(isc_commandline_argument);
|
||||||
|
|||||||
@@ -40,8 +40,6 @@
|
|||||||
<copyright>
|
<copyright>
|
||||||
<year>2017</year>
|
<year>2017</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
@@ -145,9 +143,9 @@
|
|||||||
record. This option has no effect when using CDS records.
|
record. This option has no effect when using CDS records.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
The <replaceable>algorithm</replaceable> must be one of
|
The <replaceable>algorithm</replaceable> must be one of SHA-1
|
||||||
SHA-1, SHA-256, or SHA-384. These values are case insensitive,
|
(SHA1), SHA-256 (SHA256), or SHA-384 (SHA384). These
|
||||||
and the hyphen may be omitted. If no algorithm is specified,
|
values are case insensitive. If no algorithm is specified,
|
||||||
the default is SHA-256.
|
the default is SHA-256.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2017-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2017, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -129,9 +129,9 @@
|
|||||||
record. This option has no effect when using CDS records.
|
record. This option has no effect when using CDS records.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
The <em class="replaceable"><code>algorithm</code></em> must be one of
|
The <em class="replaceable"><code>algorithm</code></em> must be one of SHA-1
|
||||||
SHA-1, SHA-256, or SHA-384. These values are case insensitive,
|
(SHA1), SHA-256 (SHA256), or SHA-384 (SHA384). These
|
||||||
and the hyphen may be omitted. If no algorithm is specified,
|
values are case insensitive. If no algorithm is specified,
|
||||||
the default is SHA-256.
|
the default is SHA-256.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2008-2012, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2008-2012, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -10,12 +10,12 @@
|
|||||||
.\" Title: dnssec-dsfromkey
|
.\" Title: dnssec-dsfromkey
|
||||||
.\" Author:
|
.\" Author:
|
||||||
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
||||||
.\" Date: 2019-05-08
|
.\" Date: 2012-05-02
|
||||||
.\" Manual: BIND9
|
.\" Manual: BIND9
|
||||||
.\" Source: ISC
|
.\" Source: ISC
|
||||||
.\" Language: English
|
.\" Language: English
|
||||||
.\"
|
.\"
|
||||||
.TH "DNSSEC\-DSFROMKEY" "8" "2019\-05\-08" "ISC" "BIND9"
|
.TH "DNSSEC\-DSFROMKEY" "8" "2012\-05\-02" "ISC" "BIND9"
|
||||||
.\" -----------------------------------------------------------------
|
.\" -----------------------------------------------------------------
|
||||||
.\" * Define some portability stuff
|
.\" * Define some portability stuff
|
||||||
.\" -----------------------------------------------------------------
|
.\" -----------------------------------------------------------------
|
||||||
@@ -39,99 +39,61 @@
|
|||||||
dnssec-dsfromkey \- DNSSEC DS RR generation tool
|
dnssec-dsfromkey \- DNSSEC DS RR generation tool
|
||||||
.SH "SYNOPSIS"
|
.SH "SYNOPSIS"
|
||||||
.HP \w'\fBdnssec\-dsfromkey\fR\ 'u
|
.HP \w'\fBdnssec\-dsfromkey\fR\ 'u
|
||||||
\fBdnssec\-dsfromkey\fR [\fB\-1\fR | \fB\-2\fR | \fB\-a\ \fR\fB\fIalg\fR\fR] [\fB\-C\fR | \fB\-l\ \fR\fB\fIdomain\fR\fR] [\fB\-T\ \fR\fB\fITTL\fR\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] {keyfile}
|
\fBdnssec\-dsfromkey\fR [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-1\fR] [\fB\-2\fR] [\fB\-a\ \fR\fB\fIalg\fR\fR] [\fB\-C\fR] [\fB\-l\ \fR\fB\fIdomain\fR\fR] [\fB\-T\ \fR\fB\fITTL\fR\fR] {keyfile}
|
||||||
.HP \w'\fBdnssec\-dsfromkey\fR\ 'u
|
.HP \w'\fBdnssec\-dsfromkey\fR\ 'u
|
||||||
\fBdnssec\-dsfromkey\fR [\fB\-1\fR | \fB\-2\fR | \fB\-a\ \fR\fB\fIalg\fR\fR] [\fB\-C\fR | \fB\-l\ \fR\fB\fIdomain\fR\fR] [\fB\-T\ \fR\fB\fITTL\fR\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-A\fR] {\fB\-f\ \fR\fB\fIfile\fR\fR} [dnsname]
|
\fBdnssec\-dsfromkey\fR {\-s} [\fB\-1\fR] [\fB\-2\fR] [\fB\-a\ \fR\fB\fIalg\fR\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-l\ \fR\fB\fIdomain\fR\fR] [\fB\-s\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-T\ \fR\fB\fITTL\fR\fR] [\fB\-f\ \fR\fB\fIfile\fR\fR] [\fB\-A\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] {dnsname}
|
||||||
.HP \w'\fBdnssec\-dsfromkey\fR\ 'u
|
.HP \w'\fBdnssec\-dsfromkey\fR\ 'u
|
||||||
\fBdnssec\-dsfromkey\fR [\fB\-1\fR | \fB\-2\fR | \fB\-a\ \fR\fB\fIalg\fR\fR] [\fB\-C\fR | \fB\-l\ \fR\fB\fIdomain\fR\fR] [\fB\-T\ \fR\fB\fITTL\fR\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] {\-s} {dnsname}
|
\fBdnssec\-dsfromkey\fR [\fB\-h\fR] [\fB\-V\fR]
|
||||||
.HP \w'\fBdnssec\-dsfromkey\fR\ 'u
|
|
||||||
\fBdnssec\-dsfromkey\fR [\fB\-h\fR | \fB\-V\fR]
|
|
||||||
.SH "DESCRIPTION"
|
.SH "DESCRIPTION"
|
||||||
.PP
|
.PP
|
||||||
The
|
|
||||||
\fBdnssec\-dsfromkey\fR
|
\fBdnssec\-dsfromkey\fR
|
||||||
command outputs DS (Delegation Signer) resource records (RRs), or CDS (Child DS) RRs with the
|
outputs the Delegation Signer (DS) resource record (RR), as defined in RFC 3658 and RFC 4509, for the given key(s)\&.
|
||||||
\fB\-C\fR
|
|
||||||
option\&.
|
|
||||||
.PP
|
|
||||||
The input keys can be specified in a number of ways:
|
|
||||||
.PP
|
|
||||||
By default,
|
|
||||||
\fBdnssec\-dsfromkey\fR
|
|
||||||
reads a key file named like
|
|
||||||
Knnnn\&.+aaa+iiiii\&.key, as generated by
|
|
||||||
\fBdnssec\-keygen\fR\&.
|
|
||||||
.PP
|
|
||||||
With the
|
|
||||||
\fB\-f \fR\fB\fIfile\fR\fR
|
|
||||||
option,
|
|
||||||
\fBdnssec\-dsfromkey\fR
|
|
||||||
reads keys from a zone file or partial zone file (which can contain just the DNSKEY records)\&.
|
|
||||||
.PP
|
|
||||||
With the
|
|
||||||
\fB\-s\fR
|
|
||||||
option,
|
|
||||||
\fBdnssec\-dsfromkey\fR
|
|
||||||
reads a
|
|
||||||
keyset\-
|
|
||||||
file, as generated by
|
|
||||||
\fBdnssec\-keygen\fR\fB\-C\fR\&.
|
|
||||||
.SH "OPTIONS"
|
.SH "OPTIONS"
|
||||||
.PP
|
.PP
|
||||||
\-1
|
\-1
|
||||||
.RS 4
|
.RS 4
|
||||||
An abbreviation for
|
Use SHA\-1 as the digest algorithm (the default is to use both SHA\-1 and SHA\-256)\&.
|
||||||
\fB\-a SHA\-1\fR\&. (Note: The SHA\-1 algorithm is no longer recommended for use when generating new DS and CDS records\&.)
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-2
|
\-2
|
||||||
.RS 4
|
.RS 4
|
||||||
An abbreviation for
|
Use SHA\-256 as the digest algorithm\&.
|
||||||
\fB\-a SHA\-256\fR\&.
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-a \fIalgorithm\fR
|
\-a \fIalgorithm\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Specify a digest algorithm to use when converting DNSKEY records to DS records\&. This option can be repeated, so that multiple DS records are created for each DNSKEY record\&.
|
Select the digest algorithm\&. The value of
|
||||||
.sp
|
\fBalgorithm\fR
|
||||||
The
|
must be one of SHA\-1 (SHA1), SHA\-256 (SHA256) or SHA\-384 (SHA384)\&. These values are case insensitive\&.
|
||||||
\fIalgorithm\fR
|
|
||||||
must be one of SHA\-1, SHA\-256, or SHA\-384\&. These values are case insensitive, and the hyphen may be omitted\&. If no algorithm is specified, the default is SHA\-256\&. (Note: The SHA\-1 algorithm is no longer recommended for use when generating new DS and CDS records\&.)
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-A
|
|
||||||
.RS 4
|
|
||||||
Include ZSKs when generating DS records\&. Without this option, only keys which have the KSK flag set will be converted to DS records and printed\&. Useful only in
|
|
||||||
\fB\-f\fR
|
|
||||||
zone file mode\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-c \fIclass\fR
|
|
||||||
.RS 4
|
|
||||||
Specifies the DNS class (default is IN)\&. Useful only in
|
|
||||||
\fB\-s\fR
|
|
||||||
keyset or
|
|
||||||
\fB\-f\fR
|
|
||||||
zone file mode\&.
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-C
|
\-C
|
||||||
.RS 4
|
.RS 4
|
||||||
Generate CDS records rather than DS records\&.
|
Generate CDS records rather than DS records\&. This is mutually exclusive with generating lookaside records\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
\-T \fITTL\fR
|
||||||
|
.RS 4
|
||||||
|
Specifies the TTL of the DS records\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
\-K \fIdirectory\fR
|
||||||
|
.RS 4
|
||||||
|
Look for key files (or, in keyset mode,
|
||||||
|
keyset\-
|
||||||
|
files) in
|
||||||
|
\fBdirectory\fR\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-f \fIfile\fR
|
\-f \fIfile\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Zone file mode:
|
Zone file mode: in place of the keyfile name, the argument is the DNS domain name of a zone master file, which can be read from
|
||||||
\fBdnssec\-dsfromkey\fR\*(Aqs final
|
|
||||||
\fIdnsname\fR
|
|
||||||
argument is the DNS domain name of a zone whose master file can be read from
|
|
||||||
\fBfile\fR\&. If the zone name is the same as
|
\fBfile\fR\&. If the zone name is the same as
|
||||||
\fBfile\fR, then it may be omitted\&.
|
\fBfile\fR, then it may be omitted\&.
|
||||||
.sp
|
.sp
|
||||||
If
|
If
|
||||||
\fIfile\fR
|
\fBfile\fR
|
||||||
is
|
is set to
|
||||||
"\-", then the zone data is read from the standard input\&. This makes it possible to use the output of the
|
"\-", then the zone data is read from the standard input\&. This makes it possible to use the output of the
|
||||||
\fBdig\fR
|
\fBdig\fR
|
||||||
command as input, as in:
|
command as input, as in:
|
||||||
@@ -139,32 +101,26 @@ command as input, as in:
|
|||||||
\fBdig dnskey example\&.com | dnssec\-dsfromkey \-f \- example\&.com\fR
|
\fBdig dnskey example\&.com | dnssec\-dsfromkey \-f \- example\&.com\fR
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-h
|
\-A
|
||||||
.RS 4
|
.RS 4
|
||||||
Prints usage information\&.
|
Include ZSKs when generating DS records\&. Without this option, only keys which have the KSK flag set will be converted to DS records and printed\&. Useful only in zone file mode\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-K \fIdirectory\fR
|
\-l \fIdomain\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Look for key files or
|
Generate a DLV set instead of a DS set\&. The specified
|
||||||
keyset\-
|
\fBdomain\fR
|
||||||
files in
|
is appended to the name for each record in the set\&. The DNSSEC Lookaside Validation (DLV) RR is described in RFC 4431\&. This is mutually exclusive with generating CDS records\&.
|
||||||
\fBdirectory\fR\&.
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-s
|
\-s
|
||||||
.RS 4
|
.RS 4
|
||||||
Keyset mode:
|
Keyset mode: in place of the keyfile name, the argument is the DNS domain name of a keyset file\&.
|
||||||
\fBdnssec\-dsfromkey\fR\*(Aqs final
|
|
||||||
\fIdnsname\fR
|
|
||||||
argument is the DNS domain name used to locate a
|
|
||||||
keyset\-
|
|
||||||
file\&.
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-T \fITTL\fR
|
\-c \fIclass\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Specifies the TTL of the DS records\&. By default the TTL is omitted\&.
|
Specifies the DNS class (default is IN)\&. Useful only in keyset or zone file mode\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-v \fIlevel\fR
|
\-v \fIlevel\fR
|
||||||
@@ -172,6 +128,11 @@ Specifies the TTL of the DS records\&. By default the TTL is omitted\&.
|
|||||||
Sets the debugging level\&.
|
Sets the debugging level\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
|
\-h
|
||||||
|
.RS 4
|
||||||
|
Prints usage information\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
\-V
|
\-V
|
||||||
.RS 4
|
.RS 4
|
||||||
Prints version information\&.
|
Prints version information\&.
|
||||||
@@ -180,16 +141,16 @@ Prints version information\&.
|
|||||||
.PP
|
.PP
|
||||||
To build the SHA\-256 DS RR from the
|
To build the SHA\-256 DS RR from the
|
||||||
\fBKexample\&.com\&.+003+26160\fR
|
\fBKexample\&.com\&.+003+26160\fR
|
||||||
keyfile name, you can issue the following command:
|
keyfile name, the following command would be issued:
|
||||||
.PP
|
.PP
|
||||||
\fBdnssec\-dsfromkey \-2 Kexample\&.com\&.+003+26160\fR
|
\fBdnssec\-dsfromkey \-2 Kexample\&.com\&.+003+26160\fR
|
||||||
.PP
|
.PP
|
||||||
The command would print something like:
|
The command would print something like:
|
||||||
.PP
|
.PP
|
||||||
\fBexample\&.com\&. IN DS 26160 5 2 3A1EADA7A74B8D0BA86726B0C227AA85AB8BBD2B2004F41A868A54F0C5EA0B94\fR
|
\fBexample\&.com\&. IN DS 26160 5 2 3A1EADA7A74B8D0BA86726B0C227AA85AB8BBD2B2004F41A868A54F0 C5EA0B94\fR
|
||||||
.SH "FILES"
|
.SH "FILES"
|
||||||
.PP
|
.PP
|
||||||
The keyfile can be designated by the key identification
|
The keyfile can be designed by the key identification
|
||||||
Knnnn\&.+aaa+iiiii
|
Knnnn\&.+aaa+iiiii
|
||||||
or the full file name
|
or the full file name
|
||||||
Knnnn\&.+aaa+iiiii\&.key
|
Knnnn\&.+aaa+iiiii\&.key
|
||||||
@@ -209,18 +170,13 @@ A keyfile error can give a "file not found" even if the file exists\&.
|
|||||||
\fBdnssec-keygen\fR(8),
|
\fBdnssec-keygen\fR(8),
|
||||||
\fBdnssec-signzone\fR(8),
|
\fBdnssec-signzone\fR(8),
|
||||||
BIND 9 Administrator Reference Manual,
|
BIND 9 Administrator Reference Manual,
|
||||||
RFC 3658
|
RFC 3658,
|
||||||
(DS RRs),
|
RFC 4431\&.
|
||||||
RFC 4509
|
RFC 4509\&.
|
||||||
(SHA\-256 for DS RRs),
|
|
||||||
RFC 6605
|
|
||||||
(SHA\-384 for DS RRs),
|
|
||||||
RFC 7344
|
|
||||||
(CDS and CDNSKEY RRs)\&.
|
|
||||||
.SH "AUTHOR"
|
.SH "AUTHOR"
|
||||||
.PP
|
.PP
|
||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2008-2012, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2008-2012, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
+119
-97
@@ -11,6 +11,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <inttypes.h>
|
#include <inttypes.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
@@ -47,7 +49,12 @@
|
|||||||
|
|
||||||
#include "dnssectool.h"
|
#include "dnssectool.h"
|
||||||
|
|
||||||
|
#ifndef PATH_MAX
|
||||||
|
#define PATH_MAX 1024 /* WIN32, and others don't define this. */
|
||||||
|
#endif
|
||||||
|
|
||||||
const char *program = "dnssec-dsfromkey";
|
const char *program = "dnssec-dsfromkey";
|
||||||
|
int verbose;
|
||||||
|
|
||||||
static dns_rdataclass_t rdclass;
|
static dns_rdataclass_t rdclass;
|
||||||
static dns_fixedname_t fixed;
|
static dns_fixedname_t fixed;
|
||||||
@@ -200,13 +207,16 @@ loadkey(char *filename, unsigned char *key_buf, unsigned int key_buf_size,
|
|||||||
rdclass = dst_key_class(key);
|
rdclass = dst_key_class(key);
|
||||||
|
|
||||||
name = dns_fixedname_initname(&fixed);
|
name = dns_fixedname_initname(&fixed);
|
||||||
dns_name_copynf(dst_key_name(key), name);
|
result = dns_name_copy(dst_key_name(key), name, NULL);
|
||||||
|
if (result != ISC_R_SUCCESS)
|
||||||
|
fatal("can't copy name");
|
||||||
|
|
||||||
dst_key_free(&key);
|
dst_key_free(&key);
|
||||||
}
|
}
|
||||||
|
|
||||||
static void
|
static void
|
||||||
logkey(dns_rdata_t *rdata) {
|
logkey(dns_rdata_t *rdata)
|
||||||
|
{
|
||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
dst_key_t *key = NULL;
|
dst_key_t *key = NULL;
|
||||||
isc_buffer_t buf;
|
isc_buffer_t buf;
|
||||||
@@ -225,7 +235,9 @@ logkey(dns_rdata_t *rdata) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
static void
|
static void
|
||||||
emit(dns_dsdigest_t dt, bool showall, bool cds, dns_rdata_t *rdata) {
|
emit(unsigned int dtype, bool showall, char *lookaside,
|
||||||
|
bool cds, dns_rdata_t *rdata)
|
||||||
|
{
|
||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
unsigned char buf[DNS_DS_BUFFERSIZE];
|
unsigned char buf[DNS_DS_BUFFERSIZE];
|
||||||
char text_buf[DST_KEY_MAXTEXTSIZE];
|
char text_buf[DST_KEY_MAXTEXTSIZE];
|
||||||
@@ -249,7 +261,7 @@ emit(dns_dsdigest_t dt, bool showall, bool cds, dns_rdata_t *rdata) {
|
|||||||
if ((dnskey.flags & DNS_KEYFLAG_KSK) == 0 && !showall)
|
if ((dnskey.flags & DNS_KEYFLAG_KSK) == 0 && !showall)
|
||||||
return;
|
return;
|
||||||
|
|
||||||
result = dns_ds_buildrdata(name, rdata, dt, buf, &ds);
|
result = dns_ds_buildrdata(name, rdata, dtype, buf, &ds);
|
||||||
if (result != ISC_R_SUCCESS)
|
if (result != ISC_R_SUCCESS)
|
||||||
fatal("can't build record");
|
fatal("can't build record");
|
||||||
|
|
||||||
@@ -257,6 +269,18 @@ emit(dns_dsdigest_t dt, bool showall, bool cds, dns_rdata_t *rdata) {
|
|||||||
if (result != ISC_R_SUCCESS)
|
if (result != ISC_R_SUCCESS)
|
||||||
fatal("can't print name");
|
fatal("can't print name");
|
||||||
|
|
||||||
|
/* Add lookaside origin, if set */
|
||||||
|
if (lookaside != NULL) {
|
||||||
|
if (isc_buffer_availablelength(&nameb) < strlen(lookaside))
|
||||||
|
fatal("DLV origin '%s' is too long", lookaside);
|
||||||
|
isc_buffer_putstr(&nameb, lookaside);
|
||||||
|
if (lookaside[strlen(lookaside) - 1] != '.') {
|
||||||
|
if (isc_buffer_availablelength(&nameb) < 1)
|
||||||
|
fatal("DLV origin '%s' is too long", lookaside);
|
||||||
|
isc_buffer_putstr(&nameb, ".");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
result = dns_rdata_tofmttext(&ds, (dns_name_t *) NULL, 0, 0, 0, "",
|
result = dns_rdata_tofmttext(&ds, (dns_name_t *) NULL, 0, 0, 0, "",
|
||||||
&textb);
|
&textb);
|
||||||
|
|
||||||
@@ -276,54 +300,48 @@ emit(dns_dsdigest_t dt, bool showall, bool cds, dns_rdata_t *rdata) {
|
|||||||
isc_buffer_usedregion(&classb, &r);
|
isc_buffer_usedregion(&classb, &r);
|
||||||
printf("%.*s", (int)r.length, r.base);
|
printf("%.*s", (int)r.length, r.base);
|
||||||
|
|
||||||
if (cds) {
|
if (lookaside == NULL) {
|
||||||
printf(" CDS ");
|
if (cds)
|
||||||
} else {
|
printf(" CDS ");
|
||||||
printf(" DS ");
|
else
|
||||||
}
|
printf(" DS ");
|
||||||
|
} else
|
||||||
|
printf(" DLV ");
|
||||||
|
|
||||||
isc_buffer_usedregion(&textb, &r);
|
isc_buffer_usedregion(&textb, &r);
|
||||||
printf("%.*s\n", (int)r.length, r.base);
|
printf("%.*s\n", (int)r.length, r.base);
|
||||||
}
|
}
|
||||||
|
|
||||||
static void
|
|
||||||
emits(bool showall, bool cds, dns_rdata_t *rdata) {
|
|
||||||
unsigned i, n;
|
|
||||||
|
|
||||||
n = sizeof(dtype)/sizeof(dtype[0]);
|
|
||||||
for (i = 0; i < n; i++) {
|
|
||||||
if (dtype[i] != 0) {
|
|
||||||
emit(dtype[i], showall, cds, rdata);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
ISC_PLATFORM_NORETURN_PRE static void
|
ISC_PLATFORM_NORETURN_PRE static void
|
||||||
usage(void) ISC_PLATFORM_NORETURN_POST;
|
usage(void) ISC_PLATFORM_NORETURN_POST;
|
||||||
|
|
||||||
static void
|
static void
|
||||||
usage(void) {
|
usage(void) {
|
||||||
fprintf(stderr, "Usage:\n");
|
fprintf(stderr, "Usage:\n");
|
||||||
fprintf(stderr, " %s [options] keyfile\n\n", program);
|
fprintf(stderr, " %s options [-K dir] keyfile\n\n", program);
|
||||||
fprintf(stderr, " %s [options] -f zonefile [zonename]\n\n", program);
|
fprintf(stderr, " %s options [-K dir] [-c class] -s dnsname\n\n",
|
||||||
fprintf(stderr, " %s [options] -s dnsname\n\n", program);
|
program);
|
||||||
fprintf(stderr, " %s [-h|-V]\n\n", program);
|
fprintf(stderr, " %s options -f zonefile (as zone name)\n\n", program);
|
||||||
|
fprintf(stderr, " %s options -f zonefile zonename\n\n", program);
|
||||||
fprintf(stderr, "Version: %s\n", VERSION);
|
fprintf(stderr, "Version: %s\n", VERSION);
|
||||||
fprintf(stderr, "Options:\n"
|
fprintf(stderr, "Options:\n");
|
||||||
" -1: digest algorithm SHA-1\n"
|
fprintf(stderr, " -v <verbose level>\n");
|
||||||
" -2: digest algorithm SHA-256\n"
|
fprintf(stderr, " -V: print version information\n");
|
||||||
" -a algorithm: digest algorithm (SHA-1, SHA-256 or SHA-384)\n"
|
fprintf(stderr, " -K <directory>: directory in which to find "
|
||||||
" -A: include all keys in DS set, not just KSKs (-f only)\n"
|
"key file or keyset file\n");
|
||||||
" -c class: rdata class for DS set (default IN) (-f or -s only)\n"
|
fprintf(stderr, " -a algorithm: digest algorithm "
|
||||||
" -C: print CDS records\n"
|
"(SHA-1, SHA-256, GOST or SHA-384)\n");
|
||||||
" -f zonefile: read keys from a zone file\n"
|
fprintf(stderr, " -1: use SHA-1\n");
|
||||||
" -h: print help information\n"
|
fprintf(stderr, " -2: use SHA-256\n");
|
||||||
" -K directory: where to find key or keyset files\n"
|
fprintf(stderr, " -C: print CDS record\n");
|
||||||
" -s: read keys from keyset-<dnsname> file\n"
|
fprintf(stderr, " -l: add lookaside zone and print DLV records\n");
|
||||||
" -T: TTL of output records (omitted by default)\n"
|
fprintf(stderr, " -s: read keyset from keyset-<dnsname> file\n");
|
||||||
" -v level: verbosity\n"
|
fprintf(stderr, " -c class: rdata class for DS set (default: IN)\n");
|
||||||
" -V: print version information\n");
|
fprintf(stderr, " -T TTL\n");
|
||||||
fprintf(stderr, "Output: DS or CDS RRs\n");
|
fprintf(stderr, " -f file: read keyset from zone file\n");
|
||||||
|
fprintf(stderr, " -A: when used with -f, "
|
||||||
|
"include all keys in DS set, not just KSKs\n");
|
||||||
|
fprintf(stderr, "Output: DS or DLV RRs\n");
|
||||||
|
|
||||||
exit (-1);
|
exit (-1);
|
||||||
}
|
}
|
||||||
@@ -332,11 +350,14 @@ int
|
|||||||
main(int argc, char **argv) {
|
main(int argc, char **argv) {
|
||||||
char *classname = NULL;
|
char *classname = NULL;
|
||||||
char *filename = NULL, *dir = NULL, *namestr;
|
char *filename = NULL, *dir = NULL, *namestr;
|
||||||
char *endp, *arg1;
|
char *lookaside = NULL;
|
||||||
|
char *endp;
|
||||||
int ch;
|
int ch;
|
||||||
bool cds = false;
|
unsigned int dtype = DNS_DSDIGEST_SHA1;
|
||||||
bool usekeyset = false;
|
bool cds = false;
|
||||||
bool showall = false;
|
bool both = true;
|
||||||
|
bool usekeyset = false;
|
||||||
|
bool showall = false;
|
||||||
isc_result_t result;
|
isc_result_t result;
|
||||||
isc_log_t *log = NULL;
|
isc_log_t *log = NULL;
|
||||||
dns_rdataset_t rdataset;
|
dns_rdataset_t rdataset;
|
||||||
@@ -344,11 +365,12 @@ main(int argc, char **argv) {
|
|||||||
|
|
||||||
dns_rdata_init(&rdata);
|
dns_rdata_init(&rdata);
|
||||||
|
|
||||||
if (argc == 1) {
|
if (argc == 1)
|
||||||
usage();
|
usage();
|
||||||
}
|
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
result = isc_mem_create(0, 0, &mctx);
|
||||||
|
if (result != ISC_R_SUCCESS)
|
||||||
|
fatal("out of memory");
|
||||||
|
|
||||||
#if USE_PKCS11
|
#if USE_PKCS11
|
||||||
pk11_result_register();
|
pk11_result_register();
|
||||||
@@ -361,18 +383,24 @@ main(int argc, char **argv) {
|
|||||||
while ((ch = isc_commandline_parse(argc, argv, OPTIONS)) != -1) {
|
while ((ch = isc_commandline_parse(argc, argv, OPTIONS)) != -1) {
|
||||||
switch (ch) {
|
switch (ch) {
|
||||||
case '1':
|
case '1':
|
||||||
add_dtype(DNS_DSDIGEST_SHA1);
|
dtype = DNS_DSDIGEST_SHA1;
|
||||||
|
both = false;
|
||||||
break;
|
break;
|
||||||
case '2':
|
case '2':
|
||||||
add_dtype(DNS_DSDIGEST_SHA256);
|
dtype = DNS_DSDIGEST_SHA256;
|
||||||
|
both = false;
|
||||||
break;
|
break;
|
||||||
case 'A':
|
case 'A':
|
||||||
showall = true;
|
showall = true;
|
||||||
break;
|
break;
|
||||||
case 'a':
|
case 'a':
|
||||||
add_dtype(strtodsdigest(isc_commandline_argument));
|
dtype = strtodsdigest(isc_commandline_argument);
|
||||||
|
both = false;
|
||||||
break;
|
break;
|
||||||
case 'C':
|
case 'C':
|
||||||
|
if (lookaside != NULL)
|
||||||
|
fatal("lookaside and CDS are mutually"
|
||||||
|
" exclusive");
|
||||||
cds = true;
|
cds = true;
|
||||||
break;
|
break;
|
||||||
case 'c':
|
case 'c':
|
||||||
@@ -391,7 +419,12 @@ main(int argc, char **argv) {
|
|||||||
filename = isc_commandline_argument;
|
filename = isc_commandline_argument;
|
||||||
break;
|
break;
|
||||||
case 'l':
|
case 'l':
|
||||||
fatal("-l option (DLV lookaside) is obsolete");
|
if (cds)
|
||||||
|
fatal("lookaside and CDS are mutually"
|
||||||
|
" exclusive");
|
||||||
|
lookaside = isc_commandline_argument;
|
||||||
|
if (strlen(lookaside) == 0U)
|
||||||
|
fatal("lookaside must be a non-empty string");
|
||||||
break;
|
break;
|
||||||
case 's':
|
case 's':
|
||||||
usekeyset = true;
|
usekeyset = true;
|
||||||
@@ -430,103 +463,92 @@ main(int argc, char **argv) {
|
|||||||
|
|
||||||
rdclass = strtoclass(classname);
|
rdclass = strtoclass(classname);
|
||||||
|
|
||||||
if (usekeyset && filename != NULL) {
|
if (usekeyset && filename != NULL)
|
||||||
fatal("cannot use both -s and -f");
|
fatal("cannot use both -s and -f");
|
||||||
}
|
|
||||||
|
|
||||||
/* When not using -f, -A is implicit */
|
/* When not using -f, -A is implicit */
|
||||||
if (filename == NULL) {
|
if (filename == NULL)
|
||||||
showall = true;
|
showall = true;
|
||||||
}
|
|
||||||
|
|
||||||
/* Default digest type if none specified. */
|
if (argc < isc_commandline_index + 1 && filename == NULL)
|
||||||
if (dtype[0] == 0) {
|
|
||||||
dtype[0] = DNS_DSDIGEST_SHA256;
|
|
||||||
}
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Use local variable arg1 so that clang can correctly analyse
|
|
||||||
* reachable paths rather than 'argc < isc_commandline_index + 1'.
|
|
||||||
*/
|
|
||||||
arg1 = argv[isc_commandline_index];
|
|
||||||
if (arg1 == NULL && filename == NULL) {
|
|
||||||
fatal("the key file name was not specified");
|
fatal("the key file name was not specified");
|
||||||
}
|
if (argc > isc_commandline_index + 1)
|
||||||
if (arg1 != NULL && argv[isc_commandline_index + 1] != NULL) {
|
|
||||||
fatal("extraneous arguments");
|
fatal("extraneous arguments");
|
||||||
}
|
|
||||||
|
|
||||||
result = dst_lib_init(mctx, NULL);
|
result = dst_lib_init(mctx, NULL);
|
||||||
if (result != ISC_R_SUCCESS) {
|
if (result != ISC_R_SUCCESS)
|
||||||
fatal("could not initialize dst: %s",
|
fatal("could not initialize dst: %s",
|
||||||
isc_result_totext(result));
|
isc_result_totext(result));
|
||||||
}
|
|
||||||
|
|
||||||
setup_logging(mctx, &log);
|
setup_logging(mctx, &log);
|
||||||
|
|
||||||
dns_rdataset_init(&rdataset);
|
dns_rdataset_init(&rdataset);
|
||||||
|
|
||||||
if (usekeyset || filename != NULL) {
|
if (usekeyset || filename != NULL) {
|
||||||
if (arg1 == NULL) {
|
if (argc < isc_commandline_index + 1 && filename != NULL) {
|
||||||
/* using file name as the zone name */
|
/* using zone name as the zone file name */
|
||||||
namestr = filename;
|
namestr = filename;
|
||||||
} else {
|
} else
|
||||||
namestr = arg1;
|
namestr = argv[isc_commandline_index];
|
||||||
}
|
|
||||||
|
|
||||||
result = initname(namestr);
|
result = initname(namestr);
|
||||||
if (result != ISC_R_SUCCESS) {
|
if (result != ISC_R_SUCCESS)
|
||||||
fatal("could not initialize name %s", namestr);
|
fatal("could not initialize name %s", namestr);
|
||||||
}
|
|
||||||
|
|
||||||
if (usekeyset) {
|
if (usekeyset)
|
||||||
result = loadkeyset(dir, &rdataset);
|
result = loadkeyset(dir, &rdataset);
|
||||||
} else {
|
else
|
||||||
INSIST(filename != NULL);
|
|
||||||
result = loadset(filename, &rdataset);
|
result = loadset(filename, &rdataset);
|
||||||
}
|
|
||||||
|
|
||||||
if (result != ISC_R_SUCCESS) {
|
if (result != ISC_R_SUCCESS)
|
||||||
fatal("could not load DNSKEY set: %s\n",
|
fatal("could not load DNSKEY set: %s\n",
|
||||||
isc_result_totext(result));
|
isc_result_totext(result));
|
||||||
}
|
|
||||||
|
|
||||||
for (result = dns_rdataset_first(&rdataset);
|
for (result = dns_rdataset_first(&rdataset);
|
||||||
result == ISC_R_SUCCESS;
|
result == ISC_R_SUCCESS;
|
||||||
result = dns_rdataset_next(&rdataset))
|
result = dns_rdataset_next(&rdataset)) {
|
||||||
{
|
|
||||||
dns_rdata_init(&rdata);
|
dns_rdata_init(&rdata);
|
||||||
dns_rdataset_current(&rdataset, &rdata);
|
dns_rdataset_current(&rdataset, &rdata);
|
||||||
|
|
||||||
if (verbose > 2) {
|
if (verbose > 2)
|
||||||
logkey(&rdata);
|
logkey(&rdata);
|
||||||
}
|
|
||||||
|
|
||||||
emits(showall, cds, &rdata);
|
if (both) {
|
||||||
|
emit(DNS_DSDIGEST_SHA1, showall, lookaside,
|
||||||
|
cds, &rdata);
|
||||||
|
emit(DNS_DSDIGEST_SHA256, showall, lookaside,
|
||||||
|
cds, &rdata);
|
||||||
|
} else
|
||||||
|
emit(dtype, showall, lookaside, cds, &rdata);
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
unsigned char key_buf[DST_KEY_MAXSIZE];
|
unsigned char key_buf[DST_KEY_MAXSIZE];
|
||||||
|
|
||||||
loadkey(arg1, key_buf, DST_KEY_MAXSIZE, &rdata);
|
loadkey(argv[isc_commandline_index], key_buf,
|
||||||
|
DST_KEY_MAXSIZE, &rdata);
|
||||||
|
|
||||||
emits(showall, cds, &rdata);
|
if (both) {
|
||||||
|
emit(DNS_DSDIGEST_SHA1, showall, lookaside, cds,
|
||||||
|
&rdata);
|
||||||
|
emit(DNS_DSDIGEST_SHA256, showall, lookaside, cds,
|
||||||
|
&rdata);
|
||||||
|
} else
|
||||||
|
emit(dtype, showall, lookaside, cds, &rdata);
|
||||||
}
|
}
|
||||||
|
|
||||||
if (dns_rdataset_isassociated(&rdataset)) {
|
if (dns_rdataset_isassociated(&rdataset))
|
||||||
dns_rdataset_disassociate(&rdataset);
|
dns_rdataset_disassociate(&rdataset);
|
||||||
}
|
|
||||||
cleanup_logging(&log);
|
cleanup_logging(&log);
|
||||||
dst_lib_destroy();
|
dst_lib_destroy();
|
||||||
if (verbose > 10) {
|
dns_name_destroy();
|
||||||
|
if (verbose > 10)
|
||||||
isc_mem_stats(mctx, stdout);
|
isc_mem_stats(mctx, stdout);
|
||||||
}
|
|
||||||
isc_mem_destroy(&mctx);
|
isc_mem_destroy(&mctx);
|
||||||
|
|
||||||
fflush(stdout);
|
fflush(stdout);
|
||||||
if (ferror(stdout)) {
|
if (ferror(stdout)) {
|
||||||
fprintf(stderr, "write error\n");
|
fprintf(stderr, "write error\n");
|
||||||
return (1);
|
return (1);
|
||||||
} else {
|
} else
|
||||||
return (0);
|
return (0);
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -12,7 +12,7 @@
|
|||||||
<!-- Converted by db4-upgrade version 1.0 -->
|
<!-- Converted by db4-upgrade version 1.0 -->
|
||||||
<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnssec-dsfromkey">
|
<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnssec-dsfromkey">
|
||||||
<info>
|
<info>
|
||||||
<date>2019-05-08</date>
|
<date>2012-05-02</date>
|
||||||
</info>
|
</info>
|
||||||
<refentryinfo>
|
<refentryinfo>
|
||||||
<corpname>ISC</corpname>
|
<corpname>ISC</corpname>
|
||||||
@@ -41,8 +41,6 @@
|
|||||||
<year>2015</year>
|
<year>2015</year>
|
||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
@@ -50,108 +48,56 @@
|
|||||||
<refsynopsisdiv>
|
<refsynopsisdiv>
|
||||||
<cmdsynopsis sepchar=" ">
|
<cmdsynopsis sepchar=" ">
|
||||||
<command>dnssec-dsfromkey</command>
|
<command>dnssec-dsfromkey</command>
|
||||||
<group choice="opt">
|
|
||||||
<arg choice="plain"><option>-1</option></arg>
|
|
||||||
<arg choice="plain"><option>-2</option></arg>
|
|
||||||
<arg choice="plain"><option>-a <replaceable class="parameter">alg</replaceable></option></arg>
|
|
||||||
</group>
|
|
||||||
<group>
|
|
||||||
<arg choice="plain" rep="norepeat"><option>-C</option></arg>
|
|
||||||
<arg choice="plain" rep="norepeat"><option>-l <replaceable class="parameter">domain</replaceable></option></arg>
|
|
||||||
</group>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-T <replaceable class="parameter">TTL</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-v <replaceable class="parameter">level</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-v <replaceable class="parameter">level</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-K <replaceable class="parameter">directory</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-1</option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-2</option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-a <replaceable class="parameter">alg</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-C</option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-l <replaceable class="parameter">domain</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-T <replaceable class="parameter">TTL</replaceable></option></arg>
|
||||||
<arg choice="req" rep="norepeat">keyfile</arg>
|
<arg choice="req" rep="norepeat">keyfile</arg>
|
||||||
</cmdsynopsis>
|
</cmdsynopsis>
|
||||||
<cmdsynopsis sepchar=" ">
|
<cmdsynopsis sepchar=" ">
|
||||||
<command>dnssec-dsfromkey</command>
|
<command>dnssec-dsfromkey</command>
|
||||||
<group choice="opt">
|
|
||||||
<arg choice="plain"><option>-1</option></arg>
|
|
||||||
<arg choice="plain"><option>-2</option></arg>
|
|
||||||
<arg choice="plain"><option>-a <replaceable class="parameter">alg</replaceable></option></arg>
|
|
||||||
</group>
|
|
||||||
<group>
|
|
||||||
<arg choice="plain" rep="norepeat"><option>-C</option></arg>
|
|
||||||
<arg choice="plain" rep="norepeat"><option>-l <replaceable class="parameter">domain</replaceable></option></arg>
|
|
||||||
</group>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-T <replaceable class="parameter">TTL</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-v <replaceable class="parameter">level</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-c <replaceable class="parameter">class</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-A</option></arg>
|
|
||||||
<arg choice="req" rep="norepeat"><option>-f <replaceable class="parameter">file</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat">dnsname</arg>
|
|
||||||
</cmdsynopsis>
|
|
||||||
<cmdsynopsis sepchar=" ">
|
|
||||||
<command>dnssec-dsfromkey</command>
|
|
||||||
<group choice="opt">
|
|
||||||
<arg choice="plain"><option>-1</option></arg>
|
|
||||||
<arg choice="plain"><option>-2</option></arg>
|
|
||||||
<arg choice="plain"><option>-a <replaceable class="parameter">alg</replaceable></option></arg>
|
|
||||||
</group>
|
|
||||||
<group>
|
|
||||||
<arg choice="plain" rep="norepeat"><option>-C</option></arg>
|
|
||||||
<arg choice="plain" rep="norepeat"><option>-l <replaceable class="parameter">domain</replaceable></option></arg>
|
|
||||||
</group>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-T <replaceable class="parameter">TTL</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-v <replaceable class="parameter">level</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-c <replaceable class="parameter">class</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-K <replaceable class="parameter">directory</replaceable></option></arg>
|
|
||||||
<arg choice="req" rep="norepeat">-s</arg>
|
<arg choice="req" rep="norepeat">-s</arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-1</option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-2</option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-a <replaceable class="parameter">alg</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-K <replaceable class="parameter">directory</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-l <replaceable class="parameter">domain</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-s</option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-c <replaceable class="parameter">class</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-T <replaceable class="parameter">TTL</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-f <replaceable class="parameter">file</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-A</option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-v <replaceable class="parameter">level</replaceable></option></arg>
|
||||||
<arg choice="req" rep="norepeat">dnsname</arg>
|
<arg choice="req" rep="norepeat">dnsname</arg>
|
||||||
</cmdsynopsis>
|
</cmdsynopsis>
|
||||||
<cmdsynopsis sepchar=" ">
|
<cmdsynopsis sepchar=" ">
|
||||||
<command>dnssec-dsfromkey</command>
|
<command>dnssec-dsfromkey</command>
|
||||||
<group choice="opt">
|
<arg choice="opt" rep="norepeat"><option>-h</option></arg>
|
||||||
<arg choice="plain" rep="norepeat"><option>-h</option></arg>
|
<arg choice="opt" rep="norepeat"><option>-V</option></arg>
|
||||||
<arg choice="plain" rep="norepeat"><option>-V</option></arg>
|
</cmdsynopsis>
|
||||||
</group>
|
|
||||||
</cmdsynopsis>
|
|
||||||
</refsynopsisdiv>
|
</refsynopsisdiv>
|
||||||
|
|
||||||
<refsection><info><title>DESCRIPTION</title></info>
|
<refsection><info><title>DESCRIPTION</title></info>
|
||||||
|
|
||||||
<para>
|
<para><command>dnssec-dsfromkey</command>
|
||||||
The <command>dnssec-dsfromkey</command> command outputs DS (Delegation
|
outputs the Delegation Signer (DS) resource record (RR), as defined in
|
||||||
Signer) resource records (RRs), or CDS (Child DS) RRs with the
|
RFC 3658 and RFC 4509, for the given key(s).
|
||||||
<option>-C</option> option.
|
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
|
||||||
The input keys can be specified in a number of ways:
|
|
||||||
</para>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
By default, <command>dnssec-dsfromkey</command> reads a key file
|
|
||||||
named like <filename>Knnnn.+aaa+iiiii.key</filename>, as generated
|
|
||||||
by <command>dnssec-keygen</command>.
|
|
||||||
</para>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
With the <option>-f <replaceable>file</replaceable></option>
|
|
||||||
option, <command>dnssec-dsfromkey</command> reads keys from a zone file
|
|
||||||
or partial zone file (which can contain just the DNSKEY records).
|
|
||||||
</para>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
With the <option>-s</option>
|
|
||||||
option, <command>dnssec-dsfromkey</command> reads
|
|
||||||
a <filename>keyset-</filename> file, as generated
|
|
||||||
by <command>dnssec-keygen</command> <option>-C</option>.
|
|
||||||
</para>
|
|
||||||
|
|
||||||
</refsection>
|
</refsection>
|
||||||
|
|
||||||
<refsection><info><title>OPTIONS</title></info>
|
<refsection><info><title>OPTIONS</title></info>
|
||||||
|
|
||||||
|
|
||||||
<variablelist>
|
<variablelist>
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-1</term>
|
<term>-1</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
An abbreviation for <option>-a SHA-1</option>.
|
Use SHA-1 as the digest algorithm (the default is to use
|
||||||
(Note: The SHA-1 algorithm is no longer recommended for use
|
both SHA-1 and SHA-256).
|
||||||
when generating new DS and CDS records.)
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -160,7 +106,7 @@
|
|||||||
<term>-2</term>
|
<term>-2</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
An abbreviation for <option>-a SHA-256</option>.
|
Use SHA-256 as the digest algorithm.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -169,49 +115,40 @@
|
|||||||
<term>-a <replaceable class="parameter">algorithm</replaceable></term>
|
<term>-a <replaceable class="parameter">algorithm</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Specify a digest algorithm to use when converting DNSKEY
|
Select the digest algorithm. The value of
|
||||||
records to DS records. This option can be repeated, so
|
<option>algorithm</option> must be one of SHA-1 (SHA1),
|
||||||
that multiple DS records are created for each DNSKEY
|
SHA-256 (SHA256) or SHA-384 (SHA384).
|
||||||
record.
|
These values are case insensitive.
|
||||||
</para>
|
|
||||||
<para>
|
|
||||||
The <replaceable>algorithm</replaceable> must be one of
|
|
||||||
SHA-1, SHA-256, or SHA-384. These values are case insensitive,
|
|
||||||
and the hyphen may be omitted. If no algorithm is specified,
|
|
||||||
the default is SHA-256.
|
|
||||||
(Note: The SHA-1 algorithm is no longer recommended for use
|
|
||||||
when generating new DS and CDS records.)
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-A</term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Include ZSKs when generating DS records. Without this option, only
|
|
||||||
keys which have the KSK flag set will be converted to DS records
|
|
||||||
and printed. Useful only in <option>-f</option> zone file mode.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-c <replaceable class="parameter">class</replaceable></term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Specifies the DNS class (default is IN). Useful only
|
|
||||||
in <option>-s</option> keyset or <option>-f</option>
|
|
||||||
zone file mode.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-C</term>
|
<term>-C</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Generate CDS records rather than DS records.
|
Generate CDS records rather than DS records. This is mutually
|
||||||
|
exclusive with generating lookaside records.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>-T <replaceable class="parameter">TTL</replaceable></term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Specifies the TTL of the DS records.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>-K <replaceable class="parameter">directory</replaceable></term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Look for key files (or, in keyset mode,
|
||||||
|
<filename>keyset-</filename> files) in
|
||||||
|
<option>directory</option>.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -220,14 +157,13 @@
|
|||||||
<term>-f <replaceable class="parameter">file</replaceable></term>
|
<term>-f <replaceable class="parameter">file</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Zone file mode: <command>dnssec-dsfromkey</command>'s
|
Zone file mode: in place of the keyfile name, the argument is
|
||||||
final <replaceable>dnsname</replaceable> argument is
|
the DNS domain name of a zone master file, which can be read
|
||||||
the DNS domain name of a zone whose master file can be read
|
|
||||||
from <option>file</option>. If the zone name is the same as
|
from <option>file</option>. If the zone name is the same as
|
||||||
<option>file</option>, then it may be omitted.
|
<option>file</option>, then it may be omitted.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
If <replaceable>file</replaceable> is <literal>"-"</literal>, then
|
If <option>file</option> is set to <literal>"-"</literal>, then
|
||||||
the zone data is read from the standard input. This makes it
|
the zone data is read from the standard input. This makes it
|
||||||
possible to use the output of the <command>dig</command>
|
possible to use the output of the <command>dig</command>
|
||||||
command as input, as in:
|
command as input, as in:
|
||||||
@@ -239,20 +175,26 @@
|
|||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-h</term>
|
<term>-A</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Prints usage information.
|
Include ZSKs when generating DS records. Without this option,
|
||||||
</para>
|
only keys which have the KSK flag set will be converted to DS
|
||||||
</listitem>
|
records and printed. Useful only in zone file mode.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-K <replaceable class="parameter">directory</replaceable></term>
|
<term>-l <replaceable class="parameter">domain</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Look for key files or <filename>keyset-</filename> files in
|
Generate a DLV set instead of a DS set. The specified
|
||||||
<option>directory</option>.
|
<option>domain</option> is appended to the name for each
|
||||||
|
record in the set.
|
||||||
|
The DNSSEC Lookaside Validation (DLV) RR is described
|
||||||
|
in RFC 4431. This is mutually exclusive with generating
|
||||||
|
CDS records.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -261,18 +203,18 @@
|
|||||||
<term>-s</term>
|
<term>-s</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Keyset mode: <command>dnssec-dsfromkey</command>'s
|
Keyset mode: in place of the keyfile name, the argument is
|
||||||
final <replaceable>dnsname</replaceable> argument is the DNS
|
the DNS domain name of a keyset file.
|
||||||
domain name used to locate a <filename>keyset-</filename> file.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-T <replaceable class="parameter">TTL</replaceable></term>
|
<term>-c <replaceable class="parameter">class</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Specifies the TTL of the DS records. By default the TTL is omitted.
|
Specifies the DNS class (default is IN). Useful only
|
||||||
|
in keyset or zone file mode.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -286,6 +228,15 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>-h</term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Prints usage information.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-V</term>
|
<term>-V</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
@@ -302,22 +253,21 @@
|
|||||||
<para>
|
<para>
|
||||||
To build the SHA-256 DS RR from the
|
To build the SHA-256 DS RR from the
|
||||||
<userinput>Kexample.com.+003+26160</userinput>
|
<userinput>Kexample.com.+003+26160</userinput>
|
||||||
keyfile name, you can issue the following command:
|
keyfile name, the following command would be issued:
|
||||||
</para>
|
</para>
|
||||||
<para><userinput>dnssec-dsfromkey -2 Kexample.com.+003+26160</userinput>
|
<para><userinput>dnssec-dsfromkey -2 Kexample.com.+003+26160</userinput>
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
The command would print something like:
|
The command would print something like:
|
||||||
</para>
|
</para>
|
||||||
<para><userinput>example.com. IN DS 26160 5 2 3A1EADA7A74B8D0BA86726B0C227AA85AB8BBD2B2004F41A868A54F0C5EA0B94</userinput>
|
<para><userinput>example.com. IN DS 26160 5 2 3A1EADA7A74B8D0BA86726B0C227AA85AB8BBD2B2004F41A868A54F0 C5EA0B94</userinput>
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
</refsection>
|
</refsection>
|
||||||
|
|
||||||
<refsection><info><title>FILES</title></info>
|
<refsection><info><title>FILES</title></info>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
The keyfile can be designated by the key identification
|
The keyfile can be designed by the key identification
|
||||||
<filename>Knnnn.+aaa+iiiii</filename> or the full file name
|
<filename>Knnnn.+aaa+iiiii</filename> or the full file name
|
||||||
<filename>Knnnn.+aaa+iiiii.key</filename> as generated by
|
<filename>Knnnn.+aaa+iiiii.key</filename> as generated by
|
||||||
<refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>.
|
<refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>.
|
||||||
@@ -345,10 +295,9 @@
|
|||||||
<refentrytitle>dnssec-signzone</refentrytitle><manvolnum>8</manvolnum>
|
<refentrytitle>dnssec-signzone</refentrytitle><manvolnum>8</manvolnum>
|
||||||
</citerefentry>,
|
</citerefentry>,
|
||||||
<citetitle>BIND 9 Administrator Reference Manual</citetitle>,
|
<citetitle>BIND 9 Administrator Reference Manual</citetitle>,
|
||||||
<citetitle>RFC 3658</citetitle> (DS RRs),
|
<citetitle>RFC 3658</citetitle>,
|
||||||
<citetitle>RFC 4509</citetitle> (SHA-256 for DS RRs),
|
<citetitle>RFC 4431</citetitle>.
|
||||||
<citetitle>RFC 6605</citetitle> (SHA-384 for DS RRs),
|
<citetitle>RFC 4509</citetitle>.
|
||||||
<citetitle>RFC 7344</citetitle> (CDS and CDNSKEY RRs).
|
|
||||||
</para>
|
</para>
|
||||||
</refsection>
|
</refsection>
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2008-2012, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2008-2012, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -33,167 +33,105 @@
|
|||||||
<h2>Synopsis</h2>
|
<h2>Synopsis</h2>
|
||||||
<div class="cmdsynopsis"><p>
|
<div class="cmdsynopsis"><p>
|
||||||
<code class="command">dnssec-dsfromkey</code>
|
<code class="command">dnssec-dsfromkey</code>
|
||||||
[
|
|
||||||
<code class="option">-1</code>
|
|
||||||
| <code class="option">-2</code>
|
|
||||||
| <code class="option">-a <em class="replaceable"><code>alg</code></em></code>
|
|
||||||
]
|
|
||||||
[
|
|
||||||
<code class="option">-C</code>
|
|
||||||
| <code class="option">-l <em class="replaceable"><code>domain</code></em></code>
|
|
||||||
]
|
|
||||||
[<code class="option">-T <em class="replaceable"><code>TTL</code></em></code>]
|
|
||||||
[<code class="option">-v <em class="replaceable"><code>level</code></em></code>]
|
[<code class="option">-v <em class="replaceable"><code>level</code></em></code>]
|
||||||
[<code class="option">-K <em class="replaceable"><code>directory</code></em></code>]
|
[<code class="option">-1</code>]
|
||||||
|
[<code class="option">-2</code>]
|
||||||
|
[<code class="option">-a <em class="replaceable"><code>alg</code></em></code>]
|
||||||
|
[<code class="option">-C</code>]
|
||||||
|
[<code class="option">-l <em class="replaceable"><code>domain</code></em></code>]
|
||||||
|
[<code class="option">-T <em class="replaceable"><code>TTL</code></em></code>]
|
||||||
{keyfile}
|
{keyfile}
|
||||||
</p></div>
|
</p></div>
|
||||||
<div class="cmdsynopsis"><p>
|
<div class="cmdsynopsis"><p>
|
||||||
<code class="command">dnssec-dsfromkey</code>
|
<code class="command">dnssec-dsfromkey</code>
|
||||||
[
|
|
||||||
<code class="option">-1</code>
|
|
||||||
| <code class="option">-2</code>
|
|
||||||
| <code class="option">-a <em class="replaceable"><code>alg</code></em></code>
|
|
||||||
]
|
|
||||||
[
|
|
||||||
<code class="option">-C</code>
|
|
||||||
| <code class="option">-l <em class="replaceable"><code>domain</code></em></code>
|
|
||||||
]
|
|
||||||
[<code class="option">-T <em class="replaceable"><code>TTL</code></em></code>]
|
|
||||||
[<code class="option">-v <em class="replaceable"><code>level</code></em></code>]
|
|
||||||
[<code class="option">-c <em class="replaceable"><code>class</code></em></code>]
|
|
||||||
[<code class="option">-A</code>]
|
|
||||||
{<code class="option">-f <em class="replaceable"><code>file</code></em></code>}
|
|
||||||
[dnsname]
|
|
||||||
</p></div>
|
|
||||||
<div class="cmdsynopsis"><p>
|
|
||||||
<code class="command">dnssec-dsfromkey</code>
|
|
||||||
[
|
|
||||||
<code class="option">-1</code>
|
|
||||||
| <code class="option">-2</code>
|
|
||||||
| <code class="option">-a <em class="replaceable"><code>alg</code></em></code>
|
|
||||||
]
|
|
||||||
[
|
|
||||||
<code class="option">-C</code>
|
|
||||||
| <code class="option">-l <em class="replaceable"><code>domain</code></em></code>
|
|
||||||
]
|
|
||||||
[<code class="option">-T <em class="replaceable"><code>TTL</code></em></code>]
|
|
||||||
[<code class="option">-v <em class="replaceable"><code>level</code></em></code>]
|
|
||||||
[<code class="option">-c <em class="replaceable"><code>class</code></em></code>]
|
|
||||||
[<code class="option">-K <em class="replaceable"><code>directory</code></em></code>]
|
|
||||||
{-s}
|
{-s}
|
||||||
|
[<code class="option">-1</code>]
|
||||||
|
[<code class="option">-2</code>]
|
||||||
|
[<code class="option">-a <em class="replaceable"><code>alg</code></em></code>]
|
||||||
|
[<code class="option">-K <em class="replaceable"><code>directory</code></em></code>]
|
||||||
|
[<code class="option">-l <em class="replaceable"><code>domain</code></em></code>]
|
||||||
|
[<code class="option">-s</code>]
|
||||||
|
[<code class="option">-c <em class="replaceable"><code>class</code></em></code>]
|
||||||
|
[<code class="option">-T <em class="replaceable"><code>TTL</code></em></code>]
|
||||||
|
[<code class="option">-f <em class="replaceable"><code>file</code></em></code>]
|
||||||
|
[<code class="option">-A</code>]
|
||||||
|
[<code class="option">-v <em class="replaceable"><code>level</code></em></code>]
|
||||||
{dnsname}
|
{dnsname}
|
||||||
</p></div>
|
</p></div>
|
||||||
<div class="cmdsynopsis"><p>
|
<div class="cmdsynopsis"><p>
|
||||||
<code class="command">dnssec-dsfromkey</code>
|
<code class="command">dnssec-dsfromkey</code>
|
||||||
[
|
[<code class="option">-h</code>]
|
||||||
<code class="option">-h</code>
|
[<code class="option">-V</code>]
|
||||||
| <code class="option">-V</code>
|
</p></div>
|
||||||
]
|
|
||||||
</p></div>
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="refsection">
|
<div class="refsection">
|
||||||
<a name="id-1.7"></a><h2>DESCRIPTION</h2>
|
<a name="id-1.7"></a><h2>DESCRIPTION</h2>
|
||||||
|
|
||||||
<p>
|
<p><span class="command"><strong>dnssec-dsfromkey</strong></span>
|
||||||
The <span class="command"><strong>dnssec-dsfromkey</strong></span> command outputs DS (Delegation
|
outputs the Delegation Signer (DS) resource record (RR), as defined in
|
||||||
Signer) resource records (RRs), or CDS (Child DS) RRs with the
|
RFC 3658 and RFC 4509, for the given key(s).
|
||||||
<code class="option">-C</code> option.
|
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
|
||||||
The input keys can be specified in a number of ways:
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
By default, <span class="command"><strong>dnssec-dsfromkey</strong></span> reads a key file
|
|
||||||
named like <code class="filename">Knnnn.+aaa+iiiii.key</code>, as generated
|
|
||||||
by <span class="command"><strong>dnssec-keygen</strong></span>.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
With the <code class="option">-f <em class="replaceable"><code>file</code></em></code>
|
|
||||||
option, <span class="command"><strong>dnssec-dsfromkey</strong></span> reads keys from a zone file
|
|
||||||
or partial zone file (which can contain just the DNSKEY records).
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
With the <code class="option">-s</code>
|
|
||||||
option, <span class="command"><strong>dnssec-dsfromkey</strong></span> reads
|
|
||||||
a <code class="filename">keyset-</code> file, as generated
|
|
||||||
by <span class="command"><strong>dnssec-keygen</strong></span> <code class="option">-C</code>.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="refsection">
|
<div class="refsection">
|
||||||
<a name="id-1.8"></a><h2>OPTIONS</h2>
|
<a name="id-1.8"></a><h2>OPTIONS</h2>
|
||||||
|
|
||||||
|
|
||||||
<div class="variablelist"><dl class="variablelist">
|
<div class="variablelist"><dl class="variablelist">
|
||||||
<dt><span class="term">-1</span></dt>
|
<dt><span class="term">-1</span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
An abbreviation for <code class="option">-a SHA-1</code>.
|
Use SHA-1 as the digest algorithm (the default is to use
|
||||||
(Note: The SHA-1 algorithm is no longer recommended for use
|
both SHA-1 and SHA-256).
|
||||||
when generating new DS and CDS records.)
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-2</span></dt>
|
<dt><span class="term">-2</span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
An abbreviation for <code class="option">-a SHA-256</code>.
|
Use SHA-256 as the digest algorithm.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt>
|
<dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Specify a digest algorithm to use when converting DNSKEY
|
Select the digest algorithm. The value of
|
||||||
records to DS records. This option can be repeated, so
|
<code class="option">algorithm</code> must be one of SHA-1 (SHA1),
|
||||||
that multiple DS records are created for each DNSKEY
|
SHA-256 (SHA256) or SHA-384 (SHA384).
|
||||||
record.
|
These values are case insensitive.
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
The <em class="replaceable"><code>algorithm</code></em> must be one of
|
|
||||||
SHA-1, SHA-256, or SHA-384. These values are case insensitive,
|
|
||||||
and the hyphen may be omitted. If no algorithm is specified,
|
|
||||||
the default is SHA-256.
|
|
||||||
(Note: The SHA-1 algorithm is no longer recommended for use
|
|
||||||
when generating new DS and CDS records.)
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-A</span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Include ZSKs when generating DS records. Without this option, only
|
|
||||||
keys which have the KSK flag set will be converted to DS records
|
|
||||||
and printed. Useful only in <code class="option">-f</code> zone file mode.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Specifies the DNS class (default is IN). Useful only
|
|
||||||
in <code class="option">-s</code> keyset or <code class="option">-f</code>
|
|
||||||
zone file mode.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-C</span></dt>
|
<dt><span class="term">-C</span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Generate CDS records rather than DS records.
|
Generate CDS records rather than DS records. This is mutually
|
||||||
|
exclusive with generating lookaside records.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
|
<dt><span class="term">-T <em class="replaceable"><code>TTL</code></em></span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Specifies the TTL of the DS records.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
|
<dt><span class="term">-K <em class="replaceable"><code>directory</code></em></span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Look for key files (or, in keyset mode,
|
||||||
|
<code class="filename">keyset-</code> files) in
|
||||||
|
<code class="option">directory</code>.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-f <em class="replaceable"><code>file</code></em></span></dt>
|
<dt><span class="term">-f <em class="replaceable"><code>file</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Zone file mode: <span class="command"><strong>dnssec-dsfromkey</strong></span>'s
|
Zone file mode: in place of the keyfile name, the argument is
|
||||||
final <em class="replaceable"><code>dnsname</code></em> argument is
|
the DNS domain name of a zone master file, which can be read
|
||||||
the DNS domain name of a zone whose master file can be read
|
|
||||||
from <code class="option">file</code>. If the zone name is the same as
|
from <code class="option">file</code>. If the zone name is the same as
|
||||||
<code class="option">file</code>, then it may be omitted.
|
<code class="option">file</code>, then it may be omitted.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
If <em class="replaceable"><code>file</code></em> is <code class="literal">"-"</code>, then
|
If <code class="option">file</code> is set to <code class="literal">"-"</code>, then
|
||||||
the zone data is read from the standard input. This makes it
|
the zone data is read from the standard input. This makes it
|
||||||
possible to use the output of the <span class="command"><strong>dig</strong></span>
|
possible to use the output of the <span class="command"><strong>dig</strong></span>
|
||||||
command as input, as in:
|
command as input, as in:
|
||||||
@@ -202,31 +140,37 @@
|
|||||||
<strong class="userinput"><code>dig dnskey example.com | dnssec-dsfromkey -f - example.com</code></strong>
|
<strong class="userinput"><code>dig dnskey example.com | dnssec-dsfromkey -f - example.com</code></strong>
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-h</span></dt>
|
<dt><span class="term">-A</span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Include ZSKs when generating DS records. Without this option,
|
||||||
|
only keys which have the KSK flag set will be converted to DS
|
||||||
|
records and printed. Useful only in zone file mode.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
|
<dt><span class="term">-l <em class="replaceable"><code>domain</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Prints usage information.
|
Generate a DLV set instead of a DS set. The specified
|
||||||
</p>
|
<code class="option">domain</code> is appended to the name for each
|
||||||
</dd>
|
record in the set.
|
||||||
<dt><span class="term">-K <em class="replaceable"><code>directory</code></em></span></dt>
|
The DNSSEC Lookaside Validation (DLV) RR is described
|
||||||
<dd>
|
in RFC 4431. This is mutually exclusive with generating
|
||||||
<p>
|
CDS records.
|
||||||
Look for key files or <code class="filename">keyset-</code> files in
|
|
||||||
<code class="option">directory</code>.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-s</span></dt>
|
<dt><span class="term">-s</span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Keyset mode: <span class="command"><strong>dnssec-dsfromkey</strong></span>'s
|
Keyset mode: in place of the keyfile name, the argument is
|
||||||
final <em class="replaceable"><code>dnsname</code></em> argument is the DNS
|
the DNS domain name of a keyset file.
|
||||||
domain name used to locate a <code class="filename">keyset-</code> file.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-T <em class="replaceable"><code>TTL</code></em></span></dt>
|
<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Specifies the TTL of the DS records. By default the TTL is omitted.
|
Specifies the DNS class (default is IN). Useful only
|
||||||
|
in keyset or zone file mode.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-v <em class="replaceable"><code>level</code></em></span></dt>
|
<dt><span class="term">-v <em class="replaceable"><code>level</code></em></span></dt>
|
||||||
@@ -235,6 +179,12 @@
|
|||||||
Sets the debugging level.
|
Sets the debugging level.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
|
<dt><span class="term">-h</span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Prints usage information.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
<dt><span class="term">-V</span></dt>
|
<dt><span class="term">-V</span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
@@ -250,23 +200,22 @@
|
|||||||
<p>
|
<p>
|
||||||
To build the SHA-256 DS RR from the
|
To build the SHA-256 DS RR from the
|
||||||
<strong class="userinput"><code>Kexample.com.+003+26160</code></strong>
|
<strong class="userinput"><code>Kexample.com.+003+26160</code></strong>
|
||||||
keyfile name, you can issue the following command:
|
keyfile name, the following command would be issued:
|
||||||
</p>
|
</p>
|
||||||
<p><strong class="userinput"><code>dnssec-dsfromkey -2 Kexample.com.+003+26160</code></strong>
|
<p><strong class="userinput"><code>dnssec-dsfromkey -2 Kexample.com.+003+26160</code></strong>
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
The command would print something like:
|
The command would print something like:
|
||||||
</p>
|
</p>
|
||||||
<p><strong class="userinput"><code>example.com. IN DS 26160 5 2 3A1EADA7A74B8D0BA86726B0C227AA85AB8BBD2B2004F41A868A54F0C5EA0B94</code></strong>
|
<p><strong class="userinput"><code>example.com. IN DS 26160 5 2 3A1EADA7A74B8D0BA86726B0C227AA85AB8BBD2B2004F41A868A54F0 C5EA0B94</code></strong>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="refsection">
|
<div class="refsection">
|
||||||
<a name="id-1.10"></a><h2>FILES</h2>
|
<a name="id-1.10"></a><h2>FILES</h2>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
The keyfile can be designated by the key identification
|
The keyfile can be designed by the key identification
|
||||||
<code class="filename">Knnnn.+aaa+iiiii</code> or the full file name
|
<code class="filename">Knnnn.+aaa+iiiii</code> or the full file name
|
||||||
<code class="filename">Knnnn.+aaa+iiiii.key</code> as generated by
|
<code class="filename">Knnnn.+aaa+iiiii.key</code> as generated by
|
||||||
<span class="refentrytitle">dnssec-keygen</span>(8).
|
<span class="refentrytitle">dnssec-keygen</span>(8).
|
||||||
@@ -296,10 +245,9 @@
|
|||||||
<span class="refentrytitle">dnssec-signzone</span>(8)
|
<span class="refentrytitle">dnssec-signzone</span>(8)
|
||||||
</span>,
|
</span>,
|
||||||
<em class="citetitle">BIND 9 Administrator Reference Manual</em>,
|
<em class="citetitle">BIND 9 Administrator Reference Manual</em>,
|
||||||
<em class="citetitle">RFC 3658</em> (DS RRs),
|
<em class="citetitle">RFC 3658</em>,
|
||||||
<em class="citetitle">RFC 4509</em> (SHA-256 for DS RRs),
|
<em class="citetitle">RFC 4431</em>.
|
||||||
<em class="citetitle">RFC 6605</em> (SHA-384 for DS RRs),
|
<em class="citetitle">RFC 4509</em>.
|
||||||
<em class="citetitle">RFC 7344</em> (CDS and CDNSKEY RRs).
|
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2013-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2013-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -134,5 +134,5 @@ RFC 5011\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2013-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2013-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
@@ -11,6 +11,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
|
|
||||||
@@ -46,7 +48,12 @@
|
|||||||
|
|
||||||
#include "dnssectool.h"
|
#include "dnssectool.h"
|
||||||
|
|
||||||
|
#ifndef PATH_MAX
|
||||||
|
#define PATH_MAX 1024 /* WIN32, and others don't define this. */
|
||||||
|
#endif
|
||||||
|
|
||||||
const char *program = "dnssec-importkey";
|
const char *program = "dnssec-importkey";
|
||||||
|
int verbose;
|
||||||
|
|
||||||
static dns_rdataclass_t rdclass;
|
static dns_rdataclass_t rdclass;
|
||||||
static dns_fixedname_t fixed;
|
static dns_fixedname_t fixed;
|
||||||
@@ -174,7 +181,9 @@ loadkey(char *filename, unsigned char *key_buf, unsigned int key_buf_size,
|
|||||||
rdclass = dst_key_class(key);
|
rdclass = dst_key_class(key);
|
||||||
|
|
||||||
name = dns_fixedname_initname(&fixed);
|
name = dns_fixedname_initname(&fixed);
|
||||||
dns_name_copynf(dst_key_name(key), name);
|
result = dns_name_copy(dst_key_name(key), name, NULL);
|
||||||
|
if (result != ISC_R_SUCCESS)
|
||||||
|
fatal("can't copy name");
|
||||||
|
|
||||||
dst_key_free(&key);
|
dst_key_free(&key);
|
||||||
}
|
}
|
||||||
@@ -298,7 +307,9 @@ main(int argc, char **argv) {
|
|||||||
if (argc == 1)
|
if (argc == 1)
|
||||||
usage();
|
usage();
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
result = isc_mem_create(0, 0, &mctx);
|
||||||
|
if (result != ISC_R_SUCCESS)
|
||||||
|
fatal("out of memory");
|
||||||
|
|
||||||
#if USE_PKCS11
|
#if USE_PKCS11
|
||||||
pk11_result_register();
|
pk11_result_register();
|
||||||
@@ -439,6 +450,7 @@ main(int argc, char **argv) {
|
|||||||
dns_rdataset_disassociate(&rdataset);
|
dns_rdataset_disassociate(&rdataset);
|
||||||
cleanup_logging(&log);
|
cleanup_logging(&log);
|
||||||
dst_lib_destroy();
|
dst_lib_destroy();
|
||||||
|
dns_name_destroy();
|
||||||
if (verbose > 10)
|
if (verbose > 10)
|
||||||
isc_mem_stats(mctx, stdout);
|
isc_mem_stats(mctx, stdout);
|
||||||
isc_mem_destroy(&mctx);
|
isc_mem_destroy(&mctx);
|
||||||
|
|||||||
@@ -38,8 +38,6 @@
|
|||||||
<year>2015</year>
|
<year>2015</year>
|
||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2013-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2013-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2008-2012, 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2008-2012, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -55,7 +55,7 @@ of the key is specified on the command line\&. This must match the name of the z
|
|||||||
.RS 4
|
.RS 4
|
||||||
Selects the cryptographic algorithm\&. The value of
|
Selects the cryptographic algorithm\&. The value of
|
||||||
\fBalgorithm\fR
|
\fBalgorithm\fR
|
||||||
must be one of RSASHA1, NSEC3RSASHA1, RSASHA256, RSASHA512, ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448\&.
|
must be one of RSAMD5, RSASHA1, DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512, ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448\&.
|
||||||
.sp
|
.sp
|
||||||
If no algorithm is specified, then RSASHA1 will be used by default, unless the
|
If no algorithm is specified, then RSASHA1 will be used by default, unless the
|
||||||
\fB\-3\fR
|
\fB\-3\fR
|
||||||
@@ -63,9 +63,9 @@ option is specified, in which case NSEC3RSASHA1 will be used instead\&. (If
|
|||||||
\fB\-3\fR
|
\fB\-3\fR
|
||||||
is used and an algorithm is specified, that algorithm will be checked for compatibility with NSEC3\&.)
|
is used and an algorithm is specified, that algorithm will be checked for compatibility with NSEC3\&.)
|
||||||
.sp
|
.sp
|
||||||
These values are case insensitive\&. In some cases, abbreviations are supported, such as ECDSA256 for ECDSAP256SHA256 and ECDSA384 for ECDSAP384SHA384\&. If RSASHA1 is specified along with the
|
These values are case insensitive\&. In some cases, abbreviations are supported, such as ECDSA256 for ECDSAP256SHA256 and ECDSA384 for ECDSAP384SHA384\&. If RSASHA1 or DSA is specified along with the
|
||||||
\fB\-3\fR
|
\fB\-3\fR
|
||||||
option, then NSEC3RSASHA1 will be used instead\&.
|
option, then NSEC3RSASHA1 or NSEC3DSA will be used instead\&.
|
||||||
.sp
|
.sp
|
||||||
As of BIND 9\&.12\&.0, this option is mandatory except when using the
|
As of BIND 9\&.12\&.0, this option is mandatory except when using the
|
||||||
\fB\-S\fR
|
\fB\-S\fR
|
||||||
@@ -307,5 +307,5 @@ The PKCS#11 URI Scheme (draft\-pechanec\-pkcs11uri\-13)\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2008-2012, 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2008-2012, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
@@ -11,6 +11,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <ctype.h>
|
#include <ctype.h>
|
||||||
#include <inttypes.h>
|
#include <inttypes.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
@@ -46,6 +48,7 @@
|
|||||||
#define MAX_RSA 4096 /* should be long enough... */
|
#define MAX_RSA 4096 /* should be long enough... */
|
||||||
|
|
||||||
const char *program = "dnssec-keyfromlabel";
|
const char *program = "dnssec-keyfromlabel";
|
||||||
|
int verbose;
|
||||||
|
|
||||||
ISC_PLATFORM_NORETURN_PRE static void
|
ISC_PLATFORM_NORETURN_PRE static void
|
||||||
usage(void) ISC_PLATFORM_NORETURN_POST;
|
usage(void) ISC_PLATFORM_NORETURN_POST;
|
||||||
@@ -61,8 +64,8 @@ usage(void) {
|
|||||||
fprintf(stderr, " name: owner of the key\n");
|
fprintf(stderr, " name: owner of the key\n");
|
||||||
fprintf(stderr, "Other options:\n");
|
fprintf(stderr, "Other options:\n");
|
||||||
fprintf(stderr, " -a algorithm: \n"
|
fprintf(stderr, " -a algorithm: \n"
|
||||||
" DH | RSASHA1 |\n"
|
" RSA | RSAMD5 | DH | DSA | RSASHA1 |\n"
|
||||||
" NSEC3RSASHA1 |\n"
|
" NSEC3DSA | NSEC3RSASHA1 |\n"
|
||||||
" RSASHA256 | RSASHA512 |\n"
|
" RSASHA256 | RSASHA512 |\n"
|
||||||
" ECDSAP256SHA256 | ECDSAP384SHA384\n");
|
" ECDSAP256SHA256 | ECDSAP384SHA384\n");
|
||||||
fprintf(stderr, " -3: use NSEC3-capable algorithm\n");
|
fprintf(stderr, " -3: use NSEC3-capable algorithm\n");
|
||||||
@@ -163,7 +166,7 @@ main(int argc, char **argv) {
|
|||||||
if (argc == 1)
|
if (argc == 1)
|
||||||
usage();
|
usage();
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
RUNTIME_CHECK(isc_mem_create(0, 0, &mctx) == ISC_R_SUCCESS);
|
||||||
|
|
||||||
#if USE_PKCS11
|
#if USE_PKCS11
|
||||||
pk11_result_register();
|
pk11_result_register();
|
||||||
@@ -368,6 +371,8 @@ main(int argc, char **argv) {
|
|||||||
|
|
||||||
len = strlen(label) + 8;
|
len = strlen(label) + 8;
|
||||||
l = isc_mem_allocate(mctx, len);
|
l = isc_mem_allocate(mctx, len);
|
||||||
|
if (l == NULL)
|
||||||
|
fatal("cannot allocate memory");
|
||||||
snprintf(l, len, "pkcs11:%s", label);
|
snprintf(l, len, "pkcs11:%s", label);
|
||||||
isc_mem_free(mctx, label);
|
isc_mem_free(mctx, label);
|
||||||
label = l;
|
label = l;
|
||||||
@@ -377,21 +382,33 @@ main(int argc, char **argv) {
|
|||||||
fatal("no algorithm specified");
|
fatal("no algorithm specified");
|
||||||
}
|
}
|
||||||
|
|
||||||
r.base = algname;
|
if (strcasecmp(algname, "RSA") == 0) {
|
||||||
r.length = strlen(algname);
|
fprintf(stderr, "The use of RSA (RSAMD5) is not "
|
||||||
ret = dns_secalg_fromtext(&alg, &r);
|
"recommended.\nIf you still wish to "
|
||||||
if (ret != ISC_R_SUCCESS) {
|
"use RSA (RSAMD5) please specify "
|
||||||
fatal("unknown algorithm %s", algname);
|
"\"-a RSAMD5\"\n");
|
||||||
}
|
if (freeit != NULL)
|
||||||
if (alg == DST_ALG_DH) {
|
free(freeit);
|
||||||
options |= DST_TYPE_KEY;
|
return (1);
|
||||||
|
} else {
|
||||||
|
r.base = algname;
|
||||||
|
r.length = strlen(algname);
|
||||||
|
ret = dns_secalg_fromtext(&alg, &r);
|
||||||
|
if (ret != ISC_R_SUCCESS)
|
||||||
|
fatal("unknown algorithm %s", algname);
|
||||||
|
if (alg == DST_ALG_DH)
|
||||||
|
options |= DST_TYPE_KEY;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (use_nsec3) {
|
if (use_nsec3) {
|
||||||
switch (alg) {
|
switch (alg) {
|
||||||
|
case DST_ALG_DSA:
|
||||||
|
alg = DST_ALG_NSEC3DSA;
|
||||||
|
break;
|
||||||
case DST_ALG_RSASHA1:
|
case DST_ALG_RSASHA1:
|
||||||
alg = DST_ALG_NSEC3RSASHA1;
|
alg = DST_ALG_NSEC3RSASHA1;
|
||||||
break;
|
break;
|
||||||
|
case DST_ALG_NSEC3DSA:
|
||||||
case DST_ALG_NSEC3RSASHA1:
|
case DST_ALG_NSEC3RSASHA1:
|
||||||
case DST_ALG_RSASHA256:
|
case DST_ALG_RSASHA256:
|
||||||
case DST_ALG_RSASHA512:
|
case DST_ALG_RSASHA512:
|
||||||
@@ -626,10 +643,10 @@ main(int argc, char **argv) {
|
|||||||
|
|
||||||
if (setdel)
|
if (setdel)
|
||||||
dst_key_settime(key, DST_TIME_DELETE, deltime);
|
dst_key_settime(key, DST_TIME_DELETE, deltime);
|
||||||
if (setsyncadd)
|
if (setsyncadd)
|
||||||
dst_key_settime(key, DST_TIME_SYNCPUBLISH, syncadd);
|
dst_key_settime(key, DST_TIME_SYNCPUBLISH, syncadd);
|
||||||
if (setsyncdel)
|
if (setsyncdel)
|
||||||
dst_key_settime(key, DST_TIME_SYNCDELETE, syncdel);
|
dst_key_settime(key, DST_TIME_SYNCDELETE, syncdel);
|
||||||
|
|
||||||
} else {
|
} else {
|
||||||
if (setpub || setact || setrev || setinact ||
|
if (setpub || setact || setrev || setinact ||
|
||||||
@@ -694,6 +711,7 @@ main(int argc, char **argv) {
|
|||||||
|
|
||||||
cleanup_logging(&log);
|
cleanup_logging(&log);
|
||||||
dst_lib_destroy();
|
dst_lib_destroy();
|
||||||
|
dns_name_destroy();
|
||||||
if (verbose > 10)
|
if (verbose > 10)
|
||||||
isc_mem_stats(mctx, stdout);
|
isc_mem_stats(mctx, stdout);
|
||||||
isc_mem_free(mctx, label);
|
isc_mem_free(mctx, label);
|
||||||
|
|||||||
@@ -43,8 +43,6 @@
|
|||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2017</year>
|
<year>2017</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
@@ -107,8 +105,8 @@
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Selects the cryptographic algorithm. The value of
|
Selects the cryptographic algorithm. The value of
|
||||||
<option>algorithm</option> must be one of RSASHA1,
|
<option>algorithm</option> must be one of RSAMD5, RSASHA1,
|
||||||
NSEC3RSASHA1, RSASHA256, RSASHA512,
|
DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512,
|
||||||
ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448.
|
ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
@@ -121,9 +119,9 @@
|
|||||||
<para>
|
<para>
|
||||||
These values are case insensitive. In some cases, abbreviations
|
These values are case insensitive. In some cases, abbreviations
|
||||||
are supported, such as ECDSA256 for ECDSAP256SHA256 and
|
are supported, such as ECDSA256 for ECDSAP256SHA256 and
|
||||||
ECDSA384 for ECDSAP384SHA384. If RSASHA1 is specified
|
ECDSA384 for ECDSAP384SHA384. If RSASHA1 or DSA is specified
|
||||||
along with the <option>-3</option> option, then NSEC3RSASHA1
|
along with the <option>-3</option> option, then NSEC3RSASHA1
|
||||||
will be used instead.
|
or NSEC3DSA will be used instead.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
As of BIND 9.12.0, this option is mandatory except when using
|
As of BIND 9.12.0, this option is mandatory except when using
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2008-2012, 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2008-2012, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -89,8 +89,8 @@
|
|||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Selects the cryptographic algorithm. The value of
|
Selects the cryptographic algorithm. The value of
|
||||||
<code class="option">algorithm</code> must be one of RSASHA1,
|
<code class="option">algorithm</code> must be one of RSAMD5, RSASHA1,
|
||||||
NSEC3RSASHA1, RSASHA256, RSASHA512,
|
DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512,
|
||||||
ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448.
|
ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
@@ -103,9 +103,9 @@
|
|||||||
<p>
|
<p>
|
||||||
These values are case insensitive. In some cases, abbreviations
|
These values are case insensitive. In some cases, abbreviations
|
||||||
are supported, such as ECDSA256 for ECDSAP256SHA256 and
|
are supported, such as ECDSA256 for ECDSAP256SHA256 and
|
||||||
ECDSA384 for ECDSAP384SHA384. If RSASHA1 is specified
|
ECDSA384 for ECDSAP384SHA384. If RSASHA1 or DSA is specified
|
||||||
along with the <code class="option">-3</code> option, then NSEC3RSASHA1
|
along with the <code class="option">-3</code> option, then NSEC3RSASHA1
|
||||||
will be used instead.
|
or NSEC3DSA will be used instead.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
As of BIND 9.12.0, this option is mandatory except when using
|
As of BIND 9.12.0, this option is mandatory except when using
|
||||||
|
|||||||
+49
-69
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2000-2005, 2007-2012, 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2000-2005, 2007-2012, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -39,7 +39,7 @@
|
|||||||
dnssec-keygen \- DNSSEC key generation tool
|
dnssec-keygen \- DNSSEC key generation tool
|
||||||
.SH "SYNOPSIS"
|
.SH "SYNOPSIS"
|
||||||
.HP \w'\fBdnssec\-keygen\fR\ 'u
|
.HP \w'\fBdnssec\-keygen\fR\ 'u
|
||||||
\fBdnssec\-keygen\fR [\fB\-3\fR] [\fB\-A\ \fR\fB\fIdate/offset\fR\fR] [\fB\-a\ \fR\fB\fIalgorithm\fR\fR] [\fB\-b\ \fR\fB\fIkeysize\fR\fR] [\fB\-C\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-D\ \fR\fB\fIdate/offset\fR\fR] [\fB\-D\ sync\ \fR\fB\fIdate/offset\fR\fR] [\fB\-d\ \fR\fB\fIbits\fR\fR] [\fB\-E\ \fR\fB\fIengine\fR\fR] [\fB\-f\ \fR\fB\fIflag\fR\fR] [\fB\-G\fR] [\fB\-g\ \fR\fB\fIgenerator\fR\fR] [\fB\-h\fR] [\fB\-I\ \fR\fB\fIdate/offset\fR\fR] [\fB\-i\ \fR\fB\fIinterval\fR\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-k\ \fR\fB\fIpolicy\fR\fR] [\fB\-L\ \fR\fB\fIttl\fR\fR] [\fB\-l\ \fR\fB\fIfile\fR\fR] [\fB\-n\ \fR\fB\fInametype\fR\fR] [\fB\-P\ \fR\fB\fIdate/offset\fR\fR] [\fB\-P\ sync\ \fR\fB\fIdate/offset\fR\fR] [\fB\-p\ \fR\fB\fIprotocol\fR\fR] [\fB\-q\fR] [\fB\-R\ \fR\fB\fIdate/offset\fR\fR] [\fB\-S\ \fR\fB\fIkey\fR\fR] [\fB\-s\ \fR\fB\fIstrength\fR\fR] [\fB\-T\ \fR\fB\fIrrtype\fR\fR] [\fB\-t\ \fR\fB\fItype\fR\fR] [\fB\-V\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] {name}
|
\fBdnssec\-keygen\fR [\fB\-a\ \fR\fB\fIalgorithm\fR\fR] [\fB\-b\ \fR\fB\fIkeysize\fR\fR] [\fB\-n\ \fR\fB\fInametype\fR\fR] [\fB\-3\fR] [\fB\-A\ \fR\fB\fIdate/offset\fR\fR] [\fB\-C\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-D\ \fR\fB\fIdate/offset\fR\fR] [\fB\-D\ sync\ \fR\fB\fIdate/offset\fR\fR] [\fB\-E\ \fR\fB\fIengine\fR\fR] [\fB\-f\ \fR\fB\fIflag\fR\fR] [\fB\-G\fR] [\fB\-g\ \fR\fB\fIgenerator\fR\fR] [\fB\-h\fR] [\fB\-I\ \fR\fB\fIdate/offset\fR\fR] [\fB\-i\ \fR\fB\fIinterval\fR\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-k\fR] [\fB\-L\ \fR\fB\fIttl\fR\fR] [\fB\-P\ \fR\fB\fIdate/offset\fR\fR] [\fB\-P\ sync\ \fR\fB\fIdate/offset\fR\fR] [\fB\-p\ \fR\fB\fIprotocol\fR\fR] [\fB\-q\fR] [\fB\-R\ \fR\fB\fIdate/offset\fR\fR] [\fB\-S\ \fR\fB\fIkey\fR\fR] [\fB\-s\ \fR\fB\fIstrength\fR\fR] [\fB\-t\ \fR\fB\fItype\fR\fR] [\fB\-V\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-z\fR] {name}
|
||||||
.SH "DESCRIPTION"
|
.SH "DESCRIPTION"
|
||||||
.PP
|
.PP
|
||||||
\fBdnssec\-keygen\fR
|
\fBdnssec\-keygen\fR
|
||||||
@@ -58,24 +58,17 @@ may be preferable to direct use of
|
|||||||
\fBdnssec\-keygen\fR\&.
|
\fBdnssec\-keygen\fR\&.
|
||||||
.SH "OPTIONS"
|
.SH "OPTIONS"
|
||||||
.PP
|
.PP
|
||||||
\-3
|
|
||||||
.RS 4
|
|
||||||
Use an NSEC3\-capable algorithm to generate a DNSSEC key\&. If this option is used with an algorithm that has both NSEC and NSEC3 versions, then the NSEC3 version will be used; for example,
|
|
||||||
\fBdnssec\-keygen \-3a RSASHA1\fR
|
|
||||||
specifies the NSEC3RSASHA1 algorithm\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-a \fIalgorithm\fR
|
\-a \fIalgorithm\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Selects the cryptographic algorithm\&. For DNSSEC keys, the value of
|
Selects the cryptographic algorithm\&. For DNSSEC keys, the value of
|
||||||
\fBalgorithm\fR
|
\fBalgorithm\fR
|
||||||
must be one of RSASHA1, NSEC3RSASHA1, RSASHA256, RSASHA512, ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448\&. For TKEY, the value must be DH (Diffie Hellman); specifying his value will automatically set the
|
must be one of RSAMD5, RSASHA1, DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512, ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448\&. For TKEY, the value must be DH (Diffie Hellman); specifying his value will automatically set the
|
||||||
\fB\-T KEY\fR
|
\fB\-T KEY\fR
|
||||||
option as well\&.
|
option as well\&.
|
||||||
.sp
|
.sp
|
||||||
These values are case insensitive\&. In some cases, abbreviations are supported, such as ECDSA256 for ECDSAP256SHA256 and ECDSA384 for ECDSAP384SHA384\&. If RSASHA1 is specified along with the
|
These values are case insensitive\&. In some cases, abbreviations are supported, such as ECDSA256 for ECDSAP256SHA256 and ECDSA384 for ECDSAP384SHA384\&. If RSASHA1 or DSA is specified along with the
|
||||||
\fB\-3\fR
|
\fB\-3\fR
|
||||||
option, then NSEC3RSASHA1 will be used instead\&.
|
option, then NSEC3RSASHA1 or NSEC3DSA will be used instead\&.
|
||||||
.sp
|
.sp
|
||||||
This parameter
|
This parameter
|
||||||
\fImust\fR
|
\fImust\fR
|
||||||
@@ -90,14 +83,29 @@ to generate TSIG keys\&.
|
|||||||
.PP
|
.PP
|
||||||
\-b \fIkeysize\fR
|
\-b \fIkeysize\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Specifies the number of bits in the key\&. The choice of key size depends on the algorithm used\&. RSA keys must be between 1024 and 4096 bits\&. Diffie Hellman keys must be between 128 and 4096 bits\&. Elliptic curve algorithms don\*(Aqt need this parameter\&.
|
Specifies the number of bits in the key\&. The choice of key size depends on the algorithm used\&. RSA keys must be between 1024 and 2048 bits\&. Diffie Hellman keys must be between 128 and 4096 bits\&. DSA keys must be between 512 and 1024 bits and an exact multiple of 64\&. HMAC keys must be between 1 and 512 bits\&. Elliptic curve algorithms don\*(Aqt need this parameter\&.
|
||||||
.sp
|
.sp
|
||||||
If the key size is not specified, some algorithms have pre\-defined defaults\&. For instance, RSA keys have a default size of 2048 bits\&.
|
If the key size is not specified, some algorithms have pre\-defined defaults\&. For example, RSA keys for use as DNSSEC zone signing keys have a default size of 1024 bits; RSA keys for use as key signing keys (KSKs, generated with
|
||||||
|
\fB\-f KSK\fR) default to 2048 bits\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
\-n \fInametype\fR
|
||||||
|
.RS 4
|
||||||
|
Specifies the owner type of the key\&. The value of
|
||||||
|
\fBnametype\fR
|
||||||
|
must either be ZONE (for a DNSSEC zone key (KEY/DNSKEY)), HOST or ENTITY (for a key associated with a host (KEY)), USER (for a key associated with a user(KEY)) or OTHER (DNSKEY)\&. These values are case insensitive\&. Defaults to ZONE for DNSKEY generation\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
\-3
|
||||||
|
.RS 4
|
||||||
|
Use an NSEC3\-capable algorithm to generate a DNSSEC key\&. If this option is used with an algorithm that has both NSEC and NSEC3 versions, then the NSEC3 version will be used; for example,
|
||||||
|
\fBdnssec\-keygen \-3a RSASHA1\fR
|
||||||
|
specifies the NSEC3RSASHA1 algorithm\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-C
|
\-C
|
||||||
.RS 4
|
.RS 4
|
||||||
Compatibility mode: generates an old\-style key, without any timing metadata\&. By default,
|
Compatibility mode: generates an old\-style key, without any metadata\&. By default,
|
||||||
\fBdnssec\-keygen\fR
|
\fBdnssec\-keygen\fR
|
||||||
will include the key\*(Aqs creation date in the metadata stored with the private key, and other dates may be set there as well (publication date, activation date, etc)\&. Keys that include this data may be incompatible with older versions of BIND; the
|
will include the key\*(Aqs creation date in the metadata stored with the private key, and other dates may be set there as well (publication date, activation date, etc)\&. Keys that include this data may be incompatible with older versions of BIND; the
|
||||||
\fB\-C\fR
|
\fB\-C\fR
|
||||||
@@ -109,11 +117,6 @@ option suppresses them\&.
|
|||||||
Indicates that the DNS record containing the key should have the specified class\&. If not specified, class IN is used\&.
|
Indicates that the DNS record containing the key should have the specified class\&. If not specified, class IN is used\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-d \fIbits\fR
|
|
||||||
.RS 4
|
|
||||||
Key size in bits\&. For the algorithms RSASHA1, NSEC3RSASA1, RSASHA256 and RSASHA512 the key size must be in range 1024\-4096\&. DH size is between 128 and 4096\&. This option is ignored for algorithms ECDSAP256SHA256, ECDSAP384SHA384, ED25519 and ED448\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-E \fIengine\fR
|
\-E \fIengine\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Specifies the cryptographic hardware to use, when applicable\&.
|
Specifies the cryptographic hardware to use, when applicable\&.
|
||||||
@@ -147,15 +150,9 @@ Prints a short summary of the options and arguments to
|
|||||||
Sets the directory in which the key files are to be written\&.
|
Sets the directory in which the key files are to be written\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-k \fIpolicy\fR
|
\-k
|
||||||
.RS 4
|
.RS 4
|
||||||
Create keys for a specific dnssec\-policy\&. If a policy uses multiple keys,
|
Deprecated in favor of \-T KEY\&.
|
||||||
\fBdnssec\-keygen\fR
|
|
||||||
will generate multiple keys\&. This will also create a "\&.state" file to keep track of the key state\&.
|
|
||||||
.sp
|
|
||||||
This option creates keys according to the dnssec\-policy configuration, hence it cannot be used together with many of the other options that
|
|
||||||
\fBdnssec\-keygen\fR
|
|
||||||
provides\&.
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-L \fIttl\fR
|
\-L \fIttl\fR
|
||||||
@@ -167,23 +164,9 @@ none
|
|||||||
is the same as leaving it unset\&.
|
is the same as leaving it unset\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-l \fIfile\fR
|
|
||||||
.RS 4
|
|
||||||
Provide a configuration file that contains a dnssec\-policy statement (matching the policy set with
|
|
||||||
\fB\-k\fR)\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-n \fInametype\fR
|
|
||||||
.RS 4
|
|
||||||
Specifies the owner type of the key\&. The value of
|
|
||||||
\fBnametype\fR
|
|
||||||
must either be ZONE (for a DNSSEC zone key (KEY/DNSKEY)), HOST or ENTITY (for a key associated with a host (KEY)), USER (for a key associated with a user(KEY)) or OTHER (DNSKEY)\&. These values are case insensitive\&. Defaults to ZONE for DNSKEY generation\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-p \fIprotocol\fR
|
\-p \fIprotocol\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Sets the protocol value for the generated key, for use with
|
Sets the protocol value for the generated key\&. The protocol is a number between 0 and 255\&. The default is 3 (DNSSEC)\&. Other possible values for this argument are listed in RFC 2535 and its successors\&.
|
||||||
\fB\-T KEY\fR\&. The protocol is a number between 0 and 255\&. The default is 3 (DNSSEC)\&. Other possible values for this argument are listed in RFC 2535 and its successors\&.
|
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-q
|
\-q
|
||||||
@@ -210,25 +193,27 @@ Specifies the strength value of the key\&. The strength is a number between 0 an
|
|||||||
Specifies the resource record type to use for the key\&.
|
Specifies the resource record type to use for the key\&.
|
||||||
\fBrrtype\fR
|
\fBrrtype\fR
|
||||||
must be either DNSKEY or KEY\&. The default is DNSKEY when using a DNSSEC algorithm, but it can be overridden to KEY for use with SIG(0)\&.
|
must be either DNSKEY or KEY\&. The default is DNSKEY when using a DNSSEC algorithm, but it can be overridden to KEY for use with SIG(0)\&.
|
||||||
|
Specifying any TSIG algorithm (HMAC\-* or DH) with
|
||||||
|
\fB\-a\fR
|
||||||
|
forces this option to KEY\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-t \fItype\fR
|
\-t \fItype\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Indicates the use of the key, for use with
|
Indicates the use of the key\&.
|
||||||
\fB\-T KEY\fR\&.
|
|
||||||
\fBtype\fR
|
\fBtype\fR
|
||||||
must be one of AUTHCONF, NOAUTHCONF, NOAUTH, or NOCONF\&. The default is AUTHCONF\&. AUTH refers to the ability to authenticate data, and CONF the ability to encrypt data\&.
|
must be one of AUTHCONF, NOAUTHCONF, NOAUTH, or NOCONF\&. The default is AUTHCONF\&. AUTH refers to the ability to authenticate data, and CONF the ability to encrypt data\&.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\-V
|
|
||||||
.RS 4
|
|
||||||
Prints version information\&.
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\-v \fIlevel\fR
|
\-v \fIlevel\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
Sets the debugging level\&.
|
Sets the debugging level\&.
|
||||||
.RE
|
.RE
|
||||||
|
.PP
|
||||||
|
\-V
|
||||||
|
.RS 4
|
||||||
|
Prints version information\&.
|
||||||
|
.RE
|
||||||
.SH "TIMING OPTIONS"
|
.SH "TIMING OPTIONS"
|
||||||
.PP
|
.PP
|
||||||
Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS\&. If the argument begins with a \*(Aq+\*(Aq or \*(Aq\-\*(Aq, it is interpreted as an offset from the present time\&. For convenience, if such an offset is followed by one of the suffixes \*(Aqy\*(Aq, \*(Aqmo\*(Aq, \*(Aqw\*(Aq, \*(Aqd\*(Aq, \*(Aqh\*(Aq, or \*(Aqmi\*(Aq, then the offset is computed in years (defined as 365 24\-hour days, ignoring leap years), months (defined as 30 24\-hour days), weeks, days, hours, or minutes, respectively\&. Without a suffix, the offset is computed in seconds\&. To explicitly prevent a date from being set, use \*(Aqnone\*(Aq or \*(Aqnever\*(Aq\&.
|
Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS\&. If the argument begins with a \*(Aq+\*(Aq or \*(Aq\-\*(Aq, it is interpreted as an offset from the present time\&. For convenience, if such an offset is followed by one of the suffixes \*(Aqy\*(Aq, \*(Aqmo\*(Aq, \*(Aqw\*(Aq, \*(Aqd\*(Aq, \*(Aqh\*(Aq, or \*(Aqmi\*(Aq, then the offset is computed in years (defined as 365 24\-hour days, ignoring leap years), months (defined as 30 24\-hour days), weeks, days, hours, or minutes, respectively\&. Without a suffix, the offset is computed in seconds\&. To explicitly prevent a date from being set, use \*(Aqnone\*(Aq or \*(Aqnever\*(Aq\&.
|
||||||
@@ -329,39 +314,34 @@ contains the private key\&.
|
|||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
\&.key
|
\&.key
|
||||||
file contains a DNSKEY or KEY record\&. When a zone is being signed by
|
file contains a DNS KEY record that can be inserted into a zone file (directly or with a $INCLUDE statement)\&.
|
||||||
\fBnamed\fR
|
|
||||||
or
|
|
||||||
\fBdnssec\-signzone\fR\fB\-S\fR, DNSKEY records are included automatically\&. In other cases, the
|
|
||||||
\&.key
|
|
||||||
file can be inserted into a zone file manually or with a
|
|
||||||
\fB$INCLUDE\fR
|
|
||||||
statement\&.
|
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
\&.private
|
\&.private
|
||||||
file contains algorithm\-specific fields\&. For obvious security reasons, this file does not have general read permission\&.
|
file contains algorithm\-specific fields\&. For obvious security reasons, this file does not have general read permission\&.
|
||||||
|
.PP
|
||||||
|
Both
|
||||||
|
\&.key
|
||||||
|
and
|
||||||
|
\&.private
|
||||||
|
files are generated for symmetric cryptography algorithms such as HMAC\-MD5, even though the public and private key are equivalent\&.
|
||||||
.SH "EXAMPLE"
|
.SH "EXAMPLE"
|
||||||
.PP
|
.PP
|
||||||
To generate an ECDSAP256SHA256 zone\-signing key for the zone
|
To generate a 768\-bit DSA key for the domain
|
||||||
\fBexample\&.com\fR, issue the command:
|
\fBexample\&.com\fR, the following command would be issued:
|
||||||
.PP
|
.PP
|
||||||
\fBdnssec\-keygen \-a ECDSAP256SHA256 example\&.com\fR
|
\fBdnssec\-keygen \-a DSA \-b 768 \-n ZONE example\&.com\fR
|
||||||
.PP
|
.PP
|
||||||
The command would print a string of the form:
|
The command would print a string of the form:
|
||||||
.PP
|
.PP
|
||||||
\fBKexample\&.com\&.+013+26160\fR
|
\fBKexample\&.com\&.+003+26160\fR
|
||||||
.PP
|
.PP
|
||||||
In this example,
|
In this example,
|
||||||
\fBdnssec\-keygen\fR
|
\fBdnssec\-keygen\fR
|
||||||
creates the files
|
creates the files
|
||||||
Kexample\&.com\&.+013+26160\&.key
|
Kexample\&.com\&.+003+26160\&.key
|
||||||
and
|
and
|
||||||
Kexample\&.com\&.+013+26160\&.private\&.
|
Kexample\&.com\&.+003+26160\&.private\&.
|
||||||
.PP
|
|
||||||
To generate a matching key\-signing key, issue the command:
|
|
||||||
.PP
|
|
||||||
\fBdnssec\-keygen \-a ECDSAP256SHA256 \-f KSK example\&.com\fR
|
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.PP
|
.PP
|
||||||
\fBdnssec-signzone\fR(8),
|
\fBdnssec-signzone\fR(8),
|
||||||
@@ -374,5 +354,5 @@ RFC 4034\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2000-2005, 2007-2012, 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2000-2005, 2007-2012, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
+604
-825
File diff suppressed because it is too large
Load Diff
@@ -50,8 +50,6 @@
|
|||||||
<year>2016</year>
|
<year>2016</year>
|
||||||
<year>2017</year>
|
<year>2017</year>
|
||||||
<year>2018</year>
|
<year>2018</year>
|
||||||
<year>2019</year>
|
|
||||||
<year>2020</year>
|
|
||||||
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
</docinfo>
|
</docinfo>
|
||||||
@@ -59,15 +57,15 @@
|
|||||||
<refsynopsisdiv>
|
<refsynopsisdiv>
|
||||||
<cmdsynopsis sepchar=" ">
|
<cmdsynopsis sepchar=" ">
|
||||||
<command>dnssec-keygen</command>
|
<command>dnssec-keygen</command>
|
||||||
<arg choice="opt" rep="norepeat"><option>-3</option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-A <replaceable class="parameter">date/offset</replaceable></option></arg>
|
|
||||||
<arg rep="norepeat"><option>-a <replaceable class="parameter">algorithm</replaceable></option></arg>
|
<arg rep="norepeat"><option>-a <replaceable class="parameter">algorithm</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-b <replaceable class="parameter">keysize</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-b <replaceable class="parameter">keysize</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-n <replaceable class="parameter">nametype</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-3</option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-A <replaceable class="parameter">date/offset</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-C</option></arg>
|
<arg choice="opt" rep="norepeat"><option>-C</option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-c <replaceable class="parameter">class</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-c <replaceable class="parameter">class</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-D <replaceable class="parameter">date/offset</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-D <replaceable class="parameter">date/offset</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-D sync <replaceable class="parameter">date/offset</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-D sync <replaceable class="parameter">date/offset</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-d <replaceable class="parameter">bits</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-E <replaceable class="parameter">engine</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-E <replaceable class="parameter">engine</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-f <replaceable class="parameter">flag</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-f <replaceable class="parameter">flag</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-G</option></arg>
|
<arg choice="opt" rep="norepeat"><option>-G</option></arg>
|
||||||
@@ -76,10 +74,8 @@
|
|||||||
<arg choice="opt" rep="norepeat"><option>-I <replaceable class="parameter">date/offset</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-I <replaceable class="parameter">date/offset</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-i <replaceable class="parameter">interval</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-i <replaceable class="parameter">interval</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-K <replaceable class="parameter">directory</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-K <replaceable class="parameter">directory</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-k <replaceable class="parameter">policy</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-k</option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-L <replaceable class="parameter">ttl</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-L <replaceable class="parameter">ttl</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-l <replaceable class="parameter">file</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-n <replaceable class="parameter">nametype</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-P <replaceable class="parameter">date/offset</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-P <replaceable class="parameter">date/offset</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-P sync <replaceable class="parameter">date/offset</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-P sync <replaceable class="parameter">date/offset</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-p <replaceable class="parameter">protocol</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-p <replaceable class="parameter">protocol</replaceable></option></arg>
|
||||||
@@ -87,10 +83,10 @@
|
|||||||
<arg choice="opt" rep="norepeat"><option>-R <replaceable class="parameter">date/offset</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-R <replaceable class="parameter">date/offset</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-S <replaceable class="parameter">key</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-S <replaceable class="parameter">key</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-s <replaceable class="parameter">strength</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-s <replaceable class="parameter">strength</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-T <replaceable class="parameter">rrtype</replaceable></option></arg>
|
|
||||||
<arg choice="opt" rep="norepeat"><option>-t <replaceable class="parameter">type</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-t <replaceable class="parameter">type</replaceable></option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-V</option></arg>
|
<arg choice="opt" rep="norepeat"><option>-V</option></arg>
|
||||||
<arg choice="opt" rep="norepeat"><option>-v <replaceable class="parameter">level</replaceable></option></arg>
|
<arg choice="opt" rep="norepeat"><option>-v <replaceable class="parameter">level</replaceable></option></arg>
|
||||||
|
<arg choice="opt" rep="norepeat"><option>-z</option></arg>
|
||||||
<arg choice="req" rep="norepeat">name</arg>
|
<arg choice="req" rep="norepeat">name</arg>
|
||||||
</cmdsynopsis>
|
</cmdsynopsis>
|
||||||
</refsynopsisdiv>
|
</refsynopsisdiv>
|
||||||
@@ -121,27 +117,13 @@
|
|||||||
|
|
||||||
|
|
||||||
<variablelist>
|
<variablelist>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-3</term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Use an NSEC3-capable algorithm to generate a DNSSEC key.
|
|
||||||
If this option is used with an algorithm that has both
|
|
||||||
NSEC and NSEC3 versions, then the NSEC3 version will be
|
|
||||||
used; for example, <command>dnssec-keygen -3a RSASHA1</command>
|
|
||||||
specifies the NSEC3RSASHA1 algorithm.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-a <replaceable class="parameter">algorithm</replaceable></term>
|
<term>-a <replaceable class="parameter">algorithm</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Selects the cryptographic algorithm. For DNSSEC keys, the value
|
Selects the cryptographic algorithm. For DNSSEC keys, the value
|
||||||
of <option>algorithm</option> must be one of RSASHA1,
|
of <option>algorithm</option> must be one of RSAMD5, RSASHA1,
|
||||||
NSEC3RSASHA1, RSASHA256, RSASHA512,
|
DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512,
|
||||||
ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448. For
|
ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448. For
|
||||||
TKEY, the value must be DH (Diffie Hellman); specifying
|
TKEY, the value must be DH (Diffie Hellman); specifying
|
||||||
his value will automatically set the <option>-T KEY</option>
|
his value will automatically set the <option>-T KEY</option>
|
||||||
@@ -150,9 +132,9 @@
|
|||||||
<para>
|
<para>
|
||||||
These values are case insensitive. In some cases, abbreviations
|
These values are case insensitive. In some cases, abbreviations
|
||||||
are supported, such as ECDSA256 for ECDSAP256SHA256 and
|
are supported, such as ECDSA256 for ECDSAP256SHA256 and
|
||||||
ECDSA384 for ECDSAP384SHA384. If RSASHA1 is specified
|
ECDSA384 for ECDSAP384SHA384. If RSASHA1 or DSA is specified
|
||||||
along with the <option>-3</option> option, then NSEC3RSASHA1
|
along with the <option>-3</option> option, then NSEC3RSASHA1
|
||||||
will be used instead.
|
or NSEC3DSA will be used instead.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
This parameter <emphasis>must</emphasis> be specified except
|
This parameter <emphasis>must</emphasis> be specified except
|
||||||
@@ -174,14 +156,45 @@
|
|||||||
<para>
|
<para>
|
||||||
Specifies the number of bits in the key. The choice of key
|
Specifies the number of bits in the key. The choice of key
|
||||||
size depends on the algorithm used. RSA keys must be
|
size depends on the algorithm used. RSA keys must be
|
||||||
between 1024 and 4096 bits. Diffie Hellman keys must be between
|
between 1024 and 2048 bits. Diffie Hellman keys must be between
|
||||||
128 and 4096 bits. Elliptic curve algorithms don't need this
|
128 and 4096 bits. DSA keys must be between 512 and 1024
|
||||||
parameter.
|
bits and an exact multiple of 64. HMAC keys must be
|
||||||
|
between 1 and 512 bits. Elliptic curve algorithms don't need
|
||||||
|
this parameter.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
If the key size is not specified, some algorithms have
|
If the key size is not specified, some algorithms have
|
||||||
pre-defined defaults. For instance, RSA keys have a default
|
pre-defined defaults. For example, RSA keys for use as
|
||||||
size of 2048 bits.
|
DNSSEC zone signing keys have a default size of 1024 bits;
|
||||||
|
RSA keys for use as key signing keys (KSKs, generated with
|
||||||
|
<option>-f KSK</option>) default to 2048 bits.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>-n <replaceable class="parameter">nametype</replaceable></term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Specifies the owner type of the key. The value of
|
||||||
|
<option>nametype</option> must either be ZONE (for a DNSSEC
|
||||||
|
zone key (KEY/DNSKEY)), HOST or ENTITY (for a key associated
|
||||||
|
with a host (KEY)), USER (for a key associated with a
|
||||||
|
user(KEY)) or OTHER (DNSKEY). These values are case
|
||||||
|
insensitive. Defaults to ZONE for DNSKEY generation.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>-3</term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Use an NSEC3-capable algorithm to generate a DNSSEC key.
|
||||||
|
If this option is used with an algorithm that has both
|
||||||
|
NSEC and NSEC3 versions, then the NSEC3 version will be
|
||||||
|
used; for example, <command>dnssec-keygen -3a RSASHA1</command>
|
||||||
|
specifies the NSEC3RSASHA1 algorithm.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -190,12 +203,12 @@
|
|||||||
<term>-C</term>
|
<term>-C</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Compatibility mode: generates an old-style key, without any
|
Compatibility mode: generates an old-style key, without
|
||||||
timing metadata. By default, <command>dnssec-keygen</command>
|
any metadata. By default, <command>dnssec-keygen</command>
|
||||||
will include the key's creation date in the metadata stored with
|
will include the key's creation date in the metadata stored
|
||||||
the private key, and other dates may be set there as well
|
with the private key, and other dates may be set there as well
|
||||||
(publication date, activation date, etc). Keys that include this
|
(publication date, activation date, etc). Keys that include
|
||||||
data may be incompatible with older versions of BIND; the
|
this data may be incompatible with older versions of BIND; the
|
||||||
<option>-C</option> option suppresses them.
|
<option>-C</option> option suppresses them.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@@ -211,18 +224,6 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-d <replaceable class="parameter">bits</replaceable></term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Key size in bits. For the algorithms RSASHA1, NSEC3RSASA1,
|
|
||||||
RSASHA256 and RSASHA512 the key size must be in range 1024-4096.
|
|
||||||
DH size is between 128 and 4096. This option is ignored for
|
|
||||||
algorithms ECDSAP256SHA256, ECDSAP384SHA384, ED25519 and ED448.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-E <replaceable class="parameter">engine</replaceable></term>
|
<term>-E <replaceable class="parameter">engine</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
@@ -292,19 +293,10 @@
|
|||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-k <replaceable class="parameter">policy</replaceable></term>
|
<term>-k</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Create keys for a specific dnssec-policy. If a policy uses
|
Deprecated in favor of -T KEY.
|
||||||
multiple keys, <command>dnssec-keygen</command> will generate
|
|
||||||
multiple keys. This will also create a ".state" file to keep
|
|
||||||
track of the key state.
|
|
||||||
</para>
|
|
||||||
<para>
|
|
||||||
This option creates keys according to the dnssec-policy
|
|
||||||
configuration, hence it cannot be used together with many of
|
|
||||||
the other options that <command>dnssec-keygen</command>
|
|
||||||
provides.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -325,38 +317,14 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-l <replaceable class="parameter">file</replaceable></term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Provide a configuration file that contains a dnssec-policy
|
|
||||||
statement (matching the policy set with <command>-k</command>).
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-n <replaceable class="parameter">nametype</replaceable></term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Specifies the owner type of the key. The value of
|
|
||||||
<option>nametype</option> must either be ZONE (for a DNSSEC
|
|
||||||
zone key (KEY/DNSKEY)), HOST or ENTITY (for a key associated
|
|
||||||
with a host (KEY)), USER (for a key associated with a
|
|
||||||
user(KEY)) or OTHER (DNSKEY). These values are case
|
|
||||||
insensitive. Defaults to ZONE for DNSKEY generation.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>-p <replaceable class="parameter">protocol</replaceable></term>
|
<term>-p <replaceable class="parameter">protocol</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Sets the protocol value for the generated key, for use
|
Sets the protocol value for the generated key. The protocol
|
||||||
with <option>-T KEY</option>. The protocol is a number between 0
|
is a number between 0 and 255. The default is 3 (DNSSEC).
|
||||||
and 255. The default is 3 (DNSSEC). Other possible values for
|
Other possible values for this argument are listed in
|
||||||
this argument are listed in RFC 2535 and its successors.
|
RFC 2535 and its successors.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -414,6 +382,10 @@
|
|||||||
<option>rrtype</option> must be either DNSKEY or KEY. The
|
<option>rrtype</option> must be either DNSKEY or KEY. The
|
||||||
default is DNSKEY when using a DNSSEC algorithm, but it can be
|
default is DNSKEY when using a DNSSEC algorithm, but it can be
|
||||||
overridden to KEY for use with SIG(0).
|
overridden to KEY for use with SIG(0).
|
||||||
|
<para>
|
||||||
|
</para>
|
||||||
|
Specifying any TSIG algorithm (HMAC-* or DH) with
|
||||||
|
<option>-a</option> forces this option to KEY.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -422,20 +394,10 @@
|
|||||||
<term>-t <replaceable class="parameter">type</replaceable></term>
|
<term>-t <replaceable class="parameter">type</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Indicates the use of the key, for use with <option>-T
|
Indicates the use of the key. <option>type</option> must be
|
||||||
KEY</option>. <option>type</option> must be one of AUTHCONF,
|
one of AUTHCONF, NOAUTHCONF, NOAUTH, or NOCONF. The default
|
||||||
NOAUTHCONF, NOAUTH, or NOCONF. The default is AUTHCONF. AUTH
|
is AUTHCONF. AUTH refers to the ability to authenticate
|
||||||
refers to the ability to authenticate data, and CONF the ability
|
data, and CONF the ability to encrypt data.
|
||||||
to encrypt data.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term>-V</term>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
Prints version information.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -449,6 +411,15 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>-V</term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Prints version information.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
</variablelist>
|
</variablelist>
|
||||||
</refsection>
|
</refsection>
|
||||||
|
|
||||||
@@ -613,12 +584,10 @@
|
|||||||
key.
|
key.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
The <filename>.key</filename> file contains a DNSKEY or KEY record.
|
The <filename>.key</filename> file contains a DNS KEY record
|
||||||
When a zone is being signed by <command>named</command>
|
that
|
||||||
or <command>dnssec-signzone</command> <option>-S</option>, DNSKEY
|
can be inserted into a zone file (directly or with a $INCLUDE
|
||||||
records are included automatically. In other cases,
|
statement).
|
||||||
the <filename>.key</filename> file can be inserted into a zone file
|
|
||||||
manually or with a <userinput>$INCLUDE</userinput> statement.
|
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
The <filename>.private</filename> file contains
|
The <filename>.private</filename> file contains
|
||||||
@@ -626,33 +595,32 @@
|
|||||||
fields. For obvious security reasons, this file does not have
|
fields. For obvious security reasons, this file does not have
|
||||||
general read permission.
|
general read permission.
|
||||||
</para>
|
</para>
|
||||||
|
<para>
|
||||||
|
Both <filename>.key</filename> and <filename>.private</filename>
|
||||||
|
files are generated for symmetric cryptography algorithms such as
|
||||||
|
HMAC-MD5, even though the public and private key are equivalent.
|
||||||
|
</para>
|
||||||
</refsection>
|
</refsection>
|
||||||
|
|
||||||
<refsection><info><title>EXAMPLE</title></info>
|
<refsection><info><title>EXAMPLE</title></info>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
To generate an ECDSAP256SHA256 zone-signing key for the zone
|
To generate a 768-bit DSA key for the domain
|
||||||
<userinput>example.com</userinput>, issue the command:
|
<userinput>example.com</userinput>, the following command would be
|
||||||
|
issued:
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para><userinput>dnssec-keygen -a DSA -b 768 -n ZONE example.com</userinput>
|
||||||
<userinput>dnssec-keygen -a ECDSAP256SHA256 example.com</userinput>
|
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
The command would print a string of the form:
|
The command would print a string of the form:
|
||||||
</para>
|
</para>
|
||||||
<para><userinput>Kexample.com.+013+26160</userinput>
|
<para><userinput>Kexample.com.+003+26160</userinput>
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
In this example, <command>dnssec-keygen</command> creates
|
In this example, <command>dnssec-keygen</command> creates
|
||||||
the files <filename>Kexample.com.+013+26160.key</filename>
|
the files <filename>Kexample.com.+003+26160.key</filename>
|
||||||
and
|
and
|
||||||
<filename>Kexample.com.+013+26160.private</filename>.
|
<filename>Kexample.com.+003+26160.private</filename>.
|
||||||
</para>
|
|
||||||
<para>
|
|
||||||
To generate a matching key-signing key, issue the command:
|
|
||||||
</para>
|
|
||||||
<para>
|
|
||||||
<userinput>dnssec-keygen -a ECDSAP256SHA256 -f KSK example.com</userinput>
|
|
||||||
</para>
|
</para>
|
||||||
</refsection>
|
</refsection>
|
||||||
|
|
||||||
|
|||||||
+84
-105
@@ -1,6 +1,6 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||||
<!--
|
<!--
|
||||||
- Copyright (C) 2000-2005, 2007-2012, 2014-2020 Internet Systems Consortium, Inc. ("ISC")
|
- Copyright (C) 2000-2005, 2007-2012, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
-
|
-
|
||||||
- This Source Code Form is subject to the terms of the Mozilla Public
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -33,15 +33,15 @@
|
|||||||
<h2>Synopsis</h2>
|
<h2>Synopsis</h2>
|
||||||
<div class="cmdsynopsis"><p>
|
<div class="cmdsynopsis"><p>
|
||||||
<code class="command">dnssec-keygen</code>
|
<code class="command">dnssec-keygen</code>
|
||||||
[<code class="option">-3</code>]
|
|
||||||
[<code class="option">-A <em class="replaceable"><code>date/offset</code></em></code>]
|
|
||||||
[<code class="option">-a <em class="replaceable"><code>algorithm</code></em></code>]
|
[<code class="option">-a <em class="replaceable"><code>algorithm</code></em></code>]
|
||||||
[<code class="option">-b <em class="replaceable"><code>keysize</code></em></code>]
|
[<code class="option">-b <em class="replaceable"><code>keysize</code></em></code>]
|
||||||
|
[<code class="option">-n <em class="replaceable"><code>nametype</code></em></code>]
|
||||||
|
[<code class="option">-3</code>]
|
||||||
|
[<code class="option">-A <em class="replaceable"><code>date/offset</code></em></code>]
|
||||||
[<code class="option">-C</code>]
|
[<code class="option">-C</code>]
|
||||||
[<code class="option">-c <em class="replaceable"><code>class</code></em></code>]
|
[<code class="option">-c <em class="replaceable"><code>class</code></em></code>]
|
||||||
[<code class="option">-D <em class="replaceable"><code>date/offset</code></em></code>]
|
[<code class="option">-D <em class="replaceable"><code>date/offset</code></em></code>]
|
||||||
[<code class="option">-D sync <em class="replaceable"><code>date/offset</code></em></code>]
|
[<code class="option">-D sync <em class="replaceable"><code>date/offset</code></em></code>]
|
||||||
[<code class="option">-d <em class="replaceable"><code>bits</code></em></code>]
|
|
||||||
[<code class="option">-E <em class="replaceable"><code>engine</code></em></code>]
|
[<code class="option">-E <em class="replaceable"><code>engine</code></em></code>]
|
||||||
[<code class="option">-f <em class="replaceable"><code>flag</code></em></code>]
|
[<code class="option">-f <em class="replaceable"><code>flag</code></em></code>]
|
||||||
[<code class="option">-G</code>]
|
[<code class="option">-G</code>]
|
||||||
@@ -50,10 +50,8 @@
|
|||||||
[<code class="option">-I <em class="replaceable"><code>date/offset</code></em></code>]
|
[<code class="option">-I <em class="replaceable"><code>date/offset</code></em></code>]
|
||||||
[<code class="option">-i <em class="replaceable"><code>interval</code></em></code>]
|
[<code class="option">-i <em class="replaceable"><code>interval</code></em></code>]
|
||||||
[<code class="option">-K <em class="replaceable"><code>directory</code></em></code>]
|
[<code class="option">-K <em class="replaceable"><code>directory</code></em></code>]
|
||||||
[<code class="option">-k <em class="replaceable"><code>policy</code></em></code>]
|
[<code class="option">-k</code>]
|
||||||
[<code class="option">-L <em class="replaceable"><code>ttl</code></em></code>]
|
[<code class="option">-L <em class="replaceable"><code>ttl</code></em></code>]
|
||||||
[<code class="option">-l <em class="replaceable"><code>file</code></em></code>]
|
|
||||||
[<code class="option">-n <em class="replaceable"><code>nametype</code></em></code>]
|
|
||||||
[<code class="option">-P <em class="replaceable"><code>date/offset</code></em></code>]
|
[<code class="option">-P <em class="replaceable"><code>date/offset</code></em></code>]
|
||||||
[<code class="option">-P sync <em class="replaceable"><code>date/offset</code></em></code>]
|
[<code class="option">-P sync <em class="replaceable"><code>date/offset</code></em></code>]
|
||||||
[<code class="option">-p <em class="replaceable"><code>protocol</code></em></code>]
|
[<code class="option">-p <em class="replaceable"><code>protocol</code></em></code>]
|
||||||
@@ -61,10 +59,10 @@
|
|||||||
[<code class="option">-R <em class="replaceable"><code>date/offset</code></em></code>]
|
[<code class="option">-R <em class="replaceable"><code>date/offset</code></em></code>]
|
||||||
[<code class="option">-S <em class="replaceable"><code>key</code></em></code>]
|
[<code class="option">-S <em class="replaceable"><code>key</code></em></code>]
|
||||||
[<code class="option">-s <em class="replaceable"><code>strength</code></em></code>]
|
[<code class="option">-s <em class="replaceable"><code>strength</code></em></code>]
|
||||||
[<code class="option">-T <em class="replaceable"><code>rrtype</code></em></code>]
|
|
||||||
[<code class="option">-t <em class="replaceable"><code>type</code></em></code>]
|
[<code class="option">-t <em class="replaceable"><code>type</code></em></code>]
|
||||||
[<code class="option">-V</code>]
|
[<code class="option">-V</code>]
|
||||||
[<code class="option">-v <em class="replaceable"><code>level</code></em></code>]
|
[<code class="option">-v <em class="replaceable"><code>level</code></em></code>]
|
||||||
|
[<code class="option">-z</code>]
|
||||||
{name}
|
{name}
|
||||||
</p></div>
|
</p></div>
|
||||||
</div>
|
</div>
|
||||||
@@ -97,22 +95,12 @@
|
|||||||
|
|
||||||
|
|
||||||
<div class="variablelist"><dl class="variablelist">
|
<div class="variablelist"><dl class="variablelist">
|
||||||
<dt><span class="term">-3</span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Use an NSEC3-capable algorithm to generate a DNSSEC key.
|
|
||||||
If this option is used with an algorithm that has both
|
|
||||||
NSEC and NSEC3 versions, then the NSEC3 version will be
|
|
||||||
used; for example, <span class="command"><strong>dnssec-keygen -3a RSASHA1</strong></span>
|
|
||||||
specifies the NSEC3RSASHA1 algorithm.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt>
|
<dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Selects the cryptographic algorithm. For DNSSEC keys, the value
|
Selects the cryptographic algorithm. For DNSSEC keys, the value
|
||||||
of <code class="option">algorithm</code> must be one of RSASHA1,
|
of <code class="option">algorithm</code> must be one of RSAMD5, RSASHA1,
|
||||||
NSEC3RSASHA1, RSASHA256, RSASHA512,
|
DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512,
|
||||||
ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448. For
|
ECDSAP256SHA256, ECDSAP384SHA384, ED25519 or ED448. For
|
||||||
TKEY, the value must be DH (Diffie Hellman); specifying
|
TKEY, the value must be DH (Diffie Hellman); specifying
|
||||||
his value will automatically set the <code class="option">-T KEY</code>
|
his value will automatically set the <code class="option">-T KEY</code>
|
||||||
@@ -121,9 +109,9 @@
|
|||||||
<p>
|
<p>
|
||||||
These values are case insensitive. In some cases, abbreviations
|
These values are case insensitive. In some cases, abbreviations
|
||||||
are supported, such as ECDSA256 for ECDSAP256SHA256 and
|
are supported, such as ECDSA256 for ECDSAP256SHA256 and
|
||||||
ECDSA384 for ECDSAP384SHA384. If RSASHA1 is specified
|
ECDSA384 for ECDSAP384SHA384. If RSASHA1 or DSA is specified
|
||||||
along with the <code class="option">-3</code> option, then NSEC3RSASHA1
|
along with the <code class="option">-3</code> option, then NSEC3RSASHA1
|
||||||
will be used instead.
|
or NSEC3DSA will be used instead.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
This parameter <span class="emphasis"><em>must</em></span> be specified except
|
This parameter <span class="emphasis"><em>must</em></span> be specified except
|
||||||
@@ -142,25 +130,50 @@
|
|||||||
<p>
|
<p>
|
||||||
Specifies the number of bits in the key. The choice of key
|
Specifies the number of bits in the key. The choice of key
|
||||||
size depends on the algorithm used. RSA keys must be
|
size depends on the algorithm used. RSA keys must be
|
||||||
between 1024 and 4096 bits. Diffie Hellman keys must be between
|
between 1024 and 2048 bits. Diffie Hellman keys must be between
|
||||||
128 and 4096 bits. Elliptic curve algorithms don't need this
|
128 and 4096 bits. DSA keys must be between 512 and 1024
|
||||||
parameter.
|
bits and an exact multiple of 64. HMAC keys must be
|
||||||
|
between 1 and 512 bits. Elliptic curve algorithms don't need
|
||||||
|
this parameter.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
If the key size is not specified, some algorithms have
|
If the key size is not specified, some algorithms have
|
||||||
pre-defined defaults. For instance, RSA keys have a default
|
pre-defined defaults. For example, RSA keys for use as
|
||||||
size of 2048 bits.
|
DNSSEC zone signing keys have a default size of 1024 bits;
|
||||||
|
RSA keys for use as key signing keys (KSKs, generated with
|
||||||
|
<code class="option">-f KSK</code>) default to 2048 bits.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
|
<dt><span class="term">-n <em class="replaceable"><code>nametype</code></em></span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Specifies the owner type of the key. The value of
|
||||||
|
<code class="option">nametype</code> must either be ZONE (for a DNSSEC
|
||||||
|
zone key (KEY/DNSKEY)), HOST or ENTITY (for a key associated
|
||||||
|
with a host (KEY)), USER (for a key associated with a
|
||||||
|
user(KEY)) or OTHER (DNSKEY). These values are case
|
||||||
|
insensitive. Defaults to ZONE for DNSKEY generation.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
|
<dt><span class="term">-3</span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Use an NSEC3-capable algorithm to generate a DNSSEC key.
|
||||||
|
If this option is used with an algorithm that has both
|
||||||
|
NSEC and NSEC3 versions, then the NSEC3 version will be
|
||||||
|
used; for example, <span class="command"><strong>dnssec-keygen -3a RSASHA1</strong></span>
|
||||||
|
specifies the NSEC3RSASHA1 algorithm.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-C</span></dt>
|
<dt><span class="term">-C</span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Compatibility mode: generates an old-style key, without any
|
Compatibility mode: generates an old-style key, without
|
||||||
timing metadata. By default, <span class="command"><strong>dnssec-keygen</strong></span>
|
any metadata. By default, <span class="command"><strong>dnssec-keygen</strong></span>
|
||||||
will include the key's creation date in the metadata stored with
|
will include the key's creation date in the metadata stored
|
||||||
the private key, and other dates may be set there as well
|
with the private key, and other dates may be set there as well
|
||||||
(publication date, activation date, etc). Keys that include this
|
(publication date, activation date, etc). Keys that include
|
||||||
data may be incompatible with older versions of BIND; the
|
this data may be incompatible with older versions of BIND; the
|
||||||
<code class="option">-C</code> option suppresses them.
|
<code class="option">-C</code> option suppresses them.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
@@ -171,15 +184,6 @@
|
|||||||
the specified class. If not specified, class IN is used.
|
the specified class. If not specified, class IN is used.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-d <em class="replaceable"><code>bits</code></em></span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Key size in bits. For the algorithms RSASHA1, NSEC3RSASA1,
|
|
||||||
RSASHA256 and RSASHA512 the key size must be in range 1024-4096.
|
|
||||||
DH size is between 128 and 4096. This option is ignored for
|
|
||||||
algorithms ECDSAP256SHA256, ECDSAP384SHA384, ED25519 and ED448.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-E <em class="replaceable"><code>engine</code></em></span></dt>
|
<dt><span class="term">-E <em class="replaceable"><code>engine</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
@@ -230,19 +234,10 @@
|
|||||||
Sets the directory in which the key files are to be written.
|
Sets the directory in which the key files are to be written.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-k <em class="replaceable"><code>policy</code></em></span></dt>
|
<dt><span class="term">-k</span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Create keys for a specific dnssec-policy. If a policy uses
|
Deprecated in favor of -T KEY.
|
||||||
multiple keys, <span class="command"><strong>dnssec-keygen</strong></span> will generate
|
|
||||||
multiple keys. This will also create a ".state" file to keep
|
|
||||||
track of the key state.
|
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
This option creates keys according to the dnssec-policy
|
|
||||||
configuration, hence it cannot be used together with many of
|
|
||||||
the other options that <span class="command"><strong>dnssec-keygen</strong></span>
|
|
||||||
provides.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-L <em class="replaceable"><code>ttl</code></em></span></dt>
|
<dt><span class="term">-L <em class="replaceable"><code>ttl</code></em></span></dt>
|
||||||
@@ -258,31 +253,13 @@
|
|||||||
or <code class="literal">none</code> is the same as leaving it unset.
|
or <code class="literal">none</code> is the same as leaving it unset.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-l <em class="replaceable"><code>file</code></em></span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Provide a configuration file that contains a dnssec-policy
|
|
||||||
statement (matching the policy set with <span class="command"><strong>-k</strong></span>).
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-n <em class="replaceable"><code>nametype</code></em></span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Specifies the owner type of the key. The value of
|
|
||||||
<code class="option">nametype</code> must either be ZONE (for a DNSSEC
|
|
||||||
zone key (KEY/DNSKEY)), HOST or ENTITY (for a key associated
|
|
||||||
with a host (KEY)), USER (for a key associated with a
|
|
||||||
user(KEY)) or OTHER (DNSKEY). These values are case
|
|
||||||
insensitive. Defaults to ZONE for DNSKEY generation.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-p <em class="replaceable"><code>protocol</code></em></span></dt>
|
<dt><span class="term">-p <em class="replaceable"><code>protocol</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Sets the protocol value for the generated key, for use
|
Sets the protocol value for the generated key. The protocol
|
||||||
with <code class="option">-T KEY</code>. The protocol is a number between 0
|
is a number between 0 and 255. The default is 3 (DNSSEC).
|
||||||
and 255. The default is 3 (DNSSEC). Other possible values for
|
Other possible values for this argument are listed in
|
||||||
this argument are listed in RFC 2535 and its successors.
|
RFC 2535 and its successors.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-q</span></dt>
|
<dt><span class="term">-q</span></dt>
|
||||||
@@ -329,21 +306,20 @@
|
|||||||
default is DNSKEY when using a DNSSEC algorithm, but it can be
|
default is DNSKEY when using a DNSSEC algorithm, but it can be
|
||||||
overridden to KEY for use with SIG(0).
|
overridden to KEY for use with SIG(0).
|
||||||
</p>
|
</p>
|
||||||
|
<p>
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
Specifying any TSIG algorithm (HMAC-* or DH) with
|
||||||
|
<code class="option">-a</code> forces this option to KEY.
|
||||||
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-t <em class="replaceable"><code>type</code></em></span></dt>
|
<dt><span class="term">-t <em class="replaceable"><code>type</code></em></span></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>
|
<p>
|
||||||
Indicates the use of the key, for use with <code class="option">-T
|
Indicates the use of the key. <code class="option">type</code> must be
|
||||||
KEY</code>. <code class="option">type</code> must be one of AUTHCONF,
|
one of AUTHCONF, NOAUTHCONF, NOAUTH, or NOCONF. The default
|
||||||
NOAUTHCONF, NOAUTH, or NOCONF. The default is AUTHCONF. AUTH
|
is AUTHCONF. AUTH refers to the ability to authenticate
|
||||||
refers to the ability to authenticate data, and CONF the ability
|
data, and CONF the ability to encrypt data.
|
||||||
to encrypt data.
|
|
||||||
</p>
|
|
||||||
</dd>
|
|
||||||
<dt><span class="term">-V</span></dt>
|
|
||||||
<dd>
|
|
||||||
<p>
|
|
||||||
Prints version information.
|
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><span class="term">-v <em class="replaceable"><code>level</code></em></span></dt>
|
<dt><span class="term">-v <em class="replaceable"><code>level</code></em></span></dt>
|
||||||
@@ -352,6 +328,12 @@
|
|||||||
Sets the debugging level.
|
Sets the debugging level.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
|
<dt><span class="term">-V</span></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
Prints version information.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
</dl></div>
|
</dl></div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -494,12 +476,10 @@
|
|||||||
key.
|
key.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
The <code class="filename">.key</code> file contains a DNSKEY or KEY record.
|
The <code class="filename">.key</code> file contains a DNS KEY record
|
||||||
When a zone is being signed by <span class="command"><strong>named</strong></span>
|
that
|
||||||
or <span class="command"><strong>dnssec-signzone</strong></span> <code class="option">-S</code>, DNSKEY
|
can be inserted into a zone file (directly or with a $INCLUDE
|
||||||
records are included automatically. In other cases,
|
statement).
|
||||||
the <code class="filename">.key</code> file can be inserted into a zone file
|
|
||||||
manually or with a <strong class="userinput"><code>$INCLUDE</code></strong> statement.
|
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
The <code class="filename">.private</code> file contains
|
The <code class="filename">.private</code> file contains
|
||||||
@@ -507,34 +487,33 @@
|
|||||||
fields. For obvious security reasons, this file does not have
|
fields. For obvious security reasons, this file does not have
|
||||||
general read permission.
|
general read permission.
|
||||||
</p>
|
</p>
|
||||||
|
<p>
|
||||||
|
Both <code class="filename">.key</code> and <code class="filename">.private</code>
|
||||||
|
files are generated for symmetric cryptography algorithms such as
|
||||||
|
HMAC-MD5, even though the public and private key are equivalent.
|
||||||
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="refsection">
|
<div class="refsection">
|
||||||
<a name="id-1.11"></a><h2>EXAMPLE</h2>
|
<a name="id-1.11"></a><h2>EXAMPLE</h2>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
To generate an ECDSAP256SHA256 zone-signing key for the zone
|
To generate a 768-bit DSA key for the domain
|
||||||
<strong class="userinput"><code>example.com</code></strong>, issue the command:
|
<strong class="userinput"><code>example.com</code></strong>, the following command would be
|
||||||
|
issued:
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p><strong class="userinput"><code>dnssec-keygen -a DSA -b 768 -n ZONE example.com</code></strong>
|
||||||
<strong class="userinput"><code>dnssec-keygen -a ECDSAP256SHA256 example.com</code></strong>
|
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
The command would print a string of the form:
|
The command would print a string of the form:
|
||||||
</p>
|
</p>
|
||||||
<p><strong class="userinput"><code>Kexample.com.+013+26160</code></strong>
|
<p><strong class="userinput"><code>Kexample.com.+003+26160</code></strong>
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
In this example, <span class="command"><strong>dnssec-keygen</strong></span> creates
|
In this example, <span class="command"><strong>dnssec-keygen</strong></span> creates
|
||||||
the files <code class="filename">Kexample.com.+013+26160.key</code>
|
the files <code class="filename">Kexample.com.+003+26160.key</code>
|
||||||
and
|
and
|
||||||
<code class="filename">Kexample.com.+013+26160.private</code>.
|
<code class="filename">Kexample.com.+003+26160.private</code>.
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
To generate a matching key-signing key, issue the command:
|
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
<strong class="userinput"><code>dnssec-keygen -a ECDSAP256SHA256 -f KSK example.com</code></strong>
|
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.\" Copyright (C) 2009, 2011, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
.\" Copyright (C) 2009, 2011, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.\"
|
.\"
|
||||||
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
@@ -99,5 +99,5 @@ RFC 5011\&.
|
|||||||
\fBInternet Systems Consortium, Inc\&.\fR
|
\fBInternet Systems Consortium, Inc\&.\fR
|
||||||
.SH "COPYRIGHT"
|
.SH "COPYRIGHT"
|
||||||
.br
|
.br
|
||||||
Copyright \(co 2009, 2011, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
|
Copyright \(co 2009, 2011, 2014-2016, 2018 Internet Systems Consortium, Inc. ("ISC")
|
||||||
.br
|
.br
|
||||||
|
|||||||
@@ -11,6 +11,8 @@
|
|||||||
|
|
||||||
/*! \file */
|
/*! \file */
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
#include <inttypes.h>
|
#include <inttypes.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
@@ -37,6 +39,7 @@
|
|||||||
#include "dnssectool.h"
|
#include "dnssectool.h"
|
||||||
|
|
||||||
const char *program = "dnssec-revoke";
|
const char *program = "dnssec-revoke";
|
||||||
|
int verbose;
|
||||||
|
|
||||||
static isc_mem_t *mctx = NULL;
|
static isc_mem_t *mctx = NULL;
|
||||||
|
|
||||||
@@ -54,13 +57,13 @@ usage(void) {
|
|||||||
#else
|
#else
|
||||||
fprintf(stderr, " -E engine: specify OpenSSL engine\n");
|
fprintf(stderr, " -E engine: specify OpenSSL engine\n");
|
||||||
#endif
|
#endif
|
||||||
fprintf(stderr, " -f: force overwrite\n");
|
fprintf(stderr, " -f: force overwrite\n");
|
||||||
fprintf(stderr, " -h: help\n");
|
|
||||||
fprintf(stderr, " -K directory: use directory for key files\n");
|
fprintf(stderr, " -K directory: use directory for key files\n");
|
||||||
fprintf(stderr, " -r: remove old keyfiles after "
|
fprintf(stderr, " -h: help\n");
|
||||||
|
fprintf(stderr, " -r: remove old keyfiles after "
|
||||||
"creating revoked version\n");
|
"creating revoked version\n");
|
||||||
fprintf(stderr, " -v level: set level of verbosity\n");
|
fprintf(stderr, " -v level: set level of verbosity\n");
|
||||||
fprintf(stderr, " -V: print version information\n");
|
fprintf(stderr, " -V: print version information\n");
|
||||||
fprintf(stderr, "Output:\n");
|
fprintf(stderr, "Output:\n");
|
||||||
fprintf(stderr, " K<name>+<alg>+<new id>.key, "
|
fprintf(stderr, " K<name>+<alg>+<new id>.key, "
|
||||||
"K<name>+<alg>+<new id>.private\n");
|
"K<name>+<alg>+<new id>.private\n");
|
||||||
@@ -88,7 +91,9 @@ main(int argc, char **argv) {
|
|||||||
if (argc == 1)
|
if (argc == 1)
|
||||||
usage();
|
usage();
|
||||||
|
|
||||||
isc_mem_create(&mctx);
|
result = isc_mem_create(0, 0, &mctx);
|
||||||
|
if (result != ISC_R_SUCCESS)
|
||||||
|
fatal("Out of memory");
|
||||||
|
|
||||||
#if HAVE_PKCS11
|
#if HAVE_PKCS11
|
||||||
pk11_result_register();
|
pk11_result_register();
|
||||||
@@ -111,6 +116,10 @@ main(int argc, char **argv) {
|
|||||||
* simplify cleanup later
|
* simplify cleanup later
|
||||||
*/
|
*/
|
||||||
dir = isc_mem_strdup(mctx, isc_commandline_argument);
|
dir = isc_mem_strdup(mctx, isc_commandline_argument);
|
||||||
|
if (dir == NULL) {
|
||||||
|
fatal("Failed to allocate memory for "
|
||||||
|
"directory");
|
||||||
|
}
|
||||||
break;
|
break;
|
||||||
case 'r':
|
case 'r':
|
||||||
removefile = true;
|
removefile = true;
|
||||||
@@ -230,7 +239,7 @@ main(int argc, char **argv) {
|
|||||||
* Remove old key file, if told to (and if
|
* Remove old key file, if told to (and if
|
||||||
* it isn't the same as the new file)
|
* it isn't the same as the new file)
|
||||||
*/
|
*/
|
||||||
if (removefile) {
|
if (removefile && dst_key_alg(key) != DST_ALG_RSAMD5) {
|
||||||
isc_buffer_init(&buf, oldname, sizeof(oldname));
|
isc_buffer_init(&buf, oldname, sizeof(oldname));
|
||||||
dst_key_setflags(key, flags & ~DNS_KEYFLAG_REVOKE);
|
dst_key_setflags(key, flags & ~DNS_KEYFLAG_REVOKE);
|
||||||
dst_key_buildfilename(key, DST_TYPE_PRIVATE, dir, &buf);
|
dst_key_buildfilename(key, DST_TYPE_PRIVATE, dir, &buf);
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user