并发控制中的completion

作用：

用于一个执行单元等待另一个执行单元执行完某事,解决某些同步问题,提供一种比信号量更好的同步机制。

1. 定义completion结构体

动态定义：
struct completion my_completion;  //定义类型为completion 的结构体my_completion 
静态定义：
DECLARE_COMPLETION(my_completion);

2.初始化completion

init_completion(&my_completion);
reinit_completion(&my_completion)；
初始化和重新初始化my_completion,使其值为0，即处于未完成状态。

3.等待执行单元被唤醒

void wait_for_completion(struct completion *c);

4.唤醒等待的执行单元

void complete(struct completion *c);        // 只唤醒一个等待的执行单元
void complete_all(struct completion *c);   	// 唤醒所有等待同一完成量的执行单元
使用 complete_all, 然而, 你必须在重新使用前重新初始化 completion 结构. 宏定义:
INIT_COMPLETION(struct completion c); 可用来快速进行这个初始化.

5.同步流程

6.complete使用例子

#include <linux/module.h>
#include <linux/init.h>
#include <linux/sched.h>  
#include <linux/kernel.h> 
#include <linux/fs.h>      
#include <linux/types.h>  /
#include <linux/completion.h>

MODULE_LICENSE("Dual BSD/GPL");
MODULE_AUTHOR("NAME_XXX");

static int complete_major = 100;//指定主设备号

DECLARE_COMPLETION(my_completion);  //静态创建并初始化
//struct completion my_completion;  //动态创建
ssize_t complete_read (struct file *filp, char __user *buf, size_t count, loff_t *pos)
{
		 //init_completion(&my_completion);
         printk(KERN_DEBUG "process %i (%s) going to sleep/n", current->pid, current->comm);
         wait_for_completion(&my_completion);
         printk(KERN_DEBUG "awoken %i (%s)/n", current->pid, current->comm);
         return 0; /* EOF */
}

ssize_t complete_write (struct file *filp, const char __user *buf, size_t count, loff_t *pos)
{
         printk(KERN_DEBUG "process %i (%s) awakening the readers.../n",current->pid, current->comm);
         complete(&my_completion);
         return count; /* succeed, to avoid retrial */
}


struct file_operations complete_fops = {
         .owner = THIS_MODULE,
         .read =    complete_read,
         .write = complete_write,
};


int complete_init(void)
{
         int result;

	/*
    * Register your major, and accept a dynamic number
    */
        result = register_chrdev(complete_major, "complete", &complete_fops);
        if (result < 0)
                return result;
        if (complete_major == 0)
                complete_major = result; /* dynamic */
        return 0;
}

void complete_cleanup(void)
{
         unregister_chrdev(complete_major, "complete");
}

module_init(complete_init);
module_exit(complete_cleanup);