| 1 | /** @file
|
|---|
| 2 | * PDM - Pluggable Device Manager, Core API. (VMM)
|
|---|
| 3 | *
|
|---|
| 4 | * The 'Core API' has been put in a different header because everyone
|
|---|
| 5 | * is currently including pdm.h. So, pdm.h is for including all of the
|
|---|
| 6 | * PDM stuff, while pdmapi.h is for the core stuff.
|
|---|
| 7 | */
|
|---|
| 8 |
|
|---|
| 9 | /*
|
|---|
| 10 | * Copyright (C) 2006-2010 Oracle Corporation
|
|---|
| 11 | *
|
|---|
| 12 | * This file is part of VirtualBox Open Source Edition (OSE), as
|
|---|
| 13 | * available from http://www.virtualbox.org. This file is free software;
|
|---|
| 14 | * you can redistribute it and/or modify it under the terms of the GNU
|
|---|
| 15 | * General Public License (GPL) as published by the Free Software
|
|---|
| 16 | * Foundation, in version 2 as it comes in the "COPYING" file of the
|
|---|
| 17 | * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
|
|---|
| 18 | * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
|
|---|
| 19 | *
|
|---|
| 20 | * The contents of this file may alternatively be used under the terms
|
|---|
| 21 | * of the Common Development and Distribution License Version 1.0
|
|---|
| 22 | * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
|
|---|
| 23 | * VirtualBox OSE distribution, in which case the provisions of the
|
|---|
| 24 | * CDDL are applicable instead of those of the GPL.
|
|---|
| 25 | *
|
|---|
| 26 | * You may elect to license modified versions of this file under the
|
|---|
| 27 | * terms and conditions of either the GPL or the CDDL or both.
|
|---|
| 28 | */
|
|---|
| 29 |
|
|---|
| 30 | #ifndef ___VBox_pdmapi_h
|
|---|
| 31 | #define ___VBox_pdmapi_h
|
|---|
| 32 |
|
|---|
| 33 | #include <VBox/types.h>
|
|---|
| 34 | #include <VBox/sup.h>
|
|---|
| 35 | #include <VBox/pdmcommon.h>
|
|---|
| 36 |
|
|---|
| 37 | RT_C_DECLS_BEGIN
|
|---|
| 38 |
|
|---|
| 39 | /** @defgroup grp_pdm The Pluggable Device Manager API
|
|---|
| 40 | * @{
|
|---|
| 41 | */
|
|---|
| 42 |
|
|---|
| 43 | VMMDECL(int) PDMGetInterrupt(PVMCPU pVCpu, uint8_t *pu8Interrupt);
|
|---|
| 44 | VMMDECL(int) PDMIsaSetIrq(PVM pVM, uint8_t u8Irq, uint8_t u8Level);
|
|---|
| 45 | VMMDECL(int) PDMIoApicSetIrq(PVM pVM, uint8_t u8Irq, uint8_t u8Level);
|
|---|
| 46 | VMMDECL(int) PDMIoApicSendMsi(PVM pVM, RTGCPHYS GCAddr, uint32_t uValue);
|
|---|
| 47 | VMMDECL(bool) PDMHasIoApic(PVM pVM);
|
|---|
| 48 | VMMDECL(int) PDMApicHasPendingIrq(PVM pVM, bool *pfPending);
|
|---|
| 49 | VMMDECL(int) PDMApicSetBase(PVM pVM, uint64_t u64Base);
|
|---|
| 50 | VMMDECL(int) PDMApicGetBase(PVM pVM, uint64_t *pu64Base);
|
|---|
| 51 | VMMDECL(int) PDMApicSetTPR(PVMCPU pVCpu, uint8_t u8TPR);
|
|---|
| 52 | VMMDECL(int) PDMApicGetTPR(PVMCPU pVCpu, uint8_t *pu8TPR, bool *pfPending);
|
|---|
| 53 | VMMDECL(int) PDMApicWriteMSR(PVM pVM, VMCPUID iCpu, uint32_t u32Reg, uint64_t u64Value);
|
|---|
| 54 | VMMDECL(int) PDMApicReadMSR(PVM pVM, VMCPUID iCpu, uint32_t u32Reg, uint64_t *pu64Value);
|
|---|
| 55 | VMMDECL(int) PDMVMMDevHeapR3ToGCPhys(PVM pVM, RTR3PTR pv, RTGCPHYS *pGCPhys);
|
|---|
| 56 | VMMDECL(bool) PDMVMMDevHeapIsEnabled(PVM pVM);
|
|---|
| 57 |
|
|---|
| 58 |
|
|---|
| 59 | /** @defgroup grp_pdm_r3 The PDM Host Context Ring-3 API
|
|---|
| 60 | * @ingroup grp_pdm
|
|---|
| 61 | * @{
|
|---|
| 62 | */
|
|---|
| 63 |
|
|---|
| 64 | VMMR3DECL(int) PDMR3InitUVM(PUVM pUVM);
|
|---|
| 65 | VMMR3DECL(int) PDMR3LdrLoadVMMR0U(PUVM pUVM);
|
|---|
| 66 | VMMR3DECL(int) PDMR3Init(PVM pVM);
|
|---|
| 67 | VMMR3DECL(void) PDMR3PowerOn(PVM pVM);
|
|---|
| 68 | VMMR3DECL(void) PDMR3ResetCpu(PVMCPU pVCpu);
|
|---|
| 69 | VMMR3DECL(void) PDMR3Reset(PVM pVM);
|
|---|
| 70 | VMMR3DECL(void) PDMR3Suspend(PVM pVM);
|
|---|
| 71 | VMMR3DECL(void) PDMR3Resume(PVM pVM);
|
|---|
| 72 | VMMR3DECL(void) PDMR3PowerOff(PVM pVM);
|
|---|
| 73 | VMMR3DECL(void) PDMR3Relocate(PVM pVM, RTGCINTPTR offDelta);
|
|---|
| 74 | VMMR3DECL(int) PDMR3Term(PVM pVM);
|
|---|
| 75 | VMMR3DECL(void) PDMR3TermUVM(PUVM pUVM);
|
|---|
| 76 |
|
|---|
| 77 | /**
|
|---|
| 78 | * Module enumeration callback function.
|
|---|
| 79 | *
|
|---|
| 80 | * @returns VBox status.
|
|---|
| 81 | * Failure will stop the search and return the return code.
|
|---|
| 82 | * Warnings will be ignored and not returned.
|
|---|
| 83 | * @param pVM VM Handle.
|
|---|
| 84 | * @param pszFilename Module filename.
|
|---|
| 85 | * @param pszName Module name. (short and unique)
|
|---|
| 86 | * @param ImageBase Address where to executable image is loaded.
|
|---|
| 87 | * @param cbImage Size of the executable image.
|
|---|
| 88 | * @param fRC Set if raw-mode context, clear if host context.
|
|---|
| 89 | * @param pvArg User argument.
|
|---|
| 90 | */
|
|---|
| 91 | typedef DECLCALLBACK(int) FNPDMR3ENUM(PVM pVM, const char *pszFilename, const char *pszName,
|
|---|
| 92 | RTUINTPTR ImageBase, size_t cbImage, bool fRC, void *pvArg);
|
|---|
| 93 | /** Pointer to a FNPDMR3ENUM() function. */
|
|---|
| 94 | typedef FNPDMR3ENUM *PFNPDMR3ENUM;
|
|---|
| 95 | VMMR3DECL(int) PDMR3LdrEnumModules(PVM pVM, PFNPDMR3ENUM pfnCallback, void *pvArg);
|
|---|
| 96 | VMMR3DECL(void) PDMR3LdrRelocateU(PUVM pUVM, RTGCINTPTR offDelta);
|
|---|
| 97 | VMMR3DECL(int) PDMR3LdrGetSymbolR3(PVM pVM, const char *pszModule, const char *pszSymbol, void **ppvValue);
|
|---|
| 98 | VMMR3DECL(int) PDMR3LdrGetSymbolR0(PVM pVM, const char *pszModule, const char *pszSymbol, PRTR0PTR ppvValue);
|
|---|
| 99 | VMMR3DECL(int) PDMR3LdrGetSymbolR0Lazy(PVM pVM, const char *pszModule, const char *pszSearchPath, const char *pszSymbol, PRTR0PTR ppvValue);
|
|---|
| 100 | VMMR3DECL(int) PDMR3LdrLoadRC(PVM pVM, const char *pszFilename, const char *pszName);
|
|---|
| 101 | VMMR3DECL(int) PDMR3LdrGetSymbolRC(PVM pVM, const char *pszModule, const char *pszSymbol, PRTRCPTR pRCPtrValue);
|
|---|
| 102 | VMMR3DECL(int) PDMR3LdrGetSymbolRCLazy(PVM pVM, const char *pszModule, const char *pszSearchPath, const char *pszSymbol, PRTRCPTR pRCPtrValue);
|
|---|
| 103 | VMMR3DECL(int) PDMR3LdrQueryRCModFromPC(PVM pVM, RTRCPTR uPC,
|
|---|
| 104 | char *pszModName, size_t cchModName, PRTRCPTR pMod,
|
|---|
| 105 | char *pszNearSym1, size_t cchNearSym1, PRTRCPTR pNearSym1,
|
|---|
| 106 | char *pszNearSym2, size_t cchNearSym2, PRTRCPTR pNearSym2);
|
|---|
| 107 | VMMR3DECL(int) PDMR3LdrQueryR0ModFromPC(PVM pVM, RTR0PTR uPC,
|
|---|
| 108 | char *pszModName, size_t cchModName, PRTR0PTR pMod,
|
|---|
| 109 | char *pszNearSym1, size_t cchNearSym1, PRTR0PTR pNearSym1,
|
|---|
| 110 | char *pszNearSym2, size_t cchNearSym2, PRTR0PTR pNearSym2);
|
|---|
| 111 | VMMR3DECL(int) PDMR3LdrGetInterfaceSymbols(PVM pVM,
|
|---|
| 112 | void *pvInterface, size_t cbInterface,
|
|---|
| 113 | const char *pszModule, const char *pszSearchPath,
|
|---|
| 114 | const char *pszSymPrefix, const char *pszSymList,
|
|---|
| 115 | bool fRing0OrRC);
|
|---|
| 116 |
|
|---|
| 117 | VMMR3DECL(int) PDMR3QueryDevice(PVM pVM, const char *pszDevice, unsigned iInstance, PPPDMIBASE ppBase);
|
|---|
| 118 | VMMR3DECL(int) PDMR3QueryDeviceLun(PVM pVM, const char *pszDevice, unsigned iInstance, unsigned iLun, PPPDMIBASE ppBase);
|
|---|
| 119 | VMMR3DECL(int) PDMR3QueryLun(PVM pVM, const char *pszDevice, unsigned iInstance, unsigned iLun, PPPDMIBASE ppBase);
|
|---|
| 120 | VMMR3DECL(int) PDMR3QueryDriverOnLun(PVM pVM, const char *pszDevice, unsigned iInstance, unsigned iLun, const char *pszDriver,
|
|---|
| 121 | PPPDMIBASE ppBase);
|
|---|
| 122 | VMMR3DECL(int) PDMR3DeviceAttach(PVM pVM, const char *pszDevice, unsigned iInstance, unsigned iLun, uint32_t fFlags, PPDMIBASE *ppBase);
|
|---|
| 123 | VMMR3DECL(int) PDMR3DeviceDetach(PVM pVM, const char *pszDevice, unsigned iInstance, unsigned iLun, uint32_t fFlags);
|
|---|
| 124 | VMMR3DECL(int) PDMR3DriverAttach(PVM pVM, const char *pszDevice, unsigned iDevIns, unsigned iLun, uint32_t fFlags, PPPDMIBASE ppBase);
|
|---|
| 125 | VMMR3DECL(int) PDMR3DriverDetach(PVM pVM, const char *pszDevice, unsigned iDevIns, unsigned iLun,
|
|---|
| 126 | const char *pszDriver, unsigned iOccurance, uint32_t fFlags);
|
|---|
| 127 | VMMR3DECL(int) PDMR3DriverReattach(PVM pVM, const char *pszDevice, unsigned iDevIns, unsigned iLun,
|
|---|
| 128 | const char *pszDriver, unsigned iOccurance, uint32_t fFlags, PCFGMNODE pCfg, PPPDMIBASE ppBase);
|
|---|
| 129 | VMMR3DECL(void) PDMR3DmaRun(PVM pVM);
|
|---|
| 130 | VMMR3DECL(int) PDMR3LockCall(PVM pVM);
|
|---|
| 131 | VMMR3DECL(int) PDMR3RegisterVMMDevHeap(PVM pVM, RTGCPHYS GCPhys, RTR3PTR pvHeap, unsigned cbSize);
|
|---|
| 132 | VMMR3DECL(int) PDMR3VMMDevHeapAlloc(PVM pVM, unsigned cbSize, RTR3PTR *ppv);
|
|---|
| 133 | VMMR3DECL(int) PDMR3VMMDevHeapFree(PVM pVM, RTR3PTR pv);
|
|---|
| 134 | VMMR3DECL(int) PDMR3UnregisterVMMDevHeap(PVM pVM, RTGCPHYS GCPhys);
|
|---|
| 135 | /** @} */
|
|---|
| 136 |
|
|---|
| 137 |
|
|---|
| 138 |
|
|---|
| 139 | /** @defgroup grp_pdm_rc The PDM Raw-Mode Context API
|
|---|
| 140 | * @ingroup grp_pdm
|
|---|
| 141 | * @{
|
|---|
| 142 | */
|
|---|
| 143 | /** @} */
|
|---|
| 144 |
|
|---|
| 145 |
|
|---|
| 146 |
|
|---|
| 147 | /** @defgroup grp_pdm_r0 The PDM Ring-0 Context API
|
|---|
| 148 | * @ingroup grp_pdm
|
|---|
| 149 | * @{
|
|---|
| 150 | */
|
|---|
| 151 |
|
|---|
| 152 | /**
|
|---|
| 153 | * Request buffer for PDMR0DriverCallReqHandler / VMMR0_DO_PDM_DRIVER_CALL_REQ_HANDLER.
|
|---|
| 154 | * @see PDMR0DriverCallReqHandler.
|
|---|
| 155 | */
|
|---|
| 156 | typedef struct PDMDRIVERCALLREQHANDLERREQ
|
|---|
| 157 | {
|
|---|
| 158 | /** The header. */
|
|---|
| 159 | SUPVMMR0REQHDR Hdr;
|
|---|
| 160 | /** The driver instance. */
|
|---|
| 161 | PPDMDRVINSR0 pDrvInsR0;
|
|---|
| 162 | /** The operation. */
|
|---|
| 163 | uint32_t uOperation;
|
|---|
| 164 | /** Explicit alignment padding. */
|
|---|
| 165 | uint32_t u32Alignment;
|
|---|
| 166 | /** Optional 64-bit integer argument. */
|
|---|
| 167 | uint64_t u64Arg;
|
|---|
| 168 | } PDMDRIVERCALLREQHANDLERREQ;
|
|---|
| 169 | /** Pointer to a PDMR0DriverCallReqHandler / VMMR0_DO_PDM_DRIVER_CALL_REQ_HANDLER
|
|---|
| 170 | * request buffer. */
|
|---|
| 171 | typedef PDMDRIVERCALLREQHANDLERREQ *PPDMDRIVERCALLREQHANDLERREQ;
|
|---|
| 172 |
|
|---|
| 173 | VMMR0_INT_DECL(int) PDMR0DriverCallReqHandler(PVM pVM, PPDMDRIVERCALLREQHANDLERREQ pReq);
|
|---|
| 174 |
|
|---|
| 175 | /**
|
|---|
| 176 | * Request buffer for PDMR0DeviceCallReqHandler / VMMR0_DO_PDM_DEVICE_CALL_REQ_HANDLER.
|
|---|
| 177 | * @see PDMR0DeviceCallReqHandler.
|
|---|
| 178 | */
|
|---|
| 179 | typedef struct PDMDEVICECALLREQHANDLERREQ
|
|---|
| 180 | {
|
|---|
| 181 | /** The header. */
|
|---|
| 182 | SUPVMMR0REQHDR Hdr;
|
|---|
| 183 | /** The device instance. */
|
|---|
| 184 | PPDMDEVINSR0 pDevInsR0;
|
|---|
| 185 | /** The request handler for the device. */
|
|---|
| 186 | PFNPDMDEVREQHANDLERR0 pfnReqHandlerR0;
|
|---|
| 187 | /** The operation. */
|
|---|
| 188 | uint32_t uOperation;
|
|---|
| 189 | /** Explicit alignment padding. */
|
|---|
| 190 | uint32_t u32Alignment;
|
|---|
| 191 | /** Optional 64-bit integer argument. */
|
|---|
| 192 | uint64_t u64Arg;
|
|---|
| 193 | } PDMDEVICECALLREQHANDLERREQ;
|
|---|
| 194 | /** Pointer to a PDMR0DeviceCallReqHandler /
|
|---|
| 195 | * VMMR0_DO_PDM_DEVICE_CALL_REQ_HANDLER request buffer. */
|
|---|
| 196 | typedef PDMDEVICECALLREQHANDLERREQ *PPDMDEVICECALLREQHANDLERREQ;
|
|---|
| 197 |
|
|---|
| 198 | VMMR0_INT_DECL(int) PDMR0DeviceCallReqHandler(PVM pVM, PPDMDEVICECALLREQHANDLERREQ pReq);
|
|---|
| 199 |
|
|---|
| 200 | /** @} */
|
|---|
| 201 |
|
|---|
| 202 | RT_C_DECLS_END
|
|---|
| 203 |
|
|---|
| 204 | /** @} */
|
|---|
| 205 |
|
|---|
| 206 | #endif
|
|---|
