head 1.2; access; symbols perseant-exfatfs-base-20240630:1.2 perseant-exfatfs:1.2.0.18 perseant-exfatfs-base:1.2 cjep_sun2x:1.2.0.16 cjep_sun2x-base:1.2 cjep_staticlib_x-base1:1.2 cjep_staticlib_x:1.2.0.14 cjep_staticlib_x-base:1.2 phil-wifi-20200421:1.2 phil-wifi-20200411:1.2 phil-wifi-20200406:1.2 pgoyette-compat-merge-20190127:1.2 pgoyette-compat-20190127:1.2 pgoyette-compat-20190118:1.2 pgoyette-compat-1226:1.2 pgoyette-compat-1126:1.2 pgoyette-compat-1020:1.2 pgoyette-compat-0930:1.2 pgoyette-compat-0906:1.2 pgoyette-compat-0728:1.2 pgoyette-compat-0625:1.2 pgoyette-compat-0521:1.2 pgoyette-compat-0502:1.2 pgoyette-compat-0422:1.2 pgoyette-compat-0415:1.2 pgoyette-compat-0407:1.2 pgoyette-compat-0330:1.2 pgoyette-compat-0322:1.2 pgoyette-compat-0315:1.2 pgoyette-compat:1.2.0.12 pgoyette-compat-base:1.2 perseant-stdc-iso10646:1.2.0.10 perseant-stdc-iso10646-base:1.2 prg-localcount2-base3:1.2 prg-localcount2-base2:1.2 prg-localcount2-base1:1.2 prg-localcount2:1.2.0.8 prg-localcount2-base:1.2 pgoyette-localcount-20170426:1.2 bouyer-socketcan-base1:1.2 pgoyette-localcount-20170320:1.2 bouyer-socketcan:1.2.0.6 bouyer-socketcan-base:1.2 pgoyette-localcount-20170107:1.2 pgoyette-localcount-20161104:1.2 localcount-20160914:1.2 pgoyette-localcount-20160806:1.2 pgoyette-localcount-20160726:1.2 pgoyette-localcount:1.2.0.4 pgoyette-localcount-base:1.2 netbsd-6-0-6-RELEASE:1.1.1.1 netbsd-6-1-5-RELEASE:1.1.1.1 yamt-pagecache-base9:1.2 yamt-pagecache-tag8:1.1.1.1 netbsd-6-1-4-RELEASE:1.1.1.1 netbsd-6-0-5-RELEASE:1.1.1.1 tls-earlyentropy:1.2.0.2 tls-earlyentropy-base:1.2 riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.2 riastradh-drm2-base3:1.2 netbsd-6-1-3-RELEASE:1.1.1.1 netbsd-6-0-4-RELEASE:1.1.1.1 bind-9-9-5b1:1.1.1.1 netbsd-6-1-2-RELEASE:1.1.1.1 netbsd-6-0-3-RELEASE:1.1.1.1 netbsd-6-1-1-RELEASE:1.1.1.1 bind-9-9-3-P2:1.1.1.1 riastradh-drm2-base2:1.1.1.1 riastradh-drm2-base1:1.1.1.1 riastradh-drm2:1.1.1.1.0.16 riastradh-drm2-base:1.1.1.1 netbsd-6-1:1.1.1.1.0.22 netbsd-6-0-2-RELEASE:1.1.1.1 netbsd-6-1-RELEASE:1.1.1.1 khorben-n900:1.1.1.1.0.20 netbsd-6-1-RC4:1.1.1.1 netbsd-6-1-RC3:1.1.1.1 agc-symver:1.1.1.1.0.18 agc-symver-base:1.1.1.1 netbsd-6-1-RC2:1.1.1.1 netbsd-6-1-RC1:1.1.1.1 yamt-pagecache-base8:1.1.1.1 netbsd-6-0-1-RELEASE:1.1.1.1 yamt-pagecache-base7:1.1.1.1 bind-9-9-2-P1:1.1.1.1 matt-nb6-plus-nbase:1.1.1.1 yamt-pagecache-base6:1.1.1.1 netbsd-6-0:1.1.1.1.0.14 netbsd-6-0-RELEASE:1.1.1.1 netbsd-6-0-RC2:1.1.1.1 tls-maxphys:1.1.1.1.0.12 tls-maxphys-base:1.2 matt-nb6-plus:1.1.1.1.0.10 matt-nb6-plus-base:1.1.1.1 netbsd-6-0-RC1:1.1.1.1 bind-9-9-1-P1:1.1.1.1 yamt-pagecache-base5:1.1.1.1 yamt-pagecache-base4:1.1.1.1 netbsd-6:1.1.1.1.0.8 netbsd-6-base:1.1.1.1 yamt-pagecache-base3:1.1.1.1 yamt-pagecache-base2:1.1.1.1 yamt-pagecache:1.1.1.1.0.6 yamt-pagecache-base:1.1.1.1 bind-9-9-0a1:1.1.1.1 bind-9-8-0-P4:1.1.1.1 cherry-xenmp:1.1.1.1.0.4 cherry-xenmp-base:1.1.1.1 bind-9-8-0-P2:1.1.1.1 bind9-8-0rc1:1.1.1.1 bouyer-quota2-nbase:1.1.1.1 bouyer-quota2:1.1.1.1.0.2 bouyer-quota2-base:1.1.1.1 matt-mips64-premerge-20101231:1.1.1.1 bind-9-7-2-P3:1.1.1.1 bind-9-7-2b1:1.1.1.1 ISC:1.1.1; locks; strict; comment @# @; 1.2 date 2014.03.01.03.24.36; author christos; state dead; branches; next 1.1; commitid RTy1KyvIubCxEWqx; 1.1 date 2010.08.05.20.01.39; author christos; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2010.08.05.20.01.39; author christos; state Exp; branches 1.1.1.1.6.1 1.1.1.1.12.1; next ; 1.1.1.1.6.1 date 2014.05.22.15.43.11; author yamt; state dead; branches; next ; commitid qlg4WCl9yarq6yBx; 1.1.1.1.12.1 date 2014.08.19.23.46.24; author tls; state dead; branches; next ; commitid jTnpym9Qu0o4R1Nx; desc @@ 1.2 log @resolve conflicts; undo many local changes that have been done upstream differently. @ text @
zkt−ls — list dnskeys
zkt−ls −H
zkt−ls [−V|--view view] [−c file] [−l list] [−adefhkLprtz] [{keyfile|dir} ...]
zkt−ls
−T [−V|--view view]
[−c file] [−l list]
[−dhrz] [{keyfile|dir}
...]
zkt−ls −−list-trustedkeys
[−V|--view view] [−c
file] [−l list]
[−dhrz] [{keyfile|dir}
...]
zkt−ls
−K [−V|--view view]
[−c file] [−l list]
[−dhkrz] [{keyfile|dir}
...]
zkt−ls −−list-dnskeys
[−V|--view view] [−c
file] [−l list]
[−dhkrz] [{keyfile|dir}
...]
The zkt-ls command list all dnssec zone keys found in the given or predefined default directory. It is also possible to specify keyfiles (K*.key) as arguments. With option −r subdirectories will be searched recursively and all dnssec keys found are listed, sorted by domain name, key type and generation time. In that mode the use of option −p may be helpful to find the location of the keyfile in the directory tree.
Other forms of the command, print out keys in a format suitable for a trusted-key section (−T) or as a DNSKEY (−K) resource record.
−V view, −−view=view
Try to read the default configuration out of a file named dnssec-<view>.conf . Instead of specifying the −V or --view option every time, it is also possible to create a hard or softlink to the executable file to give it an additional name like zkt-ls-<view> .
−c file, −−config=file
Read default values from the specified config file. Otherwise the default config file is read or build in defaults will be used.
−O optstr, −−config-option=optstr
Set any config file option via the commandline. Several config file options could be specified at the argument string but have to be delimited by semicolon (or newline).
−l list, −−label=list
Print out information solely about domains given in the comma or space separated list. Take care of, that every domain name has a trailing dot.
−d, −−directory
Skip directory arguments. This will be useful in combination with wildcard arguments to prevent dnsssec-zkt to list all keys found in subdirectories. For example "zkt-ls -d *" will print out a list of all keys only found in the current directory. Maybe it is easier to use "zkt-ls ." instead (without -r set). The option works similar to the −d option of ls(1).
−L, −−left-justify
Print out the domain name left justified.
−k, −−ksk
Select and print key signing keys only (default depends on command mode).
−z, −−zsk
Select and print zone signing keys only (default depends on command mode).
−r, −−recursive
Recursive mode (default is
off).
Also settable in the dnssec.conf file (Parameter:
Recursive).
−p, −−path
Print pathname in listing mode. In -C mode, don’t create the new key in the same directory as (already existing) keys with the same label.
−a, −−age
Print age of key in weeks,
days, hours, minutes and seconds (default is off).
Also settable in the dnssec.conf file (Parameter:
PrintAge).
−f, −−lifetime
Print the key lifetime.
−e, −−exptime
Print the key expiration time.
−t, −−time
Print the key generation time
(default is on).
Also settable in the dnssec.conf file (Parameter:
PrintTime).
−h |
No header or trusted-key section header and trailer in -T mode |
−H, −−help
Print out the online help.
−T, −−list-trustedkeys
List all key signing keys as a named.conf trusted-key section. Use −h to supress the section header/trailer.
−K, −−list-dnskeys
List the public part of all the keys in DNSKEY resource record format. Use −h to suppress comment lines.
zkt−ls −r .
Print out a list of all zone keys found below the current directory.
zkt−ls −Z −c ""
Print out the compiled in default parameters.
zkt−ls −T ./zonedir/example.net
Print out a trusted-key section containing the key signing keys of "example.net".
zkt−ls --view intern
Print out a list of all zone keys found below the directory where all the zones of view intern live. There should be a seperate dnssec config file dnssec-intern.conf with a directory option to take affect of this.
zkt−ls−intern
Same as above. The binary file zkt−ls has another link, named zkt−ls−intern made, and zkt−ls examines argv[0] to find a view whose zones it proceeds to process.
ZKT_CONFFILE
Specifies the name of the default global configuration files.
/var/named/dnssec.conf
Built-in default global configuration file. The name of the default global config file is settable via the environment variable ZKT_CONFFILE.
/var/named/dnssec-<view>.conf
View specific global configuration file.
./dnssec.conf
Local configuration file (only used in −C mode).
Some of the
general options will not be meaningful in all of the command
modes.
The option −l and the ksk rollover options
insist on domain names ending with a dot.
Holger Zuleger
Copyright (c) 2005 − 2010 by Holger Zuleger. Licensed under the BSD Licences. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
dnssec-keygen(8),
dnssec-signzone(8), rndc(8), named.conf(5), zkt-conf(8),
zkt-keyman(8), zkt-signer(8)
RFC4641 "DNSSEC Operational Practices" by Miek
Gieben and Olaf Kolkman,
DNSSEC HOWTO Tutorial by Olaf Kolkman, RIPE NCC
(http://www.nlnetlabs.nl/dnssec_howto/)