ObliviOS Developer portal Project site

Home / Decisions / ADR-205

Amend ADR-200 and ADR-201 for three owner instructions of 2026-10-29.

Accepted, recorded 30 October 2026.

Decision
ADR-205
Date
2026-10-30
Status
AcceptedAccepted for (1) and (2) (the owner's instructions); (3) Accepted as a fix of NET-009; landed on the build server and module-built 2026-10-29, in lynx image 2026103001 (flashed 2026-10-30; NET-009 PARTIAL: the route helper writes its routes)
Mentions
ADR-200, ADR-201
Mentioned by
ADR-206

1Decision

Amend ADR-200 and ADR-201 for three owner instructions of 2026-10-29.

(1) Compartments must be searchable in Settings: the entry under Network & internet is a preference of the Settings app (packages-apps-Settings/0002, network_provider_internet.xml, with keywords such as tor, address, tracker, advertising, privacy) that starts ExitSettingsActivity by its component, and no longer a tile that the exit app injects (IA_SETTINGS), because the Settings search does not index tiles that other apps inject; ExitSettingsActivity is protected with NETWORK_SETTINGS like the page of one app; check-static.py fails a leftover tile.

(2) The pages are for a person who does not know the technology: "trackers" for advertising, analytics, attribution and crash-reporting hosts, the three stands of an app are Standard, Extra private and Off with a line under each, the status is "On", "Starting", "Paused" or "Not working yet" with a plain sentence, and the name of an exception is shown only on userdebug and eng builds; the consent text keeps its content in shorter sentences.

(3) The route helper may read the index of its interface: system-sepolicy/0006 gives exitd_route nlmsg_readpriv on its own route socket (RTM_GETLINK needs it on a kernel before 6.13); the gate row of exit-needs.tsv has it.

2Why and evidence

[verified-in-source] SettingsSearchIndexablesProvider.getInjectionIndexableRawData exists, and [measured] on lynx 2026102304 a search for Compartments, Atlas and Guardian gave no result while a search for Auto reboot did, so injected tiles are not found there (the cause was not found, a static preference needs none); [verified-in-source] private/net.te and private/recovery.te for the permission; [measured] the denial avc: denied { nlmsg_readpriv } ... exitd_route every 1 to 10 s on 2026102304, and check-syscall-policy.py failing on that policy and passing on the rebuilt one.

3Consequences

The entry is found by its name and by the words a person types; the pages read in plain words; the helper can set the routes.

4Review when

(3) lets the helper read link data, MAC addresses included, which apps may not; the helper has no network socket and no exit other than the control socket of the daemon. The consent text was read and approved by the owner on 2026-10-23 and is changed in wording: the owner reads it again before the image. Atlas and Guardian are apps with no Settings page and are not searchable in Settings; the owner asked for them too, and a row for each is a separate decision (where it goes).

Read from docs/governance/decision-log.md, entry ADR-205.