Man page generated from reStructuredText..
.
.nr rst2man-indent-level 0
.
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.rstReportMargin pre:. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.rstReportMargin post:..
. RE
indent \\n[an-margin] old: \\n[rst2man-indent\\n[rst2man-indent-level]].nr rst2man-indent-level -1
new: \\n[rst2man-indent\\n[rst2man-indent-level]]..
"DNSSEC-DSFROMKEY" "1" "@RELEASE_DATE@" "@PACKAGE_VERSION@" "BIND 9"
NAME
dnssec-dsfromkey - DNSSEC DS RR generation tool
SYNOPSIS
dnssec-dsfromkey [
-1 |
-2 |
-a alg ] [
-C ] [
-T TTL] [
-v level] [
-K directory] {keyfile}
dnssec-dsfromkey [
-1 |
-2 |
-a alg ] [
-C ] [
-T TTL] [
-v level] [
-c class] [
-A] {
-f file} [dnsname]
dnssec-dsfromkey [
-1 |
-2 |
-a alg ] [
-C ] [
-T TTL] [
-v level] [
-c class] [
-K directory] {
-s} {dnsname}
dnssec-dsfromkey [
-h |
-V ]
DESCRIPTION
The
dnssec-dsfromkey command outputs DS (Delegation Signer) resource records
(RRs), or CDS (Child DS) RRs with the
\%-C option.
By default, only KSKs are converted (keys with flags = 257). The
\%-A option includes ZSKs (flags = 256). Revoked keys are never
included.
The input keys can be specified in a number of ways:
By default,
dnssec-dsfromkey reads a key file named in the format
Knnnn.+aaa+iiiii.key, as generated by \X'tty: link #std-iscman-dnssec-keygen'
\%dnssec-keygen\X'tty: link'.
With the
\%-f file option,
dnssec-dsfromkey reads keys from a zone
file or partial zone file (which can contain just the DNSKEY records).
With the
\%-s option,
dnssec-dsfromkey reads a
keyset- file,
as generated by \X'tty: link #std-iscman-dnssec-keygen'
\%dnssec-keygen\X'tty: link'
\%-C.
OPTIONS
NDENT 0.0
-1 This option is an abbreviation for \%-a SHA1.
NINDENT NDENT 0.0
-2 This option is an abbreviation for \%-a SHA-256.
NINDENT NDENT 0.0
-a algorithm This option specifies 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.
The algorithm 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.
NINDENT NDENT 0.0
-A This option indicates that ZSKs are to be included when generating DS records. Without this option, only
keys which have the KSK flag set are converted to DS records and
printed. This option is only useful in \%-f zone file mode.
NINDENT NDENT 0.0
-c class This option specifies the DNS class; the default is IN. This option is only useful in \%-s keyset
or \%-f zone file mode.
NINDENT NDENT 0.0
-C This option generates CDS records rather than DS records.
NINDENT NDENT 0.0
-f file This option sets zone file mode, in which the final dnsname argument of dnssec-dsfromkey is the
DNS domain name of a zone whose master file can be read from
file. If the zone name is the same as file, then it may be
omitted.
If file is -, then the zone data is read from the standard
input. This makes it possible to use the output of the \X'tty: link #std-iscman-dig'\%dig\X'tty: link'
command as input, as in:
dig dnskey example.com | dnssec-dsfromkey -f - example.com
NINDENT NDENT 0.0
-h This option prints usage information.
NINDENT NDENT 0.0
-K directory This option tells BIND 9 to look for key files or keyset- files in directory.
NINDENT NDENT 0.0
-s This option enables keyset mode, in which the final dnsname argument from dnssec-dsfromkey is the DNS
domain name used to locate a keyset- file.
NINDENT NDENT 0.0
-T TTL This option specifies the TTL of the DS records. By default the TTL is omitted.
NINDENT NDENT 0.0
-v level This option sets the debugging level.
NINDENT NDENT 0.0
-V This option prints version information.
NINDENT
EXAMPLE
To build the SHA-256 DS RR from the
Kexample.com.+003+26160 keyfile,
issue the following command:
dnssec-dsfromkey -2 Kexample.com.+003+26160
The command returns something similar to:
example.com. IN DS 26160 5 2 3A1EADA7A74B8D0BA86726B0C227AA85AB8BBD2B2004F41A868A54F0C5EA0B94
FILES
The keyfile can be designated by the key identification
Knnnn.+aaa+iiiii or the full file name
Knnnn.+aaa+iiiii.key, as
generated by \X'tty: link #std-iscman-dnssec-keygen'
\%dnssec-keygen\X'tty: link'.
The keyset file name is built from the
directory, the string
keyset-, and the
dnsname.
CAVEAT
A keyfile error may return \(dqfile not found,\(dq even if the file exists.
SEE ALSO
\X'tty: link #std-iscman-dnssec-keygen'
\%dnssec-keygen(8)\X'tty: link', \X'tty: link #std-iscman-dnssec-signzone'
\%dnssec-signzone(8)\X'tty: link', BIND 9 Administrator Reference Manual,
\X'tty: link https://
datatracker.ietf.org/
doc/
html/
rfc3658.html'
\%RFC 3658\X'tty: link' (DS RRs), \X'tty: link https://
datatracker.ietf.org/
doc/
html/
rfc4509.html'
\%RFC 4509\X'tty: link' (SHA-256 for DS RRs),
\X'tty: link https://
datatracker.ietf.org/
doc/
html/
rfc6605.html'
\%RFC 6605\X'tty: link' (SHA-384 for DS RRs), \X'tty: link https://
datatracker.ietf.org/
doc/
html/
rfc7344.html'
\%RFC 7344\X'tty: link' (CDS and CDNSKEY RRs).
AUTHOR
Internet Systems Consortium
COPYRIGHT
2024, Internet Systems Consortium
Generated by docutils manpage writer..