2.5 函数：__symbol_put()

文件包含：

---

#include <linux/module.h>

---

函数定义：

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

函数定义格式：void__symbol_put(const char*symbol)

函数功能描述：

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

输入参数说明：

symbol：字符串常量，代表内核符号名。

返回参数说明：

该函数无返回值。

实例解析：

编写测试文件：__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的描述，命令及显示信息如图2-9所示。

图2-9　内核符号symbol_A在kallsyms中的信息

从图2-9中可以看到内核符号symbol_A位于模块test_module内，该模块是笔者动态插入的，可以参考find_symbol()函数章节。编译模块，执行命令insmod__symbol_put.ko插入模块，然后执行命令dmesg-c，会出现如图2-10所示的结果。

图2-10　插入__symbol_put模块后系统输出信息

结果分析：

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

图2-11　再次插入__symbol_put模块后系统输出信息

实例程序中用到了find_module()和module_refcount()函数，函数find_module()是根据模块名查找模块并返回查找到的模块，函数module_refcount()则是用来获得模块被引用的次数。关于这两个函数的详细说明请参见本章中关于它们的分析。 nIzdJzlfWKoKq7B5m9DU12qvE1wztymiGadq3gflehEOfb5GWw5Ty2YkmDpow9dR