linux/drivers/md/dm-vdo/funnel-workqueue.h
Matthew Sakai d9e894d9b2 dm vdo: add specialized request queueing functionality
This patch adds funnel_queue, a mostly lock-free multi-producer,
single-consumer queue. It also adds the request queue used by the dm-vdo
deduplication index, and the work_queue used by the dm-vdo data store. Both
of these are built on top of funnel queue and are intended to support the
dispatching of many short-running tasks. The work_queue also supports
priorities. Finally, this patch adds vdo_completion, the structure which is
enqueued on work_queues.

Co-developed-by: J. corwin Coburn <corwin@hurlbutnet.net>
Signed-off-by: J. corwin Coburn <corwin@hurlbutnet.net>
Co-developed-by: Michael Sclafani <dm-devel@lists.linux.dev>
Signed-off-by: Michael Sclafani <dm-devel@lists.linux.dev>
Co-developed-by: Sweet Tea Dorminy <sweettea-kernel@dorminy.me>
Signed-off-by: Sweet Tea Dorminy <sweettea-kernel@dorminy.me>
Co-developed-by: Ken Raeburn <raeburn@redhat.com>
Signed-off-by: Ken Raeburn <raeburn@redhat.com>
Signed-off-by: Matthew Sakai <msakai@redhat.com>
Signed-off-by: Mike Snitzer <snitzer@kernel.org>
2024-02-20 13:43:13 -05:00

52 lines
1.4 KiB
C

/* SPDX-License-Identifier: GPL-2.0-only */
/*
* Copyright 2023 Red Hat
*/
#ifndef VDO_WORK_QUEUE_H
#define VDO_WORK_QUEUE_H
#include <linux/sched.h> /* for TASK_COMM_LEN */
#include "types.h"
enum {
MAX_VDO_WORK_QUEUE_NAME_LEN = TASK_COMM_LEN,
};
struct vdo_work_queue_type {
void (*start)(void *context);
void (*finish)(void *context);
enum vdo_completion_priority max_priority;
enum vdo_completion_priority default_priority;
};
struct vdo_completion;
struct vdo_thread;
struct vdo_work_queue;
int vdo_make_work_queue(const char *thread_name_prefix, const char *name,
struct vdo_thread *owner, const struct vdo_work_queue_type *type,
unsigned int thread_count, void *thread_privates[],
struct vdo_work_queue **queue_ptr);
void vdo_enqueue_work_queue(struct vdo_work_queue *queue, struct vdo_completion *completion);
void vdo_finish_work_queue(struct vdo_work_queue *queue);
void vdo_free_work_queue(struct vdo_work_queue *queue);
void vdo_dump_work_queue(struct vdo_work_queue *queue);
void vdo_dump_completion_to_buffer(struct vdo_completion *completion, char *buffer,
size_t length);
void *vdo_get_work_queue_private_data(void);
struct vdo_work_queue *vdo_get_current_work_queue(void);
struct vdo_thread *vdo_get_work_queue_owner(struct vdo_work_queue *queue);
bool __must_check vdo_work_queue_type_is(struct vdo_work_queue *queue,
const struct vdo_work_queue_type *type);
#endif /* VDO_WORK_QUEUE_H */