README
changeset 78 5a21b5238fa9
parent 56 12e098a732ed
equal deleted inserted replaced
77:b0c0e3e80c39 78:5a21b5238fa9
     1 Manage DNS/bind9 zonefiles.
     1 Manage DNS/bind9 zonefiles.
     2 
     2 
     3 update:
     3 update:
     4     ./bin/update reads data from settings/, and generates zonefiles under zones/.
     4     ./bin/update reads data from settings/, and generates zonefiles under var/zones/.
     5 
     5 
     6     `update` also shows and commits changes in settings/ data.
     6     `update` also shows and commits changes in settings/ data.
     7 
     7 
     8     -d DIR
     8     -d DIR
     9         Do data operations under given dir-root, as opposed to CWD.
     9         Do data operations under given dir-root, as opposed to CWD.
    76     Acts as our configuration file, determining the data/zones layout below.
    76     Acts as our configuration file, determining the data/zones layout below.
    77 
    77 
    78 settings/:
    78 settings/:
    79     Input files, fed through update to generate files under zones/
    79     Input files, fed through update to generate files under zones/
    80 
    80 
    81     *.serial:
       
    82         Zone serial numbers for corresponding *.zone
       
    83 
       
    84     *.zone:
    81     *.zone:
    85         Zone header, passed through process-zone with `--serial *.serial` and any appropriate `--expand view=...`.
    82         Zone header, passed through process-zone with `--serial *.serial` and any appropriate `--expand view=...`.
    86 
    83 
    87         May include a view-based $INCLUDE to include different zone data for different views.
    84         May include a view-based $INCLUDE to include different zone data for different views.
    88 
    85 
    90         Include zonefiles, $INCLUDE'd from *.zone
    87         Include zonefiles, $INCLUDE'd from *.zone
    91 
    88 
    92     *.txt:
    89     *.txt:
    93         Hosts zone data, used to generate forwards/reverse -hosts zones
    90         Hosts zone data, used to generate forwards/reverse -hosts zones
    94 
    91 
    95 zones/:
    92 var/
    96     Output files, loaded by bind.
    93     Generated files.
    97 
    94 
    98     common/*
    95     zones/:
    99         Common zone files shared across views.
    96         Generated zonefiles, loaded by bind.
   100 
    97 
   101     hosts/*:$view
    98         common/*
   102         View-variant hosts zones generated from settings/*.txt
    99             Common zone files shared across views.
   103 
   100 
   104     hosts/*
   101         hosts/*:$view
   105         Host zones generated from settings/*.txt, may be used in some views but not others.
   102             View-variant hosts zones generated from settings/*.txt
   106 
   103 
   107     includes/*:$view
   104         hosts/*
   108         View-specific zone includes used from view/*.
   105             Host zones generated from settings/*.txt, may be used in some views but not others.
   109 
   106 
   110     includes/*.*
   107         includes/*:$view
   111         Zone includes used from view/*.
   108             View-specific zone includes used from view/*.
   112 
   109 
   113     $view/*
   110         includes/*.*
   114         Zone data for given zone/domain in given view
   111             Zone includes used from view/*.
   115 
   112 
   116     $view/* -> ...:
   113         $view/*
   117         Symlinked generic-zone data for some specific zone; either to common/* or $view/*.
   114             Zone data for given zone/domain in given view
   118 
   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