VirtualBox

source: vbox/trunk/src/VBox/Additions/x11/x11include/xorg-server-1.9.0/debug.h@ 58634

Last change on this file since 58634 was 32163, checked in by vboxsync, 14 years ago

Additions/x11/x11include: additional headers for building drivers for X.Org Server 1.9
  • Property svn:eol-style set to native
File size: 7.5 KB
Line 
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
188extern "C" { /* Use "C" linkage when in C++ mode */
189#endif
190
191extern void x86emu_inc_decoded_inst_len (int x);
192extern void x86emu_decode_printf (char *x);
193extern void x86emu_decode_printf2 (char *x, int y);
194extern void x86emu_just_disassemble (void);
195extern void x86emu_single_step (void);
196extern void x86emu_end_instr (void);
197extern void x86emu_dump_regs (void);
198extern void x86emu_dump_xregs (void);
199extern void x86emu_print_int_vect (u16 iv);
200extern void x86emu_instrument_instruction (void);
201extern void x86emu_check_ip_access (void);
202extern void x86emu_check_sp_access (void);
203extern void x86emu_check_mem_access (u32 p);
204extern void x86emu_check_data_access (uint s, uint o);
205
206#ifdef __cplusplus
207} /* End of "C" linkage for C++ */
208#endif
209
210#endif /* __X86EMU_DEBUG_H */
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette