zkt-ls(8)

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 -M [-V|--view view] [-c file] [-l list] [-dhrz] [{keyfile|dir} ...]
zkt-ls --list-managedkeys [-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- or managed-key section (-Tor-M) 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 resp. managed-key section header and trailer in -T or -M 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/etc/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/etc/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/)