Files
MobileGL/docs/Disaggregated/notes/p7/ph-f.md
T

13 KiB
Raw Blame History

P7 wave 2-F:Ph 小件(分支 p7/ph-f)

计划见 PLAN-PH-P34B-P7.md §1.1(PH-7、PH-8、D11、门行)与 §3 wave 2-F; 裁定见 INTEGRATOR-DECISIONS-P7.md ID-P7-3(令牌足够、不做 TLS、 Welcome.dataNonce);规范见 CONTRACT-P7.md §0 规则 I / J、§9 簇 F、§10 第 3 条。基线 ec46a550。

主机口径:WSL Arch + lavapipe,build-split 与集成者同配置(integration tests ON)。flatc 取 3rdparty/flatbuffers 子模块构建的钉版本(scripts/gen_protocol.py)。

基线门读数(~/w7/logs/p7-gate-f-base.log):G1 .text 0xa52203、符号 0/0;普查 79 处 abort、 0 未标记;棘轮 173;车道 unit 2429 / split 303 / spawn 219 / tcp 222 / magma-tcp 74。

0. 每片一条提交,每片一次 red-once

片 项 提交 状态
1 PH-7 (1)(2)(3):常量时间令牌合一、≥16 字节、无令牌只 loopback、smoke 入 CI 2975a337 落地
2 PH-7 (4):Welcome.dataNonce 把数据连接绑定到已认证的控制连接 596b34fd 落地
3 PH-8:Hello 要 64 GiB → server 钳到自己的条款且不分配 a746417a 落地
4 D11 五处上限 + PH-2 — 未做,见 §4
5 PH-6 drop-with-latch — 未做(顺序在 4 之后)
6 PH-1 (3)(4) — 未做(顺序在 4 之后)

red-once 原始行汇总在 ~/w7/logs/p7-ph-f-redonce.txt。


1. 片 1:令牌策略合一(PH-7 (1)(2)(3),ID-P7-3)

1.1 机制

MOBILEGL_IPC_TOKEN 原来有三种读法:SocketTransport.cpp 的 ListenTcp 只问「非空」,所以一个字节 的令牌也能打开 tcp://0.0.0.0;ServerSession::Accept 用 std::strcmp;ServerMain::RunSession 用 std::string::operator==,且在 server 没配令牌时反而要求对端送空令牌。两处比较都在第一个不同字节处返回。

  • 新文件 MG_Remote/Transport/AuthToken.h:ConfiguredAuthToken()(空值 = 未配置)、 kMinimumAuthTokenBytes = 16、ConstantTimeTokenMatch(循环长度只取本进程自己的令牌,长度差并入累加器, 嵌入的 NUL 参与比较)。
  • Handshake.h AuthenticatePeerToken:唯一的策略函数,ServerSession::Accept 与 supervisor 子进程 (ServerMain::RunSession)都调它。不配置令牌时不因对端送了令牌而拒绝——策略由监听侧的 loopback 限制负责。
  • ListenTcp:配置了但不足 16 字节的令牌让监听失败(具名 Refuse{Authentication} ... minimum is 16, 进程退出 72),而不是悄悄退化成 loopback server。令牌值从不进日志。
  • Refuse{Authentication} 是 protocol.fbs RefuseCode 的枚举值,fatal_census.py 规则 4 的词表门 直接认它;普查前后都是 3 个 refusal 词,无需新增 .def 行(Refuse 词不是 Fatal 家族词)。
  • CI:TcpLane.SupervisorProtocolControls 从 wave 0 起挂在 integration-tcp 上却因 CI 没有 flatc 而恒为 SKIP。test.yml 的 integration-split 作业现在从子模块构建钉版 flatc(gen_protocol.py --check, 不改已提交头文件),导出 MOBILEGL_FLATC_EXECUTABLE,并用 junit_tally.py --require-entry-passed TcpLane.SupervisorProtocolControls 断言它跑了且过了——SKIP 在这里等于红(tcp_lane_tools_test.py 覆盖 passed / skipped / notrun / failed / absent 五态)。
  • smoke 新增两条监听控制:无令牌 + 通配地址 → 具名拒绝;13 字节令牌 + loopback → 具名拒绝、行里不含令牌。

1.2 red-once(两进程,TcpLane.SupervisorProtocolControls)

把 SocketTransport.cpp 还原到 ec46a550、只重链 libMobileGL.so:

RED   AssertionError: (None, '... MG_Remote server: pid=42256 listening on tcp://127.0.0.1:46447')
GREEN short_token_listen exit 72: MG_Remote: Refuse{Authentication} MOBILEGL_IPC_TOKEN is 13 bytes and the
      minimum is 16 (PH-7 (3)); refusing to listen on tcp://127.0.0.1:46545 rather than authenticating with
      a guessable secret

即:改前 13 字节令牌起了一个活的监听者;改后进程以名字拒绝。单测 SocketTransportTest.TcpRefusesToListen WithATokenShorterThanTheMinimum 与 TheTokenComparisonAnswersLengthAndPrefixTheSameWay 是廉价的那一半。


2. 片 2:Welcome.dataNonce(PH-7 (4),ID-P7-3)

2.1 现场故障

设备窗口 #1:经 Windows adb forward 时一个会话的两条连接乱序到达;AcceptPair 规定「先到的是控制、 后到的是数据」,于是数据连接被当成控制读 Hello,每个子进程等 10 s 后以 67 退出(日志里伴随 only 1 of 2 connections arrived within 250 ms)。同一条规则也意味着任何能连到端口的人都能把一条连接 插进窗口、成为别人会话的数据面。

2.2 机制

  • protocol.fbs:Welcome 末尾追加 dataNonce: [ubyte];新表 DataBind { nonce: [ubyte]; } 追加到 CtrlMsg 末尾。头文件由钉版 flatc 重新生成。
  • wire 指纹随之改变。 原指纹的输入全是数据面的结构尺寸与编解码摘要,控制 schema 改形状不会动它。新增 MOBILEGL_PROTOCOL_CONTROL_REVISION(mg_protocol_base.h,本次 = 1)作为 AbiFingerprintInputs. ControlSchemaRevision 混入;SessionHandshakeTest.TheAbiFingerprintChangesWhenAnyOfItsInputsDoes 钉住 该输入并加扰动行。实测 wireFingerprint 由 0x7d4470f241d23539 变为 0x03c4c293a54b3e08。 设备侧后果:旧 server 与新 client(或反之)现在以 Refuse{WireFingerprint} 拒绝,设备上的 server 需要随本提交重新部署。
  • 流程(仅 tcp://;unix 端点的第二条连接是 SCM_RIGHTS 套接字,保持 AcceptPair):
    1. client SocketTransport::ConnectControl 只连控制连接,发 Hello;
    2. server 子进程在令牌通过后用内核 CSPRNG(getrandom,退回 /dev/urandom,绝不退回 PRNG)铸 128 位 nonce,StreamLink::AttachOwnedDeferred 先建好私有内存(Welcome 要宣告其尺寸)但不带 fd、不起 reader 线程,发 Welcome(带 nonce);
    3. client 收到 Welcome 后 ConnectDataConnection 开数据连接,第一帧是 DataBind{nonce},随后才挂 StreamLink;
    4. supervisor 一次只 AcceptOne:无活会话时新连接是控制连接、fork 子进程(带一对 hand-off socketpair);有活会话时读新连接的恰好一帧(ReceiveOneFrame 不多读一个字节——DataBind 后面 紧跟 StreamLink 自己的帧),是 DataBind 就把 fd 连同所呈 nonce(sideband)经 FdPassing::SendFd 交给子进程,否则照旧 Refuse{Busy};
    5. 子进程里 ServerSession::BindDataConnection 是唯一比较点(ConstantTimeNonceMatch):匹配者 StreamLink::BindDataFd 起 reader;不匹配者在那条连接上回 Refuse{Authentication} data connection nonce mismatch 并关闭,等待继续——陈旧或抢插的连接结束不了它没能加入的会话。截止时间 (5 s)到则在控制连接上回 Refuse{Authentication} no data connection presented the session nonce; 控制对端先走则立即结束等待(子进程按 0 退出,不计入 sessionsFaulted)。
    6. 无活会话时到达的 DataBind 由子进程具名拒绝:Refuse{Authentication} data connection names no live session,干净退出 0。
  • 250 ms / 2000 ms 的「两连接到达窗口」在 TCP 上不复存在;取而代之的是 nonce 匹配。非 --serve 的单会话 TCP 模式保留监听者,由会话自己 accept 并读 DataBind(ListenerSource),比较仍在同一处。
  • 仍然没有做的:ID-P7-3 说「认证在 fork 之前完成」——本片的令牌检查与 nonce 铸造仍在 fork 出的会话子 进程里(每会话一进程,不影响绑定的正确性);把 Hello 读取与认证移进 supervisor 属于 PH-7 (5)「有界的预 认证工作 + 失败退避」,未做。

2.3 red-once(两进程)

探针只跑「数据连接先到、控制连接后到」这一条(新 smoke 的 (a)),server 分别是片 1 的头与本片:

RED   (片 1 server) stray: RuntimeError: control channel closed before a complete frame
                    control: ConnectionResetError: [Errno 104] Connection reset by peer
                    supervisor: session pid=1705895 reaped exit=67 sessionsFaulted=1      ← 现场故障原样
GREEN stray: Refuse{Authentication} 'data connection names no live session'(子进程 exit=0)
      control: Welcome,nonce 16 字节

smoke 常驻控制(TcpLane.SupervisorProtocolControls):data_connection_first(上面这条)与 stale_nonce(会话活着时先呈一个取反的 nonce → 那条连接收到 Refuse{Authentication} data connection nonce mismatch,日志 MGPipe: Refuse{Authentication} data connection nonce mismatch,随后正确的 nonce 绑定、子进程打出 ready)。单测 SocketTransportTest.TheDataBindIsReadExactlyAndTheStreamBehindItIsLeft OnTheSocket 钉住「恰好一帧」与 16 字节宽度。

integration-tcp(真 GL client 走新流程)222/222、integration-magma-tcp 74/74 保持全绿。


3. 片 3:PH-8(server 钳制尺寸)

3.1 机制

没有改代码:ServerSession::Accept 只看 Hello linkTerms 的 dataPlane / wireForm,段按 server 自己的 SetSegmentSizes 建,Welcome 宣告的也是这组。本片把它钉住:

  • 单测 SessionHandshakeTest.AHelloAskingFor64GiBIsClampedToTheServersTermsAndAllocatesNothingOfIt: Hello 四个窗口各要 64 GiB,Welcome 必须回 server 的 4 KiB 条款,四个 SegmentRef 各 ≤ 64 KiB。
  • smoke hello_asks_64_gib:两进程下同样的请求,Welcome 的条款 < 1 GiB,且回答它的会话子进程(Welcome serverPid)在数据连接绑定后(即全部段已存在)VmPeak < 64 GiB。实测:maxReply 2097136、cmd 8 MiB、 stage 32 MiB、event 256 KiB,子进程 VmPeak 237264896。

3.2 red-once(变异:Accept 改为按 Hello 的条款定尺寸,已还原)

RED   unit  SessionHandshakeTest.cpp:294  Accept rc 2 != 0(64 GiB 私有段建不出来)
RED   smoke hello_asks_64_gib: RuntimeError: control channel closed before a complete frame(子进程死于该请求)
GREEN 如 3.1

4. 片 4–6 未做,以及为什么停在这里

计划的停止规则:「某片超过一天就停在上一片」。片 4(D11 五处 + PH-2)的代码改动本身不大,但每一处都要求 一条在两进程臂上、字节来自对端的负控,而树上没有任何车道能把一条越过 client 自身守卫的畸形记录 送进一个 spawn / TCP server:

  • create_render_state 的 Cso.Slot、read_pixels 的 W×H(client 在发射前按回复槽尺寸自检)、程序归档 里的 ArchiveVector 计数、StagedTextureStore 的 run 与 level extent、SlotTables 的 handle slot/gen—— 全都由 client 的编码器生成且被它自己的检查挡住;要到达 server 必须有一个能按需伪造记录的对端(fuzz 臂 2 「超界计数」一行正是这件事,计划里记在 P7 之后)。
  • 另外两处落在簇 F 之外、且会碰 pull 构建:ProgramArtifactsCodec.cpp 编进 pull 构建(G1 .text 要求新界限 只能在 MOBILEGL_BUILD_DISAGGREGATED 内),SlotTables.h 在簇 D 的 MG_Backend/DirectGLES/ 下,且 MGPipeFatalFamily 目前只有 UnmigratedVerb / RoleViolation,PH-2 的具名拒绝需要先加一个 ProtocolCorruption 族并在 hook 映射里接上。
  • 已核实的一点备查:MG_Pipe/PipeApply.cpp 不在 pull 构建里(build-linux/compile_commands.json 无该文件),D11 第一行在那里改不影响 G1。

所以片 4 连同其后的片 5(PH-6)、片 6(PH-1 (3)(4))按规则未开工。建议下一包先落「对端伪造记录」的两进程 驱动(它同时是 fuzz 臂 2 的骨架),再逐处上界限,每处一条经它红一次的负控。


5. 门(头 a746417a)

门 基线 ec46a550 头
G1 pull .text / 符号增删 0xa52203 / 0/0 0xa52203 / 0/0(build-linux 无需重编:簇 F 文件不在 pull 构建)
fatal_census.py 79 abort、44 家族词、3 refusal 词、0 未标记 同左
link_ratchet.py --assert-monotone 173 173(不变)
spawn_lane_parity.py 0 错 0 错
unit 2429 2433(+4:片 1 两条、片 2 一条、片 3 一条)
integration-split 303 303
integration-spawn 219 219
integration-tcp 222 222
integration-magma-tcp 74 74