2.7 函数：find_symbol( )
文件包含：
#include <linux/module.h>
函数定义：
在内核源码中的位置：linux-3.19.3/kernel/module.c
函数定义格式：const struct kernel_symbol *f ind_symbol(const char *name，
struct module **owner，
const unsigned long **crc，
bool gplok，
bool warn)
函数功能描述：
函数f ind_symbol( )通过给定的内核符号的名字name，以及bool型参数gplok、warn来查找内核符号，并返回描述该符号的结构体指针。如果内核符号存在于动态插入的模块且参数owner不为空，则指针owner指向该模块。
输入参数说明：
name：字符串常量，表示待查找的内核符号的名字，是一个输入型参数。
owner：二级指针，指向所查找的内核符号所属的内核模块的指针，是一个输出型参数，它可以为空。关于结构体module的定义请参见本章关于内核函数f ind_module( )的分析。
crc：二级指针，*crc表示内核符号的crc值所在的地址，它是一个输出型参数。
gplok:bool型变量，如果为真，表示内核符号所属的模块支持GPL许可，如果为假，则不支持。它是一个输入型参数。
warn:bool型变量，表示是否输出警告信息。它是一个输入型参数。
返回参数说明：
如果函数f ind_symbol( )查找内核符号成功，则返回值是kernel_symbol结构体类型的指针，它是对所查找到的内核符号的描述，如果查找失败，则返回NULL。
其中内核符号结构体kernel_symbol在内核文件linux-3.19.3/include/linux/export.h中定义：
struct kernel_symbol
{
/＊value：如果EXPORT_SYMBOL(fun)，则value为符号fun在内核映像中的地址＊/
unsigned long value;
/＊name：指向符号名fun的指针＊/
const char ＊name;
};
实例解析：
编写测试文件：f ind_symbol.c
头文件及全局变量声明如下：
#include <linux/module.h>
#include <linux/init.h>
MODULE_LICENSE("GPL");
static int __init find_symbol_init(void);
static void __exit find_symbol_exit(void);
模块初始化函数：
int __init find_symbol_init(void)
{
const char ＊ name = "symbol_A"; //待查找的内核符号的名字
struct kernel_symbol ＊ ksymbol ; //用于接收测试函数返回值
struct module ＊ owner; //内核符号所属的模块
const unsigned long ＊crc;
bool gplok = true; //模块支持GPL许可
bool warn = true; //允许输出警告信息
ksymbol = find_symbol(name, &owner, &crc, gplok, warn); //调用待测试函数
if( ksymbol ! = NULL )
{
/＊输出查找到的内核符号在内存中的地址＊/
printk("ksymbol->value : %lx\n", ksymbol->value);
printk("ksymbol->name : %s\n", ksymbol->name); //输出内核符号名字
}
else
printk("Failed to find symbol %s\n", name);
if( owner ! = NULL )
{
/＊输出内核符号所属的模块的名字＊/
printk("owner->name : %s\n", owner->name);
}
if( crc ! = NULL )
{
/＊ 输出内核符号的crc值所在的地址＊/
printk("＊crc : %lx\n", ＊crc);
}
return 0;
}
模块退出函数：
void __exit find_symbol_exit(void)
{
printk("module exit ok! \n");
}
模块初始化及退出函数调用：
module_init(find_symbol_init);
module_exit(find_symbol_exit);
实例运行结果及分析：
首先编译模块，执行命令insmod f ind_symbol.ko插入模块，然后执行命令dmesg -c，会出现如图2-14所示的结果。
图2-14 插入f ind_symbol模块后系统输出信息
结果分析：
在该测试程序中，调用f ind_symbol( )内核函数查找名字为“symbol_A”的内核符号，然后输出该符号的相关信息，如内存地址、所属模块名等。
由kernel_symbol类型的结构体指针ksymbol接收函数返回值，通过输出ksymbol->value可知内核符号“symbol_A”的内存地址为0xffffffffa0311000，输出ksymbol->name为“symbol_A”说明与传入的内核符号名相同。owner为内核符号所属的模块，由owner->name得知模块名为“test_module”。最后输出*crc为0x26b316c0。
为了验证上述结果的正确性，在终端通过命令cat /proc/kallsyms | grep symbol_A显示内核符号symbol_A的相关信息，如图2-15所示。
图2-15 内核符号symbol_A的相关信息显示
虚拟文件系统proc中的kallsym文件列出了所有内核符号的相关信息，它是在内核启动时将内核符号添加到kallsym符号表中的。动态插入的模块中所包含的符号也会动态加载到该kallsyms符号表中。
关于内核符号的说明：
现在通过一个实例文件test_module.c说明内核符号的导出，该文件的代码如下：
#include <linux/module.h>
#include <linux/init.h>
MODULE_LICENSE("GPL");
static int __init test_module_init(void);
static void __exit test_module_exit(void);
int symbol_A(void)
{
return 1;
}
EXPORT_SYMBOL(symbol_A);
int symbol_B(void)
{
return 0;
}
EXPORT_SYMBOL(symbol_B);
static int symbol_1 = 1;
int symbol_2 = 2;
int symbol_3 = 3;
EXPORT_SYMBOL(symbol_3);
int __init test_module_init(void)
{
printk("<0>hello world");
return 0;
}
void __exit test_module_exit(void)
{
printk("<0>module exit ok! \n");
}
module_init(test_module_init);
module_exit(test_module_exit);
编译模块，生成test_module.ko文件，对该文件执行nm命令即nm -l test_module.ko，显示信息如图2-16所示。
图2-16 nm命令显示模块test_module包含的部分信息
图2-16中第三列均为test_module.ko文件中的内核符号，第一列为相应的地址，第二列为内核符号的属性，r表示只读，A表示在内存中的地址是绝对的，D表示内核符号在数据区初始化，T表示全局，t表示局部，U表示符号未定义。
从图2-16中可以看出symbol_1并未显示出来，因为它被定义为static类型，symbol_2和symbol_3为全局数据对象，另外可以看到symbol_3在模块的字符串表和符号表中，即存在__ksymtab_symbol_3、__kstrtab_symbol_3、__crc_symbol_3，而symbol_2则没有，这是因为它没有通过export导出。通过export导出的符号在模块的字符串表和符号表中有相应的入口地址，可以方便地被其他模块加载。