Changeset 31491 in vbox for trunk/include

Timestamp:

Aug 9, 2010 4:13:37 PM (15 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

64576

Message:

DBGF: Kick-off for DBGFR3Reg*. Implemented simple queried only. The debugger + MachineDebugger will use only this API later on.

Location:

trunk/include/VBox

Files:

• dbgf.h (modified) (1 diff)
• err.h (modified) (1 diff)

trunk/include/VBox/dbgf.h

@@ -937 +937 @@
 
 /**
+ * Register identifiers.
+ */
+typedef enum DBGFREG
+{
+    /* General purpose registers: */
+    DBGFREG_AL  = 0,
+    DBGFREG_AX  = DBGFREG_AL,
+    DBGFREG_EAX = DBGFREG_AL,
+    DBGFREG_RAX = DBGFREG_AL,
+
+    DBGFREG_CL,
+    DBGFREG_CX  = DBGFREG_CL,
+    DBGFREG_ECX = DBGFREG_CL,
+    DBGFREG_RCX = DBGFREG_CL,
+
+    DBGFREG_DL,
+    DBGFREG_DX  = DBGFREG_DL,
+    DBGFREG_EDX = DBGFREG_DL,
+    DBGFREG_RDX = DBGFREG_DL,
+
+    DBGFREG_BL,
+    DBGFREG_BX  = DBGFREG_BL,
+    DBGFREG_EBX = DBGFREG_BL,
+    DBGFREG_RBX = DBGFREG_BL,
+
+    DBGFREG_SPL,
+    DBGFREG_SP  = DBGFREG_SPL,
+    DBGFREG_ESP = DBGFREG_SPL,
+    DBGFREG_RSP = DBGFREG_SPL,
+
+    DBGFREG_BPL,
+    DBGFREG_BP  = DBGFREG_BPL,
+    DBGFREG_EBP = DBGFREG_BPL,
+    DBGFREG_RBP = DBGFREG_BPL,
+
+    DBGFREG_SIL,
+    DBGFREG_SI  = DBGFREG_SIL,
+    DBGFREG_ESI = DBGFREG_SIL,
+    DBGFREG_RSI = DBGFREG_SIL,
+
+    DBGFREG_DIL,
+    DBGFREG_DI  = DBGFREG_DIL,
+    DBGFREG_EDI = DBGFREG_DIL,
+    DBGFREG_RDI = DBGFREG_DIL,
+
+    DBGFREG_R8,
+    DBGFREG_R8B = DBGFREG_R8,
+    DBGFREG_R8W = DBGFREG_R8,
+    DBGFREG_R8D = DBGFREG_R8,
+
+    DBGFREG_R9,
+    DBGFREG_R9B = DBGFREG_R9,
+    DBGFREG_R9W = DBGFREG_R9,
+    DBGFREG_R9D = DBGFREG_R9,
+
+    DBGFREG_R10,
+    DBGFREG_R10B = DBGFREG_R10,
+    DBGFREG_R10W = DBGFREG_R10,
+    DBGFREG_R10D = DBGFREG_R10,
+
+    DBGFREG_R11,
+    DBGFREG_R11B = DBGFREG_R11,
+    DBGFREG_R11W = DBGFREG_R11,
+    DBGFREG_R11D = DBGFREG_R11,
+
+    DBGFREG_R12,
+    DBGFREG_R12B = DBGFREG_R12,
+    DBGFREG_R12W = DBGFREG_R12,
+    DBGFREG_R12D = DBGFREG_R12,
+
+    DBGFREG_R13,
+    DBGFREG_R13B = DBGFREG_R13,
+    DBGFREG_R13W = DBGFREG_R13,
+    DBGFREG_R13D = DBGFREG_R13,
+
+    DBGFREG_R14,
+    DBGFREG_R14B = DBGFREG_R14,
+    DBGFREG_R14W = DBGFREG_R14,
+    DBGFREG_R14D = DBGFREG_R14,
+
+    DBGFREG_R15,
+    DBGFREG_R15B = DBGFREG_R15,
+    DBGFREG_R15W = DBGFREG_R15,
+    DBGFREG_R15D = DBGFREG_R15,
+
+    DBGFREG_AH,
+    DBGFREG_CH,
+    DBGFREG_DH,
+    DBGFREG_BH,
+
+    /* Segments and other special registers: */
+    DBGFREG_CS,
+    DBGFREG_DS,
+    DBGFREG_ES,
+    DBGFREG_FS,
+    DBGFREG_GS,
+    DBGFREG_SS,
+
+    DBGFREG_CS_ATTR,
+    DBGFREG_DS_ATTR,
+    DBGFREG_ES_ATTR,
+    DBGFREG_FS_ATTR,
+    DBGFREG_GS_ATTR,
+    DBGFREG_SS_ATTR,
+
+    DBGFREG_CS_BASE,
+    DBGFREG_DS_BASE,
+    DBGFREG_ES_BASE,
+    DBGFREG_FS_BASE,
+    DBGFREG_GS_BASE,
+    DBGFREG_SS_BASE,
+
+    DBGFREG_CS_LIMIT,
+    DBGFREG_DS_LIMIT,
+    DBGFREG_ES_LIMIT,
+    DBGFREG_FS_LIMIT,
+    DBGFREG_GS_LIMIT,
+    DBGFREG_SS_LIMIT,
+
+    DBGFREG_IP,
+    DBGFREG_EIP = DBGFREG_IP,
+    DBGFREG_RIP = DBGFREG_IP,
+
+    DBGFREG_FLAGS,
+    DBGFREG_EFLAGS = DBGFREG_FLAGS,
+    DBGFREG_RFLAGS = DBGFREG_FLAGS,
+
+    /* FPU: */
+    DBGFREG_ST0,
+    DBGFREG_ST1,
+    DBGFREG_ST2,
+    DBGFREG_ST3,
+    DBGFREG_ST4,
+    DBGFREG_ST5,
+    DBGFREG_ST6,
+    DBGFREG_ST7,
+
+    DBGFREG_MM0,
+    DBGFREG_MM1,
+    DBGFREG_MM2,
+    DBGFREG_MM3,
+    DBGFREG_MM4,
+    DBGFREG_MM5,
+    DBGFREG_MM6,
+    DBGFREG_MM7,
+
+    DBGFREG_FCW,
+    DBGFREG_FSW,
+    DBGFREG_FTW,
+    DBGFREG_FOP,
+    DBGFREG_FPUIP,
+    DBGFREG_FPUCS,
+    DBGFREG_FPUDP,
+    DBGFREG_FPUDS,
+    DBGFREG_MXCSR,
+    DBGFREG_MXCSR_MASK,
+
+    /* SSE: */
+    DBGFREG_XMM0,
+    DBGFREG_XMM1,
+    DBGFREG_XMM2,
+    DBGFREG_XMM3,
+    DBGFREG_XMM4,
+    DBGFREG_XMM5,
+    DBGFREG_XMM6,
+    DBGFREG_XMM7,
+    DBGFREG_XMM8,
+    DBGFREG_XMM9,
+    DBGFREG_XMM10,
+    DBGFREG_XMM11,
+    DBGFREG_XMM12,
+    DBGFREG_XMM13,
+    DBGFREG_XMM14,
+    DBGFREG_XMM15,
+    /** @todo add XMM aliases. */
+
+    /* System registers: */
+    DBGFREG_GDTR,
+    DBGFREG_GDTR_BASE,
+    DBGFREG_GDTR_LIMIT,
+    DBGFREG_IDTR,
+    DBGFREG_IDTR_BASE,
+    DBGFREG_IDTR_LIMIT,
+    DBGFREG_LDTR,
+    DBGFREG_LDTR_ATTR,
+    DBGFREG_LDTR_BASE,
+    DBGFREG_LDTR_LIMIT,
+    DBGFREG_TR,
+    DBGFREG_TR_ATTR,
+    DBGFREG_TR_BASE,
+    DBGFREG_TR_LIMIT,
+
+    DBGFREG_CR0,
+    DBGFREG_CR2,
+    DBGFREG_CR3,
+    DBGFREG_CR4,
+    DBGFREG_CR8,
+
+    DBGFREG_DR0,
+    DBGFREG_DR1,
+    DBGFREG_DR2,
+    DBGFREG_DR3,
+    DBGFREG_DR6,
+    DBGFREG_DR7,
+
+    /* MSRs: */
+    DBGFREG_MSR_IA32_APICBASE,
+    DBGFREG_MSR_IA32_CR_PAT,
+    DBGFREG_MSR_IA32_PERF_STATUS,
+    DBGFREG_MSR_IA32_SYSENTER_CS,
+    DBGFREG_MSR_IA32_SYSENTER_EIP,
+    DBGFREG_MSR_IA32_SYSENTER_ESP,
+    DBGFREG_MSR_IA32_TSC,
+    DBGFREG_MSR_K6_EFER,
+    DBGFREG_MSR_K6_STAR,
+    DBGFREG_MSR_K8_CSTAR,
+    DBGFREG_MSR_K8_FS_BASE,
+    DBGFREG_MSR_K8_GS_BASE,
+    DBGFREG_MSR_K8_KERNEL_GS_BASE,
+    DBGFREG_MSR_K8_LSTAR,
+    DBGFREG_MSR_K8_SF_MASK,
+    DBGFREG_MSR_K8_TSC_AUX,
+
+    /** The end of the registers.  */
+    DBGFREG_END,
+    /** The usual 32-bit type hack. */
+    DBGFREG_32BIT_HACK = 0x7fffffff
+} DBGFREG;
+
+VMMR3DECL(int) DBGFR3RegQueryU8(  PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint8_t     *pu8);
+VMMR3DECL(int) DBGFR3RegQueryU16( PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint16_t    *pu16);
+VMMR3DECL(int) DBGFR3RegQueryU32( PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint32_t    *pu32);
+VMMR3DECL(int) DBGFR3RegQueryU64( PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint64_t    *pu64);
+VMMR3DECL(int) DBGFR3RegQueryU128(PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint128_t   *pu128);
+VMMR3DECL(int) DBGFR3RegQueryLrd( PVM pVM, VMCPUID idCpu, DBGFREG enmReg, long double *plrd);
+VMMR3DECL(int) DBGFR3RegQueryXdtr( PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint64_t *pu64Base, uint16_t *pu16Limit);
+
+VMMR3DECL(int) DBGFR3RegSetU8(  PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint8_t     u8);
+VMMR3DECL(int) DBGFR3RegSetU16( PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint16_t    u16);
+VMMR3DECL(int) DBGFR3RegSetU32( PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint32_t    u32);
+VMMR3DECL(int) DBGFR3RegSetU64( PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint64_t    u64);
+VMMR3DECL(int) DBGFR3RegSetU128(PVM pVM, VMCPUID idCpu, DBGFREG enmReg, uint128_t   u128);
+VMMR3DECL(int) DBGFR3RegSetLrd( PVM pVM, VMCPUID idCpu, DBGFREG enmReg, long double lrd);
+
+
+/**
  * Guest OS digger interface identifier.
  *

trunk/include/VBox/err.h

@@ -267 +267 @@
 /** The OS was not detected. */
 #define VINF_DBGF_OS_NOT_DETCTED            1209
+/** Invalid register number. */
+#define VERR_DBGF_INVALID_REGISTER          (-1210)
+/** The value was truncated to fit.
+ * For queries this means that the register is wider than the queried value.
+ * For setters this means that the value is wider than the register. */
+#define VINF_DBGF_TRUNCATED_REGISTER        1211
+/** The value was zero extended to fit.
+ * For queries this means that the register is narrower than the queried value.
+ * For setters this means that the value is narrower than the register. */
+#define VINF_DBGF_ZERO_EXTENDED_REGISTER    1212
 /** @} */