1 /* SPDX-License-Identifier: GPL-2.0+ */ 2 /* 3 * Copyright (C) 2016 Oracle. All Rights Reserved. 4 * Author: Darrick J. Wong <darrick.wong@oracle.com> 5 */ 6 #ifndef __XFS_DEFER_H__ 7 #define __XFS_DEFER_H__ 8 9 struct xfs_btree_cur; 10 struct xfs_defer_op_type; 11 struct xfs_defer_capture; 12 13 /* 14 * Header for deferred operation list. 15 */ 16 enum xfs_defer_ops_type { 17 XFS_DEFER_OPS_TYPE_BMAP, 18 XFS_DEFER_OPS_TYPE_REFCOUNT, 19 XFS_DEFER_OPS_TYPE_RMAP, 20 XFS_DEFER_OPS_TYPE_FREE, 21 XFS_DEFER_OPS_TYPE_AGFL_FREE, 22 XFS_DEFER_OPS_TYPE_MAX, 23 }; 24 25 /* 26 * Save a log intent item and a list of extents, so that we can replay 27 * whatever action had to happen to the extent list and file the log done 28 * item. 29 */ 30 struct xfs_defer_pending { 31 struct list_head dfp_list; /* pending items */ 32 struct list_head dfp_work; /* work items */ 33 struct xfs_log_item *dfp_intent; /* log intent item */ 34 struct xfs_log_item *dfp_done; /* log done item */ 35 unsigned int dfp_count; /* # extent items */ 36 enum xfs_defer_ops_type dfp_type; 37 }; 38 39 void xfs_defer_add(struct xfs_trans *tp, enum xfs_defer_ops_type type, 40 struct list_head *h); 41 int xfs_defer_finish_noroll(struct xfs_trans **tp); 42 int xfs_defer_finish(struct xfs_trans **tp); 43 void xfs_defer_cancel(struct xfs_trans *); 44 void xfs_defer_move(struct xfs_trans *dtp, struct xfs_trans *stp); 45 46 /* Description of a deferred type. */ 47 struct xfs_defer_op_type { 48 struct xfs_log_item *(*create_intent)(struct xfs_trans *tp, 49 struct list_head *items, unsigned int count, bool sort); 50 void (*abort_intent)(struct xfs_log_item *intent); 51 struct xfs_log_item *(*create_done)(struct xfs_trans *tp, 52 struct xfs_log_item *intent, unsigned int count); 53 int (*finish_item)(struct xfs_trans *tp, struct xfs_log_item *done, 54 struct list_head *item, struct xfs_btree_cur **state); 55 void (*finish_cleanup)(struct xfs_trans *tp, 56 struct xfs_btree_cur *state, int error); 57 void (*cancel_item)(struct list_head *item); 58 unsigned int max_items; 59 }; 60 61 extern const struct xfs_defer_op_type xfs_bmap_update_defer_type; 62 extern const struct xfs_defer_op_type xfs_refcount_update_defer_type; 63 extern const struct xfs_defer_op_type xfs_rmap_update_defer_type; 64 extern const struct xfs_defer_op_type xfs_extent_free_defer_type; 65 extern const struct xfs_defer_op_type xfs_agfl_free_defer_type; 66 67 /* 68 * This structure enables a dfops user to detach the chain of deferred 69 * operations from a transaction so that they can be continued later. 70 */ 71 struct xfs_defer_capture { 72 /* List of other capture structures. */ 73 struct list_head dfc_list; 74 75 /* Deferred ops state saved from the transaction. */ 76 struct list_head dfc_dfops; 77 unsigned int dfc_tpflags; 78 79 /* Block reservations for the data and rt devices. */ 80 unsigned int dfc_blkres; 81 unsigned int dfc_rtxres; 82 83 /* Log reservation saved from the transaction. */ 84 unsigned int dfc_logres; 85 86 /* 87 * An inode reference that must be maintained to complete the deferred 88 * work. 89 */ 90 struct xfs_inode *dfc_capture_ip; 91 }; 92 93 /* 94 * Functions to capture a chain of deferred operations and continue them later. 95 * This doesn't normally happen except log recovery. 96 */ 97 int xfs_defer_ops_capture_and_commit(struct xfs_trans *tp, 98 struct xfs_inode *capture_ip, struct list_head *capture_list); 99 void xfs_defer_ops_continue(struct xfs_defer_capture *d, struct xfs_trans *tp, 100 struct xfs_inode **captured_ipp); 101 void xfs_defer_ops_release(struct xfs_mount *mp, struct xfs_defer_capture *d); 102 103 #endif /* __XFS_DEFER_H__ */ 104