Loading...
1// SPDX-License-Identifier: GPL-2.0
2/*
3 * Copyright (c) 2000,2005 Silicon Graphics, Inc.
4 * All Rights Reserved.
5 */
6#ifndef __XFS_LOG_RECOVER_H__
7#define __XFS_LOG_RECOVER_H__
8
9/*
10 * Each log item type (XFS_LI_*) gets its own xlog_recover_item_ops to
11 * define how recovery should work for that type of log item.
12 */
13struct xlog_recover_item;
14struct xfs_defer_op_type;
15
16/* Sorting hat for log items as they're read in. */
17enum xlog_recover_reorder {
18 XLOG_REORDER_BUFFER_LIST,
19 XLOG_REORDER_ITEM_LIST,
20 XLOG_REORDER_INODE_BUFFER_LIST,
21 XLOG_REORDER_CANCEL_LIST,
22};
23
24struct xlog_recover_item_ops {
25 uint16_t item_type; /* XFS_LI_* type code. */
26
27 /*
28 * Help sort recovered log items into the order required to replay them
29 * correctly. Log item types that always use XLOG_REORDER_ITEM_LIST do
30 * not have to supply a function here. See the comment preceding
31 * xlog_recover_reorder_trans for more details about what the return
32 * values mean.
33 */
34 enum xlog_recover_reorder (*reorder)(struct xlog_recover_item *item);
35
36 /* Start readahead for pass2, if provided. */
37 void (*ra_pass2)(struct xlog *log, struct xlog_recover_item *item);
38
39 /* Do whatever work we need to do for pass1, if provided. */
40 int (*commit_pass1)(struct xlog *log, struct xlog_recover_item *item);
41
42 /*
43 * This function should do whatever work is needed for pass2 of log
44 * recovery, if provided.
45 *
46 * If the recovered item is an intent item, this function should parse
47 * the recovered item to construct an in-core log intent item and
48 * insert it into the AIL. The in-core log intent item should have 1
49 * refcount so that the item is freed either (a) when we commit the
50 * recovered log item for the intent-done item; (b) replay the work and
51 * log a new intent-done item; or (c) recovery fails and we have to
52 * abort.
53 *
54 * If the recovered item is an intent-done item, this function should
55 * parse the recovered item to find the id of the corresponding intent
56 * log item. Next, it should find the in-core log intent item in the
57 * AIL and release it.
58 */
59 int (*commit_pass2)(struct xlog *log, struct list_head *buffer_list,
60 struct xlog_recover_item *item, xfs_lsn_t lsn);
61};
62
63extern const struct xlog_recover_item_ops xlog_icreate_item_ops;
64extern const struct xlog_recover_item_ops xlog_buf_item_ops;
65extern const struct xlog_recover_item_ops xlog_inode_item_ops;
66extern const struct xlog_recover_item_ops xlog_dquot_item_ops;
67extern const struct xlog_recover_item_ops xlog_quotaoff_item_ops;
68extern const struct xlog_recover_item_ops xlog_bui_item_ops;
69extern const struct xlog_recover_item_ops xlog_bud_item_ops;
70extern const struct xlog_recover_item_ops xlog_efi_item_ops;
71extern const struct xlog_recover_item_ops xlog_efd_item_ops;
72extern const struct xlog_recover_item_ops xlog_rui_item_ops;
73extern const struct xlog_recover_item_ops xlog_rud_item_ops;
74extern const struct xlog_recover_item_ops xlog_cui_item_ops;
75extern const struct xlog_recover_item_ops xlog_cud_item_ops;
76extern const struct xlog_recover_item_ops xlog_attri_item_ops;
77extern const struct xlog_recover_item_ops xlog_attrd_item_ops;
78
79/*
80 * Macros, structures, prototypes for internal log manager use.
81 */
82
83#define XLOG_RHASH_BITS 4
84#define XLOG_RHASH_SIZE 16
85#define XLOG_RHASH_SHIFT 2
86#define XLOG_RHASH(tid) \
87 ((((uint32_t)tid)>>XLOG_RHASH_SHIFT) & (XLOG_RHASH_SIZE-1))
88
89#define XLOG_MAX_REGIONS_IN_ITEM (XFS_MAX_BLOCKSIZE / XFS_BLF_CHUNK / 2 + 1)
90
91
92/*
93 * item headers are in ri_buf[0]. Additional buffers follow.
94 */
95struct xlog_recover_item {
96 struct list_head ri_list;
97 int ri_cnt; /* count of regions found */
98 int ri_total; /* total regions */
99 struct xfs_log_iovec *ri_buf; /* ptr to regions buffer */
100 const struct xlog_recover_item_ops *ri_ops;
101};
102
103struct xlog_recover {
104 struct hlist_node r_list;
105 xlog_tid_t r_log_tid; /* log's transaction id */
106 xfs_trans_header_t r_theader; /* trans header for partial */
107 int r_state; /* not needed */
108 xfs_lsn_t r_lsn; /* xact lsn */
109 struct list_head r_itemq; /* q for items */
110};
111
112#define ITEM_TYPE(i) (*(unsigned short *)(i)->ri_buf[0].i_addr)
113
114#define XLOG_RECOVER_CRCPASS 0
115#define XLOG_RECOVER_PASS1 1
116#define XLOG_RECOVER_PASS2 2
117
118void xlog_buf_readahead(struct xlog *log, xfs_daddr_t blkno, uint len,
119 const struct xfs_buf_ops *ops);
120bool xlog_is_buffer_cancelled(struct xlog *log, xfs_daddr_t blkno, uint len);
121
122int xlog_recover_iget(struct xfs_mount *mp, xfs_ino_t ino,
123 struct xfs_inode **ipp);
124void xlog_recover_release_intent(struct xlog *log, unsigned short intent_type,
125 uint64_t intent_id);
126int xlog_alloc_buf_cancel_table(struct xlog *log);
127void xlog_free_buf_cancel_table(struct xlog *log);
128
129#ifdef DEBUG
130void xlog_check_buf_cancel_table(struct xlog *log);
131#else
132#define xlog_check_buf_cancel_table(log) do { } while (0)
133#endif
134
135/*
136 * Transform a regular reservation into one suitable for recovery of a log
137 * intent item.
138 *
139 * Intent recovery only runs a single step of the transaction chain and defers
140 * the rest to a separate transaction. Therefore, we reduce logcount to 1 here
141 * to avoid livelocks if the log grant space is nearly exhausted due to the
142 * recovered intent pinning the tail. Keep the same logflags to avoid tripping
143 * asserts elsewhere. Struct copies abound below.
144 */
145static inline struct xfs_trans_res
146xlog_recover_resv(const struct xfs_trans_res *r)
147{
148 struct xfs_trans_res ret = {
149 .tr_logres = r->tr_logres,
150 .tr_logcount = 1,
151 .tr_logflags = r->tr_logflags,
152 };
153
154 return ret;
155}
156
157struct xfs_defer_pending;
158
159void xlog_recover_intent_item(struct xlog *log, struct xfs_log_item *lip,
160 xfs_lsn_t lsn, const struct xfs_defer_op_type *ops);
161int xlog_recover_finish_intent(struct xfs_trans *tp,
162 struct xfs_defer_pending *dfp);
163
164#endif /* __XFS_LOG_RECOVER_H__ */
1// SPDX-License-Identifier: GPL-2.0
2/*
3 * Copyright (c) 2000,2005 Silicon Graphics, Inc.
4 * All Rights Reserved.
5 */
6#ifndef __XFS_LOG_RECOVER_H__
7#define __XFS_LOG_RECOVER_H__
8
9/*
10 * Each log item type (XFS_LI_*) gets its own xlog_recover_item_ops to
11 * define how recovery should work for that type of log item.
12 */
13struct xlog_recover_item;
14struct xfs_defer_op_type;
15
16/* Sorting hat for log items as they're read in. */
17enum xlog_recover_reorder {
18 XLOG_REORDER_BUFFER_LIST,
19 XLOG_REORDER_ITEM_LIST,
20 XLOG_REORDER_INODE_BUFFER_LIST,
21 XLOG_REORDER_CANCEL_LIST,
22};
23
24struct xlog_recover_item_ops {
25 uint16_t item_type; /* XFS_LI_* type code. */
26
27 /*
28 * Help sort recovered log items into the order required to replay them
29 * correctly. Log item types that always use XLOG_REORDER_ITEM_LIST do
30 * not have to supply a function here. See the comment preceding
31 * xlog_recover_reorder_trans for more details about what the return
32 * values mean.
33 */
34 enum xlog_recover_reorder (*reorder)(struct xlog_recover_item *item);
35
36 /* Start readahead for pass2, if provided. */
37 void (*ra_pass2)(struct xlog *log, struct xlog_recover_item *item);
38
39 /* Do whatever work we need to do for pass1, if provided. */
40 int (*commit_pass1)(struct xlog *log, struct xlog_recover_item *item);
41
42 /*
43 * This function should do whatever work is needed for pass2 of log
44 * recovery, if provided.
45 *
46 * If the recovered item is an intent item, this function should parse
47 * the recovered item to construct an in-core log intent item and
48 * insert it into the AIL. The in-core log intent item should have 1
49 * refcount so that the item is freed either (a) when we commit the
50 * recovered log item for the intent-done item; (b) replay the work and
51 * log a new intent-done item; or (c) recovery fails and we have to
52 * abort.
53 *
54 * If the recovered item is an intent-done item, this function should
55 * parse the recovered item to find the id of the corresponding intent
56 * log item. Next, it should find the in-core log intent item in the
57 * AIL and release it.
58 */
59 int (*commit_pass2)(struct xlog *log, struct list_head *buffer_list,
60 struct xlog_recover_item *item, xfs_lsn_t lsn);
61};
62
63extern const struct xlog_recover_item_ops xlog_icreate_item_ops;
64extern const struct xlog_recover_item_ops xlog_buf_item_ops;
65extern const struct xlog_recover_item_ops xlog_inode_item_ops;
66extern const struct xlog_recover_item_ops xlog_dquot_item_ops;
67extern const struct xlog_recover_item_ops xlog_quotaoff_item_ops;
68extern const struct xlog_recover_item_ops xlog_bui_item_ops;
69extern const struct xlog_recover_item_ops xlog_bud_item_ops;
70extern const struct xlog_recover_item_ops xlog_efi_item_ops;
71extern const struct xlog_recover_item_ops xlog_efd_item_ops;
72extern const struct xlog_recover_item_ops xlog_rui_item_ops;
73extern const struct xlog_recover_item_ops xlog_rud_item_ops;
74extern const struct xlog_recover_item_ops xlog_cui_item_ops;
75extern const struct xlog_recover_item_ops xlog_cud_item_ops;
76extern const struct xlog_recover_item_ops xlog_attri_item_ops;
77extern const struct xlog_recover_item_ops xlog_attrd_item_ops;
78extern const struct xlog_recover_item_ops xlog_xmi_item_ops;
79extern const struct xlog_recover_item_ops xlog_xmd_item_ops;
80extern const struct xlog_recover_item_ops xlog_rtefi_item_ops;
81extern const struct xlog_recover_item_ops xlog_rtefd_item_ops;
82
83/*
84 * Macros, structures, prototypes for internal log manager use.
85 */
86
87#define XLOG_RHASH_BITS 4
88#define XLOG_RHASH_SIZE 16
89#define XLOG_RHASH_SHIFT 2
90#define XLOG_RHASH(tid) \
91 ((((uint32_t)tid)>>XLOG_RHASH_SHIFT) & (XLOG_RHASH_SIZE-1))
92
93#define XLOG_MAX_REGIONS_IN_ITEM (XFS_MAX_BLOCKSIZE / XFS_BLF_CHUNK / 2 + 1)
94
95
96/*
97 * item headers are in ri_buf[0]. Additional buffers follow.
98 */
99struct xlog_recover_item {
100 struct list_head ri_list;
101 int ri_cnt; /* count of regions found */
102 int ri_total; /* total regions */
103 struct xfs_log_iovec *ri_buf; /* ptr to regions buffer */
104 const struct xlog_recover_item_ops *ri_ops;
105};
106
107struct xlog_recover {
108 struct hlist_node r_list;
109 xlog_tid_t r_log_tid; /* log's transaction id */
110 xfs_trans_header_t r_theader; /* trans header for partial */
111 int r_state; /* not needed */
112 xfs_lsn_t r_lsn; /* xact lsn */
113 struct list_head r_itemq; /* q for items */
114};
115
116#define ITEM_TYPE(i) (*(unsigned short *)(i)->ri_buf[0].i_addr)
117
118#define XLOG_RECOVER_CRCPASS 0
119#define XLOG_RECOVER_PASS1 1
120#define XLOG_RECOVER_PASS2 2
121
122void xlog_buf_readahead(struct xlog *log, xfs_daddr_t blkno, uint len,
123 const struct xfs_buf_ops *ops);
124bool xlog_is_buffer_cancelled(struct xlog *log, xfs_daddr_t blkno, uint len);
125
126int xlog_recover_iget(struct xfs_mount *mp, xfs_ino_t ino,
127 struct xfs_inode **ipp);
128int xlog_recover_iget_handle(struct xfs_mount *mp, xfs_ino_t ino, uint32_t gen,
129 struct xfs_inode **ipp);
130void xlog_recover_release_intent(struct xlog *log, unsigned short intent_type,
131 uint64_t intent_id);
132int xlog_alloc_buf_cancel_table(struct xlog *log);
133void xlog_free_buf_cancel_table(struct xlog *log);
134
135#ifdef DEBUG
136void xlog_check_buf_cancel_table(struct xlog *log);
137#else
138#define xlog_check_buf_cancel_table(log) do { } while (0)
139#endif
140
141/*
142 * Transform a regular reservation into one suitable for recovery of a log
143 * intent item.
144 *
145 * Intent recovery only runs a single step of the transaction chain and defers
146 * the rest to a separate transaction. Therefore, we reduce logcount to 1 here
147 * to avoid livelocks if the log grant space is nearly exhausted due to the
148 * recovered intent pinning the tail. Keep the same logflags to avoid tripping
149 * asserts elsewhere. Struct copies abound below.
150 */
151static inline struct xfs_trans_res
152xlog_recover_resv(const struct xfs_trans_res *r)
153{
154 struct xfs_trans_res ret = {
155 .tr_logres = r->tr_logres,
156 .tr_logcount = 1,
157 .tr_logflags = r->tr_logflags,
158 };
159
160 return ret;
161}
162
163struct xfs_defer_pending;
164
165void xlog_recover_intent_item(struct xlog *log, struct xfs_log_item *lip,
166 xfs_lsn_t lsn, const struct xfs_defer_op_type *ops);
167int xlog_recover_finish_intent(struct xfs_trans *tp,
168 struct xfs_defer_pending *dfp);
169
170#endif /* __XFS_LOG_RECOVER_H__ */