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