/* $Id: IOM.cpp 73097 2018-07-12 21:06:33Z vboxsync $ */ /** @file * IOM - Input / Output Monitor. */ /* * Copyright (C) 2006-2017 Oracle Corporation * * 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 (GPL) 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. */ /** @page pg_iom IOM - The Input / Output Monitor * * The input/output monitor will handle I/O exceptions routing them to the * appropriate device. It implements an API to register and deregister virtual * I/0 port handlers and memory mapped I/O handlers. A handler is PDM devices * and a set of callback functions. * * @see grp_iom * * * @section sec_iom_rawmode Raw-Mode * * In raw-mode I/O port access is trapped (\#GP(0)) by ensuring that the actual * IOPL is 0 regardless of what the guest IOPL is. The \#GP handler use the * disassembler (DIS) to figure which instruction caused it (there are a number * of instructions in addition to the I/O ones) and if it's an I/O port access * it will hand it to IOMRCIOPortHandler (via EMInterpretPortIO). * IOMRCIOPortHandler will lookup the port in the AVL tree of registered * handlers. If found, the handler will be called otherwise default action is * taken. (Default action is to write into the void and read all set bits.) * * Memory Mapped I/O (MMIO) is implemented as a slightly special case of PGM * access handlers. An MMIO range is registered with IOM which then registers it * with the PGM access handler sub-system. The access handler catches all * access and will be called in the context of a \#PF handler. In RC and R0 this * handler is iomMmioPfHandler while in ring-3 it's iomR3MmioHandler (although * in ring-3 there can be alternative ways). iomMmioPfHandler will attempt to * emulate the instruction that is doing the access and pass the corresponding * reads / writes to the device. * * Emulating I/O port access is less complex and should be slightly faster than * emulating MMIO, so in most cases we should encourage the OS to use port I/O. * Devices which are frequently accessed should register GC handlers to speed up * execution. * * * @section sec_iom_hm Hardware Assisted Virtualization Mode * * When running in hardware assisted virtualization mode we'll be doing much the * same things as in raw-mode. The main difference is that we're running in the * host ring-0 context and that we don't get faults (\#GP(0) and \#PG) but * exits. * * * @section sec_iom_rem Recompiled Execution Mode * * When running in the recompiler things are different. I/O port access is * handled by calling IOMIOPortRead and IOMIOPortWrite directly. While MMIO can * be handled in one of two ways. The normal way is that we have a registered a * special RAM range with the recompiler and in the three callbacks (for byte, * word and dword access) we call IOMMMIORead and IOMMMIOWrite directly. The * alternative ways that the physical memory access which goes via PGM will take * care of it by calling iomR3MmioHandler via the PGM access handler machinery * - this shouldn't happen but it is an alternative... * * * @section sec_iom_other Other Accesses * * I/O ports aren't really exposed in any other way, unless you count the * instruction interpreter in EM, but that's just what we're doing in the * raw-mode \#GP(0) case really. Now, it's possible to call IOMIOPortRead and * IOMIOPortWrite directly to talk to a device, but this is really bad behavior * and should only be done as temporary hacks (the PC BIOS device used to setup * the CMOS this way back in the dark ages). * * MMIO has similar direct routes as the I/O ports and these shouldn't be used * for the same reasons and with the same restrictions. OTOH since MMIO is * mapped into the physical memory address space, it can be accessed in a number * of ways thru PGM. * * * @section sec_iom_logging Logging Levels * * Following assignments: * - Level 5 is used for defering I/O port and MMIO writes to ring-3. * */ /** @todo MMIO - simplifying the device end. * - Add a return status for doing DBGFSTOP on access where there are no known * registers. * - * * */ /********************************************************************************************************************************* * Header Files * *********************************************************************************************************************************/ #define LOG_GROUP LOG_GROUP_IOM #include #include #include #include #include #include #include #include #include #include #include "IOMInternal.h" #include #include #include #include #include #include #include #include "IOMInline.h" /********************************************************************************************************************************* * Internal Functions * *********************************************************************************************************************************/ static void iomR3FlushCache(PVM pVM); static DECLCALLBACK(int) iomR3RelocateIOPortCallback(PAVLROIOPORTNODECORE pNode, void *pvUser); static DECLCALLBACK(int) iomR3RelocateMMIOCallback(PAVLROGCPHYSNODECORE pNode, void *pvUser); static DECLCALLBACK(void) iomR3IOPortInfo(PVM pVM, PCDBGFINFOHLP pHlp, const char *pszArgs); static DECLCALLBACK(void) iomR3MMIOInfo(PVM pVM, PCDBGFINFOHLP pHlp, const char *pszArgs); static FNIOMIOPORTIN iomR3IOPortDummyIn; static FNIOMIOPORTOUT iomR3IOPortDummyOut; static FNIOMIOPORTINSTRING iomR3IOPortDummyInStr; static FNIOMIOPORTOUTSTRING iomR3IOPortDummyOutStr; #ifdef VBOX_WITH_STATISTICS static const char *iomR3IOPortGetStandardName(RTIOPORT Port); #endif /** * Initializes the IOM. * * @returns VBox status code. * @param pVM The cross context VM structure. */ VMMR3_INT_DECL(int) IOMR3Init(PVM pVM) { LogFlow(("IOMR3Init:\n")); /* * Assert alignment and sizes. */ AssertCompileMemberAlignment(VM, iom.s, 32); AssertCompile(sizeof(pVM->iom.s) <= sizeof(pVM->iom.padding)); AssertCompileMemberAlignment(IOM, CritSect, sizeof(uintptr_t)); /* * Setup any fixed pointers and offsets. */ pVM->iom.s.offVM = RT_UOFFSETOF(VM, iom); /* * Initialize the REM critical section. */ #ifdef IOM_WITH_CRIT_SECT_RW int rc = PDMR3CritSectRwInit(pVM, &pVM->iom.s.CritSect, RT_SRC_POS, "IOM Lock"); #else int rc = PDMR3CritSectInit(pVM, &pVM->iom.s.CritSect, RT_SRC_POS, "IOM Lock"); #endif AssertRCReturn(rc, rc); /* * Allocate the trees structure. */ rc = MMHyperAlloc(pVM, sizeof(*pVM->iom.s.pTreesR3), 0, MM_TAG_IOM, (void **)&pVM->iom.s.pTreesR3); if (RT_SUCCESS(rc)) { pVM->iom.s.pTreesRC = MMHyperR3ToRC(pVM, pVM->iom.s.pTreesR3); pVM->iom.s.pTreesR0 = MMHyperR3ToR0(pVM, pVM->iom.s.pTreesR3); /* * Register the MMIO access handler type. */ rc = PGMR3HandlerPhysicalTypeRegister(pVM, PGMPHYSHANDLERKIND_MMIO, iomMmioHandler, NULL, "iomMmioHandler", "iomMmioPfHandler", NULL, "iomMmioHandler", "iomMmioPfHandler", "MMIO", &pVM->iom.s.hMmioHandlerType); AssertRC(rc); if (RT_SUCCESS(rc)) { /* * Info. */ DBGFR3InfoRegisterInternal(pVM, "ioport", "Dumps all IOPort ranges. No arguments.", &iomR3IOPortInfo); DBGFR3InfoRegisterInternal(pVM, "mmio", "Dumps all MMIO ranges. No arguments.", &iomR3MMIOInfo); /* * Statistics. */ STAM_REG(pVM, &pVM->iom.s.StatRZMMIOHandler, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler", STAMUNIT_TICKS_PER_CALL, "Profiling of the iomMmioPfHandler() body, only success calls."); STAM_REG(pVM, &pVM->iom.s.StatRZMMIO1Byte, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Access1", STAMUNIT_OCCURENCES, "MMIO access by 1 byte counter."); STAM_REG(pVM, &pVM->iom.s.StatRZMMIO2Bytes, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Access2", STAMUNIT_OCCURENCES, "MMIO access by 2 bytes counter."); STAM_REG(pVM, &pVM->iom.s.StatRZMMIO4Bytes, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Access4", STAMUNIT_OCCURENCES, "MMIO access by 4 bytes counter."); STAM_REG(pVM, &pVM->iom.s.StatRZMMIO8Bytes, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Access8", STAMUNIT_OCCURENCES, "MMIO access by 8 bytes counter."); STAM_REG(pVM, &pVM->iom.s.StatRZMMIOFailures, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/MMIOFailures", STAMUNIT_OCCURENCES, "Number of times iomMmioPfHandler() didn't service the request."); STAM_REG(pVM, &pVM->iom.s.StatRZInstMov, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/MOV", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOV instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstCmp, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/CMP", STAMUNIT_TICKS_PER_CALL, "Profiling of the CMP instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstAnd, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/AND", STAMUNIT_TICKS_PER_CALL, "Profiling of the AND instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstOr, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/OR", STAMUNIT_TICKS_PER_CALL, "Profiling of the OR instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstXor, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/XOR", STAMUNIT_TICKS_PER_CALL, "Profiling of the XOR instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstBt, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/BT", STAMUNIT_TICKS_PER_CALL, "Profiling of the BT instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstTest, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/TEST", STAMUNIT_TICKS_PER_CALL, "Profiling of the TEST instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstXchg, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/XCHG", STAMUNIT_TICKS_PER_CALL, "Profiling of the XCHG instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstStos, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/STOS", STAMUNIT_TICKS_PER_CALL, "Profiling of the STOS instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstLods, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/LODS", STAMUNIT_TICKS_PER_CALL, "Profiling of the LODS instruction emulation."); #ifdef IOM_WITH_MOVS_SUPPORT STAM_REG(pVM, &pVM->iom.s.StatRZInstMovs, STAMTYPE_PROFILE_ADV, "/IOM/RZ-MMIOHandler/Inst/MOVS", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOVS instruction emulation."); STAM_REG(pVM, &pVM->iom.s.StatRZInstMovsToMMIO, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/MOVS/ToMMIO", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOVS instruction emulation - Mem2MMIO."); STAM_REG(pVM, &pVM->iom.s.StatRZInstMovsFromMMIO, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/MOVS/FromMMIO", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOVS instruction emulation - MMIO2Mem."); STAM_REG(pVM, &pVM->iom.s.StatRZInstMovsMMIO, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/MOVS/MMIO2MMIO", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOVS instruction emulation - MMIO2MMIO."); #endif STAM_REG(pVM, &pVM->iom.s.StatRZInstOther, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Inst/Other", STAMUNIT_OCCURENCES, "Other instructions counter."); STAM_REG(pVM, &pVM->iom.s.StatR3MMIOHandler, STAMTYPE_COUNTER, "/IOM/R3-MMIOHandler", STAMUNIT_OCCURENCES, "Number of calls to iomR3MmioHandler."); STAM_REG(pVM, &pVM->iom.s.StatInstIn, STAMTYPE_COUNTER, "/IOM/IOWork/In", STAMUNIT_OCCURENCES, "Counter of any IN instructions."); STAM_REG(pVM, &pVM->iom.s.StatInstOut, STAMTYPE_COUNTER, "/IOM/IOWork/Out", STAMUNIT_OCCURENCES, "Counter of any OUT instructions."); STAM_REG(pVM, &pVM->iom.s.StatInstIns, STAMTYPE_COUNTER, "/IOM/IOWork/Ins", STAMUNIT_OCCURENCES, "Counter of any INS instructions."); STAM_REG(pVM, &pVM->iom.s.StatInstOuts, STAMTYPE_COUNTER, "/IOM/IOWork/Outs", STAMUNIT_OCCURENCES, "Counter of any OUTS instructions."); } } /* Redundant, but just in case we change something in the future */ iomR3FlushCache(pVM); LogFlow(("IOMR3Init: returns %Rrc\n", rc)); return rc; } /** * Flushes the IOM port & statistics lookup cache * * @param pVM The cross context VM structure. */ static void iomR3FlushCache(PVM pVM) { /* * Since all relevant (1) cache use requires at least read access to the * critical section, we can exclude all other EMTs by grabbing exclusive * access to the critical section and then safely update the caches of * other EMTs. * (1) The irrelvant access not holding the lock is in assertion code. */ IOM_LOCK_EXCL(pVM); VMCPUID iCpu = pVM->cCpus; while (iCpu-- > 0) { PVMCPU pVCpu = &pVM->aCpus[iCpu]; pVCpu->iom.s.pRangeLastReadR0 = NIL_RTR0PTR; pVCpu->iom.s.pRangeLastWriteR0 = NIL_RTR0PTR; pVCpu->iom.s.pStatsLastReadR0 = NIL_RTR0PTR; pVCpu->iom.s.pStatsLastWriteR0 = NIL_RTR0PTR; pVCpu->iom.s.pMMIORangeLastR0 = NIL_RTR0PTR; pVCpu->iom.s.pMMIOStatsLastR0 = NIL_RTR0PTR; pVCpu->iom.s.pRangeLastReadR3 = NULL; pVCpu->iom.s.pRangeLastWriteR3 = NULL; pVCpu->iom.s.pStatsLastReadR3 = NULL; pVCpu->iom.s.pStatsLastWriteR3 = NULL; pVCpu->iom.s.pMMIORangeLastR3 = NULL; pVCpu->iom.s.pMMIOStatsLastR3 = NULL; pVCpu->iom.s.pRangeLastReadRC = NIL_RTRCPTR; pVCpu->iom.s.pRangeLastWriteRC = NIL_RTRCPTR; pVCpu->iom.s.pStatsLastReadRC = NIL_RTRCPTR; pVCpu->iom.s.pStatsLastWriteRC = NIL_RTRCPTR; pVCpu->iom.s.pMMIORangeLastRC = NIL_RTRCPTR; pVCpu->iom.s.pMMIOStatsLastRC = NIL_RTRCPTR; } IOM_UNLOCK_EXCL(pVM); } /** * The VM is being reset. * * @param pVM The cross context VM structure. */ VMMR3_INT_DECL(void) IOMR3Reset(PVM pVM) { iomR3FlushCache(pVM); } /** * Applies relocations to data and code managed by this * component. This function will be called at init and * whenever the VMM need to relocate it self inside the GC. * * The IOM will update the addresses used by the switcher. * * @param pVM The cross context VM structure. * @param offDelta Relocation delta relative to old location. */ VMMR3_INT_DECL(void) IOMR3Relocate(PVM pVM, RTGCINTPTR offDelta) { LogFlow(("IOMR3Relocate: offDelta=%d\n", offDelta)); /* * Apply relocations to the GC callbacks. */ pVM->iom.s.pTreesRC = MMHyperR3ToRC(pVM, pVM->iom.s.pTreesR3); RTAvlroIOPortDoWithAll(&pVM->iom.s.pTreesR3->IOPortTreeRC, true, iomR3RelocateIOPortCallback, &offDelta); RTAvlroGCPhysDoWithAll(&pVM->iom.s.pTreesR3->MMIOTree, true, iomR3RelocateMMIOCallback, &offDelta); /* * Reset the raw-mode cache (don't bother relocating it). */ VMCPUID iCpu = pVM->cCpus; while (iCpu-- > 0) { PVMCPU pVCpu = &pVM->aCpus[iCpu]; pVCpu->iom.s.pRangeLastReadRC = NIL_RTRCPTR; pVCpu->iom.s.pRangeLastWriteRC = NIL_RTRCPTR; pVCpu->iom.s.pStatsLastReadRC = NIL_RTRCPTR; pVCpu->iom.s.pStatsLastWriteRC = NIL_RTRCPTR; pVCpu->iom.s.pMMIORangeLastRC = NIL_RTRCPTR; pVCpu->iom.s.pMMIOStatsLastRC = NIL_RTRCPTR; } } /** * Callback function for relocating a I/O port range. * * @returns 0 (continue enum) * @param pNode Pointer to a IOMIOPORTRANGERC node. * @param pvUser Pointer to the offDelta. This is a pointer to the delta since we're * not certain the delta will fit in a void pointer for all possible configs. */ static DECLCALLBACK(int) iomR3RelocateIOPortCallback(PAVLROIOPORTNODECORE pNode, void *pvUser) { PIOMIOPORTRANGERC pRange = (PIOMIOPORTRANGERC)pNode; RTGCINTPTR offDelta = *(PRTGCINTPTR)pvUser; Assert(pRange->pDevIns); pRange->pDevIns += offDelta; if (pRange->pfnOutCallback) pRange->pfnOutCallback += offDelta; if (pRange->pfnInCallback) pRange->pfnInCallback += offDelta; if (pRange->pfnOutStrCallback) pRange->pfnOutStrCallback += offDelta; if (pRange->pfnInStrCallback) pRange->pfnInStrCallback += offDelta; if (pRange->pvUser > _64K) pRange->pvUser += offDelta; return 0; } /** * Callback function for relocating a MMIO range. * * @returns 0 (continue enum) * @param pNode Pointer to a IOMMMIORANGE node. * @param pvUser Pointer to the offDelta. This is a pointer to the delta since we're * not certain the delta will fit in a void pointer for all possible configs. */ static DECLCALLBACK(int) iomR3RelocateMMIOCallback(PAVLROGCPHYSNODECORE pNode, void *pvUser) { PIOMMMIORANGE pRange = (PIOMMMIORANGE)pNode; RTGCINTPTR offDelta = *(PRTGCINTPTR)pvUser; if (pRange->pDevInsRC) pRange->pDevInsRC += offDelta; if (pRange->pfnWriteCallbackRC) pRange->pfnWriteCallbackRC += offDelta; if (pRange->pfnReadCallbackRC) pRange->pfnReadCallbackRC += offDelta; if (pRange->pfnFillCallbackRC) pRange->pfnFillCallbackRC += offDelta; if (pRange->pvUserRC > _64K) pRange->pvUserRC += offDelta; return 0; } /** * Terminates the IOM. * * Termination means cleaning up and freeing all resources, * the VM it self is at this point powered off or suspended. * * @returns VBox status code. * @param pVM The cross context VM structure. */ VMMR3_INT_DECL(int) IOMR3Term(PVM pVM) { /* * IOM is not owning anything but automatically freed resources, * so there's nothing to do here. */ NOREF(pVM); return VINF_SUCCESS; } #ifdef VBOX_WITH_STATISTICS /** * Create the statistics node for an I/O port. * * @returns Pointer to new stats node. * * @param pVM The cross context VM structure. * @param Port Port. * @param pszDesc Description. */ static PIOMIOPORTSTATS iomR3IOPortStatsCreate(PVM pVM, RTIOPORT Port, const char *pszDesc) { IOM_LOCK_EXCL(pVM); /* check if it already exists. */ PIOMIOPORTSTATS pPort = (PIOMIOPORTSTATS)RTAvloIOPortGet(&pVM->iom.s.pTreesR3->IOPortStatTree, Port); if (pPort) { IOM_UNLOCK_EXCL(pVM); return pPort; } /* allocate stats node. */ int rc = MMHyperAlloc(pVM, sizeof(*pPort), 0, MM_TAG_IOM_STATS, (void **)&pPort); AssertRC(rc); if (RT_SUCCESS(rc)) { /* insert into the tree. */ pPort->Core.Key = Port; if (RTAvloIOPortInsert(&pVM->iom.s.pTreesR3->IOPortStatTree, &pPort->Core)) { IOM_UNLOCK_EXCL(pVM); /* put a name on common ports. */ if (!pszDesc) pszDesc = iomR3IOPortGetStandardName(Port); /* register the statistics counters. */ rc = STAMR3RegisterF(pVM, &pPort->InR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-In-R3", Port); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pPort->OutR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-Out-R3", Port); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pPort->InRZ, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-In-RZ", Port); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pPort->OutRZ, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-Out-RZ", Port); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pPort->InRZToR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-In-RZtoR3", Port); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pPort->OutRZToR3,STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-Out-RZtoR3", Port); AssertRC(rc); /* Profiling */ rc = STAMR3RegisterF(pVM, &pPort->ProfInR3, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc,"/IOM/Ports/%04x-In-R3/Prof", Port); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pPort->ProfOutR3,STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc,"/IOM/Ports/%04x-Out-R3/Prof", Port); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pPort->ProfInRZ, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc,"/IOM/Ports/%04x-In-RZ/Prof", Port); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pPort->ProfOutRZ,STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc,"/IOM/Ports/%04x-Out-RZ/Prof", Port); AssertRC(rc); return pPort; } AssertMsgFailed(("what! Port=%d\n", Port)); MMHyperFree(pVM, pPort); } IOM_UNLOCK_EXCL(pVM); return NULL; } /** * Create the statistics node for an MMIO address. * * @returns Pointer to new stats node. * * @param pVM The cross context VM structure. * @param GCPhys The address. * @param pszDesc Description. */ PIOMMMIOSTATS iomR3MMIOStatsCreate(PVM pVM, RTGCPHYS GCPhys, const char *pszDesc) { IOM_LOCK_EXCL(pVM); /* check if it already exists. */ PIOMMMIOSTATS pStats = (PIOMMMIOSTATS)RTAvloGCPhysGet(&pVM->iom.s.pTreesR3->MmioStatTree, GCPhys); if (pStats) { IOM_UNLOCK_EXCL(pVM); return pStats; } /* allocate stats node. */ int rc = MMHyperAlloc(pVM, sizeof(*pStats), 0, MM_TAG_IOM_STATS, (void **)&pStats); AssertRC(rc); if (RT_SUCCESS(rc)) { /* insert into the tree. */ pStats->Core.Key = GCPhys; if (RTAvloGCPhysInsert(&pVM->iom.s.pTreesR3->MmioStatTree, &pStats->Core)) { IOM_UNLOCK_EXCL(pVM); rc = STAMR3RegisterF(pVM, &pStats->Accesses, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/MMIO/%RGp", GCPhys); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pStats->ProfReadR3, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc, "/IOM/MMIO/%RGp/Read-R3", GCPhys); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pStats->ProfWriteR3, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc, "/IOM/MMIO/%RGp/Write-R3", GCPhys); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pStats->ProfReadRZ, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc, "/IOM/MMIO/%RGp/Read-RZ", GCPhys); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pStats->ProfWriteRZ, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc, "/IOM/MMIO/%RGp/Write-RZ", GCPhys); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pStats->ReadRZToR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/MMIO/%RGp/Read-RZtoR3", GCPhys); AssertRC(rc); rc = STAMR3RegisterF(pVM, &pStats->WriteRZToR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/MMIO/%RGp/Write-RZtoR3", GCPhys); AssertRC(rc); return pStats; } AssertMsgFailed(("what! GCPhys=%RGp\n", GCPhys)); MMHyperFree(pVM, pStats); } IOM_UNLOCK_EXCL(pVM); return NULL; } #endif /* VBOX_WITH_STATISTICS */ /** * Registers a I/O port ring-3 handler. * * This API is called by PDM on behalf of a device. Devices must first register * ring-3 ranges before any GC and R0 ranges can be registered using IOMR3IOPortRegisterRC() * and IOMR3IOPortRegisterR0(). * * * @returns VBox status code. * * @param pVM The cross context VM structure. * @param pDevIns PDM device instance owning the port range. * @param PortStart First port number in the range. * @param cPorts Number of ports to register. * @param pvUser User argument for the callbacks. * @param pfnOutCallback Pointer to function which is gonna handle OUT operations in R3. * @param pfnInCallback Pointer to function which is gonna handle IN operations in R3. * @param pfnOutStrCallback Pointer to function which is gonna handle string OUT operations in R3. * @param pfnInStrCallback Pointer to function which is gonna handle string IN operations in R3. * @param pszDesc Pointer to description string. This must not be freed. */ VMMR3_INT_DECL(int) IOMR3IOPortRegisterR3(PVM pVM, PPDMDEVINS pDevIns, RTIOPORT PortStart, RTUINT cPorts, RTHCPTR pvUser, R3PTRTYPE(PFNIOMIOPORTOUT) pfnOutCallback, R3PTRTYPE(PFNIOMIOPORTIN) pfnInCallback, R3PTRTYPE(PFNIOMIOPORTOUTSTRING) pfnOutStrCallback, R3PTRTYPE(PFNIOMIOPORTINSTRING) pfnInStrCallback, const char *pszDesc) { LogFlow(("IOMR3IOPortRegisterR3: pDevIns=%p PortStart=%#x cPorts=%#x pvUser=%RHv pfnOutCallback=%#x pfnInCallback=%#x pfnOutStrCallback=%#x pfnInStrCallback=%#x pszDesc=%s\n", pDevIns, PortStart, cPorts, pvUser, pfnOutCallback, pfnInCallback, pfnOutStrCallback, pfnInStrCallback, pszDesc)); /* * Validate input. */ if ( (RTUINT)PortStart + cPorts <= (RTUINT)PortStart || (RTUINT)PortStart + cPorts > 0x10000) { AssertMsgFailed(("Invalid port range %#x-%#x (inclusive)! (%s)\n", PortStart, (RTUINT)PortStart + (cPorts - 1), pszDesc)); return VERR_IOM_INVALID_IOPORT_RANGE; } if (!pfnOutCallback && !pfnInCallback) { AssertMsgFailed(("no handlers specfied for %#x-%#x (inclusive)! (%s)\n", PortStart, (RTUINT)PortStart + (cPorts - 1), pszDesc)); return VERR_INVALID_PARAMETER; } if (!pfnOutCallback) pfnOutCallback = iomR3IOPortDummyOut; if (!pfnInCallback) pfnInCallback = iomR3IOPortDummyIn; if (!pfnOutStrCallback) pfnOutStrCallback = iomR3IOPortDummyOutStr; if (!pfnInStrCallback) pfnInStrCallback = iomR3IOPortDummyInStr; /* Flush the IO port lookup cache */ iomR3FlushCache(pVM); /* * Allocate new range record and initialize it. */ PIOMIOPORTRANGER3 pRange; int rc = MMHyperAlloc(pVM, sizeof(*pRange), 0, MM_TAG_IOM, (void **)&pRange); if (RT_SUCCESS(rc)) { pRange->Core.Key = PortStart; pRange->Core.KeyLast = PortStart + (cPorts - 1); pRange->Port = PortStart; pRange->cPorts = cPorts; pRange->pvUser = pvUser; pRange->pDevIns = pDevIns; pRange->pfnOutCallback = pfnOutCallback; pRange->pfnInCallback = pfnInCallback; pRange->pfnOutStrCallback = pfnOutStrCallback; pRange->pfnInStrCallback = pfnInStrCallback; pRange->pszDesc = pszDesc; /* * Try Insert it. */ IOM_LOCK_EXCL(pVM); if (RTAvlroIOPortInsert(&pVM->iom.s.pTreesR3->IOPortTreeR3, &pRange->Core)) { #ifdef VBOX_WITH_STATISTICS for (unsigned iPort = 0; iPort < cPorts; iPort++) iomR3IOPortStatsCreate(pVM, PortStart + iPort, pszDesc); #endif IOM_UNLOCK_EXCL(pVM); return VINF_SUCCESS; } IOM_UNLOCK_EXCL(pVM); /* conflict. */ DBGFR3Info(pVM->pUVM, "ioport", NULL, NULL); AssertMsgFailed(("Port range %#x-%#x (%s) conflicts with existing range(s)!\n", PortStart, (unsigned)PortStart + cPorts - 1, pszDesc)); MMHyperFree(pVM, pRange); rc = VERR_IOM_IOPORT_RANGE_CONFLICT; } return rc; } /** * Registers a I/O port RC handler. * * This API is called by PDM on behalf of a device. Devices must first register ring-3 ranges * using IOMIOPortRegisterR3() before calling this function. * * * @returns VBox status code. * * @param pVM The cross context VM structure. * @param pDevIns PDM device instance owning the port range. * @param PortStart First port number in the range. * @param cPorts Number of ports to register. * @param pvUser User argument for the callbacks. * @param pfnOutCallback Pointer to function which is gonna handle OUT operations in GC. * @param pfnInCallback Pointer to function which is gonna handle IN operations in GC. * @param pfnOutStrCallback Pointer to function which is gonna handle string OUT operations in GC. * @param pfnInStrCallback Pointer to function which is gonna handle string IN operations in GC. * @param pszDesc Pointer to description string. This must not be freed. */ VMMR3_INT_DECL(int) IOMR3IOPortRegisterRC(PVM pVM, PPDMDEVINS pDevIns, RTIOPORT PortStart, RTUINT cPorts, RTRCPTR pvUser, RCPTRTYPE(PFNIOMIOPORTOUT) pfnOutCallback, RCPTRTYPE(PFNIOMIOPORTIN) pfnInCallback, RCPTRTYPE(PFNIOMIOPORTOUTSTRING) pfnOutStrCallback, RCPTRTYPE(PFNIOMIOPORTINSTRING) pfnInStrCallback, const char *pszDesc) { LogFlow(("IOMR3IOPortRegisterRC: pDevIns=%p PortStart=%#x cPorts=%#x pvUser=%RRv pfnOutCallback=%RRv pfnInCallback=%RRv pfnOutStrCallback=%RRv pfnInStrCallback=%RRv pszDesc=%s\n", pDevIns, PortStart, cPorts, pvUser, pfnOutCallback, pfnInCallback, pfnOutStrCallback, pfnInStrCallback, pszDesc)); AssertReturn(VM_IS_RAW_MODE_ENABLED(pVM), VERR_IOM_HM_IPE); /* * Validate input. */ if ( (RTUINT)PortStart + cPorts <= (RTUINT)PortStart || (RTUINT)PortStart + cPorts > 0x10000) { AssertMsgFailed(("Invalid port range %#x-%#x! (%s)\n", PortStart, (RTUINT)PortStart + (cPorts - 1), pszDesc)); return VERR_IOM_INVALID_IOPORT_RANGE; } RTIOPORT PortLast = PortStart + (cPorts - 1); if (!pfnOutCallback && !pfnInCallback) { AssertMsgFailed(("Invalid port range %#x-%#x! No callbacks! (%s)\n", PortStart, PortLast, pszDesc)); return VERR_INVALID_PARAMETER; } IOM_LOCK_EXCL(pVM); /* * Validate that there are ring-3 ranges for the ports. */ RTIOPORT Port = PortStart; while (Port <= PortLast && Port >= PortStart) { PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)RTAvlroIOPortRangeGet(&pVM->iom.s.CTX_SUFF(pTrees)->IOPortTreeR3, Port); if (!pRange) { AssertMsgFailed(("No R3! Port=%#x %#x-%#x! (%s)\n", Port, PortStart, (unsigned)PortStart + cPorts - 1, pszDesc)); IOM_UNLOCK_EXCL(pVM); return VERR_IOM_NO_R3_IOPORT_RANGE; } #ifndef IOM_NO_PDMINS_CHECKS # ifndef IN_RC if (pRange->pDevIns != pDevIns) # else if (pRange->pDevIns != MMHyperRCToCC(pVM, pDevIns)) # endif { AssertMsgFailed(("Not owner! Port=%#x %#x-%#x! (%s)\n", Port, PortStart, (unsigned)PortStart + cPorts - 1, pszDesc)); IOM_UNLOCK_EXCL(pVM); return VERR_IOM_NOT_IOPORT_RANGE_OWNER; } #endif Port = pRange->Core.KeyLast + 1; } /* Flush the IO port lookup cache */ iomR3FlushCache(pVM); /* * Allocate new range record and initialize it. */ PIOMIOPORTRANGERC pRange; int rc = MMHyperAlloc(pVM, sizeof(*pRange), 0, MM_TAG_IOM, (void **)&pRange); if (RT_SUCCESS(rc)) { pRange->Core.Key = PortStart; pRange->Core.KeyLast = PortLast; pRange->Port = PortStart; pRange->cPorts = cPorts; pRange->pvUser = pvUser; pRange->pfnOutCallback = pfnOutCallback; pRange->pfnInCallback = pfnInCallback; pRange->pfnOutStrCallback = pfnOutStrCallback; pRange->pfnInStrCallback = pfnInStrCallback; pRange->pDevIns = MMHyperCCToRC(pVM, pDevIns); pRange->pszDesc = pszDesc; /* * Insert it. */ if (RTAvlroIOPortInsert(&pVM->iom.s.CTX_SUFF(pTrees)->IOPortTreeRC, &pRange->Core)) { IOM_UNLOCK_EXCL(pVM); return VINF_SUCCESS; } /* conflict. */ AssertMsgFailed(("Port range %#x-%#x (%s) conflicts with existing range(s)!\n", PortStart, (unsigned)PortStart + cPorts - 1, pszDesc)); MMHyperFree(pVM, pRange); rc = VERR_IOM_IOPORT_RANGE_CONFLICT; } IOM_UNLOCK_EXCL(pVM); return rc; } /** * Registers a Port IO R0 handler. * * This API is called by PDM on behalf of a device. Devices must first register ring-3 ranges * using IOMR3IOPortRegisterR3() before calling this function. * * * @returns VBox status code. * * @param pVM The cross context VM structure. * @param pDevIns PDM device instance owning the port range. * @param PortStart First port number in the range. * @param cPorts Number of ports to register. * @param pvUser User argument for the callbacks. * @param pfnOutCallback Pointer to function which is gonna handle OUT operations in GC. * @param pfnInCallback Pointer to function which is gonna handle IN operations in GC. * @param pfnOutStrCallback Pointer to function which is gonna handle OUT operations in GC. * @param pfnInStrCallback Pointer to function which is gonna handle IN operations in GC. * @param pszDesc Pointer to description string. This must not be freed. */ VMMR3_INT_DECL(int) IOMR3IOPortRegisterR0(PVM pVM, PPDMDEVINS pDevIns, RTIOPORT PortStart, RTUINT cPorts, RTR0PTR pvUser, R0PTRTYPE(PFNIOMIOPORTOUT) pfnOutCallback, R0PTRTYPE(PFNIOMIOPORTIN) pfnInCallback, R0PTRTYPE(PFNIOMIOPORTOUTSTRING) pfnOutStrCallback, R0PTRTYPE(PFNIOMIOPORTINSTRING) pfnInStrCallback, const char *pszDesc) { LogFlow(("IOMR3IOPortRegisterR0: pDevIns=%p PortStart=%#x cPorts=%#x pvUser=%RHv pfnOutCallback=%RHv pfnInCallback=%RHv pfnOutStrCallback=%RHv pfnInStrCallback=%RHv pszDesc=%s\n", pDevIns, PortStart, cPorts, pvUser, pfnOutCallback, pfnInCallback, pfnOutStrCallback, pfnInStrCallback, pszDesc)); /* * Validate input. */ if ( (RTUINT)PortStart + cPorts <= (RTUINT)PortStart || (RTUINT)PortStart + cPorts > 0x10000) { AssertMsgFailed(("Invalid port range %#x-%#x! (%s)\n", PortStart, (RTUINT)PortStart + (cPorts - 1), pszDesc)); return VERR_IOM_INVALID_IOPORT_RANGE; } RTIOPORT PortLast = PortStart + (cPorts - 1); if (!pfnOutCallback && !pfnInCallback) { AssertMsgFailed(("Invalid port range %#x-%#x! No callbacks! (%s)\n", PortStart, PortLast, pszDesc)); return VERR_INVALID_PARAMETER; } IOM_LOCK_EXCL(pVM); /* * Validate that there are ring-3 ranges for the ports. */ RTIOPORT Port = PortStart; while (Port <= PortLast && Port >= PortStart) { PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)RTAvlroIOPortRangeGet(&pVM->iom.s.CTX_SUFF(pTrees)->IOPortTreeR3, Port); if (!pRange) { AssertMsgFailed(("No R3! Port=%#x %#x-%#x! (%s)\n", Port, PortStart, (unsigned)PortStart + cPorts - 1, pszDesc)); IOM_UNLOCK_EXCL(pVM); return VERR_IOM_NO_R3_IOPORT_RANGE; } #ifndef IOM_NO_PDMINS_CHECKS # ifndef IN_RC if (pRange->pDevIns != pDevIns) # else if (pRange->pDevIns != MMHyperRCToCC(pVM, pDevIns)) # endif { AssertMsgFailed(("Not owner! Port=%#x %#x-%#x! (%s)\n", Port, PortStart, (unsigned)PortStart + cPorts - 1, pszDesc)); IOM_UNLOCK_EXCL(pVM); return VERR_IOM_NOT_IOPORT_RANGE_OWNER; } #endif Port = pRange->Core.KeyLast + 1; } /* Flush the IO port lookup cache */ iomR3FlushCache(pVM); /* * Allocate new range record and initialize it. */ PIOMIOPORTRANGER0 pRange; int rc = MMHyperAlloc(pVM, sizeof(*pRange), 0, MM_TAG_IOM, (void **)&pRange); if (RT_SUCCESS(rc)) { pRange->Core.Key = PortStart; pRange->Core.KeyLast = PortLast; pRange->Port = PortStart; pRange->cPorts = cPorts; pRange->pvUser = pvUser; pRange->pfnOutCallback = pfnOutCallback; pRange->pfnInCallback = pfnInCallback; pRange->pfnOutStrCallback = pfnOutStrCallback; pRange->pfnInStrCallback = pfnInStrCallback; pRange->pDevIns = MMHyperR3ToR0(pVM, pDevIns); pRange->pszDesc = pszDesc; /* * Insert it. */ if (RTAvlroIOPortInsert(&pVM->iom.s.CTX_SUFF(pTrees)->IOPortTreeR0, &pRange->Core)) { IOM_UNLOCK_EXCL(pVM); return VINF_SUCCESS; } /* conflict. */ AssertMsgFailed(("Port range %#x-%#x (%s) conflicts with existing range(s)!\n", PortStart, (unsigned)PortStart + cPorts - 1, pszDesc)); MMHyperFree(pVM, pRange); rc = VERR_IOM_IOPORT_RANGE_CONFLICT; } IOM_UNLOCK_EXCL(pVM); return rc; } /** * Deregisters a I/O Port range. * * The specified range must be registered using IOMR3IOPortRegister previous to * this call. The range does can be a smaller part of the range specified to * IOMR3IOPortRegister, but it can never be larger. * * This function will remove GC, R0 and R3 context port handlers for this range. * * @returns VBox status code. * * @param pVM The cross context VM structure. * @param pDevIns The device instance associated with the range. * @param PortStart First port number in the range. * @param cPorts Number of ports to remove starting at PortStart. * * @remark This function mainly for PCI PnP Config and will not do * all the checks you might expect it to do. */ VMMR3_INT_DECL(int) IOMR3IOPortDeregister(PVM pVM, PPDMDEVINS pDevIns, RTIOPORT PortStart, RTUINT cPorts) { LogFlow(("IOMR3IOPortDeregister: pDevIns=%p PortStart=%#x cPorts=%#x\n", pDevIns, PortStart, cPorts)); /* * Validate input. */ if ( (RTUINT)PortStart + cPorts < (RTUINT)PortStart || (RTUINT)PortStart + cPorts > 0x10000) { AssertMsgFailed(("Invalid port range %#x-%#x!\n", PortStart, (unsigned)PortStart + cPorts - 1)); return VERR_IOM_INVALID_IOPORT_RANGE; } IOM_LOCK_EXCL(pVM); /* Flush the IO port lookup cache */ iomR3FlushCache(pVM); /* * Check ownership. */ RTIOPORT PortLast = PortStart + (cPorts - 1); RTIOPORT Port = PortStart; while (Port <= PortLast && Port >= PortStart) { PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)RTAvlroIOPortRangeGet(&pVM->iom.s.pTreesR3->IOPortTreeR3, Port); if (pRange) { Assert(Port <= pRange->Core.KeyLast); #ifndef IOM_NO_PDMINS_CHECKS if (pRange->pDevIns != pDevIns) { AssertMsgFailed(("Removal of ports in range %#x-%#x rejected because not owner of %#x-%#x (%s)\n", PortStart, PortLast, pRange->Core.Key, pRange->Core.KeyLast, pRange->pszDesc)); IOM_UNLOCK_EXCL(pVM); return VERR_IOM_NOT_IOPORT_RANGE_OWNER; } #else /* IOM_NO_PDMINS_CHECKS */ RT_NOREF_PV(pDevIns); #endif /* IOM_NO_PDMINS_CHECKS */ Port = pRange->Core.KeyLast; } Port++; } /* * Remove any RC ranges first. */ int rc = VINF_SUCCESS; Port = PortStart; while (Port <= PortLast && Port >= PortStart) { /* * Try find range. */ PIOMIOPORTRANGERC pRange = (PIOMIOPORTRANGERC)RTAvlroIOPortRangeGet(&pVM->iom.s.pTreesR3->IOPortTreeRC, Port); if (pRange) { if ( pRange->Core.Key == Port && pRange->Core.KeyLast <= PortLast) { /* * Kick out the entire range. */ void *pv = RTAvlroIOPortRemove(&pVM->iom.s.pTreesR3->IOPortTreeRC, Port); Assert(pv == (void *)pRange); NOREF(pv); Port += pRange->cPorts; MMHyperFree(pVM, pRange); } else if (pRange->Core.Key == Port) { /* * Cut of the head of the range, done. */ pRange->cPorts -= Port - pRange->Port; pRange->Core.Key = Port; pRange->Port = Port; break; } else if (pRange->Core.KeyLast <= PortLast) { /* * Just cut of the tail. */ unsigned c = pRange->Core.KeyLast - Port + 1; pRange->Core.KeyLast -= c; pRange->cPorts -= c; Port += c; } else { /* * Split the range, done. */ Assert(pRange->Core.KeyLast > PortLast && pRange->Core.Key < Port); /* create tail. */ PIOMIOPORTRANGERC pRangeNew; int rc2 = MMHyperAlloc(pVM, sizeof(*pRangeNew), 0, MM_TAG_IOM, (void **)&pRangeNew); if (RT_FAILURE(rc2)) { IOM_UNLOCK_EXCL(pVM); return rc2; } *pRangeNew = *pRange; pRangeNew->Core.Key = PortLast; pRangeNew->Port = PortLast; pRangeNew->cPorts = pRangeNew->Core.KeyLast - PortLast + 1; LogFlow(("IOMR3IOPortDeregister (rc): split the range; new %x\n", pRangeNew->Core.Key)); /* adjust head */ pRange->Core.KeyLast = Port - 1; pRange->cPorts = Port - pRange->Port; /* insert */ if (!RTAvlroIOPortInsert(&pVM->iom.s.pTreesR3->IOPortTreeRC, &pRangeNew->Core)) { AssertMsgFailed(("This cannot happen!\n")); MMHyperFree(pVM, pRangeNew); rc = VERR_IOM_IOPORT_IPE_1; } break; } } else /* next port */ Port++; } /* for all ports - RC. */ /* * Remove any R0 ranges. */ Port = PortStart; while (Port <= PortLast && Port >= PortStart) { /* * Try find range. */ PIOMIOPORTRANGER0 pRange = (PIOMIOPORTRANGER0)RTAvlroIOPortRangeGet(&pVM->iom.s.pTreesR3->IOPortTreeR0, Port); if (pRange) { if ( pRange->Core.Key == Port && pRange->Core.KeyLast <= PortLast) { /* * Kick out the entire range. */ void *pv = RTAvlroIOPortRemove(&pVM->iom.s.pTreesR3->IOPortTreeR0, Port); Assert(pv == (void *)pRange); NOREF(pv); Port += pRange->cPorts; MMHyperFree(pVM, pRange); } else if (pRange->Core.Key == Port) { /* * Cut of the head of the range, done. */ pRange->cPorts -= Port - pRange->Port; pRange->Core.Key = Port; pRange->Port = Port; break; } else if (pRange->Core.KeyLast <= PortLast) { /* * Just cut of the tail. */ unsigned c = pRange->Core.KeyLast - Port + 1; pRange->Core.KeyLast -= c; pRange->cPorts -= c; Port += c; } else { /* * Split the range, done. */ Assert(pRange->Core.KeyLast > PortLast && pRange->Core.Key < Port); /* create tail. */ PIOMIOPORTRANGER0 pRangeNew; int rc2 = MMHyperAlloc(pVM, sizeof(*pRangeNew), 0, MM_TAG_IOM, (void **)&pRangeNew); if (RT_FAILURE(rc2)) { IOM_UNLOCK_EXCL(pVM); return rc2; } *pRangeNew = *pRange; pRangeNew->Core.Key = PortLast; pRangeNew->Port = PortLast; pRangeNew->cPorts = pRangeNew->Core.KeyLast - PortLast + 1; LogFlow(("IOMR3IOPortDeregister (r0): split the range; new %x\n", pRangeNew->Core.Key)); /* adjust head */ pRange->Core.KeyLast = Port - 1; pRange->cPorts = Port - pRange->Port; /* insert */ if (!RTAvlroIOPortInsert(&pVM->iom.s.pTreesR3->IOPortTreeR0, &pRangeNew->Core)) { AssertMsgFailed(("This cannot happen!\n")); MMHyperFree(pVM, pRangeNew); rc = VERR_IOM_IOPORT_IPE_1; } break; } } else /* next port */ Port++; } /* for all ports - R0. */ /* * And the same procedure for ring-3 ranges. */ Port = PortStart; while (Port <= PortLast && Port >= PortStart) { /* * Try find range. */ PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)RTAvlroIOPortRangeGet(&pVM->iom.s.pTreesR3->IOPortTreeR3, Port); if (pRange) { if ( pRange->Core.Key == Port && pRange->Core.KeyLast <= PortLast) { /* * Kick out the entire range. */ void *pv = RTAvlroIOPortRemove(&pVM->iom.s.pTreesR3->IOPortTreeR3, Port); Assert(pv == (void *)pRange); NOREF(pv); Port += pRange->cPorts; MMHyperFree(pVM, pRange); } else if (pRange->Core.Key == Port) { /* * Cut of the head of the range, done. */ pRange->cPorts -= Port - pRange->Port; pRange->Core.Key = Port; pRange->Port = Port; break; } else if (pRange->Core.KeyLast <= PortLast) { /* * Just cut of the tail. */ unsigned c = pRange->Core.KeyLast - Port + 1; pRange->Core.KeyLast -= c; pRange->cPorts -= c; Port += c; } else { /* * Split the range, done. */ Assert(pRange->Core.KeyLast > PortLast && pRange->Core.Key < Port); /* create tail. */ PIOMIOPORTRANGER3 pRangeNew; int rc2 = MMHyperAlloc(pVM, sizeof(*pRangeNew), 0, MM_TAG_IOM, (void **)&pRangeNew); if (RT_FAILURE(rc2)) { IOM_UNLOCK_EXCL(pVM); return rc2; } *pRangeNew = *pRange; pRangeNew->Core.Key = PortLast; pRangeNew->Port = PortLast; pRangeNew->cPorts = pRangeNew->Core.KeyLast - PortLast + 1; LogFlow(("IOMR3IOPortDeregister (r3): split the range; new %x\n", pRangeNew->Core.Key)); /* adjust head */ pRange->Core.KeyLast = Port - 1; pRange->cPorts = Port - pRange->Port; /* insert */ if (!RTAvlroIOPortInsert(&pVM->iom.s.pTreesR3->IOPortTreeR3, &pRangeNew->Core)) { AssertMsgFailed(("This cannot happen!\n")); MMHyperFree(pVM, pRangeNew); rc = VERR_IOM_IOPORT_IPE_1; } break; } } else /* next port */ Port++; } /* for all ports - ring-3. */ /* done */ IOM_UNLOCK_EXCL(pVM); return rc; } /** * Dummy Port I/O Handler for IN operations. * * @returns VBox status code. * * @param pDevIns The device instance. * @param pvUser User argument. * @param Port Port number used for the IN operation. * @param pu32 Where to store the result. * @param cb Number of bytes read. */ static DECLCALLBACK(int) iomR3IOPortDummyIn(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, uint32_t *pu32, unsigned cb) { NOREF(pDevIns); NOREF(pvUser); NOREF(Port); switch (cb) { case 1: *pu32 = 0xff; break; case 2: *pu32 = 0xffff; break; case 4: *pu32 = UINT32_C(0xffffffff); break; default: AssertReleaseMsgFailed(("cb=%d\n", cb)); return VERR_IOM_IOPORT_IPE_2; } return VINF_SUCCESS; } /** * @callback_method_impl{FNIOMIOPORTINSTRING, * Dummy Port I/O Handler for string IN operations.} */ static DECLCALLBACK(int) iomR3IOPortDummyInStr(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, uint8_t *pbDst, uint32_t *pcTransfer, unsigned cb) { NOREF(pDevIns); NOREF(pvUser); NOREF(Port); NOREF(pbDst); NOREF(pcTransfer); NOREF(cb); return VINF_SUCCESS; } /** * Dummy Port I/O Handler for OUT operations. * * @returns VBox status code. * * @param pDevIns The device instance. * @param pvUser User argument. * @param Port Port number used for the OUT operation. * @param u32 The value to output. * @param cb The value size in bytes. */ static DECLCALLBACK(int) iomR3IOPortDummyOut(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, uint32_t u32, unsigned cb) { NOREF(pDevIns); NOREF(pvUser); NOREF(Port); NOREF(u32); NOREF(cb); return VINF_SUCCESS; } /** * @callback_method_impl{FNIOMIOPORTOUTSTRING, * Dummy Port I/O Handler for string OUT operations.} */ static DECLCALLBACK(int) iomR3IOPortDummyOutStr(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, uint8_t const *pbSrc, uint32_t *pcTransfer, unsigned cb) { NOREF(pDevIns); NOREF(pvUser); NOREF(Port); NOREF(pbSrc); NOREF(pcTransfer); NOREF(cb); return VINF_SUCCESS; } /** * Display a single I/O port ring-3 range. * * @returns 0 * @param pNode Pointer to I/O port HC range. * @param pvUser Pointer to info output callback structure. */ static DECLCALLBACK(int) iomR3IOPortInfoOneR3(PAVLROIOPORTNODECORE pNode, void *pvUser) { PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)pNode; PCDBGFINFOHLP pHlp = (PCDBGFINFOHLP)pvUser; pHlp->pfnPrintf(pHlp, "%04x-%04x %p %p %p %p %s\n", pRange->Core.Key, pRange->Core.KeyLast, pRange->pDevIns, pRange->pfnInCallback, pRange->pfnOutCallback, pRange->pvUser, pRange->pszDesc); return 0; } /** * Display a single I/O port GC range. * * @returns 0 * @param pNode Pointer to IOPORT GC range. * @param pvUser Pointer to info output callback structure. */ static DECLCALLBACK(int) iomR3IOPortInfoOneRC(PAVLROIOPORTNODECORE pNode, void *pvUser) { PIOMIOPORTRANGERC pRange = (PIOMIOPORTRANGERC)pNode; PCDBGFINFOHLP pHlp = (PCDBGFINFOHLP)pvUser; pHlp->pfnPrintf(pHlp, "%04x-%04x %RRv %RRv %RRv %RRv %s\n", pRange->Core.Key, pRange->Core.KeyLast, pRange->pDevIns, pRange->pfnInCallback, pRange->pfnOutCallback, pRange->pvUser, pRange->pszDesc); return 0; } /** * Display all registered I/O port ranges. * * @param pVM The cross context VM structure. * @param pHlp The info helpers. * @param pszArgs Arguments, ignored. */ static DECLCALLBACK(void) iomR3IOPortInfo(PVM pVM, PCDBGFINFOHLP pHlp, const char *pszArgs) { NOREF(pszArgs); pHlp->pfnPrintf(pHlp, "I/O Port R3 ranges (pVM=%p)\n" "Range %.*s %.*s %.*s %.*s Description\n", pVM, sizeof(RTHCPTR) * 2, "pDevIns ", sizeof(RTHCPTR) * 2, "In ", sizeof(RTHCPTR) * 2, "Out ", sizeof(RTHCPTR) * 2, "pvUser "); RTAvlroIOPortDoWithAll(&pVM->iom.s.pTreesR3->IOPortTreeR3, true, iomR3IOPortInfoOneR3, (void *)pHlp); pHlp->pfnPrintf(pHlp, "I/O Port R0 ranges (pVM=%p)\n" "Range %.*s %.*s %.*s %.*s Description\n", pVM, sizeof(RTHCPTR) * 2, "pDevIns ", sizeof(RTHCPTR) * 2, "In ", sizeof(RTHCPTR) * 2, "Out ", sizeof(RTHCPTR) * 2, "pvUser "); RTAvlroIOPortDoWithAll(&pVM->iom.s.pTreesR3->IOPortTreeR0, true, iomR3IOPortInfoOneR3, (void *)pHlp); pHlp->pfnPrintf(pHlp, "I/O Port GC ranges (pVM=%p)\n" "Range %.*s %.*s %.*s %.*s Description\n", pVM, sizeof(RTRCPTR) * 2, "pDevIns ", sizeof(RTRCPTR) * 2, "In ", sizeof(RTRCPTR) * 2, "Out ", sizeof(RTRCPTR) * 2, "pvUser "); RTAvlroIOPortDoWithAll(&pVM->iom.s.pTreesR3->IOPortTreeRC, true, iomR3IOPortInfoOneRC, (void *)pHlp); } /** * Registers a Memory Mapped I/O R3 handler. * * This API is called by PDM on behalf of a device. Devices must register ring-3 ranges * before any GC and R0 ranges can be registered using IOMR3MMIORegisterRC() and IOMR3MMIORegisterR0(). * * @returns VBox status code. * * @param pVM The cross context VM structure. * @param pDevIns PDM device instance owning the MMIO range. * @param GCPhysStart First physical address in the range. * @param cbRange The size of the range (in bytes). * @param pvUser User argument for the callbacks. * @param pfnWriteCallback Pointer to function which is gonna handle Write operations. * @param pfnReadCallback Pointer to function which is gonna handle Read operations. * @param pfnFillCallback Pointer to function which is gonna handle Fill/memset operations. * @param fFlags Flags, see IOMMMIO_FLAGS_XXX. * @param pszDesc Pointer to description string. This must not be freed. */ VMMR3_INT_DECL(int) IOMR3MmioRegisterR3(PVM pVM, PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTGCPHYS cbRange, RTHCPTR pvUser, R3PTRTYPE(PFNIOMMMIOWRITE) pfnWriteCallback, R3PTRTYPE(PFNIOMMMIOREAD) pfnReadCallback, R3PTRTYPE(PFNIOMMMIOFILL) pfnFillCallback, uint32_t fFlags, const char *pszDesc) { LogFlow(("IOMR3MmioRegisterR3: pDevIns=%p GCPhysStart=%RGp cbRange=%RGp pvUser=%RHv pfnWriteCallback=%#x pfnReadCallback=%#x pfnFillCallback=%#x fFlags=%#x pszDesc=%s\n", pDevIns, GCPhysStart, cbRange, pvUser, pfnWriteCallback, pfnReadCallback, pfnFillCallback, fFlags, pszDesc)); int rc; /* * Validate input. */ AssertMsgReturn(GCPhysStart + (cbRange - 1) >= GCPhysStart,("Wrapped! %RGp LB %RGp\n", GCPhysStart, cbRange), VERR_IOM_INVALID_MMIO_RANGE); AssertMsgReturn( !(fFlags & ~IOMMMIO_FLAGS_VALID_MASK) && (fFlags & IOMMMIO_FLAGS_READ_MODE) <= IOMMMIO_FLAGS_READ_DWORD_QWORD && (fFlags & IOMMMIO_FLAGS_WRITE_MODE) <= IOMMMIO_FLAGS_WRITE_ONLY_DWORD_QWORD, ("%#x\n", fFlags), VERR_INVALID_PARAMETER); /* * Allocate new range record and initialize it. */ PIOMMMIORANGE pRange; rc = MMHyperAlloc(pVM, sizeof(*pRange), 0, MM_TAG_IOM, (void **)&pRange); if (RT_SUCCESS(rc)) { pRange->Core.Key = GCPhysStart; pRange->Core.KeyLast = GCPhysStart + (cbRange - 1); pRange->GCPhys = GCPhysStart; pRange->cb = cbRange; pRange->cRefs = 1; /* The tree reference. */ pRange->pszDesc = pszDesc; //pRange->pvUserR0 = NIL_RTR0PTR; //pRange->pDevInsR0 = NIL_RTR0PTR; //pRange->pfnReadCallbackR0 = NIL_RTR0PTR; //pRange->pfnWriteCallbackR0 = NIL_RTR0PTR; //pRange->pfnFillCallbackR0 = NIL_RTR0PTR; //pRange->pvUserRC = NIL_RTRCPTR; //pRange->pDevInsRC = NIL_RTRCPTR; //pRange->pfnReadCallbackRC = NIL_RTRCPTR; //pRange->pfnWriteCallbackRC = NIL_RTRCPTR; //pRange->pfnFillCallbackRC = NIL_RTRCPTR; pRange->fFlags = fFlags; pRange->pvUserR3 = pvUser; pRange->pDevInsR3 = pDevIns; pRange->pfnReadCallbackR3 = pfnReadCallback; pRange->pfnWriteCallbackR3 = pfnWriteCallback; pRange->pfnFillCallbackR3 = pfnFillCallback; /* * Try register it with PGM and then insert it into the tree. */ rc = PGMR3PhysMMIORegister(pVM, GCPhysStart, cbRange, pVM->iom.s.hMmioHandlerType, pRange, MMHyperR3ToR0(pVM, pRange), MMHyperR3ToRC(pVM, pRange), pszDesc); if (RT_SUCCESS(rc)) { IOM_LOCK_EXCL(pVM); if (RTAvlroGCPhysInsert(&pVM->iom.s.pTreesR3->MMIOTree, &pRange->Core)) { iomR3FlushCache(pVM); IOM_UNLOCK_EXCL(pVM); return VINF_SUCCESS; } /* bail out */ IOM_UNLOCK_EXCL(pVM); DBGFR3Info(pVM->pUVM, "mmio", NULL, NULL); AssertMsgFailed(("This cannot happen!\n")); rc = VERR_IOM_IOPORT_IPE_3; } MMHyperFree(pVM, pRange); } if (pDevIns->iInstance > 0) MMR3HeapFree((void *)pszDesc); return rc; } /** * Registers a Memory Mapped I/O RC handler range. * * This API is called by PDM on behalf of a device. Devices must first register ring-3 ranges * using IOMMMIORegisterR3() before calling this function. * * * @returns VBox status code. * * @param pVM The cross context VM structure. * @param pDevIns PDM device instance owning the MMIO range. * @param GCPhysStart First physical address in the range. * @param cbRange The size of the range (in bytes). * @param pvUser User argument for the callbacks. * @param pfnWriteCallback Pointer to function which is gonna handle Write operations. * @param pfnReadCallback Pointer to function which is gonna handle Read operations. * @param pfnFillCallback Pointer to function which is gonna handle Fill/memset operations. * @thread EMT */ VMMR3_INT_DECL(int) IOMR3MmioRegisterRC(PVM pVM, PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTGCPHYS cbRange, RTGCPTR pvUser, RCPTRTYPE(PFNIOMMMIOWRITE) pfnWriteCallback, RCPTRTYPE(PFNIOMMMIOREAD) pfnReadCallback, RCPTRTYPE(PFNIOMMMIOFILL) pfnFillCallback) { LogFlow(("IOMR3MmioRegisterRC: pDevIns=%p GCPhysStart=%RGp cbRange=%RGp pvUser=%RGv pfnWriteCallback=%#x pfnReadCallback=%#x pfnFillCallback=%#x\n", pDevIns, GCPhysStart, cbRange, pvUser, pfnWriteCallback, pfnReadCallback, pfnFillCallback)); AssertReturn(VM_IS_RAW_MODE_ENABLED(pVM), VERR_IOM_HM_IPE); /* * Validate input. */ if (!pfnWriteCallback && !pfnReadCallback) { AssertMsgFailed(("No callbacks! %RGp LB %RGp\n", GCPhysStart, cbRange)); return VERR_INVALID_PARAMETER; } PVMCPU pVCpu = VMMGetCpu(pVM); Assert(pVCpu); /* * Find the MMIO range and check that the input matches. */ IOM_LOCK_EXCL(pVM); PIOMMMIORANGE pRange = iomMmioGetRange(pVM, pVCpu, GCPhysStart); AssertReturnStmt(pRange, IOM_UNLOCK_EXCL(pVM), VERR_IOM_MMIO_RANGE_NOT_FOUND); AssertReturnStmt(pRange->pDevInsR3 == pDevIns, IOM_UNLOCK_EXCL(pVM), VERR_IOM_NOT_MMIO_RANGE_OWNER); AssertReturnStmt(pRange->GCPhys == GCPhysStart, IOM_UNLOCK_EXCL(pVM), VERR_IOM_INVALID_MMIO_RANGE); AssertReturnStmt(pRange->cb == cbRange, IOM_UNLOCK_EXCL(pVM), VERR_IOM_INVALID_MMIO_RANGE); pRange->pvUserRC = pvUser; pRange->pfnReadCallbackRC = pfnReadCallback; pRange->pfnWriteCallbackRC= pfnWriteCallback; pRange->pfnFillCallbackRC = pfnFillCallback; pRange->pDevInsRC = MMHyperCCToRC(pVM, pDevIns); IOM_UNLOCK_EXCL(pVM); return VINF_SUCCESS; } /** * Registers a Memory Mapped I/O R0 handler range. * * This API is called by PDM on behalf of a device. Devices must first register ring-3 ranges * using IOMMR3MIORegisterHC() before calling this function. * * * @returns VBox status code. * * @param pVM The cross context VM structure. * @param pDevIns PDM device instance owning the MMIO range. * @param GCPhysStart First physical address in the range. * @param cbRange The size of the range (in bytes). * @param pvUser User argument for the callbacks. * @param pfnWriteCallback Pointer to function which is gonna handle Write operations. * @param pfnReadCallback Pointer to function which is gonna handle Read operations. * @param pfnFillCallback Pointer to function which is gonna handle Fill/memset operations. * @thread EMT */ VMMR3_INT_DECL(int) IOMR3MmioRegisterR0(PVM pVM, PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTGCPHYS cbRange, RTR0PTR pvUser, R0PTRTYPE(PFNIOMMMIOWRITE) pfnWriteCallback, R0PTRTYPE(PFNIOMMMIOREAD) pfnReadCallback, R0PTRTYPE(PFNIOMMMIOFILL) pfnFillCallback) { LogFlow(("IOMR3MmioRegisterR0: pDevIns=%p GCPhysStart=%RGp cbRange=%RGp pvUser=%RHv pfnWriteCallback=%#x pfnReadCallback=%#x pfnFillCallback=%#x\n", pDevIns, GCPhysStart, cbRange, pvUser, pfnWriteCallback, pfnReadCallback, pfnFillCallback)); /* * Validate input. */ if (!pfnWriteCallback && !pfnReadCallback) { AssertMsgFailed(("No callbacks! %RGp LB %RGp\n", GCPhysStart, cbRange)); return VERR_INVALID_PARAMETER; } PVMCPU pVCpu = VMMGetCpu(pVM); Assert(pVCpu); /* * Find the MMIO range and check that the input matches. */ IOM_LOCK_EXCL(pVM); PIOMMMIORANGE pRange = iomMmioGetRange(pVM, pVCpu, GCPhysStart); AssertReturnStmt(pRange, IOM_UNLOCK_EXCL(pVM), VERR_IOM_MMIO_RANGE_NOT_FOUND); AssertReturnStmt(pRange->pDevInsR3 == pDevIns, IOM_UNLOCK_EXCL(pVM), VERR_IOM_NOT_MMIO_RANGE_OWNER); AssertReturnStmt(pRange->GCPhys == GCPhysStart, IOM_UNLOCK_EXCL(pVM), VERR_IOM_INVALID_MMIO_RANGE); AssertReturnStmt(pRange->cb == cbRange, IOM_UNLOCK_EXCL(pVM), VERR_IOM_INVALID_MMIO_RANGE); pRange->pvUserR0 = pvUser; pRange->pfnReadCallbackR0 = pfnReadCallback; pRange->pfnWriteCallbackR0= pfnWriteCallback; pRange->pfnFillCallbackR0 = pfnFillCallback; pRange->pDevInsR0 = MMHyperCCToR0(pVM, pDevIns); IOM_UNLOCK_EXCL(pVM); return VINF_SUCCESS; } /** * Deregisters a Memory Mapped I/O handler range. * * Registered GC, R0, and R3 ranges are affected. * * @returns VBox status code. * * @param pVM The cross context VM structure. * @param pDevIns Device instance which the MMIO region is registered. * @param GCPhysStart First physical address (GC) in the range. * @param cbRange Number of bytes to deregister. * * @remark This function mainly for PCI PnP Config and will not do * all the checks you might expect it to do. */ VMMR3_INT_DECL(int) IOMR3MmioDeregister(PVM pVM, PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTGCPHYS cbRange) { LogFlow(("IOMR3MmioDeregister: pDevIns=%p GCPhysStart=%RGp cbRange=%RGp\n", pDevIns, GCPhysStart, cbRange)); /* * Validate input. */ RTGCPHYS GCPhysLast = GCPhysStart + (cbRange - 1); if (GCPhysLast < GCPhysStart) { AssertMsgFailed(("Wrapped! %#x LB %RGp\n", GCPhysStart, cbRange)); return VERR_IOM_INVALID_MMIO_RANGE; } PVMCPU pVCpu = VMMGetCpu(pVM); Assert(pVCpu); IOM_LOCK_EXCL(pVM); /* * Check ownership and such for the entire area. */ RTGCPHYS GCPhys = GCPhysStart; while (GCPhys <= GCPhysLast && GCPhys >= GCPhysStart) { PIOMMMIORANGE pRange = iomMmioGetRange(pVM, pVCpu, GCPhys); if (!pRange) { IOM_UNLOCK_EXCL(pVM); return VERR_IOM_MMIO_RANGE_NOT_FOUND; } AssertMsgReturnStmt(pRange->pDevInsR3 == pDevIns, ("Not owner! GCPhys=%RGp %RGp LB %RGp %s\n", GCPhys, GCPhysStart, cbRange, pRange->pszDesc), IOM_UNLOCK_EXCL(pVM), VERR_IOM_NOT_MMIO_RANGE_OWNER); AssertMsgReturnStmt(pRange->Core.KeyLast <= GCPhysLast, ("Incomplete R3 range! GCPhys=%RGp %RGp LB %RGp %s\n", GCPhys, GCPhysStart, cbRange, pRange->pszDesc), IOM_UNLOCK_EXCL(pVM), VERR_IOM_INCOMPLETE_MMIO_RANGE); /* next */ Assert(GCPhys <= pRange->Core.KeyLast); GCPhys = pRange->Core.KeyLast + 1; } /* * Do the actual removing of the MMIO ranges. */ GCPhys = GCPhysStart; while (GCPhys <= GCPhysLast && GCPhys >= GCPhysStart) { iomR3FlushCache(pVM); PIOMMMIORANGE pRange = (PIOMMMIORANGE)RTAvlroGCPhysRemove(&pVM->iom.s.pTreesR3->MMIOTree, GCPhys); Assert(pRange); Assert(pRange->Core.Key == GCPhys && pRange->Core.KeyLast <= GCPhysLast); IOM_UNLOCK_EXCL(pVM); /* Lock order fun. */ /* remove it from PGM */ int rc = PGMR3PhysMMIODeregister(pVM, GCPhys, pRange->cb); AssertRC(rc); IOM_LOCK_EXCL(pVM); /* advance and free. */ GCPhys = pRange->Core.KeyLast + 1; if (pDevIns->iInstance > 0) { void *pvDesc = ASMAtomicXchgPtr((void * volatile *)&pRange->pszDesc, NULL); MMR3HeapFree(pvDesc); } iomMmioReleaseRange(pVM, pRange); } IOM_UNLOCK_EXCL(pVM); return VINF_SUCCESS; } /** * Pre-Registers a MMIO region. * * The rest of of the manipulation of this region goes thru the PGMPhysMMIOEx* * APIs: PGMR3PhysMMIOExMap, PGMR3PhysMMIOExUnmap, PGMR3PhysMMIOExDeregister * * @returns VBox status code. * @param pVM Pointer to the cross context VM structure. * @param pDevIns The device. * @param iSubDev The sub-device number. * @param iRegion The region number. * @param cbRegion The size of the MMIO region. Must be a multiple * of X86_PAGE_SIZE * @param fFlags Flags, see IOMMMIO_FLAGS_XXX. * @param pszDesc Pointer to description string. This must not be * freed. * @param pvUserR3 Ring-3 user pointer. * @param pfnWriteCallbackR3 Callback for handling writes, ring-3. Mandatory. * @param pfnReadCallbackR3 Callback for handling reads, ring-3. Mandatory. * @param pfnFillCallbackR3 Callback for handling fills, ring-3. Optional. * @param pvUserR0 Ring-0 user pointer. * @param pfnWriteCallbackR0 Callback for handling writes, ring-0. Optional. * @param pfnReadCallbackR0 Callback for handling reads, ring-0. Optional. * @param pfnFillCallbackR0 Callback for handling fills, ring-0. Optional. * @param pvUserRC Raw-mode context user pointer. This will be * relocated with the hypervisor guest mapping if * the unsigned integer value is 0x10000 or above. * @param pfnWriteCallbackRC Callback for handling writes, RC. Optional. * @param pfnReadCallbackRC Callback for handling reads, RC. Optional. * @param pfnFillCallbackRC Callback for handling fills, RC. Optional. */ VMMR3_INT_DECL(int) IOMR3MmioExPreRegister(PVM pVM, PPDMDEVINS pDevIns, uint32_t iSubDev, uint32_t iRegion, RTGCPHYS cbRegion, uint32_t fFlags, const char *pszDesc, RTR3PTR pvUserR3, R3PTRTYPE(PFNIOMMMIOWRITE) pfnWriteCallbackR3, R3PTRTYPE(PFNIOMMMIOREAD) pfnReadCallbackR3, R3PTRTYPE(PFNIOMMMIOFILL) pfnFillCallbackR3, RTR0PTR pvUserR0, R0PTRTYPE(PFNIOMMMIOWRITE) pfnWriteCallbackR0, R0PTRTYPE(PFNIOMMMIOREAD) pfnReadCallbackR0, R0PTRTYPE(PFNIOMMMIOFILL) pfnFillCallbackR0, RTRCPTR pvUserRC, RCPTRTYPE(PFNIOMMMIOWRITE) pfnWriteCallbackRC, RCPTRTYPE(PFNIOMMMIOREAD) pfnReadCallbackRC, RCPTRTYPE(PFNIOMMMIOFILL) pfnFillCallbackRC) { LogFlow(("IOMR3MmioExPreRegister: pDevIns=%p iSubDev=%u iRegion=%u cbRegion=%RGp fFlags=%#x pszDesc=%s\n" " pvUserR3=%RHv pfnWriteCallbackR3=%RHv pfnReadCallbackR3=%RHv pfnFillCallbackR3=%RHv\n" " pvUserR0=%RHv pfnWriteCallbackR0=%RHv pfnReadCallbackR0=%RHv pfnFillCallbackR0=%RHv\n" " pvUserRC=%RRv pfnWriteCallbackRC=%RRv pfnReadCallbackRC=%RRv pfnFillCallbackRC=%RRv\n", pDevIns, iSubDev, iRegion, cbRegion, fFlags, pszDesc, pvUserR3, pfnWriteCallbackR3, pfnReadCallbackR3, pfnFillCallbackR3, pvUserR0, pfnWriteCallbackR0, pfnReadCallbackR0, pfnFillCallbackR0, pvUserRC, pfnWriteCallbackRC, pfnReadCallbackRC, pfnFillCallbackRC)); /* * Validate input. */ AssertReturn(cbRegion > 0, VERR_INVALID_PARAMETER); AssertReturn(RT_ALIGN_T(cbRegion, X86_PAGE_SIZE, RTGCPHYS), VERR_INVALID_PARAMETER); AssertMsgReturn( !(fFlags & ~IOMMMIO_FLAGS_VALID_MASK) && (fFlags & IOMMMIO_FLAGS_READ_MODE) <= IOMMMIO_FLAGS_READ_DWORD_QWORD && (fFlags & IOMMMIO_FLAGS_WRITE_MODE) <= IOMMMIO_FLAGS_WRITE_ONLY_DWORD_QWORD, ("%#x\n", fFlags), VERR_INVALID_PARAMETER); AssertPtrReturn(pfnWriteCallbackR3, VERR_INVALID_POINTER); AssertPtrReturn(pfnReadCallbackR3, VERR_INVALID_POINTER); /* * Allocate new range record and initialize it. */ PIOMMMIORANGE pRange; int rc = MMHyperAlloc(pVM, sizeof(*pRange), 0, MM_TAG_IOM, (void **)&pRange); if (RT_SUCCESS(rc)) { pRange->Core.Key = NIL_RTGCPHYS; pRange->Core.KeyLast = NIL_RTGCPHYS; pRange->GCPhys = NIL_RTGCPHYS; pRange->cb = cbRegion; pRange->cRefs = 1; /* The PGM reference. */ pRange->fFlags = fFlags; pRange->pvUserR3 = pvUserR3; pRange->pDevInsR3 = pDevIns; pRange->pfnReadCallbackR3 = pfnReadCallbackR3; pRange->pfnWriteCallbackR3 = pfnWriteCallbackR3; pRange->pfnFillCallbackR3 = pfnFillCallbackR3; pRange->pszDesc = pszDesc; if (pfnReadCallbackR0 || pfnWriteCallbackR0 || pfnFillCallbackR0) { pRange->pvUserR0 = pvUserR0; pRange->pDevInsR0 = MMHyperCCToR0(pVM, pDevIns); pRange->pfnReadCallbackR0 = pfnReadCallbackR0; pRange->pfnWriteCallbackR0 = pfnWriteCallbackR0; pRange->pfnFillCallbackR0 = pfnFillCallbackR0; } if (pfnReadCallbackRC || pfnWriteCallbackRC || pfnFillCallbackRC) { pRange->pvUserRC = pvUserRC; pRange->pDevInsRC = MMHyperCCToRC(pVM, pDevIns); pRange->pfnReadCallbackRC = pfnReadCallbackRC; pRange->pfnWriteCallbackRC = pfnWriteCallbackRC; pRange->pfnFillCallbackRC = pfnFillCallbackRC; } /* * Try register it with PGM. PGM will call us back when it's mapped in * and out of the guest address space, and once it's destroyed. */ rc = PGMR3PhysMMIOExPreRegister(pVM, pDevIns, iSubDev, iRegion, cbRegion, pVM->iom.s.hMmioHandlerType, pRange, MMHyperR3ToR0(pVM, pRange), MMHyperR3ToRC(pVM, pRange), pszDesc); if (RT_SUCCESS(rc)) return VINF_SUCCESS; MMHyperFree(pVM, pRange); } if (pDevIns->iInstance > 0) MMR3HeapFree((void *)pszDesc); return rc; } /** * Notfication from PGM that the pre-registered MMIO region has been mapped into * user address space. * * @returns VBox status code. * @param pVM Pointer to the cross context VM structure. * @param pvUser The pvUserR3 argument of PGMR3PhysMMIOExPreRegister. * @param GCPhys The mapping address. * @remarks Called while owning the PGM lock. */ VMMR3_INT_DECL(int) IOMR3MmioExNotifyMapped(PVM pVM, void *pvUser, RTGCPHYS GCPhys) { PIOMMMIORANGE pRange = (PIOMMMIORANGE)pvUser; AssertReturn(pRange->GCPhys == NIL_RTGCPHYS, VERR_IOM_MMIO_IPE_1); IOM_LOCK_EXCL(pVM); Assert(pRange->GCPhys == NIL_RTGCPHYS); pRange->GCPhys = GCPhys; pRange->Core.Key = GCPhys; pRange->Core.KeyLast = GCPhys + pRange->cb - 1; if (RTAvlroGCPhysInsert(&pVM->iom.s.pTreesR3->MMIOTree, &pRange->Core)) { iomR3FlushCache(pVM); IOM_UNLOCK_EXCL(pVM); return VINF_SUCCESS; } IOM_UNLOCK_EXCL(pVM); AssertLogRelMsgFailed(("RTAvlroGCPhysInsert failed on %RGp..%RGp - %s\n", pRange->Core.Key, pRange->Core.KeyLast, pRange->pszDesc)); pRange->GCPhys = NIL_RTGCPHYS; pRange->Core.Key = NIL_RTGCPHYS; pRange->Core.KeyLast = NIL_RTGCPHYS; return VERR_IOM_MMIO_IPE_2; } /** * Notfication from PGM that the pre-registered MMIO region has been unmapped * from user address space. * * @param pVM Pointer to the cross context VM structure. * @param pvUser The pvUserR3 argument of PGMR3PhysMMIOExPreRegister. * @param GCPhys The mapping address. * @remarks Called while owning the PGM lock. */ VMMR3_INT_DECL(void) IOMR3MmioExNotifyUnmapped(PVM pVM, void *pvUser, RTGCPHYS GCPhys) { PIOMMMIORANGE pRange = (PIOMMMIORANGE)pvUser; AssertLogRelReturnVoid(pRange->GCPhys == GCPhys); IOM_LOCK_EXCL(pVM); Assert(pRange->GCPhys == GCPhys); PIOMMMIORANGE pRemoved = (PIOMMMIORANGE)RTAvlroGCPhysRemove(&pVM->iom.s.pTreesR3->MMIOTree, GCPhys); if (pRemoved == pRange) { pRange->GCPhys = NIL_RTGCPHYS; pRange->Core.Key = NIL_RTGCPHYS; pRange->Core.KeyLast = NIL_RTGCPHYS; iomR3FlushCache(pVM); IOM_UNLOCK_EXCL(pVM); } else { if (pRemoved) RTAvlroGCPhysInsert(&pVM->iom.s.pTreesR3->MMIOTree, &pRemoved->Core); IOM_UNLOCK_EXCL(pVM); AssertLogRelMsgFailed(("RTAvlroGCPhysRemove returned %p instead of %p for %RGp (%s)\n", pRemoved, pRange, GCPhys, pRange->pszDesc)); } } /** * Notfication from PGM that the pre-registered MMIO region has been mapped into * user address space. * * @param pVM Pointer to the cross context VM structure. * @param pvUser The pvUserR3 argument of PGMR3PhysMMIOExPreRegister. * @remarks Called while owning the PGM lock. */ VMMR3_INT_DECL(void) IOMR3MmioExNotifyDeregistered(PVM pVM, void *pvUser) { PIOMMMIORANGE pRange = (PIOMMMIORANGE)pvUser; AssertLogRelReturnVoid(pRange->GCPhys == NIL_RTGCPHYS); iomMmioReleaseRange(pVM, pRange); } /** * Handles the unlikely and probably fatal merge cases. * * @returns Merged status code. * @param rcStrict Current EM status code. * @param rcStrictCommit The IOM I/O or MMIO write commit status to merge * with @a rcStrict. * @param rcIom For logging purposes only. * @param pVCpu The cross context virtual CPU structure of the * calling EMT. For logging purposes. */ DECL_NO_INLINE(static, VBOXSTRICTRC) iomR3MergeStatusSlow(VBOXSTRICTRC rcStrict, VBOXSTRICTRC rcStrictCommit, int rcIom, PVMCPU pVCpu) { if (RT_FAILURE_NP(rcStrict)) return rcStrict; if (RT_FAILURE_NP(rcStrictCommit)) return rcStrictCommit; if (rcStrict == rcStrictCommit) return rcStrictCommit; AssertLogRelMsgFailed(("rcStrictCommit=%Rrc rcStrict=%Rrc IOPort={%#06x<-%#xx/%u} MMIO={%RGp<-%.*Rhxs} (rcIom=%Rrc)\n", VBOXSTRICTRC_VAL(rcStrictCommit), VBOXSTRICTRC_VAL(rcStrict), pVCpu->iom.s.PendingIOPortWrite.IOPort, pVCpu->iom.s.PendingIOPortWrite.u32Value, pVCpu->iom.s.PendingIOPortWrite.cbValue, pVCpu->iom.s.PendingMmioWrite.GCPhys, pVCpu->iom.s.PendingMmioWrite.cbValue, &pVCpu->iom.s.PendingMmioWrite.abValue[0], rcIom)); return VERR_IOM_FF_STATUS_IPE; } /** * Helper for IOMR3ProcessForceFlag. * * @returns Merged status code. * @param rcStrict Current EM status code. * @param rcStrictCommit The IOM I/O or MMIO write commit status to merge * with @a rcStrict. * @param rcIom Either VINF_IOM_R3_IOPORT_COMMIT_WRITE or * VINF_IOM_R3_MMIO_COMMIT_WRITE. * @param pVCpu The cross context virtual CPU structure of the * calling EMT. */ DECLINLINE(VBOXSTRICTRC) iomR3MergeStatus(VBOXSTRICTRC rcStrict, VBOXSTRICTRC rcStrictCommit, int rcIom, PVMCPU pVCpu) { /* Simple. */ if (RT_LIKELY(rcStrict == rcIom || rcStrict == VINF_EM_RAW_TO_R3 || rcStrict == VINF_SUCCESS)) return rcStrictCommit; if (RT_LIKELY(rcStrictCommit == VINF_SUCCESS)) return rcStrict; /* EM scheduling status codes. */ if (RT_LIKELY( rcStrict >= VINF_EM_FIRST && rcStrict <= VINF_EM_LAST)) { if (RT_LIKELY( rcStrictCommit >= VINF_EM_FIRST && rcStrictCommit <= VINF_EM_LAST)) return rcStrict < rcStrictCommit ? rcStrict : rcStrictCommit; } /* Unlikely */ return iomR3MergeStatusSlow(rcStrict, rcStrictCommit, rcIom, pVCpu); } /** * Called by force-flag handling code when VMCPU_FF_IOM is set. * * @returns Merge between @a rcStrict and what the commit operation returned. * @param pVM The cross context VM structure. * @param pVCpu The cross context virtual CPU structure of the calling EMT. * @param rcStrict The status code returned by ring-0 or raw-mode. * @thread EMT(pVCpu) * * @remarks The VMCPU_FF_IOM flag is handled before the status codes by EM, so * we're very likely to see @a rcStrict set to * VINF_IOM_R3_IOPORT_COMMIT_WRITE and VINF_IOM_R3_MMIO_COMMIT_WRITE * here. */ VMMR3_INT_DECL(VBOXSTRICTRC) IOMR3ProcessForceFlag(PVM pVM, PVMCPU pVCpu, VBOXSTRICTRC rcStrict) { VMCPU_FF_CLEAR(pVCpu, VMCPU_FF_IOM); Assert(pVCpu->iom.s.PendingIOPortWrite.cbValue || pVCpu->iom.s.PendingMmioWrite.cbValue); if (pVCpu->iom.s.PendingIOPortWrite.cbValue) { Log5(("IOM: Dispatching pending I/O port write: %#x LB %u -> %RTiop\n", pVCpu->iom.s.PendingIOPortWrite.u32Value, pVCpu->iom.s.PendingIOPortWrite.cbValue, pVCpu->iom.s.PendingIOPortWrite.IOPort)); VBOXSTRICTRC rcStrictCommit = IOMIOPortWrite(pVM, pVCpu, pVCpu->iom.s.PendingIOPortWrite.IOPort, pVCpu->iom.s.PendingIOPortWrite.u32Value, pVCpu->iom.s.PendingIOPortWrite.cbValue); pVCpu->iom.s.PendingIOPortWrite.cbValue = 0; rcStrict = iomR3MergeStatus(rcStrict, rcStrictCommit, VINF_IOM_R3_IOPORT_COMMIT_WRITE, pVCpu); } if (pVCpu->iom.s.PendingMmioWrite.cbValue) { Log5(("IOM: Dispatching pending MMIO write: %RGp LB %#x\n", pVCpu->iom.s.PendingMmioWrite.GCPhys, pVCpu->iom.s.PendingMmioWrite.cbValue)); /** @todo Try optimize this some day? Currently easier and correcter to * involve PGM here since we never know if the MMIO area is still mapped * to the same location as when we wrote to it in RC/R0 context. */ VBOXSTRICTRC rcStrictCommit = PGMPhysWrite(pVM, pVCpu->iom.s.PendingMmioWrite.GCPhys, pVCpu->iom.s.PendingMmioWrite.abValue, pVCpu->iom.s.PendingMmioWrite.cbValue, PGMACCESSORIGIN_IOM); pVCpu->iom.s.PendingMmioWrite.cbValue = 0; rcStrict = iomR3MergeStatus(rcStrict, rcStrictCommit, VINF_IOM_R3_MMIO_COMMIT_WRITE, pVCpu); } return rcStrict; } /** * Notification from DBGF that the number of active I/O port or MMIO * breakpoints has change. * * For performance reasons, IOM will only call DBGF before doing I/O and MMIO * accesses where there are armed breakpoints. * * @param pVM The cross context VM structure. * @param fPortIo True if there are armed I/O port breakpoints. * @param fMmio True if there are armed MMIO breakpoints. */ VMMR3_INT_DECL(void) IOMR3NotifyBreakpointCountChange(PVM pVM, bool fPortIo, bool fMmio) { /** @todo I/O breakpoints. */ RT_NOREF3(pVM, fPortIo, fMmio); } /** * Notification from DBGF that an event has been enabled or disabled. * * For performance reasons, IOM may cache the state of events it implements. * * @param pVM The cross context VM structure. * @param enmEvent The event. * @param fEnabled The new state. */ VMMR3_INT_DECL(void) IOMR3NotifyDebugEventChange(PVM pVM, DBGFEVENT enmEvent, bool fEnabled) { /** @todo IOM debug events. */ RT_NOREF3(pVM, enmEvent, fEnabled); } /** * Display a single MMIO range. * * @returns 0 * @param pNode Pointer to MMIO R3 range. * @param pvUser Pointer to info output callback structure. */ static DECLCALLBACK(int) iomR3MMIOInfoOne(PAVLROGCPHYSNODECORE pNode, void *pvUser) { PIOMMMIORANGE pRange = (PIOMMMIORANGE)pNode; PCDBGFINFOHLP pHlp = (PCDBGFINFOHLP)pvUser; pHlp->pfnPrintf(pHlp, "%RGp-%RGp %RHv %RHv %RHv %RHv %RHv %s\n", pRange->Core.Key, pRange->Core.KeyLast, pRange->pDevInsR3, pRange->pfnReadCallbackR3, pRange->pfnWriteCallbackR3, pRange->pfnFillCallbackR3, pRange->pvUserR3, pRange->pszDesc); pHlp->pfnPrintf(pHlp, "%*s %RHv %RHv %RHv %RHv %RHv\n", sizeof(RTGCPHYS) * 2 * 2 + 1, "R0", pRange->pDevInsR0, pRange->pfnReadCallbackR0, pRange->pfnWriteCallbackR0, pRange->pfnFillCallbackR0, pRange->pvUserR0); pHlp->pfnPrintf(pHlp, "%*s %RRv %RRv %RRv %RRv %RRv\n", sizeof(RTGCPHYS) * 2 * 2 + 1, "RC", pRange->pDevInsRC, pRange->pfnReadCallbackRC, pRange->pfnWriteCallbackRC, pRange->pfnFillCallbackRC, pRange->pvUserRC); return 0; } /** * Display registered MMIO ranges to the log. * * @param pVM The cross context VM structure. * @param pHlp The info helpers. * @param pszArgs Arguments, ignored. */ static DECLCALLBACK(void) iomR3MMIOInfo(PVM pVM, PCDBGFINFOHLP pHlp, const char *pszArgs) { NOREF(pszArgs); pHlp->pfnPrintf(pHlp, "MMIO ranges (pVM=%p)\n" "%.*s %.*s %.*s %.*s %.*s %.*s %s\n", pVM, sizeof(RTGCPHYS) * 4 + 1, "GC Phys Range ", sizeof(RTHCPTR) * 2, "pDevIns ", sizeof(RTHCPTR) * 2, "Read ", sizeof(RTHCPTR) * 2, "Write ", sizeof(RTHCPTR) * 2, "Fill ", sizeof(RTHCPTR) * 2, "pvUser ", "Description"); RTAvlroGCPhysDoWithAll(&pVM->iom.s.pTreesR3->MMIOTree, true, iomR3MMIOInfoOne, (void *)pHlp); } #ifdef VBOX_WITH_STATISTICS /** * Tries to come up with the standard name for a port. * * @returns Pointer to readonly string if known. * @returns NULL if unknown port number. * * @param Port The port to name. */ static const char *iomR3IOPortGetStandardName(RTIOPORT Port) { switch (Port) { case 0x00: case 0x10: case 0x20: case 0x30: case 0x40: case 0x50: case 0x70: case 0x01: case 0x11: case 0x21: case 0x31: case 0x41: case 0x51: case 0x61: case 0x71: case 0x02: case 0x12: case 0x22: case 0x32: case 0x42: case 0x52: case 0x62: case 0x72: case 0x03: case 0x13: case 0x23: case 0x33: case 0x43: case 0x53: case 0x63: case 0x73: case 0x04: case 0x14: case 0x24: case 0x34: case 0x44: case 0x54: case 0x74: case 0x05: case 0x15: case 0x25: case 0x35: case 0x45: case 0x55: case 0x65: case 0x75: case 0x06: case 0x16: case 0x26: case 0x36: case 0x46: case 0x56: case 0x66: case 0x76: case 0x07: case 0x17: case 0x27: case 0x37: case 0x47: case 0x57: case 0x67: case 0x77: case 0x08: case 0x18: case 0x28: case 0x38: case 0x48: case 0x58: case 0x68: case 0x78: case 0x09: case 0x19: case 0x29: case 0x39: case 0x49: case 0x59: case 0x69: case 0x79: case 0x0a: case 0x1a: case 0x2a: case 0x3a: case 0x4a: case 0x5a: case 0x6a: case 0x7a: case 0x0b: case 0x1b: case 0x2b: case 0x3b: case 0x4b: case 0x5b: case 0x6b: case 0x7b: case 0x0c: case 0x1c: case 0x2c: case 0x3c: case 0x4c: case 0x5c: case 0x6c: case 0x7c: case 0x0d: case 0x1d: case 0x2d: case 0x3d: case 0x4d: case 0x5d: case 0x6d: case 0x7d: case 0x0e: case 0x1e: case 0x2e: case 0x3e: case 0x4e: case 0x5e: case 0x6e: case 0x7e: case 0x0f: case 0x1f: case 0x2f: case 0x3f: case 0x4f: case 0x5f: case 0x6f: case 0x7f: case 0x80: case 0x90: case 0xa0: case 0xb0: case 0xc0: case 0xd0: case 0xe0: case 0xf0: case 0x81: case 0x91: case 0xa1: case 0xb1: case 0xc1: case 0xd1: case 0xe1: case 0xf1: case 0x82: case 0x92: case 0xa2: case 0xb2: case 0xc2: case 0xd2: case 0xe2: case 0xf2: case 0x83: case 0x93: case 0xa3: case 0xb3: case 0xc3: case 0xd3: case 0xe3: case 0xf3: case 0x84: case 0x94: case 0xa4: case 0xb4: case 0xc4: case 0xd4: case 0xe4: case 0xf4: case 0x85: case 0x95: case 0xa5: case 0xb5: case 0xc5: case 0xd5: case 0xe5: case 0xf5: case 0x86: case 0x96: case 0xa6: case 0xb6: case 0xc6: case 0xd6: case 0xe6: case 0xf6: case 0x87: case 0x97: case 0xa7: case 0xb7: case 0xc7: case 0xd7: case 0xe7: case 0xf7: case 0x88: case 0x98: case 0xa8: case 0xb8: case 0xc8: case 0xd8: case 0xe8: case 0xf8: case 0x89: case 0x99: case 0xa9: case 0xb9: case 0xc9: case 0xd9: case 0xe9: case 0xf9: case 0x8a: case 0x9a: case 0xaa: case 0xba: case 0xca: case 0xda: case 0xea: case 0xfa: case 0x8b: case 0x9b: case 0xab: case 0xbb: case 0xcb: case 0xdb: case 0xeb: case 0xfb: case 0x8c: case 0x9c: case 0xac: case 0xbc: case 0xcc: case 0xdc: case 0xec: case 0xfc: case 0x8d: case 0x9d: case 0xad: case 0xbd: case 0xcd: case 0xdd: case 0xed: case 0xfd: case 0x8e: case 0x9e: case 0xae: case 0xbe: case 0xce: case 0xde: case 0xee: case 0xfe: case 0x8f: case 0x9f: case 0xaf: case 0xbf: case 0xcf: case 0xdf: case 0xef: case 0xff: return "System Reserved"; case 0x60: case 0x64: return "Keyboard & Mouse"; case 0x378: case 0x379: case 0x37a: case 0x37b: case 0x37c: case 0x37d: case 0x37e: case 0x37f: case 0x3bc: case 0x3bd: case 0x3be: case 0x3bf: case 0x278: case 0x279: case 0x27a: case 0x27b: case 0x27c: case 0x27d: case 0x27e: case 0x27f: return "LPT1/2/3"; case 0x3f8: case 0x3f9: case 0x3fa: case 0x3fb: case 0x3fc: case 0x3fd: case 0x3fe: case 0x3ff: return "COM1"; case 0x2f8: case 0x2f9: case 0x2fa: case 0x2fb: case 0x2fc: case 0x2fd: case 0x2fe: case 0x2ff: return "COM2"; case 0x3e8: case 0x3e9: case 0x3ea: case 0x3eb: case 0x3ec: case 0x3ed: case 0x3ee: case 0x3ef: return "COM3"; case 0x2e8: case 0x2e9: case 0x2ea: case 0x2eb: case 0x2ec: case 0x2ed: case 0x2ee: case 0x2ef: return "COM4"; case 0x200: case 0x201: case 0x202: case 0x203: case 0x204: case 0x205: case 0x206: case 0x207: return "Joystick"; case 0x3f0: case 0x3f1: case 0x3f2: case 0x3f3: case 0x3f4: case 0x3f5: case 0x3f6: case 0x3f7: return "Floppy"; case 0x1f0: case 0x1f1: case 0x1f2: case 0x1f3: case 0x1f4: case 0x1f5: case 0x1f6: case 0x1f7: //case 0x3f6: //case 0x3f7: return "IDE 1st"; case 0x170: case 0x171: case 0x172: case 0x173: case 0x174: case 0x175: case 0x176: case 0x177: case 0x376: case 0x377: return "IDE 2nd"; case 0x1e0: case 0x1e1: case 0x1e2: case 0x1e3: case 0x1e4: case 0x1e5: case 0x1e6: case 0x1e7: case 0x3e6: case 0x3e7: return "IDE 3rd"; case 0x160: case 0x161: case 0x162: case 0x163: case 0x164: case 0x165: case 0x166: case 0x167: case 0x366: case 0x367: return "IDE 4th"; case 0x130: case 0x140: case 0x150: case 0x131: case 0x141: case 0x151: case 0x132: case 0x142: case 0x152: case 0x133: case 0x143: case 0x153: case 0x134: case 0x144: case 0x154: case 0x135: case 0x145: case 0x155: case 0x136: case 0x146: case 0x156: case 0x137: case 0x147: case 0x157: case 0x138: case 0x148: case 0x158: case 0x139: case 0x149: case 0x159: case 0x13a: case 0x14a: case 0x15a: case 0x13b: case 0x14b: case 0x15b: case 0x13c: case 0x14c: case 0x15c: case 0x13d: case 0x14d: case 0x15d: case 0x13e: case 0x14e: case 0x15e: case 0x13f: case 0x14f: case 0x15f: case 0x220: case 0x230: case 0x221: case 0x231: case 0x222: case 0x232: case 0x223: case 0x233: case 0x224: case 0x234: case 0x225: case 0x235: case 0x226: case 0x236: case 0x227: case 0x237: case 0x228: case 0x238: case 0x229: case 0x239: case 0x22a: case 0x23a: case 0x22b: case 0x23b: case 0x22c: case 0x23c: case 0x22d: case 0x23d: case 0x22e: case 0x23e: case 0x22f: case 0x23f: case 0x330: case 0x340: case 0x350: case 0x331: case 0x341: case 0x351: case 0x332: case 0x342: case 0x352: case 0x333: case 0x343: case 0x353: case 0x334: case 0x344: case 0x354: case 0x335: case 0x345: case 0x355: case 0x336: case 0x346: case 0x356: case 0x337: case 0x347: case 0x357: case 0x338: case 0x348: case 0x358: case 0x339: case 0x349: case 0x359: case 0x33a: case 0x34a: case 0x35a: case 0x33b: case 0x34b: case 0x35b: case 0x33c: case 0x34c: case 0x35c: case 0x33d: case 0x34d: case 0x35d: case 0x33e: case 0x34e: case 0x35e: case 0x33f: case 0x34f: case 0x35f: return "SCSI (typically)"; case 0x320: case 0x321: case 0x322: case 0x323: case 0x324: case 0x325: case 0x326: case 0x327: return "XT HD"; case 0x3b0: case 0x3b1: case 0x3b2: case 0x3b3: case 0x3b4: case 0x3b5: case 0x3b6: case 0x3b7: case 0x3b8: case 0x3b9: case 0x3ba: case 0x3bb: return "VGA"; case 0x3c0: case 0x3d0: case 0x3c1: case 0x3d1: case 0x3c2: case 0x3d2: case 0x3c3: case 0x3d3: case 0x3c4: case 0x3d4: case 0x3c5: case 0x3d5: case 0x3c6: case 0x3d6: case 0x3c7: case 0x3d7: case 0x3c8: case 0x3d8: case 0x3c9: case 0x3d9: case 0x3ca: case 0x3da: case 0x3cb: case 0x3db: case 0x3cc: case 0x3dc: case 0x3cd: case 0x3dd: case 0x3ce: case 0x3de: case 0x3cf: case 0x3df: return "VGA/EGA"; case 0x240: case 0x260: case 0x280: case 0x241: case 0x261: case 0x281: case 0x242: case 0x262: case 0x282: case 0x243: case 0x263: case 0x283: case 0x244: case 0x264: case 0x284: case 0x245: case 0x265: case 0x285: case 0x246: case 0x266: case 0x286: case 0x247: case 0x267: case 0x287: case 0x248: case 0x268: case 0x288: case 0x249: case 0x269: case 0x289: case 0x24a: case 0x26a: case 0x28a: case 0x24b: case 0x26b: case 0x28b: case 0x24c: case 0x26c: case 0x28c: case 0x24d: case 0x26d: case 0x28d: case 0x24e: case 0x26e: case 0x28e: case 0x24f: case 0x26f: case 0x28f: case 0x300: case 0x301: case 0x388: case 0x389: case 0x38a: case 0x38b: return "Sound Card (typically)"; default: return NULL; } } #endif /* VBOX_WITH_STATISTICS */