feat: add marufs kernel module — CXL shared-memory filesystem

[moonchan-park]

Summary

• Add marufs_kernel/ — Linux kernel filesystem module for CXL shared memory, enabling cross-node file sharing via DAX-mapped CXL memory pools
• CAS-based lock-free global index (4-shard hash table), RAT (2KB CL-aligned per-file metadata), NRHT (application-level name→offset mapping), 3-stage ACL (owner→default→delegation), 4-phase background GC
• Architecture docs (6 detailed + 1 overview), test suite (ioctl, mmap, cross-process, chown race, multinode), build/install scripts
• GPL-2.0-only (kernel module requirement)

Structure

marufs_kernel/
├── src/           # Kernel module source (super, dir, inode, file, index, region, nrht, acl, gc, sysfs)
├── include/       # Userspace API header (marufs_uapi.h)
├── docs/          # Architecture docs (metadata layout, entry lifecycle, GC, NRHT, ACL, mount/IO)
├── tests/         # Test suite (C test programs + shell harness)
├── Makefile       # Kernel module build
└── install.sh     # Build + insmod + mount helper
docs/source/design_doc/
└── marufs_kernel_module_architecture.md  # Architecture overview with mermaid diagrams

Test plan

• make builds marufs.ko without errors on target kernel
• sudo ./install.sh loads module and mounts filesystem
• sudo ./tests/test_local_multinode.sh passes all multinode tests

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
__init__.py	6	0	100%
__main__.py	3	3	0%	5, 7–8
allocation_manager.py	102	10	90%	30–31, 44–45, 52, 207, 211–214
client.py	184	8	95%	88, 130, 147–148, 311–313, 319
config.py	46	1	97%	72
constants.py	9	0	100%
device_scanner.py	94	31	67%	25, 100, 102–104, 106, 114–123, 125, 127, 129, 134–143, 145, 147
handler.py	524	79	84%	125, 140, 151–158, 166–168, 176, 187–192, 197, 222, 249–250, 254, 294, 298–299, 304, 326, 333–334, 338–344, 347, 351–353, 369, 371–372, 429, 450, 460–461, 567–569, 576, 698–701, 704, 715–718, 724, 1055–1059, 1065, 1076–1080, 1086, 1165, 1170, 1212
ipc.py	275	2	99%	365, 441
kv_manager.py	102	0	100%
logging_setup.py	19	0	100%
protocol.py	216	0	100%
resource_manager_installer.py	103	13	87%	80–86, 167, 169–172, 187
rpc_async_client.py	190	0	100%
rpc_async_server.py	111	0	100%
rpc_client.py	66	0	100%
rpc_client_base.py	100	10	90%	183, 219–220, 231–232, 304–305, 309–310, 340
rpc_handler_mixin.py	102	19	81%	153–155, 158–160, 218–221, 226, 230–234, 245–246, 252
rpc_server.py	64	0	100%
serializer.py	81	0	100%
server.py	145	20	86%	44, 54–59, 64–65, 73, 168, 172, 243, 247, 265–266, 284–286, 371
stats_manager.py	95	0	100%
types.py	60	1	98%	145
uds_helpers.py	13	0	100%
memory
__init__.py	5	0	100%
allocator.py	55	0	100%
mapper.py	128	2	98%	229, 296
owned_region_manager.py	101	1	99%	212
types.py	62	0	100%
TOTAL	3081	200	93%

Tests	Skipped	Failures	Errors	Time
660	4 💤	0 ❌	0 🔥	6.478s ⏱️

[moonchan-park]

PR #41 리뷰 요약

이 PR을 왜 올리는가?

Maru 프로젝트는 현재 TCP/RPC 기반의 유저스페이스 메모리 관리만 지원합니다. CXL 공유 메모리를 여러 노드가 파일시스템 인터페이스로 직접 접근하려면 커널 모듈이 필요하며, 이 PR이 없으면 cross-node 파일 공유를 위해 네트워크 라운드트립이 필수입니다. marufs 커널 모듈은 DAX-mapped CXL 메모리 풀 위에 lock-free 파일시스템을 구현하여, 표준 VFS 인터페이스(open/mmap/read/write)로 노드 간 zero-copy 데이터 공유를 가능하게 합니다.

설계 개요

graph TB
    subgraph UserSpace["Userspace"]
        app["Application"]
        test["Test Suite"]
    end

    subgraph KernelMod["marufs Kernel Module"]
        subgraph VFS["VFS Layer"]
            super["super.c -- mount, umount, format"]
            dir["dir.c -- readdir, lookup, create, unlink"]
            inode["inode.c -- iget, new_inode, evict"]
            file["file.c -- mmap, ftruncate, ioctl"]
        end

        subgraph DataLayer["Data Layer"]
            idx["index.c -- 4-shard CAS hash index"]
            region["region.c -- RAT allocator, 2KB entries"]
            nrht["nrht.c -- Name-Ref Hash Table"]
        end

        subgraph SecLayer["Security Layer"]
            acl["acl.c -- 3-stage ACL check"]
        end

        subgraph MaintLayer["Maintenance"]
            gc["gc.c -- 4-phase background GC"]
            sysfs_mod["sysfs.c -- stats export"]
        end
    end

    subgraph HW["Hardware"]
        cxl["CXL Shared Memory / DAX Device"]
    end

    app -->|"open, read, mmap, ioctl"| file
    test -->|"ioctl, mmap"| file
    super --> dir
    super --> inode
    super --> file
    dir --> idx
    file --> idx
    file --> region
    file --> acl
    file --> nrht
    inode --> idx
    gc -.->|"sweep"| idx
    gc -.->|"reclaim"| region
    gc -.->|"stale cleanup"| nrht
    idx --> cxl
    region --> cxl
    nrht --> cxl

Loading

CXL 메모리 레이아웃

block-beta
    columns 4
    sb["Superblock 4KB"]:1
    shards["Global Index Shards x4"]:1
    rat["RAT Header + 256 Entries"]:1
    data["Region Data"]:1

Loading

핵심 데이터 흐름

경로	흐름
파일 생성	create -> index claim EMPTY -> RAT alloc -> link and publish VALID
파일 읽기	lookup -> index hash search -> RAT entry -> DAX direct read
mmap	open -> ftruncate(region alloc) -> mmap -> DAX fault handler
GC	Phase1: dead process reclaim -> Phase2: stale INSERTING sweep -> Phase3: orphan sweep -> Phase4: NRHT stale sweep

리뷰 결과 요약

전체적으로 lock-free CAS 설계, 상태 머신, 메모리 배리어 처리가 잘 구조화되어 있습니다. 커널 모듈 코드 품질이 높으나, 아래 이슈들을 머지 전 검토해야 합니다.

심각도	건수	주요 이슈
Critical	3	claim_entry 상태 미검증, FIND_NAME 권한 누락, batch 버퍼 사이징
High	6	i_size_write 락 미보유, mmap 파일 참조 누수, force-unlock CAS 미사용, checksum 미구현, d_revalidate 성능, compat_ioctl 누락
Medium	3	GC 스레드 stop 체크, sysfs 버퍼 오버플로, CXL 2.0 배리어
Minor	2	하드코딩된 사용자 경로, 테스트 바이너리 누락

[youngrok-XCENA]

리뷰 요약

이 PR의 목적

CXL(Compute Express Link) 공유 메모리를 다수 노드에서 파일 수준으로 접근/관리할 수 있는 Linux 커널 파일시스템 모듈(marufs)을 추가합니다.

미적용 시 문제: CXL 메모리 풀을 POSIX 파일 인터페이스로 다룰 수 없어, 애플리케이션이 DAX 디바이스를 직접 mmap하고 멀티 노드 간 메타데이터 동기화를 자체 구현해야 합니다.

아키텍처 설계

