export_symbol详解

发布时间:2023-05-17

一、export_symbol概述

EXPORT_SYMBOL(symbol_name);
EXPORT_SYMBOL_GPL(symbol_name);

在Linux内核中,驱动程序和内核的其他部分之间是通过叫做symbol(符号)的接口来通信的,一个symbol可以是一个函数、一个全局变量或其他对象等等。默认情况下,这些symbol只能在内核中使用,因此,它们不会被其他程序访问。如果想要将symbol导出给外部模块使用,可以使用EXPORT_SYMBOLEXPORT_SYMBOL_GPL宏来实现。 EXPORT_SYMBOLEXPORT_SYMBOL_GPL的区别在于,EXPORT_SYMBOL_GPL只导出给使用了GPL或可以互操作的许可证的模块使用。由于这些许可证限制了使用这些符号的模块的范围,因此EXPORT_SYMBOL_GPL被认为比EXPORT_SYMBOL更加安全。

二、export_symbol的使用

在驱动程序中,通常的做法是使用EXPORT_SYMBOLEXPORT_SYMBOL_GPL来导出一些公共的接口或者符号,以便其他的模块或者驱动程序可以访问这些接口。通常在头文件中定义这些符号,并在C文件中实现这些符号的功能。下面是一个简单示例:

kernel_module.h

#ifndef __KERNEL_MODULE_H__
#define __KERNEL_MODULE_H__
void hello_world(void);
#endif /* __KERNEL_MODULE_H__ */

kernel_module.c

#include "kernel_module.h"
void hello_world(void)
{
    printk(KERN_ALERT "Hello world!\n");
}
EXPORT_SYMBOL_GPL(hello_world);

在这个例子中,我们定义了一个简单的hello_world函数,并将其导出给其他的模块使用。我们使用了EXPORT_SYMBOL_GPL宏使这个函数只能被使用了GPL或可以互操作的许可证的模块调用。

三、export_symbol的注意事项

在使用export_symbol时,需要注意以下几点:

1.导出符号需要用于编译到内核中的代码

export_symbol只对编译到内核中的符号起作用。如果将模块编译成为动态模块,则导出符号的宏不起作用。

2.导出符号的名字是全局的

导出符号的名字是全局的,可能会与其他符号发生冲突。为了避免冲突,可以使用一些命名约定来避免这种情况,例如添加前缀或后缀到导出的符号名字中。

3.使用EXPORT_SYMBOL_GPL时需要遵循GPL或者可以互操作的许可证

使用EXPORT_SYMBOL_GPL时,必须使用GPL或者可以和GPL互操作的许可证。对于商业闭源产品来说,使用EXPORT_SYMBOL_GPL可能会使其不能使用内核中的一些功能,因为这些功能使用了GPL许可证。

四、小结

export_symbol是内核中用来导出符号的一种机制,可以将这些符号作为接口供其他模块或者驱动程序调用。在使用export_symbol时需要注意导出符号的名字是全局的,使用EXPORT_SYMBOL_GPL时需要遵循GPL或者可以互操作的许可证。使用export_symbol时需要注意导出符号需要用于编译到内核中的代码。