Linux中workqueue使用

1. workqueque简介

• 在内核中创建一个线程；可以多CPU核并行处理；
• 推后执行；可以在进程上下文执行；
• 允许被重新调度甚至睡眠。
• 比tasklet更有效。基本可以取代。

2. 参考引用，数据结构

• struct work_struct

struct work_struct { 
    atomic_long_t data; /*工作处理函数func的参数*/ 
    #define WORK_STRUCT_PENDING 0 /* T if work item pending execution */ 
    #define WORK_STRUCT_STATIC 1 /* static initializer (debugobjects) */ 
    #define WORK_STRUCT_FLAG_MASK (3UL) 
    #define WORK_STRUCT_WQ_DATA_MASK (~WORK_STRUCT_FLAG_MASK) 
    struct list_head entry; /*连接工作的指针*/ 
    work_func_t func; /*工作处理函数*/ 
    #ifdef CONFIG_LOCKDEP 
        struct lockdep_map lockdep_map; 
    #endif 
};

• 这些工作以队列结构组织成工作队列（workqueue），其数据结构为workqueue_struct:

struct workqueue_struct { 
    struct cpu_workqueue_struct *cpu_wq; 
    struct list_head list;
    const char *name; /*workqueue name*/ 
    int singlethread; /*是不是单线程 - 单线程我们首选第一个CPU -0表示采用默认的工作者线程event*/                                 
    int freezeable; /* Freeze threads during suspend */ 
    int rt; 
};

•      如果是多线程，Linux根据当前系统CPU的个数创建cpu_workqueue_struct 其结构体就是:

struct cpu_workqueue_struct { 
    spinlock_t lock;/*因为工作者线程需要频繁的处理连接到其上的工作，所以需要枷锁保护*/ 
    struct list_head worklist; 
    wait_queue_head_t more_work; 
    struct work_struct *current_work; /*当前的work*/ 
    struct workqueue_struct *wq; /*所属的workqueue*/ 
    struct task_struct *thread; /*任务的上下文*/ 
} ____cacheline_aligned;

3. 使用流程

3.1 创建工作队列queue

create_singlethread_workqueue(name)

3.2 创建工作

INIT_WORK(structwork_struct *work, woid(*func) (void *), void *data);

3.3 调度

schedule_work（&work)

4 示例

//声明

static struct workqueue_struct *mdp_pipe_ctrl_wq; /* mdp mdp pipe ctrl wq */

static struct delayed_work mdp_pipe_ctrl_worker;


mdp_pipe_ctrl_wq = create_singlethread_workqueue("mdp_pipe_ctrl_wq");//创建工作队列

INIT_DELAYED_WORK(&mdp_pipe_ctrl_worker,mdp_pipe_ctrl_workqueue_handler);//delayed_work与task_func绑定。

//处理函数

static void mdp_pipe_ctrl_workqueue_handler(struct work_struct *work)
{
 mdp_pipe_ctrl(MDP_MASTER_BLOCK, MDP_BLOCK_POWER_OFF, FALSE);
}

//开始调用工作队列，delay时间到了就执行处理函数。

unsigned long mdp_timer_duration = (HZ/20); /* 50 msecond */

/* send workqueue to turn off mdp power */

queue_delayed_work(mdp_pipe_ctrl_wq,&mdp_pipe_ctrl_worker, mdp_timer_duration);

 

/* cancel pipe ctrl worker */

cancel_delayed_work(&mdp_pipe_ctrl_worker);

/* for workder can't be cancelled... */

flush_workqueue(mdp_pipe_ctrl_wq);

/* for workder can't be cancelled... */

flush_workqueue(mdp_pipe_ctrl_wq);

5 API 参考

1. create_workqueue用于创建一个workqueue队列，为系统中的每个CPU都创建一个内核线程。输入参数：

@name：workqueue的名称

2. create_singlethread_workqueue用于创建workqueue，只创建一个内核线程。输入参数：

@name：workqueue名称

3. destroy_workqueue释放workqueue队列。输入参数：

@ workqueue_struct：需要释放的workqueue队列指针

4. schedule_work调度执行一个具体的任务，执行的任务将会被挂入Linux系统提供的workqueue——keventd_wq输入参数：

@ work_struct：具体任务对象指针

5. schedule_delayed_work延迟一定时间去执行一个具体的任务，功能与schedule_work类似，多了一个延迟时间，输入参数：

@work_struct：具体任务对象指针

@delay：延迟时间

6. queue_work调度执行一个指定workqueue中的任务。输入参数：

@ workqueue_struct：指定的workqueue指针

@work_struct：具体任务对象指针

7. queue_delayed_work延迟调度执行一个指定workqueue中的任务，功能与queue_work类似，输入参数多了一个delay。