dnsimple/erldns
67.3
Adequate · 13 November 2026
8.7k
lines of production code
Erlang
primary language
8
measurements over time
What this system is
Features
Add documentation and sample zone files for DNSSEC support
Added a new ZONES.md guide explaining how to configure and load DNS zones in JSON or standard zonefile formats, including support for contexts and DNSSEC keys (RSA, ECDSA, Ed25519, Ed448). Included sample zone files (e.g., example.com.json) demonstrating various record types and DNSSEC key configurations to help users bootstrap and test their DNS setups.
priv/zones · high confidence
Added fake DNS responder and Scapy test examples
The \priv\ directory now includes \erldns\_fake\_responder.erl\, a new module that generates mock DNS responses for a wide range of record types (including A, AAAA, MX, TXT, DNSSEC, and others) to support testing or simulation scenarios. Additionally, \priv/scapy.txt\ has been added, providing Python Scapy script examples for constructing and sending raw DNS packets to a local server on port 8053, covering scenarios such as basic queries, truncated messages, and error conditions.
priv · high confidence
Introduce pluggable packet pipeline with asynchronous worker pool
DNS query processing is now handled by a configurable, sequential pipeline of modular pipe handlers (such as \erldns\_questions\, \erldns\_resolver\, and \erldns\_dnssec\) rather than a monolithic handler. This architecture allows for non-blocking, asynchronous execution of blocking operations via a dedicated \erldns\_async\_pool\ that uses CoDel for queue management, ensuring that listener workers are not stalled by slow tasks. The system includes built-in support for query throttling, packet caching, EDNS Extended DNS Errors (RFC 8914), and DNSSEC signing with NSEC type-mapper extensions, all orchestrated through a standardized \erldns\_pipeline\ behavior.
src/pipes · high confidence
New Admin API for DNS management and monitoring
This release introduces a new HTTP-based Admin API (default port 8083) that allows administrators to inspect and manage DNS zones and listener queues. The API provides endpoints to list all cached zones and their versions, retrieve detailed record information for specific zones (with an optional metadata-only mode), and delete zones from the cache. It also supports resetting all listener queues via a DELETE request on the root path. The API includes built-in Basic Authentication, configurable TLS support, and the ability to register custom middleware modules and additional routes for extensibility.
src/admin · high confidence
New zone generation and query generation scripts
Added a standalone Erlang escript (\scripts/generate\_zone.escript\) for generating JSON zone files compatible with erldns, supporting configurable record counts, parallel generation, and DNSSEC signing with multiple algorithms (RSA, ECDSA, Ed25519, Ed448). Also added \scripts/generate\_kxdpgun.escript\ to convert these JSON zone files into kxdpgun query format, and a BSD-specific CI script (\scripts/ci/bsd.sh\) that enforces OTP 28 or newer for socket tests. Also in this area: 2 commits (0 fixes) modifying scripts; Added zone cache benchmarking script.
scripts · medium confidence · unverified
Behavioural changes
DNS message record definitions removed from public include headers
The \include/nsrecs.hrl\ file, which previously exposed internal DNS protocol record definitions (such as \header\, \question\, and \message\) to external code, has been deleted. These definitions are no longer part of the public include interface, indicating a shift in how DNS message structures are handled internally versus externally.
include · high confidence
New TCP listener implementation with concurrency control and pipeline suspension
The TCP listener component has been replaced with a new implementation that introduces configurable concurrency limits (max\_concurrent\_queries) to prevent resource exhaustion, and supports pipeline suspension for non-blocking asynchronous operations. The new architecture includes dedicated modules for protocol handling, configuration, and request processing, featuring specific timeout controls (ingress, idle, request) and telemetry for dropped or delayed requests.
src/listeners/tcp · high confidence
New UDP listener implementation with load shedding and overrun reporting
The UDP listener has been replaced with a new architecture that introduces explicit load shedding and better observability. Incoming UDP packets are now managed by a worker pool (wpool) that enforces a configurable ingress timeout; when the system is under stress, excess requests are dropped and reported via telemetry and logs, including the raw payload in case of decode crashes. The acceptor layer now uses a cubic congestion control algorithm to dynamically adjust batch processing based on scheduler utilization, preventing overload. Additionally, the new implementation provides detailed overrun metrics, allowing operators to monitor and react to backpressure events more effectively.
src/listeners/udp · high confidence
New congestion control and queue management for UDP listeners
UDP listeners now include CoDel queue management (erldns\_codel.erl) to prevent bufferbloat and smarter congestion control algorithms (erldns\_cubic.erl) to adapt admission rates based on system stress. These changes improve network stability and reduce latency under heavy load by actively managing packet drops and adjusting processing speeds in response to congestion signals.
src/listeners · high confidence
Parallel zone loading with strict mode validation
The zone loading subsystem now supports parallel loading of zone files (JSON and BIND zonefile formats) via a new gen\_server-based worker architecture. This change introduces a 'strict' configuration mode: when enabled, the loader will fail the entire load operation if any individual zone file or key file contains errors or is missing, rather than silently skipping them. It also adds validation for configuration parameters such as format, timeout, and keys path, ensuring that invalid inputs are caught early during startup.
src/zones/load · high confidence
Project restructure and documentation overhaul
The repository has been restructured with a comprehensive documentation update, including new files for agent instructions (AGENTS.md), benchmarking (BENCHMARKING.md), design decisions (DESIGN.md), and a detailed changelog (CHANGELOG.md). The build system has been standardized on rebar3, with a new Makefile and rebar.config replacing legacy build artifacts like the Emakefile. Configuration is now managed via erldns.example.config, and linting/formatter rules have been added for markdown and YAML files. The project now requires Erlang/OTP 28 or newer and includes a Procfile for process management.
(repo-wide) · high confidence
Reimplemented zone loading, caching, and codec system
The zone management subsystem has been completely rewritten to improve performance, correctness, and extensibility. The new \erldns\_zone\_cache\ introduces a more efficient ETS-based storage structure with dedicated tables for zones, typed records, and sync counters, along with added telemetry events for zone put/delete operations. Zone data encoding and decoding are now handled by a unified, extensible codec system (\erldns\_zone\_codec\, \erldns\_zone\_encoder\, \erldns\_zone\_decoder\) that supports custom JSON parsers via registered modules and context-based record filtering. The zone loader (\erldns\_zones\) now supports both JSON and standard zone file formats with parallel loading capabilities, configurable timeouts, and strict error handling modes.
src/zones · high confidence
Replaced legacy UDP server with OTP application and configurable listeners
The legacy \server\ and \unpack\ modules have been removed and replaced with a proper OTP application structure (\erldns\_app\, \erldns\_sup\). The new implementation exposes \erldns:start\_listeners/0\ and \erldns:stop\_listeners/0\ to allow embedding applications to control when DNS listeners start, supporting an \autostart\_listeners\ configuration option. It also introduces \erldns\_config\ for cross-platform socket options (handling IPv6 dual-stack and \SO\_REUSEPORT\ nuances on FreeBSD/Linux/Windows) and exports \keyset\ and \zone\ types for external use.
src · high confidence
Test coverage
Comprehensive Common Test suite for DNS server components
Added a new Common Test (CT) suite covering the admin endpoint, AXFR transfers, configuration parsing, DNSSEC validation, EDNS/Extended Errors, listener behavior (UDP/TCP/TLS), packet caching, and pipeline execution. The suite includes a test helper module for managing peer nodes and ports, an example middleware for admin API testing, and TLS certificate/key fixtures for listener tests.
test · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 71 → 67 (-3.9)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 99 → 99 (+0.1)
- Architecture 87 → 96 (+9.2)
- Maturity 69 → 72 (+3.2)
- Readiness 71 → 77 (+6.2)
- Security 68 → 55 (-13.0)
- Performance 80 → 80 (+0.0)
Resolved (17)
- Change coupling: erldns_zone_decoder.erl ↔ erldns_zone_encoder.erl (src/zones/erldns_zone_decoder.erl)
- Duplicated block (8 lines × 2) (src/listeners/tcp/erldns_proto_tcp_request.erl)
- Leaked secret: private-key (priv/zones/example.com.json)
- Leaked secret: private-key (priv/zones/example.com.json)
- Leaked secret: private-key (priv/zones/example.com.json)
- Leaked secret: private-key (priv/zones/example.com.json)
- Leaked secret: private-key (priv/zones/example.com.json)
- Leaked secret: private-key (priv/zones/example.com.json)
- Leaked secret: private-key (priv/zones/example.com.json)
- Leaked secret: private-key (priv/zones/example.com.json)
- Leaked secret: private-key (priv/zones/example.com.json)
- Leaked secret: private-key (priv/zones/example.com.json)
- Medium CVE: EEF-[CVE redacted] (rebar.lock)
- No context/problem framing and no consequences/trade-offs for the three named decisions (DESIGN.md)
- Off-boarding risk: anonymized user #1
- Projects may be oversized for their cohesion
- Secret: private-key (priv/zones-example.json)
New (28)
- Change coupling: erldns_proto_tcp.erl ↔ erldns_proto_udp.erl (src/listeners/tcp/erldns_proto_tcp.erl)
- Edited copies of one member (3 members, 19+ corresponding lines) (src/listeners/udp/erldns_proto_udp.erl)
- Edited copies of one member (3 members, 3+ corresponding lines) (src/listeners/erldns_sch_mon.erl)
- Edited copies of one member (3 members, 7+ corresponding lines) (src/pipes/erldns_edns_ede.erl)
- Edited copies of one member (4 members, 3+ corresponding lines) (src/listeners/erldns_sch_mon.erl)
- Edited copies of one member (7 members, 8+ corresponding lines) (src/zones/erldns_zone_cache.erl)
- Edited copy of a member (10 corresponding lines) (src/zones/erldns_zone_cache.erl)
- Edited copy of a member (11 corresponding lines) (src/pipes/erldns_dnssec.erl)
- Edited copy of a member (11 corresponding lines) (src/zones/erldns_zone_cache.erl)
- Edited copy of a member (13 corresponding lines) (src/pipes/erldns_packet_cache.erl)
- Edited copy of a member (14 corresponding lines) (priv/erldns_fake_responder.erl)
- Edited copy of a member (15 corresponding lines) (src/admin/erldns_admin.erl)
- Edited copy of a member (15 corresponding lines) (src/listeners/tcp/erldns_proto_tcp_request.erl)
- Edited copy of a member (17 corresponding lines) (src/listeners/erldns_encoder.erl)
- Edited copy of a member (21 corresponding lines) (src/zones/load/erldns_zone_loader_getter.erl)
- Edited copy of a member (3 corresponding lines) (src/admin/erldns_admin_zone_handler.erl)
- Edited copy of a member (3 corresponding lines) (src/listeners/udp/erldns_proto_udp.erl)
- Edited copy of a member (4 corresponding lines) (src/listeners/tcp/erldns_proto_tcp.erl)
- Edited copy of a member (4 corresponding lines) (src/listeners/udp/erldns_proto_udp.erl)
- Edited copy of a member (45 corresponding lines) (src/pipes/erldns_pipeline.erl)
- …and 8 more
Changes since last survey
- 13 commits — 12 feature/other, 1 fixes
By area
- (root) — 8 commits
- src/pipes — 3 commits
- .github/workflows — 1 commit
- src/listeners — 1 commit
Notable commits
- fix: Fix missed hits and cached SERVFAILs in the packet cache (#397)
- change: Add put_rrset_sync_counter/4 for sources that go back on their counter (#407)
- change: Answer ANY at a wildcard CNAME with the CNAME (#405)
- change: Answer ANY minimally over UDP (RFC 8482) (#406)
- change: Bump cross-platform-actions/action from 1.6.0 to 1.7.0 in the actions-patch-minor group (#385)
- change: Check pipe dependencies fully, and allow optional ones (#400)
- change: Identify the server with NSID and id.server (#402)
- change: Stop reporting clients that leave during TCP init as errors (#404)
- change: Stop sending the query's EDNS options and records back (#401)
- change: Stop setting AD on authoritative answers (#398)
- change: Stop suspended queries along with the listeners (#386)
- change: Update dependencies (#388)
- change: Update deps and runtimes (#387)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
dnsimple/erldns was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 5c6a73d07dfd1318bcf0bbbb513c0ea4633d0cd8 — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.61+preprod-b8b1a43ae4c3.