tomoaki/hakmem
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e1a867fe52300d6a99d5128712b42cb57a4d751f
hakmem/docs
History
Moe Charm (CI) e1a867fe52 Document breakthrough: sh8bench stability achieved with SuperSlab refcount pinning 
Major milestone reached:
✅ SIGSEGV eliminated (exit code 0)
✅ Long-term execution stable (60+ seconds)
✅ Defensive guards prevent corruption propagation
⚠️ Root cause (SuperSlab lifecycle) still requires investigation

Implementation Summary:
- SuperSlab refcount pinning (prevent premature free)
- Release guards (defer free if refcount > 0)
- TLS SLL next pointer validation
- Unified cache freelist validation
- Early decrement fix

Performance Impact: < 5% overhead (acceptable)

Remaining Concerns:
- Invalid pointers still logged ([TLS_SLL_NEXT_INVALID])
- Potential memory leak from deferred releases
- Log volume may be high on long runs

Next Phase:
1. SuperSlab lifecycle tracing (remote_queue, adopt, LRU)
2. Memory usage monitoring (watch for leaks)
3. Long-term stability testing
4. Stale pointer pattern analysis

🤖 Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-03 21:57:36 +09:00
..
analysis
WIP: Add TLS SLL validation and SuperSlab registry fallback
2025-12-03 20:42:28 +09:00
archive
WIP: Add TLS SLL validation and SuperSlab registry fallback
2025-12-03 20:42:28 +09:00
benchmarks
WIP: Add TLS SLL validation and SuperSlab registry fallback
2025-12-03 20:42:28 +09:00
design
Phase 4-Step1: Add PGO workflow automation (+6.25% performance)
2025-11-29 11:28:38 +09:00
paper
WIP: Add TLS SLL validation and SuperSlab registry fallback
2025-12-03 20:42:28 +09:00
roadmap
Debug Counters Implementation - Clean History
2025-11-05 12:31:14 +09:00
specs
WIP: Add TLS SLL validation and SuperSlab registry fallback
2025-12-03 20:42:28 +09:00
status
Doc: Add debug ENV consolidation plan and survey
2025-11-29 06:58:12 +09:00
ACE_LEARNING_LAYER_PLAN.md
Debug Counters Implementation - Clean History
2025-11-05 12:31:14 +09:00
ACE_LEARNING_LAYER.md
WIP: Add TLS SLL validation and SuperSlab registry fallback
2025-12-03 20:42:28 +09:00
BENCH_REPORT_2025_11_09.md
Tiny: Enable P0→FC direct path for class7 (1KB) by default + docs
2025-11-09 23:15:02 +09:00
BREAKTHROUGH_STABILITY_ACHIEVED.md
Document breakthrough: sh8bench stability achieved with SuperSlab refcount pinning
2025-12-03 21:57:36 +09:00
BUILD_PHASE7_POOL_TLS.md
Tiny: fix header/stride mismatch and harden refill paths
2025-11-09 18:55:50 +09:00
BUILDING_QUICKSTART.md
Tiny: fix remote sentinel leak → SEGV; add defense-in-depth; PoolTLS: refill-boundary remote drain; build UX help; quickstart docs
2025-11-09 16:49:34 +09:00
CHATGPT_CONTEXT_SUMMARY.md
Add comprehensive ChatGPT handoff documentation for TLS SLL diagnosis
2025-12-03 20:41:34 +09:00
CHATGPT_HANDOFF_TLS_DIAGNOSIS.md
Add comprehensive ChatGPT handoff documentation for TLS SLL diagnosis
2025-12-03 20:41:34 +09:00
CHATGPT_PROGRESS_AND_ISSUES.md
Add ChatGPT progress analysis and remaining issues documentation
2025-12-03 20:44:18 +09:00
CRITICAL_DISCOVERY_TLS_HEAD_CORRUPTION.md
Document critical discovery: TLS head corruption is not offset issue
2025-12-03 21:02:04 +09:00
DOCS_REORG_PLAN.md
ENV cleanup: Remove BG/HotMag vars & guard fprintf (Larson 52.3M ops/s)
2025-11-26 14:45:26 +09:00
FREE_SAFETY.md
Debug Counters Implementation - Clean History
2025-11-05 12:31:14 +09:00
GEMINI_HANDOFF_SUMMARY.md
Add comprehensive ChatGPT handoff documentation for TLS SLL diagnosis
2025-12-03 20:41:34 +09:00
HEADERLESS_STABILITY_DEBUG_INSTRUCTIONS.md
Add comprehensive ChatGPT handoff documentation for TLS SLL diagnosis
2025-12-03 20:41:34 +09:00
INDEX.md
ENV cleanup: Remove BG/HotMag vars & guard fprintf (Larson 52.3M ops/s)
2025-11-26 14:45:26 +09:00
PERF_ANALYSIS_TINY_MIXED.md
Debug Counters Implementation - Clean History
2025-11-05 12:31:14 +09:00
PHASE1_TLS_HINT_BENCHMARK.md
Implement Phase 1: TLS SuperSlab Hint Box for Headerless performance
2025-12-03 18:06:24 +09:00
PHASE2_BENCHMARK_RESULTS.md
Add Phase 2 benchmark results: Headerless ON/OFF comparison
2025-12-03 17:23:32 +09:00
PHASE2_HEADERLESS_INSTRUCTION_FOR_GEMINI.md
Add Phase 2 Headerless implementation instruction for Gemini
2025-12-03 11:41:34 +09:00
PHASE_E2_EXECUTIVE_SUMMARY.md
Phase E3-FINAL: Fix Box API offset bugs - ALL classes now use correct offsets
2025-11-13 06:50:20 +09:00
PHASE_E2_REGRESSION_ANALYSIS.md
Phase E3-FINAL: Fix Box API offset bugs - ALL classes now use correct offsets
2025-11-13 06:50:20 +09:00
PHASE_E2_VISUAL_COMPARISON.md
Phase E3-FINAL: Fix Box API offset bugs - ALL classes now use correct offsets
2025-11-13 06:50:20 +09:00
PHASE_E3_IMPLEMENTATION_PLAN.md
Phase E3-FINAL: Fix Box API offset bugs - ALL classes now use correct offsets
2025-11-13 06:50:20 +09:00
README_HANDOFF_CHATGPT.md
Add comprehensive ChatGPT handoff documentation for TLS SLL diagnosis
2025-12-03 20:41:34 +09:00
README.md
Debug Counters Implementation - Clean History
2025-11-05 12:31:14 +09:00
REFACTOR_PLAN_GEMINI_ENHANCED.md
Update REFACTOR_PLAN to mark Phase 2 complete and document Magazine Spill fix
2025-12-03 17:16:19 +09:00
REFACTORING_INSTRUCTION_FOR_GEMINI.md
Add detailed refactoring instruction for Gemini - Phase 1 implementation
2025-12-03 11:20:59 +09:00
SEGFAULT_INVESTIGATION_FOR_GEMINI.md
Add comprehensive ChatGPT handoff documentation for TLS SLL diagnosis
2025-12-03 20:41:34 +09:00
SEGV_INVESTIGATION.md
Implement Phase 2: Headerless Allocator Support (Partial)
2025-12-03 12:11:27 +09:00
sh8bench_debug_instruction.md
sh8bench修正: LRU registry未登録問題 + self-heal修復
2025-12-03 09:15:59 +09:00
SLAB_HANDLE.md
Debug Counters Implementation - Clean History
2025-11-05 12:31:14 +09:00
STATUS_2025_12_03_CURRENT.md
Add comprehensive ChatGPT handoff documentation for TLS SLL diagnosis
2025-12-03 20:41:34 +09:00
TINY_C7_1KB_SEGV_TRIAGE.md
Tiny C7(1KB) SEGV triage hardening: always-on lightweight free-time guards for headerless class7 in both hak_tiny_free_with_slab and superslab free path (alignment/range check, fail-fast via SIGUSR2). Leave C7 P0/direct-FC gated OFF by default. Add docs/TINY_C7_1KB_SEGV_TRIAGE.md for Claude with repro matrix, hypotheses, instrumentation and acceptance criteria.
2025-11-10 01:59:11 +09:00
TINY_MODULARIZATION_ANALYSIS.md
Debug Counters Implementation - Clean History
2025-11-05 12:31:14 +09:00
TINY_MODULARIZATION_SUMMARY.md
Debug Counters Implementation - Clean History
2025-11-05 12:31:14 +09:00
TINY_P0_BATCH_REFILL.md
ENV cleanup: Remove BG/HotMag vars & guard fprintf (Larson 52.3M ops/s)
2025-11-26 14:45:26 +09:00
TINY_REDESIGN_CHECKLIST.md
Tiny Pool redesign: P0.1, P0.3, P1.1, P1.2 - Out-of-band class_idx lookup
2025-11-28 13:42:39 +09:00
tls_sll_hdr_reset_final_report.md
Add final investigation report for TLS_SLL_HDR_RESET
2025-12-03 11:14:59 +09:00
tls_sll_hdr_reset_for_gemini.md
Save current state before investigating TLS_SLL_HDR_RESET
2025-12-03 10:34:39 +09:00
tls_sll_hdr_reset_investigation_report.md
Fix TLS SLL race condition with atomic fence and report investigation results
2025-12-03 10:57:16 +09:00
tls_sll_hdr_reset_investigation_v2.md
Save current state before investigating TLS_SLL_HDR_RESET
2025-12-03 10:34:39 +09:00
TLS_SLL_HEADER_CORRUPTION_DIAGNOSIS.md
Add comprehensive ChatGPT handoff documentation for TLS SLL diagnosis
2025-12-03 20:41:34 +09:00
tls_sll_header_corruption_investigation.md
Save current state before investigating TLS_SLL_HDR_RESET
2025-12-03 10:34:39 +09:00
TLS_SS_HINT_BOX_DESIGN.md
Add comprehensive ChatGPT handoff documentation for TLS SLL diagnosis
2025-12-03 20:41:34 +09:00

README.md

Docs Overview

このフォルダは hakmem の設計・計測・運用メモを体系化して管理する場所です。

  • INDEX.md: 目次（各ドキュメントへのリンク）
  • benchmarks/: ベンチマーク手順とスイープ結果の保存先
  • specs/: 現在の仕様（SACS‑3/HW/ENV）を集約
  • roadmap/: これからの実装計画・優先度・タスク

運用ルール（提案）

  • 1つの変更/計測のまとまりにつき1ファイル（or 1フォルダ）
  • 再現コマンド・環境変数・ハード構成は必ず記載
  • 大きな連続出力はファイルへ保存し、本文からは抜粋/要約を記載