graph TB
    subgraph VFS["VFS Layer"]
        super["super.c: mount, umount, mkfs"]
        dir["dir.c: readdir, lookup, create"]
        inode_m["inode.c: iget, evict, getattr"]
        file_m["file.c: mmap, ftruncate, ioctl"]
    end
    subgraph CXL["CXL Shared Data Layer"]
        index_m["index.c: 4-shard lock-free hash"]
        region["region.c: RAT region allocator"]
        nrht["nrht.c: Name-Ref Hash Table"]
    end
    subgraph SEC["Security"]
        acl["acl.c: 3-stage ACL with delegation"]
    end
    subgraph BG["Background"]
        gc["gc.c: 4-phase GC sweep"]
        sysfs_mod["sysfs.c: stats and tunables"]
    end
    super --> dir
    super --> inode_m
    super --> file_m
    dir --> index_m
    file_m --> index_m
    file_m --> region
    file_m --> acl
    file_m --> nrht
    inode_m --> index_m
    gc -.-> index_m
    gc -.-> region
    gc -.-> nrht

Loading

핵심 설계 특성

항목	설명
Lock-free 동시성	CAS 기반 4-shard 해시 인덱스, NRHT, delegation ACL
WORM 시맨틱	ftruncate로 한 번만 영역 할당, 재할당 불가
4-phase GC	orphan 탐지 - 타임아웃 대기 - CAS reclaim - region sweep
DAX 직접 매핑	page cache 우회, mmap으로 CXL 메모리 직접 접근

주요 발견 사항

심각도	건수	대표 이슈
Critical	2	재부팅 시 데이터 소실(fstab format), NRHT entry CAS 탈취
High	4	DAXHEAP TOCTOU, delegation 비원자 전이, GC 레이스, i_size 비보호 쓰기
Medium	3	잘못된 errno, alloc_lock 타임아웃 미도달, x86 전용 cache flush
Low	1	하드코딩된 개발자 경로

상세 내용은 인라인 코멘트를 참조해주세요.

[youngrok-XCENA]

[critical] 재부팅마다 파일시스템 포맷 -- 데이터 소실

fstab에 format 마운트 옵션이 영구 기록됩니다. 재부팅 시마다 파일시스템이 초기화되어 모든 데이터가 소실됩니다. L243의 systemd unit도 동일한 문제가 있습니다.

최초 포맷 이후에는 format 옵션을 제거해야 합니다. fstab/systemd 등록 시 format 옵션 제외를 기본으로 하고, 별도 --format 플래그로만 포맷을 수행하는 것을 권장합니다.

[moonchan-park]

Fixed in 29243e0

fstab/systemd 모두 format 옵션 제거했습니다.

CXL은 volatile 메모리라 매 부팅 시 어딘가에서 format이 필요한 건 맞지만, autoload 스크립트에 하드코딩하는 방식은 위험합니다. 향후 format_if_needed 마운트 옵션으로 별도 구현 예정:

• 마운트 시 magic + CRC32 검증
• 유효하면 기존 메타데이터 사용, 무효하면 idempotent format 수행
• 멀티노드 환경에서도 CRC commit point 기반으로 안전하게 동작

[youngrok-XCENA]

[critical] CAS가 INSERTING 상태를 포함한 모든 상태에서 성공 -- entry 탈취 가능

st가 이미 MARUFS_ENTRY_INSERTING이면 CAS가 INSERTING->INSERTING으로 성공하여, 다른 노드가 삽입 중인 entry의 created_at과 inserter_node를 덮어씁니다. 이는 원래 삽입자의 작업을 망가뜨립니다.

CAS 전에 st == MARUFS_ENTRY_EMPTY || st == MARUFS_ENTRY_TOMBSTONE 조건을 확인해야 합니다.

[moonchan-park]

Fixed in eea4555. Added st == EMPTY || st == TOMBSTONE validation before CAS in both index_claim_entry and nrht_claim_entry.

[youngrok-XCENA]

[high] DAXHEAP primary 할당 시 TOCTOU 레이스 컨디션

