dbgmodnm.cpp@ 33540

Last change on this file since 33540 was 28800, checked in by vboxsync, 14 years ago
Automated rebranding to Oracle copyright/license strings via filemuncher
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 18.8 KB

Line
1	/* $Id: dbgmodnm.cpp 28800 2010-04-27 08:22:32Z vboxsync $ */
2	/** @file
3	* IPRT - Debug Map Reader For NM Like Mapfiles.
4	*/
5
6	/*
7	* Copyright (C) 2009 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	* The contents of this file may alternatively be used under the terms
18	* of the Common Development and Distribution License Version 1.0
19	* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
20	* VirtualBox OSE distribution, in which case the provisions of the
21	* CDDL are applicable instead of those of the GPL.
22	*
23	* You may elect to license modified versions of this file under the
24	* terms and conditions of either the GPL or the CDDL or both.
25	*/
26
27
28	/*******************************************************************************
29	* Header Files *
30	*******************************************************************************/
31	#include <iprt/dbg.h>
32	#include "internal/iprt.h"
33
34	#include <iprt/err.h>
35	#include <iprt/ctype.h>
36	#include <iprt/mem.h>
37	#include <iprt/stream.h>
38	#include <iprt/string.h>
39	#include "internal/dbgmod.h"
40
41
42	/*******************************************************************************
43	* Structures and Typedefs *
44	*******************************************************************************/
45	/**
46	* Instance data.
47	*/
48	typedef struct RTDBGMODNM
49	{
50	/** The debug container containing doing the real work. */
51	RTDBGMOD hCnt;
52	} RTDBGMODNM;
53	/** Pointer to instance data NM map reader. */
54	typedef RTDBGMODNM *PRTDBGMODNM;
55
56
57
58	/** @interface_method_impl{RTDBGMODVTDBG,pfnLineByAddr} */
59	static DECLCALLBACK(int) rtDbgModNm_LineByAddr(PRTDBGMODINT pMod, RTDBGSEGIDX iSeg, RTUINTPTR off,
60	PRTINTPTR poffDisp, PRTDBGLINE pLineInfo)
61	{
62	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
63	return RTDbgModLineByAddr(pThis->hCnt, iSeg, off, poffDisp, pLineInfo);
64	}
65
66
67	/** @interface_method_impl{RTDBGMODVTDBG,pfnLineByOrdinal} */
68	static DECLCALLBACK(int) rtDbgModNm_LineByOrdinal(PRTDBGMODINT pMod, uint32_t iOrdinal, PRTDBGLINE pLineInfo)
69	{
70	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
71	return RTDbgModLineByOrdinal(pThis->hCnt, iOrdinal, pLineInfo);
72	}
73
74
75	/** @interface_method_impl{RTDBGMODVTDBG,pfnLineCount} */
76	static DECLCALLBACK(uint32_t) rtDbgModNm_LineCount(PRTDBGMODINT pMod)
77	{
78	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
79	return RTDbgModLineCount(pThis->hCnt);
80	}
81
82
83	/** @interface_method_impl{RTDBGMODVTDBG,pfnLineAdd} */
84	static DECLCALLBACK(int) rtDbgModNm_LineAdd(PRTDBGMODINT pMod, const char *pszFile, size_t cchFile, uint32_t uLineNo,
85	uint32_t iSeg, RTUINTPTR off, uint32_t *piOrdinal)
86	{
87	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
88	return RTDbgModLineAdd(pThis->hCnt, pszFile, uLineNo, iSeg, off, piOrdinal);
89	}
90
91
92	/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolByAddr} */
93	static DECLCALLBACK(int) rtDbgModNm_SymbolByAddr(PRTDBGMODINT pMod, RTDBGSEGIDX iSeg, RTUINTPTR off,
94	PRTINTPTR poffDisp, PRTDBGSYMBOL pSymInfo)
95	{
96	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
97	return RTDbgModSymbolByAddr(pThis->hCnt, iSeg, off, poffDisp, pSymInfo);
98	}
99
100
101	/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolByName} */
102	static DECLCALLBACK(int) rtDbgModNm_SymbolByName(PRTDBGMODINT pMod, const char *pszSymbol, size_t cchSymbol, PRTDBGSYMBOL pSymInfo)
103	{
104	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
105	return RTDbgModSymbolByName(pThis->hCnt, pszSymbol, pSymInfo);
106	}
107
108
109	/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolByOrdinal} */
110	static DECLCALLBACK(int) rtDbgModNm_SymbolByOrdinal(PRTDBGMODINT pMod, uint32_t iOrdinal, PRTDBGSYMBOL pSymInfo)
111	{
112	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
113	return RTDbgModSymbolByOrdinal(pThis->hCnt, iOrdinal, pSymInfo);
114	}
115
116
117	/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolCount} */
118	static DECLCALLBACK(uint32_t) rtDbgModNm_SymbolCount(PRTDBGMODINT pMod)
119	{
120	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
121	return RTDbgModSymbolCount(pThis->hCnt);
122	}
123
124
125	/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolAdd} */
126	static DECLCALLBACK(int) rtDbgModNm_SymbolAdd(PRTDBGMODINT pMod, const char *pszSymbol, size_t cchSymbol,
127	RTDBGSEGIDX iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags,
128	uint32_t *piOrdinal)
129	{
130	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
131	return RTDbgModSymbolAdd(pThis->hCnt, pszSymbol, iSeg, off, cb, fFlags, piOrdinal);
132	}
133
134
135	/** @interface_method_impl{RTDBGMODVTDBG,pfnSegmentByIndex} */
136	static DECLCALLBACK(int) rtDbgModNm_SegmentByIndex(PRTDBGMODINT pMod, RTDBGSEGIDX iSeg, PRTDBGSEGMENT pSegInfo)
137	{
138	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
139	return RTDbgModSegmentByIndex(pThis->hCnt, iSeg, pSegInfo);
140	}
141
142
143	/** @interface_method_impl{RTDBGMODVTDBG,pfnSegmentCount} */
144	static DECLCALLBACK(RTDBGSEGIDX) rtDbgModNm_SegmentCount(PRTDBGMODINT pMod)
145	{
146	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
147	return RTDbgModSegmentCount(pThis->hCnt);
148	}
149
150
151	/** @interface_method_impl{RTDBGMODVTDBG,pfnSegmentAdd} */
152	static DECLCALLBACK(int) rtDbgModNm_SegmentAdd(PRTDBGMODINT pMod, RTUINTPTR uRva, RTUINTPTR cb, const char *pszName, size_t cchName,
153	uint32_t fFlags, PRTDBGSEGIDX piSeg)
154	{
155	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
156	return RTDbgModSegmentAdd(pThis->hCnt, uRva, cb, pszName, fFlags, piSeg);
157	}
158
159
160	/** @interface_method_impl{RTDBGMODVTDBG,pfnImageSize} */
161	static DECLCALLBACK(RTUINTPTR) rtDbgModNm_ImageSize(PRTDBGMODINT pMod)
162	{
163	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
164	return RTDbgModImageSize(pThis->hCnt);
165	}
166
167
168	/** @interface_method_impl{RTDBGMODVTDBG,pfnRvaToSegOff} */
169	static DECLCALLBACK(RTDBGSEGIDX) rtDbgModNm_RvaToSegOff(PRTDBGMODINT pMod, RTUINTPTR uRva, PRTUINTPTR poffSeg)
170	{
171	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
172	return RTDbgModRvaToSegOff(pThis->hCnt, uRva, poffSeg);
173	}
174
175
176	/** @interface_method_impl{RTDBGMODVTDBG,pfnClose} */
177	static DECLCALLBACK(int) rtDbgModNm_Close(PRTDBGMODINT pMod)
178	{
179	PRTDBGMODNM pThis = (PRTDBGMODNM)pMod->pvDbgPriv;
180	RTDbgModRelease(pThis->hCnt);
181	pThis->hCnt = NIL_RTDBGMOD;
182	RTMemFree(pThis);
183	return VINF_SUCCESS;
184	}
185
186
187	/**
188	* Scans a NM-like map file.
189	*
190	* This implements both passes to avoid code duplication.
191	*
192	* @returns IPRT status code.
193	* @param pThis The instance data.
194	* @param pStrm The stream.
195	* @param fAddSymbols false in the first pass, true in the second.
196	*/
197	static int rtDbgModNmScanFile(PRTDBGMODNM pThis, PRTSTREAM pStrm, bool fAddSymbols)
198	{
199	/*
200	* Try parse the stream.
201	*/
202	RTUINTPTR SegZeroRva = fAddSymbols ? RTDbgModSegmentRva(pThis->hCnt, 0/iSeg/) : 0;
203	char szSym[RTDBG_SYMBOL_NAME_LENGTH] = "";
204	size_t cchMod = 0;
205	size_t offSym = 0;
206	unsigned cchAddr = 0;
207	uint64_t u64Low = UINT64_MAX;
208	uint64_t u64High = 0;
209	char szLine[512];
210	int rc;
211	while (RT_SUCCESS(rc = RTStrmGetLine(pStrm, szLine, sizeof(szLine))))
212	{
213	char chType;
214	if (RT_C_IS_XDIGIT(szLine[0]))
215	{
216	/*
217	* This is really what C was made for, string parsing.
218	*/
219	/* The the symbol value (address). */
220	uint64_t u64Addr;
221	char *psz;
222	rc = RTStrToUInt64Ex(szLine, &psz, 16, &u64Addr);
223	if (rc != VWRN_TRAILING_CHARS)
224	return VERR_DBG_NOT_NM_MAP_FILE;
225
226	/* Check the address width. */
227	if (cchAddr == 0)
228	cchAddr = psz == &szLine[8] ? 8 : 16;
229	if (psz != &szLine[cchAddr])
230	return VERR_DBG_NOT_NM_MAP_FILE;
231
232	/* Get the type and check for single space before symbol. */
233	chType = szLine[cchAddr + 1];
234	if ( RT_C_IS_BLANK(chType)
235	\|\| !RT_C_IS_BLANK(szLine[cchAddr + 2])
236	\|\| RT_C_IS_BLANK(szLine[cchAddr + 3]))
237	return VERR_DBG_NOT_NM_MAP_FILE;
238
239	/* Find the end of the symbol name. */
240	char *pszName = &szLine[cchAddr + 3];
241	char *pszNameEnd = pszName;
242	char ch;
243	while ((ch = *pszNameEnd) != '\0' && !RT_C_IS_SPACE(ch))
244	pszNameEnd++;
245
246	/* Any module name (linux /proc/kallsyms) following in brackets? */
247	char *pszModName = pszNameEnd;
248	char *pszModNameEnd = pszModName;
249	if (*pszModName)
250	{
251	*pszModName++ = '\0';
252	pszModNameEnd = pszModName = RTStrStripL(pszModName);
253	if (*pszModName != '\0')
254	{
255	if (*pszModName != '[')
256	return VERR_DBG_NOT_LINUX_KALLSYMS;
257	pszModNameEnd = ++pszModName;
258	while ((ch = *pszModNameEnd) != '\0' && ch != ']')
259	pszModNameEnd++;
260	if (ch != ']')
261	return VERR_DBG_NOT_LINUX_KALLSYMS;
262	char *pszEnd = pszModNameEnd + 1;
263	if ((size_t)(pszModNameEnd - pszModName) >= 128) /* lazy bird */
264	return VERR_DBG_NOT_LINUX_KALLSYMS;
265	*pszModNameEnd = '\0';
266	if (*pszEnd)
267	pszEnd = RTStrStripL(pszEnd);
268	if (*pszEnd)
269	return VERR_DBG_NOT_LINUX_KALLSYMS;
270	}
271	}
272
273	/*
274	* Did the module change? Then update the symbol prefix.
275	*/
276	if ( cchMod != (size_t)(pszModNameEnd - pszModName)
277	\|\| memcmp(pszModName, szSym, cchMod))
278	{
279	cchMod = pszModNameEnd - pszModName;
280	if (cchMod == 0)
281	offSym = 0;
282	else
283	{
284	memcpy(szSym, pszModName, cchMod);
285	szSym[cchMod] = '.';
286	offSym = cchMod + 1;
287	}
288	szSym[offSym] = '\0';
289	}
290
291	/*
292	* Validate the type and add the symbol if it's a type we care for.
293	*/
294	uint32_t fFlags = 0;
295	RTDBGSEGIDX iSegSym = 0;
296	switch (chType)
297	{
298	/* absolute */
299	case 'a':
300	case '?': /* /proc/kallsyms */
301	iSegSym = RTDBGSEGIDX_ABS;
302	/// @todo fFlags \|= RTDBG_SYM_FLAGS_LOCAL;
303	break;
304	case 'A':
305	iSegSym = RTDBGSEGIDX_ABS;
306	/// @todo fFlags \|= RTDBG_SYM_FLAGS_PUBLIC;
307	break;
308
309	case 'b':
310	/// @todo fFlags \|= RTDBG_SYM_FLAGS_LOCAL;
311	break;
312	case 'B':
313	/// @todo fFlags \|= RTDBG_SYM_FLAGS_PUBLIC;
314	break;
315
316	case 'c':
317	/// @todo fFlags \|= RTDBG_SYM_FLAGS_LOCAL \| RTDBG_SYM_FLAGS_COMMON;
318	break;
319	case 'C':
320	/// @todo fFlags \|= RTDBG_SYM_FLAGS_PUBLIC \| RTDBG_SYM_FLAGS_COMMON;
321	break;
322
323	case 'd':
324	/// @todo fFlags \|= RTDBG_SYM_FLAGS_LOCAL;
325	break;
326	case 'D':
327	/// @todo fFlags \|= RTDBG_SYM_FLAGS_PUBLIC;
328	break;
329
330	case 'g':
331	/// @todo fFlags \|= RTDBG_SYM_FLAGS_LOCAL;
332	break;
333	case 'G':
334	/// @todo fFlags \|= RTDBG_SYM_FLAGS_PUBLIC;
335	break;
336
337	case 'i':
338	/// @todo fFlags \|= RTDBG_SYM_FLAGS_LOCAL;
339	break;
340	case 'I':
341	/// @todo fFlags \|= RTDBG_SYM_FLAGS_PUBLIC;
342	break;
343
344	case 'r':
345	/// @todo fFlags \|= RTDBG_SYM_FLAGS_LOCAL \| RTDBG_SYM_FLAGS_CONST;
346	break;
347	case 'R':
348	/// @todo fFlags \|= RTDBG_SYM_FLAGS_PUBLIC \| RTDBG_SYM_FLAGS_CONST;
349	break;
350
351	case 's':
352	/// @todo fFlags \|= RTDBG_SYM_FLAGS_LOCAL;
353	break;
354	case 'S':
355	/// @todo fFlags \|= RTDBG_SYM_FLAGS_PUBLIC;
356	break;
357
358	case 't':
359	/// @todo fFlags \|= RTDBG_SYM_FLAGS_LOCAL \| RTDBG_SYM_FLAGS_TEXT;
360	break;
361	case 'T':
362	/// @todo fFlags \|= RTDBG_SYM_FLAGS_PUBLIC \| RTDBG_SYM_FLAGS_TEXT;
363	break;
364
365	case 'w':
366	/// @todo fFlags \|= RTDBG_SYM_FLAGS_WEAK \| RTDBG_SYM_FLAGS_LOCAL; //???
367	break;
368	case 'W':
369	/// @todo fFlags \|= RTDBG_SYM_FLAGS_WEAK \| RTDBG_SYM_FLAGS_PUBLIC;
370	break;
371
372	case 'N': /* debug */
373	case 'n':
374	case '-': /* stabs */
375	case 'u': /* undefined (/proc/kallsyms) */
376	case 'U':
377	case 'v': /* weakext */
378	case 'V':
379	iSegSym = NIL_RTDBGSEGIDX;
380	break;
381
382	default:
383	return VERR_DBG_NOT_NM_MAP_FILE;
384	}
385
386	if (iSegSym != NIL_RTDBGSEGIDX)
387	{
388	if (fAddSymbols)
389	{
390	size_t cchName = pszNameEnd - pszName;
391	if (cchName >= sizeof(szSym) - offSym)
392	cchName = sizeof(szSym) - offSym - 1;
393	memcpy(&szSym[offSym], pszName, cchName + 1);
394	if (iSegSym == 0)
395	rc = RTDbgModSymbolAdd(pThis->hCnt, szSym, iSegSym, u64Addr - SegZeroRva, 0/cb/, fFlags, NULL);
396	else
397	rc = RTDbgModSymbolAdd(pThis->hCnt, szSym, iSegSym, u64Addr, 0/cb/, fFlags, NULL);
398	if ( RT_FAILURE(rc)
399	&& rc != VERR_DBG_DUPLICATE_SYMBOL
400	&& rc != VERR_DBG_ADDRESS_CONFLICT) /* (don't be too strict) */
401	return rc;
402	}
403
404	/* Track segment span. */
405	if (iSegSym == 0)
406	{
407	if (u64Low > u64Addr)
408	u64Low = u64Addr;
409	if (u64High < u64Addr)
410	u64High = u64Addr;
411	}
412	}
413	}
414	else
415	{
416	/*
417	* This is either a blank line or a symbol without an address.
418	*/
419	RTStrStripR(szLine);
420	if (szLine[0])
421	{
422	size_t cch = strlen(szLine);
423	if (cchAddr == 0)
424	cchAddr = cch < 16+3 \|\| szLine[8+1] != ' ' ? 8 : 16;
425	if (cch < cchAddr+3+1)
426	return VERR_DBG_NOT_NM_MAP_FILE;
427	chType = szLine[cchAddr + 1];
428	if ( chType != 'U'
429	&& chType != 'w')
430	return VERR_DBG_NOT_NM_MAP_FILE;
431	char *pszType = RTStrStripL(szLine);
432	if (pszType != &szLine[cchAddr + 1])
433	return VERR_DBG_NOT_NM_MAP_FILE;
434	if (!RT_C_IS_BLANK(szLine[cchAddr + 2]))
435	return VERR_DBG_NOT_NM_MAP_FILE;
436	}
437	/* else: blank - ignored */
438	}
439	}
440
441	/*
442	* The final segment.
443	*/
444	if (rc == VERR_EOF)
445	{
446	if (fAddSymbols)
447	rc = VINF_SUCCESS;
448	else
449	{
450	if ( u64Low != UINT64_MAX
451	\|\| u64High != 0)
452	rc = RTDbgModSegmentAdd(pThis->hCnt, u64Low, u64High - u64Low + 1, "main", 0, NULL);
453	else /* No sensible symbols... throw an error instead? */
454	rc = RTDbgModSegmentAdd(pThis->hCnt, 0, 0, "main", 0, NULL);
455	}
456	}
457
458	return rc;
459	}
460
461
462	/** @interface_method_impl{RTDBGMODVTDBG,pfnTryOpen} */
463	static DECLCALLBACK(int) rtDbgModNm_TryOpen(PRTDBGMODINT pMod)
464	{
465	/*
466	* Try open the file and create an instance.
467	*/
468	PRTSTREAM pStrm;
469	int rc = RTStrmOpen(pMod->pszDbgFile, "r", &pStrm);
470	if (RT_SUCCESS(rc))
471	{
472	PRTDBGMODNM pThis = (PRTDBGMODNM)RTMemAlloc(sizeof(*pThis));
473	if (pThis)
474	{
475	rc = RTDbgModCreate(&pThis->hCnt, pMod->pszName, 0 /cbSeg/, 0 /fFlags/);
476	if (RT_SUCCESS(rc))
477	{
478	/*
479	* Scan the file twice, first to figure the segment
480	* sizes, then to add the symbol.
481	*/
482	rc = rtDbgModNmScanFile(pThis, pStrm, false /fAddSymbols/);
483	if (RT_SUCCESS(rc))
484	rc = RTStrmRewind(pStrm);
485	if (RT_SUCCESS(rc))
486	rc = rtDbgModNmScanFile(pThis, pStrm, true /fAddSymbols/);
487	if (RT_SUCCESS(rc))
488	{
489	RTStrmClose(pStrm);
490	pMod->pvDbgPriv = pThis;
491	return rc;
492	}
493	}
494	RTDbgModRelease(pThis->hCnt);
495	}
496	else
497	rc = VERR_NO_MEMORY;
498	RTStrmClose(pStrm);
499	}
500	return rc;
501	}
502
503
504
505	/** Virtual function table for the NM-like map file reader. */
506	DECLHIDDEN(RTDBGMODVTDBG const) g_rtDbgModVtDbgNm =
507	{
508	/.u32Magic = / RTDBGMODVTDBG_MAGIC,
509	/.fSupports = / RT_DBGTYPE_MAP,
510	/.pszName = / "nm",
511	/.pfnTryOpen = / rtDbgModNm_TryOpen,
512	/.pfnClose = / rtDbgModNm_Close,
513
514	/.pfnRvaToSegOff = / rtDbgModNm_RvaToSegOff,
515	/.pfnImageSize = / rtDbgModNm_ImageSize,
516
517	/.pfnSegmentAdd = / rtDbgModNm_SegmentAdd,
518	/.pfnSegmentCount = / rtDbgModNm_SegmentCount,
519	/.pfnSegmentByIndex = / rtDbgModNm_SegmentByIndex,
520
521	/.pfnSymbolAdd = / rtDbgModNm_SymbolAdd,
522	/.pfnSymbolCount = / rtDbgModNm_SymbolCount,
523	/.pfnSymbolByOrdinal = / rtDbgModNm_SymbolByOrdinal,
524	/.pfnSymbolByName = / rtDbgModNm_SymbolByName,
525	/.pfnSymbolByAddr = / rtDbgModNm_SymbolByAddr,
526
527	/.pfnLineAdd = / rtDbgModNm_LineAdd,
528	/.pfnLineCount = / rtDbgModNm_LineCount,
529	/.pfnLineByOrdinal = / rtDbgModNm_LineByOrdinal,
530	/.pfnLineByAddr = / rtDbgModNm_LineByAddr,
531
532	/.u32EndMagic = / RTDBGMODVTDBG_MAGIC
533	};
534

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

source: vbox/trunk/src/VBox/Runtime/common/dbg/dbgmodnm.cpp@ 33540

Download in other formats: