Basic client/server thing going on with unencrypted OpenSSL
[hcoop/zz_old/domtool2-proto.git] / lib / domain.dtl
CommitLineData
51c32b45 1{{Configuring shared daemons with respect to a particular Internet domain name}}
2
697d1a52 3extern type no_spaces;
4{{Any string with no space characters}}
5
0279185b 6extern type no_newlines;
7{{Any string with no newline characters}}
8
85af7d3e 9extern type ip;
10{{An IP address}}
11
12extern type host;
13{{A hostname; that is, (more or less) an alphanumeric string}}
14
51c32b45 15extern type domain;
16{{An Internet domain name}}
17
4e8a3f2b 18extern type your_domain;
19{{A domain that you're allowed to configure}}
20
69d98465 21extern type your_domain_host;
22{{Some host (as a fully-qualified domain name) in one of your domains}}
23
668e333e 24extern type node;
25{{The name of a server controlled by domtool}}
26
00e4345d 27extern type user;
28extern type group;
29{{UNIX users and groups}}
30
d68ab27c 31extern type your_user;
32extern type your_group;
4e8a3f2b 33{{UNIX users and groups that you're allowed to run as}}
34
d68ab27c 35extern type your_path;
36{{A filesystem path that you're allowed to use.
37 The set of permitted values is generated from a set of roots by closing it
38 under the subdirectory relation.}}
4e8a3f2b 39
51c32b45 40context Domain;
41{{Configuration directives specific to an Internet domain}}
42
85af7d3e 43extern type serial;
44{{Domain zone serial numbers}}
45extern val serialAuto : serial;
46{{Whenever DNS data changes, choose a sensible serial number automatically.}
47extern val serialConst : int -> serial;
48{{Use this particular serial number.}}
49
50extern type soa;
51{{DNS start-of-authority record}}
52extern val soa : domain -> serial -> int -> int -> int -> int -> soa;
53
94a7e258 54val defaultSoa = soa "ns.hcoop.net" serialAuto 172800 900 1209600 3600;
55
668e333e 56extern type master;
57{{Information on the master DNS server for a domain}}
58extern val externalMaster : ip -> master;
59{{A server not controlled by domtool will serve as master.}}
60extern val internalMaster : node -> master;
61{{A server controlled by domtool will serve as master.}}
62
85af7d3e 63extern type dnsKind;
64{{How should DNS for this domain be handled?}}
668e333e 65extern val useDns : soa -> master -> [node] -> dnsKind;
66{{We do want DNS services for this domain. Specify the SOA record, information
67 on the server in charge of zone data, and a list of slave servers.}}
85af7d3e 68extern val noDns : dnsKind;
668e333e 69{{No DNS services for this domain.}}
85af7d3e 70
4e8a3f2b 71extern val domain : your_domain -> Domain => [Root] {DNS : dnsKind, TTL : int};
51c32b45 72{{Configure a domain to which you have access rights.}}