2 * Copyright (C) 2011-2012 Red Hat, Inc.
4 * This file is released under the GPL.
7 #include "dm-thin-metadata.h"
8 #include "persistent-data/dm-btree.h"
9 #include "persistent-data/dm-space-map.h"
10 #include "persistent-data/dm-space-map-disk.h"
11 #include "persistent-data/dm-transaction-manager.h"
13 #include <linux/list.h>
14 #include <linux/device-mapper.h>
15 #include <linux/workqueue.h>
17 /*--------------------------------------------------------------------------
18 * As far as the metadata goes, there is:
20 * - A superblock in block zero, taking up fewer than 512 bytes for
23 * - A space map managing the metadata blocks.
25 * - A space map managing the data blocks.
27 * - A btree mapping our internal thin dev ids onto struct disk_device_details.
29 * - A hierarchical btree, with 2 levels which effectively maps (thin
30 * dev id, virtual block) -> block_time. Block time is a 64-bit
31 * field holding the time in the low 24 bits, and block in the top 48
34 * BTrees consist solely of btree_nodes, that fill a block. Some are
35 * internal nodes, as such their values are a __le64 pointing to other
36 * nodes. Leaf nodes can store data of any reasonable size (ie. much
37 * smaller than the block size). The nodes consist of the header,
38 * followed by an array of keys, followed by an array of values. We have
39 * to binary search on the keys so they're all held together to help the
42 * Space maps have 2 btrees:
44 * - One maps a uint64_t onto a struct index_entry. Which points to a
45 * bitmap block, and has some details about how many free entries there
48 * - The bitmap blocks have a header (for the checksum). Then the rest
49 * of the block is pairs of bits. With the meaning being:
54 * 3 - ref count is higher than 2
56 * - If the count is higher than 2 then the ref count is entered in a
57 * second btree that directly maps the block_address to a uint32_t ref
60 * The space map metadata variant doesn't have a bitmaps btree. Instead
61 * it has one single blocks worth of index_entries. This avoids
62 * recursive issues with the bitmap btree needing to allocate space in
63 * order to insert. With a small data block size such as 64k the
64 * metadata support data devices that are hundreds of terrabytes.
66 * The space maps allocate space linearly from front to back. Space that
67 * is freed in a transaction is never recycled within that transaction.
68 * To try and avoid fragmenting _free_ space the allocator always goes
69 * back and fills in gaps.
71 * All metadata io is in THIN_METADATA_BLOCK_SIZE sized/aligned chunks
72 * from the block manager.
73 *--------------------------------------------------------------------------*/
75 #define DM_MSG_PREFIX "thin metadata"
77 #define THIN_SUPERBLOCK_MAGIC 27022010
78 #define THIN_SUPERBLOCK_LOCATION 0
79 #define THIN_VERSION 2
80 #define THIN_METADATA_CACHE_SIZE 64
81 #define SECTOR_TO_BLOCK_SHIFT 3
85 * 3 for btree insert +
86 * 2 for btree lookup used within space map
88 * 2 for shadow spine +
89 * 4 for rebalance 3 child node
91 #define THIN_MAX_CONCURRENT_LOCKS 6
93 /* This should be plenty */
94 #define SPACE_MAP_ROOT_SIZE 128
97 * Little endian on-disk superblock and device details.
99 struct thin_disk_superblock {
100 __le32 csum; /* Checksum of superblock except for this field. */
102 __le64 blocknr; /* This block number, dm_block_t. */
112 * Root held by userspace transactions.
116 __u8 data_space_map_root[SPACE_MAP_ROOT_SIZE];
117 __u8 metadata_space_map_root[SPACE_MAP_ROOT_SIZE];
120 * 2-level btree mapping (dev_id, (dev block, time)) -> data block
122 __le64 data_mapping_root;
125 * Device detail root mapping dev_id -> device_details
127 __le64 device_details_root;
129 __le32 data_block_size; /* In 512-byte sectors. */
131 __le32 metadata_block_size; /* In 512-byte sectors. */
132 __le64 metadata_nr_blocks;
135 __le32 compat_ro_flags;
136 __le32 incompat_flags;
139 struct disk_device_details {
140 __le64 mapped_blocks;
141 __le64 transaction_id; /* When created. */
142 __le32 creation_time;
143 __le32 snapshotted_time;
146 struct dm_pool_metadata {
147 struct hlist_node hash;
149 struct block_device *bdev;
150 struct dm_block_manager *bm;
151 struct dm_space_map *metadata_sm;
152 struct dm_space_map *data_sm;
153 struct dm_transaction_manager *tm;
154 struct dm_transaction_manager *nb_tm;
158 * First level holds thin_dev_t.
159 * Second level holds mappings.
161 struct dm_btree_info info;
164 * Non-blocking version of the above.
166 struct dm_btree_info nb_info;
169 * Just the top level for deleting whole devices.
171 struct dm_btree_info tl_info;
174 * Just the bottom level for creating new devices.
176 struct dm_btree_info bl_info;
179 * Describes the device details btree.
181 struct dm_btree_info details_info;
183 struct rw_semaphore root_lock;
186 dm_block_t details_root;
187 struct list_head thin_devices;
190 sector_t data_block_size;
193 * We reserve a section of the metadata for commit overhead.
194 * All reported space does *not* include this.
196 dm_block_t metadata_reserve;
199 * Set if a transaction has to be aborted but the attempt to roll back
200 * to the previous (good) transaction failed. The only pool metadata
201 * operation possible in this state is the closing of the device.
206 * Reading the space map roots can fail, so we read it into these
207 * buffers before the superblock is locked and updated.
209 __u8 data_space_map_root[SPACE_MAP_ROOT_SIZE];
210 __u8 metadata_space_map_root[SPACE_MAP_ROOT_SIZE];
213 struct dm_thin_device {
214 struct list_head list;
215 struct dm_pool_metadata *pmd;
220 bool aborted_with_changes:1;
221 uint64_t mapped_blocks;
222 uint64_t transaction_id;
223 uint32_t creation_time;
224 uint32_t snapshotted_time;
227 /*----------------------------------------------------------------
228 * superblock validator
229 *--------------------------------------------------------------*/
231 #define SUPERBLOCK_CSUM_XOR 160774
233 static void sb_prepare_for_write(struct dm_block_validator *v,
237 struct thin_disk_superblock *disk_super = dm_block_data(b);
239 disk_super->blocknr = cpu_to_le64(dm_block_location(b));
240 disk_super->csum = cpu_to_le32(dm_bm_checksum(&disk_super->flags,
241 block_size - sizeof(__le32),
242 SUPERBLOCK_CSUM_XOR));
245 static int sb_check(struct dm_block_validator *v,
249 struct thin_disk_superblock *disk_super = dm_block_data(b);
252 if (dm_block_location(b) != le64_to_cpu(disk_super->blocknr)) {
253 DMERR("sb_check failed: blocknr %llu: "
254 "wanted %llu", le64_to_cpu(disk_super->blocknr),
255 (unsigned long long)dm_block_location(b));
259 if (le64_to_cpu(disk_super->magic) != THIN_SUPERBLOCK_MAGIC) {
260 DMERR("sb_check failed: magic %llu: "
261 "wanted %llu", le64_to_cpu(disk_super->magic),
262 (unsigned long long)THIN_SUPERBLOCK_MAGIC);
266 csum_le = cpu_to_le32(dm_bm_checksum(&disk_super->flags,
267 block_size - sizeof(__le32),
268 SUPERBLOCK_CSUM_XOR));
269 if (csum_le != disk_super->csum) {
270 DMERR("sb_check failed: csum %u: wanted %u",
271 le32_to_cpu(csum_le), le32_to_cpu(disk_super->csum));
278 static struct dm_block_validator sb_validator = {
279 .name = "superblock",
280 .prepare_for_write = sb_prepare_for_write,
284 /*----------------------------------------------------------------
285 * Methods for the btree value types
286 *--------------------------------------------------------------*/
288 static uint64_t pack_block_time(dm_block_t b, uint32_t t)
290 return (b << 24) | t;
293 static void unpack_block_time(uint64_t v, dm_block_t *b, uint32_t *t)
296 *t = v & ((1 << 24) - 1);
299 static void data_block_inc(void *context, const void *value_le)
301 struct dm_space_map *sm = context;
306 memcpy(&v_le, value_le, sizeof(v_le));
307 unpack_block_time(le64_to_cpu(v_le), &b, &t);
308 dm_sm_inc_block(sm, b);
311 static void data_block_dec(void *context, const void *value_le)
313 struct dm_space_map *sm = context;
318 memcpy(&v_le, value_le, sizeof(v_le));
319 unpack_block_time(le64_to_cpu(v_le), &b, &t);
320 dm_sm_dec_block(sm, b);
323 static int data_block_equal(void *context, const void *value1_le, const void *value2_le)
329 memcpy(&v1_le, value1_le, sizeof(v1_le));
330 memcpy(&v2_le, value2_le, sizeof(v2_le));
331 unpack_block_time(le64_to_cpu(v1_le), &b1, &t);
332 unpack_block_time(le64_to_cpu(v2_le), &b2, &t);
337 static void subtree_inc(void *context, const void *value)
339 struct dm_btree_info *info = context;
343 memcpy(&root_le, value, sizeof(root_le));
344 root = le64_to_cpu(root_le);
345 dm_tm_inc(info->tm, root);
348 static void subtree_dec(void *context, const void *value)
350 struct dm_btree_info *info = context;
354 memcpy(&root_le, value, sizeof(root_le));
355 root = le64_to_cpu(root_le);
356 if (dm_btree_del(info, root))
357 DMERR("btree delete failed");
360 static int subtree_equal(void *context, const void *value1_le, const void *value2_le)
363 memcpy(&v1_le, value1_le, sizeof(v1_le));
364 memcpy(&v2_le, value2_le, sizeof(v2_le));
366 return v1_le == v2_le;
369 /*----------------------------------------------------------------*/
371 static int superblock_lock_zero(struct dm_pool_metadata *pmd,
372 struct dm_block **sblock)
374 return dm_bm_write_lock_zero(pmd->bm, THIN_SUPERBLOCK_LOCATION,
375 &sb_validator, sblock);
378 static int superblock_lock(struct dm_pool_metadata *pmd,
379 struct dm_block **sblock)
381 return dm_bm_write_lock(pmd->bm, THIN_SUPERBLOCK_LOCATION,
382 &sb_validator, sblock);
385 static int __superblock_all_zeroes(struct dm_block_manager *bm, int *result)
390 __le64 *data_le, zero = cpu_to_le64(0);
391 unsigned block_size = dm_bm_block_size(bm) / sizeof(__le64);
394 * We can't use a validator here - it may be all zeroes.
396 r = dm_bm_read_lock(bm, THIN_SUPERBLOCK_LOCATION, NULL, &b);
400 data_le = dm_block_data(b);
402 for (i = 0; i < block_size; i++) {
403 if (data_le[i] != zero) {
414 static void __setup_btree_details(struct dm_pool_metadata *pmd)
416 pmd->info.tm = pmd->tm;
417 pmd->info.levels = 2;
418 pmd->info.value_type.context = pmd->data_sm;
419 pmd->info.value_type.size = sizeof(__le64);
420 pmd->info.value_type.inc = data_block_inc;
421 pmd->info.value_type.dec = data_block_dec;
422 pmd->info.value_type.equal = data_block_equal;
424 memcpy(&pmd->nb_info, &pmd->info, sizeof(pmd->nb_info));
425 pmd->nb_info.tm = pmd->nb_tm;
427 pmd->tl_info.tm = pmd->tm;
428 pmd->tl_info.levels = 1;
429 pmd->tl_info.value_type.context = &pmd->bl_info;
430 pmd->tl_info.value_type.size = sizeof(__le64);
431 pmd->tl_info.value_type.inc = subtree_inc;
432 pmd->tl_info.value_type.dec = subtree_dec;
433 pmd->tl_info.value_type.equal = subtree_equal;
435 pmd->bl_info.tm = pmd->tm;
436 pmd->bl_info.levels = 1;
437 pmd->bl_info.value_type.context = pmd->data_sm;
438 pmd->bl_info.value_type.size = sizeof(__le64);
439 pmd->bl_info.value_type.inc = data_block_inc;
440 pmd->bl_info.value_type.dec = data_block_dec;
441 pmd->bl_info.value_type.equal = data_block_equal;
443 pmd->details_info.tm = pmd->tm;
444 pmd->details_info.levels = 1;
445 pmd->details_info.value_type.context = NULL;
446 pmd->details_info.value_type.size = sizeof(struct disk_device_details);
447 pmd->details_info.value_type.inc = NULL;
448 pmd->details_info.value_type.dec = NULL;
449 pmd->details_info.value_type.equal = NULL;
452 static int save_sm_roots(struct dm_pool_metadata *pmd)
457 r = dm_sm_root_size(pmd->metadata_sm, &len);
461 r = dm_sm_copy_root(pmd->metadata_sm, &pmd->metadata_space_map_root, len);
465 r = dm_sm_root_size(pmd->data_sm, &len);
469 return dm_sm_copy_root(pmd->data_sm, &pmd->data_space_map_root, len);
472 static void copy_sm_roots(struct dm_pool_metadata *pmd,
473 struct thin_disk_superblock *disk)
475 memcpy(&disk->metadata_space_map_root,
476 &pmd->metadata_space_map_root,
477 sizeof(pmd->metadata_space_map_root));
479 memcpy(&disk->data_space_map_root,
480 &pmd->data_space_map_root,
481 sizeof(pmd->data_space_map_root));
484 static int __write_initial_superblock(struct dm_pool_metadata *pmd)
487 struct dm_block *sblock;
488 struct thin_disk_superblock *disk_super;
489 sector_t bdev_size = i_size_read(pmd->bdev->bd_inode) >> SECTOR_SHIFT;
491 if (bdev_size > THIN_METADATA_MAX_SECTORS)
492 bdev_size = THIN_METADATA_MAX_SECTORS;
494 r = dm_sm_commit(pmd->data_sm);
498 r = dm_tm_pre_commit(pmd->tm);
502 r = save_sm_roots(pmd);
506 r = superblock_lock_zero(pmd, &sblock);
510 disk_super = dm_block_data(sblock);
511 disk_super->flags = 0;
512 memset(disk_super->uuid, 0, sizeof(disk_super->uuid));
513 disk_super->magic = cpu_to_le64(THIN_SUPERBLOCK_MAGIC);
514 disk_super->version = cpu_to_le32(THIN_VERSION);
515 disk_super->time = 0;
516 disk_super->trans_id = 0;
517 disk_super->held_root = 0;
519 copy_sm_roots(pmd, disk_super);
521 disk_super->data_mapping_root = cpu_to_le64(pmd->root);
522 disk_super->device_details_root = cpu_to_le64(pmd->details_root);
523 disk_super->metadata_block_size = cpu_to_le32(THIN_METADATA_BLOCK_SIZE);
524 disk_super->metadata_nr_blocks = cpu_to_le64(bdev_size >> SECTOR_TO_BLOCK_SHIFT);
525 disk_super->data_block_size = cpu_to_le32(pmd->data_block_size);
527 return dm_tm_commit(pmd->tm, sblock);
530 static int __format_metadata(struct dm_pool_metadata *pmd)
534 r = dm_tm_create_with_sm(pmd->bm, THIN_SUPERBLOCK_LOCATION,
535 &pmd->tm, &pmd->metadata_sm);
537 DMERR("tm_create_with_sm failed");
541 pmd->data_sm = dm_sm_disk_create(pmd->tm, 0);
542 if (IS_ERR(pmd->data_sm)) {
543 DMERR("sm_disk_create failed");
544 r = PTR_ERR(pmd->data_sm);
548 pmd->nb_tm = dm_tm_create_non_blocking_clone(pmd->tm);
550 DMERR("could not create non-blocking clone tm");
552 goto bad_cleanup_data_sm;
555 __setup_btree_details(pmd);
557 r = dm_btree_empty(&pmd->info, &pmd->root);
559 goto bad_cleanup_nb_tm;
561 r = dm_btree_empty(&pmd->details_info, &pmd->details_root);
563 DMERR("couldn't create devices root");
564 goto bad_cleanup_nb_tm;
567 r = __write_initial_superblock(pmd);
569 goto bad_cleanup_nb_tm;
574 dm_tm_destroy(pmd->nb_tm);
576 dm_sm_destroy(pmd->data_sm);
578 dm_tm_destroy(pmd->tm);
579 dm_sm_destroy(pmd->metadata_sm);
584 static int __check_incompat_features(struct thin_disk_superblock *disk_super,
585 struct dm_pool_metadata *pmd)
589 features = le32_to_cpu(disk_super->incompat_flags) & ~THIN_FEATURE_INCOMPAT_SUPP;
591 DMERR("could not access metadata due to unsupported optional features (%lx).",
592 (unsigned long)features);
597 * Check for read-only metadata to skip the following RDWR checks.
599 if (get_disk_ro(pmd->bdev->bd_disk))
602 features = le32_to_cpu(disk_super->compat_ro_flags) & ~THIN_FEATURE_COMPAT_RO_SUPP;
604 DMERR("could not access metadata RDWR due to unsupported optional features (%lx).",
605 (unsigned long)features);
612 static int __open_metadata(struct dm_pool_metadata *pmd)
615 struct dm_block *sblock;
616 struct thin_disk_superblock *disk_super;
618 r = dm_bm_read_lock(pmd->bm, THIN_SUPERBLOCK_LOCATION,
619 &sb_validator, &sblock);
621 DMERR("couldn't read superblock");
625 disk_super = dm_block_data(sblock);
627 /* Verify the data block size hasn't changed */
628 if (le32_to_cpu(disk_super->data_block_size) != pmd->data_block_size) {
629 DMERR("changing the data block size (from %u to %llu) is not supported",
630 le32_to_cpu(disk_super->data_block_size),
631 (unsigned long long)pmd->data_block_size);
633 goto bad_unlock_sblock;
636 r = __check_incompat_features(disk_super, pmd);
638 goto bad_unlock_sblock;
640 r = dm_tm_open_with_sm(pmd->bm, THIN_SUPERBLOCK_LOCATION,
641 disk_super->metadata_space_map_root,
642 sizeof(disk_super->metadata_space_map_root),
643 &pmd->tm, &pmd->metadata_sm);
645 DMERR("tm_open_with_sm failed");
646 goto bad_unlock_sblock;
649 pmd->data_sm = dm_sm_disk_open(pmd->tm, disk_super->data_space_map_root,
650 sizeof(disk_super->data_space_map_root));
651 if (IS_ERR(pmd->data_sm)) {
652 DMERR("sm_disk_open failed");
653 r = PTR_ERR(pmd->data_sm);
657 pmd->nb_tm = dm_tm_create_non_blocking_clone(pmd->tm);
659 DMERR("could not create non-blocking clone tm");
661 goto bad_cleanup_data_sm;
664 __setup_btree_details(pmd);
665 dm_bm_unlock(sblock);
670 dm_sm_destroy(pmd->data_sm);
672 dm_tm_destroy(pmd->tm);
673 dm_sm_destroy(pmd->metadata_sm);
675 dm_bm_unlock(sblock);
680 static int __open_or_format_metadata(struct dm_pool_metadata *pmd, bool format_device)
684 r = __superblock_all_zeroes(pmd->bm, &unformatted);
689 return format_device ? __format_metadata(pmd) : -EPERM;
691 return __open_metadata(pmd);
694 static int __create_persistent_data_objects(struct dm_pool_metadata *pmd, bool format_device)
698 pmd->bm = dm_block_manager_create(pmd->bdev, THIN_METADATA_BLOCK_SIZE << SECTOR_SHIFT,
699 THIN_METADATA_CACHE_SIZE,
700 THIN_MAX_CONCURRENT_LOCKS);
701 if (IS_ERR(pmd->bm)) {
702 DMERR("could not create block manager");
703 r = PTR_ERR(pmd->bm);
708 r = __open_or_format_metadata(pmd, format_device);
710 dm_block_manager_destroy(pmd->bm);
717 static void __destroy_persistent_data_objects(struct dm_pool_metadata *pmd)
719 dm_sm_destroy(pmd->data_sm);
720 dm_sm_destroy(pmd->metadata_sm);
721 dm_tm_destroy(pmd->nb_tm);
722 dm_tm_destroy(pmd->tm);
723 dm_block_manager_destroy(pmd->bm);
726 static int __begin_transaction(struct dm_pool_metadata *pmd)
729 struct thin_disk_superblock *disk_super;
730 struct dm_block *sblock;
733 * We re-read the superblock every time. Shouldn't need to do this
736 r = dm_bm_read_lock(pmd->bm, THIN_SUPERBLOCK_LOCATION,
737 &sb_validator, &sblock);
741 disk_super = dm_block_data(sblock);
742 pmd->time = le32_to_cpu(disk_super->time);
743 pmd->root = le64_to_cpu(disk_super->data_mapping_root);
744 pmd->details_root = le64_to_cpu(disk_super->device_details_root);
745 pmd->trans_id = le64_to_cpu(disk_super->trans_id);
746 pmd->flags = le32_to_cpu(disk_super->flags);
747 pmd->data_block_size = le32_to_cpu(disk_super->data_block_size);
749 dm_bm_unlock(sblock);
753 static int __write_changed_details(struct dm_pool_metadata *pmd)
756 struct dm_thin_device *td, *tmp;
757 struct disk_device_details details;
760 list_for_each_entry_safe(td, tmp, &pmd->thin_devices, list) {
766 details.mapped_blocks = cpu_to_le64(td->mapped_blocks);
767 details.transaction_id = cpu_to_le64(td->transaction_id);
768 details.creation_time = cpu_to_le32(td->creation_time);
769 details.snapshotted_time = cpu_to_le32(td->snapshotted_time);
770 __dm_bless_for_disk(&details);
772 r = dm_btree_insert(&pmd->details_info, pmd->details_root,
773 &key, &details, &pmd->details_root);
788 static int __commit_transaction(struct dm_pool_metadata *pmd)
791 size_t metadata_len, data_len;
792 struct thin_disk_superblock *disk_super;
793 struct dm_block *sblock;
796 * We need to know if the thin_disk_superblock exceeds a 512-byte sector.
798 BUILD_BUG_ON(sizeof(struct thin_disk_superblock) > 512);
800 r = __write_changed_details(pmd);
804 r = dm_sm_commit(pmd->data_sm);
808 r = dm_tm_pre_commit(pmd->tm);
812 r = dm_sm_root_size(pmd->metadata_sm, &metadata_len);
816 r = dm_sm_root_size(pmd->data_sm, &data_len);
820 r = save_sm_roots(pmd);
824 r = superblock_lock(pmd, &sblock);
828 disk_super = dm_block_data(sblock);
829 disk_super->time = cpu_to_le32(pmd->time);
830 disk_super->data_mapping_root = cpu_to_le64(pmd->root);
831 disk_super->device_details_root = cpu_to_le64(pmd->details_root);
832 disk_super->trans_id = cpu_to_le64(pmd->trans_id);
833 disk_super->flags = cpu_to_le32(pmd->flags);
835 copy_sm_roots(pmd, disk_super);
837 return dm_tm_commit(pmd->tm, sblock);
840 static void __set_metadata_reserve(struct dm_pool_metadata *pmd)
844 dm_block_t max_blocks = 4096; /* 16M */
846 r = dm_sm_get_nr_blocks(pmd->metadata_sm, &total);
848 DMERR("could not get size of metadata device");
849 pmd->metadata_reserve = max_blocks;
851 pmd->metadata_reserve = min(max_blocks, div_u64(total, 10));
854 struct dm_pool_metadata *dm_pool_metadata_open(struct block_device *bdev,
855 sector_t data_block_size,
859 struct dm_pool_metadata *pmd;
861 pmd = kmalloc(sizeof(*pmd), GFP_KERNEL);
863 DMERR("could not allocate metadata struct");
864 return ERR_PTR(-ENOMEM);
867 init_rwsem(&pmd->root_lock);
869 INIT_LIST_HEAD(&pmd->thin_devices);
870 pmd->fail_io = false;
872 pmd->data_block_size = data_block_size;
874 r = __create_persistent_data_objects(pmd, format_device);
880 r = __begin_transaction(pmd);
882 if (dm_pool_metadata_close(pmd) < 0)
883 DMWARN("%s: dm_pool_metadata_close() failed.", __func__);
887 __set_metadata_reserve(pmd);
892 int dm_pool_metadata_close(struct dm_pool_metadata *pmd)
895 unsigned open_devices = 0;
896 struct dm_thin_device *td, *tmp;
898 down_read(&pmd->root_lock);
899 list_for_each_entry_safe(td, tmp, &pmd->thin_devices, list) {
907 up_read(&pmd->root_lock);
910 DMERR("attempt to close pmd when %u device(s) are still open",
915 if (!dm_bm_is_read_only(pmd->bm) && !pmd->fail_io) {
916 r = __commit_transaction(pmd);
918 DMWARN("%s: __commit_transaction() failed, error = %d",
923 __destroy_persistent_data_objects(pmd);
930 * __open_device: Returns @td corresponding to device with id @dev,
931 * creating it if @create is set and incrementing @td->open_count.
932 * On failure, @td is undefined.
934 static int __open_device(struct dm_pool_metadata *pmd,
935 dm_thin_id dev, int create,
936 struct dm_thin_device **td)
939 struct dm_thin_device *td2;
941 struct disk_device_details details_le;
944 * If the device is already open, return it.
946 list_for_each_entry(td2, &pmd->thin_devices, list)
947 if (td2->id == dev) {
949 * May not create an already-open device.
960 * Check the device exists.
962 r = dm_btree_lookup(&pmd->details_info, pmd->details_root,
965 if (r != -ENODATA || !create)
972 details_le.mapped_blocks = 0;
973 details_le.transaction_id = cpu_to_le64(pmd->trans_id);
974 details_le.creation_time = cpu_to_le32(pmd->time);
975 details_le.snapshotted_time = cpu_to_le32(pmd->time);
978 *td = kmalloc(sizeof(**td), GFP_NOIO);
984 (*td)->open_count = 1;
985 (*td)->changed = changed;
986 (*td)->aborted_with_changes = false;
987 (*td)->mapped_blocks = le64_to_cpu(details_le.mapped_blocks);
988 (*td)->transaction_id = le64_to_cpu(details_le.transaction_id);
989 (*td)->creation_time = le32_to_cpu(details_le.creation_time);
990 (*td)->snapshotted_time = le32_to_cpu(details_le.snapshotted_time);
992 list_add(&(*td)->list, &pmd->thin_devices);
997 static void __close_device(struct dm_thin_device *td)
1002 static int __create_thin(struct dm_pool_metadata *pmd,
1006 dm_block_t dev_root;
1008 struct disk_device_details details_le;
1009 struct dm_thin_device *td;
1012 r = dm_btree_lookup(&pmd->details_info, pmd->details_root,
1018 * Create an empty btree for the mappings.
1020 r = dm_btree_empty(&pmd->bl_info, &dev_root);
1025 * Insert it into the main mapping tree.
1027 value = cpu_to_le64(dev_root);
1028 __dm_bless_for_disk(&value);
1029 r = dm_btree_insert(&pmd->tl_info, pmd->root, &key, &value, &pmd->root);
1031 dm_btree_del(&pmd->bl_info, dev_root);
1035 r = __open_device(pmd, dev, 1, &td);
1037 dm_btree_remove(&pmd->tl_info, pmd->root, &key, &pmd->root);
1038 dm_btree_del(&pmd->bl_info, dev_root);
1046 int dm_pool_create_thin(struct dm_pool_metadata *pmd, dm_thin_id dev)
1050 down_write(&pmd->root_lock);
1052 r = __create_thin(pmd, dev);
1053 up_write(&pmd->root_lock);
1058 static int __set_snapshot_details(struct dm_pool_metadata *pmd,
1059 struct dm_thin_device *snap,
1060 dm_thin_id origin, uint32_t time)
1063 struct dm_thin_device *td;
1065 r = __open_device(pmd, origin, 0, &td);
1070 td->snapshotted_time = time;
1072 snap->mapped_blocks = td->mapped_blocks;
1073 snap->snapshotted_time = time;
1079 static int __create_snap(struct dm_pool_metadata *pmd,
1080 dm_thin_id dev, dm_thin_id origin)
1083 dm_block_t origin_root;
1084 uint64_t key = origin, dev_key = dev;
1085 struct dm_thin_device *td;
1086 struct disk_device_details details_le;
1089 /* check this device is unused */
1090 r = dm_btree_lookup(&pmd->details_info, pmd->details_root,
1091 &dev_key, &details_le);
1095 /* find the mapping tree for the origin */
1096 r = dm_btree_lookup(&pmd->tl_info, pmd->root, &key, &value);
1099 origin_root = le64_to_cpu(value);
1101 /* clone the origin, an inc will do */
1102 dm_tm_inc(pmd->tm, origin_root);
1104 /* insert into the main mapping tree */
1105 value = cpu_to_le64(origin_root);
1106 __dm_bless_for_disk(&value);
1108 r = dm_btree_insert(&pmd->tl_info, pmd->root, &key, &value, &pmd->root);
1110 dm_tm_dec(pmd->tm, origin_root);
1116 r = __open_device(pmd, dev, 1, &td);
1120 r = __set_snapshot_details(pmd, td, origin, pmd->time);
1129 dm_btree_remove(&pmd->tl_info, pmd->root, &key, &pmd->root);
1130 dm_btree_remove(&pmd->details_info, pmd->details_root,
1131 &key, &pmd->details_root);
1135 int dm_pool_create_snap(struct dm_pool_metadata *pmd,
1141 down_write(&pmd->root_lock);
1143 r = __create_snap(pmd, dev, origin);
1144 up_write(&pmd->root_lock);
1149 static int __delete_device(struct dm_pool_metadata *pmd, dm_thin_id dev)
1153 struct dm_thin_device *td;
1155 /* TODO: failure should mark the transaction invalid */
1156 r = __open_device(pmd, dev, 0, &td);
1160 if (td->open_count > 1) {
1165 list_del(&td->list);
1167 r = dm_btree_remove(&pmd->details_info, pmd->details_root,
1168 &key, &pmd->details_root);
1172 r = dm_btree_remove(&pmd->tl_info, pmd->root, &key, &pmd->root);
1179 int dm_pool_delete_thin_device(struct dm_pool_metadata *pmd,
1184 down_write(&pmd->root_lock);
1186 r = __delete_device(pmd, dev);
1187 up_write(&pmd->root_lock);
1192 int dm_pool_set_metadata_transaction_id(struct dm_pool_metadata *pmd,
1193 uint64_t current_id,
1198 down_write(&pmd->root_lock);
1203 if (pmd->trans_id != current_id) {
1204 DMERR("mismatched transaction id");
1208 pmd->trans_id = new_id;
1212 up_write(&pmd->root_lock);
1217 int dm_pool_get_metadata_transaction_id(struct dm_pool_metadata *pmd,
1222 down_read(&pmd->root_lock);
1223 if (!pmd->fail_io) {
1224 *result = pmd->trans_id;
1227 up_read(&pmd->root_lock);
1232 static int __reserve_metadata_snap(struct dm_pool_metadata *pmd)
1235 struct thin_disk_superblock *disk_super;
1236 struct dm_block *copy, *sblock;
1237 dm_block_t held_root;
1240 * We commit to ensure the btree roots which we increment in a
1241 * moment are up to date.
1243 __commit_transaction(pmd);
1246 * Copy the superblock.
1248 dm_sm_inc_block(pmd->metadata_sm, THIN_SUPERBLOCK_LOCATION);
1249 r = dm_tm_shadow_block(pmd->tm, THIN_SUPERBLOCK_LOCATION,
1250 &sb_validator, ©, &inc);
1256 held_root = dm_block_location(copy);
1257 disk_super = dm_block_data(copy);
1259 if (le64_to_cpu(disk_super->held_root)) {
1260 DMWARN("Pool metadata snapshot already exists: release this before taking another.");
1262 dm_tm_dec(pmd->tm, held_root);
1263 dm_tm_unlock(pmd->tm, copy);
1268 * Wipe the spacemap since we're not publishing this.
1270 memset(&disk_super->data_space_map_root, 0,
1271 sizeof(disk_super->data_space_map_root));
1272 memset(&disk_super->metadata_space_map_root, 0,
1273 sizeof(disk_super->metadata_space_map_root));
1276 * Increment the data structures that need to be preserved.
1278 dm_tm_inc(pmd->tm, le64_to_cpu(disk_super->data_mapping_root));
1279 dm_tm_inc(pmd->tm, le64_to_cpu(disk_super->device_details_root));
1280 dm_tm_unlock(pmd->tm, copy);
1283 * Write the held root into the superblock.
1285 r = superblock_lock(pmd, &sblock);
1287 dm_tm_dec(pmd->tm, held_root);
1291 disk_super = dm_block_data(sblock);
1292 disk_super->held_root = cpu_to_le64(held_root);
1293 dm_bm_unlock(sblock);
1297 int dm_pool_reserve_metadata_snap(struct dm_pool_metadata *pmd)
1301 down_write(&pmd->root_lock);
1303 r = __reserve_metadata_snap(pmd);
1304 up_write(&pmd->root_lock);
1309 static int __release_metadata_snap(struct dm_pool_metadata *pmd)
1312 struct thin_disk_superblock *disk_super;
1313 struct dm_block *sblock, *copy;
1314 dm_block_t held_root;
1316 r = superblock_lock(pmd, &sblock);
1320 disk_super = dm_block_data(sblock);
1321 held_root = le64_to_cpu(disk_super->held_root);
1322 disk_super->held_root = cpu_to_le64(0);
1324 dm_bm_unlock(sblock);
1327 DMWARN("No pool metadata snapshot found: nothing to release.");
1331 r = dm_tm_read_lock(pmd->tm, held_root, &sb_validator, ©);
1335 disk_super = dm_block_data(copy);
1336 dm_btree_del(&pmd->info, le64_to_cpu(disk_super->data_mapping_root));
1337 dm_btree_del(&pmd->details_info, le64_to_cpu(disk_super->device_details_root));
1338 dm_sm_dec_block(pmd->metadata_sm, held_root);
1340 dm_tm_unlock(pmd->tm, copy);
1345 int dm_pool_release_metadata_snap(struct dm_pool_metadata *pmd)
1349 down_write(&pmd->root_lock);
1351 r = __release_metadata_snap(pmd);
1352 up_write(&pmd->root_lock);
1357 static int __get_metadata_snap(struct dm_pool_metadata *pmd,
1361 struct thin_disk_superblock *disk_super;
1362 struct dm_block *sblock;
1364 r = dm_bm_read_lock(pmd->bm, THIN_SUPERBLOCK_LOCATION,
1365 &sb_validator, &sblock);
1369 disk_super = dm_block_data(sblock);
1370 *result = le64_to_cpu(disk_super->held_root);
1372 dm_bm_unlock(sblock);
1377 int dm_pool_get_metadata_snap(struct dm_pool_metadata *pmd,
1382 down_read(&pmd->root_lock);
1384 r = __get_metadata_snap(pmd, result);
1385 up_read(&pmd->root_lock);
1390 int dm_pool_open_thin_device(struct dm_pool_metadata *pmd, dm_thin_id dev,
1391 struct dm_thin_device **td)
1395 down_write(&pmd->root_lock);
1397 r = __open_device(pmd, dev, 0, td);
1398 up_write(&pmd->root_lock);
1403 int dm_pool_close_thin_device(struct dm_thin_device *td)
1405 down_write(&td->pmd->root_lock);
1407 up_write(&td->pmd->root_lock);
1412 dm_thin_id dm_thin_dev_id(struct dm_thin_device *td)
1418 * Check whether @time (of block creation) is older than @td's last snapshot.
1419 * If so then the associated block is shared with the last snapshot device.
1420 * Any block on a device created *after* the device last got snapshotted is
1421 * necessarily not shared.
1423 static bool __snapshotted_since(struct dm_thin_device *td, uint32_t time)
1425 return td->snapshotted_time > time;
1428 static void unpack_lookup_result(struct dm_thin_device *td, __le64 value,
1429 struct dm_thin_lookup_result *result)
1431 uint64_t block_time = 0;
1432 dm_block_t exception_block;
1433 uint32_t exception_time;
1435 block_time = le64_to_cpu(value);
1436 unpack_block_time(block_time, &exception_block, &exception_time);
1437 result->block = exception_block;
1438 result->shared = __snapshotted_since(td, exception_time);
1441 static int __find_block(struct dm_thin_device *td, dm_block_t block,
1442 int can_issue_io, struct dm_thin_lookup_result *result)
1446 struct dm_pool_metadata *pmd = td->pmd;
1447 dm_block_t keys[2] = { td->id, block };
1448 struct dm_btree_info *info;
1453 info = &pmd->nb_info;
1455 r = dm_btree_lookup(info, pmd->root, keys, &value);
1457 unpack_lookup_result(td, value, result);
1462 int dm_thin_find_block(struct dm_thin_device *td, dm_block_t block,
1463 int can_issue_io, struct dm_thin_lookup_result *result)
1466 struct dm_pool_metadata *pmd = td->pmd;
1468 down_read(&pmd->root_lock);
1470 up_read(&pmd->root_lock);
1474 r = __find_block(td, block, can_issue_io, result);
1476 up_read(&pmd->root_lock);
1480 static int __find_next_mapped_block(struct dm_thin_device *td, dm_block_t block,
1482 struct dm_thin_lookup_result *result)
1486 struct dm_pool_metadata *pmd = td->pmd;
1487 dm_block_t keys[2] = { td->id, block };
1489 r = dm_btree_lookup_next(&pmd->info, pmd->root, keys, vblock, &value);
1491 unpack_lookup_result(td, value, result);
1496 static int __find_mapped_range(struct dm_thin_device *td,
1497 dm_block_t begin, dm_block_t end,
1498 dm_block_t *thin_begin, dm_block_t *thin_end,
1499 dm_block_t *pool_begin, bool *maybe_shared)
1502 dm_block_t pool_end;
1503 struct dm_thin_lookup_result lookup;
1508 r = __find_next_mapped_block(td, begin, &begin, &lookup);
1515 *thin_begin = begin;
1516 *pool_begin = lookup.block;
1517 *maybe_shared = lookup.shared;
1520 pool_end = *pool_begin + 1;
1521 while (begin != end) {
1522 r = __find_block(td, begin, true, &lookup);
1530 if ((lookup.block != pool_end) ||
1531 (lookup.shared != *maybe_shared))
1542 int dm_thin_find_mapped_range(struct dm_thin_device *td,
1543 dm_block_t begin, dm_block_t end,
1544 dm_block_t *thin_begin, dm_block_t *thin_end,
1545 dm_block_t *pool_begin, bool *maybe_shared)
1548 struct dm_pool_metadata *pmd = td->pmd;
1550 down_read(&pmd->root_lock);
1551 if (!pmd->fail_io) {
1552 r = __find_mapped_range(td, begin, end, thin_begin, thin_end,
1553 pool_begin, maybe_shared);
1555 up_read(&pmd->root_lock);
1560 static int __insert(struct dm_thin_device *td, dm_block_t block,
1561 dm_block_t data_block)
1565 struct dm_pool_metadata *pmd = td->pmd;
1566 dm_block_t keys[2] = { td->id, block };
1568 value = cpu_to_le64(pack_block_time(data_block, pmd->time));
1569 __dm_bless_for_disk(&value);
1571 r = dm_btree_insert_notify(&pmd->info, pmd->root, keys, &value,
1572 &pmd->root, &inserted);
1578 td->mapped_blocks++;
1583 int dm_thin_insert_block(struct dm_thin_device *td, dm_block_t block,
1584 dm_block_t data_block)
1588 down_write(&td->pmd->root_lock);
1589 if (!td->pmd->fail_io)
1590 r = __insert(td, block, data_block);
1591 up_write(&td->pmd->root_lock);
1596 static int __remove(struct dm_thin_device *td, dm_block_t block)
1599 struct dm_pool_metadata *pmd = td->pmd;
1600 dm_block_t keys[2] = { td->id, block };
1602 r = dm_btree_remove(&pmd->info, pmd->root, keys, &pmd->root);
1606 td->mapped_blocks--;
1612 static int __remove_range(struct dm_thin_device *td, dm_block_t begin, dm_block_t end)
1615 unsigned count, total_count = 0;
1616 struct dm_pool_metadata *pmd = td->pmd;
1617 dm_block_t keys[1] = { td->id };
1619 dm_block_t mapping_root;
1622 * Find the mapping tree
1624 r = dm_btree_lookup(&pmd->tl_info, pmd->root, keys, &value);
1629 * Remove from the mapping tree, taking care to inc the
1630 * ref count so it doesn't get deleted.
1632 mapping_root = le64_to_cpu(value);
1633 dm_tm_inc(pmd->tm, mapping_root);
1634 r = dm_btree_remove(&pmd->tl_info, pmd->root, keys, &pmd->root);
1639 * Remove leaves stops at the first unmapped entry, so we have to
1640 * loop round finding mapped ranges.
1642 while (begin < end) {
1643 r = dm_btree_lookup_next(&pmd->bl_info, mapping_root, &begin, &begin, &value);
1653 r = dm_btree_remove_leaves(&pmd->bl_info, mapping_root, &begin, end, &mapping_root, &count);
1657 total_count += count;
1660 td->mapped_blocks -= total_count;
1664 * Reinsert the mapping tree.
1666 value = cpu_to_le64(mapping_root);
1667 __dm_bless_for_disk(&value);
1668 return dm_btree_insert(&pmd->tl_info, pmd->root, keys, &value, &pmd->root);
1671 int dm_thin_remove_block(struct dm_thin_device *td, dm_block_t block)
1675 down_write(&td->pmd->root_lock);
1676 if (!td->pmd->fail_io)
1677 r = __remove(td, block);
1678 up_write(&td->pmd->root_lock);
1683 int dm_thin_remove_range(struct dm_thin_device *td,
1684 dm_block_t begin, dm_block_t end)
1688 down_write(&td->pmd->root_lock);
1689 if (!td->pmd->fail_io)
1690 r = __remove_range(td, begin, end);
1691 up_write(&td->pmd->root_lock);
1696 int dm_pool_block_is_shared(struct dm_pool_metadata *pmd, dm_block_t b, bool *result)
1701 down_read(&pmd->root_lock);
1702 r = dm_sm_get_count(pmd->data_sm, b, &ref_count);
1704 *result = (ref_count > 1);
1705 up_read(&pmd->root_lock);
1710 int dm_pool_inc_data_range(struct dm_pool_metadata *pmd, dm_block_t b, dm_block_t e)
1714 down_write(&pmd->root_lock);
1715 for (; b != e; b++) {
1716 r = dm_sm_inc_block(pmd->data_sm, b);
1720 up_write(&pmd->root_lock);
1725 int dm_pool_dec_data_range(struct dm_pool_metadata *pmd, dm_block_t b, dm_block_t e)
1729 down_write(&pmd->root_lock);
1730 for (; b != e; b++) {
1731 r = dm_sm_dec_block(pmd->data_sm, b);
1735 up_write(&pmd->root_lock);
1740 bool dm_thin_changed_this_transaction(struct dm_thin_device *td)
1744 down_read(&td->pmd->root_lock);
1746 up_read(&td->pmd->root_lock);
1751 bool dm_pool_changed_this_transaction(struct dm_pool_metadata *pmd)
1754 struct dm_thin_device *td, *tmp;
1756 down_read(&pmd->root_lock);
1757 list_for_each_entry_safe(td, tmp, &pmd->thin_devices, list) {
1763 up_read(&pmd->root_lock);
1768 bool dm_thin_aborted_changes(struct dm_thin_device *td)
1772 down_read(&td->pmd->root_lock);
1773 r = td->aborted_with_changes;
1774 up_read(&td->pmd->root_lock);
1779 int dm_pool_alloc_data_block(struct dm_pool_metadata *pmd, dm_block_t *result)
1783 down_write(&pmd->root_lock);
1785 r = dm_sm_new_block(pmd->data_sm, result);
1786 up_write(&pmd->root_lock);
1791 int dm_pool_commit_metadata(struct dm_pool_metadata *pmd)
1795 down_write(&pmd->root_lock);
1799 r = __commit_transaction(pmd);
1804 * Open the next transaction.
1806 r = __begin_transaction(pmd);
1808 up_write(&pmd->root_lock);
1812 static void __set_abort_with_changes_flags(struct dm_pool_metadata *pmd)
1814 struct dm_thin_device *td;
1816 list_for_each_entry(td, &pmd->thin_devices, list)
1817 td->aborted_with_changes = td->changed;
1820 int dm_pool_abort_metadata(struct dm_pool_metadata *pmd)
1824 down_write(&pmd->root_lock);
1828 __set_abort_with_changes_flags(pmd);
1829 __destroy_persistent_data_objects(pmd);
1830 r = __create_persistent_data_objects(pmd, false);
1832 pmd->fail_io = true;
1835 up_write(&pmd->root_lock);
1840 int dm_pool_get_free_block_count(struct dm_pool_metadata *pmd, dm_block_t *result)
1844 down_read(&pmd->root_lock);
1846 r = dm_sm_get_nr_free(pmd->data_sm, result);
1847 up_read(&pmd->root_lock);
1852 int dm_pool_get_free_metadata_block_count(struct dm_pool_metadata *pmd,
1857 down_read(&pmd->root_lock);
1859 r = dm_sm_get_nr_free(pmd->metadata_sm, result);
1862 if (*result < pmd->metadata_reserve)
1865 *result -= pmd->metadata_reserve;
1867 up_read(&pmd->root_lock);
1872 int dm_pool_get_metadata_dev_size(struct dm_pool_metadata *pmd,
1877 down_read(&pmd->root_lock);
1879 r = dm_sm_get_nr_blocks(pmd->metadata_sm, result);
1880 up_read(&pmd->root_lock);
1885 int dm_pool_get_data_dev_size(struct dm_pool_metadata *pmd, dm_block_t *result)
1889 down_read(&pmd->root_lock);
1891 r = dm_sm_get_nr_blocks(pmd->data_sm, result);
1892 up_read(&pmd->root_lock);
1897 int dm_thin_get_mapped_count(struct dm_thin_device *td, dm_block_t *result)
1900 struct dm_pool_metadata *pmd = td->pmd;
1902 down_read(&pmd->root_lock);
1903 if (!pmd->fail_io) {
1904 *result = td->mapped_blocks;
1907 up_read(&pmd->root_lock);
1912 static int __highest_block(struct dm_thin_device *td, dm_block_t *result)
1916 dm_block_t thin_root;
1917 struct dm_pool_metadata *pmd = td->pmd;
1919 r = dm_btree_lookup(&pmd->tl_info, pmd->root, &td->id, &value_le);
1923 thin_root = le64_to_cpu(value_le);
1925 return dm_btree_find_highest_key(&pmd->bl_info, thin_root, result);
1928 int dm_thin_get_highest_mapped_block(struct dm_thin_device *td,
1932 struct dm_pool_metadata *pmd = td->pmd;
1934 down_read(&pmd->root_lock);
1936 r = __highest_block(td, result);
1937 up_read(&pmd->root_lock);
1942 static int __resize_space_map(struct dm_space_map *sm, dm_block_t new_count)
1945 dm_block_t old_count;
1947 r = dm_sm_get_nr_blocks(sm, &old_count);
1951 if (new_count == old_count)
1954 if (new_count < old_count) {
1955 DMERR("cannot reduce size of space map");
1959 return dm_sm_extend(sm, new_count - old_count);
1962 int dm_pool_resize_data_dev(struct dm_pool_metadata *pmd, dm_block_t new_count)
1966 down_write(&pmd->root_lock);
1968 r = __resize_space_map(pmd->data_sm, new_count);
1969 up_write(&pmd->root_lock);
1974 int dm_pool_resize_metadata_dev(struct dm_pool_metadata *pmd, dm_block_t new_count)
1978 down_write(&pmd->root_lock);
1979 if (!pmd->fail_io) {
1980 r = __resize_space_map(pmd->metadata_sm, new_count);
1982 __set_metadata_reserve(pmd);
1984 up_write(&pmd->root_lock);
1989 void dm_pool_metadata_read_only(struct dm_pool_metadata *pmd)
1991 down_write(&pmd->root_lock);
1992 dm_bm_set_read_only(pmd->bm);
1993 up_write(&pmd->root_lock);
1996 void dm_pool_metadata_read_write(struct dm_pool_metadata *pmd)
1998 down_write(&pmd->root_lock);
1999 dm_bm_set_read_write(pmd->bm);
2000 up_write(&pmd->root_lock);
2003 int dm_pool_register_metadata_threshold(struct dm_pool_metadata *pmd,
2004 dm_block_t threshold,
2005 dm_sm_threshold_fn fn,
2010 down_write(&pmd->root_lock);
2011 r = dm_sm_register_threshold_callback(pmd->metadata_sm, threshold, fn, context);
2012 up_write(&pmd->root_lock);
2017 int dm_pool_metadata_set_needs_check(struct dm_pool_metadata *pmd)
2020 struct dm_block *sblock;
2021 struct thin_disk_superblock *disk_super;
2023 down_write(&pmd->root_lock);
2024 pmd->flags |= THIN_METADATA_NEEDS_CHECK_FLAG;
2026 r = superblock_lock(pmd, &sblock);
2028 DMERR("couldn't read superblock");
2032 disk_super = dm_block_data(sblock);
2033 disk_super->flags = cpu_to_le32(pmd->flags);
2035 dm_bm_unlock(sblock);
2037 up_write(&pmd->root_lock);
2041 bool dm_pool_metadata_needs_check(struct dm_pool_metadata *pmd)
2045 down_read(&pmd->root_lock);
2046 needs_check = pmd->flags & THIN_METADATA_NEEDS_CHECK_FLAG;
2047 up_read(&pmd->root_lock);
2052 void dm_pool_issue_prefetches(struct dm_pool_metadata *pmd)
2054 down_read(&pmd->root_lock);
2056 dm_tm_issue_prefetches(pmd->tm);
2057 up_read(&pmd->root_lock);