[deb_xorg-server.git] / hw / xfree86 / x86emu / x86emu / debug.h

/****************************************************************************
*
*						Realmode X86 Emulator Library
*
*            	Copyright (C) 1996-1999 SciTech Software, Inc.
* 				     Copyright (C) David Mosberger-Tang
* 					   Copyright (C) 1999 Egbert Eich
*
*  ========================================================================
*
*  Permission to use, copy, modify, distribute, and sell this software and
*  its documentation for any purpose is hereby granted without fee,
*  provided that the above copyright notice appear in all copies and that
*  both that copyright notice and this permission notice appear in
*  supporting documentation, and that the name of the authors not be used
*  in advertising or publicity pertaining to distribution of the software
*  without specific, written prior permission.  The authors makes no
*  representations about the suitability of this software for any purpose.
*  It is provided "as is" without express or implied warranty.
*
*  THE AUTHORS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
*  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
*  EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
*  CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
*  USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
*  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
*  PERFORMANCE OF THIS SOFTWARE.
*
*  ========================================================================
*
* Language:		ANSI C
* Environment:	Any
* Developer:    Kendall Bennett
*
* Description:  Header file for debug definitions.
*
****************************************************************************/

#ifndef __X86EMU_DEBUG_H
#define __X86EMU_DEBUG_H

/*---------------------- Macros and type definitions ----------------------*/

/* checks to be enabled for "runtime" */

#define CHECK_IP_FETCH_F                0x1
#define CHECK_SP_ACCESS_F               0x2
#define CHECK_MEM_ACCESS_F              0x4     /*using regular linear pointer */
#define CHECK_DATA_ACCESS_F             0x8     /*using segment:offset */

#ifdef DEBUG
#define CHECK_IP_FETCH()              	(M.x86.check & CHECK_IP_FETCH_F)
#define CHECK_SP_ACCESS()             	(M.x86.check & CHECK_SP_ACCESS_F)
#define CHECK_MEM_ACCESS()            	(M.x86.check & CHECK_MEM_ACCESS_F)
#define CHECK_DATA_ACCESS()           	(M.x86.check & CHECK_DATA_ACCESS_F)
#else
#define CHECK_IP_FETCH()
#define CHECK_SP_ACCESS()
#define CHECK_MEM_ACCESS()
#define CHECK_DATA_ACCESS()
#endif

#ifdef DEBUG
#define DEBUG_INSTRUMENT()    	(M.x86.debug & DEBUG_INSTRUMENT_F)
#define DEBUG_DECODE()        	(M.x86.debug & DEBUG_DECODE_F)
#define DEBUG_TRACE()         	(M.x86.debug & DEBUG_TRACE_F)
#define DEBUG_STEP()          	(M.x86.debug & DEBUG_STEP_F)
#define DEBUG_DISASSEMBLE()   	(M.x86.debug & DEBUG_DISASSEMBLE_F)
#define DEBUG_BREAK()         	(M.x86.debug & DEBUG_BREAK_F)
#define DEBUG_SVC()           	(M.x86.debug & DEBUG_SVC_F)
#define DEBUG_SAVE_IP_CS()     (M.x86.debug & DEBUG_SAVE_IP_CS_F)

#define DEBUG_FS()            	(M.x86.debug & DEBUG_FS_F)
#define DEBUG_PROC()          	(M.x86.debug & DEBUG_PROC_F)
#define DEBUG_SYSINT()        	(M.x86.debug & DEBUG_SYSINT_F)
#define DEBUG_TRACECALL()     	(M.x86.debug & DEBUG_TRACECALL_F)
#define DEBUG_TRACECALLREGS() 	(M.x86.debug & DEBUG_TRACECALL_REGS_F)
#define DEBUG_SYS()           	(M.x86.debug & DEBUG_SYS_F)
#define DEBUG_MEM_TRACE()     	(M.x86.debug & DEBUG_MEM_TRACE_F)
#define DEBUG_IO_TRACE()      	(M.x86.debug & DEBUG_IO_TRACE_F)
#define DEBUG_DECODE_NOPRINT() (M.x86.debug & DEBUG_DECODE_NOPRINT_F)
#else
#define DEBUG_INSTRUMENT()    	0
#define DEBUG_DECODE()        	0
#define DEBUG_TRACE()         	0
#define DEBUG_STEP()          	0
#define DEBUG_DISASSEMBLE()   	0
#define DEBUG_BREAK()         	0
#define DEBUG_SVC()           	0
#define DEBUG_SAVE_IP_CS()     0
#define DEBUG_FS()            	0
#define DEBUG_PROC()          	0
#define DEBUG_SYSINT()        	0
#define DEBUG_TRACECALL()     	0
#define DEBUG_TRACECALLREGS() 	0
#define DEBUG_SYS()           	0
#define DEBUG_MEM_TRACE()     	0
#define DEBUG_IO_TRACE()      	0
#define DEBUG_DECODE_NOPRINT() 0
#endif

