Add patch that contain Mali fixes.
[deb_xorg-server.git] / hw / xfree86 / x86emu / x86emu / debug.h
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 */