linux内核completion

最新推荐文章于 2025-11-04 03:27:00 发布

原创最新推荐文章于 2025-11-04 03:27:00 发布 · 401 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#linux

Linux内核中completion的使用

completion是Linux内核中用于线程间同步的一种机制，它允许一个线程告诉另一个线程某个特定事件已经完成。下面详细介绍completion的使用方法。

基本概念

completion机制用于解决以下场景：

一个线程需要等待另一个线程完成某项工作
需要比信号量更轻量级的同步机制
需要明确的完成通知而非状态查询

使用方法

1. 定义和初始化completion

#include <linux/completion.h>

// 静态定义并初始化
DECLARE_COMPLETION(my_completion);

// 动态初始化
struct completion my_completion;
init_completion(&my_completion);

2. 等待completion

// 无限等待
void wait_for_completion(struct completion *c);

// 可中断的等待（可能被信号打断）
int wait_for_completion_interruptible(struct completion *c);

// 带超时的等待（返回剩余时间，0表示超时）
unsigned long wait_for_completion_timeout(struct completion *c, unsigned long timeout);

// 可中断且带超时的等待
long wait_for_completion_interruptible_timeout(struct completion *c, unsigned long timeout);

3. 触发completion

// 唤醒一个等待者
void complete(struct completion *c);

// 唤醒所有等待者
void complete_all(struct completion *c);
4. 重新初始化completion
// 重新初始化completion（通常在complete_all之后使用）
reinit_completion(&my_completion);

使用示例

简单示例

DECLARE_COMPLETION(comp);

// 线程1
void thread1(void)
{
    // 做一些工作
    do_some_work();
    
    // 通知完成
    complete(&comp);
}

// 线程2
void thread2(void)
{
    // 等待工作完成
    wait_for_completion(&comp);
    
    // 继续执行
    continue_work();
}

带超时的示例

struct completion done;
unsigned long timeout = msecs_to_jiffies(1000); // 1秒超时

init_completion(&done);

// 启动工作线程
start_work_thread(&done);

// 主线程等待
if (!wait_for_completion_timeout(&done, timeout)) {
    // 超时处理
    pr_err("Operation timed out\n");
} else {
    // 正常完成
    pr_info("Operation completed\n");
}