.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" 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 .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' '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 turned on, 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. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "DT-VALIDATE 1" .TH DT-VALIDATE 1 "2013-02-27" "perl v5.14.3" "User Commands" .\" 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" dt\-validate \- Query the Domain Name System and display results of the DNSSEC validation process .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& dt\-validate [options] DOMAIN_NAME .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBdt-validate\fR is a diagnostic tool built on top of the \s-1DNSSEC\s0 validator. It takes \fI\s-1DOMAIN_NAME\s0\fR as an argument and queries the \s-1DNS\s0 for that domain name. It outputs the series of responses that were received from the \s-1DNS\s0 and the \&\s-1DNSSEC\s0 validation results for each domain name. An examination of the queries and validation results can help an administrator uncover errors in \s-1DNSSEC\s0 configuration of \s-1DNS\s0 zones. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\-c \fI\s-1CLASS\s0\fR, \-\-class=\fI\s-1CLASS\s0\fR" 4 .IX Item "-c CLASS, --class=CLASS" This option can be used to specify the \s-1DNS\s0 class of the Resource Record queried. If this option is not given, the default class \&\fB\s-1IN\s0\fR is used. .IP "\-h, \-\-help" 4 .IX Item "-h, --help" Display the help and exit. .IP "\-p, \-\-print" 4 .IX Item "-p, --print" Print the answers and validation results. By default, \fBdt-validate\fR just outputs a series of responses and their validation results on \&\fIstderr\fR. When the \fI\-p\fR option is used, \fBdt-validate\fR will also output the final result on \fIstdout\fR. .IP "\-t \fI\s-1TYPE\s0\fR, \-\-type=\fI\s-1TYPE\s0\fR" 4 .IX Item "-t TYPE, --type=TYPE" This option can be used to specify the \s-1DNS\s0 type of the Resource Record queried. If this option is not given, \fBdt-validate\fR will query for the \&\fBA\fR record for the given \fI\s-1DOMAIN_NAME\s0\fR. .IP "\-v \fI\s-1FILE\s0\fR, \-\-dnsval\-conf=\fI\s-1FILE\s0\fR" 4 .IX Item "-v FILE, --dnsval-conf=FILE" This option can be used to specify the location of the \fBdnsval.conf\fR configuration file. .IP "\-r \fI\s-1FILE\s0\fR, \-\-resolv\-conf=\fI\s-1FILE\s0\fR" 4 .IX Item "-r FILE, --resolv-conf=FILE" This option can be used to specify the location of the \fBresolv.conf\fR configuration file containing the name servers to use for lookups. .IP "\-i \fI\s-1FILE\s0\fR, \-\-root\-hints=\fI\s-1FILE\s0\fR" 4 .IX Item "-i FILE, --root-hints=FILE" This option can be used to specify the location of the root.hints configuration file, containing the root name servers. This is only used when no name server is found, and \fBdt-validate\fR must do recursive lookups itself. .IP "\-S \fIsuite\fR[:\fIsuite\fR], \-\-test\-suite=\fIsuite\fR[:\fIsuite\fR]" 4 .IX Item "-S suite[:suite], --test-suite=suite[:suite]" This option specifies the test suite (or range of test suites) to use for the internal tests. .IP "\-s, \-\-selftest" 4 .IX Item "-s, --selftest" This option can be used to specify that the application should perform its self tests using names from the configured test-suite. .IP "\-T \fInumber\fR[:\fInumber\fR], \-\-testcase=\fInumber\fR[:\fInumber\fR]" 4 .IX Item "-T number[:number], --testcase=number[:number]" This option can be used to run a specific test (or range of tests) from the test suite. .IP "\-F \fIfile\fR, \-\-testcase\-conf=\fIfile\fR" 4 .IX Item "-F file, --testcase-conf=file" This option is used to specify the file containing the test cases. .IP "\-l \fIlabel\fR, \-\-label=\fIlabel\fR" 4 .IX Item "-l label, --label=label" This option can be used to specify the policy from within the \fIdnsval.conf\fR file to use during validation. .IP "\-w \fIseconds\fR, \-\-wait=\fIseconds\fR" 4 .IX Item "-w seconds, --wait=seconds" This option can be used to run the queries specified by other flags in a loop, with the specified interval between successive queries. .IP "\-o, \-\-output=:[:]" 4 .IX Item "-o, --output=:[:]" is 1\-7, corresponding to syslog levels ALERT-DEBUG is one of file, net, syslog, stderr, stdout depends on file: (opened in append mode) net[::] (127.0.0.1:1053 syslog[:facility] (0\-23 (default 1 \s-1USER\s0)) .SH "PRE-REQUISITES" .IX Header "PRE-REQUISITES" \&\fBlibval\fR .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright 2005\-2013 \s-1SPARTA\s0, Inc. All rights reserved. See the \s-1COPYING\s0 file included with the DNSSEC-Tools package for details. .SH "AUTHORS" .IX Header "AUTHORS" Abhijit Hayatnagarkar, Suresh Krishnaswamy, Robert Story .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fI\fIsyslog\fI\|(3)\fR .PP \&\fB\f(BIlibval\fB\|(3)\fR .PP http://www.dnssec\-tools.org