README.md
changeset 644 c51eb0151fec
parent 634 8ec17e8d16c0
child 645 0467e1464cca
equal deleted inserted replaced
643:eda838f84366 644:c51eb0151fec
   281 Generated dhcpd.conf fragments, loaded by dhcpd.
   281 Generated dhcpd.conf fragments, loaded by dhcpd.
   282 
   282 
   283 ### `var/zones/`
   283 ### `var/zones/`
   284 Generated zonefiles, loaded by bind.
   284 Generated zonefiles, loaded by bind.
   285 
   285 
       
   286 # *pvl-dns*
       
   287 Low-level zonefile utilities.
       
   288 
       
   289 ## `bin/pvl.dns-process`
       
   290 Process a zonefile to modify:
       
   291 
       
   292 * `SOA` record serial
       
   293 * `$INCLUDE` paths
       
   294 
       
   295     $ cat etc/zones/test 
       
   296     $TTL 3600
       
   297 
       
   298     @                   SOA     foo.test. hostmaster.test. (
       
   299                                 0               ; serial
       
   300                                 1d              ; refresh
       
   301                                 5m              ; retry
       
   302                                 10d             ; expiry
       
   303                                 300             ; negative
       
   304                         )
       
   305 
       
   306                         NS      foo
       
   307                         NS      bar
       
   308 
       
   309     $INCLUDE "forward/test"
       
   310 
       
   311     $ bin/pvl.dns-process --serial $(date +%s) --include-path var/zones etc/zones/test 
       
   312     $TTL    3600
       
   313     @                                 SOA   foo.test. hostmaster.test. 1425049088 1d 5m 10d 300
       
   314                                       NS    foo
       
   315                                       NS    bar
       
   316     $INCLUDE        "var/zones/forward/test"
       
   317 
       
   318 ## `bin/pvl.dns-zone`
       
   319 Load a zonefile and output any ZoneRecords that it contains, including `$GENERATE`ed and `$INCLUDE`ed records:
       
   320 
       
   321     $ bin/pvl.dns-zone --zone=test var/zones/test 
       
   322     @                         3600    SOA   foo.test. hostmaster.test. 1425049248 1d 5m 10d 300
       
   323     @                         3600    NS    foo
       
   324     @                         3600    NS    bar
       
   325     foo                       3600    A     192.0.2.1
       
   326     bar                       3600    A     192.0.2.2
       
   327     quux.asdf                 3600    A     192.0.2.5
       
   328 
       
   329 
       
   330 Optionally `--check-hosts` for dupliates `A`/`AAAA` records.
       
   331 
       
   332 Use `--reverse-prefix=192.0.2` to generate a reverse-dns zone from `A`/`AAAA` records:
       
   333 
       
   334     $ bin/pvl.dns-zone --zone=test var/zones/test --reverse-prefix=192.0.2
       
   335     1                                 PTR   foo.test.
       
   336     2                                 PTR   bar.test.
       
   337     5                                 PTR   quux.asdf.test.
       
   338 
   286 # Experimental features 
   339 # Experimental features 
   287 
   340 
   288 Features that are still under development
   341 Features that are still under development
   289 
   342 
   290 * DHCP host status tracking from syslog/dhcpd.leases into a database 
   343 * DHCP host status tracking from syslog/dhcpd.leases into a database