DBGFOS.cpp@ 81150

Last change on this file since 81150 was 80333, checked in by vboxsync, 5 years ago
VMM: Eliminating the VBOX_BUGREF_9217_PART_I preprocessor macro. bugref:9217
Property svn:eol-style set to `native` Property svn:keywords set to `Id Revision`
File size: 20.7 KB

Line
1	/* $Id: DBGFOS.cpp 80333 2019-08-16 20:28:38Z vboxsync $ */
2	/** @file
3	* DBGF - Debugger Facility, Guest OS Diggers.
4	*/
5
6	/*
7	* Copyright (C) 2008-2019 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_DBGF
23	#include <VBox/vmm/dbgf.h>
24	#include <VBox/vmm/mm.h>
25	#include "DBGFInternal.h"
26	#include <VBox/vmm/uvm.h>
27	#include <VBox/err.h>
28	#include <VBox/log.h>
29
30	#include <iprt/assert.h>
31	#include <iprt/thread.h>
32	#include <iprt/param.h>
33
34
35	/*********************************************************************************************************************************
36	* Defined Constants And Macros *
37	*********************************************************************************************************************************/
38
39	#define DBGF_OS_READ_LOCK(pUVM) \
40	do { int rcLock = RTCritSectRwEnterShared(&pUVM->dbgf.s.CritSect); AssertRC(rcLock); } while (0)
41	#define DBGF_OS_READ_UNLOCK(pUVM) \
42	do { int rcLock = RTCritSectRwLeaveShared(&pUVM->dbgf.s.CritSect); AssertRC(rcLock); } while (0)
43
44	#define DBGF_OS_WRITE_LOCK(pUVM) \
45	do { int rcLock = RTCritSectRwEnterExcl(&pUVM->dbgf.s.CritSect); AssertRC(rcLock); } while (0)
46	#define DBGF_OS_WRITE_UNLOCK(pUVM) \
47	do { int rcLock = RTCritSectRwLeaveExcl(&pUVM->dbgf.s.CritSect); AssertRC(rcLock); } while (0)
48
49
50	/*********************************************************************************************************************************
51	* Structures and Typedefs *
52	*********************************************************************************************************************************/
53	/**
54	* EMT interface wrappers.
55	*
56	* The diggers expects to be called on an EMT. To avoid the debugger+Main having
57	*
58	* Since the user (debugger/Main) shouldn't be calling directly into the digger code, but rather
59	*/
60	typedef struct DBGFOSEMTWRAPPER
61	{
62	/** Pointer to the next list entry. */
63	struct DBGFOSEMTWRAPPER *pNext;
64	/** The interface type. */
65	DBGFOSINTERFACE enmIf;
66	/** The digger interface pointer. */
67	union
68	{
69	/** Generic void pointer. */
70	void *pv;
71	/** DBGFOSINTERFACE_DMESG.*/
72	PDBGFOSIDMESG pDmesg;
73	} uDigger;
74	/** The user mode VM handle. */
75	PUVM pUVM;
76	/** The wrapper interface union (consult enmIf). */
77	union
78	{
79	/** DBGFOSINTERFACE_DMESG.*/
80	DBGFOSIDMESG Dmesg;
81	} uWrapper;
82	} DBGFOSEMTWRAPPER;
83	/** Pointer to an EMT interface wrapper. */
84	typedef DBGFOSEMTWRAPPER *PDBGFOSEMTWRAPPER;
85
86
87	/**
88	* Internal init routine called by DBGFR3Init().
89	*
90	* @returns VBox status code.
91	* @param pUVM The user mode VM handle.
92	*/
93	int dbgfR3OSInit(PUVM pUVM)
94	{
95	RT_NOREF_PV(pUVM);
96	return VINF_SUCCESS;
97	}
98
99
100	/**
101	* Internal cleanup routine called by DBGFR3Term(), part 1.
102	*
103	* @param pUVM The user mode VM handle.
104	*/
105	void dbgfR3OSTermPart1(PUVM pUVM)
106	{
107	DBGF_OS_WRITE_LOCK(pUVM);
108
109	/*
110	* Terminate the current one.
111	*/
112	if (pUVM->dbgf.s.pCurOS)
113	{
114	pUVM->dbgf.s.pCurOS->pReg->pfnTerm(pUVM, pUVM->dbgf.s.pCurOS->abData);
115	pUVM->dbgf.s.pCurOS = NULL;
116	}
117
118	DBGF_OS_WRITE_UNLOCK(pUVM);
119	}
120
121
122	/**
123	* Internal cleanup routine called by DBGFR3Term(), part 2.
124	*
125	* @param pUVM The user mode VM handle.
126	*/
127	void dbgfR3OSTermPart2(PUVM pUVM)
128	{
129	DBGF_OS_WRITE_LOCK(pUVM);
130
131	/* This shouldn't happen. */
132	AssertStmt(!pUVM->dbgf.s.pCurOS, dbgfR3OSTermPart1(pUVM));
133
134	/*
135	* Destroy all the instances.
136	*/
137	while (pUVM->dbgf.s.pOSHead)
138	{
139	PDBGFOS pOS = pUVM->dbgf.s.pOSHead;
140	pUVM->dbgf.s.pOSHead = pOS->pNext;
141	if (pOS->pReg->pfnDestruct)
142	pOS->pReg->pfnDestruct(pUVM, pOS->abData);
143
144	PDBGFOSEMTWRAPPER pFree = pOS->pWrapperHead;
145	while ((pFree = pOS->pWrapperHead) != NULL)
146	{
147	pOS->pWrapperHead = pFree->pNext;
148	pFree->pNext = NULL;
149	MMR3HeapFree(pFree);
150	}
151
152	MMR3HeapFree(pOS);
153	}
154
155	DBGF_OS_WRITE_UNLOCK(pUVM);
156	}
157
158
159	/**
160	* EMT worker function for DBGFR3OSRegister.
161	*
162	* @returns VBox status code.
163	* @param pUVM The user mode VM handle.
164	* @param pReg The registration structure.
165	*/
166	static DECLCALLBACK(int) dbgfR3OSRegister(PUVM pUVM, PDBGFOSREG pReg)
167	{
168	/* more validations. */
169	DBGF_OS_READ_LOCK(pUVM);
170	PDBGFOS pOS;
171	for (pOS = pUVM->dbgf.s.pOSHead; pOS; pOS = pOS->pNext)
172	if (!strcmp(pOS->pReg->szName, pReg->szName))
173	{
174	DBGF_OS_READ_UNLOCK(pUVM);
175	Log(("dbgfR3OSRegister: %s -> VERR_ALREADY_LOADED\n", pReg->szName));
176	return VERR_ALREADY_LOADED;
177	}
178	DBGF_OS_READ_UNLOCK(pUVM);
179
180	/*
181	* Allocate a new structure, call the constructor and link it into the list.
182	*/
183	pOS = (PDBGFOS)MMR3HeapAllocZU(pUVM, MM_TAG_DBGF_OS, RT_UOFFSETOF_DYN(DBGFOS, abData[pReg->cbData]));
184	AssertReturn(pOS, VERR_NO_MEMORY);
185	pOS->pReg = pReg;
186
187	int rc = pOS->pReg->pfnConstruct(pUVM, pOS->abData);
188	if (RT_SUCCESS(rc))
189	{
190	DBGF_OS_WRITE_LOCK(pUVM);
191	pOS->pNext = pUVM->dbgf.s.pOSHead;
192	pUVM->dbgf.s.pOSHead = pOS;
193	DBGF_OS_WRITE_UNLOCK(pUVM);
194	}
195	else
196	{
197	if (pOS->pReg->pfnDestruct)
198	pOS->pReg->pfnDestruct(pUVM, pOS->abData);
199	MMR3HeapFree(pOS);
200	}
201
202	return VINF_SUCCESS;
203	}
204
205
206	/**
207	* Registers a guest OS digger.
208	*
209	* This will instantiate an instance of the digger and add it
210	* to the list for us in the next call to DBGFR3OSDetect().
211	*
212	* @returns VBox status code.
213	* @param pUVM The user mode VM handle.
214	* @param pReg The registration structure.
215	* @thread Any.
216	*/
217	VMMR3DECL(int) DBGFR3OSRegister(PUVM pUVM, PCDBGFOSREG pReg)
218	{
219	/*
220	* Validate intput.
221	*/
222	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
223
224	AssertPtrReturn(pReg, VERR_INVALID_POINTER);
225	AssertReturn(pReg->u32Magic == DBGFOSREG_MAGIC, VERR_INVALID_MAGIC);
226	AssertReturn(pReg->u32EndMagic == DBGFOSREG_MAGIC, VERR_INVALID_MAGIC);
227	AssertReturn(!pReg->fFlags, VERR_INVALID_PARAMETER);
228	AssertReturn(pReg->cbData < _2G, VERR_INVALID_PARAMETER);
229	AssertReturn(pReg->szName[0], VERR_INVALID_NAME);
230	AssertReturn(RTStrEnd(&pReg->szName[0], sizeof(pReg->szName)), VERR_INVALID_NAME);
231	AssertPtrReturn(pReg->pfnConstruct, VERR_INVALID_POINTER);
232	AssertPtrNullReturn(pReg->pfnDestruct, VERR_INVALID_POINTER);
233	AssertPtrReturn(pReg->pfnProbe, VERR_INVALID_POINTER);
234	AssertPtrReturn(pReg->pfnInit, VERR_INVALID_POINTER);
235	AssertPtrReturn(pReg->pfnRefresh, VERR_INVALID_POINTER);
236	AssertPtrReturn(pReg->pfnTerm, VERR_INVALID_POINTER);
237	AssertPtrReturn(pReg->pfnQueryVersion, VERR_INVALID_POINTER);
238	AssertPtrReturn(pReg->pfnQueryInterface, VERR_INVALID_POINTER);
239
240	/*
241	* Pass it on to EMT(0).
242	*/
243	return VMR3ReqPriorityCallWaitU(pUVM, 0 /idDstCpu/, (PFNRT)dbgfR3OSRegister, 2, pUVM, pReg);
244	}
245
246
247	/**
248	* EMT worker function for DBGFR3OSDeregister.
249	*
250	* @returns VBox status code.
251	* @param pUVM The user mode VM handle.
252	* @param pReg The registration structure.
253	*/
254	static DECLCALLBACK(int) dbgfR3OSDeregister(PUVM pUVM, PDBGFOSREG pReg)
255	{
256	/*
257	* Unlink it.
258	*/
259	bool fWasCurOS = false;
260	PDBGFOS pOSPrev = NULL;
261	PDBGFOS pOS;
262	DBGF_OS_WRITE_LOCK(pUVM);
263	for (pOS = pUVM->dbgf.s.pOSHead; pOS; pOSPrev = pOS, pOS = pOS->pNext)
264	if (pOS->pReg == pReg)
265	{
266	if (pOSPrev)
267	pOSPrev->pNext = pOS->pNext;
268	else
269	pUVM->dbgf.s.pOSHead = pOS->pNext;
270	if (pUVM->dbgf.s.pCurOS == pOS)
271	{
272	pUVM->dbgf.s.pCurOS = NULL;
273	fWasCurOS = true;
274	}
275	break;
276	}
277	DBGF_OS_WRITE_UNLOCK(pUVM);
278	if (!pOS)
279	{
280	Log(("DBGFR3OSDeregister: %s -> VERR_NOT_FOUND\n", pReg->szName));
281	return VERR_NOT_FOUND;
282	}
283
284	/*
285	* Terminate it if it was the current OS, then invoke the
286	* destructor and clean up.
287	*/
288	if (fWasCurOS)
289	pOS->pReg->pfnTerm(pUVM, pOS->abData);
290	if (pOS->pReg->pfnDestruct)
291	pOS->pReg->pfnDestruct(pUVM, pOS->abData);
292
293	PDBGFOSEMTWRAPPER pFree = pOS->pWrapperHead;
294	while ((pFree = pOS->pWrapperHead) != NULL)
295	{
296	pOS->pWrapperHead = pFree->pNext;
297	pFree->pNext = NULL;
298	MMR3HeapFree(pFree);
299	}
300
301	MMR3HeapFree(pOS);
302
303	return VINF_SUCCESS;
304	}
305
306
307	/**
308	* Deregisters a guest OS digger previously registered by DBGFR3OSRegister.
309	*
310	* @returns VBox status code.
311	*
312	* @param pUVM The user mode VM handle.
313	* @param pReg The registration structure.
314	* @thread Any.
315	*/
316	VMMR3DECL(int) DBGFR3OSDeregister(PUVM pUVM, PCDBGFOSREG pReg)
317	{
318	/*
319	* Validate input.
320	*/
321	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
322	AssertPtrReturn(pReg, VERR_INVALID_POINTER);
323	AssertReturn(pReg->u32Magic == DBGFOSREG_MAGIC, VERR_INVALID_MAGIC);
324	AssertReturn(pReg->u32EndMagic == DBGFOSREG_MAGIC, VERR_INVALID_MAGIC);
325	AssertReturn(RTStrEnd(&pReg->szName[0], sizeof(pReg->szName)), VERR_INVALID_NAME);
326
327	DBGF_OS_READ_LOCK(pUVM);
328	PDBGFOS pOS;
329	for (pOS = pUVM->dbgf.s.pOSHead; pOS; pOS = pOS->pNext)
330	if (pOS->pReg == pReg)
331	break;
332	DBGF_OS_READ_UNLOCK(pUVM);
333
334	if (!pOS)
335	{
336	Log(("DBGFR3OSDeregister: %s -> VERR_NOT_FOUND\n", pReg->szName));
337	return VERR_NOT_FOUND;
338	}
339
340	/*
341	* Pass it on to EMT(0).
342	*/
343	return VMR3ReqPriorityCallWaitU(pUVM, 0 /idDstCpu/, (PFNRT)dbgfR3OSDeregister, 2, pUVM, pReg);
344	}
345
346
347	/**
348	* EMT worker function for DBGFR3OSDetect.
349	*
350	* @returns VBox status code.
351	* @retval VINF_SUCCESS if successfully detected.
352	* @retval VINF_DBGF_OS_NOT_DETCTED if we cannot figure it out.
353	*
354	* @param pUVM The user mode VM handle.
355	* @param pszName Where to store the OS name. Empty string if not detected.
356	* @param cchName Size of the buffer.
357	*/
358	static DECLCALLBACK(int) dbgfR3OSDetect(PUVM pUVM, char *pszName, size_t cchName)
359	{
360	/*
361	* Cycle thru the detection routines.
362	*/
363	DBGF_OS_WRITE_LOCK(pUVM);
364
365	PDBGFOS const pOldOS = pUVM->dbgf.s.pCurOS;
366	pUVM->dbgf.s.pCurOS = NULL;
367
368	for (PDBGFOS pNewOS = pUVM->dbgf.s.pOSHead; pNewOS; pNewOS = pNewOS->pNext)
369	if (pNewOS->pReg->pfnProbe(pUVM, pNewOS->abData))
370	{
371	int rc;
372	pUVM->dbgf.s.pCurOS = pNewOS;
373	if (pOldOS == pNewOS)
374	rc = pNewOS->pReg->pfnRefresh(pUVM, pNewOS->abData);
375	else
376	{
377	if (pOldOS)
378	pOldOS->pReg->pfnTerm(pUVM, pNewOS->abData);
379	rc = pNewOS->pReg->pfnInit(pUVM, pNewOS->abData);
380	}
381	if (pszName && cchName)
382	strncat(pszName, pNewOS->pReg->szName, cchName);
383
384	DBGF_OS_WRITE_UNLOCK(pUVM);
385	return rc;
386	}
387
388	/* not found */
389	if (pOldOS)
390	pOldOS->pReg->pfnTerm(pUVM, pOldOS->abData);
391
392	DBGF_OS_WRITE_UNLOCK(pUVM);
393	return VINF_DBGF_OS_NOT_DETCTED;
394	}
395
396
397	/**
398	* Detects the guest OS and try dig out symbols and useful stuff.
399	*
400	* When called the 2nd time, symbols will be updated that if the OS
401	* is the same.
402	*
403	* @returns VBox status code.
404	* @retval VINF_SUCCESS if successfully detected.
405	* @retval VINF_DBGF_OS_NOT_DETCTED if we cannot figure it out.
406	*
407	* @param pUVM The user mode VM handle.
408	* @param pszName Where to store the OS name. Empty string if not detected.
409	* @param cchName Size of the buffer.
410	* @thread Any.
411	*/
412	VMMR3DECL(int) DBGFR3OSDetect(PUVM pUVM, char *pszName, size_t cchName)
413	{
414	AssertPtrNullReturn(pszName, VERR_INVALID_POINTER);
415	if (pszName && cchName)
416	*pszName = '\0';
417	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
418
419	/*
420	* Pass it on to EMT(0).
421	*/
422	return VMR3ReqPriorityCallWaitU(pUVM, 0 /idDstCpu/, (PFNRT)dbgfR3OSDetect, 3, pUVM, pszName, cchName);
423	}
424
425
426	/**
427	* EMT worker function for DBGFR3OSQueryNameAndVersion
428	*
429	* @returns VBox status code.
430	* @param pUVM The user mode VM handle.
431	* @param pszName Where to store the OS name. Optional.
432	* @param cchName The size of the name buffer.
433	* @param pszVersion Where to store the version string. Optional.
434	* @param cchVersion The size of the version buffer.
435	*/
436	static DECLCALLBACK(int) dbgfR3OSQueryNameAndVersion(PUVM pUVM, char pszName, size_t cchName, char pszVersion, size_t cchVersion)
437	{
438	/*
439	* Any known OS?
440	*/
441	DBGF_OS_READ_LOCK(pUVM);
442
443	if (pUVM->dbgf.s.pCurOS)
444	{
445	int rc = VINF_SUCCESS;
446	if (pszName && cchName)
447	{
448	size_t cch = strlen(pUVM->dbgf.s.pCurOS->pReg->szName);
449	if (cchName > cch)
450	memcpy(pszName, pUVM->dbgf.s.pCurOS->pReg->szName, cch + 1);
451	else
452	{
453	memcpy(pszName, pUVM->dbgf.s.pCurOS->pReg->szName, cchName - 1);
454	pszName[cchName - 1] = '\0';
455	rc = VINF_BUFFER_OVERFLOW;
456	}
457	}
458
459	if (pszVersion && cchVersion)
460	{
461	int rc2 = pUVM->dbgf.s.pCurOS->pReg->pfnQueryVersion(pUVM, pUVM->dbgf.s.pCurOS->abData, pszVersion, cchVersion);
462	if (RT_FAILURE(rc2) \|\| rc == VINF_SUCCESS)
463	rc = rc2;
464	}
465
466	DBGF_OS_READ_UNLOCK(pUVM);
467	return rc;
468	}
469
470	DBGF_OS_READ_UNLOCK(pUVM);
471	return VERR_DBGF_OS_NOT_DETCTED;
472	}
473
474
475	/**
476	* Queries the name and/or version string for the guest OS.
477	*
478	* It goes without saying that this querying is done using the current
479	* guest OS digger and not additions or user configuration.
480	*
481	* @returns VBox status code.
482	* @param pUVM The user mode VM handle.
483	* @param pszName Where to store the OS name. Optional.
484	* @param cchName The size of the name buffer.
485	* @param pszVersion Where to store the version string. Optional.
486	* @param cchVersion The size of the version buffer.
487	* @thread Any.
488	*/
489	VMMR3DECL(int) DBGFR3OSQueryNameAndVersion(PUVM pUVM, char pszName, size_t cchName, char pszVersion, size_t cchVersion)
490	{
491	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
492	AssertPtrNullReturn(pszName, VERR_INVALID_POINTER);
493	AssertPtrNullReturn(pszVersion, VERR_INVALID_POINTER);
494
495	/*
496	* Initialize the output up front.
497	*/
498	if (pszName && cchName)
499	*pszName = '\0';
500	if (pszVersion && cchVersion)
501	*pszVersion = '\0';
502
503	/*
504	* Pass it on to EMT(0).
505	*/
506	return VMR3ReqPriorityCallWaitU(pUVM, 0 /idDstCpu/,
507	(PFNRT)dbgfR3OSQueryNameAndVersion, 5, pUVM, pszName, cchName, pszVersion, cchVersion);
508	}
509
510
511	/**
512	* @interface_method_impl{DBGFOSIDMESG,pfnQueryKernelLog, Generic EMT wrapper.}
513	*/
514	static DECLCALLBACK(int) dbgfR3OSEmtIDmesg_QueryKernelLog(PDBGFOSIDMESG pThis, PUVM pUVM, uint32_t fFlags, uint32_t cMessages,
515	char pszBuf, size_t cbBuf, size_t pcbActual)
516	{
517	PDBGFOSEMTWRAPPER pWrapper = RT_FROM_MEMBER(pThis, DBGFOSEMTWRAPPER, uWrapper.Dmesg);
518	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
519	AssertReturn(pUVM == pWrapper->pUVM, VERR_INVALID_VM_HANDLE);
520	AssertReturn(!fFlags, VERR_INVALID_FLAGS);
521	AssertReturn(cMessages > 0, VERR_INVALID_PARAMETER);
522	if (cbBuf)
523	AssertPtrReturn(pszBuf, VERR_INVALID_POINTER);
524	AssertPtrNullReturn(pcbActual, VERR_INVALID_POINTER);
525
526	return VMR3ReqPriorityCallWaitU(pWrapper->pUVM, 0 /idDstCpu/,
527	(PFNRT)pWrapper->uDigger.pDmesg->pfnQueryKernelLog, 7,
528	pWrapper->uDigger.pDmesg, pUVM, fFlags, cMessages, pszBuf, cbBuf, pcbActual);
529
530	}
531
532
533	/**
534	* EMT worker for DBGFR3OSQueryInterface.
535	*
536	* @param pUVM The user mode VM handle.
537	* @param enmIf The interface identifier.
538	* @param ppvIf Where to store the interface pointer on success.
539	*/
540	static DECLCALLBACK(void) dbgfR3OSQueryInterface(PUVM pUVM, DBGFOSINTERFACE enmIf, void **ppvIf)
541	{
542	AssertPtrReturnVoid(ppvIf);
543	*ppvIf = NULL;
544	AssertReturnVoid(enmIf > DBGFOSINTERFACE_INVALID && enmIf < DBGFOSINTERFACE_END);
545	UVM_ASSERT_VALID_EXT_RETURN_VOID(pUVM);
546
547	/*
548	* Forward the query to the current OS.
549	*/
550	DBGF_OS_READ_LOCK(pUVM);
551	PDBGFOS pOS = pUVM->dbgf.s.pCurOS;
552	if (pOS)
553	{
554	void *pvDiggerIf;
555	pvDiggerIf = pOS->pReg->pfnQueryInterface(pUVM, pUVM->dbgf.s.pCurOS->abData, enmIf);
556	if (pvDiggerIf)
557	{
558	/*
559	* Do we have an EMT wrapper for this interface already?
560	*
561	* We ASSUME the interfaces are static and not dynamically allocated
562	* for each QueryInterface call.
563	*/
564	PDBGFOSEMTWRAPPER pWrapper = pOS->pWrapperHead;
565	while ( pWrapper != NULL
566	&& ( pWrapper->uDigger.pv != pvDiggerIf
567	&& pWrapper->enmIf != enmIf) )
568	pWrapper = pWrapper->pNext;
569	if (pWrapper)
570	{
571	*ppvIf = &pWrapper->uWrapper;
572	DBGF_OS_READ_UNLOCK(pUVM);
573	return;
574	}
575	DBGF_OS_READ_UNLOCK(pUVM);
576
577	/*
578	* Create a wrapper.
579	*/
580	int rc = MMR3HeapAllocExU(pUVM, MM_TAG_DBGF_OS, sizeof(pWrapper), (void *)&pWrapper);
581	if (RT_FAILURE(rc))
582	return;
583	pWrapper->uDigger.pv = pvDiggerIf;
584	pWrapper->pUVM = pUVM;
585	pWrapper->enmIf = enmIf;
586	switch (enmIf)
587	{
588	case DBGFOSINTERFACE_DMESG:
589	pWrapper->uWrapper.Dmesg.u32Magic = DBGFOSIDMESG_MAGIC;
590	pWrapper->uWrapper.Dmesg.pfnQueryKernelLog = dbgfR3OSEmtIDmesg_QueryKernelLog;
591	pWrapper->uWrapper.Dmesg.u32EndMagic = DBGFOSIDMESG_MAGIC;
592	break;
593	default:
594	AssertFailed();
595	MMR3HeapFree(pWrapper);
596	return;
597	}
598
599	DBGF_OS_WRITE_LOCK(pUVM);
600	if (pUVM->dbgf.s.pCurOS == pOS)
601	{
602	pWrapper->pNext = pOS->pWrapperHead;
603	pOS->pWrapperHead = pWrapper;
604	*ppvIf = &pWrapper->uWrapper;
605	DBGF_OS_WRITE_UNLOCK(pUVM);
606	}
607	else
608	{
609	DBGF_OS_WRITE_UNLOCK(pUVM);
610	MMR3HeapFree(pWrapper);
611	}
612	return;
613	}
614	}
615	DBGF_OS_READ_UNLOCK(pUVM);
616	}
617
618
619	/**
620	* Query an optional digger interface.
621	*
622	* @returns Pointer to the digger interface on success, NULL if the interfaces isn't
623	* available or no active guest OS digger.
624	* @param pUVM The user mode VM handle.
625	* @param enmIf The interface identifier.
626	* @thread Any.
627	*/
628	VMMR3DECL(void *) DBGFR3OSQueryInterface(PUVM pUVM, DBGFOSINTERFACE enmIf)
629	{
630	AssertMsgReturn(enmIf > DBGFOSINTERFACE_INVALID && enmIf < DBGFOSINTERFACE_END, ("%d\n", enmIf), NULL);
631
632	/*
633	* Pass it on to an EMT.
634	*/
635	void *pvIf = NULL;
636	VMR3ReqPriorityCallVoidWaitU(pUVM, VMCPUID_ANY, (PFNRT)dbgfR3OSQueryInterface, 3, pUVM, enmIf, &pvIf);
637	return pvIf;
638	}
639
640
641
642	/**
643	* Internal wrapper for calling DBGFOSREG::pfnStackUnwindAssist.
644	*/
645	int dbgfR3OSStackUnwindAssist(PUVM pUVM, VMCPUID idCpu, PDBGFSTACKFRAME pFrame, PRTDBGUNWINDSTATE pState,
646	PCCPUMCTX pInitialCtx, RTDBGAS hAs, uint64_t *puScratch)
647	{
648	int rc = VINF_SUCCESS;
649	if (pUVM->dbgf.s.pCurOS)
650	{
651	ASMCompilerBarrier();
652	DBGF_OS_READ_LOCK(pUVM);
653	PDBGFOS pOS = pUVM->dbgf.s.pCurOS;
654	if (pOS)
655	rc = pOS->pReg->pfnStackUnwindAssist(pUVM, pUVM->dbgf.s.pCurOS->abData, idCpu, pFrame,
656	pState, pInitialCtx, hAs, puScratch);
657	DBGF_OS_READ_UNLOCK(pUVM);
658	}
659	return rc;
660	}
661

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/src/VBox/VMM/VMMR3/DBGFOS.cpp@ 81150

Download in other formats: