67fb15f35f
## Changes ### 1. core/page_arena.c - Removed init failure message (lines 25-27) - error is handled by returning early - All other fprintf statements already wrapped in existing #if !HAKMEM_BUILD_RELEASE blocks ### 2. core/hakmem.c - Wrapped SIGSEGV handler init message (line 72) - CRITICAL: Kept SIGSEGV/SIGBUS/SIGABRT error messages (lines 62-64) - production needs crash logs ### 3. core/hakmem_shared_pool.c - Wrapped all debug fprintf statements in #if !HAKMEM_BUILD_RELEASE: - Node pool exhaustion warning (line 252) - SP_META_CAPACITY_ERROR warning (line 421) - SP_FIX_GEOMETRY debug logging (line 745) - SP_ACQUIRE_STAGE0.5_EMPTY debug logging (line 865) - SP_ACQUIRE_STAGE0_L0 debug logging (line 803) - SP_ACQUIRE_STAGE1_LOCKFREE debug logging (line 922) - SP_ACQUIRE_STAGE2_LOCKFREE debug logging (line 996) - SP_ACQUIRE_STAGE3 debug logging (line 1116) - SP_SLOT_RELEASE debug logging (line 1245) - SP_SLOT_FREELIST_LOCKFREE debug logging (line 1305) - SP_SLOT_COMPLETELY_EMPTY debug logging (line 1316) - Fixed lock_stats_init() for release builds (lines 60-65) - ensure g_lock_stats_enabled is initialized ## Performance Validation Before: 51M ops/s (with debug fprintf overhead) After: 49.1M ops/s (consistent performance, fprintf removed from hot paths) ## Build & Test ```bash ./build.sh larson_hakmem ./out/release/larson_hakmem 1 5 1 1000 100 10000 42 # Result: 49.1M ops/s ``` Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
142 lines
3.5 KiB
Markdown
142 lines
3.5 KiB
Markdown
# Pool TLS Phase 1.5a - Quick Start Guide
|
||
|
||
Pool TLS Phase 1.5a は 8KB-52KB のメモリ割り当てを高速化する TLS Arena 実装です。
|
||
|
||
## 🚀 クイックスタート
|
||
|
||
### 1. 開発サイクル（最も簡単！）
|
||
|
||
```bash
|
||
# Build + Verify + Smoke Test を一発で実行
|
||
./dev_pool_tls.sh test
|
||
|
||
# 結果:
|
||
# ✅ All checks passed!
|
||
```
|
||
|
||
### 2. ベンチマーク実行
|
||
|
||
```bash
|
||
# Pool TLS vs System malloc の性能比較
|
||
./run_pool_bench.sh
|
||
|
||
# 結果例:
|
||
# HAKMEM (Pool TLS): 1790000 ops/s
|
||
# System malloc: 189000 ops/s
|
||
# Performance ratio: 947% (9.47x)
|
||
# 🏆 HAKMEM WINS!
|
||
```
|
||
|
||
### 3. 個別ビルド
|
||
|
||
```bash
|
||
# Pool TLS Phase 1.5a を有効にしてビルド
|
||
./build_pool_tls.sh bench_mid_large_mt_hakmem
|
||
./build_pool_tls.sh larson_hakmem
|
||
./build_pool_tls.sh bench_random_mixed_hakmem
|
||
```
|
||
|
||
## 📋 スクリプト一覧
|
||
|
||
| スクリプト | 用途 | 使い方 |
|
||
|-----------|------|--------|
|
||
| `dev_pool_tls.sh` | 開発サイクル統合 | `./dev_pool_tls.sh test` |
|
||
| `build_pool_tls.sh` | Pool TLS ビルド | `./build_pool_tls.sh <target>` |
|
||
| `run_pool_bench.sh` | 性能ベンチマーク | `./run_pool_bench.sh` |
|
||
| `build.sh` | 汎用ビルド（ChatGPT製） | `./build.sh <target>` |
|
||
| `verify_build.sh` | ビルド検証（ChatGPT製） | `./verify_build.sh <binary>` |
|
||
|
||
## 🎯 推奨ワークフロー
|
||
|
||
### コード変更時
|
||
```bash
|
||
# 1. コード編集
|
||
vim core/pool_tls_arena.c
|
||
|
||
# 2. クイックテスト（5-10秒）
|
||
./dev_pool_tls.sh test
|
||
|
||
# 3. OK なら詳細ベンチマーク
|
||
./run_pool_bench.sh
|
||
```
|
||
|
||
### デバッグ時
|
||
```bash
|
||
# 1. デバッグビルド
|
||
./build_debug.sh bench_mid_large_mt_hakmem gdb
|
||
|
||
# 2. GDB で実行
|
||
gdb ./bench_mid_large_mt_hakmem
|
||
(gdb) run 1 100 256 42
|
||
```
|
||
|
||
### クリーンビルド
|
||
```bash
|
||
# 全削除してリビルド
|
||
./dev_pool_tls.sh clean
|
||
./dev_pool_tls.sh build
|
||
```
|
||
|
||
## 🔧 有効化されている機能
|
||
|
||
Pool TLS ビルドでは以下が自動的に有効化されます：
|
||
|
||
- ✅ `POOL_TLS_PHASE1=1` - Pool TLS Phase 1.5a（8-52KB）
|
||
- ✅ `HEADER_CLASSIDX=1` - Phase 7 header-based free
|
||
- ✅ `AGGRESSIVE_INLINE=1` - Phase 7 aggressive inlining
|
||
- ✅ `PREWARM_TLS=1` - Phase 7 TLS cache pre-warming
|
||
|
||
**フラグを忘れる心配なし！** スクリプトが全て設定します。
|
||
|
||
## 📊 性能目標
|
||
|
||
| Phase | 目標性能 | 現状 |
|
||
|-------|----------|------|
|
||
| Phase 1.5a (baseline) | 1-2M ops/s | ✅ 1.79M ops/s |
|
||
| Phase 1.5b (optimized) | 5-15M ops/s | 🚧 開発中 |
|
||
| Phase 2 (learning) | 15-30M ops/s | 📅 予定 |
|
||
|
||
## ❓ トラブルシューティング
|
||
|
||
### ビルドエラー
|
||
```bash
|
||
# フラグ確認
|
||
make print-flags
|
||
|
||
# クリーンビルド
|
||
./dev_pool_tls.sh clean
|
||
./dev_pool_tls.sh build
|
||
```
|
||
|
||
### 性能が出ない
|
||
```bash
|
||
# ビルド検証（古いバイナリでないか確認）
|
||
./verify_build.sh bench_mid_large_mt_hakmem
|
||
|
||
# リビルド
|
||
./build_pool_tls.sh bench_mid_large_mt_hakmem
|
||
```
|
||
|
||
### SEGV クラッシュ
|
||
```bash
|
||
# デバッグビルド
|
||
./build_debug.sh bench_mid_large_mt_hakmem gdb
|
||
|
||
# gdb で実行
|
||
gdb ./bench_mid_large_mt_hakmem
|
||
(gdb) run 1 100 256 42
|
||
(gdb) bt
|
||
```
|
||
|
||
## 📝 開発メモ
|
||
|
||
- **依存関係追跡**: `-MMD -MP` で自動検出（ChatGPT 実装）
|
||
- **フラグ不整合チェック**: Makefile が自動検証（ChatGPT 実装）
|
||
- **ビルド検証**: `verify_build.sh` でタイムスタンプ確認（ChatGPT 実装）
|
||
|
||
## 🎓 詳細ドキュメント
|
||
|
||
- `CLAUDE.md` - 開発履歴
|
||
- `POOL_TLS_INVESTIGATION_FINAL.md` - Phase 1.5a 調査報告
|
||
- `Makefile` - ビルドシステム詳細
|