diff --git a/docs/Disaggregated/notes/p5f/fm-report.md b/docs/Disaggregated/notes/p5f/fm-report.md new file mode 100644 index 00000000..111a8e0e --- /dev/null +++ b/docs/Disaggregated/notes/p5f/fm-report.md @@ -0,0 +1,146 @@ +# P5f fm — Magma 跨角色读写退役 + +> 分支 `p5f/fm`;Windows worktree `MobileGL-p5f-fm`;WSL gate tree `~/w7/p5f-fm`。 +> 代码 checkpoint:`b394a09f`。实现与范围结论已核对;§5 的最后一轮数字由门禁执行者补齐。 +> 本报告只裁定 fm;不宣布 P5f 总出口完成。 + +## 1. 真实可达性修正 + +f0 的“带 buffer 的 draw 最终到 buffer-legacy-arm”不能推出整个 draw 子树不可达。 +`ClipDistanceScenario.AnEnabledClipDistanceRemovesTheNegativeHalf` 使用 `gl_VertexID`,没有 VBO;在 f1 基线 +`~/w7/p5f-f1` 的真实 Magma/inproc、role-split=0、strict=0 下像素测试通过(`/tmp/p5f-fm-baseline-clip.log`)。 +因此本包保留无 buffer draw/dispatch,新增 server program source、descriptor 和 render-pass 路径;没有把所有 draw 拒绝。 +迁移后同一 case 在 role-split=1、strict=1 下通过(`fm-clip.log`;集成者独立复核 `int-wire-clip.log`)。 + +记录能被消费也必须能被发射。client 的 P4a family gate 和 server 的 `NoP4aConsumer` +原来都绑在 buffer resource-ops 上,而 Magma 没有该 ops。本包改为 client 查询该 family +的已发布 consumer bit、server 接受其 object records;残余 fill memo 加 caps generation。 +Magma 仍不发布 buffer resources bit 7;发布 indexed-binding bit 13,用记录辨别未绑定与 P7 buffer 债。 +texture staged bytes 原本也只由 GLES 的 resource-ops hook 采纳,本包补无 hook 时的 server-owned +adoption、respecify/defined-ness、destroy/release,保留有 hook 的 Espryt 路径避免双采纳。 + +## 2. 九字段与邻接字段 + +| 字段 | Magma transport 的现在来源 / 边界 | +|---|---| +| GetBoundVertexArray | `SetupWireDraw` 读 `BoundVertexElements` / `VertexElementsCsos`;无数组与 current generic attribute 正常画;实际读取 enabled array 时在 client 读前具名 `buffer-legacy-arm`(P7)。| +| GetBufferBindingPoint | UniformManager 读 `BoundShaderBuffers` 判断绑定;已存在的无绑定 native buffer placeholder 保留,有真实 SSBO/UBO buffer 时具名 `buffer-legacy-arm`。XFB capture 同样在读取前端绑定前拒绝。| +| GetFramebufferBindingSlot | `WireFramebuffer.inc` 的 clear/blit/read/copy 与 `WireDraw.inc` / pipeline builder 全读 framebuffer record / `MGPSurface`。| +| GetImageTextureBinding | UniformManager 读 `BoundShaderImages`;native image view 与 sampler 使用 server resource record。| +| GetTextureUnitObject | sampler 读 `BoundSamplerViews` / `BoundSamplerStates`;mipmap 与 framebuffer-copy 读各 verb handle。| +| GetProgramForDraw | `MagmaProgramSource(handle, ShaderCsoRecord)`;SPIR-V / reflection 来自 `Archive`,可变绑定和 global UBO 来自记录尾部。| +| GetProgramForDispatch | 同一 source,以 `DispatchProgram` 句柄选择 compute program。| +| GetTransformFeedbackProgram | 无 XFB draw 不进该读点;active XFB capture 在 wire setup 的 P7 buffer 边界具名拒绝。本包没有宣称 Magma 的 XFB capture 已可用。| +| GetTextureObject | handle-keyed VkTextureManager 完成 sync,无 GL-name / client weak_ptr 查询。| + +邻接项:`GetBufferBindingPointCount` 不再被 wire uniform 路径读取;`HasOpenTransformFeedbackSpan` +只留在 class-C query / P7 capture 子树。`GetBufferBindingSlot` 的 indirect wrappers 在第一处前端读取前 +保持具名 P7 拒绝;server 生成的 LINE_LOOP indices 用 transient server bytes,普通无 buffer draw 不受影响。 +`ShaderStorageBlockBinding` 用 `VerbStorageBlockProgram` 更新 server `StorageOverrides`,不再经 +`TryGetDirectVulkanProgram` / `ValidateProgramName` / `GetProgramObject` 探 client 名表。 + +独立 fm 的全局 FieldOwnership 分类仍保留 15 个 BARRIER_PULLED 字段;fe 集成后两个 scalar sticky +改为 APPLIER_DERIVED,仍余 **13 个字段**。其余对象行需在收口时与 residual-fill / +generator 的静态不变量一起归零,不是本包门绿后自动翻成 RECORD_SUPPLIED。 +这里没有把“没有调用旧对象 getter”冒充“旧 SharedPtr 字段已由记录填充”。`FieldOwnership.def` 已加该说明。 +`RecordError` 的反向通道归 fv;`PipeInputs::IsLive()` 仍 forward 到 `LiveContext()`,也是 +未退役的 client liveness 读取,留给 fv / 阶段收口核对;均未在本包领取完成。 + +### Program source、descriptor 与发射约束 + +`MagmaProgramSource` 是仅在 disaggregated 构建存在的只读视图:monolith/internal-program +构造接 `const ProgramObject&`,wire 构造接 handle 和 server `MGPipeShaderCsoRecord`。 +非 disaggregated 构建是原 `ProgramObject` 的类型别名,保持 pull 代码形态。 +SPIR-V、linked stages、uniform/block/XFB reflection 来自 ProgramArchive;`BlockBindings`、 +`SamplerUnits`、`StorageOverrides`、`GlobalConstants` 来自当前记录,后者覆盖 archive 的旧值。 +全局 UBO 字节与版本不再问 client,SSBO 索引沿用旧 SPIR-V reflection 的排序规则。 + +server 视图不使用或写回 `ProgramObject` 的 hash memo:每次按当前 archive/绑定尾部算 hash, +编译产物仍由 ProgramFactory 的 server cache 复用。按内容进一步缓存 hash 属性能工作, +本包没有以共享 client memo 换取“快”。draw 和 dispatch 各自从记录选 program;普通 +无 buffer draw 支持 current generic attributes,`gl_InstanceID` 的既有 SPIR-V rebase 保留。 + +sampler/image descriptor 消费 `BoundSamplerViews` / `BoundSamplerStates` / `BoundShaderImages`, +以 server texture record 创建原生 image view、按 record sampler 参数创建 sampler;view 的 +mip/layer window、format alias、swizzle 与隐式 alpha 按记录恢复。真实 buffer/texel-buffer +消费者仍在前端解引用前具名拒绝。无绑定 image 所需的 frontend placeholder 则明确报 +`Fatal{UnmigratedVerb, "Magma:unbound-image-placeholder@P7"}`,不是构造 client 对象来兜底。 + +vertex-input 的发射不受 Magma 缺 bit 7 的牵连:`NewVertexElements` 属 bit 8,P4a 的 +consumer/dependency gate 只管该阶段的四个 object families。server 因而能区分 enabled array +与 current attributes;wire 缺少 vertex-elements record 会具名拒绝,不能静默当空 VAO。 + +`CapsMirrorTest.ObjectFamilyEmissionTracksIndependentConsumerCapsWithoutBufferOps` 在同一 +子进程中采用 Texture-only → Framebuffer-only → Texture-only 三个 +snapshot;buffer bit 始终为 0,逐次断言真实 `MGPipeP4aFamilyEmits` 的正反变化。 +当前对象行仍被 BARRIER_PULLED 分类支配,测试没有假造 `SuppliedFieldMask` 的值变化; +caps generation 是该环境缓存的失效键,也是后续归属表收口必须保留的条件。 + +## 3. T5 与三类结构耦合 + +- T5:mipmap 使用 `VerbMipRes/BaseLevel/LevelCount`,只改 server image / staged shadow;upload-target 集合由 resource descriptor 推导,view window 从 `ViewOf` / sampler-view record 解析。无 client texture unit、upload-target vector 或 mip-level storage 写入。 +- texture twin / memo:独立 `std::unordered_map` 以 `{slot, gen}` 为键;dead-generation prune、shutdown 清理;shape 重建保留旧 GPU 内容。pending-upload 只上传指定 regions,避免 CPU 旧影子覆盖 GPU clear/blit/mipmap 后未改区域。失败上传不推进 synced serial。 +- program twin:`MagmaProgramSource` 在非 disaggregated 编译下是 `ProgramObject` 别名,在 split 下按值引用 server archive/record;`GetBackendHashMemo/SetBackendHashMemo` 不再写 client 对象。 +- server 构造 client 类型:wire clear/blit/mipmap/draw 使用 native image/view/framebuffer/render-pass,sampler 从 `SamplerParameters` 构造;不走隐藏 ShaderObject/ProgramObject/SamplerObject 或前端 texture placeholder 构造。原 frontend placeholder 的 allocator 边界显式改写为上节的具名 P7 拒绝,未装成新可用功能。 +- buffer twin / 直写:真实前端 BufferObject 的 backing resource、mapped bytes、EnsureGpuResident 等仅留 monolith 或既有 P7 拒绝之后;`ResourceTracker.h` 的 GPU-written fallback 归 fv,没有改。 + +`CopyImageEndpoint.TextureHandle` / `VerbStorageBlockProgram` 与 fe 采用相同 seam。 +为独立 fm 门可运行,同时带入 fe 的 GLES CopyImage endpoint 接线和 shared readback helper 的 server reply-scratch +分支;集成保留同一份,不重复计算为两份迁移。 + +新 draw render-pass 仍沿用既有正确性规则:sRGB attachment 随 `GL_FRAMEBUFFER_SRGB` +选择 sRGB/UNORM 写 view;1D/1D-array storage 保留相应 view 类型;各 attachment 使用 +GENERAL layout 与 descriptor 一致。旧 pass/framebuffer/view 退休前等待已提交 GPU 工作完成。 +每次 command buffer 重开均经 FrameContext observer 重置 dynamic-state shadow,viewport、 +scissor、blend/stencil 等不会因连续 draw 的相同值而漏发。此处选择正确性优先的提交/等待, +不声称完成 P7 的批处理性能设计。 + +staged store 的 hookless 路径与 GLES hook 二选一,绝不双 Adopt。named respecify 定义对应 +mip(包含 null-data),whole immutable respecify 重定义完整链,destroy 删除 handle key, +object-record release 清空;make-current reset 保留仍活对象的数据。 + +## 4. 出口门 4 的回答 + +**Magma 不发布 `kCapRunAheadApply`。** 无 buffer draw / compute、framebuffer、texture 诸实际可达路径 +以与 Espryt 相同的 role-split + strict 机制验证;分块时旧 client pointers 根本不在 server 块里,lockstep 不能 +掩盖这些读取。真实 buffer consumers、host-texel placeholders 和少量 native format/function shapes 仍是 P7 功能债。 +新 wire render-pass 为保证对象退休正确,提交后等待 queue 完成才销毁,尚未建立 run-ahead 的资源版本和性能契约。 +此外 `IsLive` forward、fv 剩余反向写入与完整字段归属收口仍未完成,不能把当前已测工作集 +扩大成“全 server apply 路径已满足 run-ahead”的能力承诺。保留 lockstep 是能力声明; +不把它当跨角色读写的豁免。`MagmaPipeIdentityTest.AMagmaServerNeverPublishesTheRunAheadCapBit` +分别对 ready=false/true 固定 Magma 的回答为不发布,避免随 Espryt readiness 翻转而误开启。 + +R11F_G11F_B10F 的 mip blit 是已实测的原有功能债:f1 基线真实 inproc 下 +`F1WireScenario.GenerateMipmapPackedFloatPixels` 像素失败,RGB 都为 0(`fm-base-packed.log`)。 +本包对应失败为 `Fatal{UnmigratedVerb, "Magma:mipmap-native-format@P7"}`;新增 Magma 同名测试留在 +`integration-magma-p7-known-red`,CI 强制恰一条实际执行、failure 非 skip、私有日志精确含该 marker。 +它不加入双块 field-fatal 棘轮;原 Espryt case 与所有既有测试名保留。 + +## 5. 门与 red-once + +验证数字将在最后一轮运行后补齐。已完成的独立证据: + +- 无 buffer ClipDistance:baseline 共享块绿 / fm 双块 strict 绿。 +- Program source 单测 3/3;临时退回 archive 旧 binding 值,`MagmaProgramSourceTest.ServerBindingTailsReplaceLinkTimeDefaults` 真红(旧值 9 分别不等于记录值 3/6);健康源码 3/3 绿(`fm-program-source-tests.log` / `fm-program-source-red-once.log`)。这份证据为独立临时 object/executable 执行;最终集成 unit 门仍单列核对。 +- `StagedTextureProductionTest.HooklessTextureConsumerOwnsBytesAndScopedStorageLifetime`:旧 metadata-only 条件吞 named null-data mip,level-1 extent 为 0 导致真红;修复后 1/1 绿(集成者 `int-fm-staging-red-once.log` / `int-fm-staging-green.log`)。 +- G1 pull 已测 checkpoint:`.text` 10806051 → 10806051;defined symbols 27815 → 27815;0 added / 0 removed / 0 resized / 0 renamed(`fm-g1-final.log`)。最后新增代码后的确认由下表更新。 +- flavours 已测 checkpoint:pull / push 生效宏与构建通过;独立 unit 首轮 2266/2266、0 failed(10 个宏/平台基线 skip;该次尚不含后来加入的 caps case)。 +- generator check/self-test、include closure 已绿;doc citations 只有与 f1 相同的两处既有 basename 歧义。 + +最终门记录(门禁执行者填入最终头与对应日志,不从上述 checkpoint 推算): + +| 门 | 最终结果 | +|---|---| +| 最终代码头 / build | 待最后一轮结果 | +| unit / integration-split | 待最后一轮结果 | +| Magma 双块 + strict | 待最后一轮结果;新 sampler/uniform、compute image-store 场景也必须实际执行 | +| 双块 Fatal 棘轮 | 待集成复测:fm 要退役 `GetFramebufferBindingSlot@Clear`;独立 fm 的其它 Espryt 首阻塞仍归 fe,不追加新预期对 | +| integration-gpu | 待集成门结果 | +| pull / push / G1 / G2 / G14 | 待最后一轮确认 | +| packed-format known-red | 待最后一轮精确 marker 核对;不是 skip,也不是双块字段 Fatal | + +strict、双块与 gpu 会覆盖同一测试的私有日志,串行运行并保存各自摘要;后跑车道的日志 +不能拿来替前一车道补证。新增 scenario 名集合保留既有测试,known-red 专门车道也必须实际 +执行并验证自己的失败原因,避免通过移标签隐藏回归。 + +设备门未执行:当前没有 Redmi `2f7cbe2e`;该项由阶段收口记录,不能由 host lavapipe 结果代替。