Linux内核API __symbol_put

__symol_put函数功能描述:该函数的功能是根据给定的内核符号名symbol,找到其所在的内核模块,并将该模块的引用计数减1。

__symbol_put文件包含

#include <linux/module.h>

__symbol_put函数定义

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

函数定义格式:

void __symbol_put(const char *symbol)

__symbol_put输入参数说明

symbol:字符串常量,代表内核符号名。

__symbol_put返回参数说明

该函数无返回值。

__symbol_put实例解析

编写测试文件:__symbol_put.c

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

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

模块初始化函数:

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

    symbol_name = "symbol_A";
    mod_name = "test_module";             //定义待查找的模块名为“test_module”
    fmodule = find_module( mod_name );    //调用查找模块函数

    if(fmodule ! = NULL )
    {
        printk("before calling __symbol_put, \n");
        printk("ref of %s is: %d\n", mod_name, module_refcount(fmodule));
        __symbol_put(symbol_name);       //将会减少引用计数
        printk("after calling __symbol_put, \n");
        printk("ref of %s is: %d\n", mod_name, module_refcount(fmodule));
    }
    else
    {
        printk("find %s failed! \n", mod_name );
    }
    return 0;
}

模块退出函数:

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

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

module_init(__symbol_put_init);
module_exit(__symbol_put_exit);

实例运行结果及分析:

在实例程序中,为函数__symbol_put()传递的实参为“symbol_A”,它为一个内核符号名,首先查看虚拟文件系统proc中kallsyms文件中关于内核符号symbol_A的描述,命令及显示信息如图所示。
Linux内核API __symbol_put

从上图中可以看到内核符号symbol_A位于模块test_module内,该模块是笔者动态插入的。编译模块,执行命令insmod __symbol_put.ko插入模块,然后执行命令dmesg -c,会出现如图所示的结果。
Linux内核API __symbol_put

结果分析:

从上图显示的信息可以看出,在调用__symbol_put()函数之前,模块test_module的引用计数为7,将存在于该模块中的内核符号symbol_A作为实参传递给__symbol_put()函数之后,模块的引用计数变为6。说明函数__symbol_put()的功能是查找参数symbol所在的模块,并将该模块的引用计数减1。下图为删除模块之后,再次插入一次模块的结果,模块的引用计数从6变为5,再减1次。
Linux内核API __symbol_put

实例程序中用到了find_module()和module_refcount()函数,函数find_module()是根据模块名查找模块并返回查找到的模块,函数module_refcount()则是用来获得模块被引用的次数。

Camera课程

Python教程

Java教程

Web教程

数据库教程

图形图像教程

办公软件教程

Linux教程

计算机教程

大数据教程

开发工具教程