Linux下的Debugfs

🕗 发布于 2024-11-05 13:46 嵌入式 linux

debugfs

1. 简介

类似sysfs、procfs，debugfs 也是一种内存文件系统。不过不同于sysfs一个kobject对应一个文件，procfs和进程相关的特性，debugfs的灵活度很大，可以根据需求对指定的变量进行导出并提供读写接口。debugfs又是一个Linux中 everything is a file 哲学的体现，通过VFS实现了对驱动的控制。可以通过以下命令，来挂载debugfs到指定目录。
Debugfs其存在的主要意义是为了内核开发者向用户空间传递更多有用的信息，与proc不同，proc只提供进程相关的信息；同时也与sysfs不同，sysfs对每个文件都要求一定的规则，而Debugfs没有任何的规则。
简而言之，Debugfs是一种用于内核调试的虚拟文件系统。
用途：将内核程序中的变量以文件的形式直观的展现出来，并可以直接通过文件操作来读取或修改内核变量的值，便于开发调试

2. 食用方式

1. 内核使能Debudfs

在menuconfig中使能DEBUG_FS = y

在这里插入图片描述

2.挂载命令

mount -t debugfs none /sys/kernel/debug

3.内核接口

1. API接口

想要使用Debugfs功能，首先要做的就是要包含 <linux/debugfs.h>头文件
使用debugfs_create_dir接口，创建一个文件夹，用于保存debugfs所操作的文件
使用debugfs_create_file接口，创建多个文件进行操作

2. API介绍

1. debugfs_create_dir

struct dentry *debugfs_create_dir(const char *name, struct dentry *parent);

参数	作用	备注
name	文件夹名称
parent	父目录	如果为NULL，则在/sys/kernel/debug目录下
dentry	返回值	表示创建的 debugfs 文件（或目录）的 dentry 节点。如果文件创建成功，它返回一个有效的 dentry 指针；如果创建失败，则返回 NULL。

2. debugfs_create_file

struct dentry *debugfs_create_file(const char *name, umode_t mode,
                                   struct dentry *parent, void *data,
                                   const struct file_operations *fops);

参数	作用	备注
name	文件名称
mode	文件访问权限	可以是整型（比如0644）也可以使用内核的宏
parent	父目录，用于保存该文件	如果为空则该文件的父目录为根目录
data	文件操作的私有数据	inode的i_private字段指向这个结构
fops	文件的自定义操作	可以自定义所有操作接口，也可以使用宏`DEFINE_SIMPLE_ATTRIBUTE`指定读写操作即可

DEFINE_SIMPLE_ATTRIBUTE宏：

// 
// __get: 读操作 int (*get)(void *data, u64 *value),👇
//bash下cat file ，回显内容便是内核层传给应用层的*value的值
// __set: 写操作 int (*set)(void *data, u64 value),👇
//bahs下echo 1 > file , value的值便是应用层传入内核层的数据1
// __fmt: 用于指定 get 和 set 函数的输入输出格式。 const char *fmt👇
//例如，它可以定义一个整数、浮点数或字符串的格式，以便在 sysfs 读写操作接口中正确显示或解析值。
#define DEFINE_SIMPLE_ATTRIBUTE(__fops, __get, __set, __fmt)\
static int __fops ## _open(struct inode *inode, struct file *file)\
{\
__simple_attr_check_format(__fmt, 0ull);\
return simple_attr_open(inode, file, __get, __set, __fmt);\
}\

3. debugfs_create_u8

void debugfs_create_u8(const char *name, umode_t mode,struct dentry *parent, u8 *value);

参数	作用	备注
name	文件名	一般以变量名来命名，方便调试
mode	文件权限
parent	父目录
value	变量	变量的值会被存在文件内

其他变量类型的接口：👇

//创建十进制的无符号文件
void debugfs_create_u8(const char *name, umode_t mode,
                       struct dentry *parent, u8 *value);
void debugfs_create_u16(const char *name, umode_t mode,
                        struct dentry *parent, u16 *value);
void debugfs_create_u32(const char *name, umode_t mode,
                        struct dentry *parent, u32 *value);
void debugfs_create_u64(const char *name, umode_t mode,
                        struct dentry *parent, u64 *value);
//创建十六进制的无符号文件
void debugfs_create_x8(const char *name, umode_t mode,
                       struct dentry *parent, u8 *value);
