named-checkzone.8 3.49 KB
Newer Older
Rob Austein's avatar
regen  
Rob Austein committed
1 2 3
.\" Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
.\" Copyright (C) 2000-2002 Internet Software Consortium
.\" 
Mark Andrews's avatar
Mark Andrews committed
4 5 6
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
Rob Austein's avatar
regen  
Rob Austein committed
7
.\" 
Mark Andrews's avatar
Mark Andrews committed
8 9
.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
Rob Austein's avatar
regen  
Rob Austein committed
10
.\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
Mark Andrews's avatar
Mark Andrews committed
11 12 13 14
.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
Rob Austein's avatar
regen  
Rob Austein committed
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
.\" 
.hy 0
.ad l
.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "NAMED-CHECKZONE" 8 "June 13, 2000" "" ""
38 39
.SH NAME
named-checkzone \- zone file validity checking tool
Rob Austein's avatar
regen  
Rob Austein committed
40 41 42
.SH "SYNOPSIS"
.HP 16
\fBnamed\-checkzone\fR [\fB\-d\fR] [\fB\-j\fR] [\fB\-q\fR] [\fB\-v\fR] [\fB\-c\ \fIclass\fR\fR] [\fB\-k\ \fImode\fR\fR] [\fB\-n\ \fImode\fR\fR] [\fB\-o\ \fIfilename\fR\fR] [\fB\-t\ \fIdirectory\fR\fR] [\fB\-w\ \fIdirectory\fR\fR] [\fB\-D\fR] [\fB\-W\ \fImode\fR\fR] {zonename} {filename}
43 44
.SH "DESCRIPTION"
.PP
Rob Austein's avatar
regen  
Rob Austein committed
45
\fBnamed\-checkzone\fR checks the syntax and integrity of a zone file\&. It performs the same checks as \fBnamed\fR does when loading a zone\&. This makes \fBnamed\-checkzone\fR useful for checking zone files before configuring them into a name server\&.
46 47
.SH "OPTIONS"
.TP
Rob Austein's avatar
regen  
Rob Austein committed
48 49
\-d
Enable debugging\&.
50
.TP
Rob Austein's avatar
regen  
Rob Austein committed
51 52
\-q
Quiet mode \- exit code only\&.
53
.TP
Rob Austein's avatar
regen  
Rob Austein committed
54 55
\-v
Print the version of the \fBnamed\-checkzone\fR program and exit\&.
56
.TP
Rob Austein's avatar
regen  
Rob Austein committed
57 58
\-j
When loading the zone file read the journal if it exists\&.
Mark Andrews's avatar
Mark Andrews committed
59
.TP
Rob Austein's avatar
regen  
Rob Austein committed
60 61
\-c \fIclass\fR
Specify the class of the zone\&. If not specified "IN" is assumed\&.
62
.TP
Rob Austein's avatar
regen  
Rob Austein committed
63 64
\-k \fImode\fR
Perform \fB"check\-name"\fR checks with the specified failure mode\&. Possible modes are \fB"fail"\fR, \fB"warn"\fR (default) and \fB"ignore"\fR\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
65
.TP
Rob Austein's avatar
regen  
Rob Austein committed
66 67
\-n \fImode\fR
Specify whether NS records should be checked to see if they are addresses\&. Possible modes are \fB"fail"\fR, \fB"warn"\fR (default) and \fB"ignore"\fR\&.
Mark Andrews's avatar
Mark Andrews committed
68
.TP
Rob Austein's avatar
regen  
Rob Austein committed
69 70
\-o \fIfilename\fR
Write zone output to \fIfilename\fR\&.
Mark Andrews's avatar
Mark Andrews committed
71
.TP
Rob Austein's avatar
regen  
Rob Austein committed
72 73
\-t \fIdirectory\fR
chroot to \fIdirectory\fR so that include directives in the configuration file are processed as if run by a similarly chrooted named\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
74
.TP
Rob Austein's avatar
regen  
Rob Austein committed
75 76
\-w \fIdirectory\fR
chdir to \fIdirectory\fR so that relative filenames in master file $INCLUDE directives work\&. This is similar to the directory clause in \fInamed\&.conf\fR\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
77
.TP
Rob Austein's avatar
regen  
Rob Austein committed
78 79
\-D
Dump zone file in canonical format\&.
Mark Andrews's avatar
Mark Andrews committed
80
.TP
Rob Austein's avatar
regen  
Rob Austein committed
81 82
\-W \fImode\fR
Specify whether to check for non\-terminal wildcards\&. Non\-terminal wildcards are almost always the result of a failure to understand the wildcard matching algorithm (RFC 1034)\&. Possible modes are \fB"warn"\fR (default) and \fB"ignore"\fR\&.
Mark Andrews's avatar
regen  
Mark Andrews committed
83
.TP
Rob Austein's avatar
regen  
Rob Austein committed
84 85
zonename
The domain name of the zone being checked\&.
86
.TP
Rob Austein's avatar
regen  
Rob Austein committed
87 88
filename
The name of the zone file\&.
89 90
.SH "RETURN VALUES"
.PP
Rob Austein's avatar
regen  
Rob Austein committed
91
\fBnamed\-checkzone\fR returns an exit status of 1 if errors were detected and 0 otherwise\&.
92 93
.SH "SEE ALSO"
.PP
Rob Austein's avatar
regen  
Rob Austein committed
94
\fBnamed\fR(8), RFC 1035, BIND 9 Administrator Reference Manual\&.
95 96
.SH "AUTHOR"
.PP
Rob Austein's avatar
regen  
Rob Austein committed
97
Internet Systems Consortium