79 lines
2.5 KiB
Markdown
79 lines
2.5 KiB
Markdown
|
# Archive Directory
|
||
|
|
|
||
|
|
This directory contains historical documents, old benchmark results, and experimental work from the HAKMEM memory allocator project.
|
||
|
|
|
||
|
|
## Structure
|
||
|
|
|
||
|
|
### `phase2/` - Phase 2 Documentation
|
||
|
|
Phase 2 modularization work (completed):
|
||
|
|
- IMPLEMENTATION_ROADMAP.md - Original Phase 2 roadmap
|
||
|
|
- P0_SUCCESS_REPORT.md - P0 batch refill success report (+5.16% improvement)
|
||
|
|
- README_PHASE_2C.txt - Phase 2C module extraction notes
|
||
|
|
- PHASE2_MODULE6_*.txt - Module 6 quick reference and summary
|
||
|
|
|
||
|
|
### `analysis/` - Historical Analysis Reports
|
||
|
|
Research and analysis documents from various optimization phases:
|
||
|
|
- RING_SIZE_* (4 files) - Ring buffer size analysis
|
||
|
|
- 3LAYER_* (2 files) - 3-layer allocation strategy experiments
|
||
|
|
- COMPARISON files - Performance comparisons
|
||
|
|
- MT_SAFETY_FINDINGS.txt - Multi-threading safety analysis
|
||
|
|
- NEXT_STEP_ANALYSIS.md - Strategic planning
|
||
|
|
- gemini_*.txt (4 files) - AI-assisted code reviews
|
||
|
|
|
||
|
|
### `old_benches/` - Historical Benchmark Results
|
||
|
|
Benchmark results from earlier phases:
|
||
|
|
- bench_phase*.txt - Phase milestone benchmarks
|
||
|
|
- bench_step*.txt - Step-by-step optimization results
|
||
|
|
- bench_reserve*.txt - Reserve pool experiments
|
||
|
|
- bench_*_results.txt - Various benchmark runs
|
||
|
|
|
||
|
|
### `old_logs/` - Debug and Test Logs
|
||
|
|
Debug logs, test outputs, and build logs:
|
||
|
|
- debug_*.log - Debug session logs
|
||
|
|
- test_*.log - Test execution logs
|
||
|
|
- obs_*.log - Observation/profiling logs
|
||
|
|
- build_pgo*.log - PGO build logs
|
||
|
|
- phase*.log - Phase-specific logs
|
||
|
|
|
||
|
|
### `experimental_scripts/` - Experimental Scripts
|
||
|
|
Scripts from A/B testing and parameter sweeps:
|
||
|
|
- ab_*.sh - A/B testing scripts
|
||
|
|
- sweep_*.sh - Parameter sweep scripts
|
||
|
|
- prof_sweep.sh - Profile sweeping
|
||
|
|
- reorg_plan_a.sh - Reorganization experiments
|
||
|
|
|
||
|
|
## Timeline
|
||
|
|
|
||
|
|
- **Phase 1**: Initial implementation
|
||
|
|
- **Phase 2**: Modularization (Module 1-6)
|
||
|
|
- Module 2: Ring buffer optimization
|
||
|
|
- Module 6: L2 pool extraction
|
||
|
|
- P0: Batch refill (+5.16%)
|
||
|
|
- **Phase 3**: Mid Range MT allocator (current)
|
||
|
|
- Goal: 100-120M ops/sec
|
||
|
|
- Result: 110M ops/sec (achieved!)
|
||
|
|
|
||
|
|
## Restoration
|
||
|
|
|
||
|
|
All files in this archive can be restored to the root directory if needed:
|
||
|
|
```bash
|
||
|
|
# Restore Phase 2 docs
|
||
|
|
cp archive/phase2/*.md .
|
||
|
|
|
||
|
|
# Restore specific analysis
|
||
|
|
cp archive/analysis/RING_SIZE_INDEX.md .
|
||
|
|
|
||
|
|
# Restore benchmark results
|
||
|
|
cp archive/old_benches/bench_phase1_results.txt .
|
||
|
|
```
|
||
|
|
|
||
|
|
## See Also
|
||
|
|
|
||
|
|
- `CLEANUP_SUMMARY_2025_11_01.md` - Detailed cleanup report
|
||
|
|
- `bench_results/` - Current benchmark results
|
||
|
|
- `perf_data/` - Performance profiling data
|
||
|
|
|
||
|
|
---
|
||
|
|
*Archived: 2025-11-01*
|
||
|
|
*Total: 71 files preserved*
|