Files
MobileGL/MobileGL/MG_Remote/Transport/AdoptTier.h
T

57 lines
3.0 KiB
C++

// MobileGL - MobileGL/MG_Remote/Transport/AdoptTier.h
// Copyright (c) 2025-2026 MobileGL-Dev
// Licensed under the GNU Lesser General Public License v3.0:
// https://www.gnu.org/licenses/gpl-3.0.txt
// https://www.gnu.org/licenses/lgpl-3.0.txt
// SPDX-License-Identifier: LGPL-3.0-only
// End of Source File Header
// The persistent-map adoption tier is settled at the handshake, before the first map_persistent,
// by the side that knows the data plane. T0: the client allocates an AHardwareBuffer and the
// server imports it; T1: a server-exported fd (closed); T2: decline, the client keeps the shadow
// and pushes. A T0 the session cannot use is never Fatal: it is T2 plus one line. The rules per
// data plane and knob value are in ARCHITECTURE.md §12.1. Lives in Transport because both roles
// call it (ServerSession::Accept, ClientSession::Start); Client::AdoptTierIsEmulate reads the
// settlement back on the T2 path.
#pragma once
#include <cstdint>
namespace MobileGL::MG_Remote::Transport {
enum class AdoptTierSide : std::uint8_t { Client, Server };
// THE HELLO'S T0 ASK WHEN THE KNOB IS UNSET (LinkTerms.adoptTier, protocol.fbs): T0 as asked
// by 0, except that the server names a refusal only at MGLOG_D. The ask travels because only
// the server knows why it did not grant T0 (its allow switch, its platform, its POST).
inline constexpr std::uint32_t kAdoptAskT0Default = 0x80;
// An ask that is a T0 ask (0 by name, kAdoptAskT0Default by default).
inline bool AdoptAskIsT0(std::uint32_t ask) { return ask == 0 || ask == kAdoptAskT0Default; }
// This process's knob asks for T0 (0, or unset).
bool AdoptTierWantsT0();
// This process's knob is unset: T0 fallbacks are quiet.
bool AdoptTierIsDefault();
// The tier the client's Hello asks for (LinkTerms.adoptTier): 0 when the knob says 0 and the
// plane it proposes is shared segments, kAdoptAskT0Default when the knob is unset on shared
// segments, else 2. Pure - the lines are the settle's.
std::uint32_t AdoptTierAskFor(bool streamDataPlane);
// Settles this side's handshake answer from MOBILEGL_IPC_ADOPT_TIER and the negotiated data
// plane and returns the ask this side made (client) or serves by its own knob (server):
// AdoptTierAskFor's value for a client asking T0 over shared segments, 2 otherwise. Logs at
// most one line per call (A1's stream refusal - at MGLOG_D when the knob is unset - and the
// T1 refusal). Never aborts for 0/1/unset; any other value (only a direct assignment can
// make one) is still Fatal{UnimplementedAdoptTier}.
std::uint32_t SettleAdoptTierAtHandshake(bool streamDataPlane, AdoptTierSide side);
// True once a handshake in this process has settled the tier. The at-use check trusts a
// settled session and still refuses by name a map_persistent no handshake settled.
bool AdoptTierSettledAtHandshake();
// Test seam: forget the settlement, so one process can drive both answers.
void ForgetAdoptTierSettlementForTest();
} // namespace MobileGL::MG_Remote::Transport