Linux内核API symbol_put_addr

symbol_put_addr函数功能描述:该函数的功能是根据给定的一个内存地址addr,找到该地址所在的模块后,将模块的引用计数减1。它与__symbol_put()函数有类似的功能,但二者的参数不一致。

symbol_put_addr文件包含

#include <linux/module.h>

symbol_put_addr函数定义

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

函数定义格式:

void symbol_put_addr(void *addr)

symbol_put_addr输入参数说明

addr:内存地址,通常指某一内核符号的内存地址。

symbol_put_addr返回参数说明

该函数无返回值。

symbol_put_addr实例解析

编写测试文件:symbol_put_addr.c

头文件及全局变量声明如下:

#include <linux/module.h>
#include <linux/init.h>
MODULE_LICENSE("GPL");
static int __init symbol_put_addr_init(void);
static void __exit symbol_put_addr_exit(void);

模块初始化函数:

int __init symbol_put_addr_init(void)
{
    const char * symbol_name ;
    const char * mod_name ;
    struct module * fmodule ;
    void * addr;

    symbol_name = "symbol_A";
    addr = __symbol_get( symbol_name );

    if( addr ! = NULL )
    {
        printk("addr : %lx \n", (unsigned long)addr );

        mod_name = "test_module";                 //定义待查找的模块名为“test_module”
        fmodule = find_module( mod_name );        //调用查找模块函数
        if(fmodule ! = NULL )
        {
            printk("before calling symbol_put_addr, \n");
            printk("refs of %s is: %d\n", mod_name, module_refcount(fmodule));
            symbol_put_addr( addr );              //will dec the count
            printk("after calling symbol_put_addr, \n");
            printk("refs of %s is: %d\n", mod_name, module_refcount(fmodule));
        }
        else
        {
                printk("find %s failed! \n", mod_name );
            }
        }
        else
        {
            printk("%s isn't found\n", symbol_name);
        }
        return 0;
    }

模块退出函数:

void __exit symbol_put_addr_exit(void)
{
    printk("module exit ok! \n");
}

模块初始化及退出函数调用:

module_init(symbol_put_addr_init);
module_exit(symbol_put_addr_exit);

实例运行结果及分析:

首先编译模块,执行命令insmod symbol_put_addr.ko插入模块,然后执行命令dmesg -c,会出现如图所示的结果。
Linux内核API symbol_put_addr

结果分析:

从上图显示的信息可以看出,模块插入之前模块test_module的引用计数为5,在插入模块之时调用了函数__symbol_get( ),所以在调用symbol_put_addr()函数之前,模块test_module的引用计数为6,将存在于该模块中的内核符号symbol_A的地址作为实参传递给symbol_put_addr()函数之后,模块的引用计数变为5。说明函数symbol_put_addr ( )的功能是查找内存地址addr所在的模块,并将该模块的引用计数减1。

实例程序中用到了内核函数__symbol_get()find_module()module_refcount(),函数__symbol_get()用来获取内核符号symbol_A的内存地址,该地址存在于test_module模块中;函数find_module( )根据模块名查找模块并返回查找到的模块;函数module_refcount()则是用来获得模块被引用的次数。

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

评论 抢沙发

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