1

= pvl-hosts =

     2

     3

DNS/DHCP hosts management/integration for ISC bind9 and dhcpd.

     4

     5

Also includes network SNMP discovery.

     6

     7

== Hosts ==

     8

The `pvl.hosts-* etc/hosts/test` tools read hosts files as input, which have an ini format, using section names as hostnames to configure attributes for that host:

     9

    10

    [foo]

    13

    14

    [bar]

    17

    18

The default mechanism uses the basename of the given config file as the domain name, so this example file would generate something like the following output for use in a `zone "test" { ... }` zonefile:

    19

    20

    $ pvl.hosts-dns --forward-zone=test etc/hosts/test

    21

    foo                               A     127.0.0.1

    22

    bar                               A     127.0.0.2

    23

    24

And correspondingly, the reverse zone for 127.0.0.0/8:

    25

    26

    $ pvl.hosts-dns --reverse-zone=127 etc/hosts/test

    27

    1.0.0                             PTR   foo.test.

    28

    2.0.0                             PTR   bar.test.

    29

    45

=== Generated hosts ===

    46

The hosts file format supports something similar to bind9's $GENERATE directive for hosts:

    47

    48

    [asdf{1-3}]

    49

        ip  = 10.100.100.$

    50

    51

    $ bin/pvl.hosts-dns --forward-zone=asdf etc/hosts/asdf 

    52

    asdf1@asdf                        A     10.100.100.1

    53

    asdf2@asdf                        A     10.100.100.2

    54

    asdf3@asdf                        A     10.100.100.3

    55

    56

Note that the generate directives are interpreted and compiled directly by pvl.hosts. 

    57

    58

Most of the $GENERATE options should be supported, with a little clever hackery:

    59

    60

    [asdf{1-5/2}{0,2}]

    61

       ip  = 10.100.100.$${10}

    62

    63

    $ bin/pvl.hosts-dns --forward-zone=asdf2 etc/hosts/asdf2

    64

    asdf01@asdf2                      A     10.100.100.11

    65

    asdf03@asdf2                      A     10.100.100.13

    66

    asdf05@asdf2                      A     10.100.100.15

    67

    68

This feature can be used for generating reverse delegations:

    69

    70

    [foo-{240-247}]

    71

        forward =

    72

        reverse = $.240/29.0.0.10.in-addr.arpa

    73

        ip      = 10.0.0.$

    74

    75

    $ bin/pvl.hosts-dns --reverse-zone=10 etc/hosts/reverse 

    76

    240.0.0                           CNAME 240.240/29.0.0.10.in-addr.arpa.

    77

    241.0.0                           CNAME 241.240/29.0.0.10.in-addr.arpa.

    78

    242.0.0                           CNAME 242.240/29.0.0.10.in-addr.arpa.

    79

    243.0.0                           CNAME 243.240/29.0.0.10.in-addr.arpa.

    80

    244.0.0                           CNAME 244.240/29.0.0.10.in-addr.arpa.

    81

    245.0.0                           CNAME 245.240/29.0.0.10.in-addr.arpa.

    82

    246.0.0                           CNAME 246.240/29.0.0.10.in-addr.arpa.

    83

    247.0.0                           CNAME 247.240/29.0.0.10.in-addr.arpa.