drivers/staging/et131x/et131x_debug.h

/*
 * Agere Systems Inc.
 * 10/100/1000 Base-T Ethernet Driver for the ET1301 and ET131x series MACs
 *
 * Copyright © 2005 Agere Systems Inc.
 * All rights reserved.
 *   http://www.agere.com
 *
 *------------------------------------------------------------------------------
 *
 * et131x_debug.h - Defines, structs, enums, prototypes, etc. used for
 *                  outputting debug messages to the system logging facility
 *                  (ksyslogd)
 *
 *------------------------------------------------------------------------------
 *
 * SOFTWARE LICENSE
 *
 * This software is provided subject to the following terms and conditions,
 * which you should read carefully before using the software.  Using this
 * software indicates your acceptance of these terms and conditions.  If you do
 * not agree with these terms and conditions, do not use the software.
 *
 * Copyright © 2005 Agere Systems Inc.
 * All rights reserved.
 *
 * Redistribution and use in source or binary forms, with or without
 * modifications, are permitted provided that the following conditions are met:
 *
 * . Redistributions of source code must retain the above copyright notice, this
 *    list of conditions and the following Disclaimer as comments in the code as
 *    well as in the documentation and/or other materials provided with the
 *    distribution.
 *
 * . Redistributions in binary form must reproduce the above copyright notice,
 *    this list of conditions and the following Disclaimer in the documentation
 *    and/or other materials provided with the distribution.
 *
 * . Neither the name of Agere Systems Inc. nor the names of the contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * Disclaimer
 *
 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, INFRINGEMENT AND THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  ANY
 * USE, MODIFICATION OR DISTRIBUTION OF THIS SOFTWARE IS SOLELY AT THE USERS OWN
 * RISK. IN NO EVENT SHALL AGERE SYSTEMS INC. OR CONTRIBUTORS BE LIABLE FOR ANY
 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, INCLUDING, BUT NOT LIMITED TO, CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
 * DAMAGE.
 *
 */

#ifndef __ET131X_DBG_H__
#define __ET131X_DBG_H__

/* Define Masks for debugging types/levels */
#define DBG_ERROR_ON        0x00000001L
#define DBG_WARNING_ON      0x00000002L
#define DBG_NOTICE_ON       0x00000004L
#define DBG_TRACE_ON        0x00000008L
#define DBG_VERBOSE_ON      0x00000010L
#define DBG_PARAM_ON        0x00000020L
#define DBG_BREAK_ON        0x00000040L
#define DBG_RX_ON           0x00000100L
#define DBG_TX_ON           0x00000200L

#ifdef CONFIG_ET131X_DEBUG

/*
 * Set the level of debugging if not done with a preprocessor define. See
 * et131x_main.c, function et131x_init_module() for how the debug level
 * translates into the types of messages displayed.
 */
#ifndef DBG_LVL
#define DBG_LVL	3
#endif /* DBG_LVL */

#define DBG_DEFAULTS		(DBG_ERROR_ON | DBG_WARNING_ON | DBG_BREAK_ON)

#define DBG_FLAGS(A)		((A)->dbgFlags)
#define DBG_NAME(A)		((A)->dbgName)
#define DBG_LEVEL(A)		((A)->dbgLevel)

#ifndef DBG_PRINT
#define DBG_PRINT(S...)		printk(KERN_DEBUG S)
#endif /* DBG_PRINT */

#ifndef DBG_PRINTC
#define DBG_PRINTC(S...)	printk(S)
#endif /* DBG_PRINTC */

#ifndef DBG_TRAP
#define DBG_TRAP		do {} while (0)	/* BUG() */
#endif /* DBG_TRAP */

#define _ENTER_STR	">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>"
#define _LEAVE_STR	"<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<"

#define _DBG_ENTER(A)	printk(KERN_DEBUG "%s:%.*s:%s\n", DBG_NAME(A),	\
				++DBG_LEVEL(A), _ENTER_STR, __func__)
#define _DBG_LEAVE(A)	printk(KERN_DEBUG "%s:%.*s:%s\n", DBG_NAME(A),	\
				DBG_LEVEL(A)--, _LEAVE_STR, __func__)

#define DBG_ENTER(A)							\
	do {								\
		if (DBG_FLAGS(A) & DBG_TRACE_ON)			\
			_DBG_ENTER(A);					\
	} while (0)

#define DBG_LEAVE(A)							\
	do {								\
		if (DBG_FLAGS(A) & DBG_TRACE_ON)			\
			_DBG_LEAVE(A);					\
	} while (0)