#ifdef DEBUG

#define DECODE_PRINTF(x)     	if (DEBUG_DECODE()) \
									x86emu_decode_printf(x)
#define DECODE_PRINTF2(x,y)  	if (DEBUG_DECODE()) \
									x86emu_decode_printf2(x,y)

/*
 * The following allow us to look at the bytes of an instruction.  The
 * first INCR_INSTRN_LEN, is called everytime bytes are consumed in
 * the decoding process.  The SAVE_IP_CS is called initially when the
 * major opcode of the instruction is accessed.
 */
#define INC_DECODED_INST_LEN(x)                    	\
	if (DEBUG_DECODE())  	                       	\
		x86emu_inc_decoded_inst_len(x)

#define SAVE_IP_CS(x,y)                               			\
	if (DEBUG_DECODE() | DEBUG_TRACECALL() | DEBUG_BREAK() \
              | DEBUG_IO_TRACE() | DEBUG_SAVE_IP_CS()) { \
		M.x86.saved_cs = x;                          			\
		M.x86.saved_ip = y;                          			\
	}
#else
#define INC_DECODED_INST_LEN(x)
#define DECODE_PRINTF(x)
#define DECODE_PRINTF2(x,y)
#define SAVE_IP_CS(x,y)
#endif

#ifdef DEBUG
#define TRACE_REGS()                                   		\
	if (DEBUG_DISASSEMBLE()) {                         		\
		x86emu_just_disassemble();                        	\
		goto EndOfTheInstructionProcedure;             		\
	}                                                   	\
	if (DEBUG_TRACE() || DEBUG_DECODE()) X86EMU_trace_regs()
#else
#define TRACE_REGS()
#endif

#ifdef DEBUG
#define SINGLE_STEP()		if (DEBUG_STEP()) x86emu_single_step()
#else
#define SINGLE_STEP()
#endif

#define TRACE_AND_STEP()	\
	TRACE_REGS();			\
	SINGLE_STEP()

#ifdef DEBUG
#define START_OF_INSTR()
#define END_OF_INSTR()		EndOfTheInstructionProcedure: x86emu_end_instr();
#define END_OF_INSTR_NO_TRACE()	x86emu_end_instr();
#else
#define START_OF_INSTR()
#define END_OF_INSTR()
#define END_OF_INSTR_NO_TRACE()
#endif

#ifdef DEBUG
#define  CALL_TRACE(u,v,w,x,s)                                 \
	if (DEBUG_TRACECALLREGS())									\
		x86emu_dump_regs();                                     \
	if (DEBUG_TRACECALL())                                     	\
		printk("%04x:%04x: CALL %s%04x:%04x\n", u , v, s, w, x);
#define RETURN_TRACE(n,u,v)                                    \
	if (DEBUG_TRACECALLREGS())									\
		x86emu_dump_regs();                                     \
	if (DEBUG_TRACECALL())                                     	\
		printk("%04x:%04x: %s\n",u,v,n);
#else
#define CALL_TRACE(u,v,w,x,s)
#define RETURN_TRACE(n,u,v)
#endif

#ifdef DEBUG
#define	DB(x)	x
#else
#define	DB(x)
#endif

/*-------------------------- Function Prototypes --------------------------*/

