b2333e8bca3d0041cfae4b13ff5324dd17357ff5
[hcoop/domtool2.git] / lib / domain.dtl
1 {{Configuring shared daemons with respect to a particular Internet domain name}}
2
3 extern type ip;
4 {{An IP address}}
5
6 extern type host;
7 {{A hostname; that is, (more or less) an alphanumeric string}}
8
9 extern type domain;
10 {{An Internet domain name}}
11
12 extern type your_domain;
13 {{A domain that you're allowed to configure}}
14
15 extern type node;
16 {{The name of a server controlled by domtool}}
17
18 extern type user;
19 extern type group;
20 {{UNIX users and groups that you're allowed to run as}}
21
22 extern type path;
23 {{A filesystem path that you're allowed to use}}
24
25 context Domain;
26 {{Configuration directives specific to an Internet domain}}
27
28 extern type serial;
29 {{Domain zone serial numbers}}
30 extern val serialAuto : serial;
31 {{Whenever DNS data changes, choose a sensible serial number automatically.}
32 extern val serialConst : int -> serial;
33 {{Use this particular serial number.}}
34
35 extern type soa;
36 {{DNS start-of-authority record}}
37 extern val soa : domain -> serial -> int -> int -> int -> int -> soa;
38
39 extern type master;
40 {{Information on the master DNS server for a domain}}
41 extern val externalMaster : ip -> master;
42 {{A server not controlled by domtool will serve as master.}}
43 extern val internalMaster : node -> master;
44 {{A server controlled by domtool will serve as master.}}
45
46 extern type dnsKind;
47 {{How should DNS for this domain be handled?}}
48 extern val useDns : soa -> master -> [node] -> dnsKind;
49 {{We do want DNS services for this domain. Specify the SOA record, information
50 on the server in charge of zone data, and a list of slave servers.}}
51 extern val noDns : dnsKind;
52 {{No DNS services for this domain.}}
53
54 extern val domain : your_domain -> Domain => [Root] {DNS : dnsKind, TTL : int};
55 {{Configure a domain to which you have access rights.}}