文件系统#

一个纯文件系统 L2 适配器,使用异步 I/O (aiofiles)。每个 KV 缓存对象以原始 .data 文件的形式存储,文件名编码了完整的 ObjectKey需要 NIXL——可在任何 POSIX 文件系统上运行。

必填字段:

  • base_path: 存储 KV 缓存文件的目录。

可选字段:

  • relative_tmp_dir: 写入期间临时文件的相对子目录(完成时进行原子重命名)。

  • read_ahead_size: 通过预先读取指定字节数来触发文件系统预读(正整数,可选)。

  • use_odirect: truefalse(默认 false)-- 通过 O_DIRECT 绕过页面缓存。

配置示例:

# Basic FS adapter
--l2-adapter '{"type": "fs", "base_path": "/data/lmcache/l2"}'

# With temp directory
--l2-adapter '{"type": "fs", "base_path": "/data/lmcache/l2", "relative_tmp_dir": ".tmp"}'

# With O_DIRECT for bypassing page cache
--l2-adapter '{"type": "fs", "base_path": "/data/lmcache/l2", "use_odirect": true}'