- Decision
- ADR-223
- Date
- 2026-11-10
- Status
- ProposedProposed (generator, importer and tests on branch
masklist-easylistoffreeholdos-platform, commitsf4fba7d,d529f59,9e0c3aa,8d80561, not pushed, not merged; 2026-11-10: the 32-bit change is written and host-tested in the daemon (freeholdos-servicesbranchmasklist-easylist,7beab16: control protocol version 5, 262144 rows,MAX_FILE16 MiB, 293 + 7 + 1 tests and 93 of 93 mutations on the build server), the exit app and the resolver (freeholdos-platform803e1a4; the app holds an id in an int and refuses one past 31 bits; resolver patch0002; 116 of 116 and 62 of 62 mutants killed; differential check 0 mismatches); landed on the build server on 2026-11-10 on the owner's word:packages/modules/DnsResolver725a7c0(patch 0002) andvendor/freeholdos/exit45cd0d5(the app files andexitdddf5ddd4…, built from7beab16, two builds identical); type-checks of the app (41 files) and the resolver pass; no module build, no image, no device run; the shipped list of 91,609 rows (90,732 masked, 877 protected, 4,166,795 bytes; EasyPrivacy and EasyList version202611101626archived by hash on the build server;onelink.medenied; the 3,699 rows of the classifier part unchanged) is made infreeholdos-platformdafd344and landed on the build server on 2026-11-10 on the owner's yes asvendor/freeholdos/exit9f8070f(copied withrsync -c, a dry-run after the copy empty, thesha256equal to the record), with the app limit of 16 MiB; the images already flashed carry 16-bit ids and 8192 rows) - Mentions
- ADR-158, ADR-181, ADR-186
- Mentioned by
- ADR-225
1Decision
The mask list of Compartments takes the whole-host rules (\|\|host^) of EasyPrivacy and EasyList as a fourth rule beside the three of ADR-186, and grows from 3,699 to about 91,500 rows.
A listed host is masked unless a row of the classifier, the deny list or the allow list is at or above it: a protected row shields everything below it, so no platform domain (google.com, microsoft.com, youtube.com) is masked as a whole, only a dedicated host below it such as vortex.data.microsoft.com.
The company of such a host is the host itself, and a name over 64 bytes is cut at the left, so a long attacker-chosen host cannot show as the name of a trusted one. Company ids and the row limit move to 32 bits and 262144 rows in the generator, the daemon, the resolver and the exit app; the control protocol is version 5 (a company is four bytes).
The largest list file is 16 MiB in the daemon and the resolver (4 MiB no longer holds 262144 rows; the list is 4.2 MB at 91,573 rows), and the exit app holds a company id in an int and refuses an id past 31 bits, which the ids of the generator (up to 262144) never reach (owner, 2026-11-10, on both). Rejected: a long company id in the exit app (about 40 signatures changed for ids that cannot occur).
The importer is privacy/exit/tools/import-easylist.py: it takes only a rule that names one host with no condition (no path, wildcard, domain=, negated or unknown option), drops the host and what is below it for an exception without a site condition, drops only that host for a conditional one, and ignores page exceptions (generichide and the like). Amends ADR-186 (D-E, first scope, and the limit of 8192 rows) and the source choice of ADR-158.
Rejected: the Block List Project (its lists sync with Hagezi, GPL-3.0, and other upstreams per its UPSTREAM_MONITORING.md; its list header says MIT, its licence file says Unlicense; rule 2 of classifier/SOURCES.md refuses a source whose licence cannot be read per entry); one shared company id for the tail beyond 65,535 (a choice for one failing host would unmask the whole tail for that app); the registrable domain as company (tenants of pages.dev, b-cdn.net and github.io would be one company); putting the hosts in classifier.tsv (the device parser takes 20,000 lines).
2Why and evidence
Owner, 2026-11-10: the limit of 8192 is too small; the list may grow far past it and be filtered to real trackers; \"google.com whole would make the phone unusable\"; only progress, no regression; chose EasyPrivacy and EasyList and 32-bit ids everywhere.
[measured 2026-11-10] EasyPrivacy and EasyList 202611101405 hold 47,324 and 44,193 whole-host block rules; the importer keeps 91,309 hosts, 88,208 of them not yet covered; the generator then gives 91,573 rows, 90,697 masked (was 3,699 and 2,823), 4,165,116 bytes, with every earlier row unchanged.
A refreshed AdGuard database (71d126a, the classifier is built from 0b4655c) adds 0 services; its importer skips 215 domains that have no company (108 advertising, 40 analytics, 21 pornvertising among them), not yet taken. The Block List Project has 114,103 (tracking) and 130,888 (ads) registrable domains, almost all absent from the classifier, with microsoft.com, apple.com and xiaomi.com among them.
Against the owner's Data Map export from stallion 2026110503 (1,349 services of 48 apps, 1,134 of category unknown): 30 services become wholly masked that were not (23 rotating-domain advertising hosts of one app, geoedge.be, onelink.me, clevertap-prod.com, plausible.io, confiant-integrations.net, ns1p.net); none serves content [assumption], because the export holds service keys and no host.
Tests: test-import-easylist.py passes, also on the real lists, 8 of 8 final mutations killed (20 of 20 in the round before the page-exception change); test-make-mask-list.py passes with 70,000 hosts above id 65,535, long host names and the rows of every earlier rule unchanged.
Licence read on easylist.to/pages/licence.html: GPL-3.0-or-later or CC BY-SA 3.0 or later; taking the host list under CC BY-SA 4.0 like the classifier is the author's reading and has had no licence review.
3Consequences
About 90,000 names in the memory of exitd (limit 160 MiB) and a list file past 4 MiB: neither measured; the id file grows by about 88,000 lines; the exit app stores a choice per host. A masked tracker host can still be one that an app waits for; the notification and the user's choice of ADR-181 section 4.4 stay the safety net.
Still to do before it ships (the 32-bit change in the daemon, the resolver and the exit app is done, and so are onelink.me on the deny list, the data file, the shipped list, NOTICE and SOURCE.md, see the status cell): the licence review of the step from CC BY-SA 3.0 to 4.0 for the EasyList hosts; the 1,808 listed hosts that lie under a protected row (skipped by default) read by the owner; what the resolver does with a list the daemon refuses (not read).
Rows MSK-013 and MSK-014.
4Review when
Memory of exitd above its limit or a lookup cost the owner sees; a regression found by MSK-013; the licence review finds the CC BY-SA 3.0 to 4.0 step not allowed, or EasyList changes its licence; an upstream change of the rule syntax that the importer counts as a wrong shape in bulk.
Read from docs/governance/decision-log.md, entry ADR-223.