| 1 | This is release 3.1.0 of the Hesiod name service library. Hesiod can |
|---|
| 2 | provide general name service for a variety of applications and is |
|---|
| 3 | based on the Berkeley Internet Name Daemon (BIND). |
|---|
| 4 | |
|---|
| 5 | To prepare this directory for building, run the command "./configure". |
|---|
| 6 | configure takes a number of options; use "./configure --help" to find |
|---|
| 7 | out what they are. Hesiod requires a vaguely ANSI compiler to build; |
|---|
| 8 | gcc will do. |
|---|
| 9 | |
|---|
| 10 | Run "make" or "make all" to build the Hesiod library. |
|---|
| 11 | |
|---|
| 12 | Run "make install" to install the Hesiod library. |
|---|
| 13 | |
|---|
| 14 | You will want to create a configuration file named hesiod.conf in the |
|---|
| 15 | sysconfdir (/usr/local/etc/hesiod.conf by default) on your client |
|---|
| 16 | machines, reading something like: |
|---|
| 17 | |
|---|
| 18 | rhs=.your.domain |
|---|
| 19 | lhs=.ns |
|---|
| 20 | |
|---|
| 21 | The value of rhs can be overridden at run time by the environment |
|---|
| 22 | variable HES_DOMAIN. The value ".ns" for lhs is an unfortunate |
|---|
| 23 | historical convention; ".hs" or "hesiod" would have been better. |
|---|
| 24 | Nevertheless, you probably want to use ".ns" for compatibility with |
|---|
| 25 | existing Hesiod domains. |
|---|
| 26 | |
|---|
| 27 | To create Hesiod information on your central name servers, you need to |
|---|
| 28 | make them authoritative for the domain ns.your.domain with a line in |
|---|
| 29 | named.boot reading something like: |
|---|
| 30 | |
|---|
| 31 | primary ns.your.domain named.hesiod |
|---|
| 32 | |
|---|
| 33 | And then in named.hesiod, you need data looking something like: |
|---|
| 34 | |
|---|
| 35 | ; SOA and NS records. |
|---|
| 36 | @ IN SOA server1.your.domain admin-address.your.domain ( |
|---|
| 37 | 40000 ; serial - database version number |
|---|
| 38 | 1800 ; refresh - sec servers |
|---|
| 39 | 300 ; retry - for refresh |
|---|
| 40 | 3600000 ; expire - unrefreshed data |
|---|
| 41 | 7200 ) ; min |
|---|
| 42 | NS server1.your.domain |
|---|
| 43 | NS server2.your.domain |
|---|
| 44 | |
|---|
| 45 | ; Actual Hesiod data. |
|---|
| 46 | haynes.grplist TXT "haynes:2638" |
|---|
| 47 | haynes.group TXT "haynes:*:2638:" |
|---|
| 48 | 2638.gid CNAME haynes.group |
|---|
| 49 | zephyr.sloc TXT "zephyrserver1.my.domain" |
|---|
| 50 | zephyr.sloc TXT "zephyrserver2.my.domain" |
|---|
| 51 | |
|---|
| 52 | There is a mailing list at MIT for Hesiod users, hesiod@mit.edu. To |
|---|
| 53 | get yourself on or off the list, send mail to hesiod-request@mit.edu. |
|---|
