dnssec-dsfromkey(8)

1DNSSEC-DSFROMKEY(8)                  BIND9                 DNSSEC-DSFROMKEY(8)
2
3
4

NAME

6       dnssec-dsfromkey - DNSSEC DS RR generation tool
7

SYNOPSIS

9       dnssec-dsfromkey [-1 | -2 | -a alg] [-C | -l domain] [-T TTL]
10                        [-v level] [-K directory] {keyfile}
11
12       dnssec-dsfromkey [-1 | -2 | -a alg] [-C | -l domain] [-T TTL]
13                        [-v level] [-c class] [-A] {-f file} [dnsname]
14
15       dnssec-dsfromkey [-1 | -2 | -a alg] [-C | -l domain] [-T TTL]
16                        [-v level] [-c class] [-K directory] {-s} {dnsname}
17
18       dnssec-dsfromkey [-h | -V]
19

DESCRIPTION

21       The dnssec-dsfromkey command outputs DS (Delegation Signer) resource
22       records (RRs) and other similarly-constructed RRs: with the -l option
23       it outputs DLV (DNSSEC Lookaside Validation) RRs; or with the -C it
24       outputs CDS (Child DS) RRs.
25
26       The input keys can be specified in a number of ways:
27
28       By default, dnssec-dsfromkey reads a key file named like
29       Knnnn.+aaa+iiiii.key, as generated by dnssec-keygen.
30
31       With the -f file option, dnssec-dsfromkey reads keys from a zone file
32       or partial zone file (which can contain just the DNSKEY records).
33
34       With the -s option, dnssec-dsfromkey reads a keyset- file, as generated
35       by dnssec-keygen-C.
36

OPTIONS

38       -1
39           An abbreviation for -a SHA1
40
41       -2
42           An abbreviation for -a SHA-256
43
44       -a algorithm
45           Specify a digest algorithm to use when converting DNSKEY records to
46           DS records. This option can be repeated, so that multiple DS
47           records are created for each DNSKEY record.
48
49           The algorithm must be one of SHA-1, SHA-256, or SHA-384. These
50           values are case insensitive, and the hyphen may be omitted. If no
51           algorithm is specified, the default is SHA-256.
52
53       -A
54           Include ZSKs when generating DS records. Without this option, only
55           keys which have the KSK flag set will be converted to DS records
56           and printed. Useful only in -f zone file mode.
57
58       -c class
59           Specifies the DNS class (default is IN). Useful only in -s keyset
60           or -f zone file mode.
61
62       -C
63           Generate CDS records rather than DS records. This is mutually
64           exclusive with the -l option for generating DLV records.
65
66       -f file
67           Zone file mode: dnssec-dsfromkey's final dnsname argument is the
68           DNS domain name of a zone whose master file can be read from file.
69           If the zone name is the same as file, then it may be omitted.
70
71           If file is "-", then the zone data is read from the standard input.
72           This makes it possible to use the output of the dig command as
73           input, as in:
74
75           dig dnskey example.com | dnssec-dsfromkey -f - example.com
76
77       -h
78           Prints usage information.
79
80       -K directory
81           Look for key files or keyset- files in directory.
82
83       -l domain
84           Generate a DLV set instead of a DS set. The specified domain is
85           appended to the name for each record in the set. This is mutually
86           exclusive with the -C option for generating CDS records.
87
88       -s
89           Keyset mode: dnssec-dsfromkey's final dnsname argument is the DNS
90           domain name used to locate a keyset- file.
91
92       -T TTL
93           Specifies the TTL of the DS records. By default the TTL is omitted.
94
95       -v level
96           Sets the debugging level.
97
98       -V
99           Prints version information.
100

EXAMPLE

102       To build the SHA-256 DS RR from the Kexample.com.+003+26160 keyfile
103       name, you can issue the following command:
104
105       dnssec-dsfromkey -2 Kexample.com.+003+26160
106
107       The command would print something like:
108
109       example.com. IN DS 26160 5 2
110       3A1EADA7A74B8D0BA86726B0C227AA85AB8BBD2B2004F41A868A54F0C5EA0B94
111

FILES

113       The keyfile can be designated by the key identification
114       Knnnn.+aaa+iiiii or the full file name Knnnn.+aaa+iiiii.key as
115       generated by dnssec-keygen(8).
116
117       The keyset file name is built from the directory, the string keyset-
118       and the dnsname.
119

CAVEAT

121       A keyfile error can give a "file not found" even if the file exists.
122

AUTHOR

129       Internet Systems Consortium, Inc.
130

COPYRIGHT

132       Copyright © 2008-2012, 2014-2016, 2018, 2019 Internet Systems
133       Consortium, Inc. ("ISC")
134
135
136
137ISC                               2012-05-02               DNSSEC-DSFROMKEY(8)