tomoaki/hakmem
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b51b600e8d626601e1deca96d044cd10674c7cb1
hakmem/docs/status/ROOT_MD_MOVE_PLAN.md
Moe Charm (CI) 67fb15f35f Wrap debug fprintf in !HAKMEM_BUILD_RELEASE guards (Release build optimization) 
## 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>
2025-11-26 13:14:18 +09:00

14 KiB
Raw Blame History

Root Markdown Move Plan (Phase 1 draft)

  • Scope: root-level .md files only. Nothing has been moved yet.
  • Method: heuristic classification by prefix/keywords into target “boxes”.
    • Keep root: README.md, DOCS_INDEX.md, HISTORY.md, AGENTS.md.
    • specs/env: ENV_VARS*, HAKO_MIR_FFI_SPEC.md.
    • status: PHASE*, P0_*, *_COMPLETION_REPORT, TASK_FOR*, cleanup/source-map.
    • analysis/bug: *ROOT_CAUSE*, *INVESTIGATION*, *ANALYSIS*, *CRASH*, *CORRUPTION*, *SEGV*, *SEGFAULT*, *BUG*, *FAILURE*, FALSE_POSITIVE*, L1D_*.
    • design: BOX_THEORY*, BOX3_REFACTORING*, CENTRAL_ROUTER*, REGION_ID_DESIGN*, REFACTOR*, SUPERSLAB_BOX*, PHASE12_*DESIGN*, anything with DESIGN, ARCHITECTURE, IMPLEMENTATION_GUIDE, QUICK_START, ROADMAP, PLAN.
    • benchmarks/perf: contains BENCH, PERF, PERFORMANCE, LARSON, MID_LARGE, OPTIMIZATION_QUICK_SUMMARY, COMPREHENSIVE_BENCHMARK, BENCHMARK_SUMMARY.
    • default: docs/archive/.
