Files
MobileGL/docs/Disaggregated/notes/p11/INTEGRATOR-DECISIONS-P11.md
T

27 lines
18 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# P11 集成者裁定日志(persistent map 与 ≥16 MiB 采纳)
> 形式沿用 [`../p10/INTEGRATOR-DECISIONS-P10.md`](../p10/INTEGRATOR-DECISIONS-P10.md):一条裁定一个 ID,只记「定了什么、为什么、影响哪些文件」。计划见 [`PLAN-P11.md`](PLAN-P11.md),协议见 `MobileGL/MG_Remote/CONTRACT-P11.md`。
| ID | 日期 | 裁定 | 理由 | 影响 |
|---|---|---|---|---|
| ID-P11-1 | 2026-09-29 | 范围按计划 §1 重划:`gPipeInputs` 版本化(P5e / P5f 已落地)与 T1(两台设备上只有 Adreno Vulkan 可用)关闭;`completedFrameSerial` 生命周期与探针选档并入 B;路线图的采纳基线(163 → 21 ms / 40 → 115 fps / ~400 MB)撤下,由 A4 同会话重测替代,性能与 RSS 只记录。 | 逐项核对 `74ae652e` 的树(审计 `~/w7/notes/p11/AUDIT-P11.md`);基线没有构建号、设备、臂与定频记录,115 疑为 vsync 封顶。 | `PLAN-P11.md` |
| ID-P11-2 | 2026-09-29 | **B 排期**,消费者是同一台设备上从其他 app 里启动的 GL 程序(Termux 一类,用户)。顺序 B0(跨 app 通道探针)→ B1(外部 client 的共享内存数据面)→ B2(T0)。B0 的 client 按用户的说法用 retrace client 实现:先是 adb shell 里跑的可执行文件,再是另一个 app 里的 retrace client;不走 Termux 的路子,通道不通时的后备是 server app 自己的 bound Service。 | 这类 client 今天只能走 TCP loopback(Stream),T0 在上面不可能;P10 实测 rd12 tcp 51 fps 对 shm 120 fps,数据面本身就是最大的收益。 | `PLAN-P11.md` §2 B |
| ID-P11-3 | 2026-09-29 | A1 的形状:不改线上格式。Stream 上两侧都是一行 `Refuse{AdoptTierOnStream}` 然后 T2;共享段上 client 在握手期 `Fatal{UnimplementedAdoptTier}`,server 只警告并服务 T2(档位由 client 定,server 端 Fatal 在 fork 模式下会抢在 client 的具名诊断之前);使用处的 Fatal 留给没有经过握手的调用者。 | 每一侧只判自己的旋钮就够,不需要把档位带过线;`ServerSpawn` 本来就剔除子进程的 `MOBILEGL_IPC_*`(审计 F-K4"spawn 下晚死"不成立,实际是静默 T2)。 | `Transport/AdoptTier.cpp`、`ClientSession.cpp`、`ServerSession.cpp`、`PersistentMapTracker.cpp`、`fatal_census.py` |
| ID-P11-4 | 2026-09-29 | A2 的负控改用"split 车道声明 adopted"(两后端 8 条红);计划里"删 `PipeApply.cpp` 的 R-6 拒绝"那条 red-once 不成立,不用。Magma 同时进 `Arena.` 带状块与 Buffers 车道,两处都留;`.AdoptTier0.` 只登记 tcp(`spawn_lane_parity.py` 的 `MAGMA_TCP_ONLY`)。 | split 下采纳请求经线路走,codec 不调 applier 就答 DECLINED,删 applier 的拒绝什么也不改变。 | `LargeArenaAdoptionScenario.cpp`、`MG_IntegrationTest/CMakeLists.txt`、`spawn_lane_parity.py`、`test.yml` |
| ID-P11-5 | 2026-09-29 | `protocol.fbs:43` 那行把 `Adopt = 6` 写成 T1 形状的注释不改。 | `protocol_revision_pin.py` 对整个文件取哈希,改注释就要升修订号;档位定义以 `design/07` 与 `CONTRACT-P11.md` 为准。 | 无 |
| ID-P11-6 | 2026-09-29 | **合并 dev `c60639db`**(`568090f0` 重铸读回、`8966d5c2` 转换层的局部上传、`b1d60523` Magma 清除后上传排序、`c60639db` Magma `eglSwapInterval`),合并提交 `e0102bad` 加五个跟进提交。规则:句柄臂只在上传字节是未转换的层时才用记录里携带的行 / 片步长(`carriedLayoutApplies`),转换过的层用转换缓冲自己的每纹素字节(强制旧行为的探针在 push 单进程与三臂 8 条红);push 单进程臂上 dev 的重铸丢了一个待上传的 `glTexSubImage`(client 发射时就清了脏标记),修为同时合并 applier 的待上传框(`48a30602`,合并头上红、修后绿);dev 的两个新场景登记到两后端的 Split / Spawn / Tcp(split 侧无需修);`TextureRemintPullScenario` 撤掉 monolith Espryt 的 skip;`ImageBindableRemintScenario` 钉 barrier(ID-P9-11 的同一形状)。G1 换基线:对 P9 基线 +120 / −84 个符号,其中具名的 +34 / −6 与 dev 自己的增量逐个相同,其余是重编号的异常表标签;`.text` 0xa52203 → 0xa56413;新基线 `~/w7/logs/p11/pull-syms-base.txt`。 | 两边改的是同一段 Espryt 代码(单进程的重铸与局部上传 vs P9 的 split 重铸与 pipe-push 的句柄臂),按文本取一边会丢另一边的修复。 | 合并包报告 `~/w7/notes/p11/m-report.md`;`~/w7/notes/p11/gate.sh`(G1 指向新基线) |
| ID-P11-7 | 2026-09-29 | A3 / A4 的结论(`A-DEVICE.md`):T0 在 app 域两后端都是 GO(与 shell 域逐行相同,含 128 MiB 与持续锁定);Adreno 上采纳只省 RSS(Espryt 480 MB、Magma 356 MB)、不改帧时;split T2 相对单进程采纳在 MC 26.3 上 RSS 1.4–2×、p99 Espryt +37–42% / Magma 约 2.5×(部分来自线程落位)。 | 这是 B2 的可行性与价值依据。 | `A-DEVICE.md`、`DEBTS.md` |
| ID-P11-8 | 2026-09-29 | 本阶段查出、不在 P11 修的:Espryt 零散写入按并集框上传覆盖 GPU 纹素(dev 独立任务);Magma 单进程 rd12 耗尽 `vm.max_map_count`(dev 独立任务);client 与 server 共用日志前缀时截断 server 日志(小修);pull 构建没有门跑集成测试(需裁定);split 的线程落位(性能)。 | 按规矩不顺手修 dev 的缺陷;性能只记录。 | `DEBTS.md` |
| ID-P11-9 | 2026-09-29 | **集成头 `82467823`**(dev 合并 + A-host + 计划文档)整套门:G1 对 P11 基线符号增 0 减 0、`.text` `0xa56413`;fatal census 79、refusal 词 4、link ratchet 171、spawn parity 0、协议修订 3、wire-declines 53/53;卫生 12/12;unit 2654;integration-split / spawn / tcp 392 / 309 / 321;integration-magma-split / spawn / tcp / full-split 214 / 193 / 177 / 613;integration-gpu monolith / inproc 2529 / 2529。verify 构建 unit / integration-verify / integration-verify-split 2654 / 1298 / 1232。主机 retrace 230 / 236(6 项仍是 iterationrp 的宿主 llvmpipe JIT 崩溃,monolith 同挂)。 | — | 全部 |
| ID-P11-10 | 2026-09-29 | 推送前发现 origin 已前进到 `86dc38a0`(另一个会话把 Magma `eglSwapInterval` 的移植直接推到了本线)。它与已合并的 dev `c60639db` 在 9 个文件上逐字相同,另加 split 专属的 `ForgetRequestedSwapInterval`(`MOBILEGL_BUILD_DISAGGREGATED` 下;传输模式下 `~BackendObject_DirectVulkan` 调用它,结束的 server 会话不把交换间隔带给下一个,与 DirectGLES 同规则)。以合并吸收(`9176dcff`,净增 16 行),不改写 origin。 | origin 不能强推;两份实现只差这一处,取并集。 | `DirectVulkan.{h,cpp}`、`BackendObject_DirectVulkan.cpp` |
| ID-P11-11 | 2026-09-29 | B0 的结论(`B0-CROSS-APP.md`):跨安全上下文连 server 的 unix 端点被 SELinux `connectto` 拒(shell 与另一个 app 都是),连上之后现有代码走共享段、7 个 fd 跨类别可用,数据面与协议不用改;B1 = 跨上下文的连接中介(导出的 bound Service 经 Binder 交出已连接的套接字)+ `fd:` 端点 + 按身份配对 + 防冻结 + 外部 client 的亲和 / 自旋策略 + 调用方认证。原生程序(Termux 一类)的引导方式交用户裁定。`AcceptPair` 按到达顺序配对(F2)是现有 server 的缺陷(unix 端点与非 `--serve` 的一次性 TCP server;产品 TCP 路径本已按身份配对),独立于 B1 先修(ID-P11-12)。`p11/b0` 保留到 B 落地(证据引用 `72926a88`)。 | 用户点名的消费者是原生程序,而跨上下文只有 Binder 能带 fd;原生进程没有 `Context`。 | `B0-CROSS-APP.md`、`DEBTS.md` |
| ID-P11-12 | 2026-09-29 | **PAIR**:socket client 的控制与辅助连接按 nonce 配对。client 在两条连接上各先发一条 `PairBind{nonce, aux}`(控制连接上 Hello 紧随其后);server 用 `PairAcceptor` 取代 `SocketTransport::AcceptPair`(已删):跨调用保留未配对的连接,不读 `PairBind` 之后的字节,同 nonce、角色相反才配对;什么都不发就关的连接(就绪探测)静默关闭,2 s 内没有 `PairBind` 或没等到另一半的具名拒绝后关闭,最多 16 条待配对。`protocol.fbs` 追加一张表与联合末位成员,控制协议修订 **3 → 4**(按 pin 脚本的程序);rev-3 client 连新 server 得 `Refuse{WireFingerprint}`,不会被配对。门:`PairAcceptorTest` 8 例 × unix / tcp(探测后接真 client、四条连接交错、孤立辅助连接过期后下一个 client 正常、Hello 在前的旧 client 具名拒绝)加一个真 server 的端到端用例;按到达顺序配对放回后 8 例全红、端到端 rc=6(与设备上一致)。B1 注意:代 client 建连接的 Service 必须自己写这两条 `PairBind`。 | 就绪探测与并发连接会让会话配错;B1 的 broker 更会同时代多个 client 建连接。 | `MG_Remote/Transport/*`、`Server/PairAcceptor.*`、`ServerMain.cpp`、`protocol.fbs`、`CONTRACT-P11.md` |
| ID-P11-13 | 2026-09-29 | B1 的原生路线按用户裁定(app_process helper + IPC 令牌)可行(`HSPIKE.md`):helper 经隐藏 `IActivityManager` 发显式广播交出自己的 Binder,server app 的 broker 核令牌、连自己的端点两次、以 `ParcelFileDescriptor` 交回,client 走 `fd:<control>,<aux>`;shell 与另一 app 的 uid 下都通,令牌错按名拒绝。B1 只做这一种 broker(广播 + helper Binder,Java client 同样可用),`bindService` 等有消费者再加。依赖 ROM:直接跑的 `app_process` 不受隐藏 API 黑名单约束,若某 ROM 强制则原生路线断。`p11/hspike` 保留到 B 落地。 | 用户点名的消费者是原生程序;探针证明了唯一未验证的一环。 | `HSPIKE.md` |
| ID-P11-14 | 2026-09-29 | **零拷贝必须可开关**(用户):开关即 `MOBILEGL_IPC_ADOPT_TIER`——`2`(默认)= 今天的共享内存 + client 推送(T2),`0` = T0 零拷贝导入。开了但本会话用不了(server 自测不通过、server 端禁用、Stream 数据面)→ 退回 T2 加一行具名日志,不 Fatal;A1 在共享段上对 0/1 的握手期 Fatal 随 B2 改成这个回退。server 端另设允许 / 禁止零拷贝的开关。默认值在 B2 真机门之后按数据再议。 | 零拷贝依赖 AHB 导入与 ROM 行为,必须能退回已验证的共享内存路径。 | `PLAN-P11.md` §2 B2;B2 实现 |
| ID-P11-15 | 2026-09-29 | **合并 dev `c14283ee`**(M2:Espryt 零散写入按矩形上传、Magma 每 16384 次 draw 分段提交、Magma 描述符池几何增长与整槽回收),合并提交 `c3715998` 加 8 个跟进。要点:dev 的零散写入修复只在单进程成立——split 各臂的 client 仍发存储合并后的矩形表(跨过空隙),合并头上 30 例红(两后端、三臂);改为 client 发精确写入框、server 区域上限 256 → 4096、Espryt server 在纹理无 GPU 写时自行做原来的框 / 矩形取舍(`91454338`)。dev 在按句柄查纹理的 server 路径上补的「GPU 可能写过」标记是承重的(去掉帧缓冲附件那一处即 12 例红)。分段提交也覆盖 split server 的 draw / dispatch。描述符池:回收的围栏在 split server 上重核成立(只从 Present 等完整个槽或空闲排空到达,线上各 flush 点不到达);普查用例只在 Magma Split 跑(Spawn / Tcp 的池在 server 进程,按名跳过),要等 server 应用完再读;server 每 2048 个 set 回卷。link ratchet 171 → 172(dev 新的虚函数经纹理占位对象可达,重设基线)。G1:对旧基线 +108 / −81,具名 +25 / −0 与 dev 自己的增量相同,`.text` a56413 → a5b933,新基线已写。门(`de996d53`):unit 2676、split / spawn / tcp 408 / 325 / 337、Magma 238 / 215 / 191 / 629、gpu 2617×2、verify 2676 / 1330 / 1264、retrace 230 / 236(iterationrp 6 项)。 | 两边改的是同一条上传路径与同一套描述符管理,dev 的修复在 split 下还缺一半。 | `~/w7/notes/p11/m2-report.md` |
| ID-P11-16 | 2026-09-29 | **B1 落地**(协议与行为见 `CONTRACT-P11.md` B1 节):`fd:<control>,<aux>` client 端点;两个 flavour 的 server app 都有导出的令牌 broker(令牌 ≥ 16 字节、核对运行中 server 自己的令牌,拒绝一律具名带退出码;server 只开 TCP 时走旁边的私有 abstract 监听);`app_process` helper(令牌走环境变量或文件、不走 argv,经隐藏 `IActivityManager` 发广播);server 界面「复制启动命令」「生成令牌」。**broker 在交出时就写好两条 `PairBind`**(ID-P11-12),helper 以 `MOBILEGL_IPC_FD_PAIRED=1` 告诉 client 跳过自己的;配对后的 unix 会话等 Hello 不设时限、以 EOF 为界(`kPairedUnixHelloWaitMs`),TCP 保留预认证时限——代价是一个永不发 Hello 的程序占着会话位直到它退出。**apply 线程策略按对端与数据面**:外部进程 + 共享段时 apply 线程在最低的那个大核、自旋 50 µs,唯一大核时不占它(退到别的大核或不绑);TCP、同 app spawn、inproc 不变(把 apply 放小核会把 TCP 从 51 拖到 27 fps)。server 把实际保留的核通过 broker 告诉 helper,helper 默认 `taskset` 避开它(`--keep-affinity` 关闭),核的规则只在 C++ 一处。用户须知:令牌 ≥ 16 字节、server 以离屏模式启动、HyperOS 电池对 server app 与 client 所在 app 都设「无限制」(否则熄屏或后台会被冻结)。真机(`df826f42` APK,默认环境、无解冻器):rd12 两后端 × 路线 (a)(b) ssim 全过、shm 全部胜 tcp(Espryt 119.3 / 53.2、118.7 / 39.8;Magma 36.4 / 20.3、32.5 / 20.4);程序晚 10 s 才初始化 EGL 仍能连上;插件 flavour 跑通。主机门(`8dfdd3ba`,之后只改了 Java 一行与契约):G1 0/0、ratchet 172、修订 4、卫生 12/12、unit 2692、各车道全绿;5 个 red-once。 | 用户点名的消费者是同机的原生程序;B0 / HSPIKE 已证明通道可行。 | `CONTRACT-P11.md` B1 节;`~/w7/notes/p11/b1-report.md` |
| ID-P11-17 | 2026-09-29 | **B2 落地:T0 零拷贝导入**(协议与行为见 `CONTRACT-P11.md` B2 节,数据见 `B2-DEVICE.md`)。先验:AHB 的 fd 在 shell → server app、另一 app → server app、同 app(helper / 直连 / spawn 子进程)五条路线都跨得过,GPU 读到从不解锁的锁下写入的字节,0 个 avc。设计:领养搭数据环上已有的 `map_persistent` 记录,AHB 经 aux 套接字按记录序号配对,apply 线程处理该记录时最多等 2 s、超时对那一个缓冲具名拒绝、不挂死;server 起角色时做「持续锁定 + GPU 写 + 经持有的指针读回」自测,通过才发布 `kCapAdoptT0`;client 取 min(开关, caps, 数据面);Espryt `glBufferStorageExternalEXT`、Magma `VK_ANDROID_external_memory_android_hardware_buffer`,导入的缓冲不留 Espryt 暂存副本(读者逐一审过);释放由 server 自己的 fence / serial 门控;CPU 读前 server 落完常驻写并等 GPU。控制协议修订 4 → 5。MC 26.3 峰值总内存(含 kgsl 导入):Espryt −41–42 %(3.0 → 1.8 GB)、Magma −18–26 %;ssim、帧时、CPU 不变,每帧 stage 字节不变。T0 专属改动的 red-once 在真机上做(Android 集成测试 + static-peek,inproc)。 | 用户要的同机大缓冲零拷贝;A3 已证明 app 域可行。 | `CONTRACT-P11.md` B2 节;`B2-DEVICE.md`;`~/w7/notes/p11/b2-report.md` |
| ID-P11-18 | 2026-09-29 | B2 过程中查出并修掉的三处:(1) **删除仍绑在索引绑定点上的 buffer**,前端清了绑定却没调 `NoteBindPointChanged`,server 留着旧句柄,槽位以新代号重用后 Espryt 在 `BackendSlotTable.Generation` 上 Fatal、Magma 静默丢掉那次 draw / dispatch(早于 B2,任何 split 会话都可能碰到)——四种索引目标加上交换 XFB 对象的路径都补上,`DeletedBoundBufferScenario` 两后端 × 单进程与三臂,去掉修复后 SSBO / uniform / 原子计数器红;(2) Magma 单进程在空的 uniform 绑定点上解引用空 buffer 而段错误(早于 B2),改为读零块,dev 同步修(`853c5f12`、测试 `7030d307`);这是本阶段 G1 唯一的变化:`.text` +224 字节、符号不变;(3) Espryt 的 split / spawn 集成用例没设 `MOBILEGL_ITEST_REQUIRE_GPU`,握手期 Fatal 被记成跳过、ctest 算通过——1106 条全部补上,未暴露新红。 | 前两个是真缺陷;第三个是门禁漏洞。 | `BufferState.cpp`、`UniformManager.cpp`、`MG_IntegrationTest/CMakeLists.txt` |
| ID-P11-19 | 2026-09-29 | **零拷贝默认开**(用户,看过 B2 数据后):`MOBILEGL_IPC_ADOPT_TIER` 不设 = 请求 T0,用不了时静默退回 T2(MGLOG_D、计数);显式 `0` 保留具名日志行,`2` 与之前相同。不设时 client 发一个单独的请求值(`0x80`),server 才知道该安静;为记录这个值改了 `protocol.fbs`,按 pin 脚本的「修订号提交本身的修补」用 `--force` 重钉修订 5(修订 5 从未发布),未升到 6。 | 自测把关、用不了自动退回,开关仍可关。 | `CONTRACT-P11.md` B2 节;`design/09` |
| ID-P11-20 | 2026-09-29 | **收官头 `0a117243`** 整套门:G1 符号增 0 减 0、`.text` `0xa5ba13`(相对 ID-P11-9 的增量是 M2 合入的 dev 修复与 ID-P11-18 的 +224 字节);fatal census 79(45 族词、7 refusal 词、0 未标)、link ratchet 172、spawn parity 0、协议修订 5、wire-declines 53/53;卫生 12/12;unit 2714;integration-split / spawn / tcp 427 / 346 / 348;integration-magma-split / spawn / tcp / full-split 251 / 228 / 197 / 636;integration-gpu monolith / inproc 2688 / 2688。verify 构建 unit / integration-verify / integration-verify-split 2714 / 1344 / 1278。主机 retrace 230 / 236(6 项仍是 iterationrp 的宿主 llvmpipe JIT 崩溃,monolith 同挂)。 | — | `~/w7/logs/p11/final-summary.log` |