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

22 lines
12 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` |