内核中 EXPORT_SYMBOL 标志分析

时间：2023-03-10 02:43:58
内核中 EXPORT_SYMBOL 标志分析

内核版本：Linux-4.19

1. EXPORT_SYMBOL 的作用:

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

EXPORT_SYMBOL(name);

EXPORT_SYMBOL_GPL(name);

这两个宏均用于给定的符号导出到模块外部。_GPL版本导出的符号只能被 GPL 许可证下的模块使用。

我们以 EXPORT_SYMBOL 为例。

2. EXPORT_SYMBOL 宏定义如下:

#define EXPORT_SYMBOL(sym)					\

	__EXPORT_SYMBOL(sym, "")

3. __EXPORT_SYMBOL 宏定义如下:

#include <generated/autoksyms.h>

#define __EXPORT_SYMBOL(sym, sec)				\

	__cond_export_sym(sym, sec, __is_defined(__KSYM_##sym))

#define __cond_export_sym(sym, sec, conf)			\

	___cond_export_sym(sym, sec, conf)

#define ___cond_export_sym(sym, sec, enabled)			\

	__cond_export_sym_##enabled(sym, sec)

#define __cond_export_sym_1(sym, sec) ___EXPORT_SYMBOL(sym, sec)

#define __cond_export_sym_0(sym, sec) /* nothing */

4. ___EXPORT_SYMBOL 宏定义如下:

/* For every exported symbol, place a struct in the __ksymtab section */

#define ___EXPORT_SYMBOL(sym, sec)					\

		extern typeof(sym) sym;						\

		__CRC_SYMBOL(sym, sec)						\

		static const char __kstrtab_##sym[]				\

		__attribute__((section("__ksymtab_strings"), used, aligned(1)))	\

		= #sym;								\

		__KSYMTAB_ENTRY(sym, sec)

5. __KSYMTAB_ENTRY 宏定义如下:

#define __KSYMTAB_ENTRY(sym, sec)					\

		static const struct kernel_symbol __ksymtab_##sym		\

		__attribute__((section("___ksymtab" sec "+" #sym), used))	\

		= { (unsigned long)&sym, __kstrtab_##sym }

struct kernel_symbol {

	unsigned long value;

	const char *name;

};

经过层层的宏展开,得到了最终的结果。

6. 分析总结：

在内核符号导出中。调用了EXPORT_SYMBOL(sym)，说的来说完成了以下操作：

    (1) 定义一个字符数组存放内核导出符号的名称。并放置到 “__ksymtab_strings” 的 section 中。

    (2) 定义一个内核符号结构用于存放导出符号的内存地址和名称，并放置到 “ "___ksymtab" sec "+" #sym ” 中。

相关文章