2.12 函数：symbol_put_addr( )
文件包含：
#include <linux/module.h>
函数定义：
在内核源码中的位置：linux-3.19.3/kernel/module.c
函数定义格式：void symbol_put_addr(void *addr)
函数功能描述：
该函数的功能是根据给定的一个内存地址addr，找到该地址所在的模块后，将模块的引用计数减1。它与__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，会出现如图2-22所示的结果。
图2-22 插入symbol_put_addr模块后系统输出信息
结果分析：
关于实例程序中内核符号symbol_A和模块test_module的相关信息，可参见图2-10。
从图2-22显示的信息可以看出，模块插入之前模块test_module的引用计数为5，在插入模块之时调用了函数__symbol_get( )，所以在调用symbol_put_addr( )函数之前，模块test_module的引用计数为6，将存在于该模块中的内核符号symbol_A的地址作为实参传递给symbol_put_addr( )函数之后，模块的引用计数变为5。说明函数symbol_put_addr ( )的功能是查找内存地址addr所在的模块，并将该模块的引用计数减1。
实例程序中用到了内核函数__symbol_get( )、f ind_module( )和module_refcount( )，函数__symbol_get( )用来获取内核符号symbol_A的内存地址，该地址存在于test_module模块中；函数f ind_module( )根据模块名查找模块并返回查找到的模块；函数module_refcount( )则是用来获得模块被引用的次数。关于这三个函数的详细说明可以参见本章中关于它们的分析。