3d2a3ee4df
Support injecting data corruption for processing read/write I/O. Add two parameters, corrupt_offset and corrupt_value, and an error type corrupt_data. For write I/O, inject data corruption before submitting write I/O to the underlying bdev. For read I/O, inject data corruption after read I/O successfully returned. Cause the data corruption by xoring the value at the corrupt_offset with the corrupt_value. corrupt_value is required to be non-zero to cause data corruption necessarily. Signed-off-by: Shuhei Matsumoto <smatsumoto@nvidia.com> Change-Id: I67d8d252b06d7a221413e74996f7f894e6519556 Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/15028 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Aleksey Marchuk <alexeymar@nvidia.com> Community-CI: Mellanox Build Bot
56 lines
1.4 KiB
C
56 lines
1.4 KiB
C
/* SPDX-License-Identifier: BSD-3-Clause
|
|
* Copyright (c) Intel Corporation.
|
|
* All rights reserved.
|
|
*/
|
|
|
|
#ifndef SPDK_VBDEV_ERROR_H
|
|
#define SPDK_VBDEV_ERROR_H
|
|
|
|
#include "spdk/stdinc.h"
|
|
#include "spdk/bdev.h"
|
|
|
|
enum vbdev_error_type {
|
|
VBDEV_IO_FAILURE = 1,
|
|
VBDEV_IO_PENDING,
|
|
VBDEV_IO_CORRUPT_DATA,
|
|
};
|
|
|
|
typedef void (*spdk_delete_error_complete)(void *cb_arg, int bdeverrno);
|
|
|
|
/**
|
|
* Create a vbdev on the base bdev to inject error into it.
|
|
*
|
|
* \param base_bdev_name Name of the base bdev.
|
|
* \return 0 on success or negative on failure.
|
|
*/
|
|
int vbdev_error_create(const char *base_bdev_name);
|
|
|
|
/**
|
|
* Delete vbdev used to inject errors.
|
|
*
|
|
* \param error_vbdev_name Name of the error vbdev.
|
|
* \param cb_fn Function to call after deletion.
|
|
* \param cb_arg Arguments to pass to cb_fn.
|
|
*/
|
|
void vbdev_error_delete(const char *error_vbdev_name, spdk_delete_error_complete cb_fn,
|
|
void *cb_arg);
|
|
|
|
struct vbdev_error_inject_opts {
|
|
uint32_t io_type;
|
|
uint32_t error_type;
|
|
uint32_t error_num;
|
|
uint64_t corrupt_offset;
|
|
uint8_t corrupt_value;
|
|
};
|
|
|
|
/**
|
|
* Inject error to the base bdev. Users can specify which IO type error is injected,
|
|
* what type of error is injected, and how many errors are injected.
|
|
*
|
|
* \param name Name of the base bdev into which error is injected.
|
|
* \param opts Options for error injection.
|
|
*/
|
|
int vbdev_error_inject_error(char *name, const struct vbdev_error_inject_opts *opts);
|
|
|
|
#endif /* SPDK_VBDEV_ERROR_H */
|