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