- Decision
- ADR-199
- Date
- 2026-10-29
- Status
- ProposedProposed (the fix set is the owner's instruction of 2026-10-29; the choice of
MANAGE_USERSoverCREATE_USERSor a design that does not list users is the assistant's and open to the owner) - Mentions
- ADR-184, ADR-186, ADR-196
1Decision
Amend ADR-184, ADR-186 and ADR-196 after NET-009 and IMG-018 of lynx 2026102303 (the third image on which Compartments did not run). (1) The exit app holds MANAGE_USERS and no longer QUERY_USERS (manifest and privapp allowlist): the controller lists the users of the device to mask the apps of every user, and UserManager.getUserHandles is answered only for MANAGE_USERS or CREATE_USERS. The app calls no API that changes a user.
(2) exitd runs in the group vpn (1016) as well as inet, and the policy gives exitd create on its own tun_socket and exitd_route the message type RTM_SETLINK (system-sepolicy/0005). (3) The route helper reads an interface index with RTM_GETLINK on its netlink socket and not with if_nametoindex, so that its domain keeps no inet socket, as ADR-186 says (exitd 0e3d50b9...).
(4) No exit image is built before privacy/exit/tools/check-syscall-policy.py passes on the compiled policy and exit.rc and the static check of the app passes: the gate holds one row per operation that the two services perform, read from strace of the real binaries on a phone, and the static check lists the permission that each platform call of the app needs.
2Why and evidence
NET-009 result of 2026-10-29: [measured] the open of /dev/net/tun fails with EACCES for the daemon's groups, the denial create on tun_socket shows with the node opened, the helper sends RTM_SETLINK and opens four AF_INET sockets per apply, the controller ends in a SecurityException and sets no preference; [verified-in-source] UserManagerService.getUsers and ConnectivityService.setOemNetworkPreference on the build server. netd has allow netd self:tun_socket create for its tun [verified-in-source].
3Consequences
The gate and the static check would have failed on 2026102301 to 2026102303 for causes (1) to (3) and (5); a host test cannot see a group, an xperm number, a socket that a library call opens or a permission, so the gate rows are the record of what the services do. The row NET-009 stays FAIL until an image with these fixes runs.
4Review when
MANAGE_USERS lets a platform-signed persistent app manage users, which is more than it needs; CREATE_USERS is no narrower and a design without a user list would mask only the users that broadcasts announce. The gate covers startup, a Tor bootstrap and one apply of the route helper, not every later path (a failed bootstrap, many flows); a rule that only a later path needs shows on a device. The three denials of the optional rows stay in the log.
Read from docs/governance/decision-log.md, entry ADR-199.