b46d79bdb8
This patch adds infrastructure for managing reads and writes to the underlying storage layer for the deduplication index. The deduplication index uses dm-bufio for all of its reads and writes, so part of this infrastructure is managing the various dm-bufio clients required. It also adds the buffered reader and buffered writer abstractions, which simplify reading and writing metadata structures that span several blocks. This patch also includes structures and utilities for encoding and decoding all of the deduplication index metadata, collectively called the index layout. 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: Thomas Jaskiewicz <tom@jaskiewicz.us> Signed-off-by: Thomas Jaskiewicz <tom@jaskiewicz.us> Co-developed-by: John Wiele <jwiele@redhat.com> Signed-off-by: John Wiele <jwiele@redhat.com> Signed-off-by: Matthew Sakai <msakai@redhat.com> Signed-off-by: Mike Snitzer <snitzer@kernel.org>
65 lines
2.0 KiB
C
65 lines
2.0 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright 2023 Red Hat
|
|
*/
|
|
|
|
#ifndef UDS_IO_FACTORY_H
|
|
#define UDS_IO_FACTORY_H
|
|
|
|
#include <linux/dm-bufio.h>
|
|
|
|
/*
|
|
* The I/O factory manages all low-level I/O operations to the underlying storage device. Its main
|
|
* clients are the index layout and the volume. The buffered reader and buffered writer interfaces
|
|
* are helpers for accessing data in a contiguous range of storage blocks.
|
|
*/
|
|
|
|
struct buffered_reader;
|
|
struct buffered_writer;
|
|
|
|
struct io_factory;
|
|
|
|
enum {
|
|
UDS_BLOCK_SIZE = 4096,
|
|
SECTORS_PER_BLOCK = UDS_BLOCK_SIZE >> SECTOR_SHIFT,
|
|
};
|
|
|
|
int __must_check uds_make_io_factory(struct block_device *bdev,
|
|
struct io_factory **factory_ptr);
|
|
|
|
int __must_check uds_replace_storage(struct io_factory *factory,
|
|
struct block_device *bdev);
|
|
|
|
void uds_put_io_factory(struct io_factory *factory);
|
|
|
|
size_t __must_check uds_get_writable_size(struct io_factory *factory);
|
|
|
|
int __must_check uds_make_bufio(struct io_factory *factory, off_t block_offset,
|
|
size_t block_size, unsigned int reserved_buffers,
|
|
struct dm_bufio_client **client_ptr);
|
|
|
|
int __must_check uds_make_buffered_reader(struct io_factory *factory, off_t offset,
|
|
u64 block_count,
|
|
struct buffered_reader **reader_ptr);
|
|
|
|
void uds_free_buffered_reader(struct buffered_reader *reader);
|
|
|
|
int __must_check uds_read_from_buffered_reader(struct buffered_reader *reader, u8 *data,
|
|
size_t length);
|
|
|
|
int __must_check uds_verify_buffered_data(struct buffered_reader *reader, const u8 *value,
|
|
size_t length);
|
|
|
|
int __must_check uds_make_buffered_writer(struct io_factory *factory, off_t offset,
|
|
u64 block_count,
|
|
struct buffered_writer **writer_ptr);
|
|
|
|
void uds_free_buffered_writer(struct buffered_writer *buffer);
|
|
|
|
int __must_check uds_write_to_buffered_writer(struct buffered_writer *writer,
|
|
const u8 *data, size_t length);
|
|
|
|
int __must_check uds_flush_buffered_writer(struct buffered_writer *writer);
|
|
|
|
#endif /* UDS_IO_FACTORY_H */
|