mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-21 00:41:57 +09:00
[MG_Pipe, MG_Remote, MG_Backend, MG_Impl, MG_IntegrationTest] (Disaggregated): P5c ct - the applier_reset and object_death control records
Two appended wire records replace the two cross-role control bypasses:
applier_reset (opcode 77, MGPApplierReset{Uint64 ContextSerial}, kScreen) is emitted by
the GL thread at the FreshlyPrimed make-current edge, before the client-side resets, so
the record's barrier orders the server's MGPipeApplierReset against every verb that
follows; a direct MGPipeApplierReset() from a non-apply thread with a live session is
Fatal{RoleViolation, "g_applier"} (MGPipeApply.cpp carries the layer-2 guard; the
apply-thread and no-session bring-up shapes keep the direct call verbatim).
object_death (opcode 78, reuses MGPipeHandleOnly, kCtxObject) is the framebuffer
family's first wire delete opcode: the client thread resolves the dying object's handle
in its OWN allocator, emits nothing for a handle the server never saw, and EmitAndWaits
otherwise - the wait preserving the death's ordering against in-flight records that
name the handle, the only property the blocking mailbox hop provided. The sink releases
per-kind twins through a handle-keyed ReleaseTwinByHandle (seven kinds, SamplerViewCso's
idempotent second path kept); a null arriving handle is
Fatal{ProtocolCorruption, "ObjectDeath.Handle"}. A documented NoSession fallback arm
delivers a death to a server-only fixture's loop; monolith keeps the mailbox hop and
the FreshlyPrimed direct call character for character.
Evidence: gen_pipe --check/--self-test and gen_pipe_field_ownership --check/--self-test
green; unit 2155/2155; integration-split 111/111 (107 plus four new CtWireScenario
entries, all genuinely run, each with its own log path and an EXPECT_EXIT death case);
red-once - shorting the emission to the direct call turns the four Ct cases red with
Fatal{RoleViolation, "g_applier"} by name, then restores green verbatim.
CONTRACT-P5C sections 1, 5.1-5.2, 7.
This commit is contained in:
@@ -35,6 +35,8 @@
|
||||
#pragma once
|
||||
#include <Includes.h>
|
||||
|
||||
#include <MG_Pipe/MGPipeHandles.h>
|
||||
|
||||
#if MOBILEGL_BUILD_DISAGGREGATED
|
||||
|
||||
namespace MobileGL::MG_Remote::Client {
|
||||
@@ -86,6 +88,33 @@ namespace MobileGL::MG_Remote::Client {
|
||||
// server otherwise). Declared here so PipeFill does not have to include a server header.
|
||||
Bool RunsAsTheServerRole();
|
||||
|
||||
// ---- P5c (ct), CONTRACT-P5C.md §5: the two control records' client halves --------------
|
||||
//
|
||||
// NOT ROUTED ROWS - the two are appended to PipeCalls.def with no MGPipeApply* entry point
|
||||
// and no table slot at all, so their producers call these directly. PipeFill.cpp's
|
||||
// FreshlyPrimed arm calls the first; DirectGLES' OnFrontendStateObjectDestroyed calls the
|
||||
// second.
|
||||
|
||||
// applier_reset (§5.1). Emitted on the GL thread at the tracker.FreshlyPrimed() edge,
|
||||
// BEFORE the block's client-side resets, so the record's barrier orders the server's
|
||||
// MGPipeApplierReset() against every verb that follows. ContextSerial is the client's own
|
||||
// count of applier_reset emissions (0 = the first make-current): nothing in the frontend
|
||||
// numbers a make-current today, and the sink asserts the value against its own count of
|
||||
// the same records rather than dispatching on it (P5c: one context per session; P6 reads
|
||||
// it for real). Returns false - nothing emitted - when no live session could carry the
|
||||
// record (the bring-up window before Start, a server-role-only fixture, teardown); the
|
||||
// caller then makes the direct call the record replaced.
|
||||
Bool EmitApplierResetRecord();
|
||||
|
||||
// The three answers a death notice can produce (§5.2): the record crossed; the client's
|
||||
// own allocator cannot resolve the dying object (the server never saw it, so there is no
|
||||
// twin to kill and NOTHING crossed); or no live session could carry the record. The
|
||||
// third is NOT folded into the second: a server role with no wire at all - a ServerLoop
|
||||
// fixture's shape, never a real split's - still has a server loop the caller delivers to,
|
||||
// where a handle that never existed has nothing to deliver.
|
||||
enum class ObjectDeathEmit : Uint8 { Emitted, NoHandle, NoSession };
|
||||
ObjectDeathEmit EmitObjectDeathRecord(MG_Pipe::MGPipeKind kind, Uint64 lifetimeId);
|
||||
|
||||
} // namespace MobileGL::MG_Remote::Client
|
||||
|
||||
#endif // MOBILEGL_BUILD_DISAGGREGATED
|
||||
|
||||
Reference in New Issue
Block a user