1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Copyright (c) 2000,2002,2005 Silicon Graphics, Inc.
4 * All Rights Reserved.
5 */
6 #ifndef __XFS_TRANS_PRIV_H__
7 #define __XFS_TRANS_PRIV_H__
8
9 struct xfs_log_item;
10 struct xfs_mount;
11 struct xfs_trans;
12 struct xfs_ail;
13 struct xfs_log_vec;
14
15
16 void xfs_trans_init(struct xfs_mount *);
17 void xfs_trans_add_item(struct xfs_trans *, struct xfs_log_item *);
18 void xfs_trans_del_item(struct xfs_log_item *);
19 void xfs_trans_unreserve_and_mod_sb(struct xfs_trans *tp);
20
21 void xfs_trans_committed_bulk(struct xfs_ail *ailp, struct xfs_log_vec *lv,
22 xfs_lsn_t commit_lsn, bool aborted);
23 /*
24 * AIL traversal cursor.
25 *
26 * Rather than using a generation number for detecting changes in the ail, use
27 * a cursor that is protected by the ail lock. The aild cursor exists in the
28 * struct xfs_ail, but other traversals can declare it on the stack and link it
29 * to the ail list.
30 *
31 * When an object is deleted from or moved int the AIL, the cursor list is
32 * searched to see if the object is a designated cursor item. If it is, it is
33 * deleted from the cursor so that the next time the cursor is used traversal
34 * will return to the start.
35 *
36 * This means a traversal colliding with a removal will cause a restart of the
37 * list scan, rather than any insertion or deletion anywhere in the list. The
38 * low bit of the item pointer is set if the cursor has been invalidated so
39 * that we can tell the difference between invalidation and reaching the end
40 * of the list to trigger traversal restarts.
41 */
42 struct xfs_ail_cursor {
43 struct list_head list;
44 struct xfs_log_item *item;
45 };
46
47 /*
48 * Private AIL structures.
49 *
50 * Eventually we need to drive the locking in here as well.
51 */
52 struct xfs_ail {
53 struct xfs_mount *ail_mount;
54 struct task_struct *ail_task;
55 struct list_head ail_head;
56 xfs_lsn_t ail_target;
57 xfs_lsn_t ail_target_prev;
58 struct list_head ail_cursors;
59 spinlock_t ail_lock;
60 xfs_lsn_t ail_last_pushed_lsn;
61 int ail_log_flush;
62 struct list_head ail_buf_list;
63 wait_queue_head_t ail_empty;
64 };
65
66 /*
67 * From xfs_trans_ail.c
68 */
69 void xfs_trans_ail_update_bulk(struct xfs_ail *ailp,
70 struct xfs_ail_cursor *cur,
71 struct xfs_log_item **log_items, int nr_items,
72 xfs_lsn_t lsn) __releases(ailp->ail_lock);
73 /*
74 * Return a pointer to the first item in the AIL. If the AIL is empty, then
75 * return NULL.
76 */
77 static inline struct xfs_log_item *
xfs_ail_min(struct xfs_ail * ailp)78 xfs_ail_min(
79 struct xfs_ail *ailp)
80 {
81 return list_first_entry_or_null(&ailp->ail_head, struct xfs_log_item,
82 li_ail);
83 }
84
85 static inline void
xfs_trans_ail_update(struct xfs_ail * ailp,struct xfs_log_item * lip,xfs_lsn_t lsn)86 xfs_trans_ail_update(
87 struct xfs_ail *ailp,
88 struct xfs_log_item *lip,
89 xfs_lsn_t lsn) __releases(ailp->ail_lock)
90 {
91 xfs_trans_ail_update_bulk(ailp, NULL, &lip, 1, lsn);
92 }
93
94 xfs_lsn_t xfs_ail_delete_one(struct xfs_ail *ailp, struct xfs_log_item *lip);
95 void xfs_ail_update_finish(struct xfs_ail *ailp, xfs_lsn_t old_lsn)
96 __releases(ailp->ail_lock);
97 void xfs_trans_ail_delete(struct xfs_ail *ailp, struct xfs_log_item *lip,
98 int shutdown_type);
99
100 static inline void
xfs_trans_ail_remove(struct xfs_log_item * lip,int shutdown_type)101 xfs_trans_ail_remove(
102 struct xfs_log_item *lip,
103 int shutdown_type)
104 {
105 struct xfs_ail *ailp = lip->li_ailp;
106
107 spin_lock(&ailp->ail_lock);
108 /* xfs_trans_ail_delete() drops the AIL lock */
109 if (test_bit(XFS_LI_IN_AIL, &lip->li_flags))
110 xfs_trans_ail_delete(ailp, lip, shutdown_type);
111 else
112 spin_unlock(&ailp->ail_lock);
113 }
114
115 void xfs_ail_push(struct xfs_ail *, xfs_lsn_t);
116 void xfs_ail_push_all(struct xfs_ail *);
117 void xfs_ail_push_all_sync(struct xfs_ail *);
118 struct xfs_log_item *xfs_ail_min(struct xfs_ail *ailp);
119 xfs_lsn_t xfs_ail_min_lsn(struct xfs_ail *ailp);
120
121 struct xfs_log_item * xfs_trans_ail_cursor_first(struct xfs_ail *ailp,
122 struct xfs_ail_cursor *cur,
123 xfs_lsn_t lsn);
124 struct xfs_log_item * xfs_trans_ail_cursor_last(struct xfs_ail *ailp,
125 struct xfs_ail_cursor *cur,
126 xfs_lsn_t lsn);
127 struct xfs_log_item * xfs_trans_ail_cursor_next(struct xfs_ail *ailp,
128 struct xfs_ail_cursor *cur);
129 void xfs_trans_ail_cursor_done(struct xfs_ail_cursor *cur);
130
131 #if BITS_PER_LONG != 64
132 static inline void
xfs_trans_ail_copy_lsn(struct xfs_ail * ailp,xfs_lsn_t * dst,xfs_lsn_t * src)133 xfs_trans_ail_copy_lsn(
134 struct xfs_ail *ailp,
135 xfs_lsn_t *dst,
136 xfs_lsn_t *src)
137 {
138 ASSERT(sizeof(xfs_lsn_t) == 8); /* don't lock if it shrinks */
139 spin_lock(&ailp->ail_lock);
140 *dst = *src;
141 spin_unlock(&ailp->ail_lock);
142 }
143 #else
144 static inline void
xfs_trans_ail_copy_lsn(struct xfs_ail * ailp,xfs_lsn_t * dst,xfs_lsn_t * src)145 xfs_trans_ail_copy_lsn(
146 struct xfs_ail *ailp,
147 xfs_lsn_t *dst,
148 xfs_lsn_t *src)
149 {
150 ASSERT(sizeof(xfs_lsn_t) == 8);
151 *dst = *src;
152 }
153 #endif
154
155 static inline void
xfs_clear_li_failed(struct xfs_log_item * lip)156 xfs_clear_li_failed(
157 struct xfs_log_item *lip)
158 {
159 struct xfs_buf *bp = lip->li_buf;
160
161 ASSERT(test_bit(XFS_LI_IN_AIL, &lip->li_flags));
162 lockdep_assert_held(&lip->li_ailp->ail_lock);
163
164 if (test_and_clear_bit(XFS_LI_FAILED, &lip->li_flags)) {
165 lip->li_buf = NULL;
166 xfs_buf_rele(bp);
167 }
168 }
169
170 static inline void
xfs_set_li_failed(struct xfs_log_item * lip,struct xfs_buf * bp)171 xfs_set_li_failed(
172 struct xfs_log_item *lip,
173 struct xfs_buf *bp)
174 {
175 lockdep_assert_held(&lip->li_ailp->ail_lock);
176
177 if (!test_and_set_bit(XFS_LI_FAILED, &lip->li_flags)) {
178 xfs_buf_hold(bp);
179 lip->li_buf = bp;
180 }
181 }
182
183 #endif /* __XFS_TRANS_PRIV_H__ */
184