1. 从 /dev/timer_dev 的每秒计数说起:内核定时器功能库到底解决什么问题
很多人第一次用内核定时器功能库,都会默认 add_timer 是周期性的:挂上去一次,回调就该每秒进来一次,结果 dmesg 只打印一行,/dev/timer_dev 的计数器停在 1。这不是接口坏了,timer_list 本来就是一次性定时器,要它继续跑,得在回调末尾用 mod_timer 按 jiffies + HZ 重新续期。内核定时器功能库解决的是“在软中断上下文里,按 tick 粒度延迟执行一段不能睡眠的代码”,适合做秒级心跳、超时回收、状态轮询这类对抖动不敏感的任务。
它不适合微秒级精确定时,也不适合在回调里做文件 IO 或睡眠等待。下面这条链路从 timer_list 的字段和 jiffies 单位讲起,落到字符设备、模块编译、用户态 30 秒轮询,再把 del_timer_sync、回调上下文和 hrtimer 边界上的坑一个个拆开。读者最好是已经写过字符设备模块、被 open file error 或 rmmod 崩溃折腾过的驱动开发者。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 内核定时器功能库的接口层:timer_list、expires 与 jiffies 怎么配合
2.1 timer_list 的字段与 expires 的单位
timer_list 定义在 <linux/timer.h> 里,日常打交道的成员就三个:expires、function、flags。expires 的类型是 unsigned long,单位不是毫秒,是 jiffies。jiffies 是内核从启动开始累计的 tick 数,每来一个时钟 tick 加一;HZ 决定一秒有多少个 tick。所以“1 秒后到期”要写成 jiffies + HZ,或者用 msecs_to_jiffies(1000) 换算,不能把 1000 直接赋给 expires——那样定时器会在 1000 个 tick 后到期,在 HZ 不是 1000 的板子上就不是 1 秒。
初始化现在用 timer_setup,老代码里的 init_timer 加手工赋 function 的写法还能见到,但不要混着用:timer_setup 会把链表节点和回调一起初始化好,混用容易把 function 覆盖成空指针。flags 一般传 0,只有需要指定定时器在哪个 CPU 上执行时才动它。
c复制static struct timer_list my_timer;
static void timer_fn(struct timer_list *t)
{
/* 回调内容在 2.2 展开 */
}
static int __init timer_init(void)
{
timer_setup(&my_timer, timer_fn, 0);
my_timer.expires = jiffies + HZ; /* 1 秒后到期,HZ 由内核配置决定 */
add_timer(&my_timer);
return 0;
}
timer_setup 的三个参数分别是 timer 指针、回调函数、flags;回调签名固定为 void (*)(struct timer_list *),不是无参函数。expires 用相对当前 jiffies 推算,不要自己乘毫秒数。还有一点:jiffies 会回绕,直接写 if (jiffies > t->expires) 在回绕点会翻车,内核提供 time_after、time_before 宏,比较到期时间时走这两个宏。
2.2 add_timer、mod_timer、del_timer_sync 的语义
这三个动作经常被混用,语义差别直接决定计数会不会停、卸载会不会崩。add_timer 把已经初始化、当前未激活的 timer 挂到定时器轮上,它没有返回值,重复对同一个 timer 调用 add_timer 会把链表节点重复插入,内核可能直接报 kernel BUG at kernel/time/timer.c。mod_timer 既能激活也能改期,返回 0 表示之前没挂上,返回 1 表示之前已经挂上并被迁移到新到期时间;在回调里调用它是安全的,因为回调执行时 timer 已经从链表摘除。
del_timer 只负责把 timer 从链表摘掉,返回 1 表示确实删掉了,返回 0 表示本来没激活或已经被回调摘走;它不等待正在执行的回调。del_timer_sync 会等回调跑完再返回,卸载模块前必须用它,但它不能在回调自己里调用——回调正在执行时等自己结束,会直接死锁。
c复制static atomic_t counter = ATOMIC_INIT(0);
static void timer_fn(struct timer_list *t)
{
atomic_inc(&counter);
/* 一次性定时器,续期后才会有下一次 */
mod_timer(&my_timer, jiffies + HZ);
pr_info("timer_demo: tick=%d\n", atomic_read(&counter));
}
static void __exit timer_exit(void)
{
del_timer_sync(&my_timer); /* 先停定时器,再释放资源 */
device_destroy(timer_class, devno);
class_destroy(timer_class);
cdev_del(&my_cdev);
unregister_chrdev_region(devno, 1);
pr_info("timer_demo: exit\n");
}
回调里用 atomic_inc 而不是普通 int++,因为回调跑在软中断上下文,用户态 read 跑在进程上下文,两边会抢同一个变量。mod_timer 的第二个参数还是 jiffies + HZ,表示从当前时刻再推一秒;这种写法简单,但每次续期都从“现在”起算,回调本身的延迟会累积,5.2 会讲怎么用绝对到期时间减小漂移。timer_exit 里先 del_timer_sync 再销毁设备,顺序反了就可能出现回调访问已释放的 timer_class 或 devno。
2.3 字符设备 read 如何把计数交给用户态
内核侧计数有了,用户态要能读到,就得把字符设备的 read 接上。下面这段是注册和读接口的最小组合:alloc_chrdev_region 动态拿主设备号,cdev_init 绑定 file_operations,class_create 加 device_create 让 mdev/udev 自动生成 /dev/timer_dev;read 里用 copy_to_user 把 atomic_read 的结果拷出去。
c复制static dev_t devno;
static struct cdev my_cdev;
static struct class *timer_class;
static ssize_t timer_read(struct file *filp, char __user *buf,
size_t len, loff_t *off)
{
int val = atomic_read(&counter);
if (len < sizeof(int))
return -EINVAL;
if (copy_to_user(buf, &val, sizeof(int)))
return -EFAULT;
return sizeof(int);
}
static const struct file_operations timer_fops = {
.owner = THIS_MODULE,
.read = timer_read,
};
static int __init timer_init(void)
{
int ret;
ret = alloc_chrdev_region(&devno, 0, 1, "timer_dev");
if (ret)
return ret;
cdev_init(&my_cdev, &timer_fops);
my_cdev.owner = THIS_MODULE;
ret = cdev_add(&my_cdev, devno, 1);
if (ret)
goto err_cdev;
timer_class = class_create(THIS_MODULE, "timer_class");
if (IS_ERR(timer_class)) {
ret = PTR_ERR(timer_class);
goto err_class;
}
device_create(timer_class, NULL, devno, NULL, "timer_dev");
timer_setup(&my_timer, timer_fn, 0);
my_timer.expires = jiffies + HZ;
add_timer(&my_timer);
pr_info("timer_demo: loaded, major=%d\n", MAJOR(devno));
return 0;
err_class:
cdev_del(&my_cdev);
err_cdev:
unregister_chrdev_region(devno, 1);
return ret;
}
copy_to_user 返回的是“没拷成功的字节数”,非 0 就返回 -EFAULT;read 的返回值是实际拷贝的字节数,用户态拿 sizeof(int) 去接。len 先做长度判断,避免用户态传 0 长度时拷贝越界。class_create 的参数在不同内核版本上有差异,编译报参数不匹配时按当前头文件原型对齐,不要硬套旧写法。device_create 成功后节点不一定立刻出现,取决于根文件系统里 mdev/udev 有没有跑起来,4.2 会专门讲这个 open file error。
3. 把功能库跑起来:模块编译、加载与每秒计数的验证
3.1 Makefile 与内核头文件路径
模块编译不靠手写 gcc,走 kbuild。下面这个 Makefile 是最小可用版本,obj-m 告诉 kbuild 把 timer_demo.c 编成 timer_demo.ko,KDIR 指向当前运行内核的构建目录,M=$(PWD) 让 kbuild 回到当前目录找源文件。
makefile复制obj-m += timer_demo.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 -C $(KDIR) M=$(PWD) modules 是固定入口,不要改成直接调 gcc。KDIR 里的 $(shell uname -r) 必须和当前启动的内核版本一致;交叉编译时把 KDIR 换成目标板内核源码树,再补 ARCH 和 CROSS_COMPILE。编译报 No such file or directory: /lib/modules/.../build,大概率是只装了运行内核、没装匹配的 kernel headers,或者 uname -r 与 headers 目录对不上。先 uname -r 看版本,再去 /lib/modules/ 下确认有没有同名目录和 build 软链接。
Makefile 里命令行前面的缩进必须是 Tab,不是四个空格。用编辑器把 Tab 转成空格后,make 会报 missing separator,这个报错跟内核头文件无关,别往版本上查。
3.2 加载、设备节点与 dmesg 验证
编译通过后按顺序走这几步,每一步都看返回值或日志,不要一口气全敲完再回头找问题。
bash复制make
sudo insmod timer_demo.ko
dmesg | tail -n 20
ls -l /dev/timer_dev
cat /proc/devices | grep timer
insmod 返回 0 只代表模块 init 跑完了,不代表设备节点一定生成。dmesg | tail 里应该能看到 timer_demo: loaded, major=...,这个 major 就是 alloc_chrdev_region 拿到的主设备号。ls -l /dev/timer_dev 看节点是否存在、主次设备号对不对;cat /proc/devices 里 timer_dev 那一行能核对主设备号。如果节点不存在,先确认根文件系统里 mdev/udev 是否在跑;没有热插拔机制时,手动建节点:
bash复制sudo mknod /dev/timer_dev c <major> 0
sudo chmod 666 /dev/timer_dev
<major> 换成 /proc/devices 里查到的数字,次设备号是 0,因为 alloc_chrdev_region 只申请了 1 个设备。chmod 666 是为了让非 root 的测试程序也能打开;生产环境按最小权限收窄,不要长期放开。节点建好后,用户态 open("/dev/timer_dev", O_RDWR) 才有东西可开,否则就是第 1 章里那个 open file error。
dmesg 里如果没有 pr_info 的输出,先别怀疑定时器没跑。pr_info 是 KERN_INFO 级别,可能被 console loglevel 挡在串口外,但 dmesg 缓冲区里通常还在。直接 dmesg | tail 看,不要只看串口终端;临时放开可以用 dmesg -n 8,它改的是 console 输出级别,不是永久配置。
