Blame view
drivers/md/dm-bufio.h
3.94 KB
95d402f05 dm: add bufio |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 |
/* * Copyright (C) 2009-2011 Red Hat, Inc. * * Author: Mikulas Patocka <mpatocka@redhat.com> * * This file is released under the GPL. */ #ifndef DM_BUFIO_H #define DM_BUFIO_H #include <linux/blkdev.h> #include <linux/types.h> /*----------------------------------------------------------------*/ struct dm_bufio_client; struct dm_buffer; /* * Create a buffered IO cache on a given device */ struct dm_bufio_client * dm_bufio_client_create(struct block_device *bdev, unsigned block_size, unsigned reserved_buffers, unsigned aux_size, void (*alloc_callback)(struct dm_buffer *), void (*write_callback)(struct dm_buffer *)); /* * Release a buffered IO cache. */ void dm_bufio_client_destroy(struct dm_bufio_client *c); /* * WARNING: to avoid deadlocks, these conditions are observed: * * - At most one thread can hold at most "reserved_buffers" simultaneously. * - Each other threads can hold at most one buffer. * - Threads which call only dm_bufio_get can hold unlimited number of * buffers. */ /* * Read a given block from disk. Returns pointer to data. Returns a * pointer to dm_buffer that can be used to release the buffer or to make * it dirty. */ void *dm_bufio_read(struct dm_bufio_client *c, sector_t block, struct dm_buffer **bp); /* * Like dm_bufio_read, but return buffer from cache, don't read * it. If the buffer is not in the cache, return NULL. */ void *dm_bufio_get(struct dm_bufio_client *c, sector_t block, struct dm_buffer **bp); /* * Like dm_bufio_read, but don't read anything from the disk. It is * expected that the caller initializes the buffer and marks it dirty. */ void *dm_bufio_new(struct dm_bufio_client *c, sector_t block, struct dm_buffer **bp); /* |
a66cc28f5 dm bufio: prefetch |
66 67 68 69 70 71 72 73 |
* Prefetch the specified blocks to the cache. * The function starts to read the blocks and returns without waiting for * I/O to finish. */ void dm_bufio_prefetch(struct dm_bufio_client *c, sector_t block, unsigned n_blocks); /* |
95d402f05 dm: add bufio |
74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 |
* Release a reference obtained with dm_bufio_{read,get,new}. The data * pointer and dm_buffer pointer is no longer valid after this call. */ void dm_bufio_release(struct dm_buffer *b); /* * Mark a buffer dirty. It should be called after the buffer is modified. * * In case of memory pressure, the buffer may be written after * dm_bufio_mark_buffer_dirty, but before dm_bufio_write_dirty_buffers. So * dm_bufio_write_dirty_buffers guarantees that the buffer is on-disk but * the actual writing may occur earlier. */ void dm_bufio_mark_buffer_dirty(struct dm_buffer *b); /* * Initiate writing of dirty buffers, without waiting for completion. */ void dm_bufio_write_dirty_buffers_async(struct dm_bufio_client *c); /* * Write all dirty buffers. Guarantees that all dirty buffers created prior * to this call are on disk when this call exits. */ int dm_bufio_write_dirty_buffers(struct dm_bufio_client *c); /* * Send an empty write barrier to the device to flush hardware disk cache. */ int dm_bufio_issue_flush(struct dm_bufio_client *c); /* * Like dm_bufio_release but also move the buffer to the new * block. dm_bufio_write_dirty_buffers is needed to commit the new block. */ void dm_bufio_release_move(struct dm_buffer *b, sector_t new_block); |
55494bf29 dm snapshot: use ... |
110 111 112 113 114 115 |
/* * Free the given buffer. * This is just a hint, if the buffer is in use or dirty, this function * does nothing. */ void dm_bufio_forget(struct dm_bufio_client *c, sector_t block); |
55b082e61 dm snapshot: use ... |
116 117 118 119 |
/* * Set the minimum number of buffers before cleanup happens. */ void dm_bufio_set_minimum_buffers(struct dm_bufio_client *c, unsigned n); |
95d402f05 dm: add bufio |
120 121 122 123 124 125 126 127 128 129 |
unsigned dm_bufio_get_block_size(struct dm_bufio_client *c); sector_t dm_bufio_get_device_size(struct dm_bufio_client *c); sector_t dm_bufio_get_block_number(struct dm_buffer *b); void *dm_bufio_get_block_data(struct dm_buffer *b); void *dm_bufio_get_aux_data(struct dm_buffer *b); struct dm_bufio_client *dm_bufio_get_client(struct dm_buffer *b); /*----------------------------------------------------------------*/ #endif |