contrib/bind-9.3/bin/check/named-checkzone.8

   1 .\" Copyright (C) 2004-2006 Internet Systems Consortium, Inc. ("ISC")
   2 .\" Copyright (C) 2000-2002 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.11 2006/10/05 02:50:17 marka Exp $
  17 .\"
  18 .hy 0
  19 .ad l
  20 .\"     Title: named\-checkzone
  21 .\"    Author:
  22 .\" Generator: DocBook XSL Stylesheets v1.70.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 .TP 3n
  47 \-d
  48 Enable debugging.
  49 .TP 3n
  50 \-q
  51 Quiet mode \- exit code only.
  52 .TP 3n
  53 \-v
  54 Print the version of the
  55 \fBnamed\-checkzone\fR
  56 program and exit.
  57 .TP 3n
  58 \-j
  59 When loading the zone file read the journal if it exists.
  60 .TP 3n
  61 \-c \fIclass\fR
  62 Specify the class of the zone. If not specified "IN" is assumed.
  63 .TP 3n
  64 \-k \fImode\fR
  65 Perform
  66 \fB"check\-names"\fR
  67 checks with the specified failure mode. Possible modes are
  68 \fB"fail"\fR,
  69 \fB"warn"\fR
  70 (default) and
  71 \fB"ignore"\fR.
  72 .TP 3n
  73 \-n \fImode\fR
  74 Specify whether NS records should be checked to see if they are addresses. Possible modes are
  75 \fB"fail"\fR,
  76 \fB"warn"\fR
  77 (default) and
  78 \fB"ignore"\fR.
  79 .TP 3n
  80 \-o \fIfilename\fR
  81 Write zone output to
  82 \fIfilename\fR.
  83 .TP 3n
  84 \-t \fIdirectory\fR
  85 chroot to
  86 \fIdirectory\fR
  87 so that include directives in the configuration file are processed as if run by a similarly chrooted named.
  88 .TP 3n
  89 \-w \fIdirectory\fR
  90 chdir to
  91 \fIdirectory\fR
  92 so that relative filenames in master file $INCLUDE directives work. This is similar to the directory clause in
  93 \fInamed.conf\fR.
  94 .TP 3n
  95 \-D
  96 Dump zone file in canonical format.
  97 .TP 3n
  98 zonename
  99 The domain name of the zone being checked.
 100 .TP 3n
 101 filename
 102 The name of the zone file.
 103 .SH "RETURN VALUES"
 104 .PP
 105 \fBnamed\-checkzone\fR
 106 returns an exit status of 1 if errors were detected and 0 otherwise.
 107 .SH "SEE ALSO"
 108 .PP
 109 \fBnamed\fR(8),
 110 RFC 1035,
 111 BIND 9 Administrator Reference Manual.
 112 .SH "AUTHOR"
 113 .PP
 114 Internet Systems Consortium
 115 .SH "COPYRIGHT"
 116 Copyright \(co 2004\-2006 Internet Systems Consortium, Inc. ("ISC")