需启用内核DMA调试功能并分析缓冲区状态：一、通过make menuconfig开启DMA-API debugging等选项并重编内核；二、用dma_debug=on启动参数动态启用；三、挂载debugfs查看allocations、last_fail等信息；四、用ftrace跟踪dma_map_single等函数调用链；五、用kmemleak检测dma_alloc_coherent泄漏。
如果您在Linux内核开发过程中需要观察DMA传输行为或排查DMA相关内存异常，则需启用内核DMA调试功能并分析DMA缓冲区状态。以下是具体操作步骤：
一、启用内核DMA调试选项
通过重新配置内核，开启DMA调试支持，使内核在分配/释放DMA缓冲区时记录详细日志并执行额外一致性检查。
1、进入内核源码目录，运行 make menuconfig。
2、依次展开 Device Drivers → DMA Engine support → DMA Debugging Framework，将 DMA-API debugging 设为 *（built-in）。
3、同时启用 Debug DMA-API usage 和 Enable debugging of DMA-API usage 子选项。
4、保存配置并重新编译安装内核镜像与模块。
5、启动新内核后，通过 dmesg | grep -i dma 验证调试框架是否加载成功。
二、通过dma-api-debug参数动态启用调试
若无法重新编译内核，可在启动时通过内核命令行参数临时启用DMA调试，适用于测试环境快速验证。
1、编辑GRUB配置文件 /etc/default/grub，在 GRUB_CMDLINE_LINUX 行末尾添加 dma_debug=on。
2、运行 sudo update-grub（Debian/Ubuntu）或 sudo grub2-mkconfig -o /boot/grub2/grub.cfg（RHEL/CentOS）。
3、重启系统，确认启动参数生效：执行 cat /proc/cmdline | grep dma_debug，应输出 dma_debug=on。
4、触发DMA操作（如加载驱动、启动设备传输），随后检查 dmesg 输出中是否存在DMA API违规警告（如未匹配的alloc/free、地址越界等）。
三、使用debugfs查看DMA调试信息
内核DMA调试框架在debugfs中暴露运行时统计与错误记录，可实时获取已注册DMA映射的详细信息。
1、挂载debugfs：执行 sudo mount -t debugfs none /sys/kernel/debug。
2、进入DMA调试目录：运行 cd /sys/kernel/debug/dma-api。
3、查看当前活跃DMA映射数：读取 cat allocations，输出格式为 total: X, failed: Y, active: Z。
4、查看最近DMA错误详情：执行 cat last_fail，包含出错函数、调用栈、DMA地址及size。
5、导出全部当前DMA映射快照：运行 cat dma-api-current，每行含设备名、虚拟地址、总线地址、size、方向、映射时间戳。
四、结合ftrace跟踪DMA映射路径
利用ftrace捕获DMA相关函数调用序列，定位驱动中DMA映射/取消映射的上下文及参数传递问题。
1、启用ftrace：执行 echo function > /sys/kernel/debug/tracing/current_tracer。
2、过滤DMA函数：向 /sys/kernel/debug/tracing/set_ftrace_filter 写入关键函数名，例如：dma_map_single,dma_unmap_single,dma_alloc_coherent,dma_free_coherent。
3、开启跟踪：运行 echo 1 > /sys/kernel/debug/tracing/tracing_on。
4、复现DMA操作（如设备probe或数据收发）。
5、停止跟踪并读取结果：执行 echo 0 > /sys/kernel/debug/tracing/tracing_on，再读取 cat /sys/kernel/debug/tracing/trace 获取完整调用链。
五、使用kmemleak检测DMA缓冲区泄漏
kmemleak可识别未被释放的DMA内存块，尤其适用于长期运行设备驱动中因未调用dma_free_coherent导致的内存泄漏。
1、确保内核配置中启用了 CONFIG_DEBUG_KMEMLEAK=y 并作为内置模块编译。
2、启动后启用扫描：执行 echo scan > /sys/kernel/debug/kmemleak。
3、等待数秒后触发一次完整扫描：运行 echo scan > /sys/kernel/debug/kmemleak 两次。
4、检查泄漏报告：执行 cat /sys/kernel/debug/kmemleak，若存在DMA分配未释放，将显示类似 unreferenced object 0xffffXXXXXX (size 4096) 的条目，并附带分配调用栈。
5、定位泄漏点：在报告中查找包含 dma_alloc_coherent 或 dma_pool_alloc 的调用栈，比对驱动源码中对应位置是否缺失配对的释放调用。
