TRPMInternal.h revision 806e576dde72d3c00c37226d6142ac520d91779e
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * TRPM - Internal header file.
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync * Copyright (C) 2006-2007 Sun Microsystems, Inc.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * available from http://www.virtualbox.org. This file is free software;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * you can redistribute it and/or modify it under the terms of the GNU
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * General Public License (GPL) as published by the Free Software
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * additional information or have any questions.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#if !defined(IN_TRPM_R3) && !defined(IN_TRPM_R0) && !defined(IN_TRPM_GC)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/* Enable to allow trap forwarding in GC. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** First interrupt handler. Used for validating input. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** @defgroup grp_trpm_int Internals
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @ingroup grp_trpm
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @internal
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** @name TRPMGCTrapIn* flags.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * The lower bits are offsets into the CPUMCTXCORE structure.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** The mask for the operation. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** Traps on MOV GS, eax. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** Traps on MOV FS, eax. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** Traps on MOV ES, eax. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** Traps on MOV DS, eax. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** Traps on IRET. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** Set if this is a V86 resume. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** If set this is a hypervisor register set. If cleared it's a guest set. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Converts a TRPM pointer into a VM pointer.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns Pointer to the VM structure the TRPM is part of.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param pTRPM Pointer to TRPM instance data.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#define TRPM2VM(pTRPM) ( (PVM)((char*)pTRPM - pTRPM->offVM) )
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * TRPM Data (part of VM)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * IMPORTANT! Keep the nasm version of this struct up-to-date.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsynctypedef struct TRPM
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** Offset to the VM structure.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * See TRPM2VM(). */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** Active Interrupt or trap vector number.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * If not ~0U this indicates that we're currently processing
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * a interrupt, trap, fault, abort, whatever which have arrived
9d4498106267e3834edc3a37bca5ca660153525cvboxsync * at that vector number.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** Active trap type. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** Errorcode for the active interrupt/trap. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** CR2 at the time of the active exception. */
5d69af51557e9e9db029ecd243e820383af49b18vboxsync /** Saved trap vector number. */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync /** Saved trap type. */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync /** Saved errorcode. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** Saved cr2. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** Previous trap vector # - for debugging. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** IDT monitoring and sync flag (HWACC). */
5d69af51557e9e9db029ecd243e820383af49b18vboxsync bool fDisableMonitoring; /** @todo r=bird: bool and 7 byte achPadding1. */
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync /** Whether monitoring of the guest IDT is enabled or not.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This configuration option is provided for speeding up guest like Solaris
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * that put the IDT on the same page as a whole lot of other data that is
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * freqently updated. The updates will cause #PFs and have to be interpreted
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * by PGMInterpretInstruction which is slow compared to raw execution.
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync * If the guest is well behaved and doesn't change the IDT after loading it,
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync * there is no problem with dropping the IDT monitoring.
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync * @cfgm /TRPM/SafeToDropGuestIDTMonitoring boolean defaults to false.
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync /** Padding to get the IDTs at a 16 byte alignement. */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync /** IDTs. Aligned at 16 byte offset for speed. */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync /** Bitmap for IDTEs that contain PATM handlers. (needed for relocation) */
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync /** Temporary Hypervisor trap handlers.
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync * NULL means default action. */
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync /** GC Pointer to the IDT shadow area (aIdt) placed in Hypervisor memory arena. */
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync /** Current (last) Guest's IDTR. */
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync /** padding. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** Checked trap & interrupt handler array */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** GC: The number of times writes to the Guest IDT were detected. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /** HC: Profiling of the TRPMR3SyncIDT() method. */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync /** GC: Statistics for the trap handlers. */
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync STAMCOUNTER StatTrap0dRdTsc; /**< Number of RDTSC #GPs. */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync /* R3: Statistics for interrupt handlers (allocated on the hypervisor heap). */
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync /* R0: Statistics for interrupt handlers (allocated on the hypervisor heap). */
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync /* GC: Statistics for interrupt handlers (allocated on the hypervisor heap). */
468c2bcb36eb9a032f5dd0fcb34db10bd58e9996vboxsync/** Pointer to TRPM Data. */
5d69af51557e9e9db029ecd243e820383af49b18vboxsyncTRPMGCDECL(int) trpmgcGuestIDTWriteHandler(PVM pVM, RTGCUINT uErrorCode, PCPUMCTXCORE pRegFrame, void *pvFault, void *pvRange, uintptr_t offRange);
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsyncTRPMGCDECL(int) trpmgcShadowIDTWriteHandler(PVM pVM, RTGCUINT uErrorCode, PCPUMCTXCORE pRegFrame, void *pvFault, void *pvRange, uintptr_t offRange);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync * Clear guest trap/interrupt gate handler
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param pVM The VM to operate on.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param iTrap Interrupt/trap number.
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsyncTRPMDECL(int) trpmClearGuestTrapHandler(PVM pVM, unsigned iTrap);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Clear passthrough interrupt gate handler (reset to default handler)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
5d69af51557e9e9db029ecd243e820383af49b18vboxsync * @param pVM The VM to operate on.
5d69af51557e9e9db029ecd243e820383af49b18vboxsync * @param iTrap Trap/interrupt gate number.
5d69af51557e9e9db029ecd243e820383af49b18vboxsyncTRPMR3DECL(int) trpmR3ClearPassThroughHandler(PVM pVM, unsigned iTrap);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync * Calls the interrupt gate as if we received an interrupt while in Ring-0.
5d69af51557e9e9db029ecd243e820383af49b18vboxsync * @param uIP The interrupt gate IP.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param SelCS The interrupt gate CS.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param RSP The interrupt gate RSP. ~0 if no stack switch should take place. (only AMD64)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncDECLASM(void) trpmR0DispatchHostInterrupt(RTR0UINTPTR uIP, RTSEL SelCS, RTR0UINTPTR RSP);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * Issues a software interrupt to the specified interrupt vector.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * @param uActiveVector The vector number.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsyncDECLASM(void) trpmR0DispatchHostInterruptSimple(RTUINT uActiveVector);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * Code used for the dispatching of interrupts in HC.
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync * @internal
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync# endif /* VBOX_WITH_IDT_PATCHING */