1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * Copyright (C) 2007 Oracle. All rights reserved. 4 */ 5 6 #ifndef BTRFS_ORDERED_DATA_H 7 #define BTRFS_ORDERED_DATA_H 8 9 struct btrfs_ordered_sum { 10 /* 11 * Logical start address and length for of the blocks covered by 12 * the sums array. 13 */ 14 u64 logical; 15 u32 len; 16 17 struct list_head list; 18 /* last field is a variable length array of csums */ 19 u8 sums[]; 20 }; 21 22 /* 23 * Bits for btrfs_ordered_extent::flags. 24 * 25 * BTRFS_ORDERED_IO_DONE is set when all of the blocks are written. 26 * It is used to make sure metadata is inserted into the tree only once 27 * per extent. 28 * 29 * BTRFS_ORDERED_COMPLETE is set when the extent is removed from the 30 * rbtree, just before waking any waiters. It is used to indicate the 31 * IO is done and any metadata is inserted into the tree. 32 */ 33 enum { 34 /* 35 * Different types for ordered extents, one and only one of the 4 types 36 * need to be set when creating ordered extent. 37 * 38 * REGULAR: For regular non-compressed COW write 39 * NOCOW: For NOCOW write into existing non-hole extent 40 * PREALLOC: For NOCOW write into preallocated extent 41 * COMPRESSED: For compressed COW write 42 */ 43 BTRFS_ORDERED_REGULAR, 44 BTRFS_ORDERED_NOCOW, 45 BTRFS_ORDERED_PREALLOC, 46 BTRFS_ORDERED_COMPRESSED, 47 48 /* 49 * Extra bit for direct io, can only be set for 50 * REGULAR/NOCOW/PREALLOC. No direct io for compressed extent. 51 */ 52 BTRFS_ORDERED_DIRECT, 53 54 /* Extra status bits for ordered extents */ 55 56 /* set when all the pages are written */ 57 BTRFS_ORDERED_IO_DONE, 58 /* set when removed from the tree */ 59 BTRFS_ORDERED_COMPLETE, 60 /* We had an io error when writing this out */ 61 BTRFS_ORDERED_IOERR, 62 /* Set when we have to truncate an extent */ 63 BTRFS_ORDERED_TRUNCATED, 64 /* Used during fsync to track already logged extents */ 65 BTRFS_ORDERED_LOGGED, 66 /* We have already logged all the csums of the ordered extent */ 67 BTRFS_ORDERED_LOGGED_CSUM, 68 /* We wait for this extent to complete in the current transaction */ 69 BTRFS_ORDERED_PENDING, 70 /* BTRFS_IOC_ENCODED_WRITE */ 71 BTRFS_ORDERED_ENCODED, 72 }; 73 74 /* BTRFS_ORDERED_* flags that specify the type of the extent. */ 75 #define BTRFS_ORDERED_TYPE_FLAGS ((1UL << BTRFS_ORDERED_REGULAR) | \ 76 (1UL << BTRFS_ORDERED_NOCOW) | \ 77 (1UL << BTRFS_ORDERED_PREALLOC) | \ 78 (1UL << BTRFS_ORDERED_COMPRESSED) | \ 79 (1UL << BTRFS_ORDERED_DIRECT) | \ 80 (1UL << BTRFS_ORDERED_ENCODED)) 81 82 struct btrfs_ordered_extent { 83 /* logical offset in the file */ 84 u64 file_offset; 85 86 /* 87 * These fields directly correspond to the same fields in 88 * btrfs_file_extent_item. 89 */ 90 u64 num_bytes; 91 u64 ram_bytes; 92 u64 disk_bytenr; 93 u64 disk_num_bytes; 94 u64 offset; 95 96 /* number of bytes that still need writing */ 97 u64 bytes_left; 98 99 /* 100 * If we get truncated we need to adjust the file extent we enter for 101 * this ordered extent so that we do not expose stale data. 102 */ 103 u64 truncated_len; 104 105 /* flags (described above) */ 106 unsigned long flags; 107 108 /* compression algorithm */ 109 int compress_type; 110 111 /* Qgroup reserved space */ 112 int qgroup_rsv; 113 114 /* reference count */ 115 refcount_t refs; 116 117 /* the inode we belong to */ 118 struct inode *inode; 119 120 /* list of checksums for insertion when the extent io is done */ 121 struct list_head list; 122 123 /* used for fast fsyncs */ 124 struct list_head log_list; 125 126 /* used to wait for the BTRFS_ORDERED_COMPLETE bit */ 127 wait_queue_head_t wait; 128 129 /* our friendly rbtree entry */ 130 struct rb_node rb_node; 131 132 /* a per root list of all the pending ordered extents */ 133 struct list_head root_extent_list; 134 135 struct btrfs_work work; 136 137 struct completion completion; 138 struct btrfs_work flush_work; 139 struct list_head work_list; 140 141 struct list_head bioc_list; 142 }; 143 144 int btrfs_finish_one_ordered(struct btrfs_ordered_extent *ordered_extent); 145 int btrfs_finish_ordered_io(struct btrfs_ordered_extent *ordered_extent); 146 147 void btrfs_put_ordered_extent(struct btrfs_ordered_extent *entry); 148 void btrfs_remove_ordered_extent(struct btrfs_inode *btrfs_inode, 149 struct btrfs_ordered_extent *entry); 150 bool btrfs_finish_ordered_extent(struct btrfs_ordered_extent *ordered, 151 struct page *page, u64 file_offset, u64 len, 152 bool uptodate); 153 void btrfs_mark_ordered_io_finished(struct btrfs_inode *inode, 154 struct page *page, u64 file_offset, 155 u64 num_bytes, bool uptodate); 156 bool btrfs_dec_test_ordered_pending(struct btrfs_inode *inode, 157 struct btrfs_ordered_extent **cached, 158 u64 file_offset, u64 io_size); 159 struct btrfs_ordered_extent *btrfs_alloc_ordered_extent( 160 struct btrfs_inode *inode, u64 file_offset, 161 u64 num_bytes, u64 ram_bytes, u64 disk_bytenr, 162 u64 disk_num_bytes, u64 offset, unsigned long flags, 163 int compress_type); 164 void btrfs_add_ordered_sum(struct btrfs_ordered_extent *entry, 165 struct btrfs_ordered_sum *sum); 166 struct btrfs_ordered_extent *btrfs_lookup_ordered_extent(struct btrfs_inode *inode, 167 u64 file_offset); 168 void btrfs_start_ordered_extent(struct btrfs_ordered_extent *entry); 169 int btrfs_wait_ordered_range(struct inode *inode, u64 start, u64 len); 170 struct btrfs_ordered_extent * 171 btrfs_lookup_first_ordered_extent(struct btrfs_inode *inode, u64 file_offset); 172 struct btrfs_ordered_extent *btrfs_lookup_first_ordered_range( 173 struct btrfs_inode *inode, u64 file_offset, u64 len); 174 struct btrfs_ordered_extent *btrfs_lookup_ordered_range( 175 struct btrfs_inode *inode, 176 u64 file_offset, 177 u64 len); 178 void btrfs_get_ordered_extents_for_logging(struct btrfs_inode *inode, 179 struct list_head *list); 180 u64 btrfs_wait_ordered_extents(struct btrfs_root *root, u64 nr, 181 const u64 range_start, const u64 range_len); 182 void btrfs_wait_ordered_roots(struct btrfs_fs_info *fs_info, u64 nr, 183 const u64 range_start, const u64 range_len); 184 void btrfs_lock_and_flush_ordered_range(struct btrfs_inode *inode, u64 start, 185 u64 end, 186 struct extent_state **cached_state); 187 bool btrfs_try_lock_ordered_range(struct btrfs_inode *inode, u64 start, u64 end, 188 struct extent_state **cached_state); 189 struct btrfs_ordered_extent *btrfs_split_ordered_extent( 190 struct btrfs_ordered_extent *ordered, u64 len); 191 int __init ordered_data_init(void); 192 void __cold ordered_data_exit(void); 193 194 #endif 195