47 lines
1.6 KiB
C
47 lines
1.6 KiB
C
|
// Box: ACE (Adaptive Control Engine)
|
||
|
|
// Purpose: Dynamic SuperSlab size adaptation based on allocation patterns
|
||
|
|
//
|
||
|
|
// Responsibilities:
|
||
|
|
// - Maintain ACE state per size class (hot_score, current_lg, target_lg)
|
||
|
|
// - Provide ACE-aware size selection for SuperSlab allocation
|
||
|
|
// - Implement promotion/demotion logic (1MB ↔ 2MB)
|
||
|
|
// - Registry-based observation with zero hot-path overhead
|
||
|
|
// - Periodic tick function for counter decay
|
||
|
|
//
|
||
|
|
// Dependencies:
|
||
|
|
// - hakmem_super_registry (for registry-based observation)
|
||
|
|
// - hakmem_tiny_superslab.h (for SuperSlabACEState, TINY_NUM_CLASSES_SS)
|
||
|
|
//
|
||
|
|
// API:
|
||
|
|
// - hak_tiny_superslab_next_lg() - ACE-aware size selection
|
||
|
|
// - hak_tiny_superslab_ace_tick() - periodic ACE tick (counter decay)
|
||
|
|
// - hak_tiny_superslab_ace_observe_all() - learner thread API (registry scan)
|
||
|
|
// - superslab_ace_print_stats() - ACE statistics
|
||
|
|
|
||
|
|
#ifndef SS_ACE_BOX_H
|
||
|
|
#define SS_ACE_BOX_H
|
||
|
|
|
||
|
|
#include "hakmem_tiny_superslab.h"
|
||
|
|
#include <stdint.h>
|
||
|
|
|
||
|
|
// ACE state (global, per-class)
|
||
|
|
extern SuperSlabACEState g_ss_ace[TINY_NUM_CLASSES_SS];
|
||
|
|
|
||
|
|
// ACE-aware size selection
|
||
|
|
static inline uint8_t hak_tiny_superslab_next_lg(int class_idx);
|
||
|
|
|
||
|
|
// Optional: runtime profile switch for ACE thresholds (index-based).
|
||
|
|
// Profiles are defined in ss_ace_box.c and selected via env or this setter.
|
||
|
|
void hak_tiny_superslab_ace_set_profile(int idx);
|
||
|
|
|
||
|
|
// ACE tick function (counter decay)
|
||
|
|
void hak_tiny_superslab_ace_tick(int class_idx, uint64_t now);
|
||
|
|
|
||
|
|
// Registry-based observation (learner thread API)
|
||
|
|
void hak_tiny_superslab_ace_observe_all(void);
|
||
|
|
|
||
|
|
// ACE statistics
|
||
|
|
void superslab_ace_print_stats(void);
|
||
|
|
|
||
|
|
#endif // SS_ACE_BOX_H
|