|
|
db9c06211e
|
Phase 21-1-A: Ring cache 基本実装 - Array-based TLS cache (C2/C3)
## Summary
Phase 21-1-A の基本実装完了。Ring buffer ベースの TLS cache を C2/C3
（33-128B）専用に実装。ポインタチェイス削減で +15-20% 性能向上を目指す。
## Implementation
**Files Created**:
- `core/front/tiny_ring_cache.h` - Ring cache API, ENV control
- `core/front/tiny_ring_cache.c` - Ring cache implementation
**Makefile Integration**:
- Added `core/front/tiny_ring_cache.o` to OBJS_BASE
- Added `core/front/tiny_ring_cache_shared.o` to SHARED_OBJS
- Added `core/front/tiny_ring_cache.o` to BENCH_HAKMEM_OBJS_BASE
## Design (Task 先生調査結果 + ChatGPT フィードバック)
**Ring Buffer Structure**:
- C2/C3 専用（hot classes, 33-128B）
- Default 128 slots (power-of-2, ENV で 64/128/256 A/B 可能)
- Ultra-fast pop/push (1-2 instructions, array access)
- Fast modulo via mask (capacity - 1)
**Hierarchy** (Option 4: UltraHot 置き換え):
```
Ring (L0, C2/C3 専用) → HeapV2 (L1, fallback) → TLS SLL (L2) → SuperSlab (L3)
```
**Rationale**:
- UltraHot の C3 問題（5.8% hit rate）を根本解決
- Phase 19-3 の +12.9%（UltraHot 除去）を維持
- Ring サイズ（128）>> UltraHot（4）→ hit rate 大幅向上期待
**Performance Goal**:
- Pointer chasing: TLS SLL 1 回 → Ring 0 回
- Memory access: 3 → 2 回
- Cache locality: 配列（連続メモリ）vs linked list
- Expected: +15-20% (54.4M → 62-65M ops/s)
## ENV Variables
```bash
HAKMEM_TINY_HOT_RING_ENABLE=1 # Ring 有効化 (default: 0)
HAKMEM_TINY_HOT_RING_C2=128 # C2 サイズ (default: 128)
HAKMEM_TINY_HOT_RING_C3=128 # C3 サイズ (default: 128)
HAKMEM_TINY_HOT_RING_CASCADE=1 # SLL → Ring refill (default: 0)
```
## Implementation Status
Phase 21-1-A: ✅ **COMPLETE**
- Ring buffer data structure
- TLS variables
- ENV control (enable/capacity)
- Power-of-2 capacity (fast modulo)
- Ultra-fast pop/push inline functions
- Refill from SLL (scaffold)
- Init/shutdown/stats (scaffold)
- Makefile integration
- Compile success
Phase 21-1-B: ⏳ **NEXT** - Alloc/Free 統合
Phase 21-1-C: ⏳ **PENDING** - Refill/Cascade 実装
Phase 21-1-D: ⏳ **PENDING** - A/B テスト
## Next Steps
1. Alloc path 統合 (`core/tiny_alloc_fast.inc.h`)
2. Free path 統合 (`core/tiny_free_fast_v2.inc.h`)
3. Init call from `hakmem_tiny.c`
4. A/B test: Ring vs UltraHot vs Baseline
🎯 Target: 62-65M ops/s (+15-20% vs 54.4M baseline)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-11-16 07:32:24 +09:00 |
|
