Linux内核API __print_symbol|极客笔记

__print_symbol函数功能描述：该函数的功能与sprint_symbol( )的函数功能是相似的，实际上，__print_symbol()函数的实现中调用了函数sprint_symbol( )。

该函数根据一个内存中的地址address查找一个内核符号，并将该符号的基本信息，例如符号名name、它在内核符号表中的偏移offset和大小size、所属的模块名（如果有的话）等信息以格式化串fmt的形式输出。而sprint_symbol( )函数则是将这些信息放到文本缓冲区buffer中。

__print_symbol文件包含

#include <linux/kallsyms.h>

__print_symbol函数定义

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

函数定义格式：

void __print_symbol(const char *fmt, unsigned long address)

__print_symbol输入参数说明

fmt：输出内核符号基本信息所依据的格式串，由于符号信息是连接成一个字符串的，因此fmt格式化串中一般包含一个“%s”。

address：内核符号中的某一地址，为输入型参数。

__print_symbol返回参数说明

该函数无返回值。

__print_symbol实例解析

编写测试文件：__print_symbol.c

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

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

// 符号a_symbol
int a_symbol(void)                          //此处void必须添加
{
    return 1;
}
EXPORT_SYMBOL(a_symbol);

模块初始化函数：

int __init __print_symbol_init(void)
{
    char ＊ fmt;                             //格式化字符串
    unsigned long address;                   //表示符号地址
    char ＊ name;                            //模块名字
    struct module ＊ fmodule = NULL;         //指向一个模块的指针

    address = (unsigned long) __builtin_return_address(0);     //当前函数的返回地址
    fmt = "it's the first part, \n %s";
    __print_symbol(fmt , address );
    printk("\n\n");

    name = "psmouse"; //可以通过命令lsmod查看当前内核模块，然后选择一个
    fmodule = find_module( name );       //查找模块名为“psmouse”的模块

    if( fmodule ! = NULL )
    {
        printk("fmodule->name: %s\n", fmodule->name);
        /* 将模块的内存起始地址赋值给address */
        address = (unsigned long)fmodule->module_core;
        fmt = "it's the second part, \n %s";
        __print_symbol(fmt , address );
    }
    printk("\n\n");

    /*将当前模块中符号a_symbol的地址加上偏移量 5 赋值给address*/
    address = (unsigned long)a_symbol + 5;
    fmt = "it's the third part, \n %s";
    __print_symbol(fmt , address );

    printk("\n\n");
    return 0;
}

模块退出函数：

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

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

module_init(__print_symbol_init);
module_exit(__print_symbol_exit);

实例运行结果及分析：

首先编译模块，执行命令insmod __print_symbol.ko插入模块，然后执行命令dmesg -c，会出现如图所示的结果。
Linux内核API __print_symbol

结果分析：

测试程序中调用了find_module()内核函数，它的功能是根据所给的模块名字来获得模块描述符指针的。

格式化串赋值如fmt = "it's the f irst part,\n%s"，其类似于C语言中的printf()函数的第一个参数。调用__print_symbol(fmt, address)，根据address查找特定符号的基本信息，先把信息存放到文本缓冲区buffer中，然后以格式化串fmt的形式输出。