DBGFAddrSpace.cpp@ 59140

Last change on this file since 59140 was 57358, checked in by vboxsync, 9 years ago
*: scm cleanup run.
Property svn:eol-style set to `native` Property svn:keywords set to `Id Revision`
File size: 45.4 KB

Line
1	/* $Id: DBGFAddrSpace.cpp 57358 2015-08-14 15:16:38Z vboxsync $ */
2	/** @file
3	* DBGF - Debugger Facility, Address Space Management.
4	*/
5
6	/*
7	* Copyright (C) 2008-2015 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	/** @page pg_dbgf_addr_space DBGFAddrSpace - Address Space Management
20	*
21	* What's an address space? It's mainly a convenient way of stuffing
22	* module segments and ad-hoc symbols together. It will also help out
23	* when the debugger gets extended to deal with user processes later.
24	*
25	* There are two standard address spaces that will always be present:
26	* - The physical address space.
27	* - The global virtual address space.
28	*
29	* Additional address spaces will be added and removed at runtime for
30	* guest processes. The global virtual address space will be used to
31	* track the kernel parts of the OS, or at least the bits of the kernel
32	* that is part of all address spaces (mac os x and 4G/4G patched linux).
33	*
34	*/
35
36
37	/*********************************************************************************************************************************
38	* Header Files *
39	*********************************************************************************************************************************/
40	#define LOG_GROUP LOG_GROUP_DBGF
41	#include <VBox/vmm/dbgf.h>
42	#include <VBox/vmm/hm.h>
43	#include <VBox/vmm/pdmapi.h>
44	#include <VBox/vmm/mm.h>
45	#ifdef VBOX_WITH_RAW_MODE
46	# include <VBox/vmm/patm.h>
47	#endif
48	#include "DBGFInternal.h"
49	#include <VBox/vmm/uvm.h>
50	#include <VBox/vmm/vm.h>
51	#include <VBox/err.h>
52	#include <VBox/log.h>
53
54	#include <iprt/asm.h>
55	#include <iprt/assert.h>
56	#include <iprt/ctype.h>
57	#include <iprt/env.h>
58	#include <iprt/mem.h>
59	#include <iprt/path.h>
60	#include <iprt/param.h>
61
62
63	/*********************************************************************************************************************************
64	* Structures and Typedefs *
65	*********************************************************************************************************************************/
66	/**
67	* Address space database node.
68	*/
69	typedef struct DBGFASDBNODE
70	{
71	/** The node core for DBGF::AsHandleTree, the key is the address space handle. */
72	AVLPVNODECORE HandleCore;
73	/** The node core for DBGF::AsPidTree, the key is the process id. */
74	AVLU32NODECORE PidCore;
75	/** The node core for DBGF::AsNameSpace, the string is the address space name. */
76	RTSTRSPACECORE NameCore;
77
78	} DBGFASDBNODE;
79	/** Pointer to an address space database node. */
80	typedef DBGFASDBNODE *PDBGFASDBNODE;
81
82
83	/**
84	* For dbgfR3AsLoadImageOpenData and dbgfR3AsLoadMapOpenData.
85	*/
86	typedef struct DBGFR3ASLOADOPENDATA
87	{
88	const char *pszModName;
89	RTGCUINTPTR uSubtrahend;
90	uint32_t fFlags;
91	RTDBGMOD hMod;
92	} DBGFR3ASLOADOPENDATA;
93
94	/**
95	* Callback for dbgfR3AsSearchPath and dbgfR3AsSearchEnvPath.
96	*
97	* @returns VBox status code. If success, then the search is completed.
98	* @param pszFilename The file name under evaluation.
99	* @param pvUser The user argument.
100	*/
101	typedef int FNDBGFR3ASSEARCHOPEN(const char pszFilename, void pvUser);
102	/** Pointer to a FNDBGFR3ASSEARCHOPEN. */
103	typedef FNDBGFR3ASSEARCHOPEN *PFNDBGFR3ASSEARCHOPEN;
104
105
106	/*********************************************************************************************************************************
107	* Defined Constants And Macros *
108	*********************************************************************************************************************************/
109	/** Locks the address space database for writing. */
110	#define DBGF_AS_DB_LOCK_WRITE(pUVM) \
111	do { \
112	int rcSem = RTSemRWRequestWrite((pUVM)->dbgf.s.hAsDbLock, RT_INDEFINITE_WAIT); \
113	AssertRC(rcSem); \
114	} while (0)
115
116	/** Unlocks the address space database after writing. */
117	#define DBGF_AS_DB_UNLOCK_WRITE(pUVM) \
118	do { \
119	int rcSem = RTSemRWReleaseWrite((pUVM)->dbgf.s.hAsDbLock); \
120	AssertRC(rcSem); \
121	} while (0)
122
123	/** Locks the address space database for reading. */
124	#define DBGF_AS_DB_LOCK_READ(pUVM) \
125	do { \
126	int rcSem = RTSemRWRequestRead((pUVM)->dbgf.s.hAsDbLock, RT_INDEFINITE_WAIT); \
127	AssertRC(rcSem); \
128	} while (0)
129
130	/** Unlocks the address space database after reading. */
131	#define DBGF_AS_DB_UNLOCK_READ(pUVM) \
132	do { \
133	int rcSem = RTSemRWReleaseRead((pUVM)->dbgf.s.hAsDbLock); \
134	AssertRC(rcSem); \
135	} while (0)
136
137
138
139	/**
140	* Initializes the address space parts of DBGF.
141	*
142	* @returns VBox status code.
143	* @param pUVM The user mode VM handle.
144	*/
145	int dbgfR3AsInit(PUVM pUVM)
146	{
147	Assert(pUVM->pVM);
148
149	/*
150	* Create the semaphore.
151	*/
152	int rc = RTSemRWCreate(&pUVM->dbgf.s.hAsDbLock);
153	AssertRCReturn(rc, rc);
154
155	/*
156	* Create the debugging config instance and set it up, defaulting to
157	* deferred loading in order to keep things fast.
158	*/
159	rc = RTDbgCfgCreate(&pUVM->dbgf.s.hDbgCfg, NULL, true /fNativePaths/);
160	AssertRCReturn(rc, rc);
161	rc = RTDbgCfgChangeUInt(pUVM->dbgf.s.hDbgCfg, RTDBGCFGPROP_FLAGS, RTDBGCFGOP_PREPEND,
162	RTDBGCFG_FLAGS_DEFERRED);
163	AssertRCReturn(rc, rc);
164
165	static struct
166	{
167	RTDBGCFGPROP enmProp;
168	const char *pszEnvName;
169	const char *pszCfgName;
170	} const s_aProps[] =
171	{
172	{ RTDBGCFGPROP_FLAGS, "VBOXDBG_FLAGS", "Flags" },
173	{ RTDBGCFGPROP_PATH, "VBOXDBG_PATH", "Path" },
174	{ RTDBGCFGPROP_SUFFIXES, "VBOXDBG_SUFFIXES", "Suffixes" },
175	{ RTDBGCFGPROP_SRC_PATH, "VBOXDBG_SRC_PATH", "SrcPath" },
176	};
177	PCFGMNODE pCfgDbgf = CFGMR3GetChild(CFGMR3GetRootU(pUVM), "/DBGF");
178	for (unsigned i = 0; i < RT_ELEMENTS(s_aProps); i++)
179	{
180	char szEnvValue[8192];
181	rc = RTEnvGetEx(RTENV_DEFAULT, s_aProps[i].pszEnvName, szEnvValue, sizeof(szEnvValue), NULL);
182	if (RT_SUCCESS(rc))
183	{
184	rc = RTDbgCfgChangeString(pUVM->dbgf.s.hDbgCfg, s_aProps[i].enmProp, RTDBGCFGOP_PREPEND, szEnvValue);
185	if (RT_FAILURE(rc))
186	return VMR3SetError(pUVM, rc, RT_SRC_POS,
187	"DBGF Config Error: %s=%s -> %Rrc", s_aProps[i].pszEnvName, szEnvValue, rc);
188	}
189	else if (rc != VERR_ENV_VAR_NOT_FOUND)
190	return VMR3SetError(pUVM, rc, RT_SRC_POS,
191	"DBGF Config Error: Error querying env.var. %s: %Rrc", s_aProps[i].pszEnvName, rc);
192
193	char *pszCfgValue;
194	rc = CFGMR3QueryStringAllocDef(pCfgDbgf, s_aProps[i].pszCfgName, &pszCfgValue, NULL);
195	if (RT_FAILURE(rc))
196	return VMR3SetError(pUVM, rc, RT_SRC_POS,
197	"DBGF Config Error: Querying /DBGF/%s -> %Rrc", s_aProps[i].pszCfgName, rc);
198	if (pszCfgValue)
199	{
200	rc = RTDbgCfgChangeString(pUVM->dbgf.s.hDbgCfg, s_aProps[i].enmProp, RTDBGCFGOP_PREPEND, pszCfgValue);
201	if (RT_FAILURE(rc))
202	return VMR3SetError(pUVM, rc, RT_SRC_POS,
203	"DBGF Config Error: /DBGF/%s=%s -> %Rrc", s_aProps[i].pszCfgName, pszCfgValue, rc);
204	}
205	}
206
207	/*
208	* Prepend the NoArch and VBoxDbgSyms directories to the path.
209	*/
210	char szPath[RTPATH_MAX];
211	rc = RTPathAppPrivateNoArch(szPath, sizeof(szPath));
212	AssertRCReturn(rc, rc);
213	#ifdef RT_OS_DARWIN
214	rc = RTPathAppend(szPath, sizeof(szPath), "../Resources/VBoxDbgSyms/");
215	#else
216	rc = RTDbgCfgChangeString(pUVM->dbgf.s.hDbgCfg, RTDBGCFGPROP_PATH, RTDBGCFGOP_PREPEND, szPath);
217	AssertRCReturn(rc, rc);
218
219	rc = RTPathAppend(szPath, sizeof(szPath), "VBoxDbgSyms/");
220	#endif
221	AssertRCReturn(rc, rc);
222	rc = RTDbgCfgChangeString(pUVM->dbgf.s.hDbgCfg, RTDBGCFGPROP_PATH, RTDBGCFGOP_PREPEND, szPath);
223	AssertRCReturn(rc, rc);
224
225	/*
226	* Create the standard address spaces.
227	*/
228	RTDBGAS hDbgAs;
229	rc = RTDbgAsCreate(&hDbgAs, 0, RTGCPTR_MAX, "Global");
230	AssertRCReturn(rc, rc);
231	rc = DBGFR3AsAdd(pUVM, hDbgAs, NIL_RTPROCESS);
232	AssertRCReturn(rc, rc);
233	RTDbgAsRetain(hDbgAs);
234	pUVM->dbgf.s.ahAsAliases[DBGF_AS_ALIAS_2_INDEX(DBGF_AS_GLOBAL)] = hDbgAs;
235
236	RTDbgAsRetain(hDbgAs);
237	pUVM->dbgf.s.ahAsAliases[DBGF_AS_ALIAS_2_INDEX(DBGF_AS_KERNEL)] = hDbgAs;
238
239	rc = RTDbgAsCreate(&hDbgAs, 0, RTGCPHYS_MAX, "Physical");
240	AssertRCReturn(rc, rc);
241	rc = DBGFR3AsAdd(pUVM, hDbgAs, NIL_RTPROCESS);
242	AssertRCReturn(rc, rc);
243	RTDbgAsRetain(hDbgAs);
244	pUVM->dbgf.s.ahAsAliases[DBGF_AS_ALIAS_2_INDEX(DBGF_AS_PHYS)] = hDbgAs;
245
246	rc = RTDbgAsCreate(&hDbgAs, 0, RTRCPTR_MAX, "HyperRawMode");
247	AssertRCReturn(rc, rc);
248	rc = DBGFR3AsAdd(pUVM, hDbgAs, NIL_RTPROCESS);
249	AssertRCReturn(rc, rc);
250	RTDbgAsRetain(hDbgAs);
251	pUVM->dbgf.s.ahAsAliases[DBGF_AS_ALIAS_2_INDEX(DBGF_AS_RC)] = hDbgAs;
252	RTDbgAsRetain(hDbgAs);
253	pUVM->dbgf.s.ahAsAliases[DBGF_AS_ALIAS_2_INDEX(DBGF_AS_RC_AND_GC_GLOBAL)] = hDbgAs;
254
255	rc = RTDbgAsCreate(&hDbgAs, 0, RTR0PTR_MAX, "HyperRing0");
256	AssertRCReturn(rc, rc);
257	rc = DBGFR3AsAdd(pUVM, hDbgAs, NIL_RTPROCESS);
258	AssertRCReturn(rc, rc);
259	RTDbgAsRetain(hDbgAs);
260	pUVM->dbgf.s.ahAsAliases[DBGF_AS_ALIAS_2_INDEX(DBGF_AS_R0)] = hDbgAs;
261
262	return VINF_SUCCESS;
263	}
264
265
266	/**
267	* Callback used by dbgfR3AsTerm / RTAvlPVDestroy to release an address space.
268	*
269	* @returns 0.
270	* @param pNode The address space database node.
271	* @param pvIgnore NULL.
272	*/
273	static DECLCALLBACK(int) dbgfR3AsTermDestroyNode(PAVLPVNODECORE pNode, void *pvIgnore)
274	{
275	PDBGFASDBNODE pDbNode = (PDBGFASDBNODE)pNode;
276	RTDbgAsRelease((RTDBGAS)pDbNode->HandleCore.Key);
277	pDbNode->HandleCore.Key = NIL_RTDBGAS;
278	/* Don't bother freeing it here as MM will free it soon and MM is much at
279	it when doing it wholesale instead of piecemeal. */
280	NOREF(pvIgnore);
281	return 0;
282	}
283
284
285	/**
286	* Terminates the address space parts of DBGF.
287	*
288	* @param pUVM The user mode VM handle.
289	*/
290	void dbgfR3AsTerm(PUVM pUVM)
291	{
292	/*
293	* Create the semaphore.
294	*/
295	int rc = RTSemRWDestroy(pUVM->dbgf.s.hAsDbLock);
296	AssertRC(rc);
297	pUVM->dbgf.s.hAsDbLock = NIL_RTSEMRW;
298
299	/*
300	* Release all the address spaces.
301	*/
302	RTAvlPVDestroy(&pUVM->dbgf.s.AsHandleTree, dbgfR3AsTermDestroyNode, NULL);
303	for (size_t i = 0; i < RT_ELEMENTS(pUVM->dbgf.s.ahAsAliases); i++)
304	{
305	RTDbgAsRelease(pUVM->dbgf.s.ahAsAliases[i]);
306	pUVM->dbgf.s.ahAsAliases[i] = NIL_RTDBGAS;
307	}
308	}
309
310
311	/**
312	* Relocates the RC address space.
313	*
314	* @param pUVM The user mode VM handle.
315	* @param offDelta The relocation delta.
316	*/
317	void dbgfR3AsRelocate(PUVM pUVM, RTGCUINTPTR offDelta)
318	{
319	/*
320	* We will relocate the raw-mode context modules by offDelta if they have
321	* been injected into the the DBGF_AS_RC map.
322	*/
323	if ( pUVM->dbgf.s.afAsAliasPopuplated[DBGF_AS_ALIAS_2_INDEX(DBGF_AS_RC)]
324	&& offDelta != 0)
325	{
326	RTDBGAS hAs = pUVM->dbgf.s.ahAsAliases[DBGF_AS_ALIAS_2_INDEX(DBGF_AS_RC)];
327
328	/* Take a snapshot of the modules as we might have overlapping
329	addresses between the previous and new mapping. */
330	RTDbgAsLockExcl(hAs);
331	uint32_t cModules = RTDbgAsModuleCount(hAs);
332	if (cModules > 0 && cModules < _4K)
333	{
334	struct DBGFASRELOCENTRY
335	{
336	RTDBGMOD hDbgMod;
337	RTRCPTR uOldAddr;
338	} paEntries = (struct DBGFASRELOCENTRY )RTMemTmpAllocZ(sizeof(paEntries[0]) * cModules);
339	if (paEntries)
340	{
341	/* Snapshot. */
342	for (uint32_t i = 0; i < cModules; i++)
343	{
344	paEntries[i].hDbgMod = RTDbgAsModuleByIndex(hAs, i);
345	AssertLogRelMsg(paEntries[i].hDbgMod != NIL_RTDBGMOD, ("iModule=%#x\n", i));
346
347	RTDBGASMAPINFO aMappings[1] = { { 0, 0 } };
348	uint32_t cMappings = 1;
349	int rc = RTDbgAsModuleQueryMapByIndex(hAs, i, &aMappings[0], &cMappings, 0 /fFlags/);
350	if (RT_SUCCESS(rc) && cMappings == 1 && aMappings[0].iSeg == NIL_RTDBGSEGIDX)
351	paEntries[i].uOldAddr = (RTRCPTR)aMappings[0].Address;
352	else
353	AssertLogRelMsgFailed(("iModule=%#x rc=%Rrc cMappings=%#x.\n", i, rc, cMappings));
354	}
355
356	/* Unlink them. */
357	for (uint32_t i = 0; i < cModules; i++)
358	{
359	int rc = RTDbgAsModuleUnlink(hAs, paEntries[i].hDbgMod);
360	AssertLogRelMsg(RT_SUCCESS(rc), ("iModule=%#x rc=%Rrc hDbgMod=%p\n", i, rc, paEntries[i].hDbgMod));
361	}
362
363	/* Link them at the new locations. */
364	for (uint32_t i = 0; i < cModules; i++)
365	{
366	RTRCPTR uNewAddr = paEntries[i].uOldAddr + offDelta;
367	int rc = RTDbgAsModuleLink(hAs, paEntries[i].hDbgMod, uNewAddr,
368	RTDBGASLINK_FLAGS_REPLACE);
369	AssertLogRelMsg(RT_SUCCESS(rc),
370	("iModule=%#x rc=%Rrc hDbgMod=%p %RRv -> %RRv\n", i, rc, paEntries[i].hDbgMod,
371	paEntries[i].uOldAddr, uNewAddr));
372	RTDbgModRelease(paEntries[i].hDbgMod);
373	}
374
375	RTMemTmpFree(paEntries);
376	}
377	else
378	AssertLogRelMsgFailed(("No memory for %#x modules.\n", cModules));
379	}
380	else
381	AssertLogRelMsgFailed(("cModules=%#x\n", cModules));
382	RTDbgAsUnlockExcl(hAs);
383	}
384	}
385
386
387	/**
388	* Gets the IPRT debugging configuration handle (no refs retained).
389	*
390	* @returns Config handle or NIL_RTDBGCFG.
391	* @param pUVM The user mode VM handle.
392	*/
393	VMMR3DECL(RTDBGCFG) DBGFR3AsGetConfig(PUVM pUVM)
394	{
395	UVM_ASSERT_VALID_EXT_RETURN(pUVM, NIL_RTDBGCFG);
396	return pUVM->dbgf.s.hDbgCfg;
397	}
398
399
400	/**
401	* Adds the address space to the database.
402	*
403	* @returns VBox status code.
404	* @param pUVM The user mode VM handle.
405	* @param hDbgAs The address space handle. The reference of the caller
406	* will NOT be consumed.
407	* @param ProcId The process id or NIL_RTPROCESS.
408	*/
409	VMMR3DECL(int) DBGFR3AsAdd(PUVM pUVM, RTDBGAS hDbgAs, RTPROCESS ProcId)
410	{
411	/*
412	* Input validation.
413	*/
414	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
415	const char *pszName = RTDbgAsName(hDbgAs);
416	if (!pszName)
417	return VERR_INVALID_HANDLE;
418	uint32_t cRefs = RTDbgAsRetain(hDbgAs);
419	if (cRefs == UINT32_MAX)
420	return VERR_INVALID_HANDLE;
421
422	/*
423	* Allocate a tracking node.
424	*/
425	int rc = VERR_NO_MEMORY;
426	PDBGFASDBNODE pDbNode = (PDBGFASDBNODE)MMR3HeapAllocU(pUVM, MM_TAG_DBGF_AS, sizeof(*pDbNode));
427	if (pDbNode)
428	{
429	pDbNode->HandleCore.Key = hDbgAs;
430	pDbNode->PidCore.Key = ProcId;
431	pDbNode->NameCore.pszString = pszName;
432	pDbNode->NameCore.cchString = strlen(pszName);
433	DBGF_AS_DB_LOCK_WRITE(pUVM);
434	if (RTStrSpaceInsert(&pUVM->dbgf.s.AsNameSpace, &pDbNode->NameCore))
435	{
436	if (RTAvlPVInsert(&pUVM->dbgf.s.AsHandleTree, &pDbNode->HandleCore))
437	{
438	DBGF_AS_DB_UNLOCK_WRITE(pUVM);
439	return VINF_SUCCESS;
440	}
441
442	/* bail out */
443	RTStrSpaceRemove(&pUVM->dbgf.s.AsNameSpace, pszName);
444	}
445	DBGF_AS_DB_UNLOCK_WRITE(pUVM);
446	MMR3HeapFree(pDbNode);
447	}
448	RTDbgAsRelease(hDbgAs);
449	return rc;
450	}
451
452
453	/**
454	* Delete an address space from the database.
455	*
456	* The address space must not be engaged as any of the standard aliases.
457	*
458	* @returns VBox status code.
459	* @retval VERR_SHARING_VIOLATION if in use as an alias.
460	* @retval VERR_NOT_FOUND if not found in the address space database.
461	*
462	* @param pUVM The user mode VM handle.
463	* @param hDbgAs The address space handle. Aliases are not allowed.
464	*/
465	VMMR3DECL(int) DBGFR3AsDelete(PUVM pUVM, RTDBGAS hDbgAs)
466	{
467	/*
468	* Input validation. Retain the address space so it can be released outside
469	* the lock as well as validated.
470	*/
471	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
472	if (hDbgAs == NIL_RTDBGAS)
473	return VINF_SUCCESS;
474	uint32_t cRefs = RTDbgAsRetain(hDbgAs);
475	if (cRefs == UINT32_MAX)
476	return VERR_INVALID_HANDLE;
477	RTDbgAsRelease(hDbgAs);
478
479	DBGF_AS_DB_LOCK_WRITE(pUVM);
480
481	/*
482	* You cannot delete any of the aliases.
483	*/
484	for (size_t i = 0; i < RT_ELEMENTS(pUVM->dbgf.s.ahAsAliases); i++)
485	if (pUVM->dbgf.s.ahAsAliases[i] == hDbgAs)
486	{
487	DBGF_AS_DB_UNLOCK_WRITE(pUVM);
488	return VERR_SHARING_VIOLATION;
489	}
490
491	/*
492	* Ok, try remove it from the database.
493	*/
494	PDBGFASDBNODE pDbNode = (PDBGFASDBNODE)RTAvlPVRemove(&pUVM->dbgf.s.AsHandleTree, hDbgAs);
495	if (!pDbNode)
496	{
497	DBGF_AS_DB_UNLOCK_WRITE(pUVM);
498	return VERR_NOT_FOUND;
499	}
500	RTStrSpaceRemove(&pUVM->dbgf.s.AsNameSpace, pDbNode->NameCore.pszString);
501	if (pDbNode->PidCore.Key != NIL_RTPROCESS)
502	RTAvlU32Remove(&pUVM->dbgf.s.AsPidTree, pDbNode->PidCore.Key);
503
504	DBGF_AS_DB_UNLOCK_WRITE(pUVM);
505
506	/*
507	* Free the resources.
508	*/
509	RTDbgAsRelease(hDbgAs);
510	MMR3HeapFree(pDbNode);
511
512	return VINF_SUCCESS;
513	}
514
515
516	/**
517	* Changes an alias to point to a new address space.
518	*
519	* Not all the aliases can be changed, currently it's only DBGF_AS_GLOBAL
520	* and DBGF_AS_KERNEL.
521	*
522	* @returns VBox status code.
523	* @param pUVM The user mode VM handle.
524	* @param hAlias The alias to change.
525	* @param hAliasFor The address space hAlias should be an alias for. This
526	* can be an alias. The caller's reference to this address
527	* space will NOT be consumed.
528	*/
529	VMMR3DECL(int) DBGFR3AsSetAlias(PUVM pUVM, RTDBGAS hAlias, RTDBGAS hAliasFor)
530	{
531	/*
532	* Input validation.
533	*/
534	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
535	AssertMsgReturn(DBGF_AS_IS_ALIAS(hAlias), ("%p\n", hAlias), VERR_INVALID_PARAMETER);
536	AssertMsgReturn(!DBGF_AS_IS_FIXED_ALIAS(hAlias), ("%p\n", hAlias), VERR_INVALID_PARAMETER);
537	RTDBGAS hRealAliasFor = DBGFR3AsResolveAndRetain(pUVM, hAliasFor);
538	if (hRealAliasFor == NIL_RTDBGAS)
539	return VERR_INVALID_HANDLE;
540
541	/*
542	* Make sure the handle has is already in the database.
543	*/
544	int rc = VERR_NOT_FOUND;
545	DBGF_AS_DB_LOCK_WRITE(pUVM);
546	if (RTAvlPVGet(&pUVM->dbgf.s.AsHandleTree, hRealAliasFor))
547	{
548	/*
549	* Update the alias table and release the current address space.
550	*/
551	RTDBGAS hAsOld;
552	ASMAtomicXchgHandle(&pUVM->dbgf.s.ahAsAliases[DBGF_AS_ALIAS_2_INDEX(hAlias)], hRealAliasFor, &hAsOld);
553	uint32_t cRefs = RTDbgAsRelease(hAsOld);
554	Assert(cRefs > 0); Assert(cRefs != UINT32_MAX); NOREF(cRefs);
555	rc = VINF_SUCCESS;
556	}
557	DBGF_AS_DB_UNLOCK_WRITE(pUVM);
558
559	return rc;
560	}
561
562
563	/**
564	* @callback_method_impl{FNPDMR3ENUM}
565	*/
566	static DECLCALLBACK(int) dbgfR3AsLazyPopulateR0Callback(PVM pVM, const char pszFilename, const char pszName,
567	RTUINTPTR ImageBase, size_t cbImage, PDMLDRCTX enmCtx, void *pvArg)
568	{
569	NOREF(pVM); NOREF(cbImage);
570
571	/* Only ring-0 modules. */
572	if (enmCtx == PDMLDRCTX_RING_0)
573	{
574	RTDBGMOD hDbgMod;
575	int rc = RTDbgModCreateFromImage(&hDbgMod, pszFilename, pszName, RTLDRARCH_HOST, pVM->pUVM->dbgf.s.hDbgCfg);
576	if (RT_SUCCESS(rc))
577	{
578	rc = RTDbgAsModuleLink((RTDBGAS)pvArg, hDbgMod, ImageBase, 0 /fFlags/);
579	if (RT_FAILURE(rc))
580	LogRel(("DBGF: Failed to link module \"%s\" into DBGF_AS_R0 at %RTptr: %Rrc\n",
581	pszName, ImageBase, rc));
582	}
583	else
584	LogRel(("DBGF: RTDbgModCreateFromImage failed with rc=%Rrc for module \"%s\" (%s)\n",
585	rc, pszName, pszFilename));
586	}
587	return VINF_SUCCESS;
588	}
589
590
591	/**
592	* @callback_method_impl{FNPDMR3ENUM}
593	*/
594	static DECLCALLBACK(int) dbgfR3AsLazyPopulateRCCallback(PVM pVM, const char pszFilename, const char pszName,
595	RTUINTPTR ImageBase, size_t cbImage, PDMLDRCTX enmCtx, void *pvArg)
596	{
597	NOREF(pVM); NOREF(cbImage);
598
599	/* Only raw-mode modules. */
600	if (enmCtx == PDMLDRCTX_RAW_MODE)
601	{
602	RTDBGMOD hDbgMod;
603	int rc = RTDbgModCreateFromImage(&hDbgMod, pszFilename, pszName, RTLDRARCH_X86_32, pVM->pUVM->dbgf.s.hDbgCfg);
604	if (RT_SUCCESS(rc))
605	{
606	rc = RTDbgAsModuleLink((RTDBGAS)pvArg, hDbgMod, ImageBase, 0 /fFlags/);
607	if (RT_FAILURE(rc))
608	LogRel(("DBGF: Failed to link module \"%s\" into DBGF_AS_RC at %RTptr: %Rrc\n",
609	pszName, ImageBase, rc));
610	}
611	else
612	LogRel(("DBGF: RTDbgModCreateFromImage failed with rc=%Rrc for module \"%s\" (%s)\n",
613	rc, pszName, pszFilename));
614	}
615	return VINF_SUCCESS;
616	}
617
618
619	/**
620	* Lazily populates the specified address space.
621	*
622	* @param pUVM The user mode VM handle.
623	* @param hAlias The alias.
624	*/
625	static void dbgfR3AsLazyPopulate(PUVM pUVM, RTDBGAS hAlias)
626	{
627	DBGF_AS_DB_LOCK_WRITE(pUVM);
628	uintptr_t iAlias = DBGF_AS_ALIAS_2_INDEX(hAlias);
629	if (!pUVM->dbgf.s.afAsAliasPopuplated[iAlias])
630	{
631	RTDBGAS hDbgAs = pUVM->dbgf.s.ahAsAliases[iAlias];
632	if (hAlias == DBGF_AS_R0 && pUVM->pVM)
633	PDMR3LdrEnumModules(pUVM->pVM, dbgfR3AsLazyPopulateR0Callback, hDbgAs);
634	else if (hAlias == DBGF_AS_RC && pUVM->pVM && !HMIsEnabled(pUVM->pVM))
635	{
636	LogRel(("DBGF: Lazy init of RC address space\n"));
637	PDMR3LdrEnumModules(pUVM->pVM, dbgfR3AsLazyPopulateRCCallback, hDbgAs);
638	#ifdef VBOX_WITH_RAW_MODE
639	PATMR3DbgPopulateAddrSpace(pUVM->pVM, hDbgAs);
640	#endif
641	}
642	else if (hAlias == DBGF_AS_PHYS && pUVM->pVM)
643	{
644	/** @todo Lazy load pc and vga bios symbols or the EFI stuff. */
645	}
646
647	pUVM->dbgf.s.afAsAliasPopuplated[iAlias] = true;
648	}
649	DBGF_AS_DB_UNLOCK_WRITE(pUVM);
650	}
651
652
653	/**
654	* Resolves the address space handle into a real handle if it's an alias.
655	*
656	* @returns Real address space handle. NIL_RTDBGAS if invalid handle.
657	*
658	* @param pUVM The user mode VM handle.
659	* @param hAlias The possibly address space alias.
660	*
661	* @remarks Doesn't take any locks.
662	*/
663	VMMR3DECL(RTDBGAS) DBGFR3AsResolve(PUVM pUVM, RTDBGAS hAlias)
664	{
665	UVM_ASSERT_VALID_EXT_RETURN(pUVM, NULL);
666	AssertCompileNS(NIL_RTDBGAS == (RTDBGAS)0);
667
668	uintptr_t iAlias = DBGF_AS_ALIAS_2_INDEX(hAlias);
669	if (iAlias < DBGF_AS_COUNT)
670	ASMAtomicReadHandle(&pUVM->dbgf.s.ahAsAliases[iAlias], &hAlias);
671	return hAlias;
672	}
673
674
675	/**
676	* Resolves the address space handle into a real handle if it's an alias,
677	* and retains whatever it is.
678	*
679	* @returns Real address space handle. NIL_RTDBGAS if invalid handle.
680	*
681	* @param pUVM The user mode VM handle.
682	* @param hAlias The possibly address space alias.
683	*/
684	VMMR3DECL(RTDBGAS) DBGFR3AsResolveAndRetain(PUVM pUVM, RTDBGAS hAlias)
685	{
686	UVM_ASSERT_VALID_EXT_RETURN(pUVM, NULL);
687	AssertCompileNS(NIL_RTDBGAS == (RTDBGAS)0);
688
689	uint32_t cRefs;
690	uintptr_t iAlias = DBGF_AS_ALIAS_2_INDEX(hAlias);
691	if (iAlias < DBGF_AS_COUNT)
692	{
693	if (DBGF_AS_IS_FIXED_ALIAS(hAlias))
694	{
695	/* Perform lazy address space population. */
696	if (!pUVM->dbgf.s.afAsAliasPopuplated[iAlias])
697	dbgfR3AsLazyPopulate(pUVM, hAlias);
698
699	/* Won't ever change, no need to grab the lock. */
700	hAlias = pUVM->dbgf.s.ahAsAliases[iAlias];
701	cRefs = RTDbgAsRetain(hAlias);
702	}
703	else
704	{
705	/* May change, grab the lock so we can read it safely. */
706	DBGF_AS_DB_LOCK_READ(pUVM);
707	hAlias = pUVM->dbgf.s.ahAsAliases[iAlias];
708	cRefs = RTDbgAsRetain(hAlias);
709	DBGF_AS_DB_UNLOCK_READ(pUVM);
710	}
711	}
712	else
713	/* Not an alias, just retain it. */
714	cRefs = RTDbgAsRetain(hAlias);
715
716	return cRefs != UINT32_MAX ? hAlias : NIL_RTDBGAS;
717	}
718
719
720	/**
721	* Query an address space by name.
722	*
723	* @returns Retained address space handle if found, NIL_RTDBGAS if not.
724	*
725	* @param pUVM The user mode VM handle.
726	* @param pszName The name.
727	*/
728	VMMR3DECL(RTDBGAS) DBGFR3AsQueryByName(PUVM pUVM, const char *pszName)
729	{
730	/*
731	* Validate the input.
732	*/
733	UVM_ASSERT_VALID_EXT_RETURN(pUVM, NIL_RTDBGAS);
734	AssertPtrReturn(pszName, NIL_RTDBGAS);
735	AssertReturn(*pszName, NIL_RTDBGAS);
736
737	/*
738	* Look it up in the string space and retain the result.
739	*/
740	RTDBGAS hDbgAs = NIL_RTDBGAS;
741	DBGF_AS_DB_LOCK_READ(pUVM);
742
743	PRTSTRSPACECORE pNode = RTStrSpaceGet(&pUVM->dbgf.s.AsNameSpace, pszName);
744	if (pNode)
745	{
746	PDBGFASDBNODE pDbNode = RT_FROM_MEMBER(pNode, DBGFASDBNODE, NameCore);
747	hDbgAs = (RTDBGAS)pDbNode->HandleCore.Key;
748	uint32_t cRefs = RTDbgAsRetain(hDbgAs);
749	if (RT_UNLIKELY(cRefs == UINT32_MAX))
750	hDbgAs = NIL_RTDBGAS;
751	}
752
753	DBGF_AS_DB_UNLOCK_READ(pUVM);
754	return hDbgAs;
755	}
756
757
758	/**
759	* Query an address space by process ID.
760	*
761	* @returns Retained address space handle if found, NIL_RTDBGAS if not.
762	*
763	* @param pUVM The user mode VM handle.
764	* @param ProcId The process ID.
765	*/
766	VMMR3DECL(RTDBGAS) DBGFR3AsQueryByPid(PUVM pUVM, RTPROCESS ProcId)
767	{
768	/*
769	* Validate the input.
770	*/
771	UVM_ASSERT_VALID_EXT_RETURN(pUVM, NIL_RTDBGAS);
772	AssertReturn(ProcId != NIL_RTPROCESS, NIL_RTDBGAS);
773
774	/*
775	* Look it up in the PID tree and retain the result.
776	*/
777	RTDBGAS hDbgAs = NIL_RTDBGAS;
778	DBGF_AS_DB_LOCK_READ(pUVM);
779
780	PAVLU32NODECORE pNode = RTAvlU32Get(&pUVM->dbgf.s.AsPidTree, ProcId);
781	if (pNode)
782	{
783	PDBGFASDBNODE pDbNode = RT_FROM_MEMBER(pNode, DBGFASDBNODE, PidCore);
784	hDbgAs = (RTDBGAS)pDbNode->HandleCore.Key;
785	uint32_t cRefs = RTDbgAsRetain(hDbgAs);
786	if (RT_UNLIKELY(cRefs == UINT32_MAX))
787	hDbgAs = NIL_RTDBGAS;
788	}
789	DBGF_AS_DB_UNLOCK_READ(pUVM);
790
791	return hDbgAs;
792	}
793
794
795	/**
796	* Searches for the file in the path.
797	*
798	* The file is first tested without any path modification, then we walk the path
799	* looking in each directory.
800	*
801	* @returns VBox status code.
802	* @param pszFilename The file to search for.
803	* @param pszPath The search path.
804	* @param pfnOpen The open callback function.
805	* @param pvUser User argument for the callback.
806	*/
807	static int dbgfR3AsSearchPath(const char pszFilename, const char pszPath, PFNDBGFR3ASSEARCHOPEN pfnOpen, void *pvUser)
808	{
809	char szFound[RTPATH_MAX];
810
811	/* Check the filename length. */
812	size_t const cchFilename = strlen(pszFilename);
813	if (cchFilename >= sizeof(szFound))
814	return VERR_FILENAME_TOO_LONG;
815	const char *pszName = RTPathFilename(pszFilename);
816	if (!pszName)
817	return VERR_IS_A_DIRECTORY;
818	size_t const cchName = strlen(pszName);
819
820	/*
821	* Try default location first.
822	*/
823	memcpy(szFound, pszFilename, cchFilename + 1);
824	int rc = pfnOpen(szFound, pvUser);
825	if (RT_SUCCESS(rc))
826	return rc;
827
828	/*
829	* Walk the search path.
830	*/
831	const char *psz = pszPath;
832	while (*psz)
833	{
834	/* Skip leading blanks - no directories with leading spaces, thank you. */
835	while (RT_C_IS_BLANK(*psz))
836	psz++;
837
838	/* Find the end of this element. */
839	const char *pszNext;
840	const char *pszEnd = strchr(psz, ';');
841	if (!pszEnd)
842	pszEnd = pszNext = strchr(psz, '\0');
843	else
844	pszNext = pszEnd + 1;
845	if (pszEnd != psz)
846	{
847	size_t const cch = pszEnd - psz;
848	if (cch + 1 + cchName < sizeof(szFound))
849	{
850	/** @todo RTPathCompose, RTPathComposeN(). This code isn't right
851	* for 'E:' on DOS systems. It may also create unwanted double slashes. */
852	memcpy(szFound, psz, cch);
853	szFound[cch] = '/';
854	memcpy(szFound + cch + 1, pszName, cchName + 1);
855	int rc2 = pfnOpen(szFound, pvUser);
856	if (RT_SUCCESS(rc2))
857	return rc2;
858	if ( rc2 != rc
859	&& ( rc == VERR_FILE_NOT_FOUND
860	\|\| rc == VERR_OPEN_FAILED))
861	rc = rc2;
862	}
863	}
864
865	/* advance */
866	psz = pszNext;
867	}
868
869	/*
870	* Walk the path once again, this time do a depth search.
871	*/
872	/** @todo do a depth search using the specified path. */
873
874	/* failed */
875	return rc;
876	}
877
878
879	/**
880	* Same as dbgfR3AsSearchEnv, except that the path is taken from the environment.
881	*
882	* If the environment variable doesn't exist, the current directory is searched
883	* instead.
884	*
885	* @returns VBox status code.
886	* @param pszFilename The filename.
887	* @param pszEnvVar The environment variable name.
888	* @param pfnOpen The open callback function.
889	* @param pvUser User argument for the callback.
890	*/
891	static int dbgfR3AsSearchEnvPath(const char pszFilename, const char pszEnvVar, PFNDBGFR3ASSEARCHOPEN pfnOpen, void *pvUser)
892	{
893	int rc;
894	char *pszPath = RTEnvDupEx(RTENV_DEFAULT, pszEnvVar);
895	if (pszPath)
896	{
897	rc = dbgfR3AsSearchPath(pszFilename, pszPath, pfnOpen, pvUser);
898	RTStrFree(pszPath);
899	}
900	else
901	rc = dbgfR3AsSearchPath(pszFilename, ".", pfnOpen, pvUser);
902	return rc;
903	}
904
905
906	/**
907	* Same as dbgfR3AsSearchEnv, except that the path is taken from the DBGF config
908	* (CFGM).
909	*
910	* Nothing is done if the CFGM variable isn't set.
911	*
912	* @returns VBox status code.
913	* @param pUVM The user mode VM handle.
914	* @param pszFilename The filename.
915	* @param pszCfgValue The name of the config variable (under /DBGF/).
916	* @param pfnOpen The open callback function.
917	* @param pvUser User argument for the callback.
918	*/
919	static int dbgfR3AsSearchCfgPath(PUVM pUVM, const char pszFilename, const char pszCfgValue,
920	PFNDBGFR3ASSEARCHOPEN pfnOpen, void *pvUser)
921	{
922	char *pszPath;
923	int rc = CFGMR3QueryStringAllocDef(CFGMR3GetChild(CFGMR3GetRootU(pUVM), "/DBGF"), pszCfgValue, &pszPath, NULL);
924	if (RT_FAILURE(rc))
925	return rc;
926	if (!pszPath)
927	return VERR_FILE_NOT_FOUND;
928	rc = dbgfR3AsSearchPath(pszFilename, pszPath, pfnOpen, pvUser);
929	MMR3HeapFree(pszPath);
930	return rc;
931	}
932
933
934	/**
935	* Load symbols from an executable module into the specified address space.
936	*
937	* If an module exist at the specified address it will be replaced by this
938	* call, otherwise a new module is created.
939	*
940	* @returns VBox status code.
941	*
942	* @param pUVM The user mode VM handle.
943	* @param hDbgAs The address space.
944	* @param pszFilename The filename of the executable module.
945	* @param pszModName The module name. If NULL, then then the file name
946	* base is used (no extension or nothing).
947	* @param enmArch The desired architecture, use RTLDRARCH_WHATEVER if
948	* it's not relevant or known.
949	* @param pModAddress The load address of the module.
950	* @param iModSeg The segment to load, pass NIL_RTDBGSEGIDX to load
951	* the whole image.
952	* @param fFlags Flags reserved for future extensions, must be 0.
953	*/
954	VMMR3DECL(int) DBGFR3AsLoadImage(PUVM pUVM, RTDBGAS hDbgAs, const char pszFilename, const char pszModName, RTLDRARCH enmArch,
955	PCDBGFADDRESS pModAddress, RTDBGSEGIDX iModSeg, uint32_t fFlags)
956	{
957	/*
958	* Validate input
959	*/
960	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
961	AssertPtrReturn(pszFilename, VERR_INVALID_POINTER);
962	AssertReturn(*pszFilename, VERR_INVALID_PARAMETER);
963	AssertReturn(DBGFR3AddrIsValid(pUVM, pModAddress), VERR_INVALID_PARAMETER);
964	AssertReturn(fFlags == 0, VERR_INVALID_PARAMETER);
965	RTDBGAS hRealAS = DBGFR3AsResolveAndRetain(pUVM, hDbgAs);
966	if (hRealAS == NIL_RTDBGAS)
967	return VERR_INVALID_HANDLE;
968
969	RTDBGMOD hDbgMod;
970	int rc = RTDbgModCreateFromImage(&hDbgMod, pszFilename, pszModName, enmArch, pUVM->dbgf.s.hDbgCfg);
971	if (RT_SUCCESS(rc))
972	{
973	rc = DBGFR3AsLinkModule(pUVM, hRealAS, hDbgMod, pModAddress, iModSeg, 0);
974	if (RT_FAILURE(rc))
975	RTDbgModRelease(hDbgMod);
976	}
977
978	RTDbgAsRelease(hRealAS);
979	return rc;
980	}
981
982
983	/**
984	* Load symbols from a map file into a module at the specified address space.
985	*
986	* If an module exist at the specified address it will be replaced by this
987	* call, otherwise a new module is created.
988	*
989	* @returns VBox status code.
990	*
991	* @param pUVM The user mode VM handle.
992	* @param hDbgAs The address space.
993	* @param pszFilename The map file.
994	* @param pszModName The module name. If NULL, then then the file name
995	* base is used (no extension or nothing).
996	* @param pModAddress The load address of the module.
997	* @param iModSeg The segment to load, pass NIL_RTDBGSEGIDX to load
998	* the whole image.
999	* @param uSubtrahend Value to to subtract from the symbols in the map
1000	* file. This is useful for the linux System.map and
1001	* /proc/kallsyms.
1002	* @param fFlags Flags reserved for future extensions, must be 0.
1003	*/
1004	VMMR3DECL(int) DBGFR3AsLoadMap(PUVM pUVM, RTDBGAS hDbgAs, const char pszFilename, const char pszModName,
1005	PCDBGFADDRESS pModAddress, RTDBGSEGIDX iModSeg, RTGCUINTPTR uSubtrahend, uint32_t fFlags)
1006	{
1007	/*
1008	* Validate input
1009	*/
1010	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
1011	AssertPtrReturn(pszFilename, VERR_INVALID_POINTER);
1012	AssertReturn(*pszFilename, VERR_INVALID_PARAMETER);
1013	AssertReturn(DBGFR3AddrIsValid(pUVM, pModAddress), VERR_INVALID_PARAMETER);
1014	AssertReturn(fFlags == 0, VERR_INVALID_PARAMETER);
1015	RTDBGAS hRealAS = DBGFR3AsResolveAndRetain(pUVM, hDbgAs);
1016	if (hRealAS == NIL_RTDBGAS)
1017	return VERR_INVALID_HANDLE;
1018
1019	RTDBGMOD hDbgMod;
1020	int rc = RTDbgModCreateFromMap(&hDbgMod, pszFilename, pszModName, uSubtrahend, pUVM->dbgf.s.hDbgCfg);
1021	if (RT_SUCCESS(rc))
1022	{
1023	rc = DBGFR3AsLinkModule(pUVM, hRealAS, hDbgMod, pModAddress, iModSeg, 0);
1024	if (RT_FAILURE(rc))
1025	RTDbgModRelease(hDbgMod);
1026	}
1027
1028	RTDbgAsRelease(hRealAS);
1029	return rc;
1030	}
1031
1032
1033	/**
1034	* Wrapper around RTDbgAsModuleLink, RTDbgAsModuleLinkSeg and DBGFR3AsResolve.
1035	*
1036	* @returns VBox status code.
1037	* @param pUVM The user mode VM handle.
1038	* @param hDbgAs The address space handle.
1039	* @param hMod The module handle.
1040	* @param pModAddress The link address.
1041	* @param iModSeg The segment to link, NIL_RTDBGSEGIDX for the entire image.
1042	* @param fFlags Flags to pass to the link functions, see RTDBGASLINK_FLAGS_*.
1043	*/
1044	VMMR3DECL(int) DBGFR3AsLinkModule(PUVM pUVM, RTDBGAS hDbgAs, RTDBGMOD hMod, PCDBGFADDRESS pModAddress,
1045	RTDBGSEGIDX iModSeg, uint32_t fFlags)
1046	{
1047	/*
1048	* Input validation.
1049	*/
1050	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
1051	AssertReturn(DBGFR3AddrIsValid(pUVM, pModAddress), VERR_INVALID_PARAMETER);
1052	RTDBGAS hRealAS = DBGFR3AsResolveAndRetain(pUVM, hDbgAs);
1053	if (hRealAS == NIL_RTDBGAS)
1054	return VERR_INVALID_HANDLE;
1055
1056	/*
1057	* Do the job.
1058	*/
1059	int rc;
1060	if (iModSeg == NIL_RTDBGSEGIDX)
1061	rc = RTDbgAsModuleLink(hRealAS, hMod, pModAddress->FlatPtr, fFlags);
1062	else
1063	rc = RTDbgAsModuleLinkSeg(hRealAS, hMod, iModSeg, pModAddress->FlatPtr, fFlags);
1064
1065	RTDbgAsRelease(hRealAS);
1066	return rc;
1067	}
1068
1069
1070	/**
1071	* Wrapper around RTDbgAsModuleByName and RTDbgAsModuleUnlink.
1072	*
1073	* Unlinks all mappings matching the given module name.
1074	*
1075	* @returns VBox status code.
1076	* @param pUVM The user mode VM handle.
1077	* @param hDbgAs The address space handle.
1078	* @param pszModName The name of the module to unlink.
1079	*/
1080	VMMR3DECL(int) DBGFR3AsUnlinkModuleByName(PUVM pUVM, RTDBGAS hDbgAs, const char *pszModName)
1081	{
1082	/*
1083	* Input validation.
1084	*/
1085	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
1086	RTDBGAS hRealAS = DBGFR3AsResolveAndRetain(pUVM, hDbgAs);
1087	if (hRealAS == NIL_RTDBGAS)
1088	return VERR_INVALID_HANDLE;
1089
1090	/*
1091	* Do the job.
1092	*/
1093	RTDBGMOD hMod;
1094	int rc = RTDbgAsModuleByName(hRealAS, pszModName, 0, &hMod);
1095	if (RT_SUCCESS(rc))
1096	{
1097	for (;;)
1098	{
1099	rc = RTDbgAsModuleUnlink(hRealAS, hMod);
1100	RTDbgModRelease(hMod);
1101	if (RT_FAILURE(rc))
1102	break;
1103	rc = RTDbgAsModuleByName(hRealAS, pszModName, 0, &hMod);
1104	if (RT_FAILURE_NP(rc))
1105	{
1106	if (rc == VERR_NOT_FOUND)
1107	rc = VINF_SUCCESS;
1108	break;
1109	}
1110	}
1111	}
1112
1113	RTDbgAsRelease(hRealAS);
1114	return rc;
1115	}
1116
1117
1118	/**
1119	* Adds the module name to the symbol name.
1120	*
1121	* @param pSymbol The symbol info (in/out).
1122	* @param hMod The module handle.
1123	*/
1124	static void dbgfR3AsSymbolJoinNames(PRTDBGSYMBOL pSymbol, RTDBGMOD hMod)
1125	{
1126	/* Figure the lengths, adjust them if the result is too long. */
1127	const char *pszModName = RTDbgModName(hMod);
1128	size_t cchModName = strlen(pszModName);
1129	size_t cchSymbol = strlen(pSymbol->szName);
1130	if (cchModName + 1 + cchSymbol >= sizeof(pSymbol->szName))
1131	{
1132	if (cchModName >= sizeof(pSymbol->szName) / 4)
1133	cchModName = sizeof(pSymbol->szName) / 4;
1134	if (cchModName + 1 + cchSymbol >= sizeof(pSymbol->szName))
1135	cchSymbol = sizeof(pSymbol->szName) - cchModName - 2;
1136	Assert(cchModName + 1 + cchSymbol < sizeof(pSymbol->szName));
1137	}
1138
1139	/* Do the moving and copying. */
1140	memmove(&pSymbol->szName[cchModName + 1], &pSymbol->szName[0], cchSymbol + 1);
1141	memcpy(&pSymbol->szName[0], pszModName, cchModName);
1142	pSymbol->szName[cchModName] = '!';
1143	}
1144
1145
1146	/** Temporary symbol conversion function. */
1147	static void dbgfR3AsSymbolConvert(PRTDBGSYMBOL pSymbol, PCDBGFSYMBOL pDbgfSym)
1148	{
1149	pSymbol->offSeg = pSymbol->Value = pDbgfSym->Value;
1150	pSymbol->cb = pDbgfSym->cb;
1151	pSymbol->iSeg = 0;
1152	pSymbol->fFlags = 0;
1153	pSymbol->iOrdinal = UINT32_MAX;
1154	strcpy(pSymbol->szName, pDbgfSym->szName);
1155	}
1156
1157
1158	/**
1159	* Query a symbol by address.
1160	*
1161	* The returned symbol is the one we consider closes to the specified address.
1162	*
1163	* @returns VBox status code. See RTDbgAsSymbolByAddr.
1164	*
1165	* @param pUVM The user mode VM handle.
1166	* @param hDbgAs The address space handle.
1167	* @param pAddress The address to lookup.
1168	* @param fFlags One of the RTDBGSYMADDR_FLAGS_XXX flags.
1169	* @param poffDisp Where to return the distance between the returned
1170	* symbol and pAddress. Optional.
1171	* @param pSymbol Where to return the symbol information. The returned
1172	* symbol name will be prefixed by the module name as
1173	* far as space allows.
1174	* @param phMod Where to return the module handle. Optional.
1175	*/
1176	VMMR3DECL(int) DBGFR3AsSymbolByAddr(PUVM pUVM, RTDBGAS hDbgAs, PCDBGFADDRESS pAddress, uint32_t fFlags,
1177	PRTGCINTPTR poffDisp, PRTDBGSYMBOL pSymbol, PRTDBGMOD phMod)
1178	{
1179	/*
1180	* Implement the special address space aliases the lazy way.
1181	*/
1182	if (hDbgAs == DBGF_AS_RC_AND_GC_GLOBAL)
1183	{
1184	int rc = DBGFR3AsSymbolByAddr(pUVM, DBGF_AS_RC, pAddress, fFlags, poffDisp, pSymbol, phMod);
1185	if (RT_FAILURE(rc))
1186	rc = DBGFR3AsSymbolByAddr(pUVM, DBGF_AS_GLOBAL, pAddress, fFlags, poffDisp, pSymbol, phMod);
1187	return rc;
1188	}
1189
1190	/*
1191	* Input validation.
1192	*/
1193	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
1194	AssertReturn(DBGFR3AddrIsValid(pUVM, pAddress), VERR_INVALID_PARAMETER);
1195	AssertPtrNullReturn(poffDisp, VERR_INVALID_POINTER);
1196	AssertPtrReturn(pSymbol, VERR_INVALID_POINTER);
1197	AssertPtrNullReturn(phMod, VERR_INVALID_POINTER);
1198	if (poffDisp)
1199	*poffDisp = 0;
1200	if (phMod)
1201	*phMod = NIL_RTDBGMOD;
1202	RTDBGAS hRealAS = DBGFR3AsResolveAndRetain(pUVM, hDbgAs);
1203	if (hRealAS == NIL_RTDBGAS)
1204	return VERR_INVALID_HANDLE;
1205
1206	/*
1207	* Do the lookup.
1208	*/
1209	RTDBGMOD hMod;
1210	int rc = RTDbgAsSymbolByAddr(hRealAS, pAddress->FlatPtr, fFlags, poffDisp, pSymbol, &hMod);
1211	if (RT_SUCCESS(rc))
1212	{
1213	dbgfR3AsSymbolJoinNames(pSymbol, hMod);
1214	if (!phMod)
1215	RTDbgModRelease(hMod);
1216	}
1217
1218	return rc;
1219	}
1220
1221
1222	/**
1223	* Convenience function that combines RTDbgSymbolDup and DBGFR3AsSymbolByAddr.
1224	*
1225	* @returns Pointer to the symbol on success. This must be free using
1226	* RTDbgSymbolFree(). NULL is returned if not found or any error
1227	* occurs.
1228	*
1229	* @param pUVM The user mode VM handle.
1230	* @param hDbgAs See DBGFR3AsSymbolByAddr.
1231	* @param pAddress See DBGFR3AsSymbolByAddr.
1232	* @param fFlags See DBGFR3AsSymbolByAddr.
1233	* @param poffDisp See DBGFR3AsSymbolByAddr.
1234	* @param phMod See DBGFR3AsSymbolByAddr.
1235	*/
1236	VMMR3DECL(PRTDBGSYMBOL) DBGFR3AsSymbolByAddrA(PUVM pUVM, RTDBGAS hDbgAs, PCDBGFADDRESS pAddress, uint32_t fFlags,
1237	PRTGCINTPTR poffDisp, PRTDBGMOD phMod)
1238	{
1239	RTDBGSYMBOL SymInfo;
1240	int rc = DBGFR3AsSymbolByAddr(pUVM, hDbgAs, pAddress, fFlags, poffDisp, &SymInfo, phMod);
1241	if (RT_SUCCESS(rc))
1242	return RTDbgSymbolDup(&SymInfo);
1243	return NULL;
1244	}
1245
1246
1247	/**
1248	* Query a symbol by name.
1249	*
1250	* The symbol can be prefixed by a module name pattern to scope the search. The
1251	* pattern is a simple string pattern with '*' and '?' as wild chars. See
1252	* RTStrSimplePatternMatch().
1253	*
1254	* @returns VBox status code. See RTDbgAsSymbolByAddr.
1255	*
1256	* @param pUVM The user mode VM handle.
1257	* @param hDbgAs The address space handle.
1258	* @param pszSymbol The symbol to search for, maybe prefixed by a
1259	* module pattern.
1260	* @param pSymbol Where to return the symbol information.
1261	* The returned symbol name will be prefixed by
1262	* the module name as far as space allows.
1263	* @param phMod Where to return the module handle. Optional.
1264	*/
1265	VMMR3DECL(int) DBGFR3AsSymbolByName(PUVM pUVM, RTDBGAS hDbgAs, const char *pszSymbol,
1266	PRTDBGSYMBOL pSymbol, PRTDBGMOD phMod)
1267	{
1268	/*
1269	* Implement the special address space aliases the lazy way.
1270	*/
1271	if (hDbgAs == DBGF_AS_RC_AND_GC_GLOBAL)
1272	{
1273	int rc = DBGFR3AsSymbolByName(pUVM, DBGF_AS_RC, pszSymbol, pSymbol, phMod);
1274	if (RT_FAILURE(rc))
1275	rc = DBGFR3AsSymbolByName(pUVM, DBGF_AS_GLOBAL, pszSymbol, pSymbol, phMod);
1276	return rc;
1277	}
1278
1279	/*
1280	* Input validation.
1281	*/
1282	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
1283	AssertPtrReturn(pSymbol, VERR_INVALID_POINTER);
1284	AssertPtrNullReturn(phMod, VERR_INVALID_POINTER);
1285	if (phMod)
1286	*phMod = NIL_RTDBGMOD;
1287	RTDBGAS hRealAS = DBGFR3AsResolveAndRetain(pUVM, hDbgAs);
1288	if (hRealAS == NIL_RTDBGAS)
1289	return VERR_INVALID_HANDLE;
1290
1291
1292	/*
1293	* Do the lookup.
1294	*/
1295	RTDBGMOD hMod;
1296	int rc = RTDbgAsSymbolByName(hRealAS, pszSymbol, pSymbol, &hMod);
1297	if (RT_SUCCESS(rc))
1298	{
1299	dbgfR3AsSymbolJoinNames(pSymbol, hMod);
1300	if (!phMod)
1301	RTDbgModRelease(hMod);
1302	}
1303
1304	return rc;
1305	}
1306
1307
1308	VMMR3DECL(int) DBGFR3AsLineByAddr(PUVM pUVM, RTDBGAS hDbgAs, PCDBGFADDRESS pAddress,
1309	PRTGCINTPTR poffDisp, PRTDBGLINE pLine, PRTDBGMOD phMod)
1310	{
1311	/*
1312	* Implement the special address space aliases the lazy way.
1313	*/
1314	if (hDbgAs == DBGF_AS_RC_AND_GC_GLOBAL)
1315	{
1316	int rc = DBGFR3AsLineByAddr(pUVM, DBGF_AS_RC, pAddress, poffDisp, pLine, phMod);
1317	if (RT_FAILURE(rc))
1318	rc = DBGFR3AsLineByAddr(pUVM, DBGF_AS_GLOBAL, pAddress, poffDisp, pLine, phMod);
1319	return rc;
1320	}
1321
1322	/*
1323	* Input validation.
1324	*/
1325	UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
1326	AssertReturn(DBGFR3AddrIsValid(pUVM, pAddress), VERR_INVALID_PARAMETER);
1327	AssertPtrNullReturn(poffDisp, VERR_INVALID_POINTER);
1328	AssertPtrReturn(pLine, VERR_INVALID_POINTER);
1329	AssertPtrNullReturn(phMod, VERR_INVALID_POINTER);
1330	if (poffDisp)
1331	*poffDisp = 0;
1332	if (phMod)
1333	*phMod = NIL_RTDBGMOD;
1334	RTDBGAS hRealAS = DBGFR3AsResolveAndRetain(pUVM, hDbgAs);
1335	if (hRealAS == NIL_RTDBGAS)
1336	return VERR_INVALID_HANDLE;
1337
1338	/*
1339	* Do the lookup.
1340	*/
1341	return RTDbgAsLineByAddr(hRealAS, pAddress->FlatPtr, poffDisp, pLine, phMod);
1342	}
1343
1344
1345	VMMR3DECL(PRTDBGLINE) DBGFR3AsLineByAddrA(PUVM pUVM, RTDBGAS hDbgAs, PCDBGFADDRESS pAddress,
1346	PRTGCINTPTR poffDisp, PRTDBGMOD phMod)
1347	{
1348	RTDBGLINE Line;
1349	int rc = DBGFR3AsLineByAddr(pUVM, hDbgAs, pAddress, poffDisp, &Line, phMod);
1350	if (RT_SUCCESS(rc))
1351	return RTDbgLineDup(&Line);
1352	return NULL;
1353	}
1354

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

source: vbox/trunk/src/VBox/VMM/VMMR3/DBGFAddrSpace.cpp@ 59140

Download in other formats: