Direct I/O要求缓冲区地址、文件偏移和I/O长度均对齐至逻辑扇区大小（如4096字节），需用posix_memalign分配对齐内存、校准offset与count，并通过blockdev或lsblk确认设备对齐参数。
Direct I/O 模式下，文件读取必须满足块设备的对齐要求，否则系统会报错（如 Invalid argument）。directio_alignment 并非 Linux 内核或标准 libc 的配置项，而是某些存储中间件（如 Ceph RBD、QEMU、部分用户态文件系统）中用于显式声明或校验 I/O 对齐约束的参数。真正起作用的是底层块设备的逻辑/物理扇区大小，以及用户空间缓冲区和文件偏移的对齐方式。
确认底层块设备的对齐要求
使用 blockdev 或 lsblk 查看设备的真实对齐信息：
-
sudo blockdev --getss /dev/sdX：获取逻辑扇区大小（通常为 512 或 4096 字节） -
sudo blockdev --getpbsz /dev/sdX：获取物理扇区大小（常见为 4096） -
sudo blockdev --getalignoff /dev/sdX：获取对齐偏移（多数为 0，表示从 LBA 0 开始对齐） -
lsblk -o NAME,LOG-SEC,PHY-SEC,ALIGNMENT /dev/sdX：一站式查看
Direct I/O 要求：缓冲区地址（buf）、文件偏移（offset）、I/O 长度（count）三者都需是逻辑扇区大小的整数倍；更严格场景（如某些 NVMe 或高级格式化磁盘）还要求地址和偏移对齐到物理扇区大小。
在应用层手动保证对齐
调用 open() 时启用 O_DIRECT 后，必须自行管理内存与偏移对齐：
-
分配对齐内存：用
posix_memalign()分配页对齐（推荐 4096 字节）缓冲区：void *buf; posix_memalign(&buf, 4096, buflen); -
确保文件偏移对齐：读写前检查并调整
lseek()或pread/pwrite的 offset：off_t aligned_off = (offset / 4096) * 4096; - I/O 长度也需对齐：若只需读部分数据，先按对齐单位读入缓冲区，再 memcpy 到目标位置
在 QEMU/KVM 或 Ceph RBD 中设置 directio\_alignment
这类参数多见于虚拟化或分布式块设备驱动的配置中，用于告知上层“本设备期望的最小对齐粒度”：
-
QEMU RBD 驱动：在
-drive参数中通过cache.direct=on启用 Direct I/O，并隐式依赖 RBD image 的object-size和底层 OSD 对齐策略；部分版本支持alignment=4096显式指定 -
Ceph RBD kernel client（rbd.ko）：内核模块本身不暴露
directio_alignment接口，但可通过rbd map后对/dev/rbdX执行blockdev --setra 0禁用预读，并确保用户态程序按上述方式对齐 -
用户态 RBD（librbd + fuse 或 custom daemon）：可在初始化
rbd_image_t后调用rbd_get_alignment()获取推荐对齐值，作为posix_memalign的 align 参数
验证是否对齐成功
运行时可通过 strace 观察系统调用是否失败：
strace -e trace=open,read,pread64,mmap -f ./your_app 2>&1 | grep -E "(open|read|EIO|EINVAL)"- 若出现
read(..., O_DIRECT) = -1 EINVAL，大概率是缓冲区地址或 offset 未对齐 - 也可在代码中添加断言：
assert(((uintptr_t)buf & 4095) == 0 && (offset & 4095) == 0 && (count & 4095) == 0);
