Linux内核模块开发入门与实践指南
Linux内核模块开发完全指南
1. 内核模块基础概念
1.1 什么是内核模块
内核模块是Linux内核的可动态加载组件，允许在不重新编译整个内核的情况下扩展系统功能。模块以.ko（Kernel Object）文件形式存在，可以在运行时加载和卸载。
1.2 模块与静态编译的区别
与直接编译进内核的代码相比，模块具有以下特点：
- 动态加载/卸载，减少内核内存占用
- 开发调试周期短，无需重启系统
- 功能隔离，单个模块崩溃不会导致整个系统崩溃
2. 最简单的内核模块实现
2.1 基本代码结构
一个最简单的内核模块包含以下必要元素：
#include <linux/init.h> #include <linux/kernel.h> #include <linux/module.h> static int __init my_init(void) { printk("my_init\n"); return 0; } static void __exit my_exit(void) { printk("my_exit\n"); } module_init(my_init); module_exit(my_exit);2.2 关键组件解析
头文件：
<linux/module.h>：包含模块编程的基本宏和函数<linux/kernel.h>：提供printk等内核函数<linux/init.h>：定义模块初始化和退出相关宏
初始化函数：
- 使用
__init宏标记，表示该函数仅在初始化时使用 - 必须返回int类型，0表示成功
- 使用
退出函数：
- 使用
__exit宏标记，表示该函数仅在模块卸载时使用
- 使用
模块声明：
module_init()指定模块加载时调用的函数module_exit()指定模块卸载时调用的函数
3. 模块编译与加载
3.1 Makefile编写
典型的内核模块Makefile示例：
obj-m := hello.o KDIR := /lib/modules/$(shell uname -r)/build PWD := $(shell pwd) all: make -C $(KDIR) M=$(PWD) modules clean: make -C $(KDIR) M=$(PWD) clean3.2 多文件模块编译
当模块由多个源文件组成时，Makefile需要特殊处理：
obj-m := hello_world.o hello_world-objs := hello.o world.o4. 模块操作命令
4.1 模块加载
insmod：
# insmod drv.ko- 直接加载指定路径的.ko文件
- 不处理依赖关系
modprobe：
# depmod # modprobe drv- 自动处理模块依赖
- 从标准模块目录查找模块
4.2 模块卸载
# rmmod drv- 卸载已加载的模块
- 如果模块正在使用，会返回EBUSY错误
4.3 模块信息查看
# modinfo drv输出示例：
filename: /lib/modules/3.13.0-32-generic/drv.ko srcversion: 533BB7E5866E52F63B9ACCB depends: vermagic: 3.13.0-32-generic SMP mod_unload modversions 6865. 内核打印与调试
5.1 printk函数
内核空间使用printk代替用户空间的printf：
printk(KERN_INFO "Debug message: %d\n", value);注意事项：
- 不支持浮点数打印
- 消息级别通过KERN_*宏指定
- 输出到内核环形缓冲区，可通过dmesg查看
5.2 常见打印问题
尝试打印浮点数会导致链接错误：
WARNING: '__extendsfdf2' undefined! WARNING: '__truncdfsf2' undefined!6. 模块参数传递
6.1 参数类型支持
内核模块支持以下参数类型：
- bool/invbool：布尔值
- charp：字符串指针
- 整型：short/int/long及其无符号版本
- 数组：上述类型的数组
6.2 参数定义示例
static int baudrate = 9600; static int port[4] = {0, 1, 2, 3}; static char *name = "user"; module_param(baudrate, int, S_IRUGO); module_param_array(port, int, NULL, S_IRUGO); module_param(name, charp, S_IRUGO);6.3 参数传递方式
加载时指定参数：
# insmod user.ko baudrate=115200 port=1,2,3,4 name='virtual-serial'7. 内核模块开发注意事项
7.1 内核污染（Tainting）
加载模块时可能出现警告：
loading out-of-tree module taints kernel可能原因：
- 模块未声明GPL协议
- 内核版本不匹配
- 使用树外模块
7.2 C库限制
内核模块不能使用标准C库函数，因为：
- 内核运行在比C库更低级别
- 内核实现了自己的基础函数版本
- 内存管理方式与用户空间不同
替代方案：
- kmalloc代替malloc
- printk代替printf
- 内核提供的字符串操作函数
8. 高级模块开发技巧
8.1 初始化调用顺序
内核提供多种初始化级别：
core_initcall：核心子系统初始化postcore_initcall：核心初始化之后arch_initcall：架构特定初始化subsys_initcall：子系统初始化fs_initcall：文件系统初始化device_initcall：设备驱动初始化late_initcall：最后阶段的初始化
8.2 符号导出
允许其他模块使用本模块的函数/变量：
EXPORT_SYMBOL(my_function); EXPORT_SYMBOL_GPL(my_function); // 仅GPL模块可用8.3 版本控制
确保模块与内核版本兼容：
MODULE_LICENSE("GPL"); MODULE_AUTHOR("Your Name"); MODULE_DESCRIPTION("Module description"); MODULE_VERSION("1.0");