[net-next-2.6.git] / fs / xfs / xfs_filestream.h

/*
 * Copyright (c) 2006-2007 Silicon Graphics, Inc.
 * All Rights Reserved.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it would be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write the Free Software Foundation,
 * Inc.,  51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */
#ifndef __XFS_FILESTREAM_H__
#define __XFS_FILESTREAM_H__

#ifdef __KERNEL__

struct xfs_mount;
struct xfs_inode;
struct xfs_perag;
struct xfs_bmalloca;

#ifdef XFS_FILESTREAMS_TRACE
#define XFS_FSTRM_KTRACE_INFO		1
#define XFS_FSTRM_KTRACE_AGSCAN		2
#define XFS_FSTRM_KTRACE_AGPICK1	3
#define XFS_FSTRM_KTRACE_AGPICK2	4
#define XFS_FSTRM_KTRACE_UPDATE		5
#define XFS_FSTRM_KTRACE_FREE		6
#define	XFS_FSTRM_KTRACE_ITEM_LOOKUP	7
#define	XFS_FSTRM_KTRACE_ASSOCIATE	8
#define	XFS_FSTRM_KTRACE_MOVEAG		9
#define	XFS_FSTRM_KTRACE_ORPHAN		10

#define XFS_FSTRM_KTRACE_SIZE	16384
extern ktrace_t *xfs_filestreams_trace_buf;

#endif

/*
 * Allocation group filestream associations are tracked with per-ag atomic
 * counters.  These counters allow _xfs_filestream_pick_ag() to tell whether a
 * particular AG already has active filestreams associated with it. The mount
 * point's m_peraglock is used to protect these counters from per-ag array
 * re-allocation during a growfs operation.  When xfs_growfs_data_private() is
 * about to reallocate the array, it calls xfs_filestream_flush() with the
 * m_peraglock held in write mode.
 *
 * Since xfs_mru_cache_flush() guarantees that all the free functions for all
 * the cache elements have finished executing before it returns, it's safe for
 * the free functions to use the atomic counters without m_peraglock protection.
 * This allows the implementation of xfs_fstrm_free_func() to be agnostic about
 * whether it was called with the m_peraglock held in read mode, write mode or
 * not held at all.  The race condition this addresses is the following:
 *
 *  - The work queue scheduler fires and pulls a filestream directory cache
 *    element off the LRU end of the cache for deletion, then gets pre-empted.
 *  - A growfs operation grabs the m_peraglock in write mode, flushes all the
 *    remaining items from the cache and reallocates the mount point's per-ag
 *    array, resetting all the counters to zero.
 *  - The work queue thread resumes and calls the free function for the element
 *    it started cleaning up earlier.  In the process it decrements the
 *    filestreams counter for an AG that now has no references.
 *
 * With a shrinkfs feature, the above scenario could panic the system.
 *
 * All other uses of the following macros should be protected by either the
 * m_peraglock held in read mode, or the cache's internal locking exposed by the
 * interval between a call to xfs_mru_cache_lookup() and a call to
 * xfs_mru_cache_done().  In addition, the m_peraglock must be held in read mode
 * when new elements are added to the cache.
 *
 * Combined, these locking rules ensure that no associations will ever exist in
 * the cache that reference per-ag array elements that have since been
 * reallocated.
 */
/*
 * xfs_filestream_peek_ag is only used in tracing code
 */
static inline int
xfs_filestream_peek_ag(
	xfs_mount_t	*mp,
	xfs_agnumber_t	agno)
{
	struct xfs_perag *pag;
	int		ret;

	pag = xfs_perag_get(mp, agno);
	ret = atomic_read(&pag->pagf_fstrms);
	xfs_perag_put(pag);
	return ret;
}

static inline int
xfs_filestream_get_ag(
	xfs_mount_t	*mp,
	xfs_agnumber_t	agno)
{
	struct xfs_perag *pag;
	int		ret;

	pag = xfs_perag_get(mp, agno);
	ret = atomic_inc_return(&pag->pagf_fstrms);
	xfs_perag_put(pag);
	return ret;
}

