当前位置：首页 > news >正文

debugfs：Linux 内核调试的利器

news 来源：原创 2025/8/9 22:58:01

一、什么是 debugfs？
二、debugfs 的配置和启用方式
- 2.1 内核配置选项
- 2.2 挂载 debugfs
- 2.3 Android 系统中的 debugfs
三、debugfs 的典型应用场景
- 3.1 调试驱动开发
- 3.2 内核子系统调试
- 3.3 性能分析
四、常见 debugfs 子目录与功能示例
- 4.1 /sys/kernel/debug/tracing - 内核跟踪核心目录
- 4.2 /sys/kernel/debug/gpio - GPIO 状态调试
- 4.3 /sys/kernel/debug/regulator - 电源调节器状态
- 4.4 /sys/kernel/debug/dma_buf - DMA buffer 分析
- 4.5 /sys/kernel/debug/<自定义驱动名>/
五、调试案例：自定义驱动中使用 debugfs
六、debugfs 的工作原理和核心机制
七、核心 API 总览
八、线上环境下的注意事项与安全性问题
- 8.1 信息泄露风险
- 8.2 系统稳定性风险
- 8.3 Android 安全限制节
九、补充：debugfs 与 procfs、sysfs 的区别

一、什么是 debugfs？

debugfs 是 Linux 内核提供的一个专用文件系统，主要用于内核与用户空间之间的调试信息交换。它为内核开发人员或者驱动开发者提供了一种无需修改内核代码即可获取内部状态的方式。

相比 /proc 和 /sys，debugfs 更偏向临时调试用途，适合暴露实验性、不稳定或仅用于开发阶段的接口。

特点：

动态创建、无需重新编译内核。
文件操作接口简单，可通过 shell 脚本或 C 语言轻松操作。
开发者常用于调试驱动、查看内部状态、动态注入参数等。

二、debugfs 的配置和启用方式

2.1 内核配置选项

要使用 debugfs，首先需要在编译内核时启用支持：

CONFIG_DEBUG_FS=y

如果你使用的是 Android 或嵌入式系统，也可在 menuconfig 中启用：

Kernel hacking  --->  
[*] Debug Filesystem

此选项默认对主线内核是开启的，但某些发行版或定制系统可能关闭以减小体积或提高安全性。

2.2 挂载 debugfs

一般系统启动时不会自动挂载 debugfs，你可以手动挂载：

sudo mount -t debugfs none /sys/kernel/debug

也可以在启动脚本中加入自动挂载逻辑：

if ! mountpoint -q /sys/kernel/debug; then  mount -t debugfs none /sys/kernel/debug
fi

验证：

 ls /sys/kernel/debug/

输出类似如下则表示挂载成功：

bdi/  clk/  gpio/  tracing/  suspend_stats  ...

2.3 Android 系统中的 debugfs

Android 默认处于安全模式，大多数生产环境中是关闭的。可以通过如下方式在开发版系统中开启：

adb shell
mount -t debugfs debugfs /sys/kernel/debug

部分 Android 内核会禁用 CONFIG_DEBUG_FS，需要通过修改 kernel defconfig 启用并重新编译。

三、debugfs 的典型应用场景

debugfs 通常用于以下几个方面：

3.1 调试驱动开发

我们可以将调试信息、参数、状态变量通过 debugfs 暴露出来，便于动态查看或调整，而无需反复修改内核代码、重启内核。例如：

读取设备寄存器
控制调试开关（如 loglevel）
查看缓存、状态统计信息等

3.2 内核子系统调试

很多内核子系统默认就通过 debugfs 暴露接口，例如：

tracing（ftrace）
gpio 状态查看与操作
regulator 状态与调节
DMA buf debug 信息
audio 子系统的 debug log（如 asoc）

3.3 性能分析

结合 ftrace（内核函数跟踪器）可以做函数调用路径分析、系统延迟检测、实时调试。

四、常见 debugfs 子目录与功能示例

4.1 /sys/kernel/debug/tracing - 内核跟踪核心目录

这是 ftrace 的主目录，可以分析函数调用、调度、延迟等。常见文件：

available_tracers：可用的跟踪器类型
current_tracer：当前启用的跟踪器
trace：跟踪结果输出
set_ftrace_filter：设置要跟踪的函数

示例：

# 开启函数跟踪
echo function > /sys/kernel/debug/tracing/current_tracer
# 查看 trace 日志
cat /sys/kernel/debug/tracing/trace