void debugfs_create_x16(const char *name, umode_t mode,
                        struct dentry *parent, u16 *value);
void debugfs_create_x32(const char *name, umode_t mode,
                        struct dentry *parent, u32 *value);
void debugfs_create_x64(const char *name, umode_t mode,
                        struct dentry *parent, u64 *value);

//创建一个size_t类型的文件
void debugfs_create_size_t(const char *name, umode_t mode,struct dentry *parent, size_t *value);
//创建一个unsigned long类型的文件
struct dentry *debugfs_create_ulong(const char *name, umode_t mode,struct dentry *parent,unsigned long *value);
//创建一个十六进制的unsigned long类型的文件
void debugfs_create_xul(const char *name, umode_t mode,struct dentry *parent, unsigned long *value);
// 布尔型
void debugfs_create_bool(const char *name, umode_t mode,
                         struct dentry *parent, bool *value);

Deme one

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/debugfs.h>

static struct dentry *dir = NULL;

static unsigned int debugfs_hello;

static u32 sum = 0;

static int add_write(void *data, u64 value)
{
    sum += value;
    return 0;
}
// 文件操作变量名，get读操作，set写操作，将读写操作的返回值以字符串格式化的形式读出或写入文件内部
DEFINE_SIMPLE_ATTRIBUTE(add_ops, NULL, add_write, "%llu\n");

static __init int hello_init(void)
{
    struct dentry *tmp_dir = NULL;

    /* create /sys/kernel/debug/debugfs_hello/ directory */
    dir = debugfs_create_dir("debugfs_hello", NULL);
    if (!dir) {
        printk(KERN_ALERT "debugfs_create_dir failed\n");
        return -1;
    }

    /* create /sys/kernel/debug/debugfs_hello/hello value, mode: rw*/
    tmp_dir = debugfs_create_u32("hello", 00666, dir, &debugfs_hello);
    if (!tmp_dir) {
        printk(KERN_ALERT "debugfs_create_u32 failed\n");
        return -1;
    }

    /* create /sys/kernel/debug/debugfs_hello/add value, mode: w*/
    tmp_dir = debugfs_create_file("add", 0222, dir, NULL, &add_ops);
    if (!tmp_dir) {
        printk(KERN_ALERT "debugfs_create_file failed\n");
        return -1;
    }

    /* create /sys/kernel/debug/debugfs_hello/sum value, mode: r*/
    tmp_dir = debugfs_create_u32("sum", 0444, dir, &sum);
    if (!tmp_dir) {
        printk(KERN_ALERT "debugfs_create_u32 failed\n");
        return -1;
    }

    return 0;
}


static void __exit hello_exit(void)
{
    printk(KERN_INFO "Exit debugfs_hello module\n");
    debugfs_remove_recursive(dir);
    dir = NULL;
}

module_init(hello_init);
module_exit(hello_exit);

MODULE_LICENSE("GPL");

Demo TWO

#include <linux/debugfs.h>
#include <linux/module.h>
#include <linux/fs.h>
#include <linux/uaccess.h>
#include <linux/errno.h>
#include <linux/dcache.h>
#include <linux/types.h>

static char zen_buf[512] = "hello\n";
static struct dentry *zen_dir;


static int zen_open(struct inode *inode, struct file *filp)
{
    printk("zen open\n");
    filp->private_data = inode->i_private;
    return 0;
}

ssize_t zen_read(struct file *filp, char __user *buf, size_t count, loff_t *offp)
{
    int retval = 0;
    if ((*offp + count) > 512)
        count = 512 - *offp;

    printk("read request: count:%u, offset:%u\n", count, *offp);
    if (copy_to_user(buf, zen_buf+*offp, count)) {
        printk("copy to user failed, count:%ld\n", count);
        retval = -EFAULT;
        goto out;
    }
    *offp += count;
    retval = count;
out:
    return retval;
}

ssize_t zen_write(struct file *filp, const char __user *buff, size_t count, loff_t *offp)
{
    int retval;
    printk("write request: count:%u, offset:%u\n", count, *offp);
    if (*offp > 512)
        return 0;

    if (*offp + count > 512)
        count = 512 - *offp;

    if (copy_from_user(zen_buf+*offp, buff, count)) {
        printk("copy from user failed, count:%ld\n", count);
        retval = -EFAULT;
        goto out;
    }
    *offp += count;
    retval = count;
out:
    return retval;
}

struct file_operations my_fops = {
    .owner = THIS_MODULE,
    .read = zen_read,
    .write = zen_write,
    .open = zen_open,
};

static int __init debugfs_init(void)
{
    printk("INIT MODULE\n");
    zen_dir = debugfs_create_dir("zen_dir4", NULL);
    if (!zen_dir) {
        printk("zen_dir4 is null\n");
        goto fail;
    }
    static struct dentry *sub_zen_dir;
    sub_zen_dir = debugfs_create_dir("sub_zen", zen_dir);
    if (!sub_zen_dir) {
        printk("sub zen dir is null\n");
        goto fail;
    }

    struct dentry *filent = debugfs_create_file("zen", 0644, sub_zen_dir, NULL, &my_fops);
    if (!filent) {
        printk("zen file is null\n");
        goto fail;
    }
    printk("INIT SUCCESS\n");
    return 0;
fail:
//return -ENOENT;
    return -1;
}


static void __exit debugfs_exit(void)
{
    printk("exit module\n");
    debugfs_remove_recursive(zen_dir);
    printk("exit success\n");
}


module_init(debugfs_init);
module_exit(debugfs_exit);
MODULE_LICENSE("GPL");

4. 加载模块

编译完后生成的.ko文件，使用insmod加载进内核，即可在/sys/kernel/debug下看到生成目录及文件

原文地址：https://blog.csdn.net/Xinbaibaiya12138/article/details/143492547

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：Java中每个类都有个Class对象，那Class类有自己的Class对象吗？
下一篇：域名是互联网上用于标识网站或服务器的地址

为什么 Allow 配合 meta noindex 比使用Disallow好？
为什么 Allow 配合 meta noindex。
阅读更多2024-11-06
全面解析：虚拟化技术及其应用
虚拟化技术是指通过软件模拟硬件功能，将物理资源抽象成逻辑资源的技术。虚拟化可以应用于计算、存储和网络等多个方面。虚拟化技术作为一项革命性的技术，正在深刻改变我们的世界。它不仅为企业带来了前所未有的商业
阅读更多2024-11-06
机器学习与大数据处理有何关系
机器学习（Machine Learning, ML）是人工智能的一个分支领域，它专注于让计算机系统通过自动地从数据中学习并改进其性能，以执行特定任务，而无需进行显式的编程。机器学习的核心思想是使用数据
阅读更多2024-11-06
Garbage instead of arguments “bitrate
初步确认，出现上面打印信息是因为iproute2不支持CAN配置，但是OPENWRT里我找了很入久，也没找到iproute2的配置信息，iproute2不需要配置，只需要待批ip-full ip-ti
阅读更多2024-11-06
CICD学习笔记1
黑猫是代码托管平台如github，老头jinkens：自动构建：意思就是自动执行shell脚本（脚本是部署项目该有的流程：自动环境更新、代码下载、重启项目）、shell脚本再自动部署-->构建成
阅读更多2024-11-06
【google play】使用Java接入谷歌支付流程
使用Java接入谷歌支付的完整流程，包括准备工作以及具体的Java实现。
阅读更多2024-11-06
MFC的HTTP客户端
/读取服务器上数据。另外别忘了异常处理！
阅读更多2024-11-06
G2 基于生成对抗网络（GAN）人脸图像生成
生成器（G）：输入随机噪声，通过学习数据的分布模式生成类似真实图像的输出。判别器（D）：用来判断输入的图像是真实的还是生成器生成的。训练过程中，生成器尝试欺骗判别器，生成逼真的图像，而判别器则不断优化
阅读更多2024-11-06
OCR、语音识别与信息抽取：免费开源的AI平台在医疗领域的创新应用
思通数科的AI平台通过OCR技术自动识别手写病历中的患者信息、诊断结果、医生签字等要素，并将这些信息转换为结构化数据，直接上传至医院的电子病历系统。通过这些自动化流程，平台帮助医院构建了标准化的影像数
阅读更多2024-11-06
2024年三个月自学手册网络安全（黑客技术）
网络安全可以基于攻击和防御视角来分类，我们经常听到的 “红队”、“渗透测试” 等就是研究攻击技术，而“蓝队”、“安全运营”、“安全运维”则研究防御技术。走安全行业的工程方向的，技术上面其实有很大的重叠
阅读更多2024-11-06