^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) // SPDX-License-Identifier: GPL-2.0+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) * Copyright (C) 2016 Oracle. All Rights Reserved.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) * Author: Darrick J. Wong <darrick.wong@oracle.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) #ifndef __XFS_RMAP_ITEM_H__
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) #define __XFS_RMAP_ITEM_H__
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) * There are (currently) three pairs of rmap btree redo item types: map, unmap,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) * and convert. The common abbreviations for these are RUI (rmap update
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) * intent) and RUD (rmap update done). The redo item type is encoded in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) * flags field of each xfs_map_extent.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) * *I items should be recorded in the *first* of a series of rolled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) * transactions, and the *D items should be recorded in the same transaction
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) * that records the associated rmapbt updates. Typically, the first
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) * transaction will record a bmbt update, followed by some number of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) * transactions containing rmapbt updates, and finally transactions with any
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) * bnobt/cntbt updates.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) * Should the system crash after the commit of the first transaction but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) * before the commit of the final transaction in a series, log recovery will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) * use the redo information recorded by the intent items to replay the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) * (rmapbt/bnobt/cntbt) metadata updates in the non-first transaction.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) /* kernel only RUI/RUD definitions */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) struct xfs_mount;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) struct kmem_zone;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) * Max number of extents in fast allocation path.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) #define XFS_RUI_MAX_FAST_EXTENTS 16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) * This is the "rmap update intent" log item. It is used to log the fact that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) * some reverse mappings need to change. It is used in conjunction with the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) * "rmap update done" log item described below.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) * These log items follow the same rules as struct xfs_efi_log_item; see the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) * comments about that structure (in xfs_extfree_item.h) for more details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) struct xfs_rui_log_item {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) struct xfs_log_item rui_item;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) atomic_t rui_refcount;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) atomic_t rui_next_extent;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) struct xfs_rui_log_format rui_format;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) static inline size_t
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) xfs_rui_log_item_sizeof(
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) unsigned int nr)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) return offsetof(struct xfs_rui_log_item, rui_format) +
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) xfs_rui_log_format_sizeof(nr);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) * This is the "rmap update done" log item. It is used to log the fact that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) * some rmapbt updates mentioned in an earlier rui item have been performed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) struct xfs_rud_log_item {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) struct xfs_log_item rud_item;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) struct xfs_rui_log_item *rud_ruip;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) struct xfs_rud_log_format rud_format;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) extern struct kmem_zone *xfs_rui_zone;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) extern struct kmem_zone *xfs_rud_zone;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) #endif /* __XFS_RMAP_ITEM_H__ */