#ifdef  __cplusplus
extern "C" {                    /* Use "C" linkage when in C++ mode */
#endif

    extern void x86emu_inc_decoded_inst_len(int x);
    extern void x86emu_decode_printf(const char *x);
    extern void x86emu_decode_printf2(const char *x, int y);
    extern void x86emu_just_disassemble(void);
    extern void x86emu_single_step(void);
    extern void x86emu_end_instr(void);
    extern void x86emu_dump_regs(void);
    extern void x86emu_dump_xregs(void);
    extern void x86emu_print_int_vect(u16 iv);
    extern void x86emu_instrument_instruction(void);
    extern void x86emu_check_ip_access(void);
    extern void x86emu_check_sp_access(void);
    extern void x86emu_check_mem_access(u32 p);
    extern void x86emu_check_data_access(uint s, uint o);

#ifdef  __cplusplus
}                               /* End of "C" linkage for C++           */
#endif
#endif                          /* __X86EMU_DEBUG_H */
Commit	Line	Data
a09e091a JB	1	/****************************************************************************
	2	*
	3	* Realmode X86 Emulator Library
	4	*
	5	* Copyright (C) 1996-1999 SciTech Software, Inc.
	6	* Copyright (C) David Mosberger-Tang
	7	* Copyright (C) 1999 Egbert Eich
	8	*
	9	* ========================================================================
	10	*
	11	* Permission to use, copy, modify, distribute, and sell this software and
	12	* its documentation for any purpose is hereby granted without fee,
	13	* provided that the above copyright notice appear in all copies and that
	14	* both that copyright notice and this permission notice appear in
	15	* supporting documentation, and that the name of the authors not be used
	16	* in advertising or publicity pertaining to distribution of the software
	17	* without specific, written prior permission. The authors makes no
	18	* representations about the suitability of this software for any purpose.
	19	* It is provided "as is" without express or implied warranty.
	20	*
	21	* THE AUTHORS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
	22	* INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
	23	* EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
	24	* CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
	25	* USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
	26	* OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
	27	* PERFORMANCE OF THIS SOFTWARE.
	28	*
	29	* ========================================================================
	30	*
	31	* Language: ANSI C
	32	* Environment: Any
	33	* Developer: Kendall Bennett
	34	*
	35	* Description: Header file for debug definitions.
	36	*
	37	****************************************************************************/
	38
	39	#ifndef __X86EMU_DEBUG_H
	40	#define __X86EMU_DEBUG_H
	41
	42	/---------------------- Macros and type definitions ----------------------/
	43
	44	/* checks to be enabled for "runtime" */
	45
	46	#define CHECK_IP_FETCH_F 0x1
	47	#define CHECK_SP_ACCESS_F 0x2
	48	#define CHECK_MEM_ACCESS_F 0x4 /using regular linear pointer /
	49	#define CHECK_DATA_ACCESS_F 0x8 /using segment:offset /
	50
	51	#ifdef DEBUG
	52	#define CHECK_IP_FETCH() (M.x86.check & CHECK_IP_FETCH_F)
	53	#define CHECK_SP_ACCESS() (M.x86.check & CHECK_SP_ACCESS_F)
	54	#define CHECK_MEM_ACCESS() (M.x86.check & CHECK_MEM_ACCESS_F)
	55	#define CHECK_DATA_ACCESS() (M.x86.check & CHECK_DATA_ACCESS_F)
	56	#else
	57	#define CHECK_IP_FETCH()
	58	#define CHECK_SP_ACCESS()
	59	#define CHECK_MEM_ACCESS()
	60	#define CHECK_DATA_ACCESS()
	61	#endif
	62
	63	#ifdef DEBUG
	64	#define DEBUG_INSTRUMENT() (M.x86.debug & DEBUG_INSTRUMENT_F)