#define DBG_PARAM(A, N, F, S...)					\
	do {								\
		if (DBG_FLAGS(A) & DBG_PARAM_ON)			\
			DBG_PRINT("  %s -- "F" ", N, S);		\
	} while (0)

#define DBG_ERROR(A, S...)						 \
	do {								 \
		if (DBG_FLAGS(A) & DBG_ERROR_ON) {			 \
			DBG_PRINT("%s:ERROR:%s ", DBG_NAME(A), __func__);\
			DBG_PRINTC(S);					 \
			DBG_TRAP;					 \
		}							 \
	} while (0)

#define DBG_WARNING(A, S...)						    \
	do {								    \
		if (DBG_FLAGS(A) & DBG_WARNING_ON) {			    \
			DBG_PRINT("%s:WARNING:%s ", DBG_NAME(A), __func__); \
			DBG_PRINTC(S);					    \
		}							    \
	} while (0)

#define DBG_NOTICE(A, S...)						   \
	do {								   \
		if (DBG_FLAGS(A) & DBG_NOTICE_ON) {			   \
			DBG_PRINT("%s:NOTICE:%s ", DBG_NAME(A), __func__); \
			DBG_PRINTC(S);					   \
		}							   \
	} while (0)

#define DBG_TRACE(A, S...)						  \
	do {								  \
		if (DBG_FLAGS(A) & DBG_TRACE_ON) {			  \
			DBG_PRINT("%s:TRACE:%s ", DBG_NAME(A), __func__); \
			DBG_PRINTC(S);					  \
		}							  \
	} while (0)

#define DBG_VERBOSE(A, S...)						    \
	do {								    \
		if (DBG_FLAGS(A) & DBG_VERBOSE_ON) {			    \
			DBG_PRINT("%s:VERBOSE:%s ", DBG_NAME(A), __func__); \
			DBG_PRINTC(S);					    \
		}							    \
	} while (0)

#define DBG_RX(A, S...)				\
	do {					\
		if (DBG_FLAGS(A) & DBG_RX_ON)	\
			DBG_PRINT(S);		\
	} while (0)

#define DBG_RX_ENTER(A)				\
	do {					\
		if (DBG_FLAGS(A) & DBG_RX_ON)	\
			_DBG_ENTER(A);		\
	} while (0)

#define DBG_RX_LEAVE(A)				\
	do {					\
		if (DBG_FLAGS(A) & DBG_RX_ON)	\
			_DBG_LEAVE(A);		\
	} while (0)

#define DBG_TX(A, S...)				\
	do {					\
		if (DBG_FLAGS(A) & DBG_TX_ON)	\
			DBG_PRINT(S);		\
	} while (0)

#define DBG_TX_ENTER(A)				\
	do {					\
		if (DBG_FLAGS(A) & DBG_TX_ON)	\
			_DBG_ENTER(A);		\
	} while (0)

#define DBG_TX_LEAVE(A)				\
	do {					\
		if (DBG_FLAGS(A) & DBG_TX_ON)	\
			_DBG_LEAVE(A);		\
	} while (0)

#define DBG_ASSERT(C)						\
	do {							\
		if (!(C)) {					\
			DBG_PRINT("ASSERT(%s) -- %s#%d (%s) ",  \
			     #C, __FILE__, __LINE__, __func__); \
			DBG_TRAP;				\
		}						\
	} while (0)

#define STATIC

typedef struct {
	char *dbgName;
	int dbgLevel;
	unsigned long dbgFlags;
} dbg_info_t;

#else /* CONFIG_ET131X_DEBUG */

#define DBG_DEFN
#define DBG_TRAP
#define DBG_PRINT(S...)
#define DBG_ENTER(A)
#define DBG_LEAVE(A)
#define DBG_PARAM(A, N, F, S...)
#define DBG_ERROR(A, S...)
#define DBG_WARNING(A, S...)
#define DBG_NOTICE(A, S...)
#define DBG_TRACE(A, S...)
#define DBG_VERBOSE(A, S...)
#define DBG_RX(A, S...)
#define DBG_RX_ENTER(A)
#define DBG_RX_LEAVE(A)
#define DBG_TX(A, S...)
#define DBG_TX_ENTER(A)
#define DBG_TX_LEAVE(A)
#define DBG_ASSERT(C)
#define STATIC static

#endif /* CONFIG_ET131X_DEBUG */

/* Forward declaration of the private adapter structure */
struct et131x_adapter;

void DumpTxQueueContents(int dbgLvl, struct et131x_adapter *adapter);
void DumpDeviceBlock(int dbgLvl, struct et131x_adapter *adapter,
		     unsigned int Block);
void DumpDeviceReg(int dbgLvl, struct et131x_adapter *adapter);

#endif /* __ET131X_DBG_H__ */