Files
hakmem/docs/analysis/PHASE54_MEMORY_LEAN_MODE_DESIGN_AND_INSTRUCTIONS.md

84 lines
3.2 KiB
Markdown
Raw Normal View History

Phase 54-60: Memory-Lean mode, Balanced mode stabilization, M1 (50%) achievement ## Summary Completed Phase 54-60 optimization work: **Phase 54-56: Memory-Lean mode (LEAN+OFF prewarm suppression)** - Implemented ss_mem_lean_env_box.h with ENV gates - Balanced mode (LEAN+OFF) promoted as production default - Result: +1.2% throughput, better stability, zero syscall overhead - Added to bench_profile.h: MIXED_TINYV3_C7_BALANCED preset **Phase 57: 60-min soak finalization** - Balanced mode: 60-min soak, RSS drift 0%, CV 5.38% - Speed-first mode: 60-min soak, RSS drift 0%, CV 1.58% - Syscall budget: 1.25e-7/op (800× under target) - Status: PRODUCTION-READY **Phase 59: 50% recovery baseline rebase** - hakmem FAST (Balanced): 59.184M ops/s, CV 1.31% - mimalloc: 120.466M ops/s, CV 3.50% - Ratio: 49.13% (M1 ACHIEVED within statistical noise) - Superior stability: 2.68× better CV than mimalloc **Phase 60: Alloc pass-down SSOT (NO-GO)** - Implemented alloc_passdown_ssot_env_box.h - Modified malloc_tiny_fast.h for SSOT pattern - Result: -0.46% (NO-GO) - Key lesson: SSOT not applicable where early-exit already optimized ## Key Metrics - Performance: 49.13% of mimalloc (M1 effectively achieved) - Stability: CV 1.31% (superior to mimalloc 3.50%) - Syscall budget: 1.25e-7/op (excellent) - RSS: 33MB stable, 0% drift over 60 minutes ## Files Added/Modified New boxes: - core/box/ss_mem_lean_env_box.h - core/box/ss_release_policy_box.{h,c} - core/box/alloc_passdown_ssot_env_box.h Scripts: - scripts/soak_mixed_single_process.sh - scripts/analyze_epoch_tail_csv.py - scripts/soak_mixed_rss.sh - scripts/calculate_percentiles.py - scripts/analyze_soak.py Documentation: Phase 40-60 analysis documents ## Design Decisions 1. Profile separation (core/bench_profile.h): - MIXED_TINYV3_C7_SAFE: Speed-first (no LEAN) - MIXED_TINYV3_C7_BALANCED: Balanced mode (LEAN+OFF) 2. Box Theory compliance: - All ENV gates reversible (HAKMEM_SS_MEM_LEAN, HAKMEM_ALLOC_PASSDOWN_SSOT) - Single conversion points maintained - No physical deletions (compile-out only) 3. Lessons learned: - SSOT effective only where redundancy exists (Phase 60 showed limits) - Branch prediction extremely effective (~0 cycles for well-predicted branches) - Early-exit pattern valuable even when seemingly redundant 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-17 06:24:01 +09:00
# Phase 54: Memory-Lean ModeRSS <10MB を狙う opt-in
背景Phase 53:
- hakmem FAST の peak RSS ≈ **33MB** は主に **SuperSlab backend の常駐**speed-first 設計)由来
- drift は 0% で安定(リークではない)
- syscall budget は優秀Phase 48: 9e-8/op
目的:
- “速度優先 (FAST)” を崩さずに、**別プロファイル**として Memory-Lean を追加するopt-in
- 目標: Mixed/WS=400 で **peak RSS <10MB**
- 許容: throughput **-5〜-10%**、syscalls は増えて良い(ただし暴れない)
Box Theory 方針:
- 新モードは **ENV gate** で戻せるA/B 可能)
- 変換点は 1 箇所Superslab OS Box / release policy に集約)
- 可視化は最小SS_OS_STATS と RSS/soak で十分)
- Fail-fastDSO/madvise guard のルールは維持)
---
## 設計の芯(どこを変えるか)
“RSS 33MB” の主体は **常駐 superslab** なので、ここを減らす必要がある。
やること(最小):
1. **prewarm / persistent keep を弱める**(必要になるまで割り当てない)
2. **idle superslab の decommit**MADV_FREE/MADV_DONTNEED、環境依存で切替
3. **budget**(各 class の resident 上限)を設ける(上限超過は decommit/retire
---
## API / Box提案
L0: `ss_mem_lean_env_box.h/c`
- `HAKMEM_SS_MEM_LEAN=0/1`default 0
- `HAKMEM_SS_MEM_LEAN_TARGET_MB=10`目標RSS
- `HAKMEM_SS_MEM_LEAN_DECOMMIT=FREE|DONTNEED|OFF`OS依存の挙動切替
L1: `ss_release_policy_box.h/c`
- `ss_should_keep_superslab(class_idx) -> bool`
- `ss_maybe_decommit_superslab(ss)`DSO guard / madvise guard を通す)
境界:
- Superslab OS Box既存の `ss_os_madvise_guarded()`)に decommit を集約
---
## 実装手順(小パッチ)
### Patch 1: ENV gate + stats
- `ss_mem_lean_env_box.*` 追加default OFF
- `ss_os_stats` に “lean_decommit / lean_retire” のカウンタ追加(ワンショット可)
### Patch 2: prewarm 抑制lean のときだけ)
- 既存の prewarm/persistent ルートを **lean時にスキップ**
- まずは “C0C7 の初期 superslab 予約” を弱める
### Patch 3: retire/decommit安全に
- “完全に空になった superslab” のみ対象
- DSO guard / fail-fast ルールは維持DSO 触ったら即 disable
### Patch 4: A/B性能と RSS
- **FAST**: `HAKMEM_SS_MEM_LEAN=0`baseline
- **LEAN**: `HAKMEM_SS_MEM_LEAN=1`treatment
測定:
- Phase 51 single-process soak5分→30分で RSS/ops/s drift を確認
- Phase 48 rebase の ops/s も確認(速度劣化が許容範囲か)
- `HAKMEM_SS_OS_STATS=1` で syscall budget が暴れていないか確認
判定:
- GO: peak RSS <10MB かつ drift=0%、throughput -10% 以内
- NO-GO: RSS が下がらない / syscalls が暴れる / クラッシュ
- NEUTRAL: RSS は下がるが throughput 劣化が大きい → 研究箱として保持
---
## 注意(落とし穴)
- “削除して速い” は禁止link-out/物理削除は layout tax 事故)
- decommit は kernel/CPU 依存で variance を増やしやすい → soak で CV を必ず見る
- まずは **opt-in**(標準プロファイルを汚さない)