📚 ny-wiki — 전체 목차

Storage 회사 System SW 팀의 NVMe FDP/HC-SSD × LMCache 최적화 미션 위키. 운영 규칙은 CLAUDE.md 참조. 모든 페이지는 첫 콜아웃에 업무 관점 takeaway가 들어간다. 위키링크 [[페이지명]]은 폴더 위치와 무관하게 동작 (Obsidian이 이름으로 resolve).

---

🗂️ 진행 중인 업무 — work/

지금 손대고 있는 것들. 완료되면 파일명 앞에 [Done] 표시.

• [[단기-Task-목록]] — 진행 중·예정 5개 Task (L2 latency histogram 외).
• [[raw_block-개선-Task]] — H1/H2/M1/M2/S2 독립 PR 목록 (S1 착수 금지).
• [[raw_block-Cleanup-PR]] — 첫 PR 후보: dead code 정리 3건, 53/53 테스트 통과.

raw_block PR 카탈로그 — work/reviews/ (PR 변경내용 + 아키텍처 관점)

PR/커밋	작성자	내용
[[raw_block-batched-remove-PR|batched_remove #3494]]	우리	삭제 경로 락 N→2 (OPEN)
[[raw_block-put_many-lock-PR|L1 put_many lock]]	우리	put_many 락 4N→2N
[[raw_block-put_many-batching-PR|L2 put_many batching]]	우리	per-key fan-out → 배치
[[raw_block-delete-toctou-PR|delete TOCTOU]]	권상윤	정산 race 수정 (T1)
[[raw_block-checkpoint-recovery-PR|checkpoint recovery]]	daegyu94	partial recovery
[[raw_block-LRU-eviction-PR|LRU eviction]]	daegyu94	슬롯 부족 evict 재시도
[[raw_block-blkdiscard-PR|blkdiscard]]	권상윤	init 시 BLKDISCARD
[[raw_block-checkpoint-compression-PR|checkpoint compression #3449]]	Daejun	zlib 압축, Std SSD S2 해소

팀 이슈/PR 모니터링 — work/issues/

#	작성자	제목	상태
[[Issue-3394-NonMP-Eviction|#3394]]	daegyu94	non-MP eviction 복구	Issue open, PR 없음
[[Issue-3392-Dynamic-Slot-Allocation|#3392]]	daegyu94	Dynamic Slot Allocation	Issue open
[[PR-3305-Checksum|#3305]]	daegyu94	payload 체크섬 검증	Draft PR
[[PR-3226-Incremental-Checkpoint|#3226]]	Daejun	incremental checkpoint	APPROVED, 머지 대기
[[PR-3274-IoUring-NVMe|#3274]]	ankit-sam	io_uring_cmd NVMe passthrough	갱신 중
[[Issue-3262-Distributed-MP-RFC|#3262]]	DongDongJu	RFC: Distributed MP 설계	토론 중

---

🎯 미션 & 방향성 — 00-mission/

• [[Mission]] — 위키 전체의 좌표축. 3대 방향(검증/최적화/기여)과 회사 포지셔닝.
• [[기여-포인트-맵]] — Storage Stack 5개 레이어, 11개 기여 포인트 마스터 인덱스.
• [[Samsung-LMCache-팀]] — 삼성 팀원 구성, 기여 영역, 오픈 PR, 우리가 노릴 빈 자리.
• [[LMCache-기여-가이드]] — 코드 규칙, PR 형식, 이슈 등록 기준, 우리 팀 패치 패턴.
• [[LMCache-Claude-Skills]] — /pre-pr-check·/create-pr·/pr-review 사용법 및 워크플로우.

---

🧠 LMCache (AI Cache SW) — 10-lmcache/

• [[LMCache-개요]] — 논문 기반 motivation/contribution. chunk batching이 핵심.
• [[LMCache-아키텍처]] — 4-tier × 2-mode × 5-component 전체 그림. 우리가 손댈 자리.
• [[LMCache-Local-Disk-Backend]] — NVMe와 만나는 정확한 코드. 청크=파일, async write, O_DIRECT.
• [[LMCache-Async-Loading]] — I/O–Compute Overlap, batched_async_contains.
• [[LMCache-MP-NonMP-모드]] — MP(별도 서버/ZMQ) vs Non-MP(vLLM 임베드). FDP plugin은 MP의 L2AdapterInterface만 구현.
• [[LMCache-동시성-비동기-기초]] — Lock(출입증)/Future(진동벨)/eventfd(도어벨). 락 작업의 전제 개념.
• [[L2-어댑터]] — L2AdapterInterface 계약, Store/Prefetch 흐름, FDP placement 삽입 지점.
• [[Plugin-Pipeline]] — 외부 백엔드(FDP 포함)를 LMCache에 등록하는 plugin 메커니즘.
• [[AI-Memory-플랫폼]] — Tensormesh(클러스터 KV 공유)·WEKA(distributed NVMe) + Samsung FDP의 위치.

raw_block (우리 핵심 영역) — 10-lmcache/raw_block/

• [[raw_block-내부구조]] — 디바이스 레이아웃, 슬롯 구조, write/read path, checkpoint 조건 Q&A.
• [[raw_block-종단-분석]] — raw_block L1~L4 전계층. FDP 삽입 지점 H1-H8, io_uring 현황, HC-SSD 스케일 위험.
• [[raw_block-io_uring-cmd]] — PR #3274 분석. io_uring_cmd passthrough 구현, big SQE 128B, FDP 연동 기반.
• [[raw_block-성능-우선순위]] — 종합 성능 분석 우선순위(T1/L1/L2/P0…). raw_block 기여 PR들의 출처.
• [[raw_block-PR-Landscape]] — 열린 PR 12개 ↔ 우선순위 매핑, #3274 커버 범위, 미착수 Gap(G1~G4) (2026-06-05).
• [[raw_block-CI-커버리지]] — PR CI 사각지대(O_DIRECT·멀티프로세스·주기적 체크포인트), 실장 테스트 필요 조건.
• [[S2-checkpoint-overflow]] — checkpoint silent fail 버그. #3449 zlib 압축으로 Std SSD 해소, HC SSD(15/30TB) 잔존.

---

🤖 AI 추론 기초 — 20-ai-inference/

• [[KV-Cache]] — 우리 미션의 데이터 객체. lifetime 불균일이 WAF 원인.
• [[vLLM-PagedAttention]] — page scatter 비효율 → LMCache chunk batching의 동기.
• [[PD-Disaggregation]] — Prefill ↔ Decode 분리. Transport Mode의 배경.
• [[TTFT-ITL]] — 사용자 체감 KPI. SSD → 사용자 인과 사슬의 끝.

---

💾 NVMe / SSD 기초 — 30-nvme-ssd/

• [[NAND-Flash-기초]] — Page/Block, erase-before-write, Append Point.
• [[WAF]] — Write Amplification Factor. 가장 정량적인 KPI.
• [[Garbage-Collection]] — WAF의 직접 메커니즘.
• [[NVMe-FDP]] — 우리 핵심 HW 기술. RU/RUH/RG/PH/EG.
• [[HC-SSD]] — QLC 기반 대용량. FDP 효과가 가장 큰 미디어.
• [[데이터-배치-기술-역사]] — OCSSD/Streams/ZNS/FDP. 실패에서 배운 설계.
• [[CacheLib-FDP-사례]] — Meta 사례: WAF 3.5 → ~1.0. 우리 가설의 외부 증거.
• [[FDP-SSD-LMCache-PoC]] — LMCache에서 FDP 배치 전략 3가지 (prompt별/단계별/TP 워커별).

---

🛠️ Storage Stack & System SW — 40-storage-stack/

• [[Storage-Stack]] — FS → Block → NVMe → SSD 4레이어 좌표계.
• [[O_DIRECT]] — Page Cache 우회. 측정의 명료성.
• [[io_uring]] — 진짜 async I/O + FDP hint 전달 경로.

---

🎮 GPU × Storage 연동 — 50-gpu-storage/

• [[GPU-Direct-Storage]] — CPU 우회. FDP와 결합 시 가장 깊은 직결 경로.

---

📝 작업 이력

• log.md — 자료 추가 / 페이지 작성·갱신 / 건강검진 이력.

---

🔭 아직 비어있는 영역 (앞으로 채울 후보)

• [[기여-포인트-맵]] [4] FS 선택 — ext4/xfs/f2fs 비교 → 40-storage-stack/
• [[기여-포인트-맵]] [6] I/O Scheduler 튜닝 → 40-storage-stack/
• LMCache GDS Backend 구현 분석 (FDP Backend 레퍼런스용) → 10-lmcache/
• vLLM 통합 어댑터 코드 (integration/vllm/) → 10-lmcache/
• NIXL / Mooncake (Transport Mode 백엔드) → 10-lmcache/
• xNVMe 라이브러리 (FDP-aware 추상화) → 40-storage-stack/
• SPDK FDP 경로 (커널 우회까지) → 40-storage-stack/