static inline int
xfs_filestream_put_ag(
	xfs_mount_t	*mp,
	xfs_agnumber_t	agno)
{
	struct xfs_perag *pag;
	int		ret;

	pag = xfs_perag_get(mp, agno);
	ret = atomic_dec_return(&pag->pagf_fstrms);
	xfs_perag_put(pag);
	return ret;
}

/* allocation selection flags */
typedef enum xfs_fstrm_alloc {
	XFS_PICK_USERDATA = 1,
	XFS_PICK_LOWSPACE = 2,
} xfs_fstrm_alloc_t;

/* prototypes for filestream.c */
int xfs_filestream_init(void);
void xfs_filestream_uninit(void);
int xfs_filestream_mount(struct xfs_mount *mp);
void xfs_filestream_unmount(struct xfs_mount *mp);
void xfs_filestream_flush(struct xfs_mount *mp);
xfs_agnumber_t xfs_filestream_lookup_ag(struct xfs_inode *ip);
int xfs_filestream_associate(struct xfs_inode *dip, struct xfs_inode *ip);
void xfs_filestream_deassociate(struct xfs_inode *ip);
int xfs_filestream_new_ag(struct xfs_bmalloca *ap, xfs_agnumber_t *agp);


/* filestreams for the inode? */
static inline int
xfs_inode_is_filestream(
	struct xfs_inode	*ip)
{
	return (ip->i_mount->m_flags & XFS_MOUNT_FILESTREAMS) ||
		xfs_iflags_test(ip, XFS_IFILESTREAM) ||
		(ip->i_d.di_flags & XFS_DIFLAG_FILESTREAM);
}

#endif /* __KERNEL__ */

#endif /* __XFS_FILESTREAM_H__ */
Commit	Line	Data
2a82b8be DC	1	/*
	2	* Copyright (c) 2006-2007 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_FILESTREAM_H__
	19	#define __XFS_FILESTREAM_H__
	20
	21	#ifdef __KERNEL__
	22
	23	struct xfs_mount;
	24	struct xfs_inode;
	25	struct xfs_perag;
	26	struct xfs_bmalloca;
	27
	28	#ifdef XFS_FILESTREAMS_TRACE
	29	#define XFS_FSTRM_KTRACE_INFO 1
	30	#define XFS_FSTRM_KTRACE_AGSCAN 2
	31	#define XFS_FSTRM_KTRACE_AGPICK1 3
	32	#define XFS_FSTRM_KTRACE_AGPICK2 4
	33	#define XFS_FSTRM_KTRACE_UPDATE 5
	34	#define XFS_FSTRM_KTRACE_FREE 6
	35	#define XFS_FSTRM_KTRACE_ITEM_LOOKUP 7
	36	#define XFS_FSTRM_KTRACE_ASSOCIATE 8
	37	#define XFS_FSTRM_KTRACE_MOVEAG 9
	38	#define XFS_FSTRM_KTRACE_ORPHAN 10
	39
	40	#define XFS_FSTRM_KTRACE_SIZE 16384
	41	extern ktrace_t *xfs_filestreams_trace_buf;
	42
	43	#endif
	44
	45	/*
	46	* Allocation group filestream associations are tracked with per-ag atomic
	47	* counters. These counters allow _xfs_filestream_pick_ag() to tell whether a
	48	* particular AG already has active filestreams associated with it. The mount
	49	* point's m_peraglock is used to protect these counters from per-ag array
	50	* re-allocation during a growfs operation. When xfs_growfs_data_private() is
	51	* about to reallocate the array, it calls xfs_filestream_flush() with the
	52	* m_peraglock held in write mode.
	53	*
	54	* Since xfs_mru_cache_flush() guarantees that all the free functions for all
	55	* the cache elements have finished executing before it returns, it's safe for
	56	* the free functions to use the atomic counters without m_peraglock protection.
	57	* This allows the implementation of xfs_fstrm_free_func() to be agnostic about
	58	* whether it was called with the m_peraglock held in read mode, write mode or
	59	* not held at all. The race condition this addresses is the following:
	60	*
	61	* - The work queue scheduler fires and pulls a filestream directory cache
	62	* element off the LRU end of the cache for deletion, then gets pre-empted.
	63	* - A growfs operation grabs the m_peraglock in write mode, flushes all the
	64	* remaining items from the cache and reallocates the mount point's per-ag
65	* array, resetting all the counters to zero.
66	* - The work queue thread resumes and calls the free function for the element
67	* it started cleaning up earlier. In the process it decrements the
68	* filestreams counter for an AG that now has no references.
69	*
70	* With a shrinkfs feature, the above scenario could panic the system.
71	*
72	* All other uses of the following macros should be protected by either the
73	* m_peraglock held in read mode, or the cache's internal locking exposed by the
74	* interval between a call to xfs_mru_cache_lookup() and a call to
75	* xfs_mru_cache_done(). In addition, the m_peraglock must be held in read mode
76	* when new elements are added to the cache.
77	*
78	* Combined, these locking rules ensure that no associations will ever exist in
79	* the cache that reference per-ag array elements that have since been
80	* reallocated.
81	*/
4196ac08 DC	82	/*
	83	* xfs_filestream_peek_ag is only used in tracing code
	84	*/
