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>
7.2 KiB
7.2 KiB
Larson Benchmark - 統合ガイド
🚀 クイックスタート
1. 基本的な使い方
# HAKMEM を実行（duration=2秒, threads=4）
./scripts/larson.sh hakmem 2 4
# 3者比較（HAKMEM vs mimalloc vs system）
./scripts/larson.sh battle 2 4
# Guard モード（デバッグ/安全性チェック）
./scripts/larson.sh guard 2 4
2. プロファイルを使った実行
# スループット最適化プロファイル
./scripts/larson.sh hakmem --profile tinyhot_tput 2 4
# カスタムプロファイルを作成
cp scripts/profiles/tinyhot_tput.env scripts/profiles/my_profile.env
# my_profile.env を編集
./scripts/larson.sh hakmem --profile my_profile 2 4
📋 コマンド一覧
ビルドコマンド
./scripts/larson.sh build # 全ターゲットをビルド
実行コマンド
./scripts/larson.sh hakmem <dur> <thr> # HAKMEM のみ実行
./scripts/larson.sh mi <dur> <thr> # mimalloc のみ実行
./scripts/larson.sh sys <dur> <thr> # system malloc のみ実行
./scripts/larson.sh battle <dur> <thr> # 3者比較 + 結果保存
デバッグコマンド
./scripts/larson.sh guard <dur> <thr> # Guard モード（全安全チェックON）
./scripts/larson.sh debug <dur> <thr> # Debug モード（性能+リングダンプ）
./scripts/larson.sh asan <dur> <thr> # AddressSanitizer
./scripts/larson.sh ubsan <dur> <thr> # UndefinedBehaviorSanitizer
./scripts/larson.sh tsan <dur> <thr> # ThreadSanitizer
🎯 プロファイル詳細
tinyhot_tput.env（スループット最適化）
用途: ベンチマークで最高性能を出す
設定:
- Tiny Fast Path: ON
- Fast Cap 0/1: 64
- Refill Count Hot: 64
- デバッグ: すべてOFF
実行例:
./scripts/larson.sh hakmem --profile tinyhot_tput 2 4
larson_guard.env（安全性/デバッグ）
用途: バグ再現、メモリ破壊の検出
設定:
- Trace Ring: ON
- Safe Free: ON (strict mode)
- Remote Guard: ON
- Fast Cap: 0（無効化）
実行例:
./scripts/larson.sh guard 2 4
larson_debug.env（性能+デバッグ）
用途: 性能測定しつつリングダンプ可能
設定:
- Tiny Fast Path: ON
- Trace Ring: ON（SIGUSR2でダンプ可能）
- Safe Free: OFF（性能重視）
- Debug Counters: ON
実行例:
./scripts/larson.sh debug 2 4
🔧 環境変数の確認（本線=セグフォ無し）
実行前に環境変数が表示されます：
[larson.sh] ==========================================
[larson.sh] Environment Configuration:
[larson.sh] ==========================================
[larson.sh] Tiny Fast Path: 1
[larson.sh] SuperSlab: 1
[larson.sh] SS Adopt: 1
[larson.sh] Box Refactor: 1
[larson.sh] Fast Cap 0: 64
[larson.sh] Fast Cap 1: 64
[larson.sh] Refill Count Hot: 64
[larson.sh] ...
🧯 安全ガイド（必ず通すチェック）
- Guard モード（Fail‑Fast + リング）:
./scripts/larson.sh guard 2 4 - ASan/UBSan/TSan:
./scripts/larson.sh asan 2 4/ubsan/tsan - 期待するログ:
remote_invalid/SENTINEL_TRAPが出ないこと。出る場合は採用境界以外で drain/bind/owner を触っていないかを確認。
🏆 Battle モード（3者比較）
自動で以下を実行:
- 全ターゲットをビルド
- HAKMEM, mimalloc, system を同一条件で実行
- 結果を
benchmarks/results/snapshot_YYYYmmdd_HHMMSS/に保存 - スループット比較を表示
実行例:
./scripts/larson.sh battle 2 4
出力:
Results saved to: benchmarks/results/snapshot_20251105_123456/
Summary:
hakmem.txt:Throughput = 4740839 operations per second
mimalloc.txt:Throughput = 4500000 operations per second
system.txt:Throughput = 13500000 operations per second
🛠 トラブル対応（ハング・ログ見えない）
- 既定のランスクリプトはタイムアウトとログ保存を有効化しました（2025‑11‑06以降）。
- 実行結果は
scripts/bench_results/larson_<name>_<thr>T_<dur>s_<min>-<max>.{stdout,stderr,txt}に保存されます。 stderrは捨てずに保存します（以前は/dev/nullへ捨てていました）。- ベンチ本体が固まっても
timeoutで強制終了し、スクリプトがブロックしません。
- 実行結果は
- 途中停止の見分け方:
txtに「(no Throughput line)」と出た場合はstdout/stderrを確認してください。- スレッド数は
== <name> threads=<N> ==とファイル名の<N>Tで確認できます。
- 古いプロセスが残った場合の掃除:
pkill -f larson_hakmem || true- もしくは
ps -ef | grep larson_で PID を確認してkill -9 <PID>
📊 カスタムプロファイルの作成
テンプレート
# my_profile.env
export HAKMEM_TINY_FAST_PATH=1
export HAKMEM_USE_SUPERSLAB=1
export HAKMEM_TINY_SS_ADOPT=1
export HAKMEM_TINY_FAST_CAP_0=32
export HAKMEM_TINY_FAST_CAP_1=32
export HAKMEM_TINY_REFILL_COUNT_HOT=32
export HAKMEM_TINY_TRACE_RING=0
export HAKMEM_TINY_SAFE_FREE=0
export HAKMEM_DEBUG_COUNTERS=0
export HAKMEM_TINY_PHASE6_BOX_REFACTOR=1
使用
cp scripts/profiles/tinyhot_tput.env scripts/profiles/my_profile.env
vim scripts/profiles/my_profile.env # 編集
./scripts/larson.sh hakmem --profile my_profile 2 4
🐛 トラブルシューティング
ビルドエラー
# クリーンビルド
make clean
./scripts/larson.sh build
mimalloc がビルドできない
# mimalloc をスキップして実行
./scripts/larson.sh hakmem 2 4
環境変数が反映されない
# プロファイルが正しく読み込まれているか確認
cat scripts/profiles/tinyhot_tput.env
# 環境を手動設定して実行
export HAKMEM_TINY_FAST_PATH=1
./scripts/larson.sh hakmem 2 4
📝 既存スクリプトとの関係
新しい統合スクリプト（推奨）:
scripts/larson.sh- すべてをここから実行
既存スクリプト（後方互換）:
scripts/run_larson_claude.sh- まだ使える（将来的に deprecated）scripts/run_larson_defaults.sh- larson.sh に移行推奨
🎯 典型的なワークフロー
性能測定
# 1. スループット測定
./scripts/larson.sh hakmem --profile tinyhot_tput 2 4
# 2. 3者比較
./scripts/larson.sh battle 2 4
# 3. 結果確認
ls -la benchmarks/results/snapshot_*/
バグ調査
# 1. Guard モードで再現
./scripts/larson.sh guard 2 4
# 2. ASAN で詳細確認
./scripts/larson.sh asan 2 4
# 3. リングダンプで解析（debug モード + SIGUSR2）
./scripts/larson.sh debug 2 4 &
PID=$!
sleep 1
kill -SIGUSR2 $PID # リングダンプ
A/B テスト
# プロファイルA
./scripts/larson.sh hakmem --profile profile_a 2 4
# プロファイルB
./scripts/larson.sh hakmem --profile profile_b 2 4
# 比較
grep "Throughput" benchmarks/results/snapshot_*/*.txt
📚 関連ドキュメント
- CLAUDE.md - プロジェクト概要
- PHASE6_3_FIX_SUMMARY.md - Tiny Fast Path 実装
- ENV_VARS.md - 環境変数リファレンス