Phase FREE-DISPATCHER-OPT-1: free dispatcher 統計計測

**目的**: free dispatcher(29%)の内訳を細分化して計測。

**実装内容**:
- FreeDispatchStats 構造体追加(ENV: HAKMEM_FREE_DISPATCH_STATS, default 0)
- カウンタ: total_calls / domain (tiny/mid/large) / route (ultra/legacy/pool/v6) / env_checks / route_for_class_calls
- hak_free_at / tiny_route_for_class / tiny_route_snapshot_init にカウンタ埋め込み
- 挙動変更なし(計測のみ、ENV OFF 時は overhead ゼロ)

**計測結果**:

Mixed 16-1024B (1M iter, ws=400):
- total=8,081, route_calls=267,967, env_checks=9
- BENCH_FAST_FRONT により大半は早期リターン
- route_for_class は主に alloc 側で呼ばれる(267k calls vs 8k frees)
- ENV check は初期化時の 9回のみ(snapshot 効果)

C6-heavy (257-768B, 1M iter, ws=400):
- total=500,099, route_calls=1,034, env_checks=9
- fg_classify_domain に到達する free が多い
- route_for_class 呼び出しは極小(snapshot 効果)

**結論**:
- ENV check は既に十分最適化されている(初期化時のみ)
- route_for_class は alloc 側での呼び出しが主で、free 側は snapshot で O(1)
- 次フェーズ(OPT-2)では別のアプローチを検討

**ドキュメント追加**:
- docs/analysis/FREE_DISPATCHER_ANALYSIS.md(新規)
- CURRENT_TASK.md に Phase FREE-DISPATCHER-OPT-1 セクション追加

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Moe Charm (CI)
2025-12-11 21:21:40 +09:00
parent 11dc9d390a
commit 118c0e4857
15 changed files with 647 additions and 6 deletions

View File

@ -11,6 +11,7 @@
#include "external_guard_box.h" // Phase 15: Box ExternalGuard - mincore (ENV controlled)
#include "fg_tiny_gate_box.h" // Tiny gate guard box (Superslab check)
#include "tiny_free_gate_box.h" // Tiny Free Gatekeeper Box (USER→Fast Path 境界)
#include "free_dispatch_stats_box.h" // Phase FREE-DISPATCHER-OPT-1: free dispatcher stats
#ifdef HAKMEM_POOL_TLS_PHASE1
#include "../pool_tls.h"
@ -80,6 +81,9 @@ __attribute__((always_inline))
inline
#endif
void hak_free_at(void* ptr, size_t size, hak_callsite_t site) {
// Phase FREE-DISPATCHER-OPT-1: Total call counter (at function entry)
FREE_DISPATCH_STAT_INC(total_calls);
#if HAKMEM_DEBUG_TIMING
HKM_TIME_START(t0);
#endif
@ -141,6 +145,22 @@ void hak_free_at(void* ptr, size_t size, hak_callsite_t site) {
fg = fg_guard.fg;
fg_misclass = fg_guard.misclassified;
// Phase FREE-DISPATCHER-OPT-1: Domain classification counters
if (__builtin_expect(free_dispatch_stats_enabled(), 0)) {
switch (fg.domain) {
case FG_DOMAIN_TINY:
g_free_dispatch_stats.domain_tiny++;
break;
case FG_DOMAIN_MIDCAND:
case FG_DOMAIN_POOL:
g_free_dispatch_stats.domain_mid++;
break;
case FG_DOMAIN_EXTERNAL:
g_free_dispatch_stats.domain_large++;
break;
}
}
switch (fg.domain) {
case FG_DOMAIN_TINY: {
// Phase FREE-FRONT-V3-2: v3 snapshot routing (optional, default OFF)