b8f82a4a	85	static inline int
2a82b8be DC	86	xfs_filestream_peek_ag(
	87	xfs_mount_t *mp,
	88	xfs_agnumber_t agno)
	89	{
4196ac08 DC	90	struct xfs_perag *pag;
	91	int ret;
	92
	93	pag = xfs_perag_get(mp, agno);
	94	ret = atomic_read(&pag->pagf_fstrms);
	95	xfs_perag_put(pag);
	96	return ret;
2a82b8be DC	97	}
2a82b8be DC	98
b8f82a4a	99	static inline int
2a82b8be DC	100	xfs_filestream_get_ag(
	101	xfs_mount_t *mp,
	102	xfs_agnumber_t agno)
	103	{
4196ac08 DC	104	struct xfs_perag *pag;
	105	int ret;
	106
	107	pag = xfs_perag_get(mp, agno);
	108	ret = atomic_inc_return(&pag->pagf_fstrms);
	109	xfs_perag_put(pag);
	110	return ret;
2a82b8be DC	111	}
2a82b8be DC	112
b8f82a4a	113	static inline int
2a82b8be DC	114	xfs_filestream_put_ag(
	115	xfs_mount_t *mp,
	116	xfs_agnumber_t agno)
	117	{
4196ac08 DC	118	struct xfs_perag *pag;
	119	int ret;
	120
	121	pag = xfs_perag_get(mp, agno);
	122	ret = atomic_dec_return(&pag->pagf_fstrms);
	123	xfs_perag_put(pag);
	124	return ret;
2a82b8be DC	125	}
	126
	127	/* allocation selection flags */
	128	typedef enum xfs_fstrm_alloc {
	129	XFS_PICK_USERDATA = 1,
	130	XFS_PICK_LOWSPACE = 2,
	131	} xfs_fstrm_alloc_t;
	132
	133	/* prototypes for filestream.c */
	134	int xfs_filestream_init(void);
	135	void xfs_filestream_uninit(void);
	136	int xfs_filestream_mount(struct xfs_mount *mp);
	137	void xfs_filestream_unmount(struct xfs_mount *mp);
	138	void xfs_filestream_flush(struct xfs_mount *mp);
	139	xfs_agnumber_t xfs_filestream_lookup_ag(struct xfs_inode *ip);
	140	int xfs_filestream_associate(struct xfs_inode dip, struct xfs_inode ip);
	141	void xfs_filestream_deassociate(struct xfs_inode *ip);
	142	int xfs_filestream_new_ag(struct xfs_bmalloca ap, xfs_agnumber_t agp);
	143
	144
	145	/* filestreams for the inode? */
b8f82a4a	146	static inline int
2a82b8be DC	147	xfs_inode_is_filestream(
	148	struct xfs_inode *ip)
	149	{
	150	return (ip->i_mount->m_flags & XFS_MOUNT_FILESTREAMS) \|\|
	151	xfs_iflags_test(ip, XFS_IFILESTREAM) \|\|
	152	(ip->i_d.di_flags & XFS_DIFLAG_FILESTREAM);
	153	}
	154
	155	#endif /* __KERNEL__ */
	156
	157	#endif /* __XFS_FILESTREAM_H__ */