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

/*
 * Copyright (c) 2000-2002,2005 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_ERROR_H__
#define	__XFS_ERROR_H__

#ifdef DEBUG
#define	XFS_ERROR_NTRAP	10
extern int	xfs_etrap[XFS_ERROR_NTRAP];
extern int	xfs_error_trap(int);
#define	XFS_ERROR(e)	xfs_error_trap(e)
#else
#define	XFS_ERROR(e)	(e)
#endif

struct xfs_mount;

extern void xfs_error_report(const char *tag, int level, struct xfs_mount *mp,
			const char *filename, int linenum, inst_t *ra);
extern void xfs_corruption_error(const char *tag, int level,
			struct xfs_mount *mp, void *p, const char *filename,
			int linenum, inst_t *ra);

#define	XFS_ERROR_REPORT(e, lvl, mp)	\
	xfs_error_report(e, lvl, mp, __FILE__, __LINE__, __return_address)
#define	XFS_CORRUPTION_ERROR(e, lvl, mp, mem)	\
	xfs_corruption_error(e, lvl, mp, mem, \
			     __FILE__, __LINE__, __return_address)

#define XFS_ERRLEVEL_OFF	0
#define XFS_ERRLEVEL_LOW	1
#define XFS_ERRLEVEL_HIGH	5

/*
 * Macros to set EFSCORRUPTED & return/branch.
 */
#define	XFS_WANT_CORRUPTED_GOTO(x,l)	\
	{ \
		int fs_is_ok = (x); \
		ASSERT(fs_is_ok); \
		if (unlikely(!fs_is_ok)) { \
			XFS_ERROR_REPORT("XFS_WANT_CORRUPTED_GOTO", \
					 XFS_ERRLEVEL_LOW, NULL); \
			error = XFS_ERROR(EFSCORRUPTED); \
			goto l; \
		} \
	}

#define	XFS_WANT_CORRUPTED_RETURN(x)	\
	{ \
		int fs_is_ok = (x); \
		ASSERT(fs_is_ok); \
		if (unlikely(!fs_is_ok)) { \
			XFS_ERROR_REPORT("XFS_WANT_CORRUPTED_RETURN", \
					 XFS_ERRLEVEL_LOW, NULL); \
			return XFS_ERROR(EFSCORRUPTED); \
		} \
	}

/*
 * error injection tags - the labels can be anything you want
 * but each tag should have its own unique number
 */

#define XFS_ERRTAG_NOERROR				0
#define XFS_ERRTAG_IFLUSH_1				1
#define XFS_ERRTAG_IFLUSH_2				2
#define XFS_ERRTAG_IFLUSH_3				3
#define XFS_ERRTAG_IFLUSH_4				4
#define XFS_ERRTAG_IFLUSH_5				5
#define XFS_ERRTAG_IFLUSH_6				6
#define	XFS_ERRTAG_DA_READ_BUF				7
#define	XFS_ERRTAG_BTREE_CHECK_LBLOCK			8
#define	XFS_ERRTAG_BTREE_CHECK_SBLOCK			9
#define	XFS_ERRTAG_ALLOC_READ_AGF			10
#define	XFS_ERRTAG_IALLOC_READ_AGI			11
#define	XFS_ERRTAG_ITOBP_INOTOBP			12
#define	XFS_ERRTAG_IUNLINK				13
#define	XFS_ERRTAG_IUNLINK_REMOVE			14
#define	XFS_ERRTAG_DIR_INO_VALIDATE			15
#define XFS_ERRTAG_BULKSTAT_READ_CHUNK			16
#define XFS_ERRTAG_IODONE_IOERR				17
#define XFS_ERRTAG_STRATREAD_IOERR			18
#define XFS_ERRTAG_STRATCMPL_IOERR			19
#define XFS_ERRTAG_DIOWRITE_IOERR			20
#define XFS_ERRTAG_BMAPIFORMAT				21
#define XFS_ERRTAG_MAX					22

/*
 * Random factors for above tags, 1 means always, 2 means 1/2 time, etc.
 */
