contrib/bind9/bin/check/named-checkzone.8

   1 .\" Copyright (C) 2004-2007 Internet Systems Consortium, Inc. ("ISC")
   2 .\" Copyright (C) 2000-2003 Internet Software Consortium.
   3 .\"
   4 .\" Permission to use, copy, modify, and distribute this software for any
   5 .\" purpose with or without fee is hereby granted, provided that the above
   6 .\" copyright notice and this permission notice appear in all copies.
   7 .\"
   8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
   9 .\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  10 .\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  11 .\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  12 .\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  13 .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  14 .\" PERFORMANCE OF THIS SOFTWARE.
  15 .\"
  16 .\" $Id: named-checkzone.8,v 1.11.2.1.8.16 2007/06/20 02:26:23 marka Exp $
  17 .\"
  18 .hy 0
  19 .ad l
  20 .\"     Title: named\-checkzone
  21 .\"    Author:
  22 .\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/>
  23 .\"      Date: June 13, 2000
  24 .\"    Manual: BIND9
  25 .\"    Source: BIND9
  26 .\"
  27 .TH "NAMED\-CHECKZONE" "8" "June 13, 2000" "BIND9" "BIND9"
  28 .\" disable hyphenation
  29 .nh
  30 .\" disable justification (adjust text to left margin only)
  31 .ad l
  32 .SH "NAME"
  33 named\-checkzone \- zone file validity checking tool
  34 .SH "SYNOPSIS"
  35 .HP 16
  36 \fBnamed\-checkzone\fR [\fB\-d\fR] [\fB\-j\fR] [\fB\-q\fR] [\fB\-v\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-k\ \fR\fB\fImode\fR\fR] [\fB\-n\ \fR\fB\fImode\fR\fR] [\fB\-o\ \fR\fB\fIfilename\fR\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] [\fB\-w\ \fR\fB\fIdirectory\fR\fR] [\fB\-D\fR] {zonename} {filename}
  37 .SH "DESCRIPTION"
  38 .PP
  39 \fBnamed\-checkzone\fR
  40 checks the syntax and integrity of a zone file. It performs the same checks as
  41 \fBnamed\fR
  42 does when loading a zone. This makes
  43 \fBnamed\-checkzone\fR
  44 useful for checking zone files before configuring them into a name server.
  45 .SH "OPTIONS"
  46 .PP
  47 \-d
  48 .RS 4
  49 Enable debugging.
  50 .RE
  51 .PP
  52 \-q
  53 .RS 4
  54 Quiet mode \- exit code only.
  55 .RE
  56 .PP
  57 \-v
  58 .RS 4
  59 Print the version of the
  60 \fBnamed\-checkzone\fR
  61 program and exit.
  62 .RE
  63 .PP
  64 \-j
  65 .RS 4
  66 When loading the zone file read the journal if it exists.
  67 .RE
  68 .PP
  69 \-c \fIclass\fR
  70 .RS 4
  71 Specify the class of the zone. If not specified "IN" is assumed.
  72 .RE
  73 .PP
  74 \-k \fImode\fR
  75 .RS 4
  76 Perform
  77 \fB"check\-names"\fR
  78 checks with the specified failure mode. Possible modes are
  79 \fB"fail"\fR,
  80 \fB"warn"\fR
  81 (default) and
  82 \fB"ignore"\fR.
  83 .RE
  84 .PP
  85 \-n \fImode\fR
  86 .RS 4
  87 Specify whether NS records should be checked to see if they are addresses. Possible modes are
  88 \fB"fail"\fR,
  89 \fB"warn"\fR
  90 (default) and
  91 \fB"ignore"\fR.
  92 .RE
  93 .PP
  94 \-o \fIfilename\fR
  95 .RS 4
  96 Write zone output to
  97 \fIfilename\fR.
  98 .RE
  99 .PP
 100 \-t \fIdirectory\fR
 101 .RS 4
 102 Chroot to
 103 \fIdirectory\fR
 104 so that include directives in the configuration file are processed as if run by a similarly chrooted named.
 105 .RE
 106 .PP
 107 \-w \fIdirectory\fR
 108 .RS 4
 109 chdir to
 110 \fIdirectory\fR
 111 so that relative filenames in master file $INCLUDE directives work. This is similar to the directory clause in
 112 \fInamed.conf\fR.
 113 .RE
 114 .PP
 115 \-D
 116 .RS 4
 117 Dump zone file in canonical format.
 118 .RE
 119 .PP
 120 zonename
 121 .RS 4
 122 The domain name of the zone being checked.
 123 .RE
 124 .PP
 125 filename
 126 .RS 4
 127 The name of the zone file.
 128 .RE
 129 .SH "RETURN VALUES"
 130 .PP
 131 \fBnamed\-checkzone\fR
 132 returns an exit status of 1 if errors were detected and 0 otherwise.
 133 .SH "SEE ALSO"
 134 .PP
 135 \fBnamed\fR(8),
 136 \fBnamed\-checkconf\fR(8),
 137 RFC 1035,
 138 BIND 9 Administrator Reference Manual.
 139 .SH "AUTHOR"
 140 .PP
 141 Internet Systems Consortium
 142 .SH "COPYRIGHT"
 143 Copyright \(co 2004\-2007 Internet Systems Consortium, Inc. ("ISC")
 144 .br
 145 Copyright \(co 2000\-2003 Internet Software Consortium.
 146 .br