1 | /* $Id: PDMDriver.cpp 90784 2021-08-23 09:42:32Z vboxsync $ */
|
---|
2 | /** @file
|
---|
3 | * PDM - Pluggable Device and Driver Manager, Driver parts.
|
---|
4 | */
|
---|
5 |
|
---|
6 | /*
|
---|
7 | * Copyright (C) 2006-2020 Oracle Corporation
|
---|
8 | *
|
---|
9 | * This file is part of VirtualBox Open Source Edition (OSE), as
|
---|
10 | * available from http://www.virtualbox.org. This file is free software;
|
---|
11 | * you can redistribute it and/or modify it under the terms of the GNU
|
---|
12 | * General Public License (GPL) as published by the Free Software
|
---|
13 | * Foundation, in version 2 as it comes in the "COPYING" file of the
|
---|
14 | * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
|
---|
15 | * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
|
---|
16 | */
|
---|
17 |
|
---|
18 |
|
---|
19 | /*********************************************************************************************************************************
|
---|
20 | * Header Files *
|
---|
21 | *********************************************************************************************************************************/
|
---|
22 | #define LOG_GROUP LOG_GROUP_PDM_DRIVER
|
---|
23 | #include "PDMInternal.h"
|
---|
24 | #include <VBox/vmm/pdm.h>
|
---|
25 | #include <VBox/vmm/mm.h>
|
---|
26 | #include <VBox/vmm/cfgm.h>
|
---|
27 | #include <VBox/vmm/hm.h>
|
---|
28 | #include <VBox/vmm/vmm.h>
|
---|
29 | #include <VBox/sup.h>
|
---|
30 | #include <VBox/vmm/vmcc.h>
|
---|
31 |
|
---|
32 | #include <VBox/version.h>
|
---|
33 | #include <VBox/err.h>
|
---|
34 |
|
---|
35 | #include <VBox/log.h>
|
---|
36 | #include <iprt/assert.h>
|
---|
37 | #include <iprt/asm.h>
|
---|
38 | #include <iprt/ctype.h>
|
---|
39 | #include <iprt/mem.h>
|
---|
40 | #include <iprt/thread.h>
|
---|
41 | #include <iprt/path.h>
|
---|
42 | #include <iprt/string.h>
|
---|
43 |
|
---|
44 |
|
---|
45 | /*********************************************************************************************************************************
|
---|
46 | * Structures and Typedefs *
|
---|
47 | *********************************************************************************************************************************/
|
---|
48 | /**
|
---|
49 | * Internal callback structure pointer.
|
---|
50 | *
|
---|
51 | * The main purpose is to define the extra data we associate
|
---|
52 | * with PDMDRVREGCB so we can find the VM instance and so on.
|
---|
53 | */
|
---|
54 | typedef struct PDMDRVREGCBINT
|
---|
55 | {
|
---|
56 | /** The callback structure. */
|
---|
57 | PDMDRVREGCB Core;
|
---|
58 | /** A bit of padding. */
|
---|
59 | uint32_t u32[4];
|
---|
60 | /** VM Handle. */
|
---|
61 | PVM pVM;
|
---|
62 | /** Pointer to the configuration node the registrations should be
|
---|
63 | * associated with. Can be NULL. */
|
---|
64 | PCFGMNODE pCfgNode;
|
---|
65 | } PDMDRVREGCBINT, *PPDMDRVREGCBINT;
|
---|
66 | typedef const PDMDRVREGCBINT *PCPDMDRVREGCBINT;
|
---|
67 |
|
---|
68 |
|
---|
69 | /*********************************************************************************************************************************
|
---|
70 | * Internal Functions *
|
---|
71 | *********************************************************************************************************************************/
|
---|
72 | static DECLCALLBACK(int) pdmR3DrvRegister(PCPDMDRVREGCB pCallbacks, PCPDMDRVREG pReg);
|
---|
73 | static int pdmR3DrvLoad(PVM pVM, PPDMDRVREGCBINT pRegCB, const char *pszFilename, const char *pszName);
|
---|
74 |
|
---|
75 |
|
---|
76 | /**
|
---|
77 | * Register drivers in a statically linked environment.
|
---|
78 | *
|
---|
79 | * @returns VBox status code.
|
---|
80 | * @param pVM The cross context VM structure.
|
---|
81 | * @param pfnCallback Driver registration callback
|
---|
82 | */
|
---|
83 | VMMR3DECL(int) PDMR3DrvStaticRegistration(PVM pVM, FNPDMVBOXDRIVERSREGISTER pfnCallback)
|
---|
84 | {
|
---|
85 | /*
|
---|
86 | * The registration callbacks.
|
---|
87 | */
|
---|
88 | PDMDRVREGCBINT RegCB;
|
---|
89 | RegCB.Core.u32Version = PDM_DRVREG_CB_VERSION;
|
---|
90 | RegCB.Core.pfnRegister = pdmR3DrvRegister;
|
---|
91 | RegCB.pVM = pVM;
|
---|
92 | RegCB.pCfgNode = NULL;
|
---|
93 |
|
---|
94 | int rc = pfnCallback(&RegCB.Core, VBOX_VERSION);
|
---|
95 | if (RT_FAILURE(rc))
|
---|
96 | AssertMsgFailed(("VBoxDriversRegister failed with rc=%Rrc\n", rc));
|
---|
97 |
|
---|
98 | return rc;
|
---|
99 | }
|
---|
100 |
|
---|
101 |
|
---|
102 | /**
|
---|
103 | * This function will initialize the drivers for this VM instance.
|
---|
104 | *
|
---|
105 | * First of all this mean loading the builtin drivers and letting them
|
---|
106 | * register themselves. Beyond that any additional driver modules are
|
---|
107 | * loaded and called for registration.
|
---|
108 | *
|
---|
109 | * @returns VBox status code.
|
---|
110 | * @param pVM The cross context VM structure.
|
---|
111 | */
|
---|
112 | int pdmR3DrvInit(PVM pVM)
|
---|
113 | {
|
---|
114 | LogFlow(("pdmR3DrvInit:\n"));
|
---|
115 |
|
---|
116 | AssertRelease(!(RT_UOFFSETOF(PDMDRVINS, achInstanceData) & 15));
|
---|
117 | PPDMDRVINS pDrvInsAssert; NOREF(pDrvInsAssert);
|
---|
118 | AssertCompile(sizeof(pDrvInsAssert->Internal.s) <= sizeof(pDrvInsAssert->Internal.padding));
|
---|
119 | AssertRelease(sizeof(pDrvInsAssert->Internal.s) <= sizeof(pDrvInsAssert->Internal.padding));
|
---|
120 |
|
---|
121 | /*
|
---|
122 | * The registration callbacks.
|
---|
123 | */
|
---|
124 | PDMDRVREGCBINT RegCB;
|
---|
125 | RegCB.Core.u32Version = PDM_DRVREG_CB_VERSION;
|
---|
126 | RegCB.Core.pfnRegister = pdmR3DrvRegister;
|
---|
127 | RegCB.pVM = pVM;
|
---|
128 | RegCB.pCfgNode = NULL;
|
---|
129 |
|
---|
130 | /*
|
---|
131 | * Load the builtin module
|
---|
132 | */
|
---|
133 | PCFGMNODE pDriversNode = CFGMR3GetChild(CFGMR3GetRoot(pVM), "PDM/Drivers");
|
---|
134 | bool fLoadBuiltin;
|
---|
135 | int rc = CFGMR3QueryBool(pDriversNode, "LoadBuiltin", &fLoadBuiltin);
|
---|
136 | if (rc == VERR_CFGM_VALUE_NOT_FOUND || rc == VERR_CFGM_NO_PARENT)
|
---|
137 | fLoadBuiltin = true;
|
---|
138 | else if (RT_FAILURE(rc))
|
---|
139 | {
|
---|
140 | AssertMsgFailed(("Configuration error: Querying boolean \"LoadBuiltin\" failed with %Rrc\n", rc));
|
---|
141 | return rc;
|
---|
142 | }
|
---|
143 | if (fLoadBuiltin)
|
---|
144 | {
|
---|
145 | /* make filename */
|
---|
146 | char *pszFilename = pdmR3FileR3("VBoxDD", true /*fShared*/);
|
---|
147 | if (!pszFilename)
|
---|
148 | return VERR_NO_TMP_MEMORY;
|
---|
149 | rc = pdmR3DrvLoad(pVM, &RegCB, pszFilename, "VBoxDD");
|
---|
150 | RTMemTmpFree(pszFilename);
|
---|
151 | if (RT_FAILURE(rc))
|
---|
152 | return rc;
|
---|
153 | }
|
---|
154 |
|
---|
155 | /*
|
---|
156 | * Load additional driver modules.
|
---|
157 | */
|
---|
158 | for (PCFGMNODE pCur = CFGMR3GetFirstChild(pDriversNode); pCur; pCur = CFGMR3GetNextChild(pCur))
|
---|
159 | {
|
---|
160 | /*
|
---|
161 | * Get the name and path.
|
---|
162 | */
|
---|
163 | char szName[PDMMOD_NAME_LEN];
|
---|
164 | rc = CFGMR3GetName(pCur, &szName[0], sizeof(szName));
|
---|
165 | if (rc == VERR_CFGM_NOT_ENOUGH_SPACE)
|
---|
166 | {
|
---|
167 | AssertMsgFailed(("configuration error: The module name is too long, cchName=%zu.\n", CFGMR3GetNameLen(pCur)));
|
---|
168 | return VERR_PDM_MODULE_NAME_TOO_LONG;
|
---|
169 | }
|
---|
170 | else if (RT_FAILURE(rc))
|
---|
171 | {
|
---|
172 | AssertMsgFailed(("CFGMR3GetName -> %Rrc.\n", rc));
|
---|
173 | return rc;
|
---|
174 | }
|
---|
175 |
|
---|
176 | /* the path is optional, if no path the module name + path is used. */
|
---|
177 | char szFilename[RTPATH_MAX];
|
---|
178 | rc = CFGMR3QueryString(pCur, "Path", &szFilename[0], sizeof(szFilename));
|
---|
179 | if (rc == VERR_CFGM_VALUE_NOT_FOUND || rc == VERR_CFGM_NO_PARENT)
|
---|
180 | strcpy(szFilename, szName);
|
---|
181 | else if (RT_FAILURE(rc))
|
---|
182 | {
|
---|
183 | AssertMsgFailed(("configuration error: Failure to query the module path, rc=%Rrc.\n", rc));
|
---|
184 | return rc;
|
---|
185 | }
|
---|
186 |
|
---|
187 | /* prepend path? */
|
---|
188 | if (!RTPathHavePath(szFilename))
|
---|
189 | {
|
---|
190 | char *psz = pdmR3FileR3(szFilename, false /*fShared*/);
|
---|
191 | if (!psz)
|
---|
192 | return VERR_NO_TMP_MEMORY;
|
---|
193 | size_t cch = strlen(psz) + 1;
|
---|
194 | if (cch > sizeof(szFilename))
|
---|
195 | {
|
---|
196 | RTMemTmpFree(psz);
|
---|
197 | AssertMsgFailed(("Filename too long! cch=%d '%s'\n", cch, psz));
|
---|
198 | return VERR_FILENAME_TOO_LONG;
|
---|
199 | }
|
---|
200 | memcpy(szFilename, psz, cch);
|
---|
201 | RTMemTmpFree(psz);
|
---|
202 | }
|
---|
203 |
|
---|
204 | /*
|
---|
205 | * Load the module and register it's drivers.
|
---|
206 | */
|
---|
207 | RegCB.pCfgNode = pCur;
|
---|
208 | rc = pdmR3DrvLoad(pVM, &RegCB, szFilename, szName);
|
---|
209 | if (RT_FAILURE(rc))
|
---|
210 | return rc;
|
---|
211 | }
|
---|
212 |
|
---|
213 | LogFlow(("pdmR3DrvInit: returns VINF_SUCCESS\n"));
|
---|
214 | return VINF_SUCCESS;
|
---|
215 | }
|
---|
216 |
|
---|
217 |
|
---|
218 | /**
|
---|
219 | * Loads one driver module and call the registration entry point.
|
---|
220 | *
|
---|
221 | * @returns VBox status code.
|
---|
222 | * @param pVM The cross context VM structure.
|
---|
223 | * @param pRegCB The registration callback stuff.
|
---|
224 | * @param pszFilename Module filename.
|
---|
225 | * @param pszName Module name.
|
---|
226 | */
|
---|
227 | static int pdmR3DrvLoad(PVM pVM, PPDMDRVREGCBINT pRegCB, const char *pszFilename, const char *pszName)
|
---|
228 | {
|
---|
229 | /*
|
---|
230 | * Load it.
|
---|
231 | */
|
---|
232 | int rc = pdmR3LoadR3U(pVM->pUVM, pszFilename, pszName);
|
---|
233 | if (RT_SUCCESS(rc))
|
---|
234 | {
|
---|
235 | /*
|
---|
236 | * Get the registration export and call it.
|
---|
237 | */
|
---|
238 | FNPDMVBOXDRIVERSREGISTER *pfnVBoxDriversRegister;
|
---|
239 | rc = PDMR3LdrGetSymbolR3(pVM, pszName, "VBoxDriversRegister", (void **)&pfnVBoxDriversRegister);
|
---|
240 | if (RT_SUCCESS(rc))
|
---|
241 | {
|
---|
242 | Log(("PDM: Calling VBoxDriversRegister (%p) of %s (%s)\n", pfnVBoxDriversRegister, pszName, pszFilename));
|
---|
243 | rc = pfnVBoxDriversRegister(&pRegCB->Core, VBOX_VERSION);
|
---|
244 | if (RT_SUCCESS(rc))
|
---|
245 | Log(("PDM: Successfully loaded driver module %s (%s).\n", pszName, pszFilename));
|
---|
246 | else
|
---|
247 | AssertMsgFailed(("VBoxDriversRegister failed with rc=%Rrc\n", rc));
|
---|
248 | }
|
---|
249 | else
|
---|
250 | {
|
---|
251 | AssertMsgFailed(("Failed to locate 'VBoxDriversRegister' in %s (%s) rc=%Rrc\n", pszName, pszFilename, rc));
|
---|
252 | if (rc == VERR_SYMBOL_NOT_FOUND)
|
---|
253 | rc = VERR_PDM_NO_REGISTRATION_EXPORT;
|
---|
254 | }
|
---|
255 | }
|
---|
256 | else
|
---|
257 | AssertMsgFailed(("Failed to load %s (%s) rc=%Rrc!\n", pszName, pszFilename, rc));
|
---|
258 | return rc;
|
---|
259 | }
|
---|
260 |
|
---|
261 |
|
---|
262 | /** @interface_method_impl{PDMDRVREGCB,pfnRegister} */
|
---|
263 | static DECLCALLBACK(int) pdmR3DrvRegister(PCPDMDRVREGCB pCallbacks, PCPDMDRVREG pReg)
|
---|
264 | {
|
---|
265 | /*
|
---|
266 | * Validate the registration structure.
|
---|
267 | */
|
---|
268 | AssertPtrReturn(pReg, VERR_INVALID_POINTER);
|
---|
269 | AssertMsgReturn(pReg->u32Version == PDM_DRVREG_VERSION,
|
---|
270 | ("%#x\n", pReg->u32Version),
|
---|
271 | VERR_PDM_UNKNOWN_DRVREG_VERSION);
|
---|
272 | AssertReturn(pReg->szName[0], VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
273 | AssertMsgReturn(RTStrEnd(pReg->szName, sizeof(pReg->szName)),
|
---|
274 | ("%.*s\n", sizeof(pReg->szName), pReg->szName),
|
---|
275 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
276 | AssertMsgReturn(pdmR3IsValidName(pReg->szName), ("%.*s\n", sizeof(pReg->szName), pReg->szName),
|
---|
277 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
278 | AssertMsgReturn( !(pReg->fFlags & PDM_DRVREG_FLAGS_R0)
|
---|
279 | || ( pReg->szR0Mod[0]
|
---|
280 | && RTStrEnd(pReg->szR0Mod, sizeof(pReg->szR0Mod))),
|
---|
281 | ("%s: %.*s\n", pReg->szName, sizeof(pReg->szR0Mod), pReg->szR0Mod),
|
---|
282 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
283 | AssertMsgReturn( !(pReg->fFlags & PDM_DRVREG_FLAGS_RC)
|
---|
284 | || ( pReg->szRCMod[0]
|
---|
285 | && RTStrEnd(pReg->szRCMod, sizeof(pReg->szRCMod))),
|
---|
286 | ("%s: %.*s\n", pReg->szName, sizeof(pReg->szRCMod), pReg->szRCMod),
|
---|
287 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
288 | AssertMsgReturn(RT_VALID_PTR(pReg->pszDescription),
|
---|
289 | ("%s: %p\n", pReg->szName, pReg->pszDescription),
|
---|
290 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
291 | AssertMsgReturn(!(pReg->fFlags & ~(PDM_DRVREG_FLAGS_HOST_BITS_MASK | PDM_DRVREG_FLAGS_R0 | PDM_DRVREG_FLAGS_RC)),
|
---|
292 | ("%s: %#x\n", pReg->szName, pReg->fFlags),
|
---|
293 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
294 | AssertMsgReturn((pReg->fFlags & PDM_DRVREG_FLAGS_HOST_BITS_MASK) == PDM_DRVREG_FLAGS_HOST_BITS_DEFAULT,
|
---|
295 | ("%s: %#x\n", pReg->szName, pReg->fFlags),
|
---|
296 | VERR_PDM_INVALID_DRIVER_HOST_BITS);
|
---|
297 | AssertMsgReturn(pReg->cMaxInstances > 0,
|
---|
298 | ("%s: %#x\n", pReg->szName, pReg->cMaxInstances),
|
---|
299 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
300 | AssertMsgReturn(pReg->cbInstance <= _1M,
|
---|
301 | ("%s: %#x\n", pReg->szName, pReg->cbInstance),
|
---|
302 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
303 | AssertMsgReturn(RT_VALID_PTR(pReg->pfnConstruct),
|
---|
304 | ("%s: %p\n", pReg->szName, pReg->pfnConstruct),
|
---|
305 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
306 | AssertMsgReturn(RT_VALID_PTR(pReg->pfnRelocate) || !(pReg->fFlags & PDM_DRVREG_FLAGS_RC),
|
---|
307 | ("%s: %#x\n", pReg->szName, pReg->cbInstance),
|
---|
308 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
309 | AssertMsgReturn(pReg->pfnSoftReset == NULL,
|
---|
310 | ("%s: %p\n", pReg->szName, pReg->pfnSoftReset),
|
---|
311 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
312 | AssertMsgReturn(pReg->u32VersionEnd == PDM_DRVREG_VERSION,
|
---|
313 | ("%s: %#x\n", pReg->szName, pReg->u32VersionEnd),
|
---|
314 | VERR_PDM_INVALID_DRIVER_REGISTRATION);
|
---|
315 |
|
---|
316 | /*
|
---|
317 | * Check for duplicate and find FIFO entry at the same time.
|
---|
318 | */
|
---|
319 | PCPDMDRVREGCBINT pRegCB = (PCPDMDRVREGCBINT)pCallbacks;
|
---|
320 | PPDMDRV pDrvPrev = NULL;
|
---|
321 | PPDMDRV pDrv = pRegCB->pVM->pdm.s.pDrvs;
|
---|
322 | for (; pDrv; pDrvPrev = pDrv, pDrv = pDrv->pNext)
|
---|
323 | {
|
---|
324 | if (!strcmp(pDrv->pReg->szName, pReg->szName))
|
---|
325 | {
|
---|
326 | AssertMsgFailed(("Driver '%s' already exists\n", pReg->szName));
|
---|
327 | return VERR_PDM_DRIVER_NAME_CLASH;
|
---|
328 | }
|
---|
329 | }
|
---|
330 |
|
---|
331 | /*
|
---|
332 | * Allocate new driver structure and insert it into the list.
|
---|
333 | */
|
---|
334 | int rc;
|
---|
335 | pDrv = (PPDMDRV)MMR3HeapAlloc(pRegCB->pVM, MM_TAG_PDM_DRIVER, sizeof(*pDrv));
|
---|
336 | if (pDrv)
|
---|
337 | {
|
---|
338 | pDrv->pNext = NULL;
|
---|
339 | pDrv->cInstances = 0;
|
---|
340 | pDrv->iNextInstance = 0;
|
---|
341 | pDrv->pReg = pReg;
|
---|
342 | rc = CFGMR3QueryStringAllocDef( pRegCB->pCfgNode, "RCSearchPath", &pDrv->pszRCSearchPath, NULL);
|
---|
343 | if (RT_SUCCESS(rc))
|
---|
344 | rc = CFGMR3QueryStringAllocDef(pRegCB->pCfgNode, "R0SearchPath", &pDrv->pszR0SearchPath, NULL);
|
---|
345 | if (RT_SUCCESS(rc))
|
---|
346 | {
|
---|
347 | if (pDrvPrev)
|
---|
348 | pDrvPrev->pNext = pDrv;
|
---|
349 | else
|
---|
350 | pRegCB->pVM->pdm.s.pDrvs = pDrv;
|
---|
351 | Log(("PDM: Registered driver '%s'\n", pReg->szName));
|
---|
352 | return VINF_SUCCESS;
|
---|
353 | }
|
---|
354 | MMR3HeapFree(pDrv);
|
---|
355 | }
|
---|
356 | else
|
---|
357 | rc = VERR_NO_MEMORY;
|
---|
358 | return rc;
|
---|
359 | }
|
---|
360 |
|
---|
361 |
|
---|
362 | /**
|
---|
363 | * Lookups a driver structure by name.
|
---|
364 | * @internal
|
---|
365 | */
|
---|
366 | PPDMDRV pdmR3DrvLookup(PVM pVM, const char *pszName)
|
---|
367 | {
|
---|
368 | for (PPDMDRV pDrv = pVM->pdm.s.pDrvs; pDrv; pDrv = pDrv->pNext)
|
---|
369 | if (!strcmp(pDrv->pReg->szName, pszName))
|
---|
370 | return pDrv;
|
---|
371 | return NULL;
|
---|
372 | }
|
---|
373 |
|
---|
374 |
|
---|
375 | /**
|
---|
376 | * Transforms the driver chain as it's being instantiated.
|
---|
377 | *
|
---|
378 | * Worker for pdmR3DrvInstantiate.
|
---|
379 | *
|
---|
380 | * @returns VBox status code.
|
---|
381 | * @param pVM The cross context VM structure.
|
---|
382 | * @param pDrvAbove The driver above, NULL if top.
|
---|
383 | * @param pLun The LUN.
|
---|
384 | * @param ppNode The AttachedDriver node, replaced if any
|
---|
385 | * morphing took place.
|
---|
386 | */
|
---|
387 | static int pdmR3DrvMaybeTransformChain(PVM pVM, PPDMDRVINS pDrvAbove, PPDMLUN pLun, PCFGMNODE *ppNode)
|
---|
388 | {
|
---|
389 | /*
|
---|
390 | * The typical state of affairs is that there are no injections.
|
---|
391 | */
|
---|
392 | PCFGMNODE pCurTrans = CFGMR3GetFirstChild(CFGMR3GetChild(CFGMR3GetRoot(pVM), "PDM/DriverTransformations"));
|
---|
393 | if (!pCurTrans)
|
---|
394 | return VINF_SUCCESS;
|
---|
395 |
|
---|
396 | /*
|
---|
397 | * Gather the attributes used in the matching process.
|
---|
398 | */
|
---|
399 | const char *pszDevice = pLun->pDevIns
|
---|
400 | ? pLun->pDevIns->Internal.s.pDevR3->pReg->szName
|
---|
401 | : pLun->pUsbIns->Internal.s.pUsbDev->pReg->szName;
|
---|
402 | char szLun[32];
|
---|
403 | RTStrPrintf(szLun, sizeof(szLun), "%u", pLun->iLun);
|
---|
404 | const char *pszAbove = pDrvAbove ? pDrvAbove->Internal.s.pDrv->pReg->szName : "<top>";
|
---|
405 | char *pszThisDrv;
|
---|
406 | int rc = CFGMR3QueryStringAlloc(*ppNode, "Driver", &pszThisDrv);
|
---|
407 | AssertMsgRCReturn(rc, ("Query for string value of \"Driver\" -> %Rrc\n", rc),
|
---|
408 | rc == VERR_CFGM_VALUE_NOT_FOUND ? VERR_PDM_CFG_MISSING_DRIVER_NAME : rc);
|
---|
409 |
|
---|
410 | uint64_t uInjectTransformationAbove = 0;
|
---|
411 | if (pDrvAbove)
|
---|
412 | {
|
---|
413 | rc = CFGMR3QueryIntegerDef(CFGMR3GetParent(*ppNode), "InjectTransformationPtr", &uInjectTransformationAbove, 0);
|
---|
414 | AssertLogRelRCReturn(rc, rc);
|
---|
415 | }
|
---|
416 |
|
---|
417 |
|
---|
418 | /*
|
---|
419 | * Enumerate possible driver chain transformations.
|
---|
420 | */
|
---|
421 | unsigned cTransformations = 0;
|
---|
422 | for (; pCurTrans != NULL; pCurTrans = CFGMR3GetNextChild(pCurTrans))
|
---|
423 | {
|
---|
424 | char szCurTransNm[256];
|
---|
425 | rc = CFGMR3GetName(pCurTrans, szCurTransNm, sizeof(szCurTransNm));
|
---|
426 | AssertLogRelRCReturn(rc, rc);
|
---|
427 |
|
---|
428 | /** @cfgm{/PDM/DriverTransformations/<name>/Device,string,*}
|
---|
429 | * One or more simple wildcard patters separated by '|' for matching
|
---|
430 | * the devices this transformation rule applies to. */
|
---|
431 | char *pszMultiPat;
|
---|
432 | rc = CFGMR3QueryStringAllocDef(pCurTrans, "Device", &pszMultiPat, "*");
|
---|
433 | AssertLogRelRCReturn(rc, rc);
|
---|
434 | bool fMatch = RTStrSimplePatternMultiMatch(pszMultiPat, RTSTR_MAX, pszDevice, RTSTR_MAX, NULL);
|
---|
435 | MMR3HeapFree(pszMultiPat);
|
---|
436 | if (!fMatch)
|
---|
437 | continue;
|
---|
438 |
|
---|
439 | /** @cfgm{/PDM/DriverTransformations/<name>/LUN,string,*}
|
---|
440 | * One or more simple wildcard patters separated by '|' for matching
|
---|
441 | * the LUNs this transformation rule applies to. */
|
---|
442 | rc = CFGMR3QueryStringAllocDef(pCurTrans, "LUN", &pszMultiPat, "*");
|
---|
443 | AssertLogRelRCReturn(rc, rc);
|
---|
444 | fMatch = RTStrSimplePatternMultiMatch(pszMultiPat, RTSTR_MAX, szLun, RTSTR_MAX, NULL);
|
---|
445 | MMR3HeapFree(pszMultiPat);
|
---|
446 | if (!fMatch)
|
---|
447 | continue;
|
---|
448 |
|
---|
449 | /** @cfgm{/PDM/DriverTransformations/<name>/BelowDriver,string,*}
|
---|
450 | * One or more simple wildcard patters separated by '|' for matching the
|
---|
451 | * drivers the transformation should be applied below. This means, that
|
---|
452 | * when the drivers matched here attached another driver below them, the
|
---|
453 | * transformation will be applied. To represent the device, '<top>'
|
---|
454 | * is used. */
|
---|
455 | rc = CFGMR3QueryStringAllocDef(pCurTrans, "BelowDriver", &pszMultiPat, "*");
|
---|
456 | AssertLogRelRCReturn(rc, rc);
|
---|
457 | fMatch = RTStrSimplePatternMultiMatch(pszMultiPat, RTSTR_MAX, pszAbove, RTSTR_MAX, NULL);
|
---|
458 | MMR3HeapFree(pszMultiPat);
|
---|
459 | if (!fMatch)
|
---|
460 | continue;
|
---|
461 |
|
---|
462 | /** @cfgm{/PDM/DriverTransformations/<name>/AboveDriver,string,*}
|
---|
463 | * One or more simple wildcard patters separated by '|' for matching the
|
---|
464 | * drivers the transformation should be applie above or at (depending on
|
---|
465 | * the action). The value being matched against here is the driver that
|
---|
466 | * is in the process of being attached, so for mergeconfig actions this is
|
---|
467 | * usually what you need to match on. */
|
---|
468 | rc = CFGMR3QueryStringAlloc(pCurTrans, "AboveDriver", &pszMultiPat);
|
---|
469 | if (rc == VERR_CFGM_VALUE_NOT_FOUND)
|
---|
470 | rc = VINF_SUCCESS;
|
---|
471 | else
|
---|
472 | {
|
---|
473 | AssertLogRelRCReturn(rc, rc);
|
---|
474 | fMatch = RTStrSimplePatternMultiMatch(pszMultiPat, RTSTR_MAX, pszThisDrv, RTSTR_MAX, NULL);
|
---|
475 | MMR3HeapFree(pszMultiPat);
|
---|
476 | if (!fMatch)
|
---|
477 | continue;
|
---|
478 | if (uInjectTransformationAbove == (uintptr_t)pCurTrans)
|
---|
479 | continue;
|
---|
480 | }
|
---|
481 |
|
---|
482 | /*
|
---|
483 | * We've got a match! Now, what are we supposed to do?
|
---|
484 | */
|
---|
485 | /** @cfgm{/PDM/DriverTransformations/<name>/Action,string,inject}
|
---|
486 | * The action that the transformation takes. Possible values are:
|
---|
487 | * - inject
|
---|
488 | * - mergeconfig: This merges and the content of the 'Config' key under the
|
---|
489 | * transformation into the driver's own 'Config' key, replacing any
|
---|
490 | * duplicates.
|
---|
491 | * - remove
|
---|
492 | * - removetree
|
---|
493 | * - replace
|
---|
494 | * - replacetree
|
---|
495 | */
|
---|
496 | char szAction[16];
|
---|
497 | rc = CFGMR3QueryStringDef(pCurTrans, "Action", szAction, sizeof(szAction), "inject");
|
---|
498 | AssertLogRelRCReturn(rc, rc);
|
---|
499 | AssertLogRelMsgReturn( !strcmp(szAction, "inject")
|
---|
500 | || !strcmp(szAction, "mergeconfig")
|
---|
501 | || !strcmp(szAction, "remove")
|
---|
502 | || !strcmp(szAction, "removetree")
|
---|
503 | || !strcmp(szAction, "replace")
|
---|
504 | || !strcmp(szAction, "replacetree")
|
---|
505 | ,
|
---|
506 | ("Action='%s', valid values are 'inject', 'mergeconfig', 'replace', 'replacetree', 'remove', 'removetree'.\n", szAction),
|
---|
507 | VERR_PDM_MISCONFIGURED_DRV_TRANSFORMATION);
|
---|
508 | LogRel(("PDMDriver: Applying '%s' to '%s'::[%s]...'%s': %s\n", szCurTransNm, pszDevice, szLun, pszThisDrv, szAction));
|
---|
509 | CFGMR3Dump(*ppNode);
|
---|
510 | CFGMR3Dump(pCurTrans);
|
---|
511 |
|
---|
512 | /* Get the attached driver to inject. */
|
---|
513 | PCFGMNODE pTransAttDrv = NULL;
|
---|
514 | if (!strcmp(szAction, "inject") || !strcmp(szAction, "replace") || !strcmp(szAction, "replacetree"))
|
---|
515 | {
|
---|
516 | pTransAttDrv = CFGMR3GetChild(pCurTrans, "AttachedDriver");
|
---|
517 | AssertLogRelMsgReturn(pTransAttDrv,
|
---|
518 | ("An %s transformation requires an AttachedDriver child node!\n", szAction),
|
---|
519 | VERR_PDM_MISCONFIGURED_DRV_TRANSFORMATION);
|
---|
520 | }
|
---|
521 |
|
---|
522 |
|
---|
523 | /*
|
---|
524 | * Remove the node.
|
---|
525 | */
|
---|
526 | if (!strcmp(szAction, "remove") || !strcmp(szAction, "removetree"))
|
---|
527 | {
|
---|
528 | PCFGMNODE pBelowThis = CFGMR3GetChild(*ppNode, "AttachedDriver");
|
---|
529 | if (!pBelowThis || !strcmp(szAction, "removetree"))
|
---|
530 | {
|
---|
531 | CFGMR3RemoveNode(*ppNode);
|
---|
532 | *ppNode = NULL;
|
---|
533 | }
|
---|
534 | else
|
---|
535 | {
|
---|
536 | PCFGMNODE pBelowThisCopy;
|
---|
537 | rc = CFGMR3DuplicateSubTree(pBelowThis, &pBelowThisCopy);
|
---|
538 | AssertLogRelRCReturn(rc, rc);
|
---|
539 |
|
---|
540 | rc = CFGMR3ReplaceSubTree(*ppNode, pBelowThisCopy);
|
---|
541 | AssertLogRelRCReturnStmt(rc, CFGMR3RemoveNode(pBelowThis), rc);
|
---|
542 | }
|
---|
543 | }
|
---|
544 | /*
|
---|
545 | * Replace the driver about to be instantiated.
|
---|
546 | */
|
---|
547 | else if (!strcmp(szAction, "replace") || !strcmp(szAction, "replacetree"))
|
---|
548 | {
|
---|
549 | PCFGMNODE pTransCopy;
|
---|
550 | rc = CFGMR3DuplicateSubTree(pTransAttDrv, &pTransCopy);
|
---|
551 | AssertLogRelRCReturn(rc, rc);
|
---|
552 |
|
---|
553 | PCFGMNODE pBelowThis = CFGMR3GetChild(*ppNode, "AttachedDriver");
|
---|
554 | if (!pBelowThis || !strcmp(szAction, "replacetree"))
|
---|
555 | rc = VINF_SUCCESS;
|
---|
556 | else
|
---|
557 | {
|
---|
558 | PCFGMNODE pBelowThisCopy;
|
---|
559 | rc = CFGMR3DuplicateSubTree(pBelowThis, &pBelowThisCopy);
|
---|
560 | if (RT_SUCCESS(rc))
|
---|
561 | {
|
---|
562 | rc = CFGMR3InsertSubTree(pTransCopy, "AttachedDriver", pBelowThisCopy, NULL);
|
---|
563 | AssertLogRelRC(rc);
|
---|
564 | if (RT_FAILURE(rc))
|
---|
565 | CFGMR3RemoveNode(pBelowThisCopy);
|
---|
566 | }
|
---|
567 | }
|
---|
568 | if (RT_SUCCESS(rc))
|
---|
569 | rc = CFGMR3ReplaceSubTree(*ppNode, pTransCopy);
|
---|
570 | if (RT_FAILURE(rc))
|
---|
571 | CFGMR3RemoveNode(pTransCopy);
|
---|
572 | }
|
---|
573 | /*
|
---|
574 | * Inject a driver before the driver about to be instantiated.
|
---|
575 | */
|
---|
576 | else if (!strcmp(szAction, "inject"))
|
---|
577 | {
|
---|
578 | PCFGMNODE pTransCopy;
|
---|
579 | rc = CFGMR3DuplicateSubTree(pTransAttDrv, &pTransCopy);
|
---|
580 | AssertLogRelRCReturn(rc, rc);
|
---|
581 |
|
---|
582 | PCFGMNODE pThisCopy;
|
---|
583 | rc = CFGMR3DuplicateSubTree(*ppNode, &pThisCopy);
|
---|
584 | if (RT_SUCCESS(rc))
|
---|
585 | {
|
---|
586 | rc = CFGMR3InsertSubTree(pTransCopy, "AttachedDriver", pThisCopy, NULL);
|
---|
587 | if (RT_SUCCESS(rc))
|
---|
588 | {
|
---|
589 | rc = CFGMR3InsertInteger(pTransCopy, "InjectTransformationPtr", (uintptr_t)pCurTrans);
|
---|
590 | AssertLogRelRC(rc);
|
---|
591 | rc = CFGMR3InsertString(pTransCopy, "InjectTransformationNm", szCurTransNm);
|
---|
592 | AssertLogRelRC(rc);
|
---|
593 | if (RT_SUCCESS(rc))
|
---|
594 | rc = CFGMR3ReplaceSubTree(*ppNode, pTransCopy);
|
---|
595 | }
|
---|
596 | else
|
---|
597 | {
|
---|
598 | AssertLogRelRC(rc);
|
---|
599 | CFGMR3RemoveNode(pThisCopy);
|
---|
600 | }
|
---|
601 | }
|
---|
602 | if (RT_FAILURE(rc))
|
---|
603 | CFGMR3RemoveNode(pTransCopy);
|
---|
604 | }
|
---|
605 | /*
|
---|
606 | * Merge the Config node of the transformation with the one of the
|
---|
607 | * current driver.
|
---|
608 | */
|
---|
609 | else if (!strcmp(szAction, "mergeconfig"))
|
---|
610 | {
|
---|
611 | PCFGMNODE pTransConfig = CFGMR3GetChild(pCurTrans, "Config");
|
---|
612 | AssertLogRelReturn(pTransConfig, VERR_PDM_MISCONFIGURED_DRV_TRANSFORMATION);
|
---|
613 |
|
---|
614 | PCFGMNODE pDrvConfig = CFGMR3GetChild(*ppNode, "Config");
|
---|
615 | if (*ppNode)
|
---|
616 | CFGMR3InsertNode(*ppNode, "Config", &pDrvConfig);
|
---|
617 | AssertLogRelReturn(pDrvConfig, VERR_PDM_CANNOT_TRANSFORM_REMOVED_DRIVER);
|
---|
618 |
|
---|
619 | rc = CFGMR3CopyTree(pDrvConfig, pTransConfig, CFGM_COPY_FLAGS_REPLACE_VALUES | CFGM_COPY_FLAGS_MERGE_KEYS);
|
---|
620 | AssertLogRelRCReturn(rc, rc);
|
---|
621 | }
|
---|
622 | else
|
---|
623 | AssertFailed();
|
---|
624 |
|
---|
625 | cTransformations++;
|
---|
626 | if (*ppNode)
|
---|
627 | CFGMR3Dump(*ppNode);
|
---|
628 | else
|
---|
629 | LogRel(("PDMDriver: The transformation removed the driver.\n"));
|
---|
630 | }
|
---|
631 |
|
---|
632 | /*
|
---|
633 | * Note what happened in the release log.
|
---|
634 | */
|
---|
635 | if (cTransformations > 0)
|
---|
636 | LogRel(("PDMDriver: Transformations done. Applied %u driver transformations.\n", cTransformations));
|
---|
637 |
|
---|
638 | return rc;
|
---|
639 | }
|
---|
640 |
|
---|
641 |
|
---|
642 | /**
|
---|
643 | * Instantiate a driver.
|
---|
644 | *
|
---|
645 | * @returns VBox status code, including informational statuses.
|
---|
646 | *
|
---|
647 | * @param pVM The cross context VM structure.
|
---|
648 | * @param pNode The CFGM node for the driver.
|
---|
649 | * @param pBaseInterface The base interface.
|
---|
650 | * @param pDrvAbove The driver above it. NULL if it's the top-most
|
---|
651 | * driver.
|
---|
652 | * @param pLun The LUN the driver is being attached to. NULL
|
---|
653 | * if we're instantiating a driver chain before
|
---|
654 | * attaching it - untested.
|
---|
655 | * @param ppBaseInterface Where to return the pointer to the base
|
---|
656 | * interface of the newly created driver.
|
---|
657 | *
|
---|
658 | * @remarks Recursive calls to this function is normal as the drivers will
|
---|
659 | * attach to anything below them during the pfnContruct call.
|
---|
660 | *
|
---|
661 | * @todo Need to extend this interface a bit so that the driver
|
---|
662 | * transformation feature can attach drivers to unconfigured LUNs and
|
---|
663 | * at the end of chains.
|
---|
664 | */
|
---|
665 | int pdmR3DrvInstantiate(PVM pVM, PCFGMNODE pNode, PPDMIBASE pBaseInterface, PPDMDRVINS pDrvAbove,
|
---|
666 | PPDMLUN pLun, PPDMIBASE *ppBaseInterface)
|
---|
667 | {
|
---|
668 | Assert(!pDrvAbove || !pDrvAbove->Internal.s.pDown);
|
---|
669 | Assert(!pDrvAbove || !pDrvAbove->pDownBase);
|
---|
670 |
|
---|
671 | Assert(pBaseInterface->pfnQueryInterface(pBaseInterface, PDMIBASE_IID) == pBaseInterface);
|
---|
672 |
|
---|
673 | /*
|
---|
674 | * Do driver chain injections
|
---|
675 | */
|
---|
676 | int rc = pdmR3DrvMaybeTransformChain(pVM, pDrvAbove, pLun, &pNode);
|
---|
677 | if (RT_FAILURE(rc))
|
---|
678 | return rc;
|
---|
679 | if (!pNode)
|
---|
680 | return VERR_PDM_NO_ATTACHED_DRIVER;
|
---|
681 |
|
---|
682 | /*
|
---|
683 | * Find the driver.
|
---|
684 | */
|
---|
685 | char *pszName;
|
---|
686 | rc = CFGMR3QueryStringAlloc(pNode, "Driver", &pszName);
|
---|
687 | if (RT_SUCCESS(rc))
|
---|
688 | {
|
---|
689 | PPDMDRV pDrv = pdmR3DrvLookup(pVM, pszName);
|
---|
690 | if ( pDrv
|
---|
691 | && pDrv->cInstances < pDrv->pReg->cMaxInstances)
|
---|
692 | {
|
---|
693 | /* config node */
|
---|
694 | PCFGMNODE pConfigNode = CFGMR3GetChild(pNode, "Config");
|
---|
695 | if (!pConfigNode)
|
---|
696 | rc = CFGMR3InsertNode(pNode, "Config", &pConfigNode);
|
---|
697 | if (RT_SUCCESS(rc))
|
---|
698 | {
|
---|
699 | CFGMR3SetRestrictedRoot(pConfigNode);
|
---|
700 |
|
---|
701 | /*
|
---|
702 | * Allocate the driver instance.
|
---|
703 | */
|
---|
704 | size_t cb = RT_UOFFSETOF_DYN(PDMDRVINS, achInstanceData[pDrv->pReg->cbInstance]);
|
---|
705 | cb = RT_ALIGN_Z(cb, 16);
|
---|
706 | bool const fHyperHeap = !!(pDrv->pReg->fFlags & (PDM_DRVREG_FLAGS_R0 | PDM_DRVREG_FLAGS_RC));
|
---|
707 | PPDMDRVINS pNew;
|
---|
708 | if (fHyperHeap)
|
---|
709 | rc = MMHyperAlloc(pVM, cb, 64, MM_TAG_PDM_DRIVER, (void **)&pNew);
|
---|
710 | else
|
---|
711 | rc = MMR3HeapAllocZEx(pVM, MM_TAG_PDM_DRIVER, cb, (void **)&pNew);
|
---|
712 | if (RT_SUCCESS(rc))
|
---|
713 | {
|
---|
714 | /*
|
---|
715 | * Initialize the instance structure (declaration order).
|
---|
716 | */
|
---|
717 | pNew->u32Version = PDM_DRVINS_VERSION;
|
---|
718 | pNew->iInstance = pDrv->iNextInstance;
|
---|
719 | pNew->Internal.s.pUp = pDrvAbove ? pDrvAbove : NULL;
|
---|
720 | //pNew->Internal.s.pDown = NULL;
|
---|
721 | pNew->Internal.s.pLun = pLun;
|
---|
722 | pNew->Internal.s.pDrv = pDrv;
|
---|
723 | pNew->Internal.s.pVMR3 = pVM;
|
---|
724 | pNew->Internal.s.pVMR0 = pDrv->pReg->fFlags & PDM_DRVREG_FLAGS_R0 ? pVM->pVMR0ForCall : NIL_RTR0PTR;
|
---|
725 | pNew->Internal.s.pVMRC = pDrv->pReg->fFlags & PDM_DRVREG_FLAGS_RC ? pVM->pVMRC : NIL_RTRCPTR;
|
---|
726 | //pNew->Internal.s.fDetaching = false;
|
---|
727 | pNew->Internal.s.fVMSuspended = true; /** @todo should be 'false', if driver is attached at runtime. */
|
---|
728 | //pNew->Internal.s.fVMReset = false;
|
---|
729 | pNew->Internal.s.fHyperHeap = fHyperHeap;
|
---|
730 | //pNew->Internal.s.pfnAsyncNotify = NULL;
|
---|
731 | pNew->Internal.s.pCfgHandle = pNode;
|
---|
732 | pNew->pReg = pDrv->pReg;
|
---|
733 | pNew->pCfg = pConfigNode;
|
---|
734 | pNew->pUpBase = pBaseInterface;
|
---|
735 | Assert(!pDrvAbove || pBaseInterface == &pDrvAbove->IBase);
|
---|
736 | //pNew->pDownBase = NULL;
|
---|
737 | //pNew->IBase.pfnQueryInterface = NULL;
|
---|
738 | //pNew->fTracing = 0;
|
---|
739 | pNew->idTracing = ++pVM->pdm.s.idTracingOther;
|
---|
740 | pNew->pHlpR3 = &g_pdmR3DrvHlp;
|
---|
741 | pNew->pvInstanceDataR3 = &pNew->achInstanceData[0];
|
---|
742 | if (pDrv->pReg->fFlags & PDM_DRVREG_FLAGS_R0)
|
---|
743 | {
|
---|
744 | pNew->pvInstanceDataR0 = MMHyperR3ToR0(pVM, &pNew->achInstanceData[0]);
|
---|
745 | rc = PDMR3LdrGetSymbolR0(pVM, NULL, "g_pdmR0DrvHlp", &pNew->pHlpR0);
|
---|
746 | AssertReleaseRCReturn(rc, rc);
|
---|
747 | }
|
---|
748 | if ( (pDrv->pReg->fFlags & PDM_DRVREG_FLAGS_RC)
|
---|
749 | && VM_IS_RAW_MODE_ENABLED(pVM))
|
---|
750 | {
|
---|
751 | pNew->pvInstanceDataR0 = MMHyperR3ToRC(pVM, &pNew->achInstanceData[0]);
|
---|
752 | rc = PDMR3LdrGetSymbolRC(pVM, NULL, "g_pdmRCDrvHlp", &pNew->pHlpRC);
|
---|
753 | AssertReleaseRCReturn(rc, rc);
|
---|
754 | }
|
---|
755 |
|
---|
756 | pDrv->iNextInstance++;
|
---|
757 | pDrv->cInstances++;
|
---|
758 |
|
---|
759 | /*
|
---|
760 | * Link with it with the driver above / LUN.
|
---|
761 | */
|
---|
762 | if (pDrvAbove)
|
---|
763 | {
|
---|
764 | pDrvAbove->pDownBase = &pNew->IBase;
|
---|
765 | pDrvAbove->Internal.s.pDown = pNew;
|
---|
766 | }
|
---|
767 | else if (pLun)
|
---|
768 | pLun->pTop = pNew;
|
---|
769 | if (pLun)
|
---|
770 | pLun->pBottom = pNew;
|
---|
771 |
|
---|
772 | /*
|
---|
773 | * Invoke the constructor.
|
---|
774 | */
|
---|
775 | rc = pDrv->pReg->pfnConstruct(pNew, pNew->pCfg, 0 /*fFlags*/);
|
---|
776 | if (RT_SUCCESS(rc))
|
---|
777 | {
|
---|
778 | AssertPtr(pNew->IBase.pfnQueryInterface);
|
---|
779 | Assert(pNew->IBase.pfnQueryInterface(&pNew->IBase, PDMIBASE_IID) == &pNew->IBase);
|
---|
780 |
|
---|
781 | /* Success! */
|
---|
782 | *ppBaseInterface = &pNew->IBase;
|
---|
783 | if (pLun)
|
---|
784 | Log(("PDM: Attached driver %p:'%s'/%d to LUN#%d on device '%s'/%d, pDrvAbove=%p:'%s'/%d\n",
|
---|
785 | pNew, pDrv->pReg->szName, pNew->iInstance,
|
---|
786 | pLun->iLun,
|
---|
787 | pLun->pDevIns ? pLun->pDevIns->pReg->szName : pLun->pUsbIns->pReg->szName,
|
---|
788 | pLun->pDevIns ? pLun->pDevIns->iInstance : pLun->pUsbIns->iInstance,
|
---|
789 | pDrvAbove, pDrvAbove ? pDrvAbove->pReg->szName : "", pDrvAbove ? pDrvAbove->iInstance : UINT32_MAX));
|
---|
790 | else
|
---|
791 | Log(("PDM: Attached driver %p:'%s'/%d, pDrvAbove=%p:'%s'/%d\n",
|
---|
792 | pNew, pDrv->pReg->szName, pNew->iInstance,
|
---|
793 | pDrvAbove, pDrvAbove ? pDrvAbove->pReg->szName : "", pDrvAbove ? pDrvAbove->iInstance : UINT32_MAX));
|
---|
794 | }
|
---|
795 | else
|
---|
796 | {
|
---|
797 | pdmR3DrvDestroyChain(pNew, PDM_TACH_FLAGS_NO_CALLBACKS);
|
---|
798 | if (rc == VERR_VERSION_MISMATCH)
|
---|
799 | rc = VERR_PDM_DRIVER_VERSION_MISMATCH;
|
---|
800 | }
|
---|
801 | }
|
---|
802 | else
|
---|
803 | AssertMsgFailed(("Failed to allocate %d bytes for instantiating driver '%s'! rc=%Rrc\n", cb, pszName, rc));
|
---|
804 | }
|
---|
805 | else
|
---|
806 | AssertMsgFailed(("Failed to create Config node! rc=%Rrc\n", rc));
|
---|
807 | }
|
---|
808 | else if (pDrv)
|
---|
809 | {
|
---|
810 | AssertMsgFailed(("Too many instances of driver '%s', max is %u\n", pszName, pDrv->pReg->cMaxInstances));
|
---|
811 | rc = VERR_PDM_TOO_MANY_DRIVER_INSTANCES;
|
---|
812 | }
|
---|
813 | else
|
---|
814 | {
|
---|
815 | AssertMsgFailed(("Driver '%s' wasn't found!\n", pszName));
|
---|
816 | rc = VERR_PDM_DRIVER_NOT_FOUND;
|
---|
817 | }
|
---|
818 | MMR3HeapFree(pszName);
|
---|
819 | }
|
---|
820 | else
|
---|
821 | {
|
---|
822 | if (rc == VERR_CFGM_VALUE_NOT_FOUND)
|
---|
823 | rc = VERR_PDM_CFG_MISSING_DRIVER_NAME;
|
---|
824 | else
|
---|
825 | AssertMsgFailed(("Query for string value of \"Driver\" -> %Rrc\n", rc));
|
---|
826 | }
|
---|
827 | return rc;
|
---|
828 | }
|
---|
829 |
|
---|
830 |
|
---|
831 | /**
|
---|
832 | * Detaches a driver from whatever it's attached to.
|
---|
833 | * This will of course lead to the destruction of the driver and all drivers below it in the chain.
|
---|
834 | *
|
---|
835 | * @returns VINF_SUCCESS
|
---|
836 | * @param pDrvIns The driver instance to detach.
|
---|
837 | * @param fFlags Flags, combination of the PDMDEVATT_FLAGS_* \#defines.
|
---|
838 | */
|
---|
839 | int pdmR3DrvDetach(PPDMDRVINS pDrvIns, uint32_t fFlags)
|
---|
840 | {
|
---|
841 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
842 | LogFlow(("pdmR3DrvDetach: pDrvIns=%p '%s'/%d\n", pDrvIns, pDrvIns->pReg->szName, pDrvIns->iInstance));
|
---|
843 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
844 |
|
---|
845 | /*
|
---|
846 | * Check that we're not doing this recursively, that could have unwanted sideeffects!
|
---|
847 | */
|
---|
848 | if (pDrvIns->Internal.s.fDetaching)
|
---|
849 | {
|
---|
850 | AssertMsgFailed(("Recursive detach! '%s'/%d\n", pDrvIns->pReg->szName, pDrvIns->iInstance));
|
---|
851 | return VINF_SUCCESS;
|
---|
852 | }
|
---|
853 |
|
---|
854 | /*
|
---|
855 | * Check that we actually can detach this instance.
|
---|
856 | * The requirement is that the driver/device above has a detach method.
|
---|
857 | */
|
---|
858 | if ( pDrvIns->Internal.s.pUp
|
---|
859 | ? !pDrvIns->Internal.s.pUp->pReg->pfnDetach
|
---|
860 | : pDrvIns->Internal.s.pLun->pDevIns
|
---|
861 | ? !pDrvIns->Internal.s.pLun->pDevIns->pReg->pfnDetach
|
---|
862 | : !pDrvIns->Internal.s.pLun->pUsbIns->pReg->pfnDriverDetach
|
---|
863 | )
|
---|
864 | {
|
---|
865 | AssertMsgFailed(("Cannot detach driver instance because the driver/device above doesn't support it!\n"));
|
---|
866 | return VERR_PDM_DRIVER_DETACH_NOT_POSSIBLE;
|
---|
867 | }
|
---|
868 |
|
---|
869 | /*
|
---|
870 | * Join paths with pdmR3DrvDestroyChain.
|
---|
871 | */
|
---|
872 | pdmR3DrvDestroyChain(pDrvIns, fFlags);
|
---|
873 | return VINF_SUCCESS;
|
---|
874 | }
|
---|
875 |
|
---|
876 |
|
---|
877 | /**
|
---|
878 | * Destroys a driver chain starting with the specified driver.
|
---|
879 | *
|
---|
880 | * This is used when unplugging a device at run time.
|
---|
881 | *
|
---|
882 | * @param pDrvIns Pointer to the driver instance to start with.
|
---|
883 | * @param fFlags PDM_TACH_FLAGS_NOT_HOT_PLUG, PDM_TACH_FLAGS_NO_CALLBACKS
|
---|
884 | * or 0.
|
---|
885 | */
|
---|
886 | void pdmR3DrvDestroyChain(PPDMDRVINS pDrvIns, uint32_t fFlags)
|
---|
887 | {
|
---|
888 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
889 | VM_ASSERT_EMT(pVM);
|
---|
890 |
|
---|
891 | /*
|
---|
892 | * Detach the bottommost driver until we've detached pDrvIns.
|
---|
893 | */
|
---|
894 | pDrvIns->Internal.s.fDetaching = true;
|
---|
895 | PPDMDRVINS pCur;
|
---|
896 | do
|
---|
897 | {
|
---|
898 | /* find the driver to detach. */
|
---|
899 | pCur = pDrvIns;
|
---|
900 | while (pCur->Internal.s.pDown)
|
---|
901 | pCur = pCur->Internal.s.pDown;
|
---|
902 | LogFlow(("pdmR3DrvDestroyChain: pCur=%p '%s'/%d\n", pCur, pCur->pReg->szName, pCur->iInstance));
|
---|
903 |
|
---|
904 | /*
|
---|
905 | * Unlink it and notify parent.
|
---|
906 | */
|
---|
907 | pCur->Internal.s.fDetaching = true;
|
---|
908 |
|
---|
909 | PPDMLUN pLun = pCur->Internal.s.pLun;
|
---|
910 | Assert(pLun->pBottom == pCur);
|
---|
911 | pLun->pBottom = pCur->Internal.s.pUp;
|
---|
912 |
|
---|
913 | if (pCur->Internal.s.pUp)
|
---|
914 | {
|
---|
915 | /* driver parent */
|
---|
916 | PPDMDRVINS pParent = pCur->Internal.s.pUp;
|
---|
917 | pCur->Internal.s.pUp = NULL;
|
---|
918 | pParent->Internal.s.pDown = NULL;
|
---|
919 |
|
---|
920 | if (!(fFlags & PDM_TACH_FLAGS_NO_CALLBACKS) && pParent->pReg->pfnDetach)
|
---|
921 | pParent->pReg->pfnDetach(pParent, fFlags);
|
---|
922 |
|
---|
923 | pParent->pDownBase = NULL;
|
---|
924 | }
|
---|
925 | else
|
---|
926 | {
|
---|
927 | /* device parent */
|
---|
928 | Assert(pLun->pTop == pCur);
|
---|
929 | pLun->pTop = NULL;
|
---|
930 | if (!(fFlags & PDM_TACH_FLAGS_NO_CALLBACKS))
|
---|
931 | {
|
---|
932 | if (pLun->pDevIns)
|
---|
933 | {
|
---|
934 | if (pLun->pDevIns->pReg->pfnDetach)
|
---|
935 | {
|
---|
936 | PDMCritSectEnter(pVM, pLun->pDevIns->pCritSectRoR3, VERR_IGNORED);
|
---|
937 | pLun->pDevIns->pReg->pfnDetach(pLun->pDevIns, pLun->iLun, fFlags);
|
---|
938 | PDMCritSectLeave(pVM, pLun->pDevIns->pCritSectRoR3);
|
---|
939 | }
|
---|
940 | }
|
---|
941 | else
|
---|
942 | {
|
---|
943 | if (pLun->pUsbIns->pReg->pfnDriverDetach)
|
---|
944 | {
|
---|
945 | /** @todo USB device locking? */
|
---|
946 | pLun->pUsbIns->pReg->pfnDriverDetach(pLun->pUsbIns, pLun->iLun, fFlags);
|
---|
947 | }
|
---|
948 | }
|
---|
949 | }
|
---|
950 | }
|
---|
951 |
|
---|
952 | /*
|
---|
953 | * Call destructor.
|
---|
954 | */
|
---|
955 | pCur->pUpBase = NULL;
|
---|
956 | if (pCur->pReg->pfnDestruct)
|
---|
957 | pCur->pReg->pfnDestruct(pCur);
|
---|
958 | pCur->Internal.s.pDrv->cInstances--;
|
---|
959 |
|
---|
960 | /*
|
---|
961 | * Free all resources allocated by the driver.
|
---|
962 | */
|
---|
963 | /* Queues. */
|
---|
964 | int rc = PDMR3QueueDestroyDriver(pVM, pCur);
|
---|
965 | AssertRC(rc);
|
---|
966 |
|
---|
967 | /* Timers. */
|
---|
968 | rc = TMR3TimerDestroyDriver(pVM, pCur);
|
---|
969 | AssertRC(rc);
|
---|
970 |
|
---|
971 | /* SSM data units. */
|
---|
972 | rc = SSMR3DeregisterDriver(pVM, pCur, NULL, 0);
|
---|
973 | AssertRC(rc);
|
---|
974 |
|
---|
975 | /* PDM threads. */
|
---|
976 | rc = pdmR3ThreadDestroyDriver(pVM, pCur);
|
---|
977 | AssertRC(rc);
|
---|
978 |
|
---|
979 | /* Info handlers. */
|
---|
980 | rc = DBGFR3InfoDeregisterDriver(pVM, pCur, NULL);
|
---|
981 | AssertRC(rc);
|
---|
982 |
|
---|
983 | /* PDM critsects. */
|
---|
984 | rc = pdmR3CritSectBothDeleteDriver(pVM, pCur);
|
---|
985 | AssertRC(rc);
|
---|
986 |
|
---|
987 | /* Block caches. */
|
---|
988 | PDMR3BlkCacheReleaseDriver(pVM, pCur);
|
---|
989 |
|
---|
990 | #ifdef VBOX_WITH_PDM_ASYNC_COMPLETION
|
---|
991 | /* Completion templates.*/
|
---|
992 | pdmR3AsyncCompletionTemplateDestroyDriver(pVM, pCur);
|
---|
993 | #endif
|
---|
994 |
|
---|
995 | /* Finally, the driver it self. */
|
---|
996 | bool fHyperHeap = pCur->Internal.s.fHyperHeap;
|
---|
997 | ASMMemFill32(pCur, RT_UOFFSETOF_DYN(PDMDRVINS, achInstanceData[pCur->pReg->cbInstance]), 0xdeadd0d0);
|
---|
998 | if (fHyperHeap)
|
---|
999 | MMHyperFree(pVM, pCur);
|
---|
1000 | else
|
---|
1001 | MMR3HeapFree(pCur);
|
---|
1002 |
|
---|
1003 | } while (pCur != pDrvIns);
|
---|
1004 | }
|
---|
1005 |
|
---|
1006 |
|
---|
1007 |
|
---|
1008 |
|
---|
1009 | /** @name Driver Helpers
|
---|
1010 | * @{
|
---|
1011 | */
|
---|
1012 |
|
---|
1013 | /** @interface_method_impl{PDMDRVHLPR3,pfnAttach} */
|
---|
1014 | static DECLCALLBACK(int) pdmR3DrvHlp_Attach(PPDMDRVINS pDrvIns, uint32_t fFlags, PPDMIBASE *ppBaseInterface)
|
---|
1015 | {
|
---|
1016 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1017 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
1018 | VM_ASSERT_EMT(pVM);
|
---|
1019 | LogFlow(("pdmR3DrvHlp_Attach: caller='%s'/%d: fFlags=%#x\n", pDrvIns->pReg->szName, pDrvIns->iInstance, fFlags));
|
---|
1020 | Assert(!(fFlags & ~(PDM_TACH_FLAGS_NOT_HOT_PLUG)));
|
---|
1021 | RT_NOREF_PV(fFlags);
|
---|
1022 |
|
---|
1023 | /*
|
---|
1024 | * Check that there isn't anything attached already.
|
---|
1025 | */
|
---|
1026 | int rc;
|
---|
1027 | if (!pDrvIns->Internal.s.pDown)
|
---|
1028 | {
|
---|
1029 | Assert(pDrvIns->Internal.s.pLun->pBottom == pDrvIns);
|
---|
1030 |
|
---|
1031 | /*
|
---|
1032 | * Get the attached driver configuration.
|
---|
1033 | */
|
---|
1034 | PCFGMNODE pNode = CFGMR3GetChild(pDrvIns->Internal.s.pCfgHandle, "AttachedDriver");
|
---|
1035 | if (pNode)
|
---|
1036 | rc = pdmR3DrvInstantiate(pVM, pNode, &pDrvIns->IBase, pDrvIns, pDrvIns->Internal.s.pLun, ppBaseInterface);
|
---|
1037 | else
|
---|
1038 | rc = VERR_PDM_NO_ATTACHED_DRIVER;
|
---|
1039 | }
|
---|
1040 | else
|
---|
1041 | {
|
---|
1042 | AssertMsgFailed(("Already got a driver attached. The driver should keep track of such things!\n"));
|
---|
1043 | rc = VERR_PDM_DRIVER_ALREADY_ATTACHED;
|
---|
1044 | }
|
---|
1045 |
|
---|
1046 | LogFlow(("pdmR3DrvHlp_Attach: caller='%s'/%d: return %Rrc\n",
|
---|
1047 | pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1048 | return rc;
|
---|
1049 | }
|
---|
1050 |
|
---|
1051 |
|
---|
1052 | /** @interface_method_impl{PDMDRVHLPR3,pfnDetach} */
|
---|
1053 | static DECLCALLBACK(int) pdmR3DrvHlp_Detach(PPDMDRVINS pDrvIns, uint32_t fFlags)
|
---|
1054 | {
|
---|
1055 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1056 | LogFlow(("pdmR3DrvHlp_Detach: caller='%s'/%d: fFlags=%#x\n",
|
---|
1057 | pDrvIns->pReg->szName, pDrvIns->iInstance, fFlags));
|
---|
1058 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1059 |
|
---|
1060 | /*
|
---|
1061 | * Anything attached?
|
---|
1062 | */
|
---|
1063 | int rc;
|
---|
1064 | if (pDrvIns->Internal.s.pDown)
|
---|
1065 | rc = pdmR3DrvDetach(pDrvIns->Internal.s.pDown, fFlags);
|
---|
1066 | else
|
---|
1067 | {
|
---|
1068 | AssertMsgFailed(("Nothing attached!\n"));
|
---|
1069 | rc = VERR_PDM_NO_DRIVER_ATTACHED;
|
---|
1070 | }
|
---|
1071 |
|
---|
1072 | LogFlow(("pdmR3DrvHlp_Detach: caller='%s'/%d: returns %Rrc\n",
|
---|
1073 | pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1074 | return rc;
|
---|
1075 | }
|
---|
1076 |
|
---|
1077 |
|
---|
1078 | /** @interface_method_impl{PDMDRVHLPR3,pfnDetachSelf} */
|
---|
1079 | static DECLCALLBACK(int) pdmR3DrvHlp_DetachSelf(PPDMDRVINS pDrvIns, uint32_t fFlags)
|
---|
1080 | {
|
---|
1081 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1082 | LogFlow(("pdmR3DrvHlp_DetachSelf: caller='%s'/%d: fFlags=%#x\n",
|
---|
1083 | pDrvIns->pReg->szName, pDrvIns->iInstance, fFlags));
|
---|
1084 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1085 |
|
---|
1086 | int rc = pdmR3DrvDetach(pDrvIns, fFlags);
|
---|
1087 |
|
---|
1088 | LogFlow(("pdmR3DrvHlp_Detach: returns %Rrc\n", rc)); /* pDrvIns is freed by now. */
|
---|
1089 | return rc;
|
---|
1090 | }
|
---|
1091 |
|
---|
1092 |
|
---|
1093 | /** @interface_method_impl{PDMDRVHLPR3,pfnMountPrepare} */
|
---|
1094 | static DECLCALLBACK(int) pdmR3DrvHlp_MountPrepare(PPDMDRVINS pDrvIns, const char *pszFilename, const char *pszCoreDriver)
|
---|
1095 | {
|
---|
1096 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1097 | LogFlow(("pdmR3DrvHlp_MountPrepare: caller='%s'/%d: pszFilename=%p:{%s} pszCoreDriver=%p:{%s}\n",
|
---|
1098 | pDrvIns->pReg->szName, pDrvIns->iInstance, pszFilename, pszFilename, pszCoreDriver, pszCoreDriver));
|
---|
1099 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1100 |
|
---|
1101 | /*
|
---|
1102 | * Do the caller have anything attached below itself?
|
---|
1103 | */
|
---|
1104 | if (pDrvIns->Internal.s.pDown)
|
---|
1105 | {
|
---|
1106 | AssertMsgFailed(("Cannot prepare a mount when something's attached to you!\n"));
|
---|
1107 | return VERR_PDM_DRIVER_ALREADY_ATTACHED;
|
---|
1108 | }
|
---|
1109 |
|
---|
1110 | /*
|
---|
1111 | * We're asked to prepare, so we'll start off by nuking the
|
---|
1112 | * attached configuration tree.
|
---|
1113 | */
|
---|
1114 | PCFGMNODE pNode = CFGMR3GetChild(pDrvIns->Internal.s.pCfgHandle, "AttachedDriver");
|
---|
1115 | if (pNode)
|
---|
1116 | CFGMR3RemoveNode(pNode);
|
---|
1117 |
|
---|
1118 | /*
|
---|
1119 | * If there is no core driver, we'll have to probe for it.
|
---|
1120 | */
|
---|
1121 | if (!pszCoreDriver)
|
---|
1122 | {
|
---|
1123 | /** @todo implement image probing. */
|
---|
1124 | AssertReleaseMsgFailed(("Not implemented!\n"));
|
---|
1125 | return VERR_NOT_IMPLEMENTED;
|
---|
1126 | }
|
---|
1127 |
|
---|
1128 | /*
|
---|
1129 | * Construct the basic attached driver configuration.
|
---|
1130 | */
|
---|
1131 | int rc = CFGMR3InsertNode(pDrvIns->Internal.s.pCfgHandle, "AttachedDriver", &pNode);
|
---|
1132 | if (RT_SUCCESS(rc))
|
---|
1133 | {
|
---|
1134 | rc = CFGMR3InsertString(pNode, "Driver", pszCoreDriver);
|
---|
1135 | if (RT_SUCCESS(rc))
|
---|
1136 | {
|
---|
1137 | PCFGMNODE pCfg;
|
---|
1138 | rc = CFGMR3InsertNode(pNode, "Config", &pCfg);
|
---|
1139 | if (RT_SUCCESS(rc))
|
---|
1140 | {
|
---|
1141 | rc = CFGMR3InsertString(pCfg, "Path", pszFilename);
|
---|
1142 | if (RT_SUCCESS(rc))
|
---|
1143 | {
|
---|
1144 | LogFlow(("pdmR3DrvHlp_MountPrepare: caller='%s'/%d: returns %Rrc (Driver=%s)\n",
|
---|
1145 | pDrvIns->pReg->szName, pDrvIns->iInstance, rc, pszCoreDriver));
|
---|
1146 | return rc;
|
---|
1147 | }
|
---|
1148 | else
|
---|
1149 | AssertMsgFailed(("Path string insert failed, rc=%Rrc\n", rc));
|
---|
1150 | }
|
---|
1151 | else
|
---|
1152 | AssertMsgFailed(("Config node failed, rc=%Rrc\n", rc));
|
---|
1153 | }
|
---|
1154 | else
|
---|
1155 | AssertMsgFailed(("Driver string insert failed, rc=%Rrc\n", rc));
|
---|
1156 | CFGMR3RemoveNode(pNode);
|
---|
1157 | }
|
---|
1158 | else
|
---|
1159 | AssertMsgFailed(("AttachedDriver node insert failed, rc=%Rrc\n", rc));
|
---|
1160 |
|
---|
1161 | LogFlow(("pdmR3DrvHlp_MountPrepare: caller='%s'/%d: returns %Rrc\n",
|
---|
1162 | pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1163 | return rc;
|
---|
1164 | }
|
---|
1165 |
|
---|
1166 |
|
---|
1167 | /** @interface_method_impl{PDMDRVHLPR3,pfnAssertEMT} */
|
---|
1168 | static DECLCALLBACK(bool) pdmR3DrvHlp_AssertEMT(PPDMDRVINS pDrvIns, const char *pszFile, unsigned iLine, const char *pszFunction)
|
---|
1169 | {
|
---|
1170 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1171 | if (VM_IS_EMT(pDrvIns->Internal.s.pVMR3))
|
---|
1172 | return true;
|
---|
1173 |
|
---|
1174 | char szMsg[100];
|
---|
1175 | RTStrPrintf(szMsg, sizeof(szMsg), "AssertEMT '%s'/%d\n", pDrvIns->pReg->szName, pDrvIns->iInstance);
|
---|
1176 | RTAssertMsg1Weak(szMsg, iLine, pszFile, pszFunction);
|
---|
1177 | AssertBreakpoint();
|
---|
1178 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1179 | return false;
|
---|
1180 | }
|
---|
1181 |
|
---|
1182 |
|
---|
1183 | /** @interface_method_impl{PDMDRVHLPR3,pfnAssertOther} */
|
---|
1184 | static DECLCALLBACK(bool) pdmR3DrvHlp_AssertOther(PPDMDRVINS pDrvIns, const char *pszFile, unsigned iLine, const char *pszFunction)
|
---|
1185 | {
|
---|
1186 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1187 | if (!VM_IS_EMT(pDrvIns->Internal.s.pVMR3))
|
---|
1188 | return true;
|
---|
1189 |
|
---|
1190 | char szMsg[100];
|
---|
1191 | RTStrPrintf(szMsg, sizeof(szMsg), "AssertOther '%s'/%d\n", pDrvIns->pReg->szName, pDrvIns->iInstance);
|
---|
1192 | RTAssertMsg1Weak(szMsg, iLine, pszFile, pszFunction);
|
---|
1193 | AssertBreakpoint();
|
---|
1194 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1195 | return false;
|
---|
1196 | }
|
---|
1197 |
|
---|
1198 |
|
---|
1199 | /** @interface_method_impl{PDMDRVHLPR3,pfnVMSetError} */
|
---|
1200 | static DECLCALLBACK(int) pdmR3DrvHlp_VMSetError(PPDMDRVINS pDrvIns, int rc, RT_SRC_POS_DECL, const char *pszFormat, ...)
|
---|
1201 | {
|
---|
1202 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1203 | va_list args;
|
---|
1204 | va_start(args, pszFormat);
|
---|
1205 | int rc2 = VMSetErrorV(pDrvIns->Internal.s.pVMR3, rc, RT_SRC_POS_ARGS, pszFormat, args); Assert(rc2 == rc); NOREF(rc2);
|
---|
1206 | va_end(args);
|
---|
1207 | return rc;
|
---|
1208 | }
|
---|
1209 |
|
---|
1210 |
|
---|
1211 | /** @interface_method_impl{PDMDRVHLPR3,pfnVMSetErrorV} */
|
---|
1212 | static DECLCALLBACK(int) pdmR3DrvHlp_VMSetErrorV(PPDMDRVINS pDrvIns, int rc, RT_SRC_POS_DECL, const char *pszFormat, va_list va)
|
---|
1213 | {
|
---|
1214 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1215 | int rc2 = VMSetErrorV(pDrvIns->Internal.s.pVMR3, rc, RT_SRC_POS_ARGS, pszFormat, va); Assert(rc2 == rc); NOREF(rc2);
|
---|
1216 | return rc;
|
---|
1217 | }
|
---|
1218 |
|
---|
1219 |
|
---|
1220 | /** @interface_method_impl{PDMDRVHLPR3,pfnVMSetRuntimeError} */
|
---|
1221 | static DECLCALLBACK(int) pdmR3DrvHlp_VMSetRuntimeError(PPDMDRVINS pDrvIns, uint32_t fFlags, const char *pszErrorId, const char *pszFormat, ...)
|
---|
1222 | {
|
---|
1223 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1224 | va_list args;
|
---|
1225 | va_start(args, pszFormat);
|
---|
1226 | int rc = VMSetRuntimeErrorV(pDrvIns->Internal.s.pVMR3, fFlags, pszErrorId, pszFormat, args);
|
---|
1227 | va_end(args);
|
---|
1228 | return rc;
|
---|
1229 | }
|
---|
1230 |
|
---|
1231 |
|
---|
1232 | /** @interface_method_impl{PDMDRVHLPR3,pfnVMSetRuntimeErrorV} */
|
---|
1233 | static DECLCALLBACK(int) pdmR3DrvHlp_VMSetRuntimeErrorV(PPDMDRVINS pDrvIns, uint32_t fFlags, const char *pszErrorId, const char *pszFormat, va_list va)
|
---|
1234 | {
|
---|
1235 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1236 | int rc = VMSetRuntimeErrorV(pDrvIns->Internal.s.pVMR3, fFlags, pszErrorId, pszFormat, va);
|
---|
1237 | return rc;
|
---|
1238 | }
|
---|
1239 |
|
---|
1240 |
|
---|
1241 | /** @interface_method_impl{PDMDRVHLPR3,pfnVMState} */
|
---|
1242 | static DECLCALLBACK(VMSTATE) pdmR3DrvHlp_VMState(PPDMDRVINS pDrvIns)
|
---|
1243 | {
|
---|
1244 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1245 |
|
---|
1246 | VMSTATE enmVMState = VMR3GetState(pDrvIns->Internal.s.pVMR3);
|
---|
1247 |
|
---|
1248 | LogFlow(("pdmR3DrvHlp_VMState: caller='%s'/%d: returns %d (%s)\n", pDrvIns->pReg->szName, pDrvIns->iInstance,
|
---|
1249 | enmVMState, VMR3GetStateName(enmVMState)));
|
---|
1250 | return enmVMState;
|
---|
1251 | }
|
---|
1252 |
|
---|
1253 |
|
---|
1254 | /** @interface_method_impl{PDMDRVHLPR3,pfnVMTeleportedAndNotFullyResumedYet} */
|
---|
1255 | static DECLCALLBACK(bool) pdmR3DrvHlp_VMTeleportedAndNotFullyResumedYet(PPDMDRVINS pDrvIns)
|
---|
1256 | {
|
---|
1257 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1258 |
|
---|
1259 | bool fRc = VMR3TeleportedAndNotFullyResumedYet(pDrvIns->Internal.s.pVMR3);
|
---|
1260 |
|
---|
1261 | LogFlow(("pdmR3DrvHlp_VMState: caller='%s'/%d: returns %RTbool)\n", pDrvIns->pReg->szName, pDrvIns->iInstance,
|
---|
1262 | fRc));
|
---|
1263 | return fRc;
|
---|
1264 | }
|
---|
1265 |
|
---|
1266 |
|
---|
1267 | /** @interface_method_impl{PDMDRVHLPR3,pfnGetSupDrvSession} */
|
---|
1268 | static DECLCALLBACK(PSUPDRVSESSION) pdmR3DrvHlp_GetSupDrvSession(PPDMDRVINS pDrvIns)
|
---|
1269 | {
|
---|
1270 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1271 |
|
---|
1272 | PSUPDRVSESSION pSession = pDrvIns->Internal.s.pVMR3->pSession;
|
---|
1273 | LogFlow(("pdmR3DrvHlp_GetSupDrvSession: caller='%s'/%d: returns %p)\n", pDrvIns->pReg->szName, pDrvIns->iInstance,
|
---|
1274 | pSession));
|
---|
1275 | return pSession;
|
---|
1276 | }
|
---|
1277 |
|
---|
1278 |
|
---|
1279 | /** @interface_method_impl{PDMDRVHLPR3,pfnQueueCreate} */
|
---|
1280 | static DECLCALLBACK(int) pdmR3DrvHlp_QueueCreate(PPDMDRVINS pDrvIns, uint32_t cbItem, uint32_t cItems, uint32_t cMilliesInterval,
|
---|
1281 | PFNPDMQUEUEDRV pfnCallback, const char *pszName, PPDMQUEUE *ppQueue)
|
---|
1282 | {
|
---|
1283 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1284 | LogFlow(("pdmR3DrvHlp_PDMQueueCreate: caller='%s'/%d: cbItem=%d cItems=%d cMilliesInterval=%d pfnCallback=%p pszName=%p:{%s} ppQueue=%p\n",
|
---|
1285 | pDrvIns->pReg->szName, pDrvIns->iInstance, cbItem, cItems, cMilliesInterval, pfnCallback, pszName, pszName, ppQueue));
|
---|
1286 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
1287 | VM_ASSERT_EMT(pVM);
|
---|
1288 |
|
---|
1289 | if (pDrvIns->iInstance > 0)
|
---|
1290 | {
|
---|
1291 | pszName = MMR3HeapAPrintf(pVM, MM_TAG_PDM_DRIVER_DESC, "%s_%u", pszName, pDrvIns->iInstance);
|
---|
1292 | AssertLogRelReturn(pszName, VERR_NO_MEMORY);
|
---|
1293 | }
|
---|
1294 |
|
---|
1295 | int rc = PDMR3QueueCreateDriver(pVM, pDrvIns, cbItem, cItems, cMilliesInterval, pfnCallback, pszName, ppQueue);
|
---|
1296 |
|
---|
1297 | LogFlow(("pdmR3DrvHlp_PDMQueueCreate: caller='%s'/%d: returns %Rrc *ppQueue=%p\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc, *ppQueue));
|
---|
1298 | return rc;
|
---|
1299 | }
|
---|
1300 |
|
---|
1301 |
|
---|
1302 | /** @interface_method_impl{PDMDRVHLPR3,pfnTMGetVirtualFreq} */
|
---|
1303 | static DECLCALLBACK(uint64_t) pdmR3DrvHlp_TMGetVirtualFreq(PPDMDRVINS pDrvIns)
|
---|
1304 | {
|
---|
1305 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1306 |
|
---|
1307 | return TMVirtualGetFreq(pDrvIns->Internal.s.pVMR3);
|
---|
1308 | }
|
---|
1309 |
|
---|
1310 |
|
---|
1311 | /** @interface_method_impl{PDMDRVHLPR3,pfnTMGetVirtualTime} */
|
---|
1312 | static DECLCALLBACK(uint64_t) pdmR3DrvHlp_TMGetVirtualTime(PPDMDRVINS pDrvIns)
|
---|
1313 | {
|
---|
1314 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1315 |
|
---|
1316 | return TMVirtualGet(pDrvIns->Internal.s.pVMR3);
|
---|
1317 | }
|
---|
1318 |
|
---|
1319 |
|
---|
1320 | /** @interface_method_impl{PDMDRVHLPR3,pfnTimerCreate} */
|
---|
1321 | static DECLCALLBACK(int) pdmR3DrvHlp_TimerCreate(PPDMDRVINS pDrvIns, TMCLOCK enmClock, PFNTMTIMERDRV pfnCallback, void *pvUser,
|
---|
1322 | uint32_t fFlags, const char *pszDesc, PTMTIMERHANDLE phTimer)
|
---|
1323 | {
|
---|
1324 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1325 | LogFlow(("pdmR3DrvHlp_TimerCreate: caller='%s'/%d: enmClock=%d pfnCallback=%p pvUser=%p fFlags=%#x pszDesc=%p:{%s} phTimer=%p\n",
|
---|
1326 | pDrvIns->pReg->szName, pDrvIns->iInstance, enmClock, pfnCallback, pvUser, fFlags, pszDesc, pszDesc, phTimer));
|
---|
1327 |
|
---|
1328 | /* Mangle the timer name if there are more than once instance of this driver. */
|
---|
1329 | char szName[32];
|
---|
1330 | AssertReturn(strlen(pszDesc) < sizeof(szName) - 3, VERR_INVALID_NAME);
|
---|
1331 | if (pDrvIns->iInstance > 0)
|
---|
1332 | {
|
---|
1333 | RTStrPrintf(szName, sizeof(szName), "%s[%u]", pszDesc, pDrvIns->iInstance);
|
---|
1334 | pszDesc = szName;
|
---|
1335 | }
|
---|
1336 |
|
---|
1337 | /* Clear the ring-0 flag if the driver isn't configured for ring-0. */
|
---|
1338 | if (fFlags & TMTIMER_FLAGS_RING0)
|
---|
1339 | {
|
---|
1340 | AssertReturn(!(fFlags & TMTIMER_FLAGS_NO_RING0), VERR_INVALID_FLAGS);
|
---|
1341 | Assert(pDrvIns->Internal.s.pDrv->pReg->fFlags & PDM_DRVREG_FLAGS_R0);
|
---|
1342 | /* if (!(pDrvIns->Internal.s.fIntFlags & PDMDRVINSINT_FLAGS_R0_ENABLED)) */ /** @todo PDMDRVINSINT_FLAGS_R0_ENABLED? */
|
---|
1343 | fFlags = (fFlags & ~TMTIMER_FLAGS_RING0) | TMTIMER_FLAGS_NO_RING0;
|
---|
1344 | }
|
---|
1345 | else
|
---|
1346 | fFlags |= TMTIMER_FLAGS_NO_RING0;
|
---|
1347 |
|
---|
1348 | int rc = TMR3TimerCreateDriver(pDrvIns->Internal.s.pVMR3, pDrvIns, enmClock, pfnCallback, pvUser, fFlags, pszDesc, phTimer);
|
---|
1349 |
|
---|
1350 | LogFlow(("pdmR3DrvHlp_TMTimerCreate: caller='%s'/%d: returns %Rrc *phTimer=%p\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc, *phTimer));
|
---|
1351 | return rc;
|
---|
1352 | }
|
---|
1353 |
|
---|
1354 |
|
---|
1355 | /** @interface_method_impl{PDMDRVHLPR3,pfnTimerSetMillies} */
|
---|
1356 | static DECLCALLBACK(int) pdmR3DrvHlp_TimerSetMillies(PPDMDRVINS pDrvIns, TMTIMERHANDLE hTimer, uint64_t cMilliesToNext)
|
---|
1357 | {
|
---|
1358 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1359 | return TMTimerSetMillies(pDrvIns->Internal.s.pVMR3, hTimer, cMilliesToNext);
|
---|
1360 | }
|
---|
1361 |
|
---|
1362 |
|
---|
1363 | /** @interface_method_impl{PDMDRVHLPR3,pfnSSMRegister} */
|
---|
1364 | static DECLCALLBACK(int) pdmR3DrvHlp_SSMRegister(PPDMDRVINS pDrvIns, uint32_t uVersion, size_t cbGuess,
|
---|
1365 | PFNSSMDRVLIVEPREP pfnLivePrep, PFNSSMDRVLIVEEXEC pfnLiveExec, PFNSSMDRVLIVEVOTE pfnLiveVote,
|
---|
1366 | PFNSSMDRVSAVEPREP pfnSavePrep, PFNSSMDRVSAVEEXEC pfnSaveExec, PFNSSMDRVSAVEDONE pfnSaveDone,
|
---|
1367 | PFNSSMDRVLOADPREP pfnLoadPrep, PFNSSMDRVLOADEXEC pfnLoadExec, PFNSSMDRVLOADDONE pfnLoadDone)
|
---|
1368 | {
|
---|
1369 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1370 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1371 | LogFlow(("pdmR3DrvHlp_SSMRegister: caller='%s'/%d: uVersion=%#x cbGuess=%#x \n"
|
---|
1372 | " pfnLivePrep=%p pfnLiveExec=%p pfnLiveVote=%p pfnSavePrep=%p pfnSaveExec=%p pfnSaveDone=%p pszLoadPrep=%p pfnLoadExec=%p pfnLoaddone=%p\n",
|
---|
1373 | pDrvIns->pReg->szName, pDrvIns->iInstance, uVersion, cbGuess,
|
---|
1374 | pfnLivePrep, pfnLiveExec, pfnLiveVote,
|
---|
1375 | pfnSavePrep, pfnSaveExec, pfnSaveDone, pfnLoadPrep, pfnLoadExec, pfnLoadDone));
|
---|
1376 |
|
---|
1377 | int rc = SSMR3RegisterDriver(pDrvIns->Internal.s.pVMR3, pDrvIns, pDrvIns->pReg->szName, pDrvIns->iInstance,
|
---|
1378 | uVersion, cbGuess,
|
---|
1379 | pfnLivePrep, pfnLiveExec, pfnLiveVote,
|
---|
1380 | pfnSavePrep, pfnSaveExec, pfnSaveDone,
|
---|
1381 | pfnLoadPrep, pfnLoadExec, pfnLoadDone);
|
---|
1382 |
|
---|
1383 | LogFlow(("pdmR3DrvHlp_SSMRegister: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1384 | return rc;
|
---|
1385 | }
|
---|
1386 |
|
---|
1387 |
|
---|
1388 | /** @interface_method_impl{PDMDRVHLPR3,pfnSSMDeregister} */
|
---|
1389 | static DECLCALLBACK(int) pdmR3DrvHlp_SSMDeregister(PPDMDRVINS pDrvIns, const char *pszName, uint32_t uInstance)
|
---|
1390 | {
|
---|
1391 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1392 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1393 | LogFlow(("pdmR3DrvHlp_SSMDeregister: caller='%s'/%d: pszName=%p:{%s} uInstance=%#x\n",
|
---|
1394 | pDrvIns->pReg->szName, pDrvIns->iInstance, pszName, pszName, uInstance));
|
---|
1395 |
|
---|
1396 | int rc = SSMR3DeregisterDriver(pDrvIns->Internal.s.pVMR3, pDrvIns, pszName, uInstance);
|
---|
1397 |
|
---|
1398 | LogFlow(("pdmR3DrvHlp_SSMDeregister: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1399 | return rc;
|
---|
1400 | }
|
---|
1401 |
|
---|
1402 |
|
---|
1403 | /** @interface_method_impl{PDMDRVHLPR3,pfnDBGFInfoRegister} */
|
---|
1404 | static DECLCALLBACK(int) pdmR3DrvHlp_DBGFInfoRegister(PPDMDRVINS pDrvIns, const char *pszName, const char *pszDesc, PFNDBGFHANDLERDRV pfnHandler)
|
---|
1405 | {
|
---|
1406 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1407 | LogFlow(("pdmR3DrvHlp_DBGFInfoRegister: caller='%s'/%d: pszName=%p:{%s} pszDesc=%p:{%s} pfnHandler=%p\n",
|
---|
1408 | pDrvIns->pReg->szName, pDrvIns->iInstance, pszName, pszName, pszDesc, pszDesc, pfnHandler));
|
---|
1409 |
|
---|
1410 | int rc = DBGFR3InfoRegisterDriver(pDrvIns->Internal.s.pVMR3, pszName, pszDesc, pfnHandler, pDrvIns);
|
---|
1411 |
|
---|
1412 | LogFlow(("pdmR3DrvHlp_DBGFInfoRegister: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1413 | return rc;
|
---|
1414 | }
|
---|
1415 |
|
---|
1416 |
|
---|
1417 | /** @interface_method_impl{PDMDRVHLPR3,pfnDBGFInfoRegisterArgv} */
|
---|
1418 | static DECLCALLBACK(int) pdmR3DrvHlp_DBGFInfoRegisterArgv(PPDMDRVINS pDrvIns, const char *pszName, const char *pszDesc, PFNDBGFINFOARGVDRV pfnHandler)
|
---|
1419 | {
|
---|
1420 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1421 | LogFlow(("pdmR3DrvHlp_DBGFInfoRegisterArgv: caller='%s'/%d: pszName=%p:{%s} pszDesc=%p:{%s} pfnHandler=%p\n",
|
---|
1422 | pDrvIns->pReg->szName, pDrvIns->iInstance, pszName, pszName, pszDesc, pszDesc, pfnHandler));
|
---|
1423 |
|
---|
1424 | int rc = DBGFR3InfoRegisterDriverArgv(pDrvIns->Internal.s.pVMR3, pszName, pszDesc, pfnHandler, pDrvIns);
|
---|
1425 |
|
---|
1426 | LogFlow(("pdmR3DrvHlp_DBGFInfoRegisterArgv: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1427 | return rc;
|
---|
1428 | }
|
---|
1429 |
|
---|
1430 |
|
---|
1431 | /** @interface_method_impl{PDMDRVHLPR3,pfnDBGFInfoDeregister} */
|
---|
1432 | static DECLCALLBACK(int) pdmR3DrvHlp_DBGFInfoDeregister(PPDMDRVINS pDrvIns, const char *pszName)
|
---|
1433 | {
|
---|
1434 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1435 | LogFlow(("pdmR3DrvHlp_DBGFInfoDeregister: caller='%s'/%d: pszName=%p:{%s}\n",
|
---|
1436 | pDrvIns->pReg->szName, pDrvIns->iInstance, pszName, pszName));
|
---|
1437 |
|
---|
1438 | int rc = DBGFR3InfoDeregisterDriver(pDrvIns->Internal.s.pVMR3, pDrvIns, pszName);
|
---|
1439 |
|
---|
1440 | LogFlow(("pdmR3DrvHlp_DBGFInfoDeregister: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1441 |
|
---|
1442 | return rc;
|
---|
1443 | }
|
---|
1444 |
|
---|
1445 |
|
---|
1446 | /** @interface_method_impl{PDMDRVHLPR3,pfnSTAMRegister} */
|
---|
1447 | static DECLCALLBACK(void) pdmR3DrvHlp_STAMRegister(PPDMDRVINS pDrvIns, void *pvSample, STAMTYPE enmType, const char *pszName,
|
---|
1448 | STAMUNIT enmUnit, const char *pszDesc)
|
---|
1449 | {
|
---|
1450 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1451 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
1452 | VM_ASSERT_EMT(pVM);
|
---|
1453 |
|
---|
1454 | #ifdef VBOX_WITH_STATISTICS /** @todo rework this to always be compiled in */
|
---|
1455 | if (*pszName == '/')
|
---|
1456 | STAM_REG(pDrvIns->Internal.s.pVMR3, pvSample, enmType, pszName, enmUnit, pszDesc);
|
---|
1457 | else
|
---|
1458 | STAMR3RegisterF(pVM, pvSample, enmType, STAMVISIBILITY_ALWAYS, enmUnit, pszDesc,
|
---|
1459 | "/Drivers/%s-%u/%s", pDrvIns->pReg->szName, pDrvIns->iInstance, pszName);
|
---|
1460 | #else
|
---|
1461 | RT_NOREF(pDrvIns, pvSample, enmType, pszName, enmUnit, pszDesc, pVM);
|
---|
1462 | #endif
|
---|
1463 | }
|
---|
1464 |
|
---|
1465 |
|
---|
1466 | /** @interface_method_impl{PDMDRVHLPR3,pfnSTAMRegisterV} */
|
---|
1467 | static DECLCALLBACK(void) pdmR3DrvHlp_STAMRegisterV(PPDMDRVINS pDrvIns, void *pvSample, STAMTYPE enmType, STAMVISIBILITY enmVisibility,
|
---|
1468 | STAMUNIT enmUnit, const char *pszDesc, const char *pszName, va_list args)
|
---|
1469 | {
|
---|
1470 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1471 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
1472 | VM_ASSERT_EMT(pVM);
|
---|
1473 |
|
---|
1474 | int rc;
|
---|
1475 | if (*pszName == '/')
|
---|
1476 | rc = STAMR3RegisterV(pVM, pvSample, enmType, enmVisibility, enmUnit, pszDesc, pszName, args);
|
---|
1477 | else
|
---|
1478 | {
|
---|
1479 | /* We need to format it to check whether it starts with a
|
---|
1480 | slash or not (will rework this later). */
|
---|
1481 | char szFormatted[2048];
|
---|
1482 | ssize_t cchBase = RTStrPrintf2(szFormatted, sizeof(szFormatted) - 1024, "/Drivers/%s-%u/",
|
---|
1483 | pDrvIns->pReg->szName, pDrvIns->iInstance);
|
---|
1484 | AssertReturnVoid(cchBase > 0);
|
---|
1485 |
|
---|
1486 | ssize_t cch2 = RTStrPrintf2V(&szFormatted[cchBase], sizeof(szFormatted) - cchBase, pszName, args);
|
---|
1487 | AssertReturnVoid(cch2 > 0);
|
---|
1488 |
|
---|
1489 | rc = STAMR3Register(pVM, pvSample, enmType, enmVisibility,
|
---|
1490 | &szFormatted[szFormatted[cchBase] == '/' ? cchBase : 0], enmUnit, pszDesc);
|
---|
1491 | }
|
---|
1492 | AssertRC(rc);
|
---|
1493 | }
|
---|
1494 |
|
---|
1495 |
|
---|
1496 | /** @interface_method_impl{PDMDRVHLPR3,pfnSTAMRegisterF} */
|
---|
1497 | static DECLCALLBACK(void) pdmR3DrvHlp_STAMRegisterF(PPDMDRVINS pDrvIns, void *pvSample, STAMTYPE enmType, STAMVISIBILITY enmVisibility,
|
---|
1498 | STAMUNIT enmUnit, const char *pszDesc, const char *pszName, ...)
|
---|
1499 | {
|
---|
1500 | va_list va;
|
---|
1501 | va_start(va, pszName);
|
---|
1502 | pdmR3DrvHlp_STAMRegisterV(pDrvIns, pvSample, enmType, enmVisibility, enmUnit, pszDesc, pszName, va);
|
---|
1503 | va_end(va);
|
---|
1504 | }
|
---|
1505 |
|
---|
1506 |
|
---|
1507 | /** @interface_method_impl{PDMDRVHLPR3,pfnSTAMDeregister} */
|
---|
1508 | static DECLCALLBACK(int) pdmR3DrvHlp_STAMDeregister(PPDMDRVINS pDrvIns, void *pvSample)
|
---|
1509 | {
|
---|
1510 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1511 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1512 |
|
---|
1513 | return STAMR3DeregisterByAddr(pDrvIns->Internal.s.pVMR3->pUVM, pvSample);
|
---|
1514 | }
|
---|
1515 |
|
---|
1516 |
|
---|
1517 | /** @interface_method_impl{PDMDRVHLPR3,pfnSTAMDeregisterByPrefix} */
|
---|
1518 | static DECLCALLBACK(int) pdmR3DrvHlp_STAMDeregisterByPrefix(PPDMDRVINS pDrvIns, const char *pszPrefix)
|
---|
1519 | {
|
---|
1520 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1521 |
|
---|
1522 | if (*pszPrefix == '/')
|
---|
1523 | return STAMR3DeregisterByPrefix(pDrvIns->Internal.s.pVMR3->pUVM, pszPrefix);
|
---|
1524 |
|
---|
1525 | char szTmp[2048];
|
---|
1526 | ssize_t cch = RTStrPrintf2(szTmp, sizeof(szTmp), "/Drivers/%s-%u/%s", pDrvIns->pReg->szName, pDrvIns->iInstance, pszPrefix);
|
---|
1527 | AssertReturn(cch > 0, VERR_BUFFER_OVERFLOW);
|
---|
1528 | return STAMR3DeregisterByPrefix(pDrvIns->Internal.s.pVMR3->pUVM, szTmp);
|
---|
1529 | }
|
---|
1530 |
|
---|
1531 |
|
---|
1532 | /** @interface_method_impl{PDMDRVHLPR3,pfnSUPCallVMMR0Ex} */
|
---|
1533 | static DECLCALLBACK(int) pdmR3DrvHlp_SUPCallVMMR0Ex(PPDMDRVINS pDrvIns, unsigned uOperation, void *pvArg, unsigned cbArg)
|
---|
1534 | {
|
---|
1535 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1536 | LogFlow(("pdmR3DrvHlp_SSMCallVMMR0Ex: caller='%s'/%d: uOperation=%u pvArg=%p cbArg=%d\n",
|
---|
1537 | pDrvIns->pReg->szName, pDrvIns->iInstance, uOperation, pvArg, cbArg));
|
---|
1538 | RT_NOREF_PV(cbArg);
|
---|
1539 |
|
---|
1540 | int rc;
|
---|
1541 | if ( uOperation >= VMMR0_DO_SRV_START
|
---|
1542 | && uOperation < VMMR0_DO_SRV_END)
|
---|
1543 | rc = SUPR3CallVMMR0Ex(VMCC_GET_VMR0_FOR_CALL(pDrvIns->Internal.s.pVMR3), NIL_VMCPUID, uOperation, 0, (PSUPVMMR0REQHDR)pvArg);
|
---|
1544 | else
|
---|
1545 | {
|
---|
1546 | AssertMsgFailed(("Invalid uOperation=%u\n", uOperation));
|
---|
1547 | rc = VERR_INVALID_PARAMETER;
|
---|
1548 | }
|
---|
1549 |
|
---|
1550 | LogFlow(("pdmR3DrvHlp_SUPCallVMMR0Ex: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1551 | return rc;
|
---|
1552 | }
|
---|
1553 |
|
---|
1554 |
|
---|
1555 | /** @interface_method_impl{PDMDRVHLPR3,pfnUSBRegisterHub} */
|
---|
1556 | static DECLCALLBACK(int) pdmR3DrvHlp_USBRegisterHub(PPDMDRVINS pDrvIns, uint32_t fVersions, uint32_t cPorts, PCPDMUSBHUBREG pUsbHubReg, PPCPDMUSBHUBHLP ppUsbHubHlp)
|
---|
1557 | {
|
---|
1558 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1559 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1560 | LogFlow(("pdmR3DrvHlp_USBRegisterHub: caller='%s'/%d: fVersions=%#x cPorts=%#x pUsbHubReg=%p ppUsbHubHlp=%p\n",
|
---|
1561 | pDrvIns->pReg->szName, pDrvIns->iInstance, fVersions, cPorts, pUsbHubReg, ppUsbHubHlp));
|
---|
1562 |
|
---|
1563 | #ifdef VBOX_WITH_USB
|
---|
1564 | int rc = pdmR3UsbRegisterHub(pDrvIns->Internal.s.pVMR3, pDrvIns, fVersions, cPorts, pUsbHubReg, ppUsbHubHlp);
|
---|
1565 | #else
|
---|
1566 | int rc = VERR_NOT_SUPPORTED;
|
---|
1567 | #endif
|
---|
1568 |
|
---|
1569 | LogFlow(("pdmR3DrvHlp_USBRegisterHub: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1570 | return rc;
|
---|
1571 | }
|
---|
1572 |
|
---|
1573 |
|
---|
1574 | /** @interface_method_impl{PDMDRVHLPR3,pfnSetAsyncNotification} */
|
---|
1575 | static DECLCALLBACK(int) pdmR3DrvHlp_SetAsyncNotification(PPDMDRVINS pDrvIns, PFNPDMDRVASYNCNOTIFY pfnAsyncNotify)
|
---|
1576 | {
|
---|
1577 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1578 | VM_ASSERT_EMT0(pDrvIns->Internal.s.pVMR3);
|
---|
1579 | LogFlow(("pdmR3DrvHlp_SetAsyncNotification: caller='%s'/%d: pfnAsyncNotify=%p\n", pDrvIns->pReg->szName, pDrvIns->iInstance, pfnAsyncNotify));
|
---|
1580 |
|
---|
1581 | int rc = VINF_SUCCESS;
|
---|
1582 | AssertStmt(pfnAsyncNotify, rc = VERR_INVALID_PARAMETER);
|
---|
1583 | AssertStmt(!pDrvIns->Internal.s.pfnAsyncNotify, rc = VERR_WRONG_ORDER);
|
---|
1584 | AssertStmt(pDrvIns->Internal.s.fVMSuspended || pDrvIns->Internal.s.fVMReset, rc = VERR_WRONG_ORDER);
|
---|
1585 | VMSTATE enmVMState = VMR3GetState(pDrvIns->Internal.s.pVMR3);
|
---|
1586 | AssertStmt( enmVMState == VMSTATE_SUSPENDING
|
---|
1587 | || enmVMState == VMSTATE_SUSPENDING_EXT_LS
|
---|
1588 | || enmVMState == VMSTATE_SUSPENDING_LS
|
---|
1589 | || enmVMState == VMSTATE_RESETTING
|
---|
1590 | || enmVMState == VMSTATE_RESETTING_LS
|
---|
1591 | || enmVMState == VMSTATE_POWERING_OFF
|
---|
1592 | || enmVMState == VMSTATE_POWERING_OFF_LS,
|
---|
1593 | rc = VERR_INVALID_STATE);
|
---|
1594 |
|
---|
1595 | if (RT_SUCCESS(rc))
|
---|
1596 | pDrvIns->Internal.s.pfnAsyncNotify = pfnAsyncNotify;
|
---|
1597 |
|
---|
1598 | LogFlow(("pdmR3DrvHlp_SetAsyncNotification: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName, pDrvIns->iInstance, rc));
|
---|
1599 | return rc;
|
---|
1600 | }
|
---|
1601 |
|
---|
1602 |
|
---|
1603 | /** @interface_method_impl{PDMDRVHLPR3,pfnAsyncNotificationCompleted} */
|
---|
1604 | static DECLCALLBACK(void) pdmR3DrvHlp_AsyncNotificationCompleted(PPDMDRVINS pDrvIns)
|
---|
1605 | {
|
---|
1606 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1607 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
1608 |
|
---|
1609 | VMSTATE enmVMState = VMR3GetState(pVM);
|
---|
1610 | if ( enmVMState == VMSTATE_SUSPENDING
|
---|
1611 | || enmVMState == VMSTATE_SUSPENDING_EXT_LS
|
---|
1612 | || enmVMState == VMSTATE_SUSPENDING_LS
|
---|
1613 | || enmVMState == VMSTATE_RESETTING
|
---|
1614 | || enmVMState == VMSTATE_RESETTING_LS
|
---|
1615 | || enmVMState == VMSTATE_POWERING_OFF
|
---|
1616 | || enmVMState == VMSTATE_POWERING_OFF_LS)
|
---|
1617 | {
|
---|
1618 | LogFlow(("pdmR3DrvHlp_AsyncNotificationCompleted: caller='%s'/%d:\n", pDrvIns->pReg->szName, pDrvIns->iInstance));
|
---|
1619 | VMR3AsyncPdmNotificationWakeupU(pVM->pUVM);
|
---|
1620 | }
|
---|
1621 | else
|
---|
1622 | LogFlow(("pdmR3DrvHlp_AsyncNotificationCompleted: caller='%s'/%d: enmVMState=%d\n", pDrvIns->pReg->szName, pDrvIns->iInstance, enmVMState));
|
---|
1623 | }
|
---|
1624 |
|
---|
1625 |
|
---|
1626 | /** @interface_method_impl{PDMDRVHLPR3,pfnThreadCreate} */
|
---|
1627 | static DECLCALLBACK(int) pdmR3DrvHlp_ThreadCreate(PPDMDRVINS pDrvIns, PPPDMTHREAD ppThread, void *pvUser, PFNPDMTHREADDRV pfnThread,
|
---|
1628 | PFNPDMTHREADWAKEUPDRV pfnWakeup, size_t cbStack, RTTHREADTYPE enmType, const char *pszName)
|
---|
1629 | {
|
---|
1630 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1631 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1632 | LogFlow(("pdmR3DrvHlp_ThreadCreate: caller='%s'/%d: ppThread=%p pvUser=%p pfnThread=%p pfnWakeup=%p cbStack=%#zx enmType=%d pszName=%p:{%s}\n",
|
---|
1633 | pDrvIns->pReg->szName, pDrvIns->iInstance, ppThread, pvUser, pfnThread, pfnWakeup, cbStack, enmType, pszName, pszName));
|
---|
1634 |
|
---|
1635 | int rc = pdmR3ThreadCreateDriver(pDrvIns->Internal.s.pVMR3, pDrvIns, ppThread, pvUser, pfnThread, pfnWakeup, cbStack, enmType, pszName);
|
---|
1636 |
|
---|
1637 | LogFlow(("pdmR3DrvHlp_ThreadCreate: caller='%s'/%d: returns %Rrc *ppThread=%RTthrd\n", pDrvIns->pReg->szName, pDrvIns->iInstance,
|
---|
1638 | rc, *ppThread));
|
---|
1639 | return rc;
|
---|
1640 | }
|
---|
1641 |
|
---|
1642 |
|
---|
1643 | /** @interface_method_impl{PDMDRVHLPR3,pfnAsyncCompletionTemplateCreate} */
|
---|
1644 | static DECLCALLBACK(int) pdmR3DrvHlp_AsyncCompletionTemplateCreate(PPDMDRVINS pDrvIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate,
|
---|
1645 | PFNPDMASYNCCOMPLETEDRV pfnCompleted, void *pvTemplateUser,
|
---|
1646 | const char *pszDesc)
|
---|
1647 | {
|
---|
1648 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1649 | LogFlow(("pdmR3DrvHlp_AsyncCompletionTemplateCreate: caller='%s'/%d: ppTemplate=%p pfnCompleted=%p pszDesc=%p:{%s}\n",
|
---|
1650 | pDrvIns->pReg->szName, pDrvIns->iInstance, ppTemplate, pfnCompleted, pszDesc, pszDesc));
|
---|
1651 |
|
---|
1652 | int rc = pdmR3AsyncCompletionTemplateCreateDriver(pDrvIns->Internal.s.pVMR3, pDrvIns, ppTemplate, pfnCompleted, pvTemplateUser, pszDesc);
|
---|
1653 |
|
---|
1654 | LogFlow(("pdmR3DrvHlp_AsyncCompletionTemplateCreate: caller='%s'/%d: returns %Rrc *ppThread=%p\n", pDrvIns->pReg->szName,
|
---|
1655 | pDrvIns->iInstance, rc, *ppTemplate));
|
---|
1656 | return rc;
|
---|
1657 | }
|
---|
1658 |
|
---|
1659 |
|
---|
1660 | /** @interface_method_impl{PDMDRVHLPR3,pfnNetShaperAttach} */
|
---|
1661 | static DECLCALLBACK(int) pdmR3DrvHlp_NetShaperAttach(PPDMDRVINS pDrvIns, const char *pszBwGroup, PPDMNSFILTER pFilter)
|
---|
1662 | {
|
---|
1663 | #ifdef VBOX_WITH_NETSHAPER
|
---|
1664 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1665 | LogFlow(("pdmR3DrvHlp_NetShaperAttach: caller='%s'/%d: pFilter=%p pszBwGroup=%p:{%s}\n",
|
---|
1666 | pDrvIns->pReg->szName, pDrvIns->iInstance, pFilter, pszBwGroup, pszBwGroup));
|
---|
1667 |
|
---|
1668 | int rc = PDMR3NsAttach(pDrvIns->Internal.s.pVMR3->pUVM, pDrvIns, pszBwGroup, pFilter);
|
---|
1669 |
|
---|
1670 | LogFlow(("pdmR3DrvHlp_NetShaperAttach: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName,
|
---|
1671 | pDrvIns->iInstance, rc));
|
---|
1672 | return rc;
|
---|
1673 | #else
|
---|
1674 | RT_NOREF(pDrvIns, pszBwGroup, pFilter);
|
---|
1675 | return VERR_NOT_IMPLEMENTED;
|
---|
1676 | #endif
|
---|
1677 | }
|
---|
1678 |
|
---|
1679 |
|
---|
1680 | /** @interface_method_impl{PDMDRVHLPR3,pfnNetShaperDetach} */
|
---|
1681 | static DECLCALLBACK(int) pdmR3DrvHlp_NetShaperDetach(PPDMDRVINS pDrvIns, PPDMNSFILTER pFilter)
|
---|
1682 | {
|
---|
1683 | #ifdef VBOX_WITH_NETSHAPER
|
---|
1684 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1685 | LogFlow(("pdmR3DrvHlp_NetShaperDetach: caller='%s'/%d: pFilter=%p\n",
|
---|
1686 | pDrvIns->pReg->szName, pDrvIns->iInstance, pFilter));
|
---|
1687 |
|
---|
1688 | int rc = PDMR3NsDetach(pDrvIns->Internal.s.pVMR3->pUVM, pDrvIns, pFilter);
|
---|
1689 |
|
---|
1690 | LogFlow(("pdmR3DrvHlp_NetShaperDetach: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName,
|
---|
1691 | pDrvIns->iInstance, rc));
|
---|
1692 | return rc;
|
---|
1693 | #else
|
---|
1694 | RT_NOREF(pDrvIns, pFilter);
|
---|
1695 | return VERR_NOT_IMPLEMENTED;
|
---|
1696 | #endif
|
---|
1697 | }
|
---|
1698 |
|
---|
1699 |
|
---|
1700 | /** @interface_method_impl{PDMDRVHLPR3,pfnNetShaperAllocateBandwidth} */
|
---|
1701 | static DECLCALLBACK(bool) pdmR3DrvHlp_NetShaperAllocateBandwidth(PPDMDRVINS pDrvIns, PPDMNSFILTER pFilter, size_t cbTransfer)
|
---|
1702 | {
|
---|
1703 | #ifdef VBOX_WITH_NETSHAPER
|
---|
1704 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1705 | LogFlow(("pdmR3DrvHlp_NetShaperDetach: caller='%s'/%d: pFilter=%p cbTransfer=%#zx\n",
|
---|
1706 | pDrvIns->pReg->szName, pDrvIns->iInstance, pFilter, cbTransfer));
|
---|
1707 |
|
---|
1708 | bool const fRc = PDMNetShaperAllocateBandwidth(pDrvIns->Internal.s.pVMR3, pFilter, cbTransfer);
|
---|
1709 |
|
---|
1710 | LogFlow(("pdmR3DrvHlp_NetShaperDetach: caller='%s'/%d: returns %RTbool\n", pDrvIns->pReg->szName, pDrvIns->iInstance, fRc));
|
---|
1711 | return fRc;
|
---|
1712 | #else
|
---|
1713 | RT_NOREF(pDrvIns, pFilter, cbTransfer);
|
---|
1714 | return true;
|
---|
1715 | #endif
|
---|
1716 | }
|
---|
1717 |
|
---|
1718 |
|
---|
1719 | /** @interface_method_impl{PDMDRVHLPR3,pfnLdrGetRCInterfaceSymbols} */
|
---|
1720 | static DECLCALLBACK(int) pdmR3DrvHlp_LdrGetRCInterfaceSymbols(PPDMDRVINS pDrvIns, void *pvInterface, size_t cbInterface,
|
---|
1721 | const char *pszSymPrefix, const char *pszSymList)
|
---|
1722 | {
|
---|
1723 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1724 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1725 | LogFlow(("pdmR3DrvHlp_LdrGetRCInterfaceSymbols: caller='%s'/%d: pvInterface=%p cbInterface=%zu pszSymPrefix=%p:{%s} pszSymList=%p:{%s}\n",
|
---|
1726 | pDrvIns->pReg->szName, pDrvIns->iInstance, pvInterface, cbInterface, pszSymPrefix, pszSymPrefix, pszSymList, pszSymList));
|
---|
1727 |
|
---|
1728 | int rc;
|
---|
1729 | if ( strncmp(pszSymPrefix, "drv", 3) == 0
|
---|
1730 | && RTStrIStr(pszSymPrefix + 3, pDrvIns->pReg->szName) != NULL)
|
---|
1731 | {
|
---|
1732 | if (pDrvIns->pReg->fFlags & PDM_DRVREG_FLAGS_RC)
|
---|
1733 | rc = PDMR3LdrGetInterfaceSymbols(pDrvIns->Internal.s.pVMR3,
|
---|
1734 | pvInterface, cbInterface,
|
---|
1735 | pDrvIns->pReg->szRCMod, pDrvIns->Internal.s.pDrv->pszRCSearchPath,
|
---|
1736 | pszSymPrefix, pszSymList,
|
---|
1737 | false /*fRing0OrRC*/);
|
---|
1738 | else
|
---|
1739 | {
|
---|
1740 | AssertMsgFailed(("Not a raw-mode enabled driver\n"));
|
---|
1741 | rc = VERR_PERMISSION_DENIED;
|
---|
1742 | }
|
---|
1743 | }
|
---|
1744 | else
|
---|
1745 | {
|
---|
1746 | AssertMsgFailed(("Invalid prefix '%s' for '%s'; must start with 'drv' and contain the driver name!\n",
|
---|
1747 | pszSymPrefix, pDrvIns->pReg->szName));
|
---|
1748 | rc = VERR_INVALID_NAME;
|
---|
1749 | }
|
---|
1750 |
|
---|
1751 | LogFlow(("pdmR3DrvHlp_LdrGetRCInterfaceSymbols: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName,
|
---|
1752 | pDrvIns->iInstance, rc));
|
---|
1753 | return rc;
|
---|
1754 | }
|
---|
1755 |
|
---|
1756 |
|
---|
1757 | /** @interface_method_impl{PDMDRVHLPR3,pfnLdrGetR0InterfaceSymbols} */
|
---|
1758 | static DECLCALLBACK(int) pdmR3DrvHlp_LdrGetR0InterfaceSymbols(PPDMDRVINS pDrvIns, void *pvInterface, size_t cbInterface,
|
---|
1759 | const char *pszSymPrefix, const char *pszSymList)
|
---|
1760 | {
|
---|
1761 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1762 | VM_ASSERT_EMT(pDrvIns->Internal.s.pVMR3);
|
---|
1763 | LogFlow(("pdmR3DrvHlp_LdrGetR0InterfaceSymbols: caller='%s'/%d: pvInterface=%p cbInterface=%zu pszSymPrefix=%p:{%s} pszSymList=%p:{%s}\n",
|
---|
1764 | pDrvIns->pReg->szName, pDrvIns->iInstance, pvInterface, cbInterface, pszSymPrefix, pszSymPrefix, pszSymList, pszSymList));
|
---|
1765 |
|
---|
1766 | int rc;
|
---|
1767 | if ( strncmp(pszSymPrefix, "drv", 3) == 0
|
---|
1768 | && RTStrIStr(pszSymPrefix + 3, pDrvIns->pReg->szName) != NULL)
|
---|
1769 | {
|
---|
1770 | if (pDrvIns->pReg->fFlags & PDM_DRVREG_FLAGS_R0)
|
---|
1771 | rc = PDMR3LdrGetInterfaceSymbols(pDrvIns->Internal.s.pVMR3,
|
---|
1772 | pvInterface, cbInterface,
|
---|
1773 | pDrvIns->pReg->szR0Mod, pDrvIns->Internal.s.pDrv->pszR0SearchPath,
|
---|
1774 | pszSymPrefix, pszSymList,
|
---|
1775 | true /*fRing0OrRC*/);
|
---|
1776 | else
|
---|
1777 | {
|
---|
1778 | AssertMsgFailed(("Not a ring-0 enabled driver\n"));
|
---|
1779 | rc = VERR_PERMISSION_DENIED;
|
---|
1780 | }
|
---|
1781 | }
|
---|
1782 | else
|
---|
1783 | {
|
---|
1784 | AssertMsgFailed(("Invalid prefix '%s' for '%s'; must start with 'drv' and contain the driver name!\n",
|
---|
1785 | pszSymPrefix, pDrvIns->pReg->szName));
|
---|
1786 | rc = VERR_INVALID_NAME;
|
---|
1787 | }
|
---|
1788 |
|
---|
1789 | LogFlow(("pdmR3DrvHlp_LdrGetR0InterfaceSymbols: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName,
|
---|
1790 | pDrvIns->iInstance, rc));
|
---|
1791 | return rc;
|
---|
1792 | }
|
---|
1793 |
|
---|
1794 |
|
---|
1795 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectInit} */
|
---|
1796 | static DECLCALLBACK(int) pdmR3DrvHlp_CritSectInit(PPDMDRVINS pDrvIns, PPDMCRITSECT pCritSect,
|
---|
1797 | RT_SRC_POS_DECL, const char *pszName)
|
---|
1798 | {
|
---|
1799 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1800 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
1801 | VM_ASSERT_EMT(pVM);
|
---|
1802 | LogFlow(("pdmR3DrvHlp_CritSectInit: caller='%s'/%d: pCritSect=%p pszName=%s\n",
|
---|
1803 | pDrvIns->pReg->szName, pDrvIns->iInstance, pCritSect, pszName));
|
---|
1804 |
|
---|
1805 | int rc = pdmR3CritSectInitDriver(pVM, pDrvIns, pCritSect, RT_SRC_POS_ARGS, "%s_%u", pszName, pDrvIns->iInstance);
|
---|
1806 |
|
---|
1807 | LogFlow(("pdmR3DrvHlp_CritSectInit: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName,
|
---|
1808 | pDrvIns->iInstance, rc));
|
---|
1809 | return rc;
|
---|
1810 | }
|
---|
1811 |
|
---|
1812 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectYield} */
|
---|
1813 | static DECLCALLBACK(bool) pdmR3DrvHlp_CritSectYield(PPDMDRVINS pDrvIns, PPDMCRITSECT pCritSect)
|
---|
1814 | {
|
---|
1815 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1816 | RT_NOREF(pDrvIns);
|
---|
1817 | return PDMR3CritSectYield(pDrvIns->Internal.s.pVMR3, pCritSect);
|
---|
1818 | }
|
---|
1819 |
|
---|
1820 |
|
---|
1821 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectEnter} */
|
---|
1822 | static DECLCALLBACK(int) pdmR3DrvHlp_CritSectEnter(PPDMDRVINS pDrvIns, PPDMCRITSECT pCritSect, int rcBusy)
|
---|
1823 | {
|
---|
1824 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1825 | return PDMCritSectEnter(pDrvIns->Internal.s.pVMR3, pCritSect, rcBusy);
|
---|
1826 | }
|
---|
1827 |
|
---|
1828 |
|
---|
1829 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectEnterDebug} */
|
---|
1830 | static DECLCALLBACK(int) pdmR3DrvHlp_CritSectEnterDebug(PPDMDRVINS pDrvIns, PPDMCRITSECT pCritSect, int rcBusy,
|
---|
1831 | RTHCUINTPTR uId, RT_SRC_POS_DECL)
|
---|
1832 | {
|
---|
1833 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1834 | return PDMCritSectEnterDebug(pDrvIns->Internal.s.pVMR3, pCritSect, rcBusy, uId, RT_SRC_POS_ARGS);
|
---|
1835 | }
|
---|
1836 |
|
---|
1837 |
|
---|
1838 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectTryEnter} */
|
---|
1839 | static DECLCALLBACK(int) pdmR3DrvHlp_CritSectTryEnter(PPDMDRVINS pDrvIns, PPDMCRITSECT pCritSect)
|
---|
1840 | {
|
---|
1841 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1842 | return PDMCritSectTryEnter(pDrvIns->Internal.s.pVMR3, pCritSect);
|
---|
1843 | }
|
---|
1844 |
|
---|
1845 |
|
---|
1846 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectTryEnterDebug} */
|
---|
1847 | static DECLCALLBACK(int) pdmR3DrvHlp_CritSectTryEnterDebug(PPDMDRVINS pDrvIns, PPDMCRITSECT pCritSect,
|
---|
1848 | RTHCUINTPTR uId, RT_SRC_POS_DECL)
|
---|
1849 | {
|
---|
1850 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1851 | return PDMCritSectTryEnterDebug(pDrvIns->Internal.s.pVMR3, pCritSect, uId, RT_SRC_POS_ARGS);
|
---|
1852 | }
|
---|
1853 |
|
---|
1854 |
|
---|
1855 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectLeave} */
|
---|
1856 | static DECLCALLBACK(int) pdmR3DrvHlp_CritSectLeave(PPDMDRVINS pDrvIns, PPDMCRITSECT pCritSect)
|
---|
1857 | {
|
---|
1858 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1859 | return PDMCritSectLeave(pDrvIns->Internal.s.pVMR3, pCritSect);
|
---|
1860 | }
|
---|
1861 |
|
---|
1862 |
|
---|
1863 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectIsOwner} */
|
---|
1864 | static DECLCALLBACK(bool) pdmR3DrvHlp_CritSectIsOwner(PPDMDRVINS pDrvIns, PCPDMCRITSECT pCritSect)
|
---|
1865 | {
|
---|
1866 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1867 | return PDMCritSectIsOwner(pDrvIns->Internal.s.pVMR3, pCritSect);
|
---|
1868 | }
|
---|
1869 |
|
---|
1870 |
|
---|
1871 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectIsInitialized} */
|
---|
1872 | static DECLCALLBACK(bool) pdmR3DrvHlp_CritSectIsInitialized(PPDMDRVINS pDrvIns, PCPDMCRITSECT pCritSect)
|
---|
1873 | {
|
---|
1874 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1875 | RT_NOREF(pDrvIns);
|
---|
1876 | return PDMCritSectIsInitialized(pCritSect);
|
---|
1877 | }
|
---|
1878 |
|
---|
1879 |
|
---|
1880 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectHasWaiters} */
|
---|
1881 | static DECLCALLBACK(bool) pdmR3DrvHlp_CritSectHasWaiters(PPDMDRVINS pDrvIns, PCPDMCRITSECT pCritSect)
|
---|
1882 | {
|
---|
1883 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1884 | return PDMCritSectHasWaiters(pDrvIns->Internal.s.pVMR3, pCritSect);
|
---|
1885 | }
|
---|
1886 |
|
---|
1887 |
|
---|
1888 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectGetRecursion} */
|
---|
1889 | static DECLCALLBACK(uint32_t) pdmR3DrvHlp_CritSectGetRecursion(PPDMDRVINS pDrvIns, PCPDMCRITSECT pCritSect)
|
---|
1890 | {
|
---|
1891 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1892 | RT_NOREF(pDrvIns);
|
---|
1893 | return PDMCritSectGetRecursion(pCritSect);
|
---|
1894 | }
|
---|
1895 |
|
---|
1896 |
|
---|
1897 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectScheduleExitEvent} */
|
---|
1898 | static DECLCALLBACK(int) pdmR3DrvHlp_CritSectScheduleExitEvent(PPDMDRVINS pDrvIns, PPDMCRITSECT pCritSect,
|
---|
1899 | SUPSEMEVENT hEventToSignal)
|
---|
1900 | {
|
---|
1901 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1902 | RT_NOREF(pDrvIns);
|
---|
1903 | return PDMHCCritSectScheduleExitEvent(pCritSect, hEventToSignal);
|
---|
1904 | }
|
---|
1905 |
|
---|
1906 |
|
---|
1907 | /** @interface_method_impl{PDMDRVHLPR3,pfnCritSectDelete} */
|
---|
1908 | static DECLCALLBACK(int) pdmR3DrvHlp_CritSectDelete(PPDMDRVINS pDrvIns, PPDMCRITSECT pCritSect)
|
---|
1909 | {
|
---|
1910 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1911 | return PDMR3CritSectDelete(pDrvIns->Internal.s.pVMR3, pCritSect);
|
---|
1912 | }
|
---|
1913 |
|
---|
1914 |
|
---|
1915 | /** @interface_method_impl{PDMDRVHLPR3,pfnCallR0} */
|
---|
1916 | static DECLCALLBACK(int) pdmR3DrvHlp_CallR0(PPDMDRVINS pDrvIns, uint32_t uOperation, uint64_t u64Arg)
|
---|
1917 | {
|
---|
1918 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1919 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
1920 | LogFlow(("pdmR3DrvHlp_CallR0: caller='%s'/%d: uOperation=%#x u64Arg=%#RX64\n",
|
---|
1921 | pDrvIns->pReg->szName, pDrvIns->iInstance, uOperation, u64Arg));
|
---|
1922 |
|
---|
1923 | /*
|
---|
1924 | * Lazy resolve the ring-0 entry point.
|
---|
1925 | */
|
---|
1926 | int rc = VINF_SUCCESS;
|
---|
1927 | PFNPDMDRVREQHANDLERR0 pfnReqHandlerR0 = pDrvIns->Internal.s.pfnReqHandlerR0;
|
---|
1928 | if (RT_UNLIKELY(pfnReqHandlerR0 == NIL_RTR0PTR))
|
---|
1929 | {
|
---|
1930 | if (pDrvIns->pReg->fFlags & PDM_DRVREG_FLAGS_R0)
|
---|
1931 | {
|
---|
1932 | char szSymbol[ sizeof("drvR0") + sizeof(pDrvIns->pReg->szName) + sizeof("ReqHandler")];
|
---|
1933 | strcat(strcat(strcpy(szSymbol, "drvR0"), pDrvIns->pReg->szName), "ReqHandler");
|
---|
1934 | szSymbol[sizeof("drvR0") - 1] = RT_C_TO_UPPER(szSymbol[sizeof("drvR0") - 1]);
|
---|
1935 |
|
---|
1936 | rc = PDMR3LdrGetSymbolR0Lazy(pVM, pDrvIns->pReg->szR0Mod, pDrvIns->Internal.s.pDrv->pszR0SearchPath, szSymbol,
|
---|
1937 | &pfnReqHandlerR0);
|
---|
1938 | if (RT_SUCCESS(rc))
|
---|
1939 | pDrvIns->Internal.s.pfnReqHandlerR0 = pfnReqHandlerR0;
|
---|
1940 | else
|
---|
1941 | pfnReqHandlerR0 = NIL_RTR0PTR;
|
---|
1942 | }
|
---|
1943 | else
|
---|
1944 | rc = VERR_ACCESS_DENIED;
|
---|
1945 | }
|
---|
1946 | if (RT_LIKELY(pfnReqHandlerR0 != NIL_RTR0PTR))
|
---|
1947 | {
|
---|
1948 | /*
|
---|
1949 | * Make the ring-0 call.
|
---|
1950 | */
|
---|
1951 | PDMDRIVERCALLREQHANDLERREQ Req;
|
---|
1952 | Req.Hdr.u32Magic = SUPVMMR0REQHDR_MAGIC;
|
---|
1953 | Req.Hdr.cbReq = sizeof(Req);
|
---|
1954 | Req.pDrvInsR0 = PDMDRVINS_2_R0PTR(pDrvIns);
|
---|
1955 | Req.uOperation = uOperation;
|
---|
1956 | Req.u32Alignment = 0;
|
---|
1957 | Req.u64Arg = u64Arg;
|
---|
1958 | rc = SUPR3CallVMMR0Ex(VMCC_GET_VMR0_FOR_CALL(pVM), NIL_VMCPUID, VMMR0_DO_PDM_DRIVER_CALL_REQ_HANDLER, 0, &Req.Hdr);
|
---|
1959 | }
|
---|
1960 |
|
---|
1961 | LogFlow(("pdmR3DrvHlp_CallR0: caller='%s'/%d: returns %Rrc\n", pDrvIns->pReg->szName,
|
---|
1962 | pDrvIns->iInstance, rc));
|
---|
1963 | return rc;
|
---|
1964 | }
|
---|
1965 |
|
---|
1966 |
|
---|
1967 | /** @interface_method_impl{PDMDRVHLPR3,pfnBlkCacheRetain} */
|
---|
1968 | static DECLCALLBACK(int) pdmR3DrvHlp_BlkCacheRetain(PPDMDRVINS pDrvIns, PPPDMBLKCACHE ppBlkCache,
|
---|
1969 | PFNPDMBLKCACHEXFERCOMPLETEDRV pfnXferComplete,
|
---|
1970 | PFNPDMBLKCACHEXFERENQUEUEDRV pfnXferEnqueue,
|
---|
1971 | PFNPDMBLKCACHEXFERENQUEUEDISCARDDRV pfnXferEnqueueDiscard,
|
---|
1972 | const char *pcszId)
|
---|
1973 | {
|
---|
1974 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1975 | return PDMR3BlkCacheRetainDriver(pDrvIns->Internal.s.pVMR3, pDrvIns, ppBlkCache,
|
---|
1976 | pfnXferComplete, pfnXferEnqueue, pfnXferEnqueueDiscard, pcszId);
|
---|
1977 | }
|
---|
1978 |
|
---|
1979 |
|
---|
1980 |
|
---|
1981 | /** @interface_method_impl{PDMDRVHLPR3,pfnVMGetSuspendReason} */
|
---|
1982 | static DECLCALLBACK(VMSUSPENDREASON) pdmR3DrvHlp_VMGetSuspendReason(PPDMDRVINS pDrvIns)
|
---|
1983 | {
|
---|
1984 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1985 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
1986 | VM_ASSERT_EMT(pVM);
|
---|
1987 | VMSUSPENDREASON enmReason = VMR3GetSuspendReason(pVM->pUVM);
|
---|
1988 | LogFlow(("pdmR3DrvHlp_VMGetSuspendReason: caller='%s'/%d: returns %d\n",
|
---|
1989 | pDrvIns->pReg->szName, pDrvIns->iInstance, enmReason));
|
---|
1990 | return enmReason;
|
---|
1991 | }
|
---|
1992 |
|
---|
1993 |
|
---|
1994 | /** @interface_method_impl{PDMDRVHLPR3,pfnVMGetResumeReason} */
|
---|
1995 | static DECLCALLBACK(VMRESUMEREASON) pdmR3DrvHlp_VMGetResumeReason(PPDMDRVINS pDrvIns)
|
---|
1996 | {
|
---|
1997 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
1998 | PVM pVM = pDrvIns->Internal.s.pVMR3;
|
---|
1999 | VM_ASSERT_EMT(pVM);
|
---|
2000 | VMRESUMEREASON enmReason = VMR3GetResumeReason(pVM->pUVM);
|
---|
2001 | LogFlow(("pdmR3DrvHlp_VMGetResumeReason: caller='%s'/%d: returns %d\n",
|
---|
2002 | pDrvIns->pReg->szName, pDrvIns->iInstance, enmReason));
|
---|
2003 | return enmReason;
|
---|
2004 | }
|
---|
2005 |
|
---|
2006 |
|
---|
2007 | /** @interface_method_impl{PDMDRVHLPR3,pfnQueryGenericUserObject} */
|
---|
2008 | static DECLCALLBACK(void *) pdmR3DrvHlp_QueryGenericUserObject(PPDMDRVINS pDrvIns, PCRTUUID pUuid)
|
---|
2009 | {
|
---|
2010 | PDMDRV_ASSERT_DRVINS(pDrvIns);
|
---|
2011 | LogFlow(("pdmR3DrvHlp_QueryGenericUserObject: caller='%s'/%d: pUuid=%p:%RTuuid\n",
|
---|
2012 | pDrvIns->pReg->szName, pDrvIns->iInstance, pUuid, pUuid));
|
---|
2013 |
|
---|
2014 | void *pvRet;
|
---|
2015 | PUVM pUVM = pDrvIns->Internal.s.pVMR3->pUVM;
|
---|
2016 | if (pUVM->pVmm2UserMethods->pfnQueryGenericObject)
|
---|
2017 | pvRet = pUVM->pVmm2UserMethods->pfnQueryGenericObject(pUVM->pVmm2UserMethods, pUVM, pUuid);
|
---|
2018 | else
|
---|
2019 | pvRet = NULL;
|
---|
2020 |
|
---|
2021 | LogRel(("pdmR3DrvHlp_QueryGenericUserObject: caller='%s'/%d: returns %#p for %RTuuid\n",
|
---|
2022 | pDrvIns->pReg->szName, pDrvIns->iInstance, pvRet, pUuid));
|
---|
2023 | return pvRet;
|
---|
2024 | }
|
---|
2025 |
|
---|
2026 |
|
---|
2027 | /**
|
---|
2028 | * The driver helper structure.
|
---|
2029 | */
|
---|
2030 | const PDMDRVHLPR3 g_pdmR3DrvHlp =
|
---|
2031 | {
|
---|
2032 | PDM_DRVHLPR3_VERSION,
|
---|
2033 | pdmR3DrvHlp_Attach,
|
---|
2034 | pdmR3DrvHlp_Detach,
|
---|
2035 | pdmR3DrvHlp_DetachSelf,
|
---|
2036 | pdmR3DrvHlp_MountPrepare,
|
---|
2037 | pdmR3DrvHlp_AssertEMT,
|
---|
2038 | pdmR3DrvHlp_AssertOther,
|
---|
2039 | pdmR3DrvHlp_VMSetError,
|
---|
2040 | pdmR3DrvHlp_VMSetErrorV,
|
---|
2041 | pdmR3DrvHlp_VMSetRuntimeError,
|
---|
2042 | pdmR3DrvHlp_VMSetRuntimeErrorV,
|
---|
2043 | pdmR3DrvHlp_VMState,
|
---|
2044 | pdmR3DrvHlp_VMTeleportedAndNotFullyResumedYet,
|
---|
2045 | pdmR3DrvHlp_GetSupDrvSession,
|
---|
2046 | pdmR3DrvHlp_QueueCreate,
|
---|
2047 | pdmR3DrvHlp_TMGetVirtualFreq,
|
---|
2048 | pdmR3DrvHlp_TMGetVirtualTime,
|
---|
2049 | pdmR3DrvHlp_TimerCreate,
|
---|
2050 | pdmR3DrvHlp_SSMRegister,
|
---|
2051 | pdmR3DrvHlp_SSMDeregister,
|
---|
2052 | pdmR3DrvHlp_DBGFInfoRegister,
|
---|
2053 | pdmR3DrvHlp_DBGFInfoRegisterArgv,
|
---|
2054 | pdmR3DrvHlp_DBGFInfoDeregister,
|
---|
2055 | pdmR3DrvHlp_STAMRegister,
|
---|
2056 | pdmR3DrvHlp_STAMRegisterF,
|
---|
2057 | pdmR3DrvHlp_STAMRegisterV,
|
---|
2058 | pdmR3DrvHlp_STAMDeregister,
|
---|
2059 | pdmR3DrvHlp_SUPCallVMMR0Ex,
|
---|
2060 | pdmR3DrvHlp_USBRegisterHub,
|
---|
2061 | pdmR3DrvHlp_SetAsyncNotification,
|
---|
2062 | pdmR3DrvHlp_AsyncNotificationCompleted,
|
---|
2063 | pdmR3DrvHlp_ThreadCreate,
|
---|
2064 | pdmR3DrvHlp_AsyncCompletionTemplateCreate,
|
---|
2065 | pdmR3DrvHlp_NetShaperAttach,
|
---|
2066 | pdmR3DrvHlp_NetShaperDetach,
|
---|
2067 | pdmR3DrvHlp_NetShaperAllocateBandwidth,
|
---|
2068 | pdmR3DrvHlp_LdrGetRCInterfaceSymbols,
|
---|
2069 | pdmR3DrvHlp_LdrGetR0InterfaceSymbols,
|
---|
2070 | pdmR3DrvHlp_CritSectInit,
|
---|
2071 | pdmR3DrvHlp_CritSectYield,
|
---|
2072 | pdmR3DrvHlp_CritSectEnter,
|
---|
2073 | pdmR3DrvHlp_CritSectEnterDebug,
|
---|
2074 | pdmR3DrvHlp_CritSectTryEnter,
|
---|
2075 | pdmR3DrvHlp_CritSectTryEnterDebug,
|
---|
2076 | pdmR3DrvHlp_CritSectLeave,
|
---|
2077 | pdmR3DrvHlp_CritSectIsOwner,
|
---|
2078 | pdmR3DrvHlp_CritSectIsInitialized,
|
---|
2079 | pdmR3DrvHlp_CritSectHasWaiters,
|
---|
2080 | pdmR3DrvHlp_CritSectGetRecursion,
|
---|
2081 | pdmR3DrvHlp_CritSectScheduleExitEvent,
|
---|
2082 | pdmR3DrvHlp_CritSectDelete,
|
---|
2083 | pdmR3DrvHlp_CallR0,
|
---|
2084 | pdmR3DrvHlp_BlkCacheRetain,
|
---|
2085 | pdmR3DrvHlp_VMGetSuspendReason,
|
---|
2086 | pdmR3DrvHlp_VMGetResumeReason,
|
---|
2087 | pdmR3DrvHlp_TimerSetMillies,
|
---|
2088 | pdmR3DrvHlp_STAMDeregisterByPrefix,
|
---|
2089 | pdmR3DrvHlp_QueryGenericUserObject,
|
---|
2090 | NULL,
|
---|
2091 | NULL,
|
---|
2092 | NULL,
|
---|
2093 | NULL,
|
---|
2094 | NULL,
|
---|
2095 | NULL,
|
---|
2096 | NULL,
|
---|
2097 | PDM_DRVHLPR3_VERSION /* u32TheEnd */
|
---|
2098 | };
|
---|
2099 |
|
---|
2100 | /** @} */
|
---|