| WORKQUEUE(9) | Kernel Developer's Manual | WORKQUEUE(9) |
workqueue —
#include <sys/workqueue.h>
int
workqueue_create(struct
workqueue **wqp, const
char *name, void
(*func)(struct work *, void *),
void *arg,
pri_t prio,
int ipl,
int flags);
void
workqueue_enqueue(struct
workqueue *wq, struct
work *wk, struct cpu_info
*ci);
void
workqueue_wait(struct
workqueue *wq, struct
work *wk);
void
workqueue_destroy(struct
workqueue *wq);
workqueue utility routines are provided to defer
work which is needed to be processed in a thread context.
workqueue_create() creates a workqueue. It
takes the following arguments:
WQ_FPUWQ_MPSAFEWQ_PERCPUworkqueue_enqueue() enqueues the work
wk into the workqueue wq.
If the WQ_PERCPU flag was set on workqueue
creation, the ci argument may be used to specify the
CPU on which the work should be enqueued. Also it may be
NULL, then work will be enqueued on the current CPU.
If WQ_PERCPU flag was not set,
ci must be NULL.
The enqueued work will be processed in a thread context. A work
must not be enqueued again until the callback is called by the
workqueue framework.
workqueue_wait() waits for a specified
work wk on the workqueue wq to
finish. The caller must ensure that wk will not be
enqueued to the workqueue again until after
workqueue_wait() returns.
workqueue_destroy() destroys a workqueue
and frees associated resources. The caller should ensure that the workqueue
has no work enqueued beforehand.
workqueue_create() returns 0 on success. Otherwise, it
returns an errno(2).
workqueue subsystem is implemented within the file
sys/kern/subr_workqueue.c.
| December 28, 2017 | NetBSD 10.0 |