4.2 /sys/kernel/debug/gpio - GPIO 状态调试

查看系统中所有 GPIO 控制器和当前引脚状态：

cat /sys/kernel/debug/gpio

输出类似：

gpiochip0: GPIOs 0-31, parent: platform/10012000.gpio, gpio-controller 
gpio-4   (sysfs               ) out hi    
gpio-17  (wifi_power         ) out lo

4.3 /sys/kernel/debug/regulator - 电源调节器状态

可查看/调试 regulator 驱动注册的电压、状态等：

cat /sys/kernel/debug/regulator/ */status
cat /sys/kernel/debug/regulator/ */microvolts

4.4 /sys/kernel/debug/dma_buf - DMA buffer 分析

可用于分析图形子系统中共享内存的引用情况：

cat /sys/kernel/debug/dma_buf/bufinfo

4.5 /sys/kernel/debug/<自定义驱动名>/

我们可以调用 debugfs_create_* 系列 API 在这里创建自己的调试目录和接口，支持暴露：

整数、布尔变量
文件接口（read/write）
二进制 blob（例如 buffer dump）

五、调试案例：自定义驱动中使用 debugfs

一个简单的例子：假如我们正在开发一个字符设备驱动，需要调试内部状态：

#include <linux/debugfs.h>
static struct dentry *debug_dir;
static u32 debug_val = 0;
static int __init mydrv_init(void)
{debug_dir = debugfs_create_dir("mydrv", NULL);if (!debug_dir)return -ENOMEM;debugfs_create_u32("debug_val", 0644, debug_dir, &debug_val);return 0;
}
static void __exit mydrv_exit(void)
{debugfs_remove_recursive(debug_dir);
}

加载驱动后可直接查看或设置：

cat /sys/kernel/debug/mydrv/debug_val
echo 42 > /sys/kernel/debug/mydrv/debug_val

这比 printk + 重编译 + 重启流程更高效，尤其适合频繁调试场景。

六、debugfs 的工作原理和核心机制

debugfs 实际上是一个虚拟文件系统（Virtual File System, VFS），类似于 /proc 和 /sys，其底层由内核代码负责维护和注册。

它的本质是：
内核将特定结构体变量映射为文件或目录，通过 file_operations 让用户空间可以读写这些内核变量或结构体。

关键实现机制：

debugfs_create_*() 系列 API 用于创建虚拟文件
每个文件背后对应一个 file_operations，封装了 read/write 行为
这些文件操作最终在 debugfs 挂载点下暴露给用户空间

例如，debugfs_create_u32("val", 0644, parent, &var) 就等价于暴露了一个变量 var 到文件系统中，可以直接读写。模块注册结构图如下：
在这里插入图片描述

七、核心 API 总览

基本语法格式：

API名称	功能
debugfs_create_dir(name, parent)	创建子目录
debugfs create file(name, mode, parent, data, fops)	创建具备操作函数的文件
debugfs_create_u32(name, mode, parent, ptr)	绑定变量为 u32 文件
debugfs_create bool(name, mode, parent, ptr)	创建布尔值控制项
debugfs_remove(entry)	删除单个debugfs项
debugfs_remove_recursive(entry)	递归删除整个目录树

示例：绑定一个只读的布尔变量

static bool debug_flag = true;
debugfs_create_bool("enable_debug", 0444, parent_dir, &debug_flag);

用户空间读取：

cat /sys/kernel/debug/mydrv/enable_debug

虽然 debugfs 极大地方便了开发与调试，但在生产环境下要慎用或禁用，主要原因包括：

八、线上环境下的注意事项与安全性问题

8.1 信息泄露风险

debugfs 会暴露大量内核内部信息，黑客或恶意程序可借此探测系统结构。
某些接口甚至允许直接写入数据，可能对系统稳定性产生影响。

8.2 系统稳定性风险

由于很多 debugfs 文件由开发者编写，若实现不严谨可能导致 panic。
示例：越界访问、没有加锁保护、引用了已释放的结构体等。

8.3 Android 安全限制节

Android 生产版默认关闭 debugfs
SELinux 和 seccomp 等机制会阻止其挂载

推荐的安全策略：

线上系统关闭 CONFIG_DEBUG_FS，从内核构建阶段禁止。
或者通过配置挂载权限为只读，并结合 SELinux 限制访问。
对自定义 debugfs 文件做好访问控制，严格限制 read/write 权限。

九、补充：debugfs 与 procfs、sysfs 的区别

特性	debugfs	procfs	sysfs
主要用途	调试/开发	进程信息	内核对象模型
是否稳定	否(可变)	是	是
是否推荐线上启用	否	是	是
是否支持驱动自定义接口	支持	支持但复杂	支持但需 class/device

debugfs：Linux 内核调试的利器

目录一、什么是 debugfs？二、debugfs 的配置和启用方式2.1 内核配置选项2.2 挂载 debugfs2.3 Android 系统中的 debugfs 三、debugfs 的典型应用场景3.1 调试驱动开发3.2 内核子系统调试3.3 性能分析四、常见 debugfs 子目录与功能示例4.1 /sys/kernel/debug/trac…...

编程日记 2025/8/9 22:58:01

Spyglass：跨时钟域同步（同步使能）

相关阅读 Spyglasshttps://blog.csdn.net/weixin_45791458/category_12828934.html?spm1001.2014.3001.5482 简介同步使能方案主要用于数据信号跨时钟域同步，该方案将一个控制信号同步至目标时钟域并用其作为数据信号的捕获触发器的使能信号，如图1所示…...

编程日记 2025/8/9 23:45:46

环境 CentOS7 参考 minikube start | minikube 创建虚拟机，参考模拟Gitlab安装-CSDN博客下载二进制包 curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 报错不能解析host，配置host 下载成功安装 sudo install minikube-linux-am…...

编程日记 2025/8/9 18:14:59

图像锐化调整

一、背景介绍之前找多尺度做对比度增强时候，发现了一些锐化相关算法，正好本来也要整理锐化，这里就直接顺手对之前做过的锐化大概整理了下，方便后续用的时候直接抓了。这里整理的锐化主要是两块：一个是参考论文&#…...

编程日记 2025/8/9 23:30:20

【CanMV K230】AI_CUBE1.4

《k230-AI 最近小伙伴有做模型的需求。所以我重新捡起来了。正好把之前没测过的测一下。这次我们用的是全新版本。AICUBE1.4.dotnet环境9.0 注意AICUBE训练模型对硬件有所要求。最好使用独立显卡。有小伙伴说集显也可以。emmmm可以试试哈集显显存2G很勉强了。我们依然用…...

编程日记 2025/8/9 23:35:27

STM32外设AD-定时器触发 + DMA读取模板

STM32外设AD-定时器触发 DMA读取模板一，方法思路二，定时器基础与配置1，定时器时钟源 (Clock Source)2，预分频器 (Prescaler - PSC)3，自动重装载寄存器 (Auto-Reload Register - ARR) / 周期 (Period)4，触…...

编程日记 2025/8/9 23:38:04

数据库故障排查指南：从入门到精通

1. 常见数据库故障类型 1.1 连接故障数据库连接超时连接池耗尽网络连接中断认证失败1.2 性能故障查询执行缓慢内存使用过高CPU使用率异常磁盘I/O瓶颈1.3 数据故障数据不一致数据丢失数据损坏事务失败2. 故障排查流程 2.1 初步诊断 -- 检查数据库状态SHOW STATUS;SHOW PRO…...

编程日记 2025/8/9 23:40:39

【AT32】 AT32 移植 Freemodbus 主站

基于野火开发板 at32f437zgt6芯片和at32 官方开发工具移植了网上一套开源的freemodbus 主站这里对modbus 协议不做过多的讲解主要已实现代码为主 AT32 Work Bench 参考之前我之前的配置与stm32cubemx软件差不多注意485芯片的收发脚配置即可 AT32 IDE 说实话这软件太垃…...

编程日记 2025/8/9 23:40:41

内网环境下如何使用ntpdate实时同步时间

背景介绍 NTP（Network Time Protocol）是一种网络协议，用于同步计算机系统的时间。ntpdate是一个用于手动同步时间的命令行工具，它可以从指定的NTP服务器获取当前时间并更新本地系统时间。 ntpdate 服务介绍功能：ntp…...

编程日记 2025/8/9 19:06:45

python版本管理工具-pyenv轻松切换多个Python版本

在使用python环境开发时，相信肯定被使用版本所烦恼，在用第三方库时依赖兼容的python版本不一样，有没有一个能同时安装多个python并能自由切换的工具呢，那就是pyenv，让你可以轻松切换多个Python 版本。 pyenv是什么 p…...

编程日记 2025/8/9 23:32:52

工商总局可视化模版 – 基于ECharts的大数据可视化HTML源码

概述在大数据时代，数据可视化已成为各行各业进行数据分析和决策的重要工具。幽络源今天为大家带来一款基于ECharts的工商总局数据可视化HTML模版，帮助开发者快速搭建专业级工商广告数据展示平台。这款模版设计规范，功能完善，适合…...

编程日记 2025/8/9 23:35:26

计算机网络：网络基础

计算机网络 ： 网络基础目录计算机网络 ： 网络基础引言1. 网络发展背景2. 初始协议2.1 初始协议2.2 协议分层2.2.1 软件分层的好处2.2.2 OSI七层模型2.2.3 TCP/IP五层（四层）模型 2.3 TCP/IP协议2.3.1TCP/IP协议与操作系统的关系&…...

编程日记 2025/8/9 23:32:52

eSwitch manager 简介

eSwitch manager 的定义和作用 eSwitch manager 通常指的是能够配置和管理 eSwitch（嵌入式交换机）的实体或接口。在 NVIDIA/Mellanox 的网络架构中，Physical Function（PF）在 switchdev 模式下充当 eSwitch manager&am…...

编程日记 2025/8/9 23:27:47

物联网技术在银行安全用电系统中的应用与实践研究

摘要随着金融科技的快速发展，银行业电子设备数量激增，用电安全管理问题日益突出。本文基于2019年农业银行与2020年中国邮政储蓄银行发布的安全用电相关政策，分析了银行场景下存在的五大用电安全隐患，提出以物联网技术为核心的安…...

编程日记 2025/8/9 23:32:51

589. N叉树的前序遍历迭代法：null指针与栈的巧妙配合

一、题目描述给定一个N叉树的根节点，返回其节点值的前序遍历结果。前序遍历的定义是：先访问根节点，再依次遍历每个子节点（从左到右）。例如，对于如下N叉树： 1/ | \3 2 4 / \ 5 6前序遍历结果…...

编程日记 2025/8/9 23:35:26

【洗车店专用软件】佳易王洗车店多项目会员管理系统：一卡多用扣次软件系统实操教程 #扣次洗车管理软件

一、软件试用版资源文件下载说明 （一）若您想体验软件功能，可通过以下方式获取软件试用版资源文件： 访问头像主页：进入作者头像主页，找到第一篇文章，点击文章最后的卡片按钮，即可了解…...

编程日记 2025/8/9 23:38:03

小红书笔记详情接口如何调用？实操讲解。

调用小红书笔记详情接口通常需要经过申请权限、构建请求、发送请求并处理响应等步骤，以下是详细的实操讲解： 一、申请接口权限注册小红书开放平台账号访问小红书开放平台官网/第三方开放平台，按照提示完成注册流程，提供必要的…...

编程日记 2025/8/9 23:35:25

leetcode 57. Insert Interval

题目描述代码：由于intervals已经按照左端点排序，并且intervals中的区间全部不重叠，那么可以断定intervals中所有区间的右端点也已经是有序的。先二分查找intervals中第一个其右端点>newInterval左端点的区间。然后按照类似于56. Merge In…...

编程日记 2025/8/9 23:48:22

杰理ac696配置mic

省电容mic有概率不出声解决办法如下...

编程日记 2025/8/9 14:23:26

COMSOL随机参数化表面流体流动模拟

基于粗糙度表面的裂隙流研究对于理解地下水的流动、污染物传输以及与之相关的地质灾害（如滑坡）等方面具有重要意义。本研究通过蒙特卡洛方法生成随机表面形貌，并利用COMSOL Multiphysics对随机参数化表面的微尺度流体流动进行模拟。参数化…...

编程日记 2025/8/9 23:51:04

Linux远程连接服务

远程连接服务器简介远程连接服务器通过文字或图形接口方式来远程登录系统，让你在远程终端前登录linux主机以取得可操作主机接口（shell），而登录后的操作感觉就像是坐在系统前面一样。远程连接服务器的功能分享主机的运算能力远…...

编程日记 2025/8/9 23:48:21

用Python绘制梦幻星空

用Python绘制梦幻星空在这篇教程中，我们将学习如何使用Python创建一个美丽的星空场景。我们将使用Python的图形库Pygame和随机库来创建闪烁的星星、流星和月亮，打造一个动态的夜空效果。项目概述我们将实现以下功能： 创建深蓝色的夜…...