Linux内核API module_refcount

module_refcount函数功能描述:该函数是用来获得模块的引用计数。每个模块的结构体描述符module中都有一个该模块被引用次数的计数字段,它或者是一个指针或者是一个local_t类型变量。关于结构体struct module,请参见find_module()函数的分析。

module_refcount文件包含

#include <linux/module.h>

module_refcount函数定义

在内核源码中的位置:linux-3.19.3/kernel/module.c

函数定义格式:

unsigned int module_refcount(struct module *mod)

module_refcount输入参数说明

mod:指向模块结构体的指针,结构体中包含模块的名称、状态、所属的模块链表等。

module_refcount返回参数说明

返回值是一个unsigned int类型的值,它表示模块被引用的次数。

module_refcount实例解析

编写测试文件: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,会出现如图所示的结果。
Linux内核API module_refcount

结果分析:

在该测试程序中,调用了find_module()内核函数,它的功能是根据所给的模块名字来获得模块描述符指针的。

首先给定了一个名为“test_module”的模块,然后调用find_module()来获得与它相对应的模块的结构体描述符,赋值给fmodule。输出fmodule->name恰为“test_module”,然后调用module_refcount( )得到该模块的引用计数为3。

这里也验证了当前模块THIS_MODULE的引用计数。从输出信息的第三、四行可知,当前模块的name为module_refcount,它的引用计数为1,因为该模块处于MODULE_STATE_COMING(正在被加载)状态。

分析中涉及枚举类型module_state,它定义了模块的三种状态,其具体定义见函数find_module()的分析。

赞(1)
未经允许不得转载:极客笔记 » Linux内核API module_refcount
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址