33
|
1 |
Manage DNS/bind9 zonefiles.
|
|
2 |
|
|
3 |
update:
|
78
|
4 |
./bin/update reads data from settings/, and generates zonefiles under var/zones/.
|
33
|
5 |
|
|
6 |
`update` also shows and commits changes in settings/ data.
|
|
7 |
|
56
|
8 |
-d DIR
|
34
|
9 |
Do data operations under given dir-root, as opposed to CWD.
|
|
10 |
|
|
11 |
-q
|
56
|
12 |
Quiet. No log messages except errors.
|
34
|
13 |
|
|
14 |
-vDV
|
|
15 |
Increasing logging verbosity.
|
|
16 |
|
|
17 |
-p
|
56
|
18 |
Show diffs for changed output on stdout.
|
34
|
19 |
|
|
20 |
-F
|
|
21 |
Force-update output files, even if newer than input files.
|
|
22 |
|
|
23 |
-S
|
|
24 |
Do not generate new serials for zones.
|
|
25 |
|
56
|
26 |
-s
|
|
27 |
Generate new serials for all zones.
|
|
28 |
|
34
|
29 |
-n
|
|
30 |
Fake-update; show changes, but don't actually commit/deploy them.
|
|
31 |
|
56
|
32 |
Useful for testing.
|
|
33 |
|
34
|
34 |
-C
|
|
35 |
Do not commit source changes.
|
|
36 |
|
|
37 |
-c
|
|
38 |
Force-commit source changes, even though -n
|
|
39 |
|
56
|
40 |
-m MSG
|
34
|
41 |
Commit message for source changes; optional
|
|
42 |
|
33
|
43 |
bin/update-serial:
|
|
44 |
Increment DNS SOA record serials in the given .serial files.
|
|
45 |
|
|
46 |
Uses a YYYYMMDDXX format, but supports XX overflow.
|
|
47 |
|
|
48 |
bin/process-zone:
|
|
49 |
Read zonefile containing records, and generate any of:
|
|
50 |
|
|
51 |
--check-hosts:
|
|
52 |
Check for duplicate host names/IPs.
|
|
53 |
|
|
54 |
--forward-zone:
|
|
55 |
Generate additional TXT/MX records to supplement A/CNAME records.
|
|
56 |
|
|
57 |
--reverse-zone=NET
|
|
58 |
Generate PTR records for all matching A records.
|
|
59 |
|
|
60 |
--meta-zone:
|
|
61 |
Generate additional TXT records from zonefile metadata, read from:
|
|
62 |
|
|
63 |
hg annotate -q --date | ./bin/process-zone --input-line-date ...
|
|
64 |
|
|
65 |
bin/expand-zone:
|
|
66 |
Expand template vars in a zone textfile; does not parse records, just passes through lines.
|
|
67 |
|
|
68 |
Used to substitute e.g. `--serial .../foo.serial` values into SOA '{serial}' fields.
|
|
69 |
|
|
70 |
bin/update:
|
|
71 |
Runs update-serial/process-zone/expand-zone to keep various generated zones/views up-to-date with respect to
|
56
|
72 |
source files under settings/.
|
33
|
73 |
|
|
74 |
Also supports hg diff/commit/annotate integration with settings.
|
|
75 |
|
56
|
76 |
Acts as our configuration file, determining the data/zones layout below.
|
|
77 |
|
33
|
78 |
settings/:
|
|
79 |
Input files, fed through update to generate files under zones/
|
|
80 |
|
|
81 |
*.zone:
|
|
82 |
Zone header, passed through process-zone with `--serial *.serial` and any appropriate `--expand view=...`.
|
|
83 |
|
|
84 |
May include a view-based $INCLUDE to include different zone data for different views.
|
|
85 |
|
|
86 |
*.zone.*:
|
56
|
87 |
Include zonefiles, $INCLUDE'd from *.zone
|
33
|
88 |
|
|
89 |
*.txt:
|
|
90 |
Hosts zone data, used to generate forwards/reverse -hosts zones
|
|
91 |
|
78
|
92 |
var/
|
|
93 |
Generated files.
|
33
|
94 |
|
78
|
95 |
zones/:
|
|
96 |
Generated zonefiles, loaded by bind.
|
56
|
97 |
|
78
|
98 |
common/*
|
|
99 |
Common zone files shared across views.
|
56
|
100 |
|
78
|
101 |
hosts/*:$view
|
|
102 |
View-variant hosts zones generated from settings/*.txt
|
56
|
103 |
|
78
|
104 |
hosts/*
|
|
105 |
Host zones generated from settings/*.txt, may be used in some views but not others.
|
|
106 |
|
|
107 |
includes/*:$view
|
|
108 |
View-specific zone includes used from view/*.
|
|
109 |
|
|
110 |
includes/*.*
|
|
111 |
Zone includes used from view/*.
|
|
112 |
|
|
113 |
$view/*
|
|
114 |
Zone data for given zone/domain in given view
|
|
115 |
|
|
116 |
$view/* -> ...:
|
|
117 |
Symlinked generic-zone data for some specific zone; either to common/* or $view/*.
|
|
118 |
|
|
119 |
serials/*.serial
|
|
120 |
Zone serial numbers for corresponding zones/*/*.zone
|
|
121 |
|