#define XFS_RANDOM_DEFAULT				100
#define XFS_RANDOM_IFLUSH_1				XFS_RANDOM_DEFAULT
#define XFS_RANDOM_IFLUSH_2				XFS_RANDOM_DEFAULT
#define XFS_RANDOM_IFLUSH_3				XFS_RANDOM_DEFAULT
#define XFS_RANDOM_IFLUSH_4				XFS_RANDOM_DEFAULT
#define XFS_RANDOM_IFLUSH_5				XFS_RANDOM_DEFAULT
#define XFS_RANDOM_IFLUSH_6				XFS_RANDOM_DEFAULT
#define XFS_RANDOM_DA_READ_BUF				XFS_RANDOM_DEFAULT
#define XFS_RANDOM_BTREE_CHECK_LBLOCK			(XFS_RANDOM_DEFAULT/4)
#define XFS_RANDOM_BTREE_CHECK_SBLOCK			XFS_RANDOM_DEFAULT
#define XFS_RANDOM_ALLOC_READ_AGF			XFS_RANDOM_DEFAULT
#define XFS_RANDOM_IALLOC_READ_AGI			XFS_RANDOM_DEFAULT
#define XFS_RANDOM_ITOBP_INOTOBP			XFS_RANDOM_DEFAULT
#define XFS_RANDOM_IUNLINK				XFS_RANDOM_DEFAULT
#define XFS_RANDOM_IUNLINK_REMOVE			XFS_RANDOM_DEFAULT
#define XFS_RANDOM_DIR_INO_VALIDATE			XFS_RANDOM_DEFAULT
#define XFS_RANDOM_BULKSTAT_READ_CHUNK			XFS_RANDOM_DEFAULT
#define XFS_RANDOM_IODONE_IOERR				(XFS_RANDOM_DEFAULT/10)
#define XFS_RANDOM_STRATREAD_IOERR			(XFS_RANDOM_DEFAULT/10)
#define XFS_RANDOM_STRATCMPL_IOERR			(XFS_RANDOM_DEFAULT/10)
#define XFS_RANDOM_DIOWRITE_IOERR			(XFS_RANDOM_DEFAULT/10)
#define	XFS_RANDOM_BMAPIFORMAT				XFS_RANDOM_DEFAULT

#ifdef DEBUG
extern int xfs_error_test(int, int *, char *, int, char *, unsigned long);

#define	XFS_NUM_INJECT_ERROR				10
#define XFS_TEST_ERROR(expr, mp, tag, rf)		\
	((expr) || \
	 xfs_error_test((tag), (mp)->m_fixedfsid, "expr", __LINE__, __FILE__, \
			(rf)))

extern int xfs_errortag_add(int error_tag, xfs_mount_t *mp);
extern int xfs_errortag_clearall(xfs_mount_t *mp, int loud);
#else
#define XFS_TEST_ERROR(expr, mp, tag, rf)	(expr)
#define xfs_errortag_add(tag, mp)		(ENOSYS)
#define xfs_errortag_clearall(mp, loud)		(ENOSYS)
#endif /* DEBUG */

/*
 * XFS panic tags -- allow a call to xfs_cmn_err() be turned into
 *			a panic by setting xfs_panic_mask in a
 *			sysctl.  update xfs_max[XFS_PARAM] if
 *			more are added.
 */
#define		XFS_NO_PTAG			0
#define		XFS_PTAG_IFLUSH			0x00000001
#define		XFS_PTAG_LOGRES			0x00000002
#define		XFS_PTAG_AILDELETE		0x00000004
#define		XFS_PTAG_ERROR_REPORT		0x00000008
#define		XFS_PTAG_SHUTDOWN_CORRUPT	0x00000010
#define		XFS_PTAG_SHUTDOWN_IOERROR	0x00000020
#define		XFS_PTAG_SHUTDOWN_LOGERROR	0x00000040
#define		XFS_PTAG_FSBLOCK_ZERO		0x00000080

struct xfs_mount;

