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 

     8 bin/update-serial:

     9     Increment DNS SOA record serials in the given .serial files.

    10 

    11     Uses a YYYYMMDDXX format, but supports XX overflow.

    12 

    13 bin/process-zone:

    14     Read zonefile containing records, and generate any of:

    15 

    16     --check-hosts:

    17         Check for duplicate host names/IPs.

    18 

    19     --forward-zone:

    20         Generate additional TXT/MX records to supplement A/CNAME records.

    21 

    22     --reverse-zone=NET

    23         Generate PTR records for all matching A records.

    24 

    25     --meta-zone:

    26         Generate additional TXT records from zonefile metadata, read from:

    27 

    28             hg annotate -q --date | ./bin/process-zone --input-line-date ...

    29 

    30 bin/expand-zone:

    31     Expand template vars in a zone textfile; does not parse records, just passes through lines.

    32 

    33     Used to substitute e.g. `--serial .../foo.serial` values into SOA '{serial}' fields.

    34 

    35 bin/update:

    36     Runs update-serial/process-zone/expand-zone to keep various generated zones/views up-to-date with respect to

    37     source files under settings/

    38 

    39     Also supports hg diff/commit/annotate integration with settings.

    40 

    41 settings/:

    42     Input files, fed through update to generate files under zones/

    43 

    44     *.serial:

    45         Zone serial numbers for corresponding *.zone

    46 

    47     *.zone:

    48         Zone header, passed through process-zone with `--serial *.serial` and any appropriate `--expand view=...`.

    49 

    50         May include a view-based $INCLUDE to include different zone data for different views.

    51 

    52     *.zone.*:

    53         Additional common zone data; copied to zones/, and $INCLUDE'd from *.zone.

    54 

    55     *.txt:

    56         Hosts zone data, used to generate forwards/reverse -hosts zones

    57 

    58 zones/:

    59     Output files, loaded by bind.

    60 

    61     *.zone:

    62         View-independent zone headers with expanded serial.

    63 

    64     *.zone.hosts:

    65         View-independent generated zones for hosts.

    66 

    67     *.zone.$view:

    68         Per-view copied zone data.

    69 

    70     *.zone.*:

    71         Additional view-independent copied zone data.

    72 

    73     $view/*.zone:

    74         Per-view zone header with expanded $INCLUDE:s and serial.

    75 

    76     $view/*.zone.hosts:

    77         Per-view generated zones for hosts.

    78 

    79     $view/*.zone -> .../$.zone:

    80         Symlinked generic-zone data for some specific zone; either view-specific or view-independent.

    81