File: dlint.1

package info (click to toggle)
dlint 1.4.0-8
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 236 kB
  • sloc: sh: 1,173; makefile: 94; perl: 89
file content (104 lines) | stat: -rw-r--r-- 3,279 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
.TH DLINT 1 "18 July 1998"
.SH NAME
dlint \- Internet Domain Name System (DNS) error checking utility
.SH SYNOPSIS
.B dlint
[
.B \-n
]
.I zone
.SH DESCRIPTION
DNS administrators can use
.B dlint
to scan recursively through the domain records of the fully-qualified
zone
.IR zone ,
to get a report on any errors therein.
You can scan a zone you own, or anyone else's zone on the Internet.
.B dlint
talks directly to a primary or secondary nameserver for the zone,
to make sure it's working with up-to-date information.
.LP
.I dlint
also suggests ways of fixing problems instead of just complaining
about them like other debugging tools.
.LP
The argument
.I zone
should always have an ending period to indicate it is a
fully qualified domain name.
.SH OPTIONS
By default,
.B dlint
recursively traverses the entire hierarchy below the zone specified.
The
.B \-n
option may be used to disable recursive traversal, causing it to
only examine the records in the given zone.
Note that a zone may or may not contain any number of sub-domains
(all of which will be checked with or without this option).
.SH EXAMPLES
.IP
.B example% dlint nau.edu.
.LP
recursively scans the DNS records in zone nau.edu for problems.
.IP
.B example% dlint 64.114.134.in-addr.arpa.
.LP
recursively scans the DNS records associated with IP subnet 134.114.64.0 for problems.
You had to already know that 134.114.0.0 was subnetted.
.SH DIAGNOSTICS
The output from
.B dlint
is computer parsable, each line has a special meaning.
Lines beginning with a semicolon (;) are comments only.
Lines beginning with the phrase ``WARNING'' are useful information
that you should consider.
A warning is not necessarily an error,
but may be a problem.
Lines beginning with the phrase ``ERROR'' are definite errors
and should be dealt with accordingly.
.SH "EXIT STATUS"
.IP 0
Successful run, no problems encountered with zone.
.IP 1
Successful run, worst problem with zone was a WARNING.
.IP 2
Successful run, worst problem with zone was an ERROR.
.IP 3
Usage error.
.IP 4
A signal interrupted the program run
(i.e. user typed interrupt key sequence).
.SH BUGS
.B Dlint
doesn't work behind some firewalls because it needs to talk to a
root nameserver to get started.
.LP
.B Dlint
uses the zone transfer mechanism (AXFR) which some nameservers deny to
unauthorized hosts.
.LP
Other nameservers happily return zero records instead of an error,
in response to an unauthorized AXFR!
That is just wrong.
.SH AUTHOR
Paul Balyoz <pab@domtools.com>
.SH DISTRIBUTION
http://www.domtools.com/
.SH COPYRIGHT
Copyright (C) 1993-1998 Paul A. Balyoz <pab@domtools.com>
.LP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.LP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.LP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.