Linux驱动调试中的Debugfs的使用简介 (2012-03-31 14:14)

在调试linux驱动的时候，可以用debugfs来调试，debugfs类似字符设备驱动一样，甚至更简单，不需要主设备号次设备号等等，只需要实现一个file_operations，然后通过debugfs_create_file就可以在debugfs中建立一个文件结点，就像字符设备驱动那样，只需要对这个文件结点进行open就可以进行read、write、ioctl，等等操作，这些操作对应到我们在驱动里为debugfs准备的file_operations。

让内核支持DEBUGFS，使能宏CONFIG_DEBUG_FS，在内核配置中选中，一般是在Kernel hacking中：

在实际的使用中，举个例子来说明，在调试GPIO驱动的时候，我们可以通过debugfs来调试：

首先定义一个file_operations：

staticconst struct file_operations gpiolib_operations = {

.open = gpiolib_open,

.read = gpiolib_read,

.write = gpiolib_write,

.llseek = seq_lseek,

.release = single_release,

};

然后，建立一个debugfs文件结点：

(void)debugfs_create_file("gpio", S_IFREG | S_IRUGO,

NULL, NULL, &gpiolib_operations);

在实际的驱动中，建立debugfs文件结点一般在驱动初始化的时候。

根据我们的调试需要，实现读写操作，一般用得比较多的是read和write操作，所以在gpiolib_read和gpiolib_write里加入我们的调试代码。调用GPIO驱动的时候，我的想法是，给GPIO结点发一个读指令，那么就得传入的gpio号的状态，给GPIO结点发一个写指令，那么就根据传入的参数设置gpio的状态。于是，我只需要实现write函数：

[html] view plaincopy
  1. staticssize_t gpiolib_write(struct file *file, const char __user *buf,size_t size, loff_t *ppos)
  2. {
  3. charinfo[255];
  4. int port=0,value=0;
  5. memset(info,0, 255);
  6. copy_from_user(info,buf, size);
  7. printk("gpio:%s\n",info);
  8. if((info[0]>= '0') && (info[0] <= '9')){
  9. port= (info[0] - 48)*10;
  10. if((info[1]>= '0') && (info[1] <= '9')){
  11. port+= (info[1] - 48);
  12. if(info[2]== ' '){
  13. if(info[3] == 'w'){
  14. value = (info[4] =='0')?0:1;
  15. }
  16. }
  17. }
  18. }
  19. if(info[3]== 'r'){
  20. gpio_direction_input(port);
  21. printk("gpio%dstatus = %d\n", port, __gpio_get_value(port));
  22. }else if(info[3] == 'w'){
  23. printk("write%d to gpio%d\n", value, port);
  24. gpio_direction_output(port,value);
  25. __gpio_set_value(port,value);
  26. }
  27. return size;
  28. }

这段代码的意思，根据传入的参数info作相应的操作，info的格式是：

info[0]和info[1]分别代表gpio号的十位和个位；

info[2]必须为空格；

info[3]为读写性质，‘w'为写，'r'为读；

info[4]如果为写，那么它表示写的状态。

这样就可以在驱动加载之后，用shell命令echo来进行调试了。

例如gpio号为57的端口控制蜂鸣器，gpio号为37的端口连接按键，那么：

蜂鸣器发声：echo 57 w1 > gpio

蜂鸣器停止：echo 57 w0 > gpio

读取按键状态：echo 37 r > gpio

那么这个gpio文件结点在哪呢？

内核启动后会把debugfs文件系统挂载到/sys/kernel/debug目录下，我们的gpio文件结点就在这里。

如果没有找到，那么可以手动挂载mount-t debugfs none /mnt，这样就挂载到/mnt目录下了。

PS:

更为强大的调试选项：

CONFIG_GPIO_SYSFS   定义此宏后 会在/sys/class/gpio/下面到处gpio的设备文件 可以通过此设备文件对gpio进行控制与读取   
========================================================================================================================

Linux内核里的DebugFS

2011-01-17 23:52 by wwang, 4597 阅读, 5 评论, 收藏,编辑

DebugFS，顾名思义，是一种用于内核调试的虚拟文件系统，内核开发者通过debugfs和用户空间交换数据。类似的虚拟文件系统还有procfs和sysfs等，这几种虚拟文件系统都并不实际存储在硬盘上，而是Linux内核运行起来后才建立起来。

通常情况下，最常用的内核调试手段是printk。但printk并不是所有情况都好用，比如打印的数据可能过多，我们真正关心的数据在大量的输出里不是那么一目了然；或者我们在调试时可能需要修改某些内核变量，这种情况下printk就无能为力，而如果为了修改某个值重新编译内核或者驱动又过于低效，此时就需要一个临时的文件系统可以把我们需要关心的数据映射到用户空间。在过去，procfs可以实现这个目的，到了2.6时代，新引入的sysfs也同样可以实现，但不论是procfs或是sysfs，用它们来实现某些debug的需求，似乎偏离了它们创建的本意。比如procfs，其目的是反映进程的状态信息；而sysfs主要用于Linux设备模型。不论是procfs或是sysfs的接口应该保持相对稳定，因为用户态程序很可能会依赖它们。当然，如果我们只是临时借用procfs或者sysfs来作debug之用，在代码发布之前将相关调试代码删除也无不可。但如果相关的调试借口要在相当长的一段时间内存在于内核之中，就不太适合放在procfs和sysfs里了。故此，debugfs应运而生。

默认情况下，debugfs会被挂载在目录/sys/kernel/debug之下，如果您的发行版里没有自动挂载，可以用如下命令手动完成：

?
# mount -t debugfs none /your/debugfs/dir

Linux内核为debugfs提供了非常简洁的API，本文接下来将以一个实作为例来介绍，sample code可以从这里下载。

这个实作会在debugfs中建立如下的目录结构：

其中，a对应模块中的一个u8类型的变量，b和subdir下面的c都是对应模块里的一个字符数组，只是它们的实现方式不同。

在module_init里，我们首先要建立根目录mydebug：

[html] view plaincopy
  1. my_debugfs_root = debugfs_create_dir("mydebug", NULL);

第一个参数是目录的名称，第二个参数用来指定这个目录的上级目录，如果是NULL，则表示是放在debugfs的根目录里。

子目录也是用debugfs_create_dir来实现：

[html] view plaincopy
  1. sub_dir = debugfs_create_dir("subdir", my_debugfs_root);

建立文件a的代码非常简单：

[html] view plaincopy
  1. debugfs_create_u8("a", 0644, my_debugfs_root, &a);

这表示文件名为“a”，文件属性是0644，父目录是上面建立的“mydebug”，对应的变量是模块中的a。

Linux内核还提供了其他一些创建debugfs文件的API，请参考本文的附录。

b是一个32-bytes的字符数组，在debugfs里，数组可以用blob wrapper来实现。

[html] view plaincopy
  1. char hello[32] = "Hello world!\n";
  2. structdebugfs_blob_wrapper b;
  3. b.data = (void*)hello;
  4. b.size = strlen(hello) + 1;
  5. debugfs_create_blob("b", 0644, my_debugfs_root, &b);

这里需要注意的是，blob wrapper定义的数据只能是只读的。在本例中，虽然我们把文件b的权限设定为0644，但实际这个文件还是只读的，如果试图改写这个文件，系统将提示出错。

如果需要对内核数组进行写的动作，blob wrapper就无法满足要求，我们只能通过自己定义文件操作来实现。在这个实作里，可以参考文件c的实现。c和b在模块里对应着同一块字符数组，不同的是，b是只读的，而c通过自定义的文件操作同时实现了读和写。

[html] view plaincopy
  1. staticint c_open(structinode *inode, structfile *filp)
  2. {
  3. filp->private_data = inode->i_private;
  4. return0;
  5. }
  6. staticssize_t c_read(structfile *filp, char__user *buffer,
  7. size_tcount, loff_t *ppos)
  8. {
  9. if(*ppos >= 32)
  10. return0;
  11. if(*ppos + count > 32)
  12. count = 32 - *ppos;
  13. if(copy_to_user(buffer, hello + *ppos, count))
  14. return-EFAULT;
  15. *ppos += count;
  16. returncount;
  17. }
  18. staticssize_t c_write(structfile *filp, constchar __user *buffer,
  19. size_tcount, loff_t *ppos)
  20. {
  21. if(*ppos >= 32)
  22. return0;
  23. if(*ppos + count > 32)
  24. count = 32 - *ppos;
  25. if(copy_from_user(hello + *ppos, buffer, count))
  26. return-EFAULT;
  27. *ppos += count;
  28. returncount;
  29. }
  30. structfile_operations c_fops = {
  31. .owner = THIS_MODULE,
  32. .open = c_open,
  33. .read = c_read,
  34. .write = c_write,
  35. };
  36. debugfs_create_file("c", 0644, sub_dir, NULL, &c_fops);

注：代码里，c_open其实并没有任何用处，因为c_read和c_write直接引用了全局变量hello。这里，我们也可以换一种写法，在read/write函数里用filp->private_data来引用字符数组hello。

到这里，三个文件和子目录已经创建完毕。在module_exit中，我们要记得释放创建的数据。

[html] view plaincopy
  1. debugfs_remove_recursive(my_debugfs_root);

debugfs_remove_recursive可以帮我们逐步移除每个分配的dentry，如果您想一个一个手动的移除，也可以直接调用debugfs_remove。

附录：

创建和撤销目录及文件

[html] view plaincopy
  1. <span style="font-size:12px;">structdentry *debugfs_create_dir(constchar *name, structdentry *parent);
  2. structdentry *debugfs_create_file(constchar *name, mode_t mode,
  3. structdentry *parent, void*data,
  4. conststruct file_operations *fops);
  5. void debugfs_remove(struct dentry *dentry);
  6. void debugfs_remove_recursive(struct dentry *dentry);
  7. </span>

创建单值文件

[html] view plaincopy
  1. structdentry *debugfs_create_u8(constchar *name, mode_t mode, structdentry *parent, u8 *value);
  2. structdentry *debugfs_create_u16(constchar *name, mode_t mode,structdentry *parent, u16 *value);
  3. structdentry *debugfs_create_u32(constchar *name, mode_t mode,structdentry *parent, u32 *value);
  4. structdentry *debugfs_create_u64(constchar *name, mode_t mode, structdentry *parent, u64 *value);
  5. structdentry *debugfs_create_x8(constchar *name, mode_t mode,        structdentry *parent, u8 *value);
  6. structdentry *debugfs_create_x16(constchar *name, mode_t mode,        structdentry *parent, u16 *value);
  7. structdentry *debugfs_create_x32(constchar *name, mode_t mode,         structdentry *parent, u32 *value);
  8. structdentry *debugfs_create_size_t(constchar *name, mode_t mode,        structdentry *parent, size_t*value);
  9. structdentry *debugfs_create_bool(constchar *name, mode_t mode,         structdentry *parent, u32 *value);

其中，后缀为x8、x16、x32的这三个函数是指debugfs中的数据用十六进制表示。

创建BLOB文件

[html] view plaincopy
  1. structdebugfs_blob_wrapper {
  2. void*data;
  3. unsignedlong size;
  4. };
  5. structdentry *debugfs_create_blob(constchar *name, mode_t mode,
  6. structdentry *parent, structdebugfs_blob_wrapper *blob);

其它

[html] view plaincopy
  1. structdentry *debugfs_rename(structdentry *old_dir, structdentry *old_dentry,
  2. structdentry *new_dir, constchar *new_name);
  3. structdentry *debugfs_create_symlink(constchar *name,
  4. structdentry *parent, constchar *target);

====================================================================================================================================

以前都習慣用 printk 和 /proc 做輸入輸出的動作, 不過 debugfs 看起來是 User space 和 kernel space 交流更好的選擇.

先確認 Enable Kernel debugfs Function

Kernel hacking —>
-*- Debug Filesystem

先來個簡單的範例,
在你要 debug 的 modules 內, 加入 debugfs 的 include file

#include <linux/debugfs.h>

要將想要輸出的變數, 假設叫 pcie0_linked 輸出到 debugfs 上, 在 initial code 的地方加上
debugfs_create_u32("pcie0_linked", 0644, NULL, &pcie0_linked);

接下來就可以重開機了 load 新 kernel 了,

mount debugfs

$ mount -t debugfs debug /debugfs

或是寫在 /etc/fstab

debugfs /debugfs debugfs debug

這時就可以 ls /debugfs/ , 就會出現 pcie0_linked 的檔案.

[html] view plaincopy
  1. $ cat /debugfs/pcie0_linked
  2. 1
  3. $ echo 0 > /debugfs/pcie0_linked
  4. $ cat /debugfs/pcie0_linked
  5. 0

像是 procfs 一樣, debugfs 也有 create directory 的 function, 以便讓變數可以在目錄內
我們小小改一下上面的程式, 加上 create_dir 的功能

[html] view plaincopy
  1. struct dentry *pcie_dir;
  2. pcie_dir = debugfs_create_dir("pcie",NULL);
  3. if( pcie_dir != NULL ) {
  4. debugfs_create_u32("pcie0_linked", 0644, pcie_dir, &pcie0_linked);
  5. }

改了以上的輸出, 接下來就可以在 /debugfs 下, 看到多了一個 pcie 的目錄, 而 pcie0_linked 就在裡面.

如果想用 hex(16 進位), 可以改用 debugfs_create_x32.

proc file system 最棒的就是可以讀寫檔案了, 可以做更多的控制.
debugfs 也有一個 function 可以讓使用者做檔案讀寫, 這邊寫一個簡單的 sample.

多 include 一個 header

[html] view plaincopy
  1. #include <linux/seq_file.h>
  2. static int pcie_reg_open(struct seq_file *s, void *data)
  3. {
  4. seq_printf(s, "pcie0_link status : %s\n", pcie0_linked == 1 ? "Enable": "D
  5. return 0;
  6. }
  7. static int pcie_single_open(struct inode *inode, struct file *file)
  8. {
  9. return single_open(file, pcie_reg_open, inode->i_private);
  10. }
  11. static ssize_t pcie_debug_write(struct file *file,
  12. const char __user *userbuf,
  13. size_t count, loff_t *ppos)
  14. {
  15. char buf[20];
  16. if (copy_from_user(buf, userbuf, min(count, sizeof(buf))))
  17. return -EFAULT;
  18. printk("%s: %s \n",__FUNCTION__, buf);
  19. return count;
  20. }
  21. static const struct file_operations pcie_ios_fops = {
  22. .open = pcie_single_open,
  23. .read = seq_read,
  24. .write = pcie_debug_write,
  25. .llseek = seq_lseek,
  26. .release = single_release,
  27. };
  28. debugfs_create_file("file", 0644, pcie_dir, NULL, &pcie_ios_fops);

這樣

[html] view plaincopy
  1. $ cat /debugs/pcie/file 會顯示
  2. pcie0_link status : Enable
  3. 而
  4. $ echo "richliu" > /debugfs/pcie/file 會顯示
  5. pcie_debug_write: richliu
  6. $

最後要介紹的是比較特別的一種格式 blob, 這是可以傳 binary 到 user space 的格式, blob 的 struct 是

[html] view plaincopy
  1. struct debugfs_blob_wrapper {
  2. void *data;
  3. unsigned long size;
  4. };

在剛剛的 Code 加上

static struct debugfs_blob_wrapper blob; –> 最好放 global.
char data[100];
sprintf(data, "Data Pointer is : %08X \n", data);
blob.data = data;
blob.size = 100;
debugfs_create_blob("blob", S_IRUSR, pcie_dir, &blob);

在 Linux 下直接用 hexdump 去讀資料出來

$ hexdump /debugfs/pcie/blob -c
0000000 D a t a P o i n t e r i s
0000010 : C 4 0 5 C 1 6 0 \n \0 \0 \0 \0
0000020 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0
*
0000060

請記得 Blob 這個檔案是 Read Only, 只能傳出, 不能傳入…

參考:
Debugfs
Debugfs 中譯版(好像是從匪區抄過來的?)

Linux驱动调试中的Debugfs的使用简介 CONFIG_DEBUG_FS 的功能与配置相关推荐

  1. Linux驱动调试中的Debugfs的使用简介

    Linux驱动调试中的Debugfs的使用简介 (2012-03-31 14:14) 在调试linux驱动的时候,可以用debugfs来调试,debugfs类似字符设备驱动一样,甚至更简单,不需要主设 ...

  2. LINUX驱动模型中bus与platform_bus区别和异同

     LINUX驱动模型中bus与platform_bus区别和异同 首先要明确的是platform_bus是BUS的一个字集,也就是说platform_bus是BUS定义的一个总线类型.可以看到pl ...

  3. LCD驱动调试中部分常见问题的分析及解决办法

    点击打开链接http://www.52rd.com/Blog/Detail_RD.Blog_DamonKabo_30355.html 点击打开链接 http://blog.csdn.net/color ...

  4. 【引用】linux驱动开发中open 方法

    open 方法提供给驱动来做任何的初始化来准备后续的操作. 在大部分驱动中, open 应当进行下面的 工作: ●     检查设备特定的错误(例如设备没准备好, 或者类似的硬件错误 ●     如果 ...

  5. Linux驱动编程中EXPORT_SYMBOL（）介绍

    一.查看内核驱动代码你会发现很多的函数带有EXPORT_SYMBOL()宏定义. 二.那么EXPORT_SYMBOL的作用是什么?            EXPORT_SYMBOL标签内定义的函数或者 ...

  6. Linux驱动开发中与设备树相关的6种debug方法

    整理出了6种驱动开发时与设备注册.设备树相关的调试方法,彼此间没有优先级之分,每种方法不一定是最优解,但可以作为一种debug查找问题的手段,快速定位问题原因.例如在芯片验证时,不同时钟频率下系统启动 ...

  7. Linux驱动开发中的中间件：设备树

    Linux设备树 设备树的产生是为了解决内核源码的arch/arm目录下代码混乱和臃肿的问题(过去每个厂商出个板子就要提供外设硬件和平台硬件信息,这些信息以.c和.h文件的形式呈现).在使用设备树之后 ...

  8. linux驱动调试--段错误之oops信息分析

    原文地址 http://blog.chinaunix.net/xmlrpc.php?r=blog/article&uid=29401328&id=4923447 发生段错误原因就是访问 ...

  9. Linux驱动调试之修改系统时钟中断定位系统僵死问题

    目录 1 将驱动程序改错 2 调试 1 将驱动程序改错 我们在点灯的函数里面增加一个死循环, 编译完之后,加载,测试,发现系统卡死. 2 调试 我们的系统不管在做什么事情,系统时钟中断是永远都在进行的 ...

最新文章

  1. 一种更好的汇报性能测试结果的方法（译）
  2. struts实战--登陆拦截器
  3. LeetCode Valid Sudoku
  4. MFC+GDI+绘制出雷达余晖效果
  5. django使用mysql_设置Django以使用MySQL
  6. mysql数据库 二十一练习题 及答案 (mysql练习题)
  7. 归并python_python基本算法之实现归并排序(Merge sort)
  8. html5界面手机播放mp3
  9. Bsdiff差分算法讲解
  10. 大一入门oj题目——《三天以后》
  11. 网店系统选择的四大策略
  12. 用python画太阳花过程_有几个问题一直弄不出来求大神 python(python太阳花教程)
  13. 通过数据来源分析来寻找隐藏的恶意软件
  14. ubuntu14.04上安装Mist
  15. 使用谷歌Colab(Colaboratory)免费GPU训练自己的模型及谷歌网盘无限容量(Google drive)申请教程
  16. Java对象扁平化的操作
  17. 微信小程序文件云存储-上传下载删除功能
  18. 华硕笔记本系统重装之后需要输入用户名和计算机名称是怎么回事,华硕笔记本电脑重装系统【方法详解】...
  19. 7-1 sdut-Collection(Map)-1 读中国载人航天史，汇航天员数量，向航天员致敬
  20. 弘辽科技：一件代发什么商品最容易赚钱？怎么做优化？

热门文章

  1. Ubuntu14.04下安装wineqq国际版和卸载QQ
  2. 《漫画算法》源码整理-6
  3. Spring(二)——IoC
  4. Python和OpenCV环境配置
  5. 内部类调用相同属性同名时的调用细节
  6. VUE搭建手机商城心得
  7. 使用 Fluentd 和 ElasticSearch Stack 实现 Kubernetes 的集群 Logging
  8. XML Schema学习
  9. [老老实实学WCF] 第七篇 会话
  10. Repository模式（转载）