📚 课程目录第1章 Linux内核开发环境搭建

Linux内核驱动开发：从字符设备到中断处理实战 - 第1节

1.1 开发环境全景概览

内核驱动开发与用户态程序开发有本质区别：驱动直接运行在操作系统最底层，任何错误都可能导致系统崩溃。因此，搭建一个隔离、可控、可复现的开发环境是学习的第一步。本章将引导你从零构建一套完整的 Linux 内核驱动开发环境，涵盖虚拟机、操作系统、内核源码及第一个可加载内核模块（LKM）。

  环境目标： 在 Windows/macOS 宿主机上通过 VirtualBox 运行 Ubuntu 22.04 LTS，下载并编译与当前系统版本匹配的内核源码树，最终编写、编译并加载一个打印 "Hello, Kernel!" 的内核模块。

1.2 虚拟机与操作系统安装

1.2.1 选择虚拟化平台

推荐使用 Oracle VirtualBox（开源免费）或 VMware Workstation Player（个人免费）。两者均支持嵌套分页、硬件加速和共享文件夹，足以满足内核编译需求。

特性	VirtualBox	VMware Workstation Player
许可证	GPLv2（开源）	个人免费，商业需授权
3D 加速	基础支持	较好
快照管理	支持	支持
共享文件夹	需安装增强功能	内置支持
推荐场景	内核编译、嵌入式开发	桌面级 Linux 测试

1.2.2 虚拟机配置建议

CPU： 至少分配 2 个核心（推荐 4 核），以加速内核编译。
内存： 至少 4 GB（推荐 8 GB），编译大型内核时内存不足会导致 OOM。
磁盘： 动态分配 40 GB 以上，建议使用 VDI 或 VMDK 格式。
网络： 使用 NAT + 主机仅主机（Host-Only）双网卡，方便 SSH 连接。

💡 省时技巧： 安装 Ubuntu 时选择 "最小化安装"，避免预装大量桌面软件占用磁盘空间。后续通过 apt 按需安装 build-essential、gcc、make 等工具链。

1.3 内核源码获取与配置

1.3.1 确认当前内核版本

在虚拟机终端中执行以下命令，查看当前运行的内核版本：

$ uname -r
5.15.0-91-generic

驱动模块必须与运行中的内核版本严格匹配。有两种方式获取源码：

安装内核头文件（推荐初学者）： 包含编译模块所需的头文件和 Makefile 片段，体积小，速度快。
下载完整内核源码： 适合需要修改内核配置或调试内核本身的场景。

1.3.2 安装内核头文件

$ sudo apt update
$ sudo apt install linux-headers-$(uname -r)
$ ls -l /usr/src/linux-headers-5.15.0-91-generic/

1.3.3 下载完整内核源码（可选）

$ sudo apt install linux-source
$ cd /usr/src
$ sudo tar -xvf linux-source-5.15.0.tar.bz2
$ cd linux-source-5.15.0
$ sudo make oldconfig   # 使用当前内核配置

⚠️ 常见错误： 如果使用完整源码编译模块，必须确保 .config 文件与当前运行内核一致。直接使用 make oldconfig 可以复用 /proc/config.gz 中的配置。

1.4 第一个内核模块：Hello World

1.4.1 模块源码结构

一个最小化的内核模块包含两个核心函数：module_init() 和 module_exit()。它们分别在模块加载和卸载时被内核调用。

// hello.c
#include <linux/module.h>    // 所有模块都需要
#include <linux/kernel.h>    // printk 等级宏
#include <linux/init.h>      // __init / __exit 宏

static int __init hello_init(void)
{
    printk(KERN_INFO "Hello, Kernel! Module loaded.\n");
    return 0;   // 返回 0 表示成功
}

static void __exit hello_exit(void)
{
    printk(KERN_INFO "Goodbye, Kernel! Module unloaded.\n");
}

module_init(hello_init);
module_exit(hello_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Your Name");
MODULE_DESCRIPTION("A simple Hello World LKM");

1.4.2 Makefile 编写

内核模块的编译依赖内核构建系统（Kbuild）。Makefile 必须使用 obj-m 变量指定目标模块：

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

  关键说明： KDIR 指向内核头文件或源码树的构建目录。-C 选项让 make 先进入 KDIR 读取顶层 Makefile，然后通过 M= 返回当前目录编译模块。

1.4.3 编译与测试

$ make
make -C /lib/modules/5.15.0-91-generic/build M=/home/user/hello modules
  CC [M]  hello.o
  MODPOST
  LD [M]  hello.ko

$ sudo insmod hello.ko      # 加载模块
$ dmesg | tail -1
[ 1234.567890] Hello, Kernel! Module loaded.

$ sudo rmmod hello          # 卸载模块
$ dmesg | tail -1
[ 1235.123456] Goodbye, Kernel! Module unloaded.

$ lsmod | grep hello        # 确认模块已卸载

1.5 模块生命周期与内核日志

1.5.1 模块状态转换

内核模块在生命周期中经历四个状态：

状态	说明	触发操作
Loaded	模块已加载到内核空间，但尚未初始化	`insmod` 将 .ko 文件读入内存
Initialized	执行 `module_init()` 成功，模块可用	内核调用 init 函数
Running	模块正常提供服务	系统正常运行中
Unloaded	执行 `module_exit()` 后释放资源	`rmmod` 触发 exit 函数

1.5.2 printk 与日志级别

printk() 是内核空间的打印函数，类似用户态的 printf()。它支持 8 个日志级别，定义在 <linux/kern_levels.h>：

KERN_EMERG (0) — 紧急情况，系统不可用
KERN_ALERT (1) — 必须立即处理
KERN_CRIT (2) — 严重错误
KERN_ERR (3) — 错误条件
KERN_WARNING (4) — 警告
KERN_NOTICE (5) — 正常但重要
KERN_INFO (6) — 信息性消息
KERN_DEBUG (7) — 调试消息

💡 调试技巧： 使用 tail -f /var/log/kern.log 或 dmesg -w 实时查看内核日志。如果 printk 消息没有显示，检查 /proc/sys/kernel/printk 的当前控制台日志级别。

1.6 常见问题与排错

错误现象	可能原因	解决方案
`insmod: ERROR: could not insert module hello.ko: Invalid module format`	模块编译使用的内核版本与当前运行内核不一致	确认 `uname -r` 与 `/lib/modules/` 下的目录名匹配
`insmod: ERROR: could not insert module hello.ko: Operation not permitted`	Secure Boot 阻止加载未签名模块	进入 BIOS 禁用 Secure Boot，或使用 `mokutil` 签名模块
`make: *** /lib/modules/5.15.0-91-generic/build: No such file or directory`	未安装内核头文件	执行 `sudo apt install linux-headers-$(uname -r)`
加载模块后系统无响应	init 函数中发生 panic 或死循环	重启虚拟机，检查代码中是否有 `BUG()` 或无限循环

⚠️ 安全提醒： 不要在重要数据或生产环境虚拟机中测试未经验证的内核模块。始终使用快照或专用测试虚拟机。内核模块拥有最高权限，可以读写任意内存地址。

1.7 本章小结

通过本章的学习，你已经完成了以下关键任务：

搭建了基于虚拟机的隔离开发环境
安装了与当前内核匹配的头文件或完整源码
编写并编译了第一个内核模块 hello.ko
使用 insmod / rmmod 加载和卸载模块
通过 dmesg 观察内核日志输出