读书笔记（10）—— kernel 完成量

完成量

完成量特点
自旋锁信号量在内的各种锁类机制都有一个共同的特点即加锁者和解锁者必须是同一个进程，而完成量不同，A进程加锁，B进程解锁的同步原语操作，主要用于进程间通信。
数据结构

struct completion {
  unsigned int done；
  wait_queue_head_t wait;
}

其中done字段表示完成状态，wait字段代表等待队列。工作原理就是：A进程将done
设置为未完成，然后将自己挂接到wait队列上并进入睡眠（类似于信号量的加锁操作down），B进程完成所需要的工作之后，唤醒A进程（类似于信号量的解锁操作up），很明显完成量只能在进程上下文使用，并不能用于中断上下文。
完成量主要使用的API

声明一个完成量（全局变量）：
DECLARE_COMPLETION(work)
在栈内声明一个完成量（局部变量）：
DECLARE_COMPLETION_ONSTACK(WORK)
初始化一个完成量：
init_completion(work)
等待一个完成量完成，当前进程将进入不可中断睡眠状态（TASK_UNINTERRUPTIBLE）:
wait_for_completion_killable(x)
等待完成量完成，当前进程将进入可中断睡眠状态（TASK_INTERRUPTIBLE）:
wait_for_completion_timeout(x,timeout)
等待完成量完成，当前进程进入带超时值timeout的可杀死睡眠状态（TASK_KILLABLE）:
wait_for_completion_interruptiable_timeout(x,timeout);
等待完成量完成，当前进程进入带超时值timeout的可中断睡眠状态（TASK_INTERRUPTIABLE）:
wait_for_completion_interrupt_timeout(x,timeout)
执行完成操作，并唤醒等待队列上的第一个进程：
complete(x)
执行完成操作，并唤醒等待队列上的所有进程：
complete_all(x)
判断完成量是否已经完成：
complete_done(x)