L452에서 marufs_daxheap_bufid == 0 확인 후 L459에서 락을 해제하고, L461에서 daxheap_kern_alloc()을 락 없이 호출합니다. 두 스레드가 동시에 primary mount를 시도하면 버퍼가 이중 할당됩니다.

제안: 락을 alloc 완료 후까지 유지하거나, 할당 후 CAS로 bufid를 교체하세요.

[moonchan-park]

Fixed in d0ef7e1

mutex를 check부터 alloc + bufid 기록까지 유지하도록 변경. 에러 경로마다 mutex_unlock 추가.

[youngrok-XCENA]

[high] GRANTING -> ACTIVE 상태 전환이 CAS가 아닌 단순 WRITE

GRANTING 상태에서 다른 노드(예: GC)가 상태를 이미 변경했을 수 있는데, 이를 확인하지 않고 덮어씁니다.

marufs_le32_cas(&de->state, MARUFS_DELEG_GRANTING, MARUFS_DELEG_ACTIVE)로 변경하여 예상 상태에서만 전환해야 합니다.

[moonchan-park]

Fixed in d0ef7e1

WRITE_LE32(de->state, ACTIVE) → marufs_le32_cas(&de->state, GRANTING, ACTIVE). CAS 실패 시(GC가 이미 EMPTY로 전환) -EAGAIN 반환하여 caller가 retry.

[youngrok-XCENA]

[high] gc_orphan_count 비원자적 증감 -- 레이스 컨디션

gc_orphan_count와 gc_orphans 배열이 락 없이 접근됩니다. marufs_gc_track_orphan()이 GC sweep 경로 등에서 여러 CPU에서 동시 호출 가능한 경우 race condition이 발생합니다.

단일 스레드에서만 호출됨을 보장하거나, spinlock/atomic으로 보호해야 합니다.

[moonchan-park]

Fixed in d0ef7e1

GC는 단일 kthread로만 실행되므로 race 없음. 해당 사실을 marufs_gc_track_orphan 주석에 명시했습니다.

[youngrok-XCENA]

[high] i_size를 i_rwsem 없이 직접 수정

VFS는 i_size 변경 시 i_rwsem 보호 또는 i_size_write() 사용을 요구합니다. concurrent getattr과 read_iter에서 inconsistent size를 볼 수 있습니다.

getattr 콜백에서는 inode->i_size를 갱신하지 말고 stat->size에 직접 쓰는 것이 더 안전합니다.

[moonchan-park]

Fixed in 99cc329

youngrok 제안대로 stat->size에 직접 기록하는 방식으로 변경. fillattr 먼저 호출 → RAT fresh value로 stat->size/stat->blocks override. inode->i_size 업데이트 자체를 안 하므로 i_rwsem 불필요.

[youngrok-XCENA]

[medium] 잘못된 에러 코드 반환

return -1은 -EPERM에 해당합니다. VFS statfs 콜백은 의미 있는 errno를 반환해야 합니다. marufs_rat_entry_get() 실패는 I/O 오류이므로 return -EIO가 적절합니다.

[moonchan-park]

이전 커밋(5b5dfb8)에서 이미 수정 완료. return -1 → return -EIO (super.c statfs).

[youngrok-XCENA]

[medium] alloc_lock 재시도/타임아웃 로직 불일치 -- 5초 타임아웃 미도달

retries++가 cpu_relax() 경로에서만 증가합니다. cpu_relax()는 나노초 단위이므로, MARUFS_REGION_INIT_MAX_RETRIES(10)에 도달하는 데 마이크로초밖에 걸리지 않아, 5초 타임아웃 + force-unlock 경로는 사실상 도달 불가능합니다.

제안: retries를 force-unlock 횟수로 세거나, cpu_relax 대신 usleep_range()를 사용하여 대기 시간을 확보하세요.

[moonchan-park]

Fixed in 21ccbb5.

