dbgas.cpp revision 8b4a8db7768e94d025f1216ecfcd50d727fa2b7c
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * IPRT - Debug Address Space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Copyright (C) 2009 Sun Microsystems, Inc.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * available from http://www.virtualbox.org. This file is free software;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * you can redistribute it and/or modify it under the terms of the GNU
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * General Public License (GPL) as published by the Free Software
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * The contents of this file may alternatively be used under the terms
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * of the Common Development and Distribution License Version 1.0
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * VirtualBox OSE distribution, in which case the provisions of the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * CDDL are applicable instead of those of the GPL.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * You may elect to license modified versions of this file under the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * terms and conditions of either the GPL or the CDDL or both.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * additional information or have any questions.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/*******************************************************************************
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync* Header Files *
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync*******************************************************************************/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/*******************************************************************************
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync* Structures and Typedefs *
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync*******************************************************************************/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Pointer to a module table entry. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Pointer to an address space mapping node. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Pointer to a name head. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Module entry.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsynctypedef struct RTDBGASMOD
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Node core, the module handle is the key. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the first mapping of the module or a segment within it. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the next module with an identical name. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * An address space mapping, either of a full module or a segment.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsynctypedef struct RTDBGASMAP
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The AVL node core. Contains the address range. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the next mapping of the module. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the module. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Which segment in the module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * This is NIL_RTDBGSEGIDX when the entire module is mapped. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Name in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsynctypedef struct RTDBGASNAME
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The string space node core.*/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The list of nodes */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Debug address space instance.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsynctypedef struct RTDBGASINT
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Magic value (RTDBGAS_MAGIC). */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Number of modules in the module address space. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the module table.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * The valid array length is given by cModules. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** AVL tree translating module handles to module entries. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** AVL tree mapping addresses to modules. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Names of the modules in the name space. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The first address the AS. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The last address in the AS. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The name of the address space. (variable length) */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Pointer to an a debug address space instance. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/*******************************************************************************
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync* Defined Constants And Macros *
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync*******************************************************************************/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Validates a context handle and returns rc if not valid. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync AssertReturn((pDbgAs)->u32Magic == RTDBGAS_MAGIC, (rc)); \
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync } while (0)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/*******************************************************************************
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync* Internal Functions *
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync*******************************************************************************/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic void rtDbgAsModuleUnlinkMod(PRTDBGASINT pDbgAs, PRTDBGASMOD pMod);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Creates an empty address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phDbgAs Where to store the address space handle on success.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param FirstAddr The first address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param LastAddr The last address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszName The name of the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsCreate(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr, const char *pszName)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Input validation.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync AssertReturn(FirstAddr < LastAddr, VERR_INVALID_PARAMETER);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Allocate memory for the instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASINT pDbgAs = (PRTDBGASINT)RTMemAlloc(RT_OFFSETOF(RTDBGASINT, szName[cchName + 1]));
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* initalize it. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Variant of RTDbgAsCreate that takes a name format string.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phDbgAs Where to store the address space handle on success.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param FirstAddr The first address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param LastAddr The last address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszNameFmt The name format of the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param va Format arguments.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsCreateV(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr, const char *pszNameFmt, va_list va)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync int rc = RTDbgAsCreate(phDbgAs, FirstAddr, LastAddr, pszName);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Variant of RTDbgAsCreate that takes a name format string.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phDbgAs Where to store the address space handle on success.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param FirstAddr The first address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param LastAddr The last address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszNameFmt The name format of the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ... Format arguments.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsCreateF(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr, const char *pszNameFmt, ...)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync int rc = RTDbgAsCreateV(phDbgAs, FirstAddr, LastAddr, pszNameFmt, va);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Callback used by RTDbgAsDestroy to free all mapping nodes.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns 0
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pNode The map node.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pvUser NULL.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic DECLCALLBACK(int) rtDbgAsDestroyMapCallback(PAVLRUINTPTRNODECORE pNode, void *pvUser)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Callback used by RTDbgAsDestroy to free all name space nodes.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns 0
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pStr The name node.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pvUser NULL.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic DECLCALLBACK(int) rtDbgAsDestroyNameCallback(PRTSTRSPACECORE pStr, void *pvUser)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Destroys the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * This means unlinking all the modules it currently contains, potentially
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * causing some or all of them to be destroyed as they are managed by
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * reference counting.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle. A NIL handle will
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * be quietly ignored.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Mark the address space invalid and release all the modules.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync ASMAtomicWriteU32(&pDbgAs->u32Magic, ~RTDBGAS_MAGIC);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTAvlrUIntPtrDestroy(&pDbgAs->MapTree, rtDbgAsDestroyMapCallback, NULL);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTStrSpaceDestroy(&pDbgAs->NameSpace, rtDbgAsDestroyNameCallback, NULL);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync while (i-- > 0)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDbgModRelease((RTDBGMOD)pDbgAs->paModules[i].Core.Key);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Gets the name of an address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns read only address space name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * NULL if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Gets the first address in an address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns The address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * 0 if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Gets the last address in an address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns The address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * 0 if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Gets the number of modules in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * This can be used together with RTDbgAsModuleByIndex
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * to enumerate the modules.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns The number of modules.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Common worker for RTDbgAsModuleLink and RTDbgAsModuleLinkSeg.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pDbgAs Pointer to the address space instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgMod The module to link.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param iSeg The segment to link or NIL if all.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address we're linking it at.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param cb The size of what we're linking.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszName The name of the module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncint rtDbgAsModuleLinkCommon(PRTDBGASINT pDbgAs, RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg,
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Check that the requested space is undisputed.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pAdjMod = (PRTDBGASMAP)RTAvlrUIntPtrGetBestFit(&pDbgAs->MapTree, Addr, false /* fAbove */);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pAdjMod = (PRTDBGASMAP)RTAvlrUIntPtrGetBestFit(&pDbgAs->MapTree, Addr, true /* fAbove */);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * First, create or find the module table entry.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMOD pMod = (PRTDBGASMOD)RTAvlPVGet(&pDbgAs->ModTree, hDbgMod);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Ok, we need a new entry. Grow the table if necessary.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync void *pvNew = RTMemRealloc(pDbgAs->paModules, sizeof(pDbgAs->paModules[0]) * (pDbgAs->cModules + 32));
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Add it to the name space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASNAME pName = (PRTDBGASNAME)RTStrSpaceGet(&pDbgAs->NameSpace, pszName);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pName = (PRTDBGASNAME)RTMemAlloc(sizeof(*pName) + cchName + 1);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pName->StrCore.pszString = (char *)memcpy(pName + 1, pszName, cchName + 1);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* quick, but unfair. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Create a mapping node.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTMemAlloc(sizeof(*pMap));
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync if (RTAvlrUIntPtrInsert(&pDbgAs->MapTree, &pMap->Core))
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlink the module if this was the only mapping.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Links a module into the address space at the give address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * The size of the mapping is determined using RTDbgModImageSize().
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_OUT_OF_RANGE if the specified address will put the module
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * outside the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_ADDRESS_CONFLICT if the mapping clashes with existing mappings.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgMod The module handle of the module to be linked in.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ImageAddr The address to link the module at.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleLink(RTDBGAS hDbgAs, RTDBGMOD hDbgMod, RTUINTPTR ImageAddr)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Invoke worker common with RTDbgAsModuleLinkSeg.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync return rtDbgAsModuleLinkCommon(pDbgAs, hDbgMod, NIL_RTDBGSEGIDX, ImageAddr, cb, pszName);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Links a segment into the address space at the give address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * The size of the mapping is determined using RTDbgModSegmentSize().
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_OUT_OF_RANGE if the specified address will put the module
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * outside the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_ADDRESS_CONFLICT if the mapping clashes with existing mappings.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgMod The module handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param iSeg The segment number (0-based) of the segment to be
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * linked in.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param SegAddr The address to link the segment at.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleLinkSeg(RTDBGAS hDbgAs, RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg, RTUINTPTR SegAddr)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Invoke worker common with RTDbgAsModuleLinkSeg.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync return rtDbgAsModuleLinkCommon(pDbgAs, hDbgMod, iSeg, SegAddr, cb, pszName);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Worker for RTDbgAsModuleUnlink, RTDbgAsModuleUnlinkByAddr and rtDbgAsModuleLinkCommon.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pDbgAs Pointer to the address space instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pMod The module to unlink.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic void rtDbgAsModuleUnlinkMod(PRTDBGASINT pDbgAs, PRTDBGASMOD pMod)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlink it from the name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASNAME pName = (PRTDBGASNAME)RTStrSpaceGet(&pDbgAs->NameSpace, RTDbgModName((RTDBGMOD)pMod->Core.Key));
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync for (PRTDBGASMOD pCur = pName->pHead; pCur; pCur = pCur->pNextName)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Free the name if this was the last reference to it.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pName = (PRTDBGASNAME)RTStrSpaceRemove(&pDbgAs->NameSpace, pName->StrCore.pszString);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Remove it from the module handle tree.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PAVLPVNODECORE pNode = RTAvlPVRemove(&pDbgAs->ModTree, pMod->Core.Key);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Remove it from the module table by replacing it by the last entry.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pDbgAs->paModules[iMod] = pDbgAs->paModules[pDbgAs->cModules];
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Worker for RTDbgAsModuleUnlink and RTDbgAsModuleUnlinkByAddr.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pDbgAs Pointer to the address space instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pMap The map to unlink and free.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic void rtDbgAsModuleUnlinkMap(PRTDBGASINT pDbgAs, PRTDBGASMAP pMap)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* remove from the tree */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PAVLRUINTPTRNODECORE pNode = RTAvlrUIntPtrRemove(&pDbgAs->MapTree, pMap->Core.Key);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* unlink */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync bool fFound = false;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync for (PRTDBGASMAP pCur = pMod->pMapHead; pCur; pCur = pCur->pNext)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* free it */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlinks all the mappings of a module from the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the module wasn't found.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgMod The module handle of the module to be unlinked.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleUnlink(RTDBGAS hDbgAs, RTDBGMOD hDbgMod)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMOD pMod = (PRTDBGASMOD)RTAvlPVGet(&pDbgAs->ModTree, hDbgMod);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unmap all but
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlinks the mapping at the specified address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if no module or segment is mapped at that address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address within the mapping to be unlinked.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleUnlinkByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlink it from the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlink the module as well if it's the last mapping it has.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Get a the handle of a module in the address space by is index.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns A retained handle to the specified module. The caller must release
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * the returned reference.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * NIL_RTDBGMOD if invalid index or handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param iModule The index of the module to get.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @remarks The module indexes may change after calls to RTDbgAsModuleLink,
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * RTDbgAsModuleLinkSeg, RTDbgAsModuleUnlink and
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * RTDbgAsModuleUnlinkByAddr.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(RTDBGMOD) RTDbgAsModuleByIndex(RTDBGAS hDbgAs, uint32_t iModule)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Get, retain and return it.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGMOD hMod = (RTDBGMOD)pDbgAs->paModules[iModule].Core.Key;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Queries mapping module information by handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if no mapping was found at the specified address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr Address within the mapping of the module or segment.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phMod Where to the return the retained module handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pAddr Where to return the base address of the mapping.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param piSeg Where to return the segment index. This is set to
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * NIL if the entire module is mapped as a single
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * mapping. Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTDBGMOD phMod, PRTUINTPTR pAddr, PRTDBGSEGIDX piSeg)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Set up the return values.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Queries mapping module information by name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if no mapping was found at the specified address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_OUT_OF_RANGE if the name index was out of range.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszName The module name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param iName There can be more than one module by the same name
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * in an address space. This argument indicates which
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * is ment. (0 based)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phMod Where to the return the retained module handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleByName(RTDBGAS hDbgAs, const char *pszName, uint32_t iName, PRTDBGMOD phMod)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASNAME pName = (PRTDBGASNAME)RTStrSpaceGet(&pDbgAs->NameSpace, pszName);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync while (iName-- > 0)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Get, retain and return it.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Adds a symbol to a module in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAdd for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if no module was found at the specified address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszSymbol The symbol name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address of the symbol.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param cb The size of the symbol.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolAdd(RTDBGAS hDbgAs, const char *pszSymbol, RTUINTPTR Addr, uint32_t cb)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync return RTDbgModSymbolAdd(hMod, pszSymbol, pMap->iSeg, Addr - pMap->Core.Key, cb);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a symbol by address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAddr for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address which closest symbol is requested.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param poffDisp Where to return the distance between the symbol
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * and address. Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pSymbol Where to return the symbol info.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGSYMBOL pSymbol)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync return RTDbgModSymbolByAddr(hMod, pMap->iSeg, Addr - pMap->Core.Key, poffDisp, pSymbol);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a symbol by address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAddrA for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address which closest symbol is requested.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param poffDisp Where to return the distance between the symbol
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * and address. Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ppSymbol Where to return the pointer to the allocated
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * symbol info. Always set. Free with RTDbgSymbolFree.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolByAddrA(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGSYMBOL *ppSymbol)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync return RTDbgModSymbolByAddrA(hMod, pMap->iSeg, Addr - pMap->Core.Key, poffDisp, ppSymbol);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a symbol by name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_SYMBOL_NOT_FOUND if not found.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszSymbol The symbol name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pSymbol Where to return the symbol info.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolByName(RTDBGAS hDbgAs, const char *pszSymbol, PRTDBGSYMBOL pSymbol)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Iterate the modules, looking for the symbol.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGMOD hMod = (RTDBGMOD)pDbgAs->paModules[i].Core.Key;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync int rc = RTDbgModSymbolByName(hMod, pszSymbol, pSymbol);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a symbol by name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_SYMBOL_NOT_FOUND if not found.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszSymbol The symbol name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ppSymbol Where to return the pointer to the allocated
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * symbol info. Always set. Free with RTDbgSymbolFree.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolByNameA(RTDBGAS hDbgAs, const char *pszSymbol, PRTDBGSYMBOL *ppSymbol)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Iterate the modules, looking for the symbol.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGMOD hMod = (RTDBGMOD)pDbgAs->paModules[i].Core.Key;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync int rc = RTDbgModSymbolByNameA(hMod, pszSymbol, ppSymbol);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a line number by address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAddrA for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address which closest symbol is requested.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param poffDisp Where to return the distance between the line
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * number and address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pLine Where to return the line number information.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsLineByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGLINE pLine)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync return RTDbgModLineByAddr(hMod, pMap->iSeg, Addr - pMap->Core.Key, poffDisp, pLine);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a line number by address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAddrA for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address which closest symbol is requested.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param poffDisp Where to return the distance between the line
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * number and address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ppLine Where to return the pointer to the allocated line
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * number info. Always set. Free with RTDbgLineFree.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsLineByAddrA(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGLINE *ppLine)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.