65	#define DEBUG_DECODE() (M.x86.debug & DEBUG_DECODE_F)
66	#define DEBUG_TRACE() (M.x86.debug & DEBUG_TRACE_F)
67	#define DEBUG_STEP() (M.x86.debug & DEBUG_STEP_F)
68	#define DEBUG_DISASSEMBLE() (M.x86.debug & DEBUG_DISASSEMBLE_F)
69	#define DEBUG_BREAK() (M.x86.debug & DEBUG_BREAK_F)
70	#define DEBUG_SVC() (M.x86.debug & DEBUG_SVC_F)
71	#define DEBUG_SAVE_IP_CS() (M.x86.debug & DEBUG_SAVE_IP_CS_F)
72
73	#define DEBUG_FS() (M.x86.debug & DEBUG_FS_F)
74	#define DEBUG_PROC() (M.x86.debug & DEBUG_PROC_F)
75	#define DEBUG_SYSINT() (M.x86.debug & DEBUG_SYSINT_F)
76	#define DEBUG_TRACECALL() (M.x86.debug & DEBUG_TRACECALL_F)
77	#define DEBUG_TRACECALLREGS() (M.x86.debug & DEBUG_TRACECALL_REGS_F)
78	#define DEBUG_SYS() (M.x86.debug & DEBUG_SYS_F)
79	#define DEBUG_MEM_TRACE() (M.x86.debug & DEBUG_MEM_TRACE_F)
80	#define DEBUG_IO_TRACE() (M.x86.debug & DEBUG_IO_TRACE_F)
81	#define DEBUG_DECODE_NOPRINT() (M.x86.debug & DEBUG_DECODE_NOPRINT_F)
82	#else
83	#define DEBUG_INSTRUMENT() 0
84	#define DEBUG_DECODE() 0
85	#define DEBUG_TRACE() 0
86	#define DEBUG_STEP() 0
87	#define DEBUG_DISASSEMBLE() 0
88	#define DEBUG_BREAK() 0
89	#define DEBUG_SVC() 0
90	#define DEBUG_SAVE_IP_CS() 0
91	#define DEBUG_FS() 0
92	#define DEBUG_PROC() 0
93	#define DEBUG_SYSINT() 0
94	#define DEBUG_TRACECALL() 0
95	#define DEBUG_TRACECALLREGS() 0
96	#define DEBUG_SYS() 0
97	#define DEBUG_MEM_TRACE() 0
98	#define DEBUG_IO_TRACE() 0
99	#define DEBUG_DECODE_NOPRINT() 0
100	#endif
101
102	#ifdef DEBUG
103
104	#define DECODE_PRINTF(x) if (DEBUG_DECODE()) \
105	x86emu_decode_printf(x)
106	#define DECODE_PRINTF2(x,y) if (DEBUG_DECODE()) \
107	x86emu_decode_printf2(x,y)
108
109	/*
110	* The following allow us to look at the bytes of an instruction. The
111	* first INCR_INSTRN_LEN, is called everytime bytes are consumed in
112	* the decoding process. The SAVE_IP_CS is called initially when the
113	* major opcode of the instruction is accessed.
114	*/
115	#define INC_DECODED_INST_LEN(x) \
116	if (DEBUG_DECODE()) \
117	x86emu_inc_decoded_inst_len(x)
118
119	#define SAVE_IP_CS(x,y) \
120	if (DEBUG_DECODE() \| DEBUG_TRACECALL() \| DEBUG_BREAK() \
121	\| DEBUG_IO_TRACE() \| DEBUG_SAVE_IP_CS()) { \
122	M.x86.saved_cs = x; \
123	M.x86.saved_ip = y; \
124	}
125	#else
126	#define INC_DECODED_INST_LEN(x)
127	#define DECODE_PRINTF(x)
128	#define DECODE_PRINTF2(x,y)
129	#define SAVE_IP_CS(x,y)
130	#endif
131
132	#ifdef DEBUG
133	#define TRACE_REGS() \
134	if (DEBUG_DISASSEMBLE()) { \
135	x86emu_just_disassemble(); \
136	goto EndOfTheInstructionProcedure; \
137	} \
138	if (DEBUG_TRACE() \|\| DEBUG_DECODE()) X86EMU_trace_regs()
139	#else
140	#define TRACE_REGS()
141	#endif
142
143	#ifdef DEBUG
144	#define SINGLE_STEP() if (DEBUG_STEP()) x86emu_single_step()
145	#else
146	#define SINGLE_STEP()
147	#endif
148
149	#define TRACE_AND_STEP() \
150	TRACE_REGS(); \
151	SINGLE_STEP()
152
153	#ifdef DEBUG
154	#define START_OF_INSTR()
155	#define END_OF_INSTR() EndOfTheInstructionProcedure: x86emu_end_instr();
156	#define END_OF_INSTR_NO_TRACE() x86emu_end_instr();
157	#else
158	#define START_OF_INSTR()
159	#define END_OF_INSTR()
160	#define END_OF_INSTR_NO_TRACE()
161	#endif
162
163	#ifdef DEBUG
164	#define CALL_TRACE(u,v,w,x,s) \
165	if (DEBUG_TRACECALLREGS()) \
166	x86emu_dump_regs(); \
167	if (DEBUG_TRACECALL()) \
168	printk("%04x:%04x: CALL %s%04x:%04x\n", u , v, s, w, x);
169	#define RETURN_TRACE(n,u,v) \
170	if (DEBUG_TRACECALLREGS()) \
171	x86emu_dump_regs(); \
172	if (DEBUG_TRACECALL()) \
173	printk("%04x:%04x: %s\n",u,v,n);
174	#else
175	#define CALL_TRACE(u,v,w,x,s)
176	#define RETURN_TRACE(n,u,v)
177	#endif
178
179	#ifdef DEBUG
180	#define DB(x) x
181	#else
182	#define DB(x)
183	#endif
184
185	/-------------------------- Function Prototypes --------------------------/
186
187	#ifdef __cplusplus
188	extern "C" { /* Use "C" linkage when in C++ mode */
189	#endif
190
191	extern void x86emu_inc_decoded_inst_len(int x);
192	extern void x86emu_decode_printf(const char *x);
193	extern void x86emu_decode_printf2(const char *x, int y);
194	extern void x86emu_just_disassemble(void);
195	extern void x86emu_single_step(void);
196	extern void x86emu_end_instr(void);
197	extern void x86emu_dump_regs(void);
198	extern void x86emu_dump_xregs(void);
199	extern void x86emu_print_int_vect(u16 iv);
200	extern void x86emu_instrument_instruction(void);
201	extern void x86emu_check_ip_access(void);
202	extern void x86emu_check_sp_access(void);
203	extern void x86emu_check_mem_access(u32 p);
204	extern void x86emu_check_data_access(uint s, uint o);
205
206	#ifdef __cplusplus
207	} /* End of "C" linkage for C++ */
208	#endif
209	#endif /* __X86EMU_DEBUG_H */