Memory Pool & GC

특징

주요 내용

클래스 다이어그램 — Collector, Storage, Smart Pointer

시퀀스 다이어그램 — Collect() 사이클 한 번

ObjectPtr vs. RootPtr

사용 예시

#include "Memory.h"
using namespace Memory;

class MyClass
{
    GENERATE(MyClass); // Reflection 시스템과 함께 쓰면 GC 순회 대상이 됨
public:
    int value = 42;
};

int main()
{
    Init(1024 * 1024, 1000000); // Pool 크기 1MB, Sweep 시간 예산 1ms

    ObjectPtr<MyClass> obj  = MakePtr<MyClass>();      // 비활성 Handle — GC root 아님
    RootPtr<MyClass>   root = MakePtr<MyClass>();      // 생성자가 AddRoot(this) 호출 -> GC root
    RootPtr<int[]>     arr  = MakeArray<int>(5);

    obj = ObjectPtr<MyClass>();  // 참조 해제
    Collect();                    // obj가 가리키던 메모리는 회수 대상, root/arr는 보호됨
    Release();
}

1. 1기ECS용 Memory Pool → MemoryManager2023.05 — 2023.10
   태그 v1.0 → v4.x
2. 2023.05.20
   MemoryECS용 MemoryPool 첫 버전

   엔진에서 겪은 Component Pointer 무효화 문제를 풀려고 만든 고정 크기 풀 — 같은 날 Scene · Node 기반 ECS용으로 맞춤(v1.0.0).
3. 2023.05.26
   MemoryMemoryManager · OnlyMemoryPool · Demo로 프로젝트 분리 (v2.x)
4. 2023.07.03
   MemoryMemoryPtr 도입 (v4.0)

   "생성 · 소멸 권한은 MemoryManager가 쥐어야 한다"는 이유로 weak_ptr 비슷한 Pointer를 만듦 — 커밋 메시지에 남긴 이유 그대로.
5. 2023.10.02
   MemoryPool 전체 크기를 객체 크기의 배수로 맞춰 남는 공간 제거
6. 2기Accessor · Collector 구조의 GC로 재작성2025.11 — 현재
   2년 넘는 공백 뒤 재시작
7. 2025.11.30
   Memory구조를 갈아엎은 재시작

   옛 MemoryManager/, OnlyMemoryPool/, MemoryPtr/, ExternalProject_Add 기반 빌드를 전부 걷어내고 지금의 Accessor/Collector/Pointer/Storage 구조와 git submodule 기반 빌드로 다시 짬 — 그 사이 Reflection · Container를 만들며 익힌 설계를 그대로 가져옴.
8. 2025.12.12
   MemoryContainer 라이브러리로 일원화GC 실동작 확인부터

   Memory 안에 따로 있던 List · Arena를 지우고 Container를 submodule로 연결. 데모에 GCExample()을 넣어 DynamicArray/HashMap에 담긴 ObjectPtr까지 Collect()가 실제로 훑고 회수하는지 확인.
9. 2025.12.15
   Memory순환 참조 마킹 무한 루프직접 겪고 고친 문제

   커밋 메시지 그대로 — 서로 연결된 값들을 GC에 등록하면 순환이 생겨 마킹 로직이 끝나지 않음. 스택으로 그래프를 도는 GarbageCollector.cpp 루프에 IsMarked() 가드를 넣어 이미 마킹된 노드를 다시 쌓지 않게 고침.
10. 2026.02.22
    MemoryRefPtr 설계 전환침투적 → 비침투적

    관리 대상이 RefCounted를 상속해야만 쓸 수 있던 구조가 너무 불편해서, 대상 타입을 감싸는 RefData<T>를 두는 std::shared_ptr 비슷한 방식으로 바꿈. 같은 커밋에서 ObjectPtr 기본 생성자가 Pointer를 nullptr로 초기화하지 않아 나던 런타임 에러도 잡음.
11. 2기코드 리뷰 → 수정2026.08
12. 2026.08.06
    Memory리뷰로 찾은 버그 4건 수정 + GC Prepare 단계 분리

    #17 PoolBudget 소멸자, #18 Purge 시간 예산, #19 미초기화 메모리 접근, #20 RefPtr 메모리 순서를 한 커밋에서 고치고, Sweep 전에 마킹 상태를 초기화하는 Prepare 단계를 따로 뗌 — Unreal의 reset-before-mark 방식 (PR #21).

Sequence 다이어그램 — PoolBudget의 버킷 탐색과 밀도 재분류

GetPool()은 Dense부터 Sparse 순으로 역순 탐색해서 첫 번째로 여유 있는 버킷을 바로 씀 — eFull 버킷은 애초에 탐색 대상에서 빠짐. Update()는 Pool마다 GetUsedRatio()를 다시 재서 밀도가 바뀌었으면 List::Splice로 해당 버킷으로 옮김(포인터/Iterator 재계산 없이 노드만 다른 리스트로 이동).

GitHub에 지금 열려 있는 이슈 (실시간)