2.10 函数：module_refcount( )
文件包含：
#include <linux/module.h>
函数定义：
在内核源码中的位置：linux-3.19.3/kernel/module.c
函数定义格式：unsigned int module_refcount(struct module *mod)
函数功能描述：
该函数是用来获得模块的引用计数。每个模块的结构体描述符module中都有一个该模块被引用次数的计数字段，它或者是一个指针或者是一个local_t类型变量。关于结构体struct module，请参见本章中f ind_module( )函数的分析。
输入参数说明：
mod：指向模块结构体的指针，结构体中包含模块的名称、状态、所属的模块链表等。
返回参数说明：
返回值是一个unsigned int类型的值，它表示模块被引用的次数。
实例解析：
编写测试文件：module_refcount.c
头文件及全局变量声明如下：
#include <linux/module.h>
#include <linux/init.h>
MODULE_LICENSE("GPL");
static int __init module_refcount_init(void);
static void __exit module_refcount _exit(void);
模块初始化函数：
int __init module_refcount _init(void)
{
const char ＊name = "test_module"; //字符串常量，表示一个模块名字
/＊ 查找名为name的模块 ＊/
struct module ＊ fmodule = find_module( name );
/＊ 输出名为name的模块的信息 ＊/
if( fmodule ! = NULL )
{
printk("fmodule->name: %s\n", fmodule->name);
printk("module_refcount(fmodule): %d\n", module_refcount(fmodule));
}
/＊ 输出当前模块的信息 ＊/
printk("THIS_MODULE->name: %s\n", THIS_MODULE->name);
printk("module_refcount(THIS_MODULE): %d\n", module_refcount(THIS_MODULE));
return 0;
}
模块退出函数：
void __exit module_refcount _exit(void)
{
printk("module exit ok! \n");
}
模块初始化及退出函数调用：
module_init(module_refcount _init);
module_exit(module_refcount _exit);
实例运行结果及分析：
首先编译模块，执行命令insmod module_refcount.ko插入模块，然后执行命令dmesg -c，会出现如图2-20所示的结果。
图2-20 插入module_refcount模块后系统输出信息
结果分析：
在该测试程序中，调用了f ind_module( )内核函数，它的功能是根据所给的模块名字来获得模块描述符指针的，关于其详细说明见本章中该函数的分析。
首先给定了一个名为“test_module”的模块，然后调用f ind_module( )来获得与它相对应的模块的结构体描述符，赋值给fmodule。输出fmodule->name恰为“test_module”，然后调用module_refcount( )得到该模块的引用计数为3。
这里也验证了当前模块THIS_MODULE的引用计数。从输出信息的第三、四行可知，当前模块的name为module_refcount，它的引用计数为1，因为该模块处于MODULE_STATE_COMING（正在被加载）状态。
分析中涉及枚举类型module_state，它定义了模块的三种状态，其具体定义见本章中关于函数f ind_module( )的分析。