Linux Audio

Check our new training course

Loading...
v3.1
 
  1/*
  2 * Copyright (c) 2000,2002,2005 Silicon Graphics, Inc.
  3 * All Rights Reserved.
  4 *
  5 * This program is free software; you can redistribute it and/or
  6 * modify it under the terms of the GNU General Public License as
  7 * published by the Free Software Foundation.
  8 *
  9 * This program is distributed in the hope that it would be useful,
 10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 12 * GNU General Public License for more details.
 13 *
 14 * You should have received a copy of the GNU General Public License
 15 * along with this program; if not, write the Free Software Foundation,
 16 * Inc.,  51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 17 */
 18#ifndef __XFS_TRANS_PRIV_H__
 19#define	__XFS_TRANS_PRIV_H__
 20
 
 21struct xfs_log_item;
 22struct xfs_log_item_desc;
 23struct xfs_mount;
 24struct xfs_trans;
 25struct xfs_ail;
 26struct xfs_log_vec;
 27
 
 
 28void	xfs_trans_add_item(struct xfs_trans *, struct xfs_log_item *);
 29void	xfs_trans_del_item(struct xfs_log_item *);
 30void	xfs_trans_free_items(struct xfs_trans *tp, xfs_lsn_t commit_lsn,
 31				int flags);
 32void	xfs_trans_unreserve_and_mod_sb(struct xfs_trans *tp);
 33
 34void	xfs_trans_committed_bulk(struct xfs_ail *ailp, struct xfs_log_vec *lv,
 35				xfs_lsn_t commit_lsn, int aborted);
 36/*
 37 * AIL traversal cursor.
 38 *
 39 * Rather than using a generation number for detecting changes in the ail, use
 40 * a cursor that is protected by the ail lock. The aild cursor exists in the
 41 * struct xfs_ail, but other traversals can declare it on the stack and link it
 42 * to the ail list.
 43 *
 44 * When an object is deleted from or moved int the AIL, the cursor list is
 45 * searched to see if the object is a designated cursor item. If it is, it is
 46 * deleted from the cursor so that the next time the cursor is used traversal
 47 * will return to the start.
 48 *
 49 * This means a traversal colliding with a removal will cause a restart of the
 50 * list scan, rather than any insertion or deletion anywhere in the list. The
 51 * low bit of the item pointer is set if the cursor has been invalidated so
 52 * that we can tell the difference between invalidation and reaching the end
 53 * of the list to trigger traversal restarts.
 54 */
 55struct xfs_ail_cursor {
 56	struct list_head	list;
 57	struct xfs_log_item	*item;
 58};
 59
 60/*
 61 * Private AIL structures.
 62 *
 63 * Eventually we need to drive the locking in here as well.
 64 */
 65struct xfs_ail {
 66	struct xfs_mount	*xa_mount;
 67	struct task_struct	*xa_task;
 68	struct list_head	xa_ail;
 69	xfs_lsn_t		xa_target;
 70	struct list_head	xa_cursors;
 71	spinlock_t		xa_lock;
 72	xfs_lsn_t		xa_last_pushed_lsn;
 
 
 
 
 
 73};
 74
 
 
 
 75/*
 76 * From xfs_trans_ail.c
 77 */
 78void	xfs_trans_ail_update_bulk(struct xfs_ail *ailp,
 79				struct xfs_ail_cursor *cur,
 80				struct xfs_log_item **log_items, int nr_items,
 81				xfs_lsn_t lsn) __releases(ailp->xa_lock);
 
 
 
 
 
 
 
 
 
 
 
 
 82static inline void
 83xfs_trans_ail_update(
 84	struct xfs_ail		*ailp,
 85	struct xfs_log_item	*lip,
 86	xfs_lsn_t		lsn) __releases(ailp->xa_lock)
 87{
 88	xfs_trans_ail_update_bulk(ailp, NULL, &lip, 1, lsn);
 89}
 90
 91void	xfs_trans_ail_delete_bulk(struct xfs_ail *ailp,
 92				struct xfs_log_item **log_items, int nr_items)
 93				__releases(ailp->xa_lock);
 94static inline void
 95xfs_trans_ail_delete(
 96	struct xfs_ail	*ailp,
 97	xfs_log_item_t	*lip) __releases(ailp->xa_lock)
 
 
 98{
 99	xfs_trans_ail_delete_bulk(ailp, &lip, 1);
100}
101
102void			xfs_ail_push(struct xfs_ail *, xfs_lsn_t);
103void			xfs_ail_push_all(struct xfs_ail *);
104xfs_lsn_t		xfs_ail_min_lsn(struct xfs_ail *ailp);
 
 
105
106void			xfs_trans_unlocked_item(struct xfs_ail *,
107					xfs_log_item_t *);
 
 
 
 
 
108
109struct xfs_log_item *	xfs_trans_ail_cursor_first(struct xfs_ail *ailp,
110					struct xfs_ail_cursor *cur,
111					xfs_lsn_t lsn);
112struct xfs_log_item *	xfs_trans_ail_cursor_last(struct xfs_ail *ailp,
113					struct xfs_ail_cursor *cur,
114					xfs_lsn_t lsn);
115struct xfs_log_item *	xfs_trans_ail_cursor_next(struct xfs_ail *ailp,
116					struct xfs_ail_cursor *cur);
117void			xfs_trans_ail_cursor_done(struct xfs_ail *ailp,
118					struct xfs_ail_cursor *cur);
 
 
 
 
 
 
 
 
 
 
 
119
120#if BITS_PER_LONG != 64
121static inline void
122xfs_trans_ail_copy_lsn(
123	struct xfs_ail	*ailp,
124	xfs_lsn_t	*dst,
125	xfs_lsn_t	*src)
126{
127	ASSERT(sizeof(xfs_lsn_t) == 8);	/* don't lock if it shrinks */
128	spin_lock(&ailp->xa_lock);
129	*dst = *src;
130	spin_unlock(&ailp->xa_lock);
131}
132#else
133static inline void
134xfs_trans_ail_copy_lsn(
135	struct xfs_ail	*ailp,
136	xfs_lsn_t	*dst,
137	xfs_lsn_t	*src)
138{
139	ASSERT(sizeof(xfs_lsn_t) == 8);
140	*dst = *src;
141}
142#endif
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
143#endif	/* __XFS_TRANS_PRIV_H__ */
v6.13.7
  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
  9struct xlog;
 10struct xfs_log_item;
 
 11struct xfs_mount;
 12struct xfs_trans;
 13struct xfs_ail;
 14struct xfs_log_vec;
 15
 16
 17void	xfs_trans_init(struct xfs_mount *);
 18void	xfs_trans_add_item(struct xfs_trans *, struct xfs_log_item *);
 19void	xfs_trans_del_item(struct xfs_log_item *);
 
 
 20void	xfs_trans_unreserve_and_mod_sb(struct xfs_trans *tp);
 21
 
 
 22/*
 23 * AIL traversal cursor.
 24 *
 25 * Rather than using a generation number for detecting changes in the ail, use
 26 * a cursor that is protected by the ail lock. The aild cursor exists in the
 27 * struct xfs_ail, but other traversals can declare it on the stack and link it
 28 * to the ail list.
 29 *
 30 * When an object is deleted from or moved int the AIL, the cursor list is
 31 * searched to see if the object is a designated cursor item. If it is, it is
 32 * deleted from the cursor so that the next time the cursor is used traversal
 33 * will return to the start.
 34 *
 35 * This means a traversal colliding with a removal will cause a restart of the
 36 * list scan, rather than any insertion or deletion anywhere in the list. The
 37 * low bit of the item pointer is set if the cursor has been invalidated so
 38 * that we can tell the difference between invalidation and reaching the end
 39 * of the list to trigger traversal restarts.
 40 */
 41struct xfs_ail_cursor {
 42	struct list_head	list;
 43	struct xfs_log_item	*item;
 44};
 45
 46/*
 47 * Private AIL structures.
 48 *
 49 * Eventually we need to drive the locking in here as well.
 50 */
 51struct xfs_ail {
 52	struct xlog		*ail_log;
 53	struct task_struct	*ail_task;
 54	struct list_head	ail_head;
 55	struct list_head	ail_cursors;
 56	spinlock_t		ail_lock;
 57	xfs_lsn_t		ail_last_pushed_lsn;
 58	xfs_lsn_t		ail_head_lsn;
 59	int			ail_log_flush;
 60	unsigned long		ail_opstate;
 61	struct list_head	ail_buf_list;
 62	wait_queue_head_t	ail_empty;
 63	xfs_lsn_t		ail_target;
 64};
 65
 66/* Push all items out of the AIL immediately. */
 67#define XFS_AIL_OPSTATE_PUSH_ALL	0u
 68
 69/*
 70 * From xfs_trans_ail.c
 71 */
 72void	xfs_trans_ail_update_bulk(struct xfs_ail *ailp,
 73				struct xfs_ail_cursor *cur,
 74				struct xfs_log_item **log_items, int nr_items,
 75				xfs_lsn_t lsn) __releases(ailp->ail_lock);
 76/*
 77 * Return a pointer to the first item in the AIL.  If the AIL is empty, then
 78 * return NULL.
 79 */
 80static inline struct xfs_log_item *
 81xfs_ail_min(
 82	struct xfs_ail  *ailp)
 83{
 84	return list_first_entry_or_null(&ailp->ail_head, struct xfs_log_item,
 85					li_ail);
 86}
 87
 88static inline void
 89xfs_trans_ail_update(
 90	struct xfs_ail		*ailp,
 91	struct xfs_log_item	*lip,
 92	xfs_lsn_t		lsn) __releases(ailp->ail_lock)
 93{
 94	xfs_trans_ail_update_bulk(ailp, NULL, &lip, 1, lsn);
 95}
 96
 97void xfs_trans_ail_insert(struct xfs_ail *ailp, struct xfs_log_item *lip,
 98		xfs_lsn_t lsn);
 99
100xfs_lsn_t xfs_ail_delete_one(struct xfs_ail *ailp, struct xfs_log_item *lip);
101void xfs_ail_update_finish(struct xfs_ail *ailp, xfs_lsn_t old_lsn)
102			__releases(ailp->ail_lock);
103void xfs_trans_ail_delete(struct xfs_log_item *lip, int shutdown_type);
104
105static inline void xfs_ail_push(struct xfs_ail *ailp)
106{
107	wake_up_process(ailp->ail_task);
108}
109
110static inline void xfs_ail_push_all(struct xfs_ail *ailp)
111{
112	if (!test_and_set_bit(XFS_AIL_OPSTATE_PUSH_ALL, &ailp->ail_opstate))
113		xfs_ail_push(ailp);
114}
115
116static inline xfs_lsn_t xfs_ail_get_push_target(struct xfs_ail *ailp)
117{
118	return READ_ONCE(ailp->ail_target);
119}
120
121void			xfs_ail_push_all_sync(struct xfs_ail *ailp);
122xfs_lsn_t		xfs_ail_min_lsn(struct xfs_ail *ailp);
123
124struct xfs_log_item *	xfs_trans_ail_cursor_first(struct xfs_ail *ailp,
125					struct xfs_ail_cursor *cur,
126					xfs_lsn_t lsn);
127struct xfs_log_item *	xfs_trans_ail_cursor_last(struct xfs_ail *ailp,
128					struct xfs_ail_cursor *cur,
129					xfs_lsn_t lsn);
130struct xfs_log_item *	xfs_trans_ail_cursor_next(struct xfs_ail *ailp,
131					struct xfs_ail_cursor *cur);
132void			xfs_trans_ail_cursor_done(struct xfs_ail_cursor *cur);
133
134void			__xfs_ail_assign_tail_lsn(struct xfs_ail *ailp);
135
136static inline void
137xfs_ail_assign_tail_lsn(
138	struct xfs_ail		*ailp)
139{
140
141	spin_lock(&ailp->ail_lock);
142	__xfs_ail_assign_tail_lsn(ailp);
143	spin_unlock(&ailp->ail_lock);
144}
145
146#if BITS_PER_LONG != 64
147static inline void
148xfs_trans_ail_copy_lsn(
149	struct xfs_ail	*ailp,
150	xfs_lsn_t	*dst,
151	xfs_lsn_t	*src)
152{
153	ASSERT(sizeof(xfs_lsn_t) == 8);	/* don't lock if it shrinks */
154	spin_lock(&ailp->ail_lock);
155	*dst = *src;
156	spin_unlock(&ailp->ail_lock);
157}
158#else
159static inline void
160xfs_trans_ail_copy_lsn(
161	struct xfs_ail	*ailp,
162	xfs_lsn_t	*dst,
163	xfs_lsn_t	*src)
164{
165	ASSERT(sizeof(xfs_lsn_t) == 8);
166	*dst = *src;
167}
168#endif
169
170static inline void
171xfs_clear_li_failed(
172	struct xfs_log_item	*lip)
173{
174	struct xfs_buf	*bp = lip->li_buf;
175
176	ASSERT(test_bit(XFS_LI_IN_AIL, &lip->li_flags));
177	lockdep_assert_held(&lip->li_ailp->ail_lock);
178
179	if (test_and_clear_bit(XFS_LI_FAILED, &lip->li_flags)) {
180		lip->li_buf = NULL;
181		xfs_buf_rele(bp);
182	}
183}
184
185static inline void
186xfs_set_li_failed(
187	struct xfs_log_item	*lip,
188	struct xfs_buf		*bp)
189{
190	lockdep_assert_held(&lip->li_ailp->ail_lock);
191
192	if (!test_and_set_bit(XFS_LI_FAILED, &lip->li_flags)) {
193		xfs_buf_hold(bp);
194		lip->li_buf = bp;
195	}
196}
197
198#endif	/* __XFS_TRANS_PRIV_H__ */