Linux内核API find_symbol

find_symbol函数功能描述:函数find_symbol()通过给定的内核符号的名字name,以及bool型参数gplok、warn来查找内核符号,并返回描述该符号的结构体指针。如果内核符号存在于动态插入的模块且参数owner不为空,则指针owner指向该模块。

find_symbol文件包含

#include <linux/module.h>

find_symbol函数定义

在内核源码中的位置: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)

find_symbol输入参数说明

  • name:字符串常量,表示待查找的内核符号的名字,是一个输入型参数。
  • owner:二级指针,指向所查找的内核符号所属的内核模块的指针,是一个输出型参数,它可以为空。关于结构体module的定义请参见前面关于内核函数find_module()的分析。
  • crc:二级指针,*crc表示内核符号的crc值所在的地址,它是一个输出型参数。
  • gplok:bool型变量,如果为真,表示内核符号所属的模块支持GPL许可,如果为假,则不支持。它是一个输入型参数。
  • warn:bool型变量,表示是否输出警告信息。它是一个输入型参数。

find_symbol返回参数说明

如果函数find_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;
};

find_symbol实例解析

编写测试文件:find_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,会出现如图所示的结果。
Linux内核API find_symbol

结果分析:

在该测试程序中,调用find_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的相关信息,如图所示。
Linux内核API find_symbol

虚拟文件系统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,显示信息如图所示。
Linux内核API find_symbol

上图中第三列均为test_module.ko文件中的内核符号,第一列为相应的地址,第二列为内核符号的属性,r表示只读,A表示在内存中的地址是绝对的,D表示内核符号在数据区初始化,T表示全局,t表示局部,U表示符号未定义。

从图中可以看出symbol_1并未显示出来,因为它被定义为static类型,symbol_2和symbol_3为全局数据对象,另外可以看到symbol_3在模块的字符串表和符号表中,即存在__ksymtab_symbol_3、__kstrtab_symbol_3、__crc_symbol_3,而symbol_2则没有,这是因为它没有通过export导出。通过export导出的符号在模块的字符串表和符号表中有相应的入口地址,可以方便地被其他模块加载。

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

评论 抢沙发

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