cpu_relax() → usleep_range(500000, 600000) (500ms). 10회 retry × 500ms = 5s이므로 타임아웃 force-unlock 경로에 실제로 도달 가능. #include <linux/delay.h> 추가.

[youngrok-XCENA]

[medium] clwb/clflushopt는 x86 전용 -- 다른 아키텍처에서 컴파일 실패

clwb(p) (L403), clflushopt(p) (L413)는 x86 전용 인스트럭션입니다. ARM64/RISC-V 빌드에서 컴파일 오류가 발생합니다.

#ifdef CONFIG_X86 가드를 추가하거나, arch_wb_cache_pmem() 등 아키텍처 독립 API 사용을 검토하세요. CXL이 현재 주로 x86에서 사용되더라도, #error 메시지로 지원 범위를 명시하는 것이 좋습니다.

[moonchan-park]

Fixed in 21ccbb5.

x86-only clwb/clflushopt 직접 호출 대신 커널 arch-portable API인 arch_wb_cache_pmem() / arch_invalidate_pmem() (<linux/libnvdimm.h>)으로 교체. x86에서는 동일하게 clwb+wmb / clflushopt+mb 수행, non-x86에서는 no-op (WT mapping 전제). 수동 cacheline 루프 + #error guard 불필요.

[youngrok-XCENA]

[low] 개발자 로컬 경로 하드코딩

/home/mcpark/daxheap가 기본값으로 설정되어 있습니다. 다른 환경에서 MARUFS_DAXHEAP_DIR 미설정 시 빌드가 실패합니다. 기본값을 제거하고 미설정 시 에러를 출력하거나, 프로젝트 상대 경로로 변경하세요.

[moonchan-park]

Fixed in 21ccbb5.

DAXHEAP_DIR 기본값 제거 → 빈 문자열. install.sh에서 --daxheap 사용 시 DAXHEAP_DIR 미설정이면 즉시 에러. setup_local_multinode.sh / test_local_multinode.sh 동일 적용. Makefile 코멘트도 generic path로 변경.

[jooho-XCENA]

Review: 미해결 HIGH 이슈 8건

기존 리뷰(moonchan-park, youngrok-XCENA)와 fix 커밋(eea4555, 99cc329, d0ef7e1, 21ccbb5, 8614242 등)을 확인한 후, 아직 미해결이고 다른 리뷰어가 코멘트하지 않은 HIGH 이슈만 남겼습니다.

이미 해결 확인된 항목 (코멘트 생략)

• ✅ GC kthread_should_stop inter-phase → 21ccbb5
• ✅ i_size_write without i_rwsem → 99cc329
• ✅ mmap file ref restore → d0ef7e1
• ✅ alloc_lock CAS → d0ef7e1
• ✅ GRANTING→ACTIVE CAS → d0ef7e1
• ✅ DAXHEAP TOCTOU → d0ef7e1
• ✅ compat_ioctl → 8614242
• ✅ claim_entry guard → eea4555
• ✅ FIND_NAME perm → eea4555
• ✅ superblock CRC32 → 5b5dfb8
• ✅ fstab format option → 29243e0
• ✅ arch-portable flush → 21ccbb5

[jooho-XCENA]

[HIGH] NRHT_INIT에 ADMIN 권한 필요

MARUFS_IOC_NRHT_INIT은 영역 전체를 memset(base, 0, total_needed) + 재포맷하는 파괴적 작업입니다 (nrht.c:523).

현재 MARUFS_PERM_IOCTL만 요구하는데, 이는 일반 NRHT 이름 조회/저장과 동일한 수준입니다. IOCTL 권한이 있는 모든 프로세스가 전체 NRHT를 포맷할 수 있습니다.

// 현재:
ret = marufs_check_permission(fc.sbi, fc.xi->rat_entry_id, MARUFS_PERM_IOCTL);

// 권장:
ret = marufs_check_permission(fc.sbi, fc.xi->rat_entry_id, MARUFS_PERM_ADMIN);

[moonchan-park]

Fixed in 27206dc. MARUFS_PERM_IOCTL → MARUFS_PERM_ADMIN으로 변경.