extern void xfs_fs_vcmn_err(int level, struct xfs_mount *mp,
		char *fmt, va_list ap)
	__attribute__ ((format (printf, 3, 0)));
extern void xfs_cmn_err(int panic_tag, int level, struct xfs_mount *mp,
			char *fmt, ...)
	__attribute__ ((format (printf, 4, 5)));
extern void xfs_fs_cmn_err(int level, struct xfs_mount *mp, char *fmt, ...)
	__attribute__ ((format (printf, 3, 4)));

extern void xfs_hex_dump(void *p, int length);

#define xfs_fs_repair_cmn_err(level, mp, fmt, args...) \
	xfs_fs_cmn_err(level, mp, fmt "  Unmount and run xfs_repair.", ## args)

#define xfs_fs_mount_cmn_err(f, fmt, args...) \
	((f & XFS_MFSI_QUIET)? (void)0 : cmn_err(CE_WARN, "XFS: " fmt, ## args))

#endif	/* __XFS_ERROR_H__ */
Commit	Line	Data
1da177e4	1	/*
7b718769 NS	2	* Copyright (c) 2000-2002,2005 Silicon Graphics, Inc.
7b718769 NS	3	* All Rights Reserved.
1da177e4	4	*
7b718769 NS	5	* This program is free software; you can redistribute it and/or
7b718769 NS	6	* modify it under the terms of the GNU General Public License as
1da177e4 LT	7	* published by the Free Software Foundation.
1da177e4 LT	8	*
7b718769 NS	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.
1da177e4	13	*
7b718769 NS	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
1da177e4 LT	17	*/
	18	#ifndef __XFS_ERROR_H__
	19	#define __XFS_ERROR_H__
	20
1da177e4 LT	21	#ifdef DEBUG
	22	#define XFS_ERROR_NTRAP 10
	23	extern int xfs_etrap[XFS_ERROR_NTRAP];
	24	extern int xfs_error_trap(int);
	25	#define XFS_ERROR(e) xfs_error_trap(e)
	26	#else
	27	#define XFS_ERROR(e) (e)
	28	#endif
	29
	30	struct xfs_mount;
	31
a0e856b0 AE	32	extern void xfs_error_report(const char tag, int level, struct xfs_mount mp,
	33	const char filename, int linenum, inst_t ra);
	34	extern void xfs_corruption_error(const char *tag, int level,
	35	struct xfs_mount mp, void p, const char *filename,
	36	int linenum, inst_t *ra);
1da177e4	37
1da177e4 LT	38	#define XFS_ERROR_REPORT(e, lvl, mp) \
	39	xfs_error_report(e, lvl, mp, __FILE__, __LINE__, __return_address)
	40	#define XFS_CORRUPTION_ERROR(e, lvl, mp, mem) \
	41	xfs_corruption_error(e, lvl, mp, mem, \
	42	__FILE__, __LINE__, __return_address)
	43
	44	#define XFS_ERRLEVEL_OFF 0
	45	#define XFS_ERRLEVEL_LOW 1
	46	#define XFS_ERRLEVEL_HIGH 5
	47
a844f451 NS	48	/*
	49	* Macros to set EFSCORRUPTED & return/branch.
	50	*/
	51	#define XFS_WANT_CORRUPTED_GOTO(x,l) \
	52	{ \
	53	int fs_is_ok = (x); \
	54	ASSERT(fs_is_ok); \
	55	if (unlikely(!fs_is_ok)) { \
	56	XFS_ERROR_REPORT("XFS_WANT_CORRUPTED_GOTO", \
	57	XFS_ERRLEVEL_LOW, NULL); \
	58	error = XFS_ERROR(EFSCORRUPTED); \
	59	goto l; \
	60	} \
	61	}
	62
	63	#define XFS_WANT_CORRUPTED_RETURN(x) \
	64	{ \
	65	int fs_is_ok = (x); \
	66	ASSERT(fs_is_ok); \
	67	if (unlikely(!fs_is_ok)) { \
	68	XFS_ERROR_REPORT("XFS_WANT_CORRUPTED_RETURN", \
	69	XFS_ERRLEVEL_LOW, NULL); \
	70	return XFS_ERROR(EFSCORRUPTED); \
	71	} \
	72	}
	73
1da177e4 LT	74	/*
	75	* error injection tags - the labels can be anything you want
	76	* but each tag should have its own unique number
	77	*/
	78
	79	#define XFS_ERRTAG_NOERROR 0
	80	#define XFS_ERRTAG_IFLUSH_1 1
	81	#define XFS_ERRTAG_IFLUSH_2 2
	82	#define XFS_ERRTAG_IFLUSH_3 3
	83	#define XFS_ERRTAG_IFLUSH_4 4
	84	#define XFS_ERRTAG_IFLUSH_5 5
	85	#define XFS_ERRTAG_IFLUSH_6 6
	86	#define XFS_ERRTAG_DA_READ_BUF 7
	87	#define XFS_ERRTAG_BTREE_CHECK_LBLOCK 8
	88	#define XFS_ERRTAG_BTREE_CHECK_SBLOCK 9
	89	#define XFS_ERRTAG_ALLOC_READ_AGF 10
	90	#define XFS_ERRTAG_IALLOC_READ_AGI 11
	91	#define XFS_ERRTAG_ITOBP_INOTOBP 12
	92	#define XFS_ERRTAG_IUNLINK 13
	93	#define XFS_ERRTAG_IUNLINK_REMOVE 14
	94	#define XFS_ERRTAG_DIR_INO_VALIDATE 15
	95	#define XFS_ERRTAG_BULKSTAT_READ_CHUNK 16
	96	#define XFS_ERRTAG_IODONE_IOERR 17
	97	#define XFS_ERRTAG_STRATREAD_IOERR 18
	98	#define XFS_ERRTAG_STRATCMPL_IOERR 19
	99	#define XFS_ERRTAG_DIOWRITE_IOERR 20
	100	#define XFS_ERRTAG_BMAPIFORMAT 21
	101	#define XFS_ERRTAG_MAX 22
	102
	103	/*
	104	* Random factors for above tags, 1 means always, 2 means 1/2 time, etc.
	105	*/
	106	#define XFS_RANDOM_DEFAULT 100
	107	#define XFS_RANDOM_IFLUSH_1 XFS_RANDOM_DEFAULT
	108	#define XFS_RANDOM_IFLUSH_2 XFS_RANDOM_DEFAULT
	109	#define XFS_RANDOM_IFLUSH_3 XFS_RANDOM_DEFAULT
	110	#define XFS_RANDOM_IFLUSH_4 XFS_RANDOM_DEFAULT
	111	#define XFS_RANDOM_IFLUSH_5 XFS_RANDOM_DEFAULT
	112	#define XFS_RANDOM_IFLUSH_6 XFS_RANDOM_DEFAULT
	113	#define XFS_RANDOM_DA_READ_BUF XFS_RANDOM_DEFAULT
	114	#define XFS_RANDOM_BTREE_CHECK_LBLOCK (XFS_RANDOM_DEFAULT/4)
	115	#define XFS_RANDOM_BTREE_CHECK_SBLOCK XFS_RANDOM_DEFAULT
	116	#define XFS_RANDOM_ALLOC_READ_AGF XFS_RANDOM_DEFAULT
	117	#define XFS_RANDOM_IALLOC_READ_AGI XFS_RANDOM_DEFAULT
	118	#define XFS_RANDOM_ITOBP_INOTOBP XFS_RANDOM_DEFAULT
	119	#define XFS_RANDOM_IUNLINK XFS_RANDOM_DEFAULT
	120	#define XFS_RANDOM_IUNLINK_REMOVE XFS_RANDOM_DEFAULT
	121	#define XFS_RANDOM_DIR_INO_VALIDATE XFS_RANDOM_DEFAULT
	122	#define XFS_RANDOM_BULKSTAT_READ_CHUNK XFS_RANDOM_DEFAULT
	123	#define XFS_RANDOM_IODONE_IOERR (XFS_RANDOM_DEFAULT/10)
	124	#define XFS_RANDOM_STRATREAD_IOERR (XFS_RANDOM_DEFAULT/10)
	125	#define XFS_RANDOM_STRATCMPL_IOERR (XFS_RANDOM_DEFAULT/10)
	126	#define XFS_RANDOM_DIOWRITE_IOERR (XFS_RANDOM_DEFAULT/10)
	127	#define XFS_RANDOM_BMAPIFORMAT XFS_RANDOM_DEFAULT
	128
1550d0b0	129	#ifdef DEBUG
a844f451	130	extern int xfs_error_test(int, int , char , int, char *, unsigned long);
1da177e4 LT	131
1da177e4 LT	132	#define XFS_NUM_INJECT_ERROR 10
1da177e4 LT	133	#define XFS_TEST_ERROR(expr, mp, tag, rf) \
	134	((expr) \|\| \
	135	xfs_error_test((tag), (mp)->m_fixedfsid, "expr", __LINE__, __FILE__, \
	136	(rf)))
1da177e4	137
a844f451	138	extern int xfs_errortag_add(int error_tag, xfs_mount_t *mp);
0ce4cfd4	139	extern int xfs_errortag_clearall(xfs_mount_t *mp, int loud);
1da177e4 LT	140	#else
	141	#define XFS_TEST_ERROR(expr, mp, tag, rf) (expr)
	142	#define xfs_errortag_add(tag, mp) (ENOSYS)
0ce4cfd4	143	#define xfs_errortag_clearall(mp, loud) (ENOSYS)
1550d0b0	144	#endif /* DEBUG */
1da177e4 LT	145
	146	/*
	147	* XFS panic tags -- allow a call to xfs_cmn_err() be turned into
	148	* a panic by setting xfs_panic_mask in a
	149	* sysctl. update xfs_max[XFS_PARAM] if
	150	* more are added.
	151	*/
	152	#define XFS_NO_PTAG 0
	153	#define XFS_PTAG_IFLUSH 0x00000001
	154	#define XFS_PTAG_LOGRES 0x00000002
	155	#define XFS_PTAG_AILDELETE 0x00000004
	156	#define XFS_PTAG_ERROR_REPORT 0x00000008
	157	#define XFS_PTAG_SHUTDOWN_CORRUPT 0x00000010
	158	#define XFS_PTAG_SHUTDOWN_IOERROR 0x00000020
	159	#define XFS_PTAG_SHUTDOWN_LOGERROR 0x00000040
572d95f4	160	#define XFS_PTAG_FSBLOCK_ZERO 0x00000080
1da177e4 LT	161
1da177e4 LT	162	struct xfs_mount;
efc55757 CH	163
	164	extern void xfs_fs_vcmn_err(int level, struct xfs_mount *mp,
	165	char *fmt, va_list ap)
	166	__attribute__ ((format (printf, 3, 0)));
a844f451	167	extern void xfs_cmn_err(int panic_tag, int level, struct xfs_mount *mp,
efc55757 CH	168	char *fmt, ...)
	169	__attribute__ ((format (printf, 4, 5)));
	170	extern void xfs_fs_cmn_err(int level, struct xfs_mount mp, char fmt, ...)
	171	__attribute__ ((format (printf, 3, 4)));
1da177e4	172
d4f3cc01 ES	173	extern void xfs_hex_dump(void *p, int length);
d4f3cc01 ES	174
3762ec6b NS	175	#define xfs_fs_repair_cmn_err(level, mp, fmt, args...) \
	176	xfs_fs_cmn_err(level, mp, fmt " Unmount and run xfs_repair.", ## args)
	177
764d1f89	178	#define xfs_fs_mount_cmn_err(f, fmt, args...) \
dac61f52	179	((f & XFS_MFSI_QUIET)? (void)0 : cmn_err(CE_WARN, "XFS: " fmt, ## args))
764d1f89	180
1da177e4	181	#endif /* __XFS_ERROR_H__ */