file target rule
100K_SEGV_ROOT_CAUSE_FINAL.md docs/analysis/ analysis/bug
ACE_INVESTIGATION_REPORT.md docs/analysis/ analysis/bug
ACE_PHASE1_IMPLEMENTATION_TODO.md docs/archive/ default-archive
ACE_PHASE1_PROGRESS.md docs/archive/ default-archive
ACE_PHASE1_TEST_RESULTS.md docs/archive/ default-archive
ACE_POOL_ARCHITECTURE_INVESTIGATION.md docs/analysis/ analysis/bug
AGENTS.md (keep-root) entrance
ANALYSIS_INDEX.md docs/analysis/ analysis/bug
ATOMIC_FREELIST_IMPLEMENTATION_STRATEGY.md docs/archive/ default-archive
ATOMIC_FREELIST_INDEX.md docs/archive/ default-archive
ATOMIC_FREELIST_QUICK_START.md docs/design/ design/general
ATOMIC_FREELIST_SITE_BY_SITE_GUIDE.md docs/archive/ default-archive
ATOMIC_FREELIST_SUMMARY.md docs/archive/ default-archive
BENCHMARK_SUMMARY_20251122.md docs/benchmarks/ bench/perf
BENCH_FIXED_SIZE_WORKSET64_CRASH_REPORT.md docs/analysis/ analysis/bug
BITMAP_FIX_FAILURE_ANALYSIS.md docs/analysis/ analysis/bug
BOTTLENECK_ANALYSIS_REPORT_20251114.md docs/analysis/ analysis/bug
BOX3_REFACTORING.md docs/design/ design/architecture
BOX_THEORY_ARCHITECTURE_REPORT.md docs/design/ design/architecture
BOX_THEORY_EXECUTIVE_SUMMARY.md docs/design/ design/architecture
BOX_THEORY_VERIFICATION_REPORT.md docs/design/ design/architecture
BOX_THEORY_VERIFICATION_SUMMARY.md docs/design/ design/architecture
BRANCH_OPTIMIZATION_QUICK_START.md docs/design/ design/general
BRANCH_PREDICTION_OPTIMIZATION_REPORT.md docs/archive/ default-archive
BUG_FLOW_DIAGRAM.md docs/analysis/ analysis/bug
C2_CORRUPTION_ROOT_CAUSE_FINAL.md docs/analysis/ analysis/bug
C6_TLS_SLL_HEAD_CORRUPTION_ROOT_CAUSE.md docs/analysis/ analysis/bug
C7_TLS_SLL_CORRUPTION_ANALYSIS.md docs/analysis/ analysis/bug
C7_TLS_SLL_CORRUPTION_FIX_REPORT.md docs/analysis/ analysis/bug
CENTRAL_ROUTER_BOX_DESIGN.md docs/design/ design/architecture
CLAUDE.md docs/archive/ default-archive
CLEANUP_SUMMARY_2025_11_01.md docs/status/ cleanup/status
COMPREHENSIVE_BENCHMARK_REPORT_20251122.md docs/benchmarks/ bench/perf
CRITICAL_BUG_REPORT.md docs/analysis/ analysis/bug
CURRENT_TASK.md docs/archive/ default-archive
DEBUG_100PCT_STABILITY.md docs/analysis/ analysis/bug
DEBUG_LOGGING_POLICY.md docs/analysis/ analysis/bug
DESIGN_FLAWS_ANALYSIS.md docs/analysis/ analysis/bug
DESIGN_FLAWS_SUMMARY.md docs/design/ design/general
DOCS_INDEX.md (keep-root) entrance
ENV_VARS.md docs/specs/ specs/env
ENV_VARS_COMPLETE.md docs/specs/ specs/env
FALSE_POSITIVE_REPORT.md docs/analysis/ analysis/bug
FALSE_POSITIVE_SEGV_FIX.md docs/analysis/ analysis/bug
FAST_CAP_0_SEGV_ROOT_CAUSE_ANALYSIS.md docs/analysis/ analysis/bug
FEATURE_AUDIT_REMOVE_LIST.md docs/archive/ default-archive
FINAL_ANALYSIS_C2_CORRUPTION.md docs/analysis/ analysis/bug
FIX_IMPLEMENTATION_GUIDE.md docs/design/ design/general
FOLDER_REORGANIZATION_2025_11_01.md docs/archive/ default-archive
FREELIST_CORRUPTION_ROOT_CAUSE.md docs/analysis/ analysis/bug
FREE_INC_SUMMARY.md docs/archive/ default-archive
FREE_PATH_INVESTIGATION.md docs/analysis/ analysis/bug
FREE_PATH_ULTRATHINK_ANALYSIS.md docs/analysis/ analysis/bug
FREE_TO_SS_INVESTIGATION_INDEX.md docs/analysis/ analysis/bug
FREE_TO_SS_SEGV_INVESTIGATION.md docs/analysis/ analysis/bug
FREE_TO_SS_TECHNICAL_DEEPDIVE.md docs/archive/ default-archive
HAKO_MIR_FFI_SPEC.md docs/specs/ specs/env
HISTORY.md (keep-root) entrance
HOTPATH_PERFORMANCE_INVESTIGATION.md docs/analysis/ analysis/bug
INVESTIGATION_RESULTS.md docs/analysis/ analysis/bug
INVESTIGATION_SUMMARY.md docs/analysis/ analysis/bug
L1D_ANALYSIS_INDEX.md docs/analysis/ analysis/bug
L1D_CACHE_MISS_ANALYSIS_REPORT.md docs/analysis/ analysis/bug
L1D_CACHE_MISS_EXECUTIVE_SUMMARY.md docs/analysis/ analysis/bug
L1D_CACHE_MISS_HOTSPOT_DIAGRAM.md docs/analysis/ analysis/bug
L1D_OPTIMIZATION_QUICK_START_GUIDE.md docs/analysis/ analysis/bug
LARGE_FILES_ANALYSIS.md docs/analysis/ analysis/bug
LARGE_FILES_QUICK_REFERENCE.md docs/archive/ default-archive
LARGE_FILES_REFACTORING_PLAN.md docs/design/ design/general
LARSON_CATASTROPHIC_SLOWDOWN_ROOT_CAUSE.md docs/analysis/ analysis/bug
LARSON_CRASH_ROOT_CAUSE_REPORT.md docs/analysis/ analysis/bug
LARSON_DIAGNOSTIC_PATCH.md docs/benchmarks/ bench/perf
LARSON_GUIDE.md docs/benchmarks/ bench/perf
LARSON_INVESTIGATION_SUMMARY.md docs/analysis/ analysis/bug
LARSON_OOM_ROOT_CAUSE_ANALYSIS.md docs/analysis/ analysis/bug
LARSON_PERFORMANCE_ANALYSIS_2025_11_05.md docs/analysis/ analysis/bug
LARSON_QUICK_REF.md docs/benchmarks/ bench/perf
LARSON_SLOWDOWN_INVESTIGATION_REPORT.md docs/analysis/ analysis/bug
LRU_CACHE_MMAP_ROOT_CAUSE_ANALYSIS.md docs/analysis/ analysis/bug
MALLOC_FALLBACK_REMOVAL_REPORT.md docs/archive/ default-archive
MID_LARGE_FINAL_AB_REPORT.md docs/benchmarks/ bench/perf
MID_LARGE_LOCK_CONTENTION_ANALYSIS.md docs/analysis/ analysis/bug
MID_LARGE_MINCORE_AB_TESTING_SUMMARY.md docs/benchmarks/ bench/perf
MID_LARGE_MINCORE_INVESTIGATION_REPORT.md docs/analysis/ analysis/bug
MID_LARGE_P0_FIX_REPORT_20251114.md docs/benchmarks/ bench/perf
MID_LARGE_P0_PHASE_REPORT.md docs/benchmarks/ bench/perf
MID_MT_COMPLETION_REPORT.md docs/status/ phase/status
MIMALLOC_ANALYSIS_REPORT.md docs/analysis/ analysis/bug
MIMALLOC_IMPLEMENTATION_ROADMAP.md docs/design/ design/general
MIMALLOC_KEY_FINDINGS.md docs/archive/ default-archive
OPTIMIZATION_QUICK_SUMMARY.md docs/benchmarks/ bench/perf
OPTIMIZATION_REPORT_2025_11_12.md docs/archive/ default-archive
P0_BUG_STATUS.md docs/status/ phase/status
P0_DIRECT_FC_ANALYSIS.md docs/status/ phase/status
P0_DIRECT_FC_SUMMARY.md docs/status/ phase/status
P0_INVESTIGATION_FINAL.md docs/status/ phase/status
P0_ROOT_CAUSE_FOUND.md docs/status/ phase/status
P0_SEGV_ANALYSIS.md docs/status/ phase/status
PAGE_BOUNDARY_SEGV_FIX.md docs/analysis/ analysis/bug
PERFORMANCE_DROP_INVESTIGATION_2025_11_21.md docs/analysis/ analysis/bug
PERFORMANCE_INVESTIGATION_REPORT.md docs/analysis/ analysis/bug
PERFORMANCE_REGRESSION_INVESTIGATION_REPORT.md docs/analysis/ analysis/bug
PERF_ANALYSIS_2025_11_05.md docs/analysis/ analysis/bug
PERF_BASELINE_FRONT_DIRECT.md docs/benchmarks/ bench/perf
PHASE11_SUPERSLAB_PREWARM_IMPLEMENTATION_REPORT.md docs/status/ phase/status
PHASE12_SHARED_SUPERSLAB_POOL_DESIGN.md docs/status/ phase/status
PHASE12_SP_SLOT_BOX_IMPLEMENTATION_REPORT.md docs/status/ phase/status
PHASE15_BUG_ANALYSIS.md docs/status/ phase/status
PHASE15_BUG_ROOT_CAUSE_FINAL.md docs/status/ phase/status
PHASE15_REGISTRY_LOOKUP_INVESTIGATION.md docs/status/ phase/status
PHASE15_WRAPPER_DOMAIN_CHECK_FIX.md docs/status/ phase/status
PHASE19_AB_TEST_RESULTS.md docs/status/ phase/status
PHASE19_FRONTEND_METRICS_FINDINGS.md docs/status/ phase/status
PHASE1_EXECUTIVE_SUMMARY.md docs/status/ phase/status
PHASE1_REFILL_INVESTIGATION.md docs/status/ phase/status
PHASE23_CAPACITY_OPTIMIZATION_RESULTS.md docs/status/ phase/status
PHASE2A_IMPLEMENTATION_REPORT.md docs/status/ phase/status
PHASE2A_SUPERSLAB_DYNAMIC_EXPANSION.md docs/status/ phase/status
PHASE2B_IMPLEMENTATION_REPORT.md docs/status/ phase/status
PHASE2B_QUICKSTART.md docs/status/ phase/status
PHASE2B_TLS_ADAPTIVE_SIZING.md docs/status/ phase/status
PHASE2C_BIGCACHE_L25_DYNAMIC.md docs/status/ phase/status
PHASE2C_IMPLEMENTATION_REPORT.md docs/status/ phase/status
PHASE6_3_FIX_SUMMARY.md docs/status/ phase/status
PHASE6_3_REGRESSION_ULTRATHINK.md docs/status/ phase/status
PHASE6_EVALUATION.md docs/status/ phase/status
PHASE6_INTEGRATION_STATUS.md docs/status/ phase/status
PHASE6_RESULTS.md docs/status/ phase/status
PHASE7_4T_STABILITY_VERIFICATION.md docs/status/ phase/status
PHASE7_ACTION_PLAN.md docs/status/ phase/status
PHASE7_BENCHMARK_PLAN.md docs/status/ phase/status
PHASE7_BUG3_FIX_REPORT.md docs/status/ phase/status
PHASE7_BUG_FIX_REPORT.md docs/status/ phase/status
PHASE7_COMPREHENSIVE_BENCHMARK_RESULTS.md docs/status/ phase/status
PHASE7_CRITICAL_FINDINGS_SUMMARY.md docs/status/ phase/status
PHASE7_DEBUG_COMMANDS.md docs/status/ phase/status
PHASE7_DESIGN_REVIEW.md docs/status/ phase/status
PHASE7_FINAL_BENCHMARK_RESULTS.md docs/status/ phase/status
PHASE7_PERFORMANCE_INVESTIGATION_REPORT.md docs/status/ phase/status
PHASE7_QUICK_BENCHMARK_RESULTS.md docs/status/ phase/status
PHASE7_SUMMARY.md docs/status/ phase/status
PHASE7_SYSCALL_BOTTLENECK_ANALYSIS.md docs/status/ phase/status
PHASE7_TASK3_RESULTS.md docs/status/ phase/status
PHASE9_LRU_ARCHITECTURE_ISSUE.md docs/status/ phase/status
PHASE_B_COMPLETION_REPORT.md docs/status/ phase/status
PHASE_E3-1_INVESTIGATION_REPORT.md docs/status/ phase/status
PHASE_E3-1_SUMMARY.md docs/status/ phase/status
PHASE_E3-2_IMPLEMENTATION.md docs/status/ phase/status
PHASE_E3_SEGV_ROOT_CAUSE_REPORT.md docs/status/ phase/status
POINTER_CONVERSION_BUG_ANALYSIS.md docs/analysis/ analysis/bug
POINTER_FIX_SUMMARY.md docs/archive/ default-archive
POOL_FULL_FIX_EVALUATION.md docs/archive/ default-archive
POOL_HOT_PATH_BOTTLENECK.md docs/archive/ default-archive
POOL_IMPLEMENTATION_CHECKLIST.md docs/archive/ default-archive
POOL_TLS_INVESTIGATION_FINAL.md docs/analysis/ analysis/bug
POOL_TLS_LEARNING_DESIGN.md docs/design/ design/general
POOL_TLS_PHASE1_5A_FIX.md docs/archive/ default-archive
POOL_TLS_QUICKSTART.md docs/archive/ default-archive
POOL_TLS_SEGV_INVESTIGATION.md docs/analysis/ analysis/bug
POOL_TLS_SEGV_ROOT_CAUSE.md docs/analysis/ analysis/bug
QUICK_REFERENCE.md docs/archive/ default-archive
RANDOM_MIXED_BOTTLENECK_ANALYSIS.md docs/analysis/ analysis/bug
RANDOM_MIXED_SUMMARY.md docs/archive/ default-archive
README.md (keep-root) entrance
README_CLEAN.md docs/archive/ default-archive
REFACTORING_BOX_ANALYSIS.md docs/analysis/ analysis/bug
REFACTORING_PLAN_TINY_ALLOC.md docs/design/ design/architecture
REFACTOR_EXECUTIVE_SUMMARY.md docs/design/ design/architecture
REFACTOR_IMPLEMENTATION_GUIDE.md docs/design/ design/architecture
REFACTOR_INTEGRATION_PLAN.md docs/design/ design/architecture
REFACTOR_PLAN.md docs/design/ design/architecture
REFACTOR_PROGRESS.md docs/design/ design/architecture
REFACTOR_QUICK_START.md docs/design/ design/architecture
REFACTOR_STEP1_IMPLEMENTATION.md docs/design/ design/architecture
REFACTOR_SUMMARY.md docs/design/ design/architecture
REGION_ID_DESIGN.md docs/design/ design/architecture
RELEASE_DEBUG_OVERHEAD_REPORT.md docs/analysis/ analysis/bug
REMAINING_BUGS_ANALYSIS.md docs/analysis/ analysis/bug
REMOVE_MALLOC_FALLBACK_TASK.md docs/archive/ default-archive
RING_CACHE_ACTIVATION_GUIDE.md docs/archive/ default-archive
SANITIZER_INVESTIGATION_REPORT.md docs/analysis/ analysis/bug
SANITIZER_PHASE1_RESULTS.md docs/archive/ default-archive
SEGFAULT_INVESTIGATION_REPORT.md docs/analysis/ analysis/bug
SEGFAULT_ROOT_CAUSE_FINAL.md docs/analysis/ analysis/bug
SEGV_FIX_REPORT.md docs/analysis/ analysis/bug
SEGV_FIX_SUMMARY.md docs/analysis/ analysis/bug
SEGV_ROOT_CAUSE_COMPLETE.md docs/analysis/ analysis/bug
SFC_ROOT_CAUSE_ANALYSIS.md docs/analysis/ analysis/bug
SLAB_INDEX_FOR_INVESTIGATION.md docs/analysis/ analysis/bug
SLL_REFILL_BOTTLENECK_ANALYSIS.md docs/analysis/ analysis/bug
SOURCE_MAP.md docs/status/ cleanup/status
SPLIT_DETAILS.md docs/archive/ default-archive
STABILITY_POLICY.md docs/archive/ default-archive
STRUCTURAL_ANALYSIS.md docs/analysis/ analysis/bug
SUPERSLAB_BOX_REFACTORING_COMPLETE.md docs/design/ design/architecture
SUPERSLAB_REFILL_BREAKDOWN.md docs/archive/ default-archive
TASK_FOR_OTHER_AI.md docs/status/ phase/status
TESTABILITY_ANALYSIS.md docs/analysis/ analysis/bug
TINY_256B_1KB_SEGV_FIX_REPORT.md docs/analysis/ analysis/bug
TINY_DRAIN_INTERVAL_AB_REPORT.md docs/archive/ default-archive
TINY_HEAP_V2_TASK_SPEC.md docs/archive/ default-archive
TINY_LEARNING_LAYER.md docs/archive/ default-archive
TINY_PERF_PROFILE_EXTENDED.md docs/benchmarks/ bench/perf
TINY_PERF_PROFILE_STEP1.md docs/benchmarks/ bench/perf
ULTRATHINK_ANALYSIS.md docs/analysis/ analysis/bug
ULTRATHINK_ANALYSIS_2025_11_07.md docs/analysis/ analysis/bug
ULTRATHINK_SUMMARY.md docs/archive/ default-archive
debug_analysis_final_$(date +%Y%m%d_%H%M%S).md docs/archive/ default-archive
debug_logs_$(date +%Y%m%d_%H%M%S).md docs/archive/ default-archive
debug_logs_round2_$(date +%Y%m%d_%H%M%S).md docs/archive/ default-archive