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

zkt-ls

NAME
SYNOPSYS
DESCRIPTION
GENERAL OPTIONS
COMMAND OPTIONS
SAMPLE USAGE
ENVIRONMENT VARIABLES
FILES
BUGS
AUTHORS
COPYRIGHT
SEE ALSO

NAME

zkt−ls — list dnskeys

SYNOPSYS

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} ...]

DESCRIPTION

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.

GENERAL OPTIONS

−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

COMMAND OPTIONS

−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.

SAMPLE USAGE

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.

ENVIRONMENT VARIABLES

ZKT_CONFFILE

Specifies the name of the default global configuration files.

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).

BUGS

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.

AUTHORS

Holger Zuleger

COPYRIGHT

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.

SEE ALSO

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/)


@ 1.1 log @Initial revision @ text @@ 1.1.1.1 log @Import bind 9.7.2b1 @ text @@ 1.1.1.1.12.1 log @Rebase to HEAD as of a few days ago. @ text @@ 1.1.1.1.6.1 log @sync with head. for a reference, the tree before this commit was tagged as yamt-pagecache-tag8. this commit was splitted into small chunks to avoid a limitation of cvs. ("Protocol error: too many arguments") @ text @@