第一个内核模块：编写Hello World模块、模块加载/卸载、printk日志级别、模块参数传递

内核模块是Linux驱动开发的基本载体，它允许我们在不重新编译整个内核的情况下，动态地向内核添加功能。对于初学者而言，编写一个Hello World模块是理解内核模块生命周期、编译机制、日志输出以及参数传递的最佳起点。本章将围绕一个完整的Hello World模块，深入剖析模块的加载与卸载流程、printk日志级别的控制方法，以及模块参数的传递机制，帮助读者建立内核模块开发的基础框架。

3.1 内核模块的核心原理与文件结构

内核模块（Loadable Kernel Module，LKM）是一种可以在运行时动态加载到内核地址空间的代码片段。与用户态程序不同，内核模块没有main()函数入口，而是通过两个关键宏来声明生命周期回调：module_init()指定模块加载时执行的初始化函数，module_exit()指定模块卸载时执行的清理函数。这两个宏在<linux/module.h>中定义，编译器会将它们重定向到特定的ELF段，使得内核在加载和卸载模块时能够准确定位并调用对应的处理函数。

一个标准的内核模块文件通常包含以下组成部分：头文件引用、模块描述信息（MODULE_LICENSE、MODULE_AUTHOR、MODULE_DESCRIPTION）、参数声明、初始化函数、退出函数以及module_init/module_exit的注册。其中MODULE_LICENSE是必须声明的，如果缺失或声明为非GPL兼容许可证，内核会打印"kernel taint"警告，影响模块的可用性。

3.2 编写Hello World模块与Makefile

下面我们编写一个完整的Hello World模块，并加入模块参数功能，以便演示参数传递机制。首先创建hello.c源文件：

#include <linux/init.h>
#include <linux/module.h>
#include <linux/kernel.h>

static int count = 1;
static char *who = "world";

module_param(count, int, 0644);
module_param(who, charp, 0644);
MODULE_PARM_DESC(count, "打印次数，默认1次");
MODULE_PARM_DESC(who, "问候对象，默认world");

static int __init hello_init(void)
{
    int i;
    for (i = 0; i < count; i++) {
        printk(KERN_INFO "Hello, %s! (第%d次)\n", who, i + 1);
    }
    printk(KERN_DEBUG "hello_init: 模块加载成功\n");
    return 0;
}

static void __exit hello_exit(void)
{
    printk(KERN_INFO "Goodbye, %s! 模块已卸载\n", who);
}

module_init(hello_init);
module_exit(hello_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Kernel Course");
MODULE_DESCRIPTION("Hello World 内核模块示例");
MODULE_VERSION("1.0");

对应的Makefile文件如下，它利用内核构建系统（Kbuild）来编译模块：

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) clean

执行make命令后，会生成hello.ko文件，这就是可加载的内核模块二进制。使用file hello.ko可以查看其ELF格式，确认是64位内核模块。

3.3 模块加载/卸载操作与printk日志级别

模块的加载使用insmod命令，卸载使用rmmod命令。加载时，内核会执行module_init注册的函数；卸载时执行module_exit注册的函数。操作流程如下：

# 加载模块（不传参数，使用默认值）
sudo insmod hello.ko

# 查看内核日志
dmesg | tail -20

# 加载模块并传递参数
sudo insmod hello.ko count=3 who="kernel"

# 查看模块信息
modinfo hello.ko

# 卸载模块
sudo rmmod hello

printk是内核态的日志输出函数，其原型为printk(const char *fmt, ...)。与用户态的printf不同，printk通过日志级别（loglevel）来控制消息的显示优先级。日志级别定义在<linux/kern_levels.h>中，常用的级别如下：

内核通过/proc/sys/kernel/printk文件控制日志的显示阈值，该文件包含4个数值：控制台日志级别、默认消息日志级别、最小控制台日志级别、默认控制台日志级别。当printk的日志级别数值小于控制台日志级别时，消息才会显示在控制台上。而dmesg命令可以查看所有级别的内核日志，不受控制台级别限制。

3.4 模块参数传递机制与sysfs接口

模块参数允许用户在加载模块时通过命令行传递配置值，也可以在模块运行期间通过sysfs文件系统动态修改。参数声明使用module_param(name, type, perm)宏，其中perm表示sysfs中对应文件的权限位。常用的参数类型包括：bool、int、long、charp（字符指针）、intp（整型指针）等。

