export_symbol详解

SMYQ • 2024-11-01 14:10 • 编程

一、export_symbol概述

EXPORT_SYMBOL(symbol_name);
EXPORT_SYMBOL_GPL(symbol_name);

在Linux内核中，驱动程序和内核的其他部分之间是通过叫做symbol(符号)的接口来通信的，一个symbol可以是一个函数、一个全局变量或其他对象等等。默认情况下，这些symbol只能在内核中使用，因此，它们不会被其他程序访问。如果想要将symbol导出给外部模块使用，可以使用EXPORT_SYMBOL和EXPORT_SYMBOL_GPL宏来实现。

EXPORT_SYMBOL和EXPORT_SYMBOL_GPL的区别在于，EXPORT_SYMBOL_GPL只导出给使用了GPL或可以互操作的许可证的模块使用。由于这些许可证限制了使用这些符号的模块的范围，因此EXPORT_SYMBOL_GPL被认为比EXPORT_SYMBOL更加安全。

二、export_symbol的使用

在驱动程序中，通常的做法是使用EXPORT_SYMBOL或EXPORT_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时需要注意导出符号需要用于编译到内核中的代码。

原创文章，作者：SMYQ，如若转载，请注明出处：https://www.506064.com/n/147599.html