75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
|
# Phase 23: Per-op Default-OFF Tax Prune (compile-out write-once + unified-cache measurement)
|
|||
|
|
|
|||
|
|
**Status**: ⚪ NEUTRAL（compile gate は維持、リンク除外はしない）
|
|||
|
|
|
|||
|
|
## Problem statement
|
|||
|
|
|
|||
|
|
過去の Phase 22（Research Box Prune）で確認したパターンの再適用：
|
|||
|
|
|
|||
|
|
- 研究用の機能が **default OFF** なのに、
|
|||
|
|
- hot path が毎回 `if (enabled())` / TLS read / small branch を払ってしまう
|
|||
|
|
|
|||
|
|
特に alloc/free が十分に速くなった後は、この種の **固定税（per-op tax）** が残りやすい。
|
|||
|
|
|
|||
|
|
## Goal
|
|||
|
|
|
|||
|
|
default OFF の knobs を **compile-out** できるようにし、hot/cold の固定税をゼロに寄せる。
|
|||
|
|
|
|||
|
|
- ✅ compile-out: `#if HAKMEM_*_COMPILED`（Phase 22 の勝ち筋）
|
|||
|
|
- ❌ link-out: Makefile から `.o` を抜く（Phase 22-2 の NO-GO）
|
|||
|
|
|
|||
|
|
## Scope (v1)
|
|||
|
|
|
|||
|
|
### A) Phase 5 E5-2: Header Write-Once
|
|||
|
|
|
|||
|
|
Compile gate:
|
|||
|
|
- `HAKMEM_TINY_HEADER_WRITE_ONCE_COMPILED=0/1`（default: 0）
|
|||
|
|
|
|||
|
|
効果：
|
|||
|
|
- `HAKMEM_TINY_HEADER_WRITE_ONCE` が default OFF のままでも、
|
|||
|
|
`tiny_header_finalize_alloc()` が毎回 ENV gate を評価する固定税を除去できる。
|
|||
|
|
|
|||
|
|
対象：
|
|||
|
|
- `core/box/tiny_header_box.h`: `tiny_header_finalize_alloc()`
|
|||
|
|
- `core/front/tiny_unified_cache.c`: `unified_cache_prefill_headers()`
|
|||
|
|
|
|||
|
|
### B) Unified Cache measurement (ENV-gated instrumentation)
|
|||
|
|
|
|||
|
|
Compile gate:
|
|||
|
|
- `HAKMEM_TINY_UNIFIED_CACHE_MEASURE_COMPILED=0/1`（default: 0）
|
|||
|
|
|
|||
|
|
効果：
|
|||
|
|
- hot path の `unified_cache_measure_check()` 呼び出しと、
|
|||
|
|
refill 側の測定コードを compile-out できる。
|
|||
|
|
|
|||
|
|
対象：
|
|||
|
|
- `core/front/tiny_unified_cache.h`: hit-path の measurement update（既に `#if` でガード）
|
|||
|
|
- `core/front/tiny_unified_cache.c`: refill-side measurement
|
|||
|
|
|
|||
|
|
## Box Theory framing
|
|||
|
|
|
|||
|
|
- BuildFlagsBox（`core/hakmem_build_flags.h`）で compile-time 境界を作る。
|
|||
|
|
- Rollback は build flag のみ（runtime ではなく build-time の“戻せる”）。
|
|||
|
|
- Link set は固定（`.o` を外さない）。
|
|||
|
|
|
|||
|
|
## A/B plan (build-level)
|
|||
|
|
|
|||
|
|
原則：**同じコードで、compile gate だけを切り替える**。
|
|||
|
|
|
|||
|
|
1) baseline（default, compile-out）
|
|||
|
|
- `make clean && make -j bench_random_mixed_hakmem`
|
|||
|
|
- `scripts/run_mixed_10_cleanenv.sh`
|
|||
|
|
|
|||
|
|
2) compiled-in（研究用）
|
|||
|
|
- `make clean && make -j EXTRA_CFLAGS='-DHAKMEM_TINY_HEADER_WRITE_ONCE_COMPILED=1 -DHAKMEM_TINY_UNIFIED_CACHE_MEASURE_COMPILED=1' bench_random_mixed_hakmem`
|
|||
|
|
- `scripts/run_mixed_10_cleanenv.sh`
|
|||
|
|
|
|||
|
|
## GO/NO-GO
|
|||
|
|
|
|||
|
|
この種の “prune” は layout 変化が絡むため、判断は保守的に運用する：
|
|||
|
|
|
|||
|
|
- GO: +0.5% 以上
|
|||
|
|
- NEUTRAL: ±0.5%
|
|||
|
|
- NO-GO: -0.5% 以下（revert 推奨）
|
|||
|
|
|