]>
git.ipfire.org Git - people/ms/u-boot.git/blob - drivers/bios_emulator/x86emu/debug.c
1 /****************************************************************************
3 * Realmode X86 Emulator Library
5 * Copyright (C) 1991-2004 SciTech Software, Inc.
6 * Copyright (C) David Mosberger-Tang
7 * Copyright (C) 1999 Egbert Eich
9 * ========================================================================
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.
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.
29 * ========================================================================
33 * Developer: Kendall Bennett
35 * Description: This file contains the code to handle debugging of the
38 ****************************************************************************/
42 #include <linux/ctype.h>
43 #include "x86emu/x86emui.h"
45 /*----------------------------- Implementation ----------------------------*/
49 static void print_encoded_bytes(u16 s
, u16 o
);
50 static void print_decoded_instruction(void);
51 static int x86emu_parse_line(char *s
, int *ps
, int *n
);
53 /* should look something like debug's output. */
54 void X86EMU_trace_regs(void)
59 if (DEBUG_DECODE() && !DEBUG_DECODE_NOPRINT()) {
60 printk("%04x:%04x ", M
.x86
.saved_cs
, M
.x86
.saved_ip
);
61 print_encoded_bytes(M
.x86
.saved_cs
, M
.x86
.saved_ip
);
62 print_decoded_instruction();
66 void X86EMU_trace_xregs(void)
73 void x86emu_just_disassemble(void)
76 * This routine called if the flag DEBUG_DISASSEMBLE is set kind
79 printk("%04x:%04x ", M
.x86
.saved_cs
, M
.x86
.saved_ip
);
80 print_encoded_bytes(M
.x86
.saved_cs
, M
.x86
.saved_ip
);
81 print_decoded_instruction();
84 static void disassemble_forward(u16 seg
, u16 off
, int n
)
90 * hack, hack, hack. What we do is use the exact machinery set up
91 * for execution, except that now there is an additional state
92 * flag associated with the "execution", and we are using a copy
93 * of the register struct. All the major opcodes, once fully
94 * decoded, have the following two steps: TRACE_REGS(r,m);
95 * SINGLE_STEP(r,m); which disappear if DEBUG is not defined to
96 * the preprocessor. The TRACE_REGS macro expands to:
98 * if (debug&DEBUG_DISASSEMBLE)
99 * {just_disassemble(); goto EndOfInstruction;}
100 * if (debug&DEBUG_TRACE) trace_regs(r,m);
102 * ...... and at the last line of the routine.
104 * EndOfInstruction: end_instr();
106 * Up to the point where TRACE_REG is expanded, NO modifications
107 * are done to any register EXCEPT the IP register, for fetch and
110 * This was done for an entirely different reason, but makes a
111 * nice way to get the system to help debug codes.
114 tregs
.x86
.R_IP
= off
;
115 tregs
.x86
.R_CS
= seg
;
117 /* reset the decoding buffers */
118 tregs
.x86
.enc_str_pos
= 0;
119 tregs
.x86
.enc_pos
= 0;
121 /* turn on the "disassemble only, no execute" flag */
122 tregs
.x86
.debug
|= DEBUG_DISASSEMBLE_F
;
124 /* DUMP NEXT n instructions to screen in straight_line fashion */
126 * This looks like the regular instruction fetch stream, except
127 * that when this occurs, each fetched opcode, upon seeing the
128 * DEBUG_DISASSEMBLE flag set, exits immediately after decoding
129 * the instruction. XXX --- CHECK THAT MEM IS NOT AFFECTED!!!
130 * Note the use of a copy of the register structure...
132 for (i
= 0; i
< n
; i
++) {
133 op1
= (*sys_rdb
) (((u32
) M
.x86
.R_CS
<< 4) + (M
.x86
.R_IP
++));
134 (x86emu_optab
[op1
]) (op1
);
136 /* end major hack mode. */
139 void x86emu_check_ip_access(void)
144 void x86emu_check_sp_access(void)
148 void x86emu_check_mem_access(u32 dummy
)
150 /* check bounds, etc */
153 void x86emu_check_data_access(uint dummy1
, uint dummy2
)
155 /* check bounds, etc */
158 void x86emu_inc_decoded_inst_len(int x
)
163 void x86emu_decode_printf(char *x
)
165 sprintf(M
.x86
.decoded_buf
+ M
.x86
.enc_str_pos
, "%s", x
);
166 M
.x86
.enc_str_pos
+= strlen(x
);
169 void x86emu_decode_printf2(char *x
, int y
)
173 sprintf(M
.x86
.decoded_buf
+ M
.x86
.enc_str_pos
, "%s", temp
);
174 M
.x86
.enc_str_pos
+= strlen(temp
);
177 void x86emu_end_instr(void)
179 M
.x86
.enc_str_pos
= 0;
183 static void print_encoded_bytes(u16 s
, u16 o
)
187 for (i
= 0; i
< M
.x86
.enc_pos
; i
++) {
188 sprintf(buf1
+ 2 * i
, "%02x", fetch_data_byte_abs(s
, o
+ i
));
190 printk("%-20s", buf1
);
193 static void print_decoded_instruction(void)
195 printk("%s", M
.x86
.decoded_buf
);
198 void x86emu_print_int_vect(u16 iv
)
204 seg
= fetch_data_word_abs(0, iv
* 4);
205 off
= fetch_data_word_abs(0, iv
* 4 + 2);
206 printk("%04x:%04x ", seg
, off
);
209 void X86EMU_dump_memory(u16 seg
, u16 off
, u32 amt
)
211 u32 start
= off
& 0xfffffff0;
212 u32 end
= (off
+ 16) & 0xfffffff0;
217 while (end
<= off
+ amt
) {
218 printk("%04x:%04x ", seg
, start
);
219 for (i
= start
; i
< off
; i
++)
222 printk("%02x ", fetch_data_byte_abs(seg
, i
));
229 void x86emu_single_step(void)
238 static int breakpoint
;
239 static int noDecode
= 1;
244 if (M
.x86
.saved_ip
!= breakpoint
) {
247 M
.x86
.debug
&= ~DEBUG_DECODE_NOPRINT_F
;
248 M
.x86
.debug
|= DEBUG_TRACE_F
;
249 M
.x86
.debug
&= ~DEBUG_BREAK_F
;
250 print_decoded_instruction();
255 offset
= M
.x86
.saved_ip
;
258 cmd
= x86emu_parse_line(s
, ps
, &ntok
);
261 disassemble_forward(M
.x86
.saved_cs
, (u16
) offset
, 10);
265 segment
= M
.x86
.saved_cs
;
267 X86EMU_dump_memory(segment
, (u16
) offset
, 16);
269 } else if (ntok
== 3) {
272 X86EMU_dump_memory(segment
, (u16
) offset
, 16);
275 segment
= M
.x86
.saved_cs
;
276 X86EMU_dump_memory(segment
, (u16
) offset
, 16);
281 M
.x86
.debug
^= DEBUG_TRACECALL_F
;
285 DEBUG_SVC_F
| DEBUG_SYS_F
| DEBUG_SYSINT_F
;
291 X86EMU_trace_xregs();
297 M
.x86
.debug
|= DEBUG_DECODE_NOPRINT_F
;
299 M
.x86
.debug
&= ~DEBUG_DECODE_NOPRINT_F
;
301 M
.x86
.debug
&= ~DEBUG_TRACE_F
;
302 M
.x86
.debug
|= DEBUG_BREAK_F
;
307 M
.x86
.debug
|= DEBUG_EXIT
;
310 noDecode
= (noDecode
) ? 0 : 1;
311 printk("Toggled decoding to %s\n",
312 (noDecode
) ? "false" : "true");
322 int X86EMU_trace_on(void)
324 return M
.x86
.debug
|= DEBUG_STEP_F
| DEBUG_DECODE_F
| DEBUG_TRACE_F
;
327 int X86EMU_trace_off(void)
329 return M
.x86
.debug
&= ~(DEBUG_STEP_F
| DEBUG_DECODE_F
| DEBUG_TRACE_F
);
332 static int x86emu_parse_line(char *s
, int *ps
, int *n
)
350 while (!isblank(*s
) && *s
!= '\n')
365 void x86emu_dump_regs(void)
367 printk("\tAX=%04x ", M
.x86
.R_AX
);
368 printk("BX=%04x ", M
.x86
.R_BX
);
369 printk("CX=%04x ", M
.x86
.R_CX
);
370 printk("DX=%04x ", M
.x86
.R_DX
);
371 printk("SP=%04x ", M
.x86
.R_SP
);
372 printk("BP=%04x ", M
.x86
.R_BP
);
373 printk("SI=%04x ", M
.x86
.R_SI
);
374 printk("DI=%04x\n", M
.x86
.R_DI
);
375 printk("\tDS=%04x ", M
.x86
.R_DS
);
376 printk("ES=%04x ", M
.x86
.R_ES
);
377 printk("SS=%04x ", M
.x86
.R_SS
);
378 printk("CS=%04x ", M
.x86
.R_CS
);
379 printk("IP=%04x ", M
.x86
.R_IP
);
380 if (ACCESS_FLAG(F_OF
))
381 printk("OV "); /* CHECKED... */
384 if (ACCESS_FLAG(F_DF
))
388 if (ACCESS_FLAG(F_IF
))
392 if (ACCESS_FLAG(F_SF
))
396 if (ACCESS_FLAG(F_ZF
))
400 if (ACCESS_FLAG(F_AF
))
404 if (ACCESS_FLAG(F_PF
))
408 if (ACCESS_FLAG(F_CF
))
415 void x86emu_dump_xregs(void)
417 printk("\tEAX=%08x ", M
.x86
.R_EAX
);
418 printk("EBX=%08x ", M
.x86
.R_EBX
);
419 printk("ECX=%08x ", M
.x86
.R_ECX
);
420 printk("EDX=%08x \n", M
.x86
.R_EDX
);
421 printk("\tESP=%08x ", M
.x86
.R_ESP
);
422 printk("EBP=%08x ", M
.x86
.R_EBP
);
423 printk("ESI=%08x ", M
.x86
.R_ESI
);
424 printk("EDI=%08x\n", M
.x86
.R_EDI
);
425 printk("\tDS=%04x ", M
.x86
.R_DS
);
426 printk("ES=%04x ", M
.x86
.R_ES
);
427 printk("SS=%04x ", M
.x86
.R_SS
);
428 printk("CS=%04x ", M
.x86
.R_CS
);
429 printk("EIP=%08x\n\t", M
.x86
.R_EIP
);
430 if (ACCESS_FLAG(F_OF
))
431 printk("OV "); /* CHECKED... */
434 if (ACCESS_FLAG(F_DF
))
438 if (ACCESS_FLAG(F_IF
))
442 if (ACCESS_FLAG(F_SF
))
446 if (ACCESS_FLAG(F_ZF
))
450 if (ACCESS_FLAG(F_AF
))
454 if (ACCESS_FLAG(F_PF
))
458 if (ACCESS_FLAG(F_CF
))