当perm设置为0时，参数不会出现在sysfs中，只能在加载时通过insmod传递。当perm设置为0644时，参数文件会出现在/sys/module/hello/parameters/目录下，root用户可以读取，也可以写入修改。这种机制为驱动的运行时调优提供了极大便利。

# 加载时传递参数
sudo insmod hello.ko count=5 who="embedded"

# 查看sysfs中的参数节点
ls -l /sys/module/hello/parameters/
cat /sys/module/hello/parameters/count

# 运行时修改参数（需要root权限）
echo 10 > /sys/module/hello/parameters/count

# 再次查看模块日志，确认参数已更新
dmesg | tail -5

3.5 案例拆解：一个带参数校验的计数器模块

为了更深入地理解模块参数传递的实际应用，我们设计一个带参数校验的计数器模块。该模块维护一个内部计数器，支持通过模块参数设置初始值，并限制计数范围在0~100之间。这个案例模拟了驱动中常见的参数合法性检查场景。

场景背景：某嵌入式设备需要统计外部中断触发次数，驱动开发者希望提供一个可配置的初始计数值，同时防止用户设置超出硬件寄存器范围的数值。

实现方案：在hello_init中增加参数校验逻辑，如果传入的count值超出范围，则返回-EINVAL，模块加载失败。同时，利用param_set_int回调函数实现运行时参数修改的校验。

static int count = 1;
static int count_set(const char *val, const struct kernel_param *kp)
{
    int ret;
    int new_val;
    
    ret = kstrtoint(val, 10, &new_val);
    if (ret)
        return ret;
    
    if (new_val < 0 || new_val > 100) {
        printk(KERN_WARNING "count参数超出范围(0-100): %d\n", new_val);
        return -EINVAL;
    }
    
    return param_set_int(val, kp);
}

static const struct kernel_param_ops count_ops = {
    .set = count_set,
    .get = param_get_int,
};

module_param_cb(count, &count_ops, &count, 0644);

操作步骤与验证：

1. 编译模块后，尝试加载sudo insmod hello.ko count=150，观察加载失败并返回insmod: ERROR: could not insert module hello.ko: Invalid parameters。
2. 使用合法值加载sudo insmod hello.ko count=50，模块加载成功。
3. 运行时尝试写入非法值echo 200 > /sys/module/hello/parameters/count，系统返回write error: Invalid argument。
4. 写入合法值echo 80 > /sys/module/hello/parameters/count，操作成功。

结果对比：通过参数校验，模块在加载阶段和运行阶段都能有效拦截非法输入，避免了因参数越界导致的硬件寄存器配置错误。这种模式在真实驱动中非常常见，例如设置I2C总线速率、SPI时钟频率、GPIO编号等场景。

3.6 常见误区与调试技巧

在编写和调试内核模块时，初学者容易陷入以下几个误区：

• 忽略MODULE_LICENSE声明：如果模块没有声明GPL许可证，内核会将其标记为"tainted"，某些内核功能（如debugfs的部分接口）将不可用。
• printk使用printf格式：内核模块中不能使用%f浮点格式符，因为内核默认不启用浮点运算。同时，%p等扩展格式符需要内核配置支持。
• 加载后立即卸载导致日志丢失：如果模块加载后马上卸载，printk输出的日志可能还停留在缓冲区中，使用dmesg可以查看，但控制台可能来不及显示。
• 参数类型不匹配：使用module_param时，参数类型必须与变量类型严格匹配，否则会导致内存越界或数据错乱。
• 忘记清理函数：如果初始化函数中成功申请了资源（如内存、中断、设备号），必须在退出函数中逐一释放，否则会造成资源泄漏。

调试内核模块时，推荐使用以下工具链：dmesg查看日志、lsmod查看模块加载状态、modinfo查看模块元信息、/sys/module/<name>/目录查看运行时状态。对于复杂问题，可以使用printk配合KERN_DEBUG级别输出函数调用栈，或者使用WARN_ON()宏在异常条件触发时打印调用栈信息。

最后需要强调的是，内核模块运行在特权级别，任何内存访问错误都可能导致系统崩溃（Oops）甚至内核恐慌（Kernel Panic）。因此，在编写模块时务必保持谨慎，遵循"最小权限"原则，只访问必要的资源，并在所有错误路径上做好清理工作。通过本章的学习，读者应当能够独立完成一个带参数传递的Hello World模块的编写、编译、加载、测试和卸载全流程，为后续学习字符设备驱动、平台驱动等复杂主题打下坚实基础。