一、class_create
函数功能
宏class_create()用于动态创建设备的逻辑类,并完成部分字段的初始化,然后将其添加进Linux内核系统中。此函数的执行效果就是在/sys/class/目录下创建一个新的文件夹,此文件夹的名字为此函数的第二个输入参数,但此文件夹是空的。宏class_create()在实现时,调用了函数__class_create()。
函数实现
<内核源码路径>/include/linux/device.h中:
#define class_create(owner, name) \
({ \
static struct lock_class_key __key; \
__class_create(owner, name, &__key); \
})
参数说明
- owner:一个struct module结构体类型的指针,指向函数__class_create()即将创建的、“拥有”这个struct class的模块。一般赋值为THIS_MODULE,此结构体的详细定义见文件include/linux/module.h。
- name:char类型的指针,代表即将创建的struct class变量的名字,用于给struct class的name字段赋值。通俗地说,就是指向struct class名称的字符串的指针。
返回值
与函数__class_create()的返回值相同,都代表新创建的逻辑类。
二、class_destroy
函数功能
函数class_destroy()用于删除设备的逻辑类,即从Linux内核系统中删除设备的逻辑类。此函数执行的效果是删除函数__class_create()或宏class_create()在/sys/class/目录下创建的逻辑类对应的文件夹。
函数声明与实现
函数声明
<内核源码路径>/include/linux/device.h中:
extern void class_destroy(struct class *cls);
函数实现
<内核源码路径>/drivers/base/class.c中:
/**
* class_destroy - destroys a struct class structure
* @cls: pointer to the struct class that is to be destroyed
*
* Note, the pointer to be destroyed must have been created with a call
* to class_create().
*/
void class_destroy(struct class *cls)
{
if ((cls == NULL) || (IS_ERR(cls)))
return;
class_unregister(cls);
}
参数说明
- cls:struct class结构体类型的变量,代表通过class_create创建的设备的逻辑类。
返回值
无。
综合说明
开始写Linux设备驱动程序的时候,很多时候都是利用mknod命令手动创建设备节点(包括ldd3中不少例子也是这样)。实际上现在Linux内核已经为我们提供了一组函数,可以用来在模块加载的时候自动在/dev目录下创建相应设备节点,并在卸载模块时删除该节点。 内核中定义了struct class结构体,顾名思义,一个struct class结构体类型变量对应一个类,内核同时提供了class_create(…)函数,可以用它来创建一个类,这个类存放于sysfs下面,一旦创建 好了这个类,再调用device_create(…)函数来在/dev目录下创建相应的设备节点。这样,加载模块的时候,用户空间中的udev会自动响应 device_create(…)函数,去/sysfs下寻找对应的类从而创建设备节点。
注意事项
(1)class_create宏需要与函数class_destroy()配对使用,不能单独使用。当单独使用时,第一次不会出现错误,但当第二次插入模块时就会出现错误。
(2)class_create创建一个逻辑类后,还需在这个类下面创建设备,不然的话这个类没什么用。
参考链接
(1)??????Linux内核API class_create|极客笔记
(2)004_linux驱动之_class_create创建一个设备类 - 陆小果哥哥 - 博客园
(3)class_create(),device_create()使用?
|