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. |
---|