← Back to branch summary

~andreserl/ubuntu/lucid/bind9/bind9-apport-533601

« back to all changes in this revision

Viewing changes to bin/check/named-checkzone.8

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2006-01-05 12:29:28 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060105122928-oih7ttkkmpb90q8q
Tags: 1:9.3.2-1
* New upstream
* use lsb-base for start/stop messages in init.d.
* switch to debhelper 4

Show diffs side-by-side

added added

removed removed

Lines of Context:
bin/check/named-checkzone.8
1
 
.\" Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
2
 
.\" Copyright (C) 2000-2002  Internet Software Consortium.
3
 
.\"
 
1
.\" Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
 
2
.\" Copyright (C) 2000-2002 Internet Software Consortium.
 
3
.\" 
4
4
.\" Permission to use, copy, modify, and distribute this software for any
5
5
.\" purpose with or without fee is hereby granted, provided that the above
6
6
.\" copyright notice and this permission notice appear in all copies.
7
 
.\"
 
7
.\" 
8
8
.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
9
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,
 
10
.\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
11
11
.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
12
12
.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
13
13
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
14
14
.\" PERFORMANCE OF THIS SOFTWARE.
15
15
.\"
16
 
.\" $Id: named-checkzone.8,v 1.11.2.1.8.4 2004/06/03 05:35:42 marka Exp $
 
16
.\" $Id: named-checkzone.8,v 1.11.2.1.8.8 2005/10/13 02:33:41 marka Exp $
17
17
.\"
18
 
.TH "NAMED-CHECKZONE" "8" "June 13, 2000" "BIND9" ""
19
 
.SH NAME
20
 
named-checkzone \- zone file validity checking tool
21
 
.SH SYNOPSIS
22
 
.sp
23
 
\fBnamed-checkzone\fR [ \fB-d\fR ]  [ \fB-j\fR ]  [ \fB-q\fR ]  [ \fB-v\fR ]  [ \fB-c \fIclass\fB\fR ]  [ \fB-k \fImode\fB\fR ]  [ \fB-n \fImode\fB\fR ]  [ \fB-o \fIfilename\fB\fR ]  [ \fB-t \fIdirectory\fB\fR ]  [ \fB-w \fIdirectory\fB\fR ]  [ \fB-D\fR ]  \fBzonename\fR \fBfilename\fR
 
18
.hy 0
 
19
.ad l
 
20
.\" ** You probably do not want to edit this file directly **
 
21
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 
22
.\" Instead of manually editing it, you probably should edit the DocBook XML
 
23
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
 
24
.TH "NAMED\-CHECKZONE" "8" "June 13, 2000" "BIND9" "BIND9"
 
25
.\" disable hyphenation
 
26
.nh
 
27
.\" disable justification (adjust text to left margin only)
 
28
.ad l
 
29
.SH "NAME"
 
30
named\-checkzone \- zone file validity checking tool
 
31
.SH "SYNOPSIS"
 
32
.HP 16
 
33
\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}
24
34
.SH "DESCRIPTION"
25
35
.PP
26
 
\fBnamed-checkzone\fR checks the syntax and integrity of
27
 
a zone file. It performs the same checks as \fBnamed\fR
 
36
\fBnamed\-checkzone\fR
 
37
checks the syntax and integrity of a zone file. It performs the same checks as
 
38
\fBnamed\fR
28
39
does when loading a zone. This makes
29
 
\fBnamed-checkzone\fR useful for checking zone
30
 
files before configuring them into a name server.
 
40
\fBnamed\-checkzone\fR
 
41
useful for checking zone files before configuring them into a name server.
31
42
.SH "OPTIONS"
32
43
.TP
33
 
\fB-d\fR
 
44
\-d
34
45
Enable debugging.
35
46
.TP
36
 
\fB-q\fR
37
 
Quiet mode - exit code only.
 
47
\-q
 
48
Quiet mode \- exit code only.
38
49
.TP
39
 
