Files
hakmem/core/box/wrapper_env_cache_box.h
Moe Charm (CI) 19056282b6 Phase 3 D2: Wrapper Env Cache - [DECISION: NO-GO]
Target: Reduce wrapper_env_cfg() overhead in malloc/free hot path
- Strategy: Cache wrapper env configuration pointer in TLS
- Approach: Fast pointer cache (TLS caches const wrapper_env_cfg_t*)

Implementation:
- core/box/wrapper_env_cache_env_box.h: ENV gate (HAKMEM_WRAP_ENV_CACHE)
- core/box/wrapper_env_cache_box.h: TLS cache layer (wrapper_env_cfg_fast)
- core/box/hak_wrappers.inc.h: Integration into malloc/free hot paths
- ENV gate: HAKMEM_WRAP_ENV_CACHE=0/1 (default OFF)

A/B Test Results (Mixed, 10-run, 20M iters):
- Baseline (D2=0): 46.52M ops/s (avg), 46.47M ops/s (median)
- Optimized (D2=1): 45.85M ops/s (avg), 45.98M ops/s (median)
- Improvement: avg -1.44%, median -1.05% (DECISION: NO-GO)

Analysis:
- Regression cause: TLS cache adds overhead (branch + TLS access)
- wrapper_env_cfg() is already minimal (pointer return after simple check)
- Adding TLS caching layer makes it worse, not better
- Branch prediction penalty outweighs any potential savings

Cumulative Phase 2-3:
- B3: +2.89%, B4: +1.47%, C3: +2.20%
- D1: +1.06% (opt-in), D2: -1.44% (NO-GO)
- Total: ~7.2% (excluding D2)

Decision: FREEZE as research box (default OFF, regression confirmed)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2025-12-13 22:03:27 +09:00

26 lines
1.1 KiB
C

// wrapper_env_cache_box.h - TLS cache layer for wrapper env config (Phase 3 D2)
// Purpose: Eliminate repeated wrapper_env_cfg() calls in malloc/free hot path
// Strategy: Cache the const pointer in TLS (safe, no refresh sync needed)
#pragma once
#include "wrapper_env_box.h" // wrapper_env_cfg()
#include "wrapper_env_cache_env_box.h" // wrap_env_cache_enabled()
// Fast pointer cache: TLS caches the pointer to g_wrapper_env
// Safety: wrapper_env_refresh_from_env() doesn't change the pointer address,
// only the content of g_wrapper_env, so TLS cache remains valid.
static inline const wrapper_env_cfg_t* wrapper_env_cfg_fast(void) {
if (__builtin_expect(!wrap_env_cache_enabled(), 1)) {
// Cache disabled (default): use baseline wrapper_env_cfg()
return wrapper_env_cfg();
}
// Cache enabled: TLS fast pointer
static __thread const wrapper_env_cfg_t* cached_ptr = NULL;
if (__builtin_expect(cached_ptr == NULL, 0)) {
// First access: initialize TLS cache with pointer to g_wrapper_env
cached_ptr = wrapper_env_cfg();
}
return cached_ptr;
}