阅读数:158 评论数:0

一、概述

在 Linux 内核编程中，DECLARE_COMPLETION 是一个宏，用于声明并初始化一个 completion 结构体，这个结构体用于同步机制，允许一个进程等待另一个进程的信号。

DECLARE_COMPLETION 宏定义如下：

#define DECLARE_COMPLETION(work) \
    struct completion work = COMPLETION_INITIALIZER(work)

这个宏声明了一个名为 work 的 completion 结构体，并使用 COMPLETION_INITIALIZER 宏将其初始化。COMPLETION_INITIALIZER 本身用于设置 completion 结构体的初始状态，使其处于未完成状态。

使用 DECLARE_COMPLETION 宏可以在函数内部或者作为全局变量来声明一个 completion 结构体。当你想要等待某个事件发生时，可以在一个线程中调用 wait_for_completion（或者相关的函数，如 wait_for_completion_timeout），而在另一个线程中一旦事件发生，就调用 complete 或 complete_all 来唤醒等待的线程。

例如：

#include <linux/completion.h>

void some_function(void)
{
    DECLARE_COMPLETION(comp);

    // ... 代码可能会启动一个异步操作，然后等待它完成 ...

    // 等待异步操作完成
    wait_for_completion(&comp);

    // ... 一旦异步操作调用了complete(&comp)，执行会从这里继续 ...
}

二、源码相关

comletion的相关定义包含在include/linux/completion.h中：

struct completion {
unsigned int done;
wait_queue_head_t wait;
};
#define COMPLETION_INITIALIZER(work)
{ 0, __WAIT_QUEUE_HEAD_INITIALIZER((work).wait) }
#define DECLARE_COMPLETION(work)
struct completion work = COMPLETION_INITIALIZER(work)
static inline void init_completion(struct completion *x)
{
x->done = 0;
init_waitqueue_head(&x->wait);
}

要等待completion，可进行如下调用：

void wait_for_completion(struct completion *c);

触发completion事件，调用：

void complete(struct completion *c); //唤醒一个等待线程
void complete_all(struct completion *c); //唤醒所有的等待线程