[jooho-XCENA]

[HIGH] DMABUF export가 전체 CXL 디바이스를 노출

sbi->heap_dmabuf는 전체 daxheap 디바이스를 나타냅니다. 여기서 export하면 사용자가 superblock, RAT, global index, 다른 사용자의 region 데이터까지 모두 접근 가능합니다 — ACL을 완전히 우회합니다.

권장 수정:

1. 최소한 MARUFS_PERM_ADMIN 권한을 요구하거나
2. 전체 디바이스가 아닌 해당 파일의 region만 export하는 per-region dma_buf slice 생성

현재 READ+WRITE 권한만 있으면 전체 디바이스 fd를 얻을 수 있어, single-file 권한으로 다른 모든 파일의 데이터를 읽을 수 있습니다.

[moonchan-park]

Fixed in 27206dc. MARUFS_PERM_READ | MARUFS_PERM_WRITE → MARUFS_PERM_ADMIN으로 변경. 해당 ioctl은 다른 노드에서 동일한 daxheap fd를 이용하여 marufs mount하기 위해 제공되는 인터페이스이므로 per-region slice 기능은 제공하지 않을 계획입니다.

[jooho-XCENA]

[HIGH] gc_pause가 world-writable (0644)

0644이면 모든 사용자가 GC를 일시정지/재개할 수 있습니다. GC가 멈추면 dead region과 orphan entry가 누적되어 메모리 고갈 및 서비스 거부로 이어집니다.

또한 gc_pause_store, gc_trigger_store, gc_stop_store, gc_restart_store 모두 capable(CAP_SYS_ADMIN) 체크가 없어, container/user-namespace 환경에서 비특권 사용자가 조작 가능합니다.

// 현재:
__ATTR(gc_pause, 0644, gc_pause_show, gc_pause_store);

// 권장:
__ATTR(gc_pause, 0600, gc_pause_show, gc_pause_store);
// + store 함수에 추가:
if (!capable(CAP_SYS_ADMIN))
    return -EPERM;

[moonchan-park]

Fixed in 27206dc. gc_pause 퍼미션 0644 → 0600으로 변경하고, gc_trigger/gc_stop/gc_pause/gc_restart 4개 store 함수 모두에 capable(CAP_SYS_ADMIN) 체크 추가.

[jooho-XCENA]

[HIGH] num_buckets 상한 미검증 — roundup_pow_of_two overflow

num_buckets는 사용자가 NRHT_INIT ioctl을 통해 제어합니다. num_buckets가 매우 큰 값(예: 0xFFFFFFFF)이고 num_shards=1이면:

1. buckets_per_shard = 0xFFFFFFFF
2. roundup_pow_of_two(0xFFFFFFFF) → 64비트에서 1UL << 32 = 0x100000000
3. bucket_array_size = 0x100000000 * 4 → u64 overflow 또는 total_needed 계산 이상
4. memset(base, 0, (size_t)total_needed) — region 경계를 넘어 CXL 메모리 write 가능

// roundup_pow_of_two 전에 상한 검증 추가:
if (buckets_per_shard > MARUFS_NRHT_MAX_ENTRIES)
    return -EINVAL;
buckets_per_shard = roundup_pow_of_two(buckets_per_shard);
if (buckets_per_shard == 0 || buckets_per_shard > MARUFS_NRHT_MAX_ENTRIES)
    return -EINVAL;

[moonchan-park]

Fixed in f74049b. roundup_pow_of_two 전후로 MARUFS_NRHT_MAX_ENTRIES 상한 검증 추가.

[jooho-XCENA]

[HIGH] setattr가 ATTR_SIZE 외의 변경을 무시 — chmod/chown/utimes 무효

setattr_prepare()로 검증 후 ATTR_SIZE만 처리하고 반환합니다. ATTR_UID, ATTR_GID, ATTR_MODE, ATTR_ATIME 등은 검증 통과 후 적용되지 않아, chmod/chown/utimes가 성공을 반환하지만 실제 변경 없습니다.

