^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_BMAP_ITEM_H__
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) #define __XFS_BMAP_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) two pairs of bmap btree redo item types: map & unmap.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) * The common abbreviations for these are BUI (bmap update intent) and BUD
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) * (bmap update done). The redo item type is encoded in the flags field of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) * 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 bmbt updates.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) * Should the system crash after the commit of the first transaction but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) * before the commit of the final transaction in a series, log recovery will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) * use the redo information recorded by the intent items to replay the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) * bmbt metadata updates in the non-first transaction.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) /* kernel only BUI/BUD definitions */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) struct xfs_mount;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) struct kmem_zone;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) * Max number of extents in fast allocation path.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) #define XFS_BUI_MAX_FAST_EXTENTS 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) * This is the "bmap update intent" log item. It is used to log the fact that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) * some reverse mappings need to change. It is used in conjunction with the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) * "bmap update done" log item described below.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) * These log items follow the same rules as struct xfs_efi_log_item; see the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) * comments about that structure (in xfs_extfree_item.h) for more details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) struct xfs_bui_log_item {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) struct xfs_log_item bui_item;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) atomic_t bui_refcount;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) atomic_t bui_next_extent;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) struct xfs_bui_log_format bui_format;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) static inline size_t
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) xfs_bui_log_item_sizeof(
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) unsigned int nr)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) return offsetof(struct xfs_bui_log_item, bui_format) +
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) xfs_bui_log_format_sizeof(nr);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) * This is the "bmap update done" log item. It is used to log the fact that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) * some bmbt updates mentioned in an earlier bui item have been performed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) struct xfs_bud_log_item {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) struct xfs_log_item bud_item;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) struct xfs_bui_log_item *bud_buip;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) struct xfs_bud_log_format bud_format;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) extern struct kmem_zone *xfs_bui_zone;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) extern struct kmem_zone *xfs_bud_zone;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) #endif /* __XFS_BMAP_ITEM_H__ */