\fB-v\fR
40
 
Print the version of the \fBnamed-checkzone\fR
 
50
\-v
 
51
Print the version of the
 
52
\fBnamed\-checkzone\fR
41
53
program and exit.
42
54
.TP
43
 
\fB-j\fR
 
55
\-j
44
56
When loading the zone file read the journal if it exists.
45
57
.TP
46
 
\fB-c \fIclass\fB\fR
 
58
\-c \fIclass\fR
47
59
Specify the class of the zone. If not specified "IN" is assumed.
48
60
.TP
49
 
\fB-k \fImode\fB\fR
50
 
Perform \fB"check-name"\fR checks with the specified failure mode.
51
 
Possible modes are \fB"fail"\fR,
52
 
\fB"warn"\fR (default) and
53
 
\fB"ignore"\fR.
54
 
.TP
55
 
\fB-n \fImode\fB\fR
56
 
Specify whether NS records should be checked to see if they
57
 
are addresses. Possible modes are \fB"fail"\fR,
58
 
\fB"warn"\fR (default) and
59
 
\fB"ignore"\fR.
60
 
.TP
61
 
\fB-o \fIfilename\fB\fR
62
 
Write zone output to \fIdirectory\fR.
63
 
.TP
64
 
\fB-t \fIdirectory\fB\fR
65
 
chroot to \fIdirectory\fR so that include
66
 
directives in the configuration file are processed as if
67
 
run by a similarly chrooted named.
68
 
.TP
69
 
\fB-w \fIdirectory\fB\fR
70
 
chdir to \fIdirectory\fR so that relative
71
 
filenames in master file $INCLUDE directives work. This
72
 
is similar to the directory clause in
 
61
\-k \fImode\fR
 
62
Perform
 
63
\fB"check\-name"\fR
 
64
checks with the specified failure mode. Possible modes are
 
65
\fB"fail"\fR,
 
66
\fB"warn"\fR
 
67
(default) and
 
68
\fB"ignore"\fR.
 
69
.TP
 
70
\-n \fImode\fR
 
71
Specify whether NS records should be checked to see if they are addresses. Possible modes are
 
72
\fB"fail"\fR,
 
73
\fB"warn"\fR
 
74
(default) and
 
75
\fB"ignore"\fR.
 
76
.TP
 
77
\-o \fIfilename\fR
 
78
Write zone output to
 
79
\fIfilename\fR.
 
80
.TP
 
81
\-t \fIdirectory\fR
 
82
chroot to
 
83
\fIdirectory\fR
 
84
so that include directives in the configuration file are processed as if run by a similarly chrooted named.
 
85
.TP
 
86
\-w \fIdirectory\fR
 
87
chdir to
 
88
\fIdirectory\fR
 
89
so that relative filenames in master file $INCLUDE directives work. This is similar to the directory clause in
73
90
\fInamed.conf\fR.
74
91
.TP
75
 
\fB-D\fR
 
92
\-D
76
93
Dump zone file in canonical format.
77
94
.TP
78
 
\fBzonename\fR
 
95
zonename
79
96
The domain name of the zone being checked.
80
97
.TP
81
 
\fBfilename\fR
 
98
filename
82
99
The name of the zone file.
83
100
.SH "RETURN VALUES"
84
101
.PP
85
 
\fBnamed-checkzone\fR returns an exit status of 1 if
86
 
errors were detected and 0 otherwise.
 
102
\fBnamed\-checkzone\fR
 
103
returns an exit status of 1 if errors were detected and 0 otherwise.
87
104
.SH "SEE ALSO"
88
105
.PP
89
106
\fBnamed\fR(8),
90
 
\fIRFC 1035\fR,
91
 
\fIBIND 9 Administrator Reference Manual\fR.
 
107
RFC 1035,
 
108
BIND 9 Administrator Reference Manual.
92
109
.SH "AUTHOR"
93
110
.PP
94
111
Internet Systems Consortium