Linux 驱动开发之内核模块开发（四）—— 符号表的导出

        Linux内核头文件提供了一个方便的方法用来管理符号的对模块外部的可见性,因此减少了命名空间的污染(命名空间的名称可能会与内核其他地方定义的名称冲突),并且适当信息隐藏。 如果你的模块需要输出符号给其他模块使用,应当使用下面的宏定义:

EXPORT_SYMBOL(name);

EXPORT_SYMBOL_GPL(name);   //只适用于包含GPL许可权的模块；

     这两个宏均用于将给定的符号导出到模块外. _GPL版本的宏定义只能使符号对GPL许可的模块可用。
**符号必须在模块文件的全局部分导出,不能在函数中导出,**这是因为上述这两个宏将被扩展成一个特殊用途的声明，而该变量必须是全局的。这个变量存储于模块的一个特殊的可执行部分(一个"ELF段" ),在装载时，内核通过这个段来寻找模块导出的变量(感兴趣的读者可以看<linux/module.h>获知更详细的信息)。

一、宏定义EXPORT_SYMBOL分析

1、源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
1<include/linux/moudule.h>

2

3…….

4

5#ifndef MODULE_SYMBOL_PREFIX

6#define MODULE_SYMBOL_PREFIX ""

7#endif

8

9…….

10

11struct kernel_symbol       //内核符号结构

12{

13       unsignedlong value;  //该符号在内存地址中的地址

14       constchar *name;     //该符号的名称

15

16};

17

18……

19

20#define __EXPORT_SYMBOL(sym,sec)                                 \

21       externtypeof(sym) sym;                                                        \

22       __CRC_SYMBOL(sym,sec)                                            \

23       staticconst char __kstrtab_##sym[]                                 \

24       __attribute__((section(“__ksymtab_strings”),aligned(1)))   \

25       =MODULE_SYMBOL_PREFIX#sym;                      \

26       staticconst struct kernel_symbol __ksymtab_##sym         \

27       __used                                                                          \

28       __attribute__((section(“__ksymatab”sec),unused))                   \

29       ={(unsignedlong)&sym,_kstrab_#sym} 

30

31#define    EXPORT_SYMBOL(sym)                   \

32              __EXPOTR_SYMBOL(sym,””)

33

34#define    EXPORT_SYMBOL_GPL(sym)           \

35              __EXPOTR_SYMBOL(sym,”_gpl”)

36

37#define    EXPORT_SYMBOL(sym)                   \

38              __EXPOTR_SYMBOL(sym,”_gpl_future”)

39

1
2
1 在分析前，先了解如下相关知识： 

2

1）#运算符，##运算符

     通常在宏定义中使用#来创建字符串 #abc就表示字符串”abc”等。

    ##运算符称为预处理器的粘合剂，用来替换粘合两个不同的符号，

如：#define xName (n)  x##n

则xName(4)  则变为x4

2）gcc的 attribute 属性：

     
attribute((section(“section_name”)))的作用是将指定的函数或变量放入到名为”section_name”的段中。

    __attribute__属性添加可以在函数或变量定义的时候直接加入在定义语句中。

如：

int myvar__attribute__((section("mydata"))) = 0;

表示定义了整形变量myvar=0;并且将该变量存放到名为”mydata”的section中

关于gcc_attribute详解可以参考：http://blog.sina.com.cn/s/blog_661314940100qujt.html

2、EXPORT_SYMBOL的作用是什么？

       EXPORT_SYMBOL标签内定义的函数或者符号对全部内核代码公开，不用修改内核代码就可以在您的内核模块中直接调用，即使用EXPORT_SYMBOL可以将一个函数以符号的方式导出给其他模块使用。

       这里要和System.map做一下对比：System.map 中的是连接时的函数地址。连接完成以后，在2.6内核运行过程中，是不知道哪个符号在哪个地址的。

       EXPORT_SYMBOL的符号，是把这些符号和对应的地址保存起来，在内核运行的过程中，可以找到这些符号对应的地址。而模块在加载过程中，其本质就是能动态连接到内核，如果在模块中引用了内核或其它模块的符号，就要EXPORT_SYMBOL这些符号，这样才能找到对应的地址连接。

二、 EXPORT_SYMBOL使用方法

第一、在模块函数定义之后使用EXPORT_SYMBOL（函数名）

第二、在调用该函数的模块中使用extern对之声明

第三、首先加载定义该函数的模块，再加载调用该函数的模块

要调用别的模块实现的函数接口和全局变量，就要导出符号 /usr/src/linux-headers-2.6.32-33-generic/Module.symvers

函数A先将show() 函数导出，函数B 使用extern 对其声明，要注意：

a — 编译a模块后，要将
Module.symvers 拷贝到b模块下

b — 然后才能编译b模块

c — 加载：先加载a模块，再加载b模块

d — 卸载：先卸载b模块，再卸载a模块

三、示例

代码a ,hello.c

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
1#include <linux/module.h>

2

3static int num =10;

4static void show(void)

5{

6   printk("show(),num = %d\n",num);

7}

8static int hello_init(void)

9{

10  printk("hello_init");

11  return 0;

12}

13static void hello_exit(void)

14{

15  printk("hello_exit \n");

16}

17EXPORT_SYMBOL(show);

18MODULE_LICENSE("GPL");

19module_init(hello_init);

20module_exit(hello_exit);

21

1
2
1 代码b show.c

2

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
1#include <linux/module.h>

2

3extern void show(void);

4

5static int show_init(void)

6{

7   printk("show_init");

8   show();

9   return 0;

10}

11static void show_exit(void)

12{

13  printk("show_exit \n");

14}

15

16MODULE_LICENSE("GPL");

17

18module_init(show_init);

19module_exit(show_exit);<strong>

20</strong>

21

1
2
1 编译后加载模块，卸载模块，可以用 

2

**dmesg ** 查看内核打印信息。