You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: LIMITATIONS.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,43 +4,43 @@
4
4
5
5
### Upstream / Vendor
6
6
7
-
- Upstream publishes source tarballs and installation instructions, not an official package repository. The latest published upstream tarball is `djbdns-1.05.tar.gz`.
8
-
- Upstream installation guidance requires a UNIX-like system plus `daemontools` 0.70 or later and `ucspi-tcp`, then a local compile and `make setup check`.
7
+
* Upstream publishes source tarballs and installation instructions, not an official package repository. The latest published upstream tarball is `djbdns-1.05.tar.gz`.
8
+
* Upstream installation guidance requires a UNIX-like system plus `daemontools` 0.70 or later and `ucspi-tcp`, then a local compile and `make setup check`.
9
9
10
10
### APT (Debian / Ubuntu)
11
11
12
-
- Debian still ships `djbdns` as a maintained source package and builds split binaries including `axfrdns`, `djbdns-conf`, `djbdns-utils`, `dnscache`, `rbldns`, `tinydns`, and `walldns`.
13
-
- Debian package pages for current and recent releases show distro-managed package availability for supported Debian architectures.
14
-
- Ubuntu still carries `djbdns` in the `universe` source package set. The cookbook's current package-install path is therefore most defensible on Debian-family platforms.
12
+
* Debian still ships `djbdns` as a maintained source package and builds split binaries including `axfrdns`, `djbdns-conf`, `djbdns-utils`, `dnscache`, `rbldns`, `tinydns`, and `walldns`.
13
+
* Debian package pages for current and recent releases show distro-managed package availability for supported Debian architectures.
14
+
* Ubuntu still carries `djbdns` in the `universe` source package set. The cookbook's current package-install path is therefore most defensible on Debian-family platforms.
15
15
16
16
### DNF / YUM (RHEL family)
17
17
18
-
- I did not find a primary-source upstream package repository for RHEL-family systems.
19
-
- Inference: the cookbook's source-install path remains the only installation path directly backed by upstream documentation for RHEL-family platforms.
18
+
* I did not find a primary-source upstream package repository for RHEL-family systems.
19
+
* Inference: the cookbook's source-install path remains the only installation path directly backed by upstream documentation for RHEL-family platforms.
20
20
21
21
### Zypper (SUSE)
22
22
23
-
- I did not find a primary-source upstream package repository for SUSE/openSUSE.
24
-
- Inference: source installation is also the only path clearly supported by upstream guidance on SUSE-family platforms.
23
+
* I did not find a primary-source upstream package repository for SUSE/openSUSE.
24
+
* Inference: source installation is also the only path clearly supported by upstream guidance on SUSE-family platforms.
25
25
26
26
## Architecture Limitations
27
27
28
-
- Upstream does not publish a tested architecture matrix; its guidance is source-build oriented rather than architecture-specific.
29
-
- Debian and Ubuntu package availability is distribution-managed and architecture-dependent. The cookbook should treat package installs as Debian-family specific, not universally portable.
28
+
* Upstream does not publish a tested architecture matrix; its guidance is source-build oriented rather than architecture-specific.
29
+
* Debian and Ubuntu package availability is distribution-managed and architecture-dependent. The cookbook should treat package installs as Debian-family specific, not universally portable.
30
30
31
31
## Source / Compiled Installation
32
32
33
33
### Build Dependencies
34
34
35
-
- Debian: compiler and build tools; upstream also requires `daemontools` and `ucspi-tcp`
36
-
- RHEL: compiler and build tools; upstream also requires `daemontools` and `ucspi-tcp`
37
-
- SUSE: compiler and build tools; upstream also requires `daemontools` and `ucspi-tcp`
35
+
* Debian: compiler and build tools; upstream also requires `daemontools` and `ucspi-tcp`
36
+
* RHEL: compiler and build tools; upstream also requires `daemontools` and `ucspi-tcp`
37
+
* SUSE: compiler and build tools; upstream also requires `daemontools` and `ucspi-tcp`
38
38
39
39
## Known Issues
40
40
41
-
- The cookbook's `install_method` heuristic is cookbook-local logic, not upstream vendor guidance.
42
-
- The cookbook metadata currently advertises platforms that are broader and older than the upstream/package evidence gathered here. Platform modernization should be handled explicitly and separately from this resource migration.
43
-
-`axfrdns` depends on `tcpserver` from `ucspi-tcp`, but the cookbook does not yet model that dependency as a first-class resource concern.
44
-
- Current Dokken integration coverage is still gated by the shared `runit` dependency rather than djbdns resource convergence. In this session:
41
+
* The cookbook's `install_method` heuristic is cookbook-local logic, not upstream vendor guidance.
42
+
* The cookbook metadata currently advertises platforms that are broader and older than the upstream/package evidence gathered here. Platform modernization should be handled explicitly and separately from this resource migration.
43
+
*`axfrdns` depends on `tcpserver` from `ucspi-tcp`, but the cookbook does not yet model that dependency as a first-class resource concern.
44
+
* Current Dokken integration coverage is still gated by the shared `runit` dependency rather than djbdns resource convergence. In this session:
45
45
Debian 12 failed because `runit::default` installs `runit-systemd` but then cannot start `runit.service`.
46
46
Ubuntu 24.04 failed earlier in convergence because `runit-systemd` had no install candidate.
Copy file name to clipboardExpand all lines: README.md
+46-46Lines changed: 46 additions & 46 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,78 +18,78 @@ This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of
18
18
19
19
The following platforms are supported via test kitchen.
20
20
21
-
- Ubuntu
22
-
- Debian
23
-
- RHEL
21
+
* Ubuntu
22
+
* Debian
23
+
* RHEL
24
24
25
25
It may work with or without modification on other platforms, particularly using the `source` install method.
26
26
27
27
## Chef
28
28
29
-
- Chef 15.3+
29
+
* Chef 15.3+
30
30
31
31
## Cookbooks
32
32
33
-
- build-essential - for compiling the source.
34
-
- ucspi-tcp - `tcpserver` is used by the axfr recipe.
35
-
- runit - for setting up the services.
33
+
* build-essential - for compiling the source.
34
+
* ucspi-tcp - `tcpserver` is used by the axfr recipe.
35
+
* runit - for setting up the services.
36
36
37
37
## Attributes
38
38
39
-
-`node['djbdns']['tinydns_ipaddress']` - listen address for public facing tinydns server
40
-
-`node['djbdns']['tinydns_internal_ipaddress']` - listen address for internal tinydns server
41
-
-`node['djbdns']['public_dnscache_ipaddress']` - listen address for public DNS cache
42
-
-`node['djbdns']['axfrdns_ipaddress']` - listen address for axfrdns
43
-
-`node['djbdns']['public_dnscache_allowed_networks']` - subnets that are allowed to talk to the dnscache.
44
-
-`node['djbdns']['tinydns_internal_resolved_domain']` - default domain this tinydns serves
45
-
-`node['djbdns']['tinydns_internal_resolved_reverse_domains']` - default in-addr.arpa domains this tinydns serves
46
-
-`node['djbdns']['axfrdns_dir']` - default location of the axfrdns service and configuration, default `/etc/djbdns/axfrdns`
47
-
-`node['djbdns']['tinydns_dir']` - default location of the tinydns service and configuration, default `/etc/djbdns/tinydns`
48
-
-`node['djbdns']['tinydns_internal_dir']` - default location of the tinydns internal service and configuration, default `/etc/djbdns/tinydns_internal`
49
-
-`node['djbdns']['public_dnscache_dir']` - default location of the public dnscache service and configuration, default `/etc/djbdns/public-dnscache`
50
-
-`node['djbdns']['bin_dir']` - default location where binaries will be stored.
51
-
-`node['djbdns']['axfrdns_uid']` - default uid for the axfrdns user
52
-
-`node['djbdns']['dnscache_uid']` - default uid for the dnscache user
53
-
-`node['djbdns']['dnslog_uid']` - default uid for the dnslog user
54
-
-`node['djbdns']['tinydns_uid']` - default uid for the tinydns user
55
-
-`node['djbdns']['package_name']` - name of the djbdns package. this shouldn't be changed most of the time, but may be necessary to use the [Debian fork](http://en.wikipedia.org/wiki/Dbndns), `dbndns`.
56
-
-`node['djbdns']['install_method']` - method used to install djbdns, can be `package`, or `source`.
39
+
*`node['djbdns']['tinydns_ipaddress']` - listen address for public facing tinydns server
40
+
*`node['djbdns']['tinydns_internal_ipaddress']` - listen address for internal tinydns server
41
+
*`node['djbdns']['public_dnscache_ipaddress']` - listen address for public DNS cache
42
+
*`node['djbdns']['axfrdns_ipaddress']` - listen address for axfrdns
43
+
*`node['djbdns']['public_dnscache_allowed_networks']` - subnets that are allowed to talk to the dnscache.
44
+
*`node['djbdns']['tinydns_internal_resolved_domain']` - default domain this tinydns serves
45
+
*`node['djbdns']['tinydns_internal_resolved_reverse_domains']` - default in-addr.arpa domains this tinydns serves
46
+
*`node['djbdns']['axfrdns_dir']` - default location of the axfrdns service and configuration, default `/etc/djbdns/axfrdns`
47
+
*`node['djbdns']['tinydns_dir']` - default location of the tinydns service and configuration, default `/etc/djbdns/tinydns`
48
+
*`node['djbdns']['tinydns_internal_dir']` - default location of the tinydns internal service and configuration, default `/etc/djbdns/tinydns_internal`
49
+
*`node['djbdns']['public_dnscache_dir']` - default location of the public dnscache service and configuration, default `/etc/djbdns/public-dnscache`
50
+
*`node['djbdns']['bin_dir']` - default location where binaries will be stored.
51
+
*`node['djbdns']['axfrdns_uid']` - default uid for the axfrdns user
52
+
*`node['djbdns']['dnscache_uid']` - default uid for the dnscache user
53
+
*`node['djbdns']['dnslog_uid']` - default uid for the dnslog user
54
+
*`node['djbdns']['tinydns_uid']` - default uid for the tinydns user
55
+
*`node['djbdns']['package_name']` - name of the djbdns package. this shouldn't be changed most of the time, but may be necessary to use the [Debian fork](http://en.wikipedia.org/wiki/Dbndns), `dbndns`.
56
+
*`node['djbdns']['install_method']` - method used to install djbdns, can be `package`, or `source`.
57
57
58
58
## Resources
59
59
60
60
This cookbook is mid-migration from recipe/attribute-driven behavior toward higher-level resources. The current resource-first surface is:
61
61
62
-
-`djbdns_install` - installs djbdns and bootstraps shared users/directories.
63
-
-`djbdns_server` - configures the public tinydns service.
64
-
-`djbdns_internal_server` - configures the internal tinydns service with explicit records or legacy data-bag/template inputs.
65
-
-`djbdns_cache` - configures the public dnscache service.
66
-
-`djbdns_axfr` - configures the axfrdns service that fronts an existing public tinydns directory.
67
-
-`djbdns_rr` - appends tinydns records inside an existing tinydns root.
62
+
*`djbdns_install` - installs djbdns and bootstraps shared users/directories.
63
+
*`djbdns_server` - configures the public tinydns service.
64
+
*`djbdns_internal_server` - configures the internal tinydns service with explicit records or legacy data-bag/template inputs.
65
+
*`djbdns_cache` - configures the public dnscache service.
66
+
*`djbdns_axfr` - configures the axfrdns service that fronts an existing public tinydns directory.
67
+
*`djbdns_rr` - appends tinydns records inside an existing tinydns root.
68
68
69
69
The legacy recipes `default`, `server`, `cache`, `internal_server`, and `axfr` are now compatibility wrappers around those resources.
70
70
71
71
### Resource Model Roadmap
72
72
73
-
-`djbdns_install`: shared install/bootstrap layer
74
-
-`djbdns_server`: public tinydns service
75
-
-`djbdns_internal_server`: internal tinydns service with explicit data-bag/template inputs
76
-
-`djbdns_cache`: public dnscache service
77
-
-`djbdns_axfr`: axfr service bound to an existing public tinydns instance
73
+
*`djbdns_install`: shared install/bootstrap layer
74
+
*`djbdns_server`: public tinydns service
75
+
*`djbdns_internal_server`: internal tinydns service with explicit data-bag/template inputs
76
+
*`djbdns_cache`: public dnscache service
77
+
*`djbdns_axfr`: axfr service bound to an existing public tinydns instance
78
78
79
79
## djbdns_rr
80
80
81
81
Adds a resource record for the specified FQDN.
82
82
83
83
### Actions
84
84
85
-
-`:add`: Creates a new entry in the tinydns data file with the `add-X` scripts in the tinydns root directory.
85
+
*`:add`: Creates a new entry in the tinydns data file with the `add-X` scripts in the tinydns root directory.
86
86
87
87
### Attribute Parameters
88
88
89
-
-`fqdn`: name attribute. specifies the fully qualified domain name of the record.
90
-
-`ip`: ip address for the record.
91
-
-`type`: specifies the type of entry. valid types are: alias, alias6, childns, host, host6, mx, and ns. default is `host`.
92
-
-`cwd`: current working directory where the add scripts and data files must be located. default is the node attribute `djbdns[:tinydns_internal_dir]`, usually `/etc/djbdns/tinydns-internal`.
89
+
*`fqdn`: name attribute. specifies the fully qualified domain name of the record.
90
+
*`ip`: ip address for the record.
91
+
*`type`: specifies the type of entry. valid types are: alias, alias6, childns, host, host6, mx, and ns. default is `host`.
92
+
*`cwd`: current working directory where the add scripts and data files must be located. default is the node attribute `djbdns[:tinydns_internal_dir]`, usually `/etc/djbdns/tinydns-internal`.
93
93
94
94
### Example
95
95
@@ -112,14 +112,14 @@ Compatibility wrapper for `djbdns_install`.
112
112
113
113
The default recipe attempts to install djbdns on as many platforms as possible. It tries to determine the platform's installation method:
114
114
115
-
- Debian will install from packages
116
-
- All other distributions will install from source.
115
+
* Debian will install from packages
116
+
* All other distributions will install from source.
117
117
118
118
Service specific users will be created as system users:
0 commit comments