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