/**************************************************************************** * * Realmode X86 Emulator Library * * Copyright (C) 1991-2004 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: This file contains the code to handle debugging of the * emulator. * ****************************************************************************/ #include "bas_types.h" #include "bas_printf.h" #include "bas_string.h" #include "x86debug.h" #include "x86emui.h" /*----------------------------- Implementation ----------------------------*/ #ifdef DBG_X86EMU static void print_encoded_bytes (uint16_t s, uint16_t o); static void print_decoded_instruction (void); //static int parse_line (char *s, int *ps, int *n); /* should look something like debug's output. */ void X86EMU_trace_regs (void) { if (DEBUG_TRACE()) { x86emu_dump_regs(); } if (DEBUG_DECODE() && !DEBUG_DECODE_NOPRINT()) { xprintf("%04x:%04x ", M.x86.saved_cs, M.x86.saved_ip); print_encoded_bytes(M.x86.saved_cs, M.x86.saved_ip); print_decoded_instruction(); } } void X86EMU_trace_xregs (void) { if (DEBUG_TRACE()) { x86emu_dump_xregs(); } } void x86emu_just_disassemble (void) { /* * This routine called if the flag DEBUG_DISASSEMBLE is set kind * of a hack! */ xprintf("%x:%x ", M.x86.saved_cs, M.x86.saved_ip); print_encoded_bytes( M.x86.saved_cs, M.x86.saved_ip); print_decoded_instruction(); } #if 0 static void disassemble_forward (uint16_t seg, uint16_t off, int n) { X86EMU_sysEnv tregs; int i; u8 op1; /* * hack, hack, hack. What we do is use the exact machinery set up * for execution, except that now there is an additional state * flag associated with the "execution", and we are using a copy * of the register struct. All the major opcodes, once fully * decoded, have the following two steps: TRACE_REGS(r,m); * SINGLE_STEP(r,m); which disappear if DEBUG is not defined to * the preprocessor. The TRACE_REGS macro expands to: * * if (debug&DEBUG_DISASSEMBLE) * {just_disassemble(); goto EndOfInstruction;} * if (debug&DEBUG_TRACE) trace_regs(r,m); * * ...... and at the last line of the routine. * * EndOfInstruction: end_instr(); * * Up to the point where TRACE_REG is expanded, NO modifications * are done to any register EXCEPT the IP register, for fetch and * decoding purposes. * * This was done for an entirely different reason, but makes a * nice way to get the system to help debug codes. */ tregs = M; tregs.x86.R_IP = off; tregs.x86.R_CS = seg; /* reset the decoding buffers */ tregs.x86.enc_str_pos = 0; tregs.x86.enc_pos = 0; /* turn on the "disassemble only, no execute" flag */ tregs.x86.debug |= DEBUG_DISASSEMBLE_F; /* DUMP NEXT n instructions to screen in straight_line fashion */ /* * This looks like the regular instruction fetch stream, except * that when this occurs, each fetched opcode, upon seeing the * DEBUG_DISASSEMBLE flag set, exits immediately after decoding * the instruction. XXX --- CHECK THAT MEM IS NOT AFFECTED!!! * Note the use of a copy of the register structure... */ for (i=0; i 256) return; seg = fetch_data_word_abs(0, iv * 4); off = fetch_data_word_abs(0, iv *4 + 2); xprintf("%04x:%04x", seg, off); } void X86EMU_dump_memory (uint16_t seg, uint16_t off, uint32_t amt) { uint32_t start = off & 0xfffffff0; uint32_t end = (off + 16) & 0xfffffff0; uint32_t i; uint32_t current; current = start; while (end <= off + amt) { xprintf("%04x:%04x ", seg, start); for (i = start; i < off; i++) xprintf(" "); for ( ; i< end; i++) xprintf("%02x", fetch_data_byte_abs(seg, i)); xprintf("\r\n"); start = end; end = start + 16; } } void x86emu_single_step (void) { #if 0 char s[1024]; int ps[10]; int ntok; int cmd; int done; int segment; int offset; static int breakpoint; static int noDecode = 1; char *p; if (DEBUG_BREAK()) { if (M.x86.saved_ip != breakpoint) { return; } else { M.x86.debug &= ~DEBUG_DECODE_NOPRINT_F; M.x86.debug |= DEBUG_TRACE_F; M.x86.debug &= ~DEBUG_BREAK_F; print_decoded_instruction (); X86EMU_trace_regs(); } } done=0; offset = M.x86.saved_ip; while (!done) { DPRINT("-"); p = fgets(s, 1023, stdin); cmd = parse_line(s, ps, &ntok); switch(cmd) { case 'u': disassemble_forward(M.x86.saved_cs,(uint16_t)offset,10); break; case 'd': if (ntok == 2) { segment = M.x86.saved_cs; offset = ps[1]; X86EMU_dump_memory(segment,(uint16_t)offset,16); offset += 16; } else if (ntok == 3) { segment = ps[1]; offset = ps[2]; X86EMU_dump_memory(segment,(uint16_t)offset,16); offset += 16; } else { segment = M.x86.saved_cs; X86EMU_dump_memory(segment,(uint16_t)offset,16); offset += 16; } break; case 'c': M.x86.debug ^= DEBUG_TRACECALL_F; break; case 's': M.x86.debug ^= DEBUG_SVC_F | DEBUG_SYS_F | DEBUG_SYSINT_F; break; case 'r': X86EMU_trace_regs(); break; case 'x': X86EMU_trace_xregs(); break; case 'g': if (ntok == 2) { breakpoint = ps[1]; if (noDecode) { M.x86.debug |= DEBUG_DECODE_NOPRINT_F; } else { M.x86.debug &= ~DEBUG_DECODE_NOPRINT_F; } M.x86.debug &= ~DEBUG_TRACE_F; M.x86.debug |= DEBUG_BREAK_F; done = 1; } break; case 'q': M.x86.debug |= DEBUG_EXIT; return; case 'P': noDecode = (noDecode)?0:1; DPRINT("Toggled decoding to "); DPRINT((noDecode)?"FALSE":"TRUE"); DPRINT("\r\n"); break; case 't': case 0: done = 1; break; } } #endif } int X86EMU_trace_on(void) { return M.x86.debug |= DEBUG_STEP_F | DEBUG_DECODE_F | DEBUG_TRACE_F; } int X86EMU_trace_off(void) { return M.x86.debug &= ~(DEBUG_STEP_F | DEBUG_DECODE_F | DEBUG_TRACE_F); } int X86EMU_set_debug(int debug) { return M.x86.debug = debug; } #if 0 static int parse_line (char *s, int *ps, int *n) { int cmd; *n = 0; while (*s == ' ' || *s == '\t') s++; ps[*n] = *s; switch (*s) { case '\n': *n += 1; return 0; default: cmd = *s; *n += 1; } while (1) { while (*s != ' ' && *s != '\t' && *s != '\n') s++; if (*s == '\n') return cmd; while (*s == ' ' || *s == '\t') s++; sscanf(s,"%x",&ps[*n]); *n += 1; } } #endif #endif /* DBG_X86EMU */ void x86emu_dump_regs (void) { xprintf("\tAX=%04x", M.x86.R_AX); xprintf(" BX=%04x", M.x86.R_BX); xprintf(" CX=%04x", M.x86.R_CX); xprintf(" DX=%04x", M.x86.R_DX); xprintf(" SP=%04x", M.x86.R_SP); xprintf(" BP=%04x", M.x86.R_BP); xprintf(" SI=%04x", M.x86.R_SI); xprintf(" DI=%04x", M.x86.R_DI); xprintf("\r\n"); xprintf("\tDS=%04x", M.x86.R_DS); xprintf(" ES=%04x", M.x86.R_ES); xprintf(" SS=%04x", M.x86.R_SS); xprintf(" CS=%04x", M.x86.R_CS); xprintf(" IP=%04x", M.x86.R_IP); if (ACCESS_FLAG(F_OF)) xprintf("OV "); /* CHECKED... */ else xprintf("NV "); if (ACCESS_FLAG(F_DF)) xprintf("DN "); else xprintf("UP "); if (ACCESS_FLAG(F_IF)) xprintf("EI "); else xprintf("DI "); if (ACCESS_FLAG(F_SF)) xprintf("NG "); else xprintf("PL "); if (ACCESS_FLAG(F_ZF)) xprintf("ZR "); else xprintf("NZ "); if (ACCESS_FLAG(F_AF)) xprintf("AC "); else xprintf("NA "); if (ACCESS_FLAG(F_PF)) xprintf("PE "); else xprintf("PO "); if (ACCESS_FLAG(F_CF)) xprintf("CY "); else xprintf("NC "); xprintf("\r\n"); } void x86emu_dump_xregs (void) { xprintf(" EAX=%08x", M.x86.R_EAX ); xprintf(" EBX=%08x", M.x86.R_EBX ); xprintf(" ECX=%08x", M.x86.R_ECX ); xprintf(" EDX=%08x", M.x86.R_EDX ); xprintf("\r\n"); xprintf(" ESP=%08x", M.x86.R_ESP ); xprintf(" EBP=%08x", M.x86.R_EBP ); xprintf(" ESI=%08x", M.x86.R_ESI ); xprintf(" EDI=%08x", M.x86.R_EDI ); xprintf("\r\n"); xprintf(" DS=%08x", M.x86.R_DS ); xprintf(" ES=%08x", M.x86.R_ES ); xprintf(" SS=%08x", M.x86.R_SS ); xprintf(" CS=%08x", M.x86.R_CS ); xprintf(" EIP%08x=", M.x86.R_EIP ); xprintf("\r\n\t"); if (ACCESS_FLAG(F_OF)) xprintf("OV "); /* CHECKED... */ else xprintf("NV "); if (ACCESS_FLAG(F_DF)) xprintf("DN "); else xprintf("UP "); if (ACCESS_FLAG(F_IF)) xprintf("EI "); else xprintf("DI "); if (ACCESS_FLAG(F_SF)) xprintf("NG "); else xprintf("PL "); if (ACCESS_FLAG(F_ZF)) xprintf("ZR "); else xprintf("NZ "); if (ACCESS_FLAG(F_AF)) xprintf("AC "); else xprintf("NA "); if (ACCESS_FLAG(F_PF)) xprintf("PE "); else xprintf("PO "); if (ACCESS_FLAG(F_CF)) xprintf("CY "); else xprintf("NC "); xprintf("\r\n"); }