; $Id: PATMA.mac 742 2007-02-07 10:17:01Z vboxsync $
;; @file
; PATM macros & definitions (identical to PATMA.h!!)
;

;
; Copyright (C) 2006 InnoTek Systemberatung GmbH
;
; This file is part of VirtualBox Open Source Edition (OSE), as
; available from http://www.virtualbox.org. This file is free software;
; you can redistribute it and/or modify it under the terms of the GNU
; General Public License as published by the Free Software Foundation,
; in version 2 as it comes in the "COPYING" file of the VirtualBox OSE
; distribution. VirtualBox OSE is distributed in the hope that it will
; be useful, but WITHOUT ANY WARRANTY of any kind.
;
; If you received this file as part of a commercial VirtualBox
; distribution, then only the terms of your commercial VirtualBox
; license agreement apply instead of the previous paragraph.
;

; hardcoded dependency on single byte int 3
%define PATM_INT3            int3

%define PATM_VMFLAGS         0xF1ABCD00
%ifdef VBOX_WITH_STATISTICS
%define PATM_ALLPATCHCALLS   0xF1ABCD01
%define PATM_PERPATCHCALLS   0xF1ABCD02
%endif
%define PATM_JUMPDELTA       0xF1ABCD03
%ifdef VBOX_WITH_STATISTICS
%define PATM_IRETEFLAGS      0xF1ABCD04
%define PATM_IRETCS          0xF1ABCD05
%define PATM_IRETEIP         0xF1ABCD06
%endif
%define PATM_FIXUP           0xF1ABCD07
%define PATM_PENDINGACTION   0xF1ABCD08
%define PATM_CPUID_STD_PTR   0xF1ABCD09
%define PATM_CPUID_EXT_PTR   0xF1ABCD0a
%define PATM_CPUID_DEF_PTR   0xF1ABCD0b
%define PATM_STACKBASE       0xF1ABCD0c    ;/** Stack to store our private patch return addesses */
%define PATM_STACKBASE_GUEST 0xF1ABCD0d    ;/** Stack to store guest return addresses */
%define PATM_STACKPTR        0xF1ABCD0e
%define PATM_PATCHBASE       0xF1ABCD0f
%define PATM_INTERRUPTFLAG   0xF1ABCD10
%define PATM_INHIBITIRQADDR  0xF1ABCD11
%define PATM_VM_FORCEDACTIONS  0xF1ABCD12
%define PATM_TEMP_EAX                           0xF1ABCD13      ;/** Location for original EAX register */
%define PATM_TEMP_ECX                           0xF1ABCD14      ;/** Location for original ECX register */
%define PATM_TEMP_EDI                           0xF1ABCD15      ;/** Location for original EDI register */
%define PATM_TEMP_EFLAGS                        0xF1ABCD16      ;/** Location for original eflags */
%define PATM_TEMP_RESTORE_FLAGS                 0xF1ABCD17      ;/** Which registers to restore */
%define PATM_CALL_PATCH_TARGET_ADDR             0xF1ABCD18
%define PATM_CALL_RETURN_ADDR                   0xF1ABCD19

;/* Anything larger doesn't require a fixup */
%define PATM_NO_FIXUP        0xF1ABCE00
%define PATM_CPUID_STD_MAX   0xF1ABCE00
%define PATM_CPUID_EXT_MAX   0xF1ABCE01
%define PATM_RETURNADDR      0xF1ABCE02
%define PATM_PATCHNEXTBLOCK  0xF1ABCE03
%define PATM_CALLTARGET      0xF1ABCE04    ; /* relative */
%define PATM_NEXTINSTRADDR   0xF1ABCE05    ; /* absolute guest address of the next instruction */
%define PATM_CURINSTRADDR    0xF1ABCE06    ; /* absolute guest address of the current instruction */
%define PATM_LOOKUP_AND_CALL_FUNCTION           0xF1ABCE07   ; /** Relative address of global PATM lookup and call function. */
%define PATM_RETURN_FUNCTION                    0xF1ABCE08   ; /** Relative address of global PATM return function. */
%define PATM_LOOKUP_AND_JUMP_FUNCTION           0xF1ABCE09   ; /** Relative address of global PATM lookup and jump function. */
%define PATM_IRET_FUNCTION                      0xF1ABCE0A   ; /** Relative address of global PATM iret function. */


; everything except IOPL, NT, IF, VM, VIF, VIP and RF
%define PATM_FLAGS_MASK      (X86_EFL_CF|X86_EFL_PF|X86_EFL_AF|X86_EFL_ZF|X86_EFL_SF|X86_EFL_TF|X86_EFL_DF|X86_EFL_OF|X86_EFL_AC|X86_EFL_ID)

; currently only IF & IOPL
%define PATM_VIRTUAL_FLAGS_MASK (X86_EFL_IF|X86_EFL_IOPL)

; PATM stack size (identical in PATMA.mac!!)
%define PATM_STACK_SIZE                    (4096)
%define PATM_STACK_TOTAL_SIZE              (2*PATM_STACK_SIZE)

;/* Patch Manager pending actions (in GCSTATE). */
%define PATM_ACTION_LOOKUP_ADDRESS              1
%define PATM_ACTION_DISPATCH_PENDING_IRQ        2
%define PATM_ACTION_PENDING_IRQ_AFTER_IRET      3
%define PATM_ACTION_LOG_IF1                     4
%define PATM_ACTION_LOG_CLI                     5
%define PATM_ACTION_LOG_STI                     6
%define PATM_ACTION_LOG_POPF_IF1                7
%define PATM_ACTION_LOG_POPF_IF0                8
%define PATM_ACTION_LOG_PUSHF                   9
%define PATM_ACTION_LOG_IRET                    10
%define PATM_ACTION_LOG_RET                     11
%define PATM_ACTION_LOG_CALL                    12

;/* Magic dword found in ecx for patm pending actions. */
%define PATM_ACTION_MAGIC          0xABCD4321

%define PATM_RESTORE_EAX                        BIT(0)
%define PATM_RESTORE_ECX                        BIT(1)
%define PATM_RESTORE_EDI                        BIT(2)


;/* For indirect calls/jump (identical in PATMA.h & PATMA.mac!) */
%define PATM_MAX_JUMPTABLE_ENTRIES        16

struc PATCHJUMPTABLE
    .nrSlots         resw    1
    .ulInsertPos     resw    1
    .cAddresses      resd    1
    ; array of pInstrGC and pRelPatchGC pairs (nrSlot times)
    .Slot_pInstrGC   resd    1
    .Slot_pRelPatchGC resd   1
endstruc

;/* Must match structure size!!
%define PATCHJUMPTABLE_SIZE    (PATM_MAX_JUMPTABLE_ENTRIES*2*4)
;/* Direct calls need only one lookup slot */
%define PATCHDIRECTJUMPTABLE_SIZE (2*4)