xref: /openbmc/linux/fs/xfs/libxfs/xfs_defer.h (revision cd3c2cf3)
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_ATTR,
23 	XFS_DEFER_OPS_TYPE_MAX,
24 };
25 
26 /*
27  * Save a log intent item and a list of extents, so that we can replay
28  * whatever action had to happen to the extent list and file the log done
29  * item.
30  */
31 struct xfs_defer_pending {
32 	struct list_head		dfp_list;	/* pending items */
33 	struct list_head		dfp_work;	/* work items */
34 	struct xfs_log_item		*dfp_intent;	/* log intent item */
35 	struct xfs_log_item		*dfp_done;	/* log done item */
36 	unsigned int			dfp_count;	/* # extent items */
37 	enum xfs_defer_ops_type		dfp_type;
38 };
39 
40 void xfs_defer_add(struct xfs_trans *tp, enum xfs_defer_ops_type type,
41 		struct list_head *h);
42 int xfs_defer_finish_noroll(struct xfs_trans **tp);
43 int xfs_defer_finish(struct xfs_trans **tp);
44 void xfs_defer_cancel(struct xfs_trans *);
45 void xfs_defer_move(struct xfs_trans *dtp, struct xfs_trans *stp);
46 
47 /* Description of a deferred type. */
48 struct xfs_defer_op_type {
49 	struct xfs_log_item *(*create_intent)(struct xfs_trans *tp,
50 			struct list_head *items, unsigned int count, bool sort);
51 	void (*abort_intent)(struct xfs_log_item *intent);
52 	struct xfs_log_item *(*create_done)(struct xfs_trans *tp,
53 			struct xfs_log_item *intent, unsigned int count);
54 	int (*finish_item)(struct xfs_trans *tp, struct xfs_log_item *done,
55 			struct list_head *item, struct xfs_btree_cur **state);
56 	void (*finish_cleanup)(struct xfs_trans *tp,
57 			struct xfs_btree_cur *state, int error);
58 	void (*cancel_item)(struct list_head *item);
59 	unsigned int		max_items;
60 };
61 
62 extern const struct xfs_defer_op_type xfs_bmap_update_defer_type;
63 extern const struct xfs_defer_op_type xfs_refcount_update_defer_type;
64 extern const struct xfs_defer_op_type xfs_rmap_update_defer_type;
65 extern const struct xfs_defer_op_type xfs_extent_free_defer_type;
66 extern const struct xfs_defer_op_type xfs_agfl_free_defer_type;
67 extern const struct xfs_defer_op_type xfs_attr_defer_type;
68 
69 
70 /*
71  * Deferred operation item relogging limits.
72  */
73 #define XFS_DEFER_OPS_NR_INODES	2	/* join up to two inodes */
74 #define XFS_DEFER_OPS_NR_BUFS	2	/* join up to two buffers */
75 
76 /* Resources that must be held across a transaction roll. */
77 struct xfs_defer_resources {
78 	/* held buffers */
79 	struct xfs_buf		*dr_bp[XFS_DEFER_OPS_NR_BUFS];
80 
81 	/* inodes with no unlock flags */
82 	struct xfs_inode	*dr_ip[XFS_DEFER_OPS_NR_INODES];
83 
84 	/* number of held buffers */
85 	unsigned short		dr_bufs;
86 
87 	/* bitmap of ordered buffers */
88 	unsigned short		dr_ordered;
89 
90 	/* number of held inodes */
91 	unsigned short		dr_inos;
92 };
93 
94 /*
95  * This structure enables a dfops user to detach the chain of deferred
96  * operations from a transaction so that they can be continued later.
97  */
98 struct xfs_defer_capture {
99 	/* List of other capture structures. */
100 	struct list_head	dfc_list;
101 
102 	/* Deferred ops state saved from the transaction. */
103 	struct list_head	dfc_dfops;
104 	unsigned int		dfc_tpflags;
105 
106 	/* Block reservations for the data and rt devices. */
107 	unsigned int		dfc_blkres;
108 	unsigned int		dfc_rtxres;
109 
110 	/* Log reservation saved from the transaction. */
111 	unsigned int		dfc_logres;
112 
113 	struct xfs_defer_resources dfc_held;
114 };
115 
116 /*
117  * Functions to capture a chain of deferred operations and continue them later.
118  * This doesn't normally happen except log recovery.
119  */
120 int xfs_defer_ops_capture_and_commit(struct xfs_trans *tp,
121 		struct list_head *capture_list);
122 void xfs_defer_ops_continue(struct xfs_defer_capture *d, struct xfs_trans *tp,
123 		struct xfs_defer_resources *dres);
124 void xfs_defer_ops_capture_abort(struct xfs_mount *mp,
125 		struct xfs_defer_capture *d);
126 void xfs_defer_resources_rele(struct xfs_defer_resources *dres);
127 
128 void xfs_defer_start_recovery(struct xfs_log_item *lip,
129 		enum xfs_defer_ops_type dfp_type, struct list_head *r_dfops);
130 void xfs_defer_cancel_recovery(struct xfs_mount *mp,
131 		struct xfs_defer_pending *dfp);
132 
133 int __init xfs_defer_init_item_caches(void);
134 void xfs_defer_destroy_item_caches(void);
135 
136 #endif /* __XFS_DEFER_H__ */
137