1*ece92f85SJason Jin /**************************************************************************** 2*ece92f85SJason Jin * 3*ece92f85SJason Jin * Realmode X86 Emulator Library 4*ece92f85SJason Jin * 5*ece92f85SJason Jin * Copyright (C) 1991-2004 SciTech Software, Inc. 6*ece92f85SJason Jin * Copyright (C) David Mosberger-Tang 7*ece92f85SJason Jin * Copyright (C) 1999 Egbert Eich 8*ece92f85SJason Jin * 9*ece92f85SJason Jin * ======================================================================== 10*ece92f85SJason Jin * 11*ece92f85SJason Jin * Permission to use, copy, modify, distribute, and sell this software and 12*ece92f85SJason Jin * its documentation for any purpose is hereby granted without fee, 13*ece92f85SJason Jin * provided that the above copyright notice appear in all copies and that 14*ece92f85SJason Jin * both that copyright notice and this permission notice appear in 15*ece92f85SJason Jin * supporting documentation, and that the name of the authors not be used 16*ece92f85SJason Jin * in advertising or publicity pertaining to distribution of the software 17*ece92f85SJason Jin * without specific, written prior permission. The authors makes no 18*ece92f85SJason Jin * representations about the suitability of this software for any purpose. 19*ece92f85SJason Jin * It is provided "as is" without express or implied warranty. 20*ece92f85SJason Jin * 21*ece92f85SJason Jin * THE AUTHORS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 22*ece92f85SJason Jin * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO 23*ece92f85SJason Jin * EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR 24*ece92f85SJason Jin * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF 25*ece92f85SJason Jin * USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR 26*ece92f85SJason Jin * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 27*ece92f85SJason Jin * PERFORMANCE OF THIS SOFTWARE. 28*ece92f85SJason Jin * 29*ece92f85SJason Jin * ======================================================================== 30*ece92f85SJason Jin * 31*ece92f85SJason Jin * Language: ANSI C 32*ece92f85SJason Jin * Environment: Any 33*ece92f85SJason Jin * Developer: Kendall Bennett 34*ece92f85SJason Jin * 35*ece92f85SJason Jin * Description: Header file for x86 register definitions. 36*ece92f85SJason Jin * 37*ece92f85SJason Jin ****************************************************************************/ 38*ece92f85SJason Jin 39*ece92f85SJason Jin #ifndef __X86EMU_REGS_H 40*ece92f85SJason Jin #define __X86EMU_REGS_H 41*ece92f85SJason Jin 42*ece92f85SJason Jin /*---------------------- Macros and type definitions ----------------------*/ 43*ece92f85SJason Jin 44*ece92f85SJason Jin #pragma pack(1) 45*ece92f85SJason Jin 46*ece92f85SJason Jin /* 47*ece92f85SJason Jin * General EAX, EBX, ECX, EDX type registers. Note that for 48*ece92f85SJason Jin * portability, and speed, the issue of byte swapping is not addressed 49*ece92f85SJason Jin * in the registers. All registers are stored in the default format 50*ece92f85SJason Jin * available on the host machine. The only critical issue is that the 51*ece92f85SJason Jin * registers should line up EXACTLY in the same manner as they do in 52*ece92f85SJason Jin * the 386. That is: 53*ece92f85SJason Jin * 54*ece92f85SJason Jin * EAX & 0xff === AL 55*ece92f85SJason Jin * EAX & 0xffff == AX 56*ece92f85SJason Jin * 57*ece92f85SJason Jin * etc. The result is that alot of the calculations can then be 58*ece92f85SJason Jin * done using the native instruction set fully. 59*ece92f85SJason Jin */ 60*ece92f85SJason Jin 61*ece92f85SJason Jin #ifdef __BIG_ENDIAN__ 62*ece92f85SJason Jin 63*ece92f85SJason Jin typedef struct { 64*ece92f85SJason Jin u32 e_reg; 65*ece92f85SJason Jin } I32_reg_t; 66*ece92f85SJason Jin 67*ece92f85SJason Jin typedef struct { 68*ece92f85SJason Jin u16 filler0, x_reg; 69*ece92f85SJason Jin } I16_reg_t; 70*ece92f85SJason Jin 71*ece92f85SJason Jin typedef struct { 72*ece92f85SJason Jin u8 filler0, filler1, h_reg, l_reg; 73*ece92f85SJason Jin } I8_reg_t; 74*ece92f85SJason Jin 75*ece92f85SJason Jin #else /* !__BIG_ENDIAN__ */ 76*ece92f85SJason Jin 77*ece92f85SJason Jin typedef struct { 78*ece92f85SJason Jin u32 e_reg; 79*ece92f85SJason Jin } I32_reg_t; 80*ece92f85SJason Jin 81*ece92f85SJason Jin typedef struct { 82*ece92f85SJason Jin u16 x_reg; 83*ece92f85SJason Jin } I16_reg_t; 84*ece92f85SJason Jin 85*ece92f85SJason Jin typedef struct { 86*ece92f85SJason Jin u8 l_reg, h_reg; 87*ece92f85SJason Jin } I8_reg_t; 88*ece92f85SJason Jin 89*ece92f85SJason Jin #endif /* BIG_ENDIAN */ 90*ece92f85SJason Jin 91*ece92f85SJason Jin typedef union { 92*ece92f85SJason Jin I32_reg_t I32_reg; 93*ece92f85SJason Jin I16_reg_t I16_reg; 94*ece92f85SJason Jin I8_reg_t I8_reg; 95*ece92f85SJason Jin } i386_general_register; 96*ece92f85SJason Jin 97*ece92f85SJason Jin struct i386_general_regs { 98*ece92f85SJason Jin i386_general_register A, B, C, D; 99*ece92f85SJason Jin }; 100*ece92f85SJason Jin 101*ece92f85SJason Jin typedef struct i386_general_regs Gen_reg_t; 102*ece92f85SJason Jin 103*ece92f85SJason Jin struct i386_special_regs { 104*ece92f85SJason Jin i386_general_register SP, BP, SI, DI, IP; 105*ece92f85SJason Jin u32 FLAGS; 106*ece92f85SJason Jin }; 107*ece92f85SJason Jin 108*ece92f85SJason Jin /* 109*ece92f85SJason Jin * Segment registers here represent the 16 bit quantities 110*ece92f85SJason Jin * CS, DS, ES, SS. 111*ece92f85SJason Jin */ 112*ece92f85SJason Jin 113*ece92f85SJason Jin #undef CS 114*ece92f85SJason Jin #undef DS 115*ece92f85SJason Jin #undef SS 116*ece92f85SJason Jin #undef ES 117*ece92f85SJason Jin #undef FS 118*ece92f85SJason Jin #undef GS 119*ece92f85SJason Jin 120*ece92f85SJason Jin struct i386_segment_regs { 121*ece92f85SJason Jin u16 CS, DS, SS, ES, FS, GS; 122*ece92f85SJason Jin }; 123*ece92f85SJason Jin 124*ece92f85SJason Jin /* 8 bit registers */ 125*ece92f85SJason Jin #define R_AH gen.A.I8_reg.h_reg 126*ece92f85SJason Jin #define R_AL gen.A.I8_reg.l_reg 127*ece92f85SJason Jin #define R_BH gen.B.I8_reg.h_reg 128*ece92f85SJason Jin #define R_BL gen.B.I8_reg.l_reg 129*ece92f85SJason Jin #define R_CH gen.C.I8_reg.h_reg 130*ece92f85SJason Jin #define R_CL gen.C.I8_reg.l_reg 131*ece92f85SJason Jin #define R_DH gen.D.I8_reg.h_reg 132*ece92f85SJason Jin #define R_DL gen.D.I8_reg.l_reg 133*ece92f85SJason Jin 134*ece92f85SJason Jin /* 16 bit registers */ 135*ece92f85SJason Jin #define R_AX gen.A.I16_reg.x_reg 136*ece92f85SJason Jin #define R_BX gen.B.I16_reg.x_reg 137*ece92f85SJason Jin #define R_CX gen.C.I16_reg.x_reg 138*ece92f85SJason Jin #define R_DX gen.D.I16_reg.x_reg 139*ece92f85SJason Jin 140*ece92f85SJason Jin /* 32 bit extended registers */ 141*ece92f85SJason Jin #define R_EAX gen.A.I32_reg.e_reg 142*ece92f85SJason Jin #define R_EBX gen.B.I32_reg.e_reg 143*ece92f85SJason Jin #define R_ECX gen.C.I32_reg.e_reg 144*ece92f85SJason Jin #define R_EDX gen.D.I32_reg.e_reg 145*ece92f85SJason Jin 146*ece92f85SJason Jin /* special registers */ 147*ece92f85SJason Jin #define R_SP spc.SP.I16_reg.x_reg 148*ece92f85SJason Jin #define R_BP spc.BP.I16_reg.x_reg 149*ece92f85SJason Jin #define R_SI spc.SI.I16_reg.x_reg 150*ece92f85SJason Jin #define R_DI spc.DI.I16_reg.x_reg 151*ece92f85SJason Jin #define R_IP spc.IP.I16_reg.x_reg 152*ece92f85SJason Jin #define R_FLG spc.FLAGS 153*ece92f85SJason Jin 154*ece92f85SJason Jin /* special registers */ 155*ece92f85SJason Jin #define R_SP spc.SP.I16_reg.x_reg 156*ece92f85SJason Jin #define R_BP spc.BP.I16_reg.x_reg 157*ece92f85SJason Jin #define R_SI spc.SI.I16_reg.x_reg 158*ece92f85SJason Jin #define R_DI spc.DI.I16_reg.x_reg 159*ece92f85SJason Jin #define R_IP spc.IP.I16_reg.x_reg 160*ece92f85SJason Jin #define R_FLG spc.FLAGS 161*ece92f85SJason Jin 162*ece92f85SJason Jin /* special registers */ 163*ece92f85SJason Jin #define R_ESP spc.SP.I32_reg.e_reg 164*ece92f85SJason Jin #define R_EBP spc.BP.I32_reg.e_reg 165*ece92f85SJason Jin #define R_ESI spc.SI.I32_reg.e_reg 166*ece92f85SJason Jin #define R_EDI spc.DI.I32_reg.e_reg 167*ece92f85SJason Jin #define R_EIP spc.IP.I32_reg.e_reg 168*ece92f85SJason Jin #define R_EFLG spc.FLAGS 169*ece92f85SJason Jin 170*ece92f85SJason Jin /* segment registers */ 171*ece92f85SJason Jin #define R_CS seg.CS 172*ece92f85SJason Jin #define R_DS seg.DS 173*ece92f85SJason Jin #define R_SS seg.SS 174*ece92f85SJason Jin #define R_ES seg.ES 175*ece92f85SJason Jin #define R_FS seg.FS 176*ece92f85SJason Jin #define R_GS seg.GS 177*ece92f85SJason Jin 178*ece92f85SJason Jin /* flag conditions */ 179*ece92f85SJason Jin #define FB_CF 0x0001 /* CARRY flag */ 180*ece92f85SJason Jin #define FB_PF 0x0004 /* PARITY flag */ 181*ece92f85SJason Jin #define FB_AF 0x0010 /* AUX flag */ 182*ece92f85SJason Jin #define FB_ZF 0x0040 /* ZERO flag */ 183*ece92f85SJason Jin #define FB_SF 0x0080 /* SIGN flag */ 184*ece92f85SJason Jin #define FB_TF 0x0100 /* TRAP flag */ 185*ece92f85SJason Jin #define FB_IF 0x0200 /* INTERRUPT ENABLE flag */ 186*ece92f85SJason Jin #define FB_DF 0x0400 /* DIR flag */ 187*ece92f85SJason Jin #define FB_OF 0x0800 /* OVERFLOW flag */ 188*ece92f85SJason Jin 189*ece92f85SJason Jin /* 80286 and above always have bit#1 set */ 190*ece92f85SJason Jin #define F_ALWAYS_ON (0x0002) /* flag bits always on */ 191*ece92f85SJason Jin 192*ece92f85SJason Jin /* 193*ece92f85SJason Jin * Define a mask for only those flag bits we will ever pass back 194*ece92f85SJason Jin * (via PUSHF) 195*ece92f85SJason Jin */ 196*ece92f85SJason Jin #define F_MSK (FB_CF|FB_PF|FB_AF|FB_ZF|FB_SF|FB_TF|FB_IF|FB_DF|FB_OF) 197*ece92f85SJason Jin 198*ece92f85SJason Jin /* following bits masked in to a 16bit quantity */ 199*ece92f85SJason Jin 200*ece92f85SJason Jin #define F_CF 0x0001 /* CARRY flag */ 201*ece92f85SJason Jin #define F_PF 0x0004 /* PARITY flag */ 202*ece92f85SJason Jin #define F_AF 0x0010 /* AUX flag */ 203*ece92f85SJason Jin #define F_ZF 0x0040 /* ZERO flag */ 204*ece92f85SJason Jin #define F_SF 0x0080 /* SIGN flag */ 205*ece92f85SJason Jin #define F_TF 0x0100 /* TRAP flag */ 206*ece92f85SJason Jin #define F_IF 0x0200 /* INTERRUPT ENABLE flag */ 207*ece92f85SJason Jin #define F_DF 0x0400 /* DIR flag */ 208*ece92f85SJason Jin #define F_OF 0x0800 /* OVERFLOW flag */ 209*ece92f85SJason Jin 210*ece92f85SJason Jin #define TOGGLE_FLAG(flag) (M.x86.R_FLG ^= (flag)) 211*ece92f85SJason Jin #define SET_FLAG(flag) (M.x86.R_FLG |= (flag)) 212*ece92f85SJason Jin #define CLEAR_FLAG(flag) (M.x86.R_FLG &= ~(flag)) 213*ece92f85SJason Jin #define ACCESS_FLAG(flag) (M.x86.R_FLG & (flag)) 214*ece92f85SJason Jin #define CLEARALL_FLAG(m) (M.x86.R_FLG = 0) 215*ece92f85SJason Jin 216*ece92f85SJason Jin #define CONDITIONAL_SET_FLAG(COND,FLAG) \ 217*ece92f85SJason Jin if (COND) SET_FLAG(FLAG); else CLEAR_FLAG(FLAG) 218*ece92f85SJason Jin 219*ece92f85SJason Jin #define F_PF_CALC 0x010000 /* PARITY flag has been calced */ 220*ece92f85SJason Jin #define F_ZF_CALC 0x020000 /* ZERO flag has been calced */ 221*ece92f85SJason Jin #define F_SF_CALC 0x040000 /* SIGN flag has been calced */ 222*ece92f85SJason Jin 223*ece92f85SJason Jin #define F_ALL_CALC 0xff0000 /* All have been calced */ 224*ece92f85SJason Jin 225*ece92f85SJason Jin /* 226*ece92f85SJason Jin * Emulator machine state. 227*ece92f85SJason Jin * Segment usage control. 228*ece92f85SJason Jin */ 229*ece92f85SJason Jin #define SYSMODE_SEG_DS_SS 0x00000001 230*ece92f85SJason Jin #define SYSMODE_SEGOVR_CS 0x00000002 231*ece92f85SJason Jin #define SYSMODE_SEGOVR_DS 0x00000004 232*ece92f85SJason Jin #define SYSMODE_SEGOVR_ES 0x00000008 233*ece92f85SJason Jin #define SYSMODE_SEGOVR_FS 0x00000010 234*ece92f85SJason Jin #define SYSMODE_SEGOVR_GS 0x00000020 235*ece92f85SJason Jin #define SYSMODE_SEGOVR_SS 0x00000040 236*ece92f85SJason Jin #define SYSMODE_PREFIX_REPE 0x00000080 237*ece92f85SJason Jin #define SYSMODE_PREFIX_REPNE 0x00000100 238*ece92f85SJason Jin #define SYSMODE_PREFIX_DATA 0x00000200 239*ece92f85SJason Jin #define SYSMODE_PREFIX_ADDR 0x00000400 240*ece92f85SJason Jin #define SYSMODE_INTR_PENDING 0x10000000 241*ece92f85SJason Jin #define SYSMODE_EXTRN_INTR 0x20000000 242*ece92f85SJason Jin #define SYSMODE_HALTED 0x40000000 243*ece92f85SJason Jin 244*ece92f85SJason Jin #define SYSMODE_SEGMASK (SYSMODE_SEG_DS_SS | \ 245*ece92f85SJason Jin SYSMODE_SEGOVR_CS | \ 246*ece92f85SJason Jin SYSMODE_SEGOVR_DS | \ 247*ece92f85SJason Jin SYSMODE_SEGOVR_ES | \ 248*ece92f85SJason Jin SYSMODE_SEGOVR_FS | \ 249*ece92f85SJason Jin SYSMODE_SEGOVR_GS | \ 250*ece92f85SJason Jin SYSMODE_SEGOVR_SS) 251*ece92f85SJason Jin #define SYSMODE_CLRMASK (SYSMODE_SEG_DS_SS | \ 252*ece92f85SJason Jin SYSMODE_SEGOVR_CS | \ 253*ece92f85SJason Jin SYSMODE_SEGOVR_DS | \ 254*ece92f85SJason Jin SYSMODE_SEGOVR_ES | \ 255*ece92f85SJason Jin SYSMODE_SEGOVR_FS | \ 256*ece92f85SJason Jin SYSMODE_SEGOVR_GS | \ 257*ece92f85SJason Jin SYSMODE_SEGOVR_SS | \ 258*ece92f85SJason Jin SYSMODE_PREFIX_DATA | \ 259*ece92f85SJason Jin SYSMODE_PREFIX_ADDR) 260*ece92f85SJason Jin 261*ece92f85SJason Jin #define INTR_SYNCH 0x1 262*ece92f85SJason Jin #define INTR_ASYNCH 0x2 263*ece92f85SJason Jin #define INTR_HALTED 0x4 264*ece92f85SJason Jin 265*ece92f85SJason Jin typedef struct { 266*ece92f85SJason Jin struct i386_general_regs gen; 267*ece92f85SJason Jin struct i386_special_regs spc; 268*ece92f85SJason Jin struct i386_segment_regs seg; 269*ece92f85SJason Jin /* 270*ece92f85SJason Jin * MODE contains information on: 271*ece92f85SJason Jin * REPE prefix 2 bits repe,repne 272*ece92f85SJason Jin * SEGMENT overrides 5 bits normal,DS,SS,CS,ES 273*ece92f85SJason Jin * Delayed flag set 3 bits (zero, signed, parity) 274*ece92f85SJason Jin * reserved 6 bits 275*ece92f85SJason Jin * interrupt # 8 bits instruction raised interrupt 276*ece92f85SJason Jin * BIOS video segregs 4 bits 277*ece92f85SJason Jin * Interrupt Pending 1 bits 278*ece92f85SJason Jin * Extern interrupt 1 bits 279*ece92f85SJason Jin * Halted 1 bits 280*ece92f85SJason Jin */ 281*ece92f85SJason Jin long mode; 282*ece92f85SJason Jin u8 intno; 283*ece92f85SJason Jin volatile int intr; /* mask of pending interrupts */ 284*ece92f85SJason Jin int debug; 285*ece92f85SJason Jin #ifdef DEBUG 286*ece92f85SJason Jin int check; 287*ece92f85SJason Jin u16 saved_ip; 288*ece92f85SJason Jin u16 saved_cs; 289*ece92f85SJason Jin int enc_pos; 290*ece92f85SJason Jin int enc_str_pos; 291*ece92f85SJason Jin char decode_buf[32]; /* encoded byte stream */ 292*ece92f85SJason Jin char decoded_buf[256]; /* disassembled strings */ 293*ece92f85SJason Jin #endif 294*ece92f85SJason Jin } X86EMU_regs; 295*ece92f85SJason Jin 296*ece92f85SJason Jin /**************************************************************************** 297*ece92f85SJason Jin REMARKS: 298*ece92f85SJason Jin Structure maintaining the emulator machine state. 299*ece92f85SJason Jin 300*ece92f85SJason Jin MEMBERS: 301*ece92f85SJason Jin x86 - X86 registers 302*ece92f85SJason Jin mem_base - Base real mode memory for the emulator 303*ece92f85SJason Jin mem_size - Size of the real mode memory block for the emulator 304*ece92f85SJason Jin ****************************************************************************/ 305*ece92f85SJason Jin #undef x86 306*ece92f85SJason Jin typedef struct { 307*ece92f85SJason Jin X86EMU_regs x86; 308*ece92f85SJason Jin u8 *mem_base; 309*ece92f85SJason Jin u32 mem_size; 310*ece92f85SJason Jin void *private; 311*ece92f85SJason Jin } X86EMU_sysEnv; 312*ece92f85SJason Jin 313*ece92f85SJason Jin #pragma pack() 314*ece92f85SJason Jin 315*ece92f85SJason Jin /*----------------------------- Global Variables --------------------------*/ 316*ece92f85SJason Jin 317*ece92f85SJason Jin #ifdef __cplusplus 318*ece92f85SJason Jin extern "C" { /* Use "C" linkage when in C++ mode */ 319*ece92f85SJason Jin #endif 320*ece92f85SJason Jin 321*ece92f85SJason Jin /* Global emulator machine state. 322*ece92f85SJason Jin * 323*ece92f85SJason Jin * We keep it global to avoid pointer dereferences in the code for speed. 324*ece92f85SJason Jin */ 325*ece92f85SJason Jin 326*ece92f85SJason Jin extern X86EMU_sysEnv _X86EMU_env; 327*ece92f85SJason Jin #define M _X86EMU_env 328*ece92f85SJason Jin 329*ece92f85SJason Jin /*-------------------------- Function Prototypes --------------------------*/ 330*ece92f85SJason Jin 331*ece92f85SJason Jin /* Function to log information at runtime */ 332*ece92f85SJason Jin 333*ece92f85SJason Jin #ifndef __KERNEL__ 334*ece92f85SJason Jin void printk(const char *fmt, ...); 335*ece92f85SJason Jin #endif 336*ece92f85SJason Jin 337*ece92f85SJason Jin #ifdef __cplusplus 338*ece92f85SJason Jin } /* End of "C" linkage for C++ */ 339*ece92f85SJason Jin #endif 340*ece92f85SJason Jin #endif /* __X86EMU_REGS_H */ 341