背景
在 ttm_bo_init_reserved() 函数中(drivers/gpu/drm/ttm/ttm_bo.c),BO 初始化时有一段关键的条件判断:
/*
* For ttm_bo_type_device buffers, allocate
* address space from the device.
*/
if (bo->type == ttm_bo_type_device || bo->type == ttm_bo_type_sg) {
ret = drm_vma_offset_add(bdev->vma_manager, &bo->base.vma_node,
PFN_UP(bo->base.size));
if (ret)
goto err_put;
}
只有 ttm_bo_type_device 和 ttm_bo_type_sg 两种类型才会调用 drm_vma_offset_add(),
而 ttm_bo_type_kernel 不会。本文解释其背后的设计原因。
TTM BO 三种类型定义
定义于 include/drm/ttm/ttm_bo.h:
enum ttm_bo_type {
ttm_bo_type_device, /* 用户可 mmap 的普通 BO */
ttm_bo_type_kernel, /* 仅内核使用,用户不可访问 */
ttm_bo_type_sg /* 来自 dma-buf sg table,跨驱动共享 */
};
drm_vma_offset_add 的作用
drm_vma_offset_manager 是 DRM 子系统提供的一个虚拟地址空间分配器,底层使用
drm_mm(DRM 的线性地址空间管理器)实现。
它的核心功能是:为每个 BO 分配一个唯一的伪文件页偏移(fake page offset),
使得用户空间可以通过以下流程将 BO 映射到进程地址空间:
用户空间调用 GEM_MMAP ioctl
→ 内核返回 mmap offset(由 vma_manager 分配)
→ 用户空间调用 mmap(fd, offset, size, …)
→ 内核的 .mmap 回调通过 offset 找到对应 BO
→ 建立用户空间 VMA 到 BO 物理内存的映射
偏移值来自:
// 64位系统上的地址空间范围(页单位)
#define DRM_FILE_PAGE_OFFSET_START ((0xFFFFFFFFUL >> PAGE_SHIFT) + 1)
#define DRM_FILE_PAGE_OFFSET_SIZE ((0xFFFFFFFFUL >> PAGE_SHIFT) * 256)
为什么各类型的处理不同
ttm_bo_type_device:必须分配 VMA offset
- 代表用户态普通 BO(对应 DRM_IOCTL_AMDGPU_GEM_CREATE 创建的 BO)。
- 用户空间通过 GEM_MMAP ioctl 或 DRM_IOCTL_MODE_MAP_DUMB 获取 mmap offset,
再通过 mmap() 将 BO 映射到进程地址空间进行 CPU 读写。 - 没有 VMA offset,用户空间就无法 mmap 这块内存。
ttm_bo_type_sg:必须分配 VMA offset
- 代表从 dma-buf 导入的 BO,底层内存由 scatter-gather 表描述,物理内存来自另一个驱动。
- 该类型的 BO 在本驱动侧同样需要 VMA offset,原因:
- 支持通过本驱动的文件描述符进行 CPU mmap 访问。
- dma-buf 的 CPU 访问路径(dma_buf_mmap())需要通过 vma_node 找到对应 BO。
- DRM prime 导入导出机制需要 BO 在 vma_manager 中有合法位置。
ttm_bo_type_kernel:跳过 VMA offset 分配
- 代表内核专用 BO,用于驱动内部使用(帧缓冲保留区、命令缓冲区、页表 BO 等)。
- 内核文档明确说明:cannot be accessed from user-space。
- 它永远不会被用户空间 mmap(),因此:
- 不需要占用 vma_manager 的地址空间资源。
- 跳过此步骤可以提高性能(减少 drm_mm 操作)。
- 更重要的是安全性:若意外为内核 BO 分配了 VMA offset,
理论上用户空间可以通过猜测 offset 尝试 mmap 内核内存,造成安全隐患。
完整数据流对比
ttm_bo_type_device:
创建 BO → drm_vma_offset_add() 分配 fake offset
→ 用户调用 GEM_MMAP ioctl 获取 offset
→ 用户调用 mmap(drm_fd, offset << PAGE_SHIFT, size)
→ 内核 .mmap → drm_vma_offset_lookup_locked() 找到 BO
→ ttm_bo_vm_fault() 处理缺页,建立 PTE 映射
ttm_bo_type_sg:
dma-buf import → ttm_bo_type_sg BO 创建 → drm_vma_offset_add()
→ 支持通过本驱动 mmap 或 dma_buf_mmap() 访问
ttm_bo_type_kernel:
创建 BO → 跳过 drm_vma_offset_add()
→ 内核通过 amdgpu_bo_kmap() / ttm_bo_kmap() 直接建立内核虚拟地址映射
→ 用户空间无任何访问路径
释放时的对称性
在 ttm_bo_release() 中,只有持有 VMA offset 的 BO 才需要释放:
drm_vma_offset_remove(bdev->vma_manager, &bo->base.vma_node);
由于 ttm_bo_type_kernel 从未调用 drm_vma_offset_add(),
其 vma_node 中的 vm_node 为空(drm_mm_node 未被初始化为已分配状态),
drm_vma_offset_remove() 对空节点是安全的 no-op,不会造成问题。
总结
| ttm_bo_type_device | ✅ 是 | 用户空间需要通过 mmap() 访问 |
| ttm_bo_type_sg | ✅ 是 | dma-buf 导入 BO,需支持跨驱动 CPU 映射 |
| ttm_bo_type_kernel | ❌ 否 | 纯内核使用,无用户空间访问路径,节省资源且更安全 |
核心原则:VMA offset 是"用户空间 mmap 入口"的票据,只有需要被用户空间访问的 BO 才需要持有它。
