50 lines
1.9 KiB
C
50 lines
1.9 KiB
C
|
// smallobject_policy_v7_box.h - SmallObject Policy v7 (Phase v7-4)
|
||
|
|
//
|
||
|
|
// Purpose:
|
||
|
|
// - Centralized routing policy for ULTRA / v7 / MID_v3 / LEGACY
|
||
|
|
// - Single source of truth for class → route_kind mapping
|
||
|
|
// - ENV configuration managed in one place (L3 Policy layer)
|
||
|
|
|
||
|
|
#ifndef HAKMEM_SMALLOBJECT_POLICY_V7_BOX_H
|
||
|
|
#define HAKMEM_SMALLOBJECT_POLICY_V7_BOX_H
|
||
|
|
|
||
|
|
#include <stdint.h>
|
||
|
|
#include <stdbool.h>
|
||
|
|
|
||
|
|
// ============================================================================
|
||
|
|
// Route Kind Enum (L0/L1/L1' layer selection)
|
||
|
|
// ============================================================================
|
||
|
|
|
||
|
|
typedef enum {
|
||
|
|
SMALL_ROUTE_ULTRA, // L0: C4-C7 ULTRA (FROZEN)
|
||
|
|
SMALL_ROUTE_V7, // L1: SmallObject v7 (research box)
|
||
|
|
SMALL_ROUTE_MID_V3, // L1': MID v3 (257-768B mid/small)
|
||
|
|
SMALL_ROUTE_LEGACY, // L1': TinyHeap v1 / Pool v1 (fallback)
|
||
|
|
} SmallRouteKind;
|
||
|
|
|
||
|
|
// ============================================================================
|
||
|
|
// Policy Snapshot Structure
|
||
|
|
// ============================================================================
|
||
|
|
|
||
|
|
typedef struct SmallPolicyV7 {
|
||
|
|
SmallRouteKind route_kind[8]; // C0-C7 routing decision
|
||
|
|
} SmallPolicyV7;
|
||
|
|
|
||
|
|
// ============================================================================
|
||
|
|
// Policy API
|
||
|
|
// ============================================================================
|
||
|
|
|
||
|
|
/// Get policy snapshot (read-only, TLS cached)
|
||
|
|
/// Frontend calls this to determine route_kind[class_idx]
|
||
|
|
const SmallPolicyV7* small_policy_v7_snapshot(void);
|
||
|
|
|
||
|
|
/// Initialize policy from ENV variables (called once at startup)
|
||
|
|
/// Priority: ULTRA > v7 > MID_v3 > LEGACY
|
||
|
|
/// @param policy: Policy structure to initialize
|
||
|
|
void small_policy_v7_init_from_env(SmallPolicyV7* policy);
|
||
|
|
|
||
|
|
/// Get route kind name for debugging
|
||
|
|
const char* small_route_kind_name(SmallRouteKind kind);
|
||
|
|
|
||
|
|
#endif // HAKMEM_SMALLOBJECT_POLICY_V7_BOX_H
|