VFS 규약상 setattr_prepare() 통과 후 setattr_copy()를 호출하거나, 지원하지 않는 attribute는 -EPERM으로 명시적 거부해야 합니다.

if (attr->ia_valid & ATTR_SIZE) {
    // ... ftruncate 처리 ...
}

// 추가 필요:
setattr_copy(MARUFS_IDMAP_ARG_COMMA inode, attr);
// 또는: 지원하지 않는 경우 명시적 거부
if (attr->ia_valid & ~ATTR_SIZE)
    return -EPERM;

[moonchan-park]

Fixed in f74049b. ATTR_SIZE | ATTR_FORCE 외의 attr 변경 요청은 -EPERM으로 명시적 거부. CXL FS는 POSIX attr를 persist하지 않으므로 setattr_copy() 대신 거부 방식을 선택.

[jooho-XCENA]

[HIGH] f_bfree unsigned underflow — 비정상적 free space 보고

sbi->total_size와 used_size가 모두 u64이므로, metadata 손상이나 concurrent allocation으로 used_size > total_size가 되면 unsigned 뺄셈이 wrap하여 매우 큰 값이 됩니다.

// 현재:
buf->f_bfree = (sbi->total_size - used_size) / PAGE_SIZE;

// 권장:
if (used_size > sbi->total_size)
    buf->f_bfree = 0;
else
    buf->f_bfree = (sbi->total_size - used_size) / PAGE_SIZE;
buf->f_bavail = buf->f_bfree;

[moonchan-park]

Fixed in f74049b. used_size > sbi->total_size 가드 추가하여 unsigned underflow 방지.

[jooho-XCENA]

[HIGH] read_folio가 항상 zero-filled page 반환 — page cache 경로 데이터 손실

DAX mmap이 주 접근 경로이지만, sendfile(), splice(), 또는 non-DAX fallback 경로는 page cache를 통해 read_folio를 호출합니다. 현재 항상 zero page를 반환하므로 실제 CXL 메모리 데이터 대신 0을 읽게 됩니다.

권장:

1. CXL 메모리에서 데이터를 복사: memcpy_from_dax(page, sbi->dax_base + phys_offset + page_offset, ...) 또는
2. page cache 사용을 완전히 차단하고 read_iter만으로 서빙 (address_space_operations에서 read_folio 제거 후 적절한 대안 구현)

[moonchan-park]

Fixed in f74049b. CXL 데이터를 page cache로 복사하는 대신 -EIO로 차단하는 방식을 선택했습니다.

이유:

• read_folio 인터페이스에서 permission check를 끼워넣을 수 없어 marufs ACL 모델 우회
• DRAM page cache에 CXL 데이터 복사본이 남아 cross-node 일관성 깨짐
• read() 시스콜은 read_iter에서 직접 CXL 복사 + 권한 체크로 정상 지원

sendfile/splice는 DAX FS의 KV cache 워크로드에서 사용하지 않으므로 차단해도 영향 없습니다.

[jooho-XCENA]

[HIGH] set_page_dirty() — 커널 6.8+에서 제거됨, 빌드 실패

set_page_dirty()는 커널 6.8에서 제거되었습니다 (folio_mark_dirty()로 대체). 이 모듈의 compat.h가 6.17까지 지원하므로 최신 커널에서 빌드가 실패합니다.

// 현재:
set_page_dirty(page);

// 권장:
folio_mark_dirty(page_folio(page));
// 또는 compat.h에 shim 추가:
#if LINUX_VERSION_CODE >= KERNEL_VERSION(6, 8, 0)
    folio_mark_dirty(page_folio(page));
#else
    set_page_dirty(page);
#endif

[moonchan-park]

Fixed in f74049b. compat.h에 marufs_set_page_dirty() inline 함수 추가 (6.8+ → folio_mark_dirty(), 이전 → set_page_dirty()). file.c에서는 compat 함수를 호출.