本文主要是介绍linux中断下文工作队列之自定义工作队列(中断五),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
共享队列是由内核管理的全局工作队列,自定义工作队列是由内核或驱动程序创建的特定工作队列,用于处理特定的任务。
一、工作队列相关结构体
在 Linux 内核中,结构体 struct work_struct 描述的是要延迟执行的工作项,定义在include/linux/workqueue.h 当中,如下所示
struct work_struct {
atomic_long_t data; // 工作项的数据字段
struct list_head entry; // 工作项在工作队列中的链表节点work_func_t func; // 工作项的处理函数
#ifdef CONFIG_LOCKDEP
struct lockdep_map lockdep_map; // 锁依赖性映射
#endif
};
这些工作组织成工作队列,内核使用 struct workqueue_struct 结构体描述一个工作队列,定义在 include/linux/workqueue.h 当中,如下所示:
struct workqueue_struct {
struct list_head pwqs; // 工作队列上的挂起工作项列表struct list_head delayed_works; // 延迟执行的工作项列表
struct delayed_work_timer dwork_timer; // 延迟工作项的定时器
struct workqueue_attrs *unbound_attrs; // 无绑定工作队列的属性struct pool_workqueue *dfl_pwq; // 默认的池化工作队列
...
};
二、工作队列相关接口函数
2.1、创建一个工作队列
在 Linux 内核中,create_workqueue 函数用于创建一个工作队列,函数原型如下所示:
struct workqueue_struct *create_workqueue(const char *name);
参数 name 是创建的工作队列的名字。使用这个函数可以给每个CPU 都创建一个CPU相关的工作队列。创建成功返回一个 struct workqueue_struct 类型指针,创建失败返回NULL。
如果只给一个 CPU 创建一个 CPU 相关的工作队列,使用以下函数。
#define create_singlethread_workqueue(name) \
alloc_workqueue("%s", WQ_SINGLE_THREAD, 1, name)
参数 name 是创建的工作队列的名字。使用这个函数只会给一个CPU 创建一个CPU相关的工作队列。创建成功之后返回一个 struct workqueue_struct 类型指针,创建失败返回NULL。
2.2、调度工作队列
当工作队列创建好之后,需要将要延迟执行的工作项放在工作队列上,调度工作队列,使用 queue_work_on 函数,函数原型如下所示:
bool queue_work_on(int cpu, struct workqueue_struct *wq, struct work_struct *work);
该函数有三个参数,第一个参数是一个整数 cpu,第二个参数是一个指向structworkqueue_struct 的指针 wq,第三个参数是一个指向 struct work_struct 的指针work。
该函数的返回类型是布尔值,表示是否成功调度工作队列。queue_work_on函数还有其他变种,比如 queue_work 函数,这里略过,其实思路是一致的,用于将定义好的工作项立即添加到工作队列中,并在工作队列可用时立即执行。
2.3、取消已经调度的工作
如果要取消一个已经调度的工作,使用函数 bool cancel_work_sync,函数原型如下所示:
bool cancel_work_sync(struct work_struct *work);
函数的作用是取消一个已经调度的工作,如果被取消的工作已经正在执行,则会等待他执行完成再返回
2.4、刷新工作队列
在 Linux 内核中,使用 flush_workqueue 函数将刷新该工作队列中所有已提交但未执行的工作项。函数原型如下所示:
void flush_workqueue(struct workqueue_struct *wq);
该函数参数是一个指向 struct workqueue_struct 类型的指针wq。函数的作用是刷新工作队列,告诉内核尽快处理工作队列上的工作。
2.5、删除自定义的工作队列
如果要删除自定义的工作队列,使用 destroy_workqueue 函数,函数原型如下所示:
void destroy_workqueue(struct workqueue_struct *wq);
该函数参数是一个指向 struct workqueue_struct 类型的指针wq。
三、代码示例
3.1、驱动层程序
#include <linux/module.h>
#include <linux/init.h>
#include <linux/interrupt.h>
#include <linux/gpio.h>
#include <linux/delay.h>
#include <linux/workqueue.h>int irq;
struct workqueue_struct *test_workqueue;
struct work_struct test_workqueue_work;// 工作项处理函数
void test_work(struct work_struct *work)
{msleep(1000);printk("This is test_work\n");
}// 中断处理函数
irqreturn_t test_interrupt(int irq, void *args)
{printk("This is test_interrupt\n");queue_work(test_workqueue, &test_workqueue_work); // 提交工作项到工作队列return IRQ_RETVAL(IRQ_HANDLED);
}static int interrupt_irq_init(void)
{int ret;irq = gpio_to_irq(101); // 将GPIO映射为中断号printk("irq is %d\n", irq);// 请求中断ret = request_irq(irq, test_interrupt, IRQF_TRIGGER_RISING, "test", NULL);if (ret < 0){printk("request_irq is error\n");return -1;}test_workqueue = create_workqueue("test_workqueue"); // 创建工作队列INIT_WORK(&test_workqueue_work, test_work); // 初始化工作项return 0;
}static void interrupt_irq_exit(void)
{free_irq(irq, NULL); // 释放中断cancel_work_sync(&test_workqueue_work); // 取消工作项flush_workqueue(test_workqueue); // 刷新工作队列destroy_workqueue(test_workqueue); // 销毁工作队列printk("bye bye\n");
}module_init(interrupt_irq_init);
module_exit(interrupt_irq_exit);
3.2、linux中断下文工作队列之自定义工作队列使用API要点
struct workqueue_struct *test_workqueue;
test_workqueue = create_workqueue("test_workqueue"); // 创建工作队列
这篇关于linux中断下文工作队列之自定义工作队列(中断五)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!