Linux内核API之class_create与class_destroy

一、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()使用