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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
.\"
.\" zonec.8 -- zonec manual
.\"
.\" Copyright (c) 2001-2006, NLnet Labs. All rights reserved.
.\"
.\" See LICENSE for the license.
.\"
.\"
.Dd Oct 11, 2006
.Os FreeBSD
.Dt zonec 8
.Sh NAME
.Nm zonec
.Nd NSD Zone Compiler version 2.3.6.
.Sh SYNOPSIS
.Nm zonec
.Op Fl v
.Op Fl h
.Op Fl L
.Op Fl F
.Op Fl d Ar directory
.Op Fl o Ar origin
.Op Fl f Ar database
.Ar nsd.zones
.Sh DESCRIPTION
.Ic Zonec
is the
.Xr nsd 8
database compiler for creating name space databases from a set of
input master zone files specified in
.Ar nsd.zones
file.
.Pp
It is normally invoked via
.Xr nsdc 8
rebuild command.
.Ic Zonec
will then parse every zone in
.Ar nsd.zones
file and add it to the name space database,
.Pa /etc/nsd/nsd.db
by default, that is used by
.Xr nsd 8
to answer incoming queries.
.Pp
If
.Ar nsd.zones
file equals `-` then all zone information is read from stdin. Making constructs like:
.Ic cat zones* | ./zonec -f nsd.db -o example.net -
possible.
.Pp
The available options are:
.Bl -tag -width indent
.It Fl d Ar directory
Change the working directory to
.Ar directory
before doing any work.
.It Fl f Ar database
Create the specified
.Ar database
instead of the default
.Pa /etc/nsd/nsd.db
.It Fl o Ar origin
When reading from stdin use this as the first origin. When reading zone
from
.Pa nsd.zones
this option is ignored.
.It Fl v
Increase the verbosity of zonec. This flag can be specified multiple
times to increase the level of verbosity. The first level of
verbosity will print per zone summary information. The second level
of will print progress information for each 10,000 RRs processed.
.It Fl F
Set debug facilities. (If compiled with --enable-checking.)
.It Fl L
Set debug level. (If compiled with --enable-checking.)
.El
.Sh FILE FORMAT
The nsd.zones file is formatted as follows:
.TS
tab (@);
l l.
zone <zonename> <filename> [masters <IP>|<IP>|...]
zone <zonename> <filename> [notify <IP>|<IP>|...]
.TE
The first word on a line must be ``zone''. It indicates that the zone
should be loaded as authoritative data.
The second word is the name (origin) of the zone and the third word is the
pathname to the master zone file. If you use zonec with the -d option
the pathname may be relative to the NSD zones directory.
Optionally masters list-of-ip-addresses can be present to update the respective
zone with axfr from the given master servers. These servers will be tried in
order. This option is ignored by zonec and is only relevant for nsdc update.
Optionally a list-of-ip-addresses of server that must be notified when can be
present. This option is ignored by zonec and is only relevant for nsdc notify.
A typical example would be:
.TS
tab (@);
l l.
zone example.com primary/example.com
zone example.net secondary/example.net masters 10.1.1.1
.TE
The second line indicates that nsdc update should try to axfr the zone
example.net from the master server 10.1.1.1
Since NSD is primarily written to be run on the root name servers,
this file most likely to contain something like:
.TS
tab (@);
l l.
zone . root.zone
.TE
.Sh FILES
.Bl -tag -width indent
.It Pa /etc/nsd/nsd.db
default
.Ic NSD
database
.El
.Sh DIAGNOSTICS
.Ic zonec
will log all the problems via the standard error output and
progress via stdout if
.Fl v
option is specified.
.Sh SEE ALSO
.Xr nsd 8 ,
.Xr nsd-notify 8 ,
.Xr nsd-xfer 8 ,
.Xr nsdc 8
.Sh AUTHORS
.Ic NSD
was written by NLnet Labs and RIPE NCC joint team. Please see CREDITS file
in the distribution for further details.
.Sh BUGS
.Ic Zonec
has rather weak error diagnostics that will change in further versions.
.Ic Zonec
expects the input files to be free of syntax errors and very little
fool proof checks are done.
|
