Spdk/module/bdev/compress/vbdev_compress.c
paul luse bb5083a85d bdev/compress: Port to use accel_fw instead of compressdev
directly

This patch removes hardcoded compressdev code from the
vbdev module and instead uses the accel_fw. The port required
a few changes based on how things are plumbed and accessed,
nothing that isn't be too obscure.  CI tests were updated to
run ISAL accel_fw module as well as DPDK compressdev with QAT.

Unit tests for the new module will follow in a separate patch.

Signed-off-by: paul luse <paul.e.luse@intel.com>
Change-Id: I769cbc888658fb846d89f6f0bfeeb1a2a820767e
Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/13610
Tested-by: SPDK CI Jenkins <sys_sgci@intel.com>
Reviewed-by: Tomasz Zawadzki <tomasz.zawadzki@intel.com>
Reviewed-by: Konrad Sztyber <konrad.sztyber@intel.com>
2023-01-20 10:26:21 +00:00

1197 lines
35 KiB
C

/* SPDX-License-Identifier: BSD-3-Clause
* Copyright (C) 2018 Intel Corporation.
* All rights reserved.
* Copyright (c) 2021, 2022 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
*/
#include "vbdev_compress.h"
#include "spdk/reduce.h"
#include "spdk/stdinc.h"
#include "spdk/rpc.h"
#include "spdk/env.h"
#include "spdk/endian.h"
#include "spdk/string.h"
#include "spdk/thread.h"
#include "spdk/util.h"
#include "spdk/bdev_module.h"
#include "spdk/likely.h"
#include "spdk/log.h"
#include "spdk/accel.h"
#include "spdk_internal/accel_module.h"
#define CHUNK_SIZE (1024 * 16)
#define COMP_BDEV_NAME "compress"
#define BACKING_IO_SZ (4 * 1024)
struct vbdev_comp_delete_ctx {
spdk_delete_compress_complete cb_fn;
void *cb_arg;
int cb_rc;
struct spdk_thread *orig_thread;
};
/* List of virtual bdevs and associated info for each. */
struct vbdev_compress {
struct spdk_bdev *base_bdev; /* the thing we're attaching to */
struct spdk_bdev_desc *base_desc; /* its descriptor we get from open */
struct spdk_io_channel *base_ch; /* IO channel of base device */
struct spdk_bdev comp_bdev; /* the compression virtual bdev */
struct comp_io_channel *comp_ch; /* channel associated with this bdev */
struct spdk_io_channel *accel_channel; /* to communicate with the accel framework */
struct spdk_thread *reduce_thread;
pthread_mutex_t reduce_lock;
uint32_t ch_count;
TAILQ_HEAD(, spdk_bdev_io) pending_comp_ios; /* outstanding operations to a comp library */
struct spdk_poller *poller; /* completion poller */
struct spdk_reduce_vol_params params; /* params for the reduce volume */
struct spdk_reduce_backing_dev backing_dev; /* backing device info for the reduce volume */
struct spdk_reduce_vol *vol; /* the reduce volume */
struct vbdev_comp_delete_ctx *delete_ctx;
bool orphaned; /* base bdev claimed but comp_bdev not registered */
int reduce_errno;
TAILQ_HEAD(, vbdev_comp_op) queued_comp_ops;
TAILQ_ENTRY(vbdev_compress) link;
struct spdk_thread *thread; /* thread where base device is opened */
};
static TAILQ_HEAD(, vbdev_compress) g_vbdev_comp = TAILQ_HEAD_INITIALIZER(g_vbdev_comp);
/* The comp vbdev channel struct. It is allocated and freed on my behalf by the io channel code.
*/
struct comp_io_channel {
struct spdk_io_channel_iter *iter; /* used with for_each_channel in reset */
};
/* Per I/O context for the compression vbdev. */
struct comp_bdev_io {
struct comp_io_channel *comp_ch; /* used in completion handling */
struct vbdev_compress *comp_bdev; /* vbdev associated with this IO */
struct spdk_bdev_io_wait_entry bdev_io_wait; /* for bdev_io_wait */
struct spdk_bdev_io *orig_io; /* the original IO */
struct spdk_io_channel *ch; /* for resubmission */
int status; /* save for completion on orig thread */
};
static void vbdev_compress_examine(struct spdk_bdev *bdev);
static int vbdev_compress_claim(struct vbdev_compress *comp_bdev);
static void vbdev_compress_queue_io(struct spdk_bdev_io *bdev_io);
struct vbdev_compress *_prepare_for_load_init(struct spdk_bdev_desc *bdev_desc, uint32_t lb_size);
static void vbdev_compress_submit_request(struct spdk_io_channel *ch, struct spdk_bdev_io *bdev_io);
static void comp_bdev_ch_destroy_cb(void *io_device, void *ctx_buf);
static void vbdev_compress_delete_done(void *cb_arg, int bdeverrno);
/* for completing rw requests on the orig IO thread. */
static void
_reduce_rw_blocks_cb(void *arg)
{
struct comp_bdev_io *io_ctx = arg;
if (spdk_likely(io_ctx->status == 0)) {
spdk_bdev_io_complete(io_ctx->orig_io, SPDK_BDEV_IO_STATUS_SUCCESS);
} else if (io_ctx->status == -ENOMEM) {
vbdev_compress_queue_io(spdk_bdev_io_from_ctx(io_ctx));
} else {
SPDK_ERRLOG("status %d on operation from reduce API\n", io_ctx->status);
spdk_bdev_io_complete(io_ctx->orig_io, SPDK_BDEV_IO_STATUS_FAILED);
}
}
/* Completion callback for r/w that were issued via reducelib. */
static void
reduce_rw_blocks_cb(void *arg, int reduce_errno)
{
struct spdk_bdev_io *bdev_io = arg;
struct comp_bdev_io *io_ctx = (struct comp_bdev_io *)bdev_io->driver_ctx;
struct spdk_io_channel *ch = spdk_io_channel_from_ctx(io_ctx->comp_ch);
struct spdk_thread *orig_thread;
/* TODO: need to decide which error codes are bdev_io success vs failure;
* example examine calls reading metadata */
io_ctx->status = reduce_errno;
/* Send this request to the orig IO thread. */
orig_thread = spdk_io_channel_get_thread(ch);
spdk_thread_exec_msg(orig_thread, _reduce_rw_blocks_cb, io_ctx);
}
static int
_compress_operation(struct spdk_reduce_backing_dev *backing_dev, struct iovec *src_iovs,
int src_iovcnt, struct iovec *dst_iovs,
int dst_iovcnt, bool compress, void *cb_arg)
{
struct spdk_reduce_vol_cb_args *reduce_cb_arg = cb_arg;
struct vbdev_compress *comp_bdev = SPDK_CONTAINEROF(backing_dev, struct vbdev_compress,
backing_dev);
int rc;
if (compress) {
assert(dst_iovcnt == 1);
rc = spdk_accel_submit_compress(comp_bdev->accel_channel, dst_iovs[0].iov_base, dst_iovs[0].iov_len,
src_iovs, src_iovcnt, &reduce_cb_arg->output_size,
0, reduce_cb_arg->cb_fn, reduce_cb_arg->cb_arg);
} else {
rc = spdk_accel_submit_decompress(comp_bdev->accel_channel, dst_iovs, dst_iovcnt,
src_iovs, src_iovcnt, &reduce_cb_arg->output_size,
0, reduce_cb_arg->cb_fn, reduce_cb_arg->cb_arg);
}
return rc;
}
/* Entry point for reduce lib to issue a compress operation. */
static void
_comp_reduce_compress(struct spdk_reduce_backing_dev *dev,
struct iovec *src_iovs, int src_iovcnt,
struct iovec *dst_iovs, int dst_iovcnt,
struct spdk_reduce_vol_cb_args *cb_arg)
{
int rc;
rc = _compress_operation(dev, src_iovs, src_iovcnt, dst_iovs, dst_iovcnt, true, cb_arg);
if (rc) {
SPDK_ERRLOG("with compress operation code %d (%s)\n", rc, spdk_strerror(-rc));
cb_arg->cb_fn(cb_arg->cb_arg, rc);
}
}
/* Entry point for reduce lib to issue a decompress operation. */
static void
_comp_reduce_decompress(struct spdk_reduce_backing_dev *dev,
struct iovec *src_iovs, int src_iovcnt,
struct iovec *dst_iovs, int dst_iovcnt,
struct spdk_reduce_vol_cb_args *cb_arg)
{
int rc;
rc = _compress_operation(dev, src_iovs, src_iovcnt, dst_iovs, dst_iovcnt, false, cb_arg);
if (rc) {
SPDK_ERRLOG("with decompress operation code %d (%s)\n", rc, spdk_strerror(-rc));
cb_arg->cb_fn(cb_arg->cb_arg, rc);
}
}
static void
_comp_submit_write(void *ctx)
{
struct spdk_bdev_io *bdev_io = ctx;
struct vbdev_compress *comp_bdev = SPDK_CONTAINEROF(bdev_io->bdev, struct vbdev_compress,
comp_bdev);
spdk_reduce_vol_writev(comp_bdev->vol, bdev_io->u.bdev.iovs, bdev_io->u.bdev.iovcnt,
bdev_io->u.bdev.offset_blocks, bdev_io->u.bdev.num_blocks,
reduce_rw_blocks_cb, bdev_io);
}
static void
_comp_submit_read(void *ctx)
{
struct spdk_bdev_io *bdev_io = ctx;
struct vbdev_compress *comp_bdev = SPDK_CONTAINEROF(bdev_io->bdev, struct vbdev_compress,
comp_bdev);
spdk_reduce_vol_readv(comp_bdev->vol, bdev_io->u.bdev.iovs, bdev_io->u.bdev.iovcnt,
bdev_io->u.bdev.offset_blocks, bdev_io->u.bdev.num_blocks,
reduce_rw_blocks_cb, bdev_io);
}
/* Callback for getting a buf from the bdev pool in the event that the caller passed
* in NULL, we need to own the buffer so it doesn't get freed by another vbdev module
* beneath us before we're done with it.
*/
static void
comp_read_get_buf_cb(struct spdk_io_channel *ch, struct spdk_bdev_io *bdev_io, bool success)
{
struct vbdev_compress *comp_bdev = SPDK_CONTAINEROF(bdev_io->bdev, struct vbdev_compress,
comp_bdev);
if (spdk_unlikely(!success)) {
SPDK_ERRLOG("Failed to get data buffer\n");
reduce_rw_blocks_cb(bdev_io, -ENOMEM);
return;
}
spdk_thread_exec_msg(comp_bdev->reduce_thread, _comp_submit_read, bdev_io);
}
/* Called when someone above submits IO to this vbdev. */
static void
vbdev_compress_submit_request(struct spdk_io_channel *ch, struct spdk_bdev_io *bdev_io)
{
struct comp_bdev_io *io_ctx = (struct comp_bdev_io *)bdev_io->driver_ctx;
struct vbdev_compress *comp_bdev = SPDK_CONTAINEROF(bdev_io->bdev, struct vbdev_compress,
comp_bdev);
struct comp_io_channel *comp_ch = spdk_io_channel_get_ctx(ch);
memset(io_ctx, 0, sizeof(struct comp_bdev_io));
io_ctx->comp_bdev = comp_bdev;
io_ctx->comp_ch = comp_ch;
io_ctx->orig_io = bdev_io;
switch (bdev_io->type) {
case SPDK_BDEV_IO_TYPE_READ:
spdk_bdev_io_get_buf(bdev_io, comp_read_get_buf_cb,
bdev_io->u.bdev.num_blocks * bdev_io->bdev->blocklen);
return;
case SPDK_BDEV_IO_TYPE_WRITE:
spdk_thread_exec_msg(comp_bdev->reduce_thread, _comp_submit_write, bdev_io);
return;
/* TODO support RESET in future patch in the series */
case SPDK_BDEV_IO_TYPE_RESET:
case SPDK_BDEV_IO_TYPE_WRITE_ZEROES:
case SPDK_BDEV_IO_TYPE_UNMAP:
case SPDK_BDEV_IO_TYPE_FLUSH:
default:
SPDK_ERRLOG("Unknown I/O type %d\n", bdev_io->type);
spdk_bdev_io_complete(io_ctx->orig_io, SPDK_BDEV_IO_STATUS_FAILED);
break;
}
}
static bool
vbdev_compress_io_type_supported(void *ctx, enum spdk_bdev_io_type io_type)
{
struct vbdev_compress *comp_bdev = (struct vbdev_compress *)ctx;
switch (io_type) {
case SPDK_BDEV_IO_TYPE_READ:
case SPDK_BDEV_IO_TYPE_WRITE:
return spdk_bdev_io_type_supported(comp_bdev->base_bdev, io_type);
case SPDK_BDEV_IO_TYPE_UNMAP:
case SPDK_BDEV_IO_TYPE_RESET:
case SPDK_BDEV_IO_TYPE_FLUSH:
case SPDK_BDEV_IO_TYPE_WRITE_ZEROES:
default:
return false;
}
}
/* Resubmission function used by the bdev layer when a queued IO is ready to be
* submitted.
*/
static void
vbdev_compress_resubmit_io(void *arg)
{
struct spdk_bdev_io *bdev_io = (struct spdk_bdev_io *)arg;
struct comp_bdev_io *io_ctx = (struct comp_bdev_io *)bdev_io->driver_ctx;
vbdev_compress_submit_request(io_ctx->ch, bdev_io);
}
/* Used to queue an IO in the event of resource issues. */
static void
vbdev_compress_queue_io(struct spdk_bdev_io *bdev_io)
{
struct comp_bdev_io *io_ctx = (struct comp_bdev_io *)bdev_io->driver_ctx;
int rc;
io_ctx->bdev_io_wait.bdev = bdev_io->bdev;
io_ctx->bdev_io_wait.cb_fn = vbdev_compress_resubmit_io;
io_ctx->bdev_io_wait.cb_arg = bdev_io;
rc = spdk_bdev_queue_io_wait(bdev_io->bdev, io_ctx->comp_bdev->base_ch, &io_ctx->bdev_io_wait);
if (rc) {
SPDK_ERRLOG("Queue io failed in vbdev_compress_queue_io, rc=%d.\n", rc);
assert(false);
spdk_bdev_io_complete(bdev_io, SPDK_BDEV_IO_STATUS_FAILED);
}
}
/* Callback for unregistering the IO device. */
static void
_device_unregister_cb(void *io_device)
{
struct vbdev_compress *comp_bdev = io_device;
/* Done with this comp_bdev. */
pthread_mutex_destroy(&comp_bdev->reduce_lock);
free(comp_bdev->comp_bdev.name);
free(comp_bdev);
}
static void
_vbdev_compress_destruct_cb(void *ctx)
{
struct vbdev_compress *comp_bdev = ctx;
TAILQ_REMOVE(&g_vbdev_comp, comp_bdev, link);
spdk_bdev_module_release_bdev(comp_bdev->base_bdev);
/* Close the underlying bdev on its same opened thread. */
spdk_bdev_close(comp_bdev->base_desc);
comp_bdev->vol = NULL;
if (comp_bdev->orphaned == false) {
spdk_io_device_unregister(comp_bdev, _device_unregister_cb);
} else {
vbdev_compress_delete_done(comp_bdev->delete_ctx, 0);
_device_unregister_cb(comp_bdev);
}
}
static void
vbdev_compress_destruct_cb(void *cb_arg, int reduce_errno)
{
struct vbdev_compress *comp_bdev = (struct vbdev_compress *)cb_arg;
if (reduce_errno) {
SPDK_ERRLOG("number %d\n", reduce_errno);
} else {
if (comp_bdev->thread && comp_bdev->thread != spdk_get_thread()) {
spdk_thread_send_msg(comp_bdev->thread,
_vbdev_compress_destruct_cb, comp_bdev);
} else {
_vbdev_compress_destruct_cb(comp_bdev);
}
}
}
static void
_reduce_destroy_cb(void *ctx, int reduce_errno)
{
struct vbdev_compress *comp_bdev = (struct vbdev_compress *)ctx;
if (reduce_errno) {
SPDK_ERRLOG("number %d\n", reduce_errno);
}
comp_bdev->vol = NULL;
spdk_put_io_channel(comp_bdev->base_ch);
if (comp_bdev->orphaned == false) {
spdk_bdev_unregister(&comp_bdev->comp_bdev, vbdev_compress_delete_done,
comp_bdev->delete_ctx);
} else {
vbdev_compress_destruct_cb((void *)comp_bdev, 0);
}
}
static void
_delete_vol_unload_cb(void *ctx)
{
struct vbdev_compress *comp_bdev = ctx;
/* FIXME: Assert if these conditions are not satisfied for now. */
assert(!comp_bdev->reduce_thread ||
comp_bdev->reduce_thread == spdk_get_thread());
/* reducelib needs a channel to comm with the backing device */
comp_bdev->base_ch = spdk_bdev_get_io_channel(comp_bdev->base_desc);
/* Clean the device before we free our resources. */
spdk_reduce_vol_destroy(&comp_bdev->backing_dev, _reduce_destroy_cb, comp_bdev);
}
/* Called by reduceLib after performing unload vol actions */
static void
delete_vol_unload_cb(void *cb_arg, int reduce_errno)
{
struct vbdev_compress *comp_bdev = (struct vbdev_compress *)cb_arg;
if (reduce_errno) {
SPDK_ERRLOG("number %d\n", reduce_errno);
/* FIXME: callback should be executed. */
return;
}
pthread_mutex_lock(&comp_bdev->reduce_lock);
if (comp_bdev->reduce_thread && comp_bdev->reduce_thread != spdk_get_thread()) {
spdk_thread_send_msg(comp_bdev->reduce_thread,
_delete_vol_unload_cb, comp_bdev);
pthread_mutex_unlock(&comp_bdev->reduce_lock);
} else {
pthread_mutex_unlock(&comp_bdev->reduce_lock);
_delete_vol_unload_cb(comp_bdev);
}
}
const char *
compress_get_name(const struct vbdev_compress *comp_bdev)
{
return comp_bdev->comp_bdev.name;
}
struct vbdev_compress *
compress_bdev_first(void)
{
struct vbdev_compress *comp_bdev;
comp_bdev = TAILQ_FIRST(&g_vbdev_comp);
return comp_bdev;
}
struct vbdev_compress *
compress_bdev_next(struct vbdev_compress *prev)
{
struct vbdev_compress *comp_bdev;
comp_bdev = TAILQ_NEXT(prev, link);
return comp_bdev;
}
bool
compress_has_orphan(const char *name)
{
struct vbdev_compress *comp_bdev;
TAILQ_FOREACH(comp_bdev, &g_vbdev_comp, link) {
if (comp_bdev->orphaned && strcmp(name, comp_bdev->comp_bdev.name) == 0) {
return true;
}
}
return false;
}
/* Called after we've unregistered following a hot remove callback.
* Our finish entry point will be called next.
*/
static int
vbdev_compress_destruct(void *ctx)
{
struct vbdev_compress *comp_bdev = (struct vbdev_compress *)ctx;
if (comp_bdev->vol != NULL) {
/* Tell reducelib that we're done with this volume. */
spdk_reduce_vol_unload(comp_bdev->vol, vbdev_compress_destruct_cb, comp_bdev);
} else {
vbdev_compress_destruct_cb(comp_bdev, 0);
}
return 0;
}
/* We supplied this as an entry point for upper layers who want to communicate to this
* bdev. This is how they get a channel.
*/
static struct spdk_io_channel *
vbdev_compress_get_io_channel(void *ctx)
{
struct vbdev_compress *comp_bdev = (struct vbdev_compress *)ctx;
/* The IO channel code will allocate a channel for us which consists of
* the SPDK channel structure plus the size of our comp_io_channel struct
* that we passed in when we registered our IO device. It will then call
* our channel create callback to populate any elements that we need to
* update.
*/
return spdk_get_io_channel(comp_bdev);
}
/* This is the output for bdev_get_bdevs() for this vbdev */
static int
vbdev_compress_dump_info_json(void *ctx, struct spdk_json_write_ctx *w)
{
struct vbdev_compress *comp_bdev = (struct vbdev_compress *)ctx;
spdk_json_write_name(w, "compress");
spdk_json_write_object_begin(w);
spdk_json_write_named_string(w, "name", spdk_bdev_get_name(&comp_bdev->comp_bdev));
spdk_json_write_named_string(w, "base_bdev_name", spdk_bdev_get_name(comp_bdev->base_bdev));
spdk_json_write_object_end(w);
return 0;
}
/* This is used to generate JSON that can configure this module to its current state. */
static int
vbdev_compress_config_json(struct spdk_json_write_ctx *w)
{
struct vbdev_compress *comp_bdev;
const char *module_name = NULL;
int rc;
rc = spdk_accel_get_opc_module_name(ACCEL_OPC_COMPRESS, &module_name);
if (rc) {
SPDK_ERRLOG("error getting module name (%d)\n", rc);
}
TAILQ_FOREACH(comp_bdev, &g_vbdev_comp, link) {
spdk_json_write_object_begin(w);
spdk_json_write_named_string(w, "method", "bdev_compress_create");
spdk_json_write_named_object_begin(w, "params");
spdk_json_write_named_string(w, "base_bdev_name", spdk_bdev_get_name(comp_bdev->base_bdev));
spdk_json_write_named_string(w, "name", spdk_bdev_get_name(&comp_bdev->comp_bdev));
spdk_json_write_object_end(w);
spdk_json_write_object_end(w);
}
return 0;
}
static void
_vbdev_reduce_init_cb(void *ctx)
{
struct vbdev_compress *meta_ctx = ctx;
int rc;
assert(meta_ctx->base_desc != NULL);
/* We're done with metadata operations */
spdk_put_io_channel(meta_ctx->base_ch);
if (meta_ctx->vol) {
rc = vbdev_compress_claim(meta_ctx);
if (rc == 0) {
return;
}
}
/* Close the underlying bdev on its same opened thread. */
spdk_bdev_close(meta_ctx->base_desc);
free(meta_ctx);
}
/* Callback from reduce for when init is complete. We'll pass the vbdev_comp struct
* used for initial metadata operations to claim where it will be further filled out
* and added to the global list.
*/
static void
vbdev_reduce_init_cb(void *cb_arg, struct spdk_reduce_vol *vol, int reduce_errno)
{
struct vbdev_compress *meta_ctx = cb_arg;
if (reduce_errno == 0) {
meta_ctx->vol = vol;
} else {
SPDK_ERRLOG("for vol %s, error %u\n",
spdk_bdev_get_name(meta_ctx->base_bdev), reduce_errno);
}
if (meta_ctx->thread && meta_ctx->thread != spdk_get_thread()) {
spdk_thread_send_msg(meta_ctx->thread, _vbdev_reduce_init_cb, meta_ctx);
} else {
_vbdev_reduce_init_cb(meta_ctx);
}
}
/* Callback for the function used by reduceLib to perform IO to/from the backing device. We just
* call the callback provided by reduceLib when it called the read/write/unmap function and
* free the bdev_io.
*/
static void
comp_reduce_io_cb(struct spdk_bdev_io *bdev_io, bool success, void *arg)
{
struct spdk_reduce_vol_cb_args *cb_args = arg;
int reduce_errno;
if (success) {
reduce_errno = 0;
} else {
reduce_errno = -EIO;
}
spdk_bdev_free_io(bdev_io);
cb_args->cb_fn(cb_args->cb_arg, reduce_errno);
}
/* This is the function provided to the reduceLib for sending reads directly to
* the backing device.
*/
static void
_comp_reduce_readv(struct spdk_reduce_backing_dev *dev, struct iovec *iov, int iovcnt,
uint64_t lba, uint32_t lba_count, struct spdk_reduce_vol_cb_args *args)
{
struct vbdev_compress *comp_bdev = SPDK_CONTAINEROF(dev, struct vbdev_compress,
backing_dev);
int rc;
rc = spdk_bdev_readv_blocks(comp_bdev->base_desc, comp_bdev->base_ch,
iov, iovcnt, lba, lba_count,
comp_reduce_io_cb,
args);
if (rc) {
if (rc == -ENOMEM) {
SPDK_ERRLOG("No memory, start to queue io.\n");
/* TODO: there's no bdev_io to queue */
} else {
SPDK_ERRLOG("submitting readv request\n");
}
args->cb_fn(args->cb_arg, rc);
}
}
/* This is the function provided to the reduceLib for sending writes directly to
* the backing device.
*/
static void
_comp_reduce_writev(struct spdk_reduce_backing_dev *dev, struct iovec *iov, int iovcnt,
uint64_t lba, uint32_t lba_count, struct spdk_reduce_vol_cb_args *args)
{
struct vbdev_compress *comp_bdev = SPDK_CONTAINEROF(dev, struct vbdev_compress,
backing_dev);
int rc;
rc = spdk_bdev_writev_blocks(comp_bdev->base_desc, comp_bdev->base_ch,
iov, iovcnt, lba, lba_count,
comp_reduce_io_cb,
args);
if (rc) {
if (rc == -ENOMEM) {
SPDK_ERRLOG("No memory, start to queue io.\n");
/* TODO: there's no bdev_io to queue */
} else {
SPDK_ERRLOG("error submitting writev request\n");
}
args->cb_fn(args->cb_arg, rc);
}
}
/* This is the function provided to the reduceLib for sending unmaps directly to
* the backing device.
*/
static void
_comp_reduce_unmap(struct spdk_reduce_backing_dev *dev,
uint64_t lba, uint32_t lba_count, struct spdk_reduce_vol_cb_args *args)
{
struct vbdev_compress *comp_bdev = SPDK_CONTAINEROF(dev, struct vbdev_compress,
backing_dev);
int rc;
rc = spdk_bdev_unmap_blocks(comp_bdev->base_desc, comp_bdev->base_ch,
lba, lba_count,
comp_reduce_io_cb,
args);
if (rc) {
if (rc == -ENOMEM) {
SPDK_ERRLOG("No memory, start to queue io.\n");
/* TODO: there's no bdev_io to queue */
} else {
SPDK_ERRLOG("submitting unmap request\n");
}
args->cb_fn(args->cb_arg, rc);
}
}
/* Called by reduceLib after performing unload vol actions following base bdev hotremove */
static void
bdev_hotremove_vol_unload_cb(void *cb_arg, int reduce_errno)
{
struct vbdev_compress *comp_bdev = (struct vbdev_compress *)cb_arg;
if (reduce_errno) {
SPDK_ERRLOG("number %d\n", reduce_errno);
}
comp_bdev->vol = NULL;
spdk_bdev_unregister(&comp_bdev->comp_bdev, NULL, NULL);
}
static void
vbdev_compress_base_bdev_hotremove_cb(struct spdk_bdev *bdev_find)
{
struct vbdev_compress *comp_bdev, *tmp;
TAILQ_FOREACH_SAFE(comp_bdev, &g_vbdev_comp, link, tmp) {
if (bdev_find == comp_bdev->base_bdev) {
/* Tell reduceLib that we're done with this volume. */
spdk_reduce_vol_unload(comp_bdev->vol, bdev_hotremove_vol_unload_cb, comp_bdev);
}
}
}
/* Called when the underlying base bdev triggers asynchronous event such as bdev removal. */
static void
vbdev_compress_base_bdev_event_cb(enum spdk_bdev_event_type type, struct spdk_bdev *bdev,
void *event_ctx)
{
switch (type) {
case SPDK_BDEV_EVENT_REMOVE:
vbdev_compress_base_bdev_hotremove_cb(bdev);
break;
default:
SPDK_NOTICELOG("Unsupported bdev event: type %d\n", type);
break;
}
}
/* TODO: determine which parms we want user configurable, HC for now
* params.vol_size
* params.chunk_size
* compression PMD, algorithm, window size, comp level, etc.
* DEV_MD_PATH
*/
/* Common function for init and load to allocate and populate the minimal
* information for reducelib to init or load.
*/
struct vbdev_compress *
_prepare_for_load_init(struct spdk_bdev_desc *bdev_desc, uint32_t lb_size)
{
struct vbdev_compress *meta_ctx;
struct spdk_bdev *bdev;
meta_ctx = calloc(1, sizeof(struct vbdev_compress));
if (meta_ctx == NULL) {
SPDK_ERRLOG("failed to alloc init contexts\n");
return NULL;
}
meta_ctx->backing_dev.unmap = _comp_reduce_unmap;
meta_ctx->backing_dev.readv = _comp_reduce_readv;
meta_ctx->backing_dev.writev = _comp_reduce_writev;
meta_ctx->backing_dev.compress = _comp_reduce_compress;
meta_ctx->backing_dev.decompress = _comp_reduce_decompress;
meta_ctx->base_desc = bdev_desc;
bdev = spdk_bdev_desc_get_bdev(bdev_desc);
meta_ctx->base_bdev = bdev;
meta_ctx->backing_dev.blocklen = bdev->blocklen;
meta_ctx->backing_dev.blockcnt = bdev->blockcnt;
meta_ctx->params.chunk_size = CHUNK_SIZE;
if (lb_size == 0) {
meta_ctx->params.logical_block_size = bdev->blocklen;
} else {
meta_ctx->params.logical_block_size = lb_size;
}
meta_ctx->params.backing_io_unit_size = BACKING_IO_SZ;
return meta_ctx;
}
/* Call reducelib to initialize a new volume */
static int
vbdev_init_reduce(const char *bdev_name, const char *pm_path, uint32_t lb_size)
{
struct spdk_bdev_desc *bdev_desc = NULL;
struct vbdev_compress *meta_ctx;
int rc;
rc = spdk_bdev_open_ext(bdev_name, true, vbdev_compress_base_bdev_event_cb,
NULL, &bdev_desc);
if (rc) {
SPDK_ERRLOG("could not open bdev %s\n", bdev_name);
return rc;
}
meta_ctx = _prepare_for_load_init(bdev_desc, lb_size);
if (meta_ctx == NULL) {
spdk_bdev_close(bdev_desc);
return -EINVAL;
}
/* Save the thread where the base device is opened */
meta_ctx->thread = spdk_get_thread();
meta_ctx->base_ch = spdk_bdev_get_io_channel(meta_ctx->base_desc);
spdk_reduce_vol_init(&meta_ctx->params, &meta_ctx->backing_dev,
pm_path,
vbdev_reduce_init_cb,
meta_ctx);
return 0;
}
/* We provide this callback for the SPDK channel code to create a channel using
* the channel struct we provided in our module get_io_channel() entry point. Here
* we get and save off an underlying base channel of the device below us so that
* we can communicate with the base bdev on a per channel basis. If we needed
* our own poller for this vbdev, we'd register it here.
*/
static int
comp_bdev_ch_create_cb(void *io_device, void *ctx_buf)
{
struct vbdev_compress *comp_bdev = io_device;
/* Now set the reduce channel if it's not already set. */
pthread_mutex_lock(&comp_bdev->reduce_lock);
if (comp_bdev->ch_count == 0) {
/* We use this queue to track outstanding IO in our layer. */
TAILQ_INIT(&comp_bdev->pending_comp_ios);
/* We use this to queue up compression operations as needed. */
TAILQ_INIT(&comp_bdev->queued_comp_ops);
comp_bdev->base_ch = spdk_bdev_get_io_channel(comp_bdev->base_desc);
comp_bdev->reduce_thread = spdk_get_thread();
comp_bdev->accel_channel = spdk_accel_get_io_channel();
}
comp_bdev->ch_count++;
pthread_mutex_unlock(&comp_bdev->reduce_lock);
return 0;
}
static void
_channel_cleanup(struct vbdev_compress *comp_bdev)
{
spdk_put_io_channel(comp_bdev->base_ch);
spdk_put_io_channel(comp_bdev->accel_channel);
comp_bdev->reduce_thread = NULL;
}
/* Used to reroute destroy_ch to the correct thread */
static void
_comp_bdev_ch_destroy_cb(void *arg)
{
struct vbdev_compress *comp_bdev = arg;
pthread_mutex_lock(&comp_bdev->reduce_lock);
_channel_cleanup(comp_bdev);
pthread_mutex_unlock(&comp_bdev->reduce_lock);
}
/* We provide this callback for the SPDK channel code to destroy a channel
* created with our create callback. We just need to undo anything we did
* when we created. If this bdev used its own poller, we'd unregister it here.
*/
static void
comp_bdev_ch_destroy_cb(void *io_device, void *ctx_buf)
{
struct vbdev_compress *comp_bdev = io_device;
pthread_mutex_lock(&comp_bdev->reduce_lock);
comp_bdev->ch_count--;
if (comp_bdev->ch_count == 0) {
/* Send this request to the thread where the channel was created. */
if (comp_bdev->reduce_thread != spdk_get_thread()) {
spdk_thread_send_msg(comp_bdev->reduce_thread,
_comp_bdev_ch_destroy_cb, comp_bdev);
} else {
_channel_cleanup(comp_bdev);
}
}
pthread_mutex_unlock(&comp_bdev->reduce_lock);
}
/* RPC entry point for compression vbdev creation. */
int
create_compress_bdev(const char *bdev_name, const char *pm_path, uint32_t lb_size)
{
struct vbdev_compress *comp_bdev = NULL;
if ((lb_size != 0) && (lb_size != LB_SIZE_4K) && (lb_size != LB_SIZE_512B)) {
SPDK_ERRLOG("Logical block size must be 512 or 4096\n");
return -EINVAL;
}
TAILQ_FOREACH(comp_bdev, &g_vbdev_comp, link) {
if (strcmp(bdev_name, comp_bdev->base_bdev->name) == 0) {
SPDK_ERRLOG("Bass bdev %s already being used for a compress bdev\n", bdev_name);
return -EBUSY;
}
}
return vbdev_init_reduce(bdev_name, pm_path, lb_size);
}
static int
vbdev_compress_init(void)
{
return 0;
}
/* Called when the entire module is being torn down. */
static void
vbdev_compress_finish(void)
{
/* TODO: unload vol in a future patch */
}
/* During init we'll be asked how much memory we'd like passed to us
* in bev_io structures as context. Here's where we specify how
* much context we want per IO.
*/
static int
vbdev_compress_get_ctx_size(void)
{
return sizeof(struct comp_bdev_io);
}
/* When we register our bdev this is how we specify our entry points. */
static const struct spdk_bdev_fn_table vbdev_compress_fn_table = {
.destruct = vbdev_compress_destruct,
.submit_request = vbdev_compress_submit_request,
.io_type_supported = vbdev_compress_io_type_supported,
.get_io_channel = vbdev_compress_get_io_channel,
.dump_info_json = vbdev_compress_dump_info_json,
.write_config_json = NULL,
};
static struct spdk_bdev_module compress_if = {
.name = "compress",
.module_init = vbdev_compress_init,
.get_ctx_size = vbdev_compress_get_ctx_size,
.examine_disk = vbdev_compress_examine,
.module_fini = vbdev_compress_finish,
.config_json = vbdev_compress_config_json
};
SPDK_BDEV_MODULE_REGISTER(compress, &compress_if)
static int _set_compbdev_name(struct vbdev_compress *comp_bdev)
{
struct spdk_bdev_alias *aliases;
if (!TAILQ_EMPTY(spdk_bdev_get_aliases(comp_bdev->base_bdev))) {
aliases = TAILQ_FIRST(spdk_bdev_get_aliases(comp_bdev->base_bdev));
comp_bdev->comp_bdev.name = spdk_sprintf_alloc("COMP_%s", aliases->alias.name);
if (!comp_bdev->comp_bdev.name) {
SPDK_ERRLOG("could not allocate comp_bdev name for alias\n");
return -ENOMEM;
}
} else {
comp_bdev->comp_bdev.name = spdk_sprintf_alloc("COMP_%s", comp_bdev->base_bdev->name);
if (!comp_bdev->comp_bdev.name) {
SPDK_ERRLOG("could not allocate comp_bdev name for unique name\n");
return -ENOMEM;
}
}
return 0;
}
static int
vbdev_compress_claim(struct vbdev_compress *comp_bdev)
{
int rc;
if (_set_compbdev_name(comp_bdev)) {
return -EINVAL;
}
/* Note: some of the fields below will change in the future - for example,
* blockcnt specifically will not match (the compressed volume size will
* be slightly less than the base bdev size)
*/
comp_bdev->comp_bdev.product_name = COMP_BDEV_NAME;
comp_bdev->comp_bdev.write_cache = comp_bdev->base_bdev->write_cache;
comp_bdev->comp_bdev.optimal_io_boundary =
comp_bdev->params.chunk_size / comp_bdev->params.logical_block_size;
comp_bdev->comp_bdev.split_on_optimal_io_boundary = true;
comp_bdev->comp_bdev.blocklen = comp_bdev->params.logical_block_size;
comp_bdev->comp_bdev.blockcnt = comp_bdev->params.vol_size / comp_bdev->comp_bdev.blocklen;
assert(comp_bdev->comp_bdev.blockcnt > 0);
/* This is the context that is passed to us when the bdev
* layer calls in so we'll save our comp_bdev node here.
*/
comp_bdev->comp_bdev.ctxt = comp_bdev;
comp_bdev->comp_bdev.fn_table = &vbdev_compress_fn_table;
comp_bdev->comp_bdev.module = &compress_if;
pthread_mutex_init(&comp_bdev->reduce_lock, NULL);
/* Save the thread where the base device is opened */
comp_bdev->thread = spdk_get_thread();
spdk_io_device_register(comp_bdev, comp_bdev_ch_create_cb, comp_bdev_ch_destroy_cb,
sizeof(struct comp_io_channel),
comp_bdev->comp_bdev.name);
rc = spdk_bdev_module_claim_bdev(comp_bdev->base_bdev, comp_bdev->base_desc,
comp_bdev->comp_bdev.module);
if (rc) {
SPDK_ERRLOG("could not claim bdev %s\n", spdk_bdev_get_name(comp_bdev->base_bdev));
goto error_claim;
}
rc = spdk_bdev_register(&comp_bdev->comp_bdev);
if (rc < 0) {
SPDK_ERRLOG("trying to register bdev\n");
goto error_bdev_register;
}
TAILQ_INSERT_TAIL(&g_vbdev_comp, comp_bdev, link);
SPDK_NOTICELOG("registered io_device and virtual bdev for: %s\n", comp_bdev->comp_bdev.name);
return 0;
/* Error cleanup paths. */
error_bdev_register:
spdk_bdev_module_release_bdev(comp_bdev->base_bdev);
error_claim:
spdk_io_device_unregister(comp_bdev, NULL);
free(comp_bdev->comp_bdev.name);
return rc;
}
static void
_vbdev_compress_delete_done(void *_ctx)
{
struct vbdev_comp_delete_ctx *ctx = _ctx;
ctx->cb_fn(ctx->cb_arg, ctx->cb_rc);
free(ctx);
}
static void
vbdev_compress_delete_done(void *cb_arg, int bdeverrno)
{
struct vbdev_comp_delete_ctx *ctx = cb_arg;
ctx->cb_rc = bdeverrno;
if (ctx->orig_thread != spdk_get_thread()) {
spdk_thread_send_msg(ctx->orig_thread, _vbdev_compress_delete_done, ctx);
} else {
_vbdev_compress_delete_done(ctx);
}
}
void
bdev_compress_delete(const char *name, spdk_delete_compress_complete cb_fn, void *cb_arg)
{
struct vbdev_compress *comp_bdev = NULL;
struct vbdev_comp_delete_ctx *ctx;
TAILQ_FOREACH(comp_bdev, &g_vbdev_comp, link) {
if (strcmp(name, comp_bdev->comp_bdev.name) == 0) {
break;
}
}
if (comp_bdev == NULL) {
cb_fn(cb_arg, -ENODEV);
return;
}
ctx = calloc(1, sizeof(*ctx));
if (ctx == NULL) {
SPDK_ERRLOG("Failed to allocate delete context\n");
cb_fn(cb_arg, -ENOMEM);
return;
}
/* Save these for after the vol is destroyed. */
ctx->cb_fn = cb_fn;
ctx->cb_arg = cb_arg;
ctx->orig_thread = spdk_get_thread();
comp_bdev->delete_ctx = ctx;
/* Tell reducelib that we're done with this volume. */
if (comp_bdev->orphaned == false) {
spdk_reduce_vol_unload(comp_bdev->vol, delete_vol_unload_cb, comp_bdev);
} else {
delete_vol_unload_cb(comp_bdev, 0);
}
}
static void
_vbdev_reduce_load_cb(void *ctx)
{
struct vbdev_compress *meta_ctx = ctx;
int rc;
assert(meta_ctx->base_desc != NULL);
/* Done with metadata operations */
spdk_put_io_channel(meta_ctx->base_ch);
if (meta_ctx->reduce_errno == 0) {
rc = vbdev_compress_claim(meta_ctx);
if (rc != 0) {
goto err;
}
} else if (meta_ctx->reduce_errno == -ENOENT) {
if (_set_compbdev_name(meta_ctx)) {
goto err;
}
/* Save the thread where the base device is opened */
meta_ctx->thread = spdk_get_thread();
meta_ctx->comp_bdev.module = &compress_if;
pthread_mutex_init(&meta_ctx->reduce_lock, NULL);
rc = spdk_bdev_module_claim_bdev(meta_ctx->base_bdev, meta_ctx->base_desc,
meta_ctx->comp_bdev.module);
if (rc) {
SPDK_ERRLOG("could not claim bdev %s\n", spdk_bdev_get_name(meta_ctx->base_bdev));
free(meta_ctx->comp_bdev.name);
goto err;
}
meta_ctx->orphaned = true;
TAILQ_INSERT_TAIL(&g_vbdev_comp, meta_ctx, link);
} else {
if (meta_ctx->reduce_errno != -EILSEQ) {
SPDK_ERRLOG("for vol %s, error %u\n",
spdk_bdev_get_name(meta_ctx->base_bdev), meta_ctx->reduce_errno);
}
goto err;
}
spdk_bdev_module_examine_done(&compress_if);
return;
err:
/* Close the underlying bdev on its same opened thread. */
spdk_bdev_close(meta_ctx->base_desc);
free(meta_ctx);
spdk_bdev_module_examine_done(&compress_if);
}
/* Callback from reduce for then load is complete. We'll pass the vbdev_comp struct
* used for initial metadata operations to claim where it will be further filled out
* and added to the global list.
*/
static void
vbdev_reduce_load_cb(void *cb_arg, struct spdk_reduce_vol *vol, int reduce_errno)
{
struct vbdev_compress *meta_ctx = cb_arg;
if (reduce_errno == 0) {
/* Update information following volume load. */
meta_ctx->vol = vol;
memcpy(&meta_ctx->params, spdk_reduce_vol_get_params(vol),
sizeof(struct spdk_reduce_vol_params));
}
meta_ctx->reduce_errno = reduce_errno;
if (meta_ctx->thread && meta_ctx->thread != spdk_get_thread()) {
spdk_thread_send_msg(meta_ctx->thread, _vbdev_reduce_load_cb, meta_ctx);
} else {
_vbdev_reduce_load_cb(meta_ctx);
}
}
/* Examine_disk entry point: will do a metadata load to see if this is ours,
* and if so will go ahead and claim it.
*/
static void
vbdev_compress_examine(struct spdk_bdev *bdev)
{
struct spdk_bdev_desc *bdev_desc = NULL;
struct vbdev_compress *meta_ctx;
int rc;
if (strcmp(bdev->product_name, COMP_BDEV_NAME) == 0) {
spdk_bdev_module_examine_done(&compress_if);
return;
}
rc = spdk_bdev_open_ext(spdk_bdev_get_name(bdev), false,
vbdev_compress_base_bdev_event_cb, NULL, &bdev_desc);
if (rc) {
SPDK_ERRLOG("could not open bdev %s\n", spdk_bdev_get_name(bdev));
spdk_bdev_module_examine_done(&compress_if);
return;
}
meta_ctx = _prepare_for_load_init(bdev_desc, 0);
if (meta_ctx == NULL) {
spdk_bdev_close(bdev_desc);
spdk_bdev_module_examine_done(&compress_if);
return;
}
/* Save the thread where the base device is opened */
meta_ctx->thread = spdk_get_thread();
meta_ctx->base_ch = spdk_bdev_get_io_channel(meta_ctx->base_desc);
spdk_reduce_vol_load(&meta_ctx->backing_dev, vbdev_reduce_load_cb, meta_ctx);
}
SPDK_LOG_REGISTER_COMPONENT(vbdev_compress)