HDLBits——Module

在 Linux 内核中，`THIS_MODULE` 是一个用于表示当前模块的宏，其定义位于 `<linux/module.h>` 中。它通常用于模块初始化和卸载时的注册与注销操作，提供了一个指向 `struct module` 的指针，表示当前正在运行的模块结构体。 在 SCSI 子系统中，`scsi_register_driver` 函数用于注册一个 SCSI 驱动程序。该函数需要传入一个 `struct scsi_driver` 类型的指针，并且在内部会调用 `driver_register` 来完成实际的驱动注册操作。在调用 `scsi_register_driver` 时，通常会使用 `THIS_MODULE` 作为参数之一，以确保驱动程序与模块生命周期同步。 例如，一个典型的 SCSI 驱动程序初始化函数可能如下所示： ```c static int __init my_scsi_driver_init(void) { return scsi_register_driver(&my_scsi_driver); } module_init(my_scsi_driver_init); ``` 其中，`scsi_register_driver` 内部实现可能类似于： ```c int scsi_register_driver(struct scsi_driver *sdrv) { sdrv->driver.owner = THIS_MODULE; return driver_register(&sdrv->driver); } ``` 通过将 `THIS_MODULE` 赋值给 `driver.owner`，确保了该驱动所属的模块不会在驱动被使用时被卸载[^1]。 在内核模块机制中，`THIS_MODULE` 的定义如下： ```c extern struct module __this_module; #define THIS_MODULE (&__this_module) ``` 每个模块在加载时都会有一个对应的 `struct module` 结构体，`THIS_MODULE` 提供了对该结构体的引用，用于模块的引用计数、符号导出、模块卸载同步等机制[^2]。 ### `THIS_MODULE` 的主要用途包括： - **模块引用计数**：当一个设备驱动程序被注册时，内核会增加该模块的引用计数，防止模块在被使用时被卸载。 - **符号导出**：模块中导出的符号（如函数、变量）需要与模块结构体关联，`THIS_MODULE` 用于标识这些符号属于哪个模块。 - **模块卸载同步**：在卸载模块时，内核会检查模块的引用计数，若仍有设备在使用该模块，则不允许卸载。 在 `scsi_register_driver` 中使用 `THIS_MODULE` 的目的正是为了确保 SCSI 驱动程序在其生命周期内始终与模块绑定，防止模块在驱动程序仍处于活动状态时被卸载，从而避免潜在的空指针访问或内存泄漏问题。 ### 示例代码：SCSI 驱动程序注册 ```c #include <linux/module.h> #include <scsi/scsi_driver.h> static struct scsi_driver my_scsi_drv = { .driver = { .name = "my_scsi_driver", .owner = THIS_MODULE, }, // 其他驱动操作函数 }; static int __init my_scsi_init(void) { return scsi_register_driver(&my_scsi_drv); } static void __exit my_scsi_exit(void) { scsi_unregister_driver(&my_scsi_drv); } module_init(my_scsi_init); module_exit(my_scsi_exit); MODULE_LICENSE("GPL"); MODULE_AUTHOR("Your Name"); MODULE_DESCRIPTION("A simple SCSI driver example"); ``` ### 总结 - `THIS_MODULE` 是当前模块的引用，用于模块注册、符号导出和引用计数管理。 - 在 `scsi_register_driver` 中使用 `THIS_MODULE` 可确保驱动程序与模块生命周期同步，防止模块在驱动程序仍在使用时被卸载。