.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DTCK 1"
.TH DTCK 1 2023-07-29 "perl v5.38.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dtck \- Check the DNSSEC\-Tools data files for sanity.
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\&  dtck [options] [dtck_config_file]
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdtck\fR checks DNSSEC-Tools data files to determine if the entries are valid.
\&\fBdtck\fR checks the validity of DNSSEC-Tools configuration files, \fIrollrec\fR
files, and \fIkeyrec\fR files.  It does not perform the file checking itself,
but runs checking programs specific to each type of data file.
.PP
A \fBdtck\fR configuration file is consulted to determine the files to check.
This file lists the DNSSEC-Tools data files and their types.  If a \fBdtck\fR
configuration file is not given on the command line, \fBdtck\fR will only check
the DNSSEC-Tools configuration file.  This is equivalent to running
\&\fBdtconfchk\fR directly.
.SH "DTCK CONFIGURATION FILE"
.IX Header "DTCK CONFIGURATION FILE"
A \fBdtck\fR configuration file contains a list of the files to be checked by
\&\fBdtck\fR.  Except for comments, each line has the following format:
.PP
.Vb 1
\&    keyword file directory
.Ve
.PP
\&\fIkeyword\fR is one of "config", "rollrec", or "keyrec".
\&\fIfile\fR is the pathname of the file to be checked.
\&\fIdirectory\fR is the name of the directory that holds \fIfile\fR and is optional.
.PP
The \fBdtck\fR configuration file contains the following types of records:
.IP \fBconfig\fR 4
.IX Item "config"
These lines define the DNSSEC-Tools configuration files that will be checked.
The \fBdtconfchk\fR program will be used to verify these files.
.IP \fBrollrec\fR 4
.IX Item "rollrec"
These lines define the \fIrollrec\fR files that will be checked.
The \fBrollchk\fR program will be used to verify these files.
.IP \fBkeyrec\fR 4
.IX Item "keyrec"
These lines define the \fIkeyrec\fR files that will be checked.
The \fBkrfcheck\fR program will be used to verify these files.
.IP comments 4
.IX Item "comments"
Any lines starting with an octothorpe (#) are comment lines and are ignored.
.SH OPTIONS
.IX Header "OPTIONS"
\&\fBdtck\fR takes two types of options.  Options of the first type are handled 
directly by \fBdtck\fR, controlling its output and processing.  Options of the
second type are passed to the file-checking programs and are not further
handled by \fBdtck\fR.
.SS "Options Handled by \fBdtck\fP"
.IX Subsection "Options Handled by dtck"
.IP \fB\-defcon\fR 4
.IX Item "-defcon"
This option directs \fBdtck\fR to add the default DNSSEC-Tools configuration
file to the list of configuration files to be checked.
.IP \fB\-list\fR 4
.IX Item "-list"
The names of the files will be listed as they are checked.
.IP \fB\-pretty\fR 4
.IX Item "-pretty"
Clarifying output is added to the output from \fBdtck\fR and the
file-checking programs.
.IP \fB\-help\fR 4
.IX Item "-help"
Display a usage message.
.SS "Options Not Handled by \fBdtck\fP"
.IX Subsection "Options Not Handled by dtck"
.IP \fB\-count\fR 4
.IX Item "-count"
The file-checking programs will display a final error count.
.IP \fB\-quiet\fR 4
.IX Item "-quiet"
No output will be given by the file-checking program.
.IP \fB\-verbose\fR 4
.IX Item "-verbose"
Verbose output will be given by the file-checking program.
.IP \fB\-Version\fR 4
.IX Item "-Version"
Displays the version information for \fBdtck\fR and the DNSSEC-Tools package.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright 2007\-2014 SPARTA, Inc.  All rights reserved.
See the COPYING file included with the DNSSEC-Tools package for details.
.SH AUTHOR
.IX Header "AUTHOR"
Wayne Morrison, tewok@tislabs.com
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdtconfchk\|(8)\fR,
\&\fBkrfcheck\|(8)\fR,
\&\fBrollchk\|(8)\fR
.PP
\&\fBdnssec\-tools.conf\|(5)\fR,
\&\fBkeyrec\|(5)\fR,
\&\fBrollrec\|(5)\fR