/* $Id: ldr.cpp 48935 2013-10-07 21:19:37Z vboxsync $ */ /** @file * IPRT - Binary Image Loader. */ /* * Copyright (C) 2006-2011 Oracle Corporation * * This file is part of VirtualBox Open Source Edition (OSE), as * available from http://www.virtualbox.org. This file is free software; * you can redistribute it and/or modify it under the terms of the GNU * General Public License (GPL) as published by the Free Software * Foundation, in version 2 as it comes in the "COPYING" file of the * VirtualBox OSE distribution. VirtualBox OSE is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. * * The contents of this file may alternatively be used under the terms * of the Common Development and Distribution License Version 1.0 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the * VirtualBox OSE distribution, in which case the provisions of the * CDDL are applicable instead of those of the GPL. * * You may elect to license modified versions of this file under the * terms and conditions of either the GPL or the CDDL or both. */ /******************************************************************************* * Header Files * *******************************************************************************/ #define LOG_GROUP RTLOGGROUP_LDR #include #include "internal/iprt.h" #include #include #include #include #include #include "internal/ldr.h" RTDECL(bool) RTLdrIsLoadable(const char *pszFilename) { /* * Try to load the library. */ RTLDRMOD hLib; int rc = RTLdrLoad(pszFilename, &hLib); if (RT_SUCCESS(rc)) { RTLdrClose(hLib); return true; } return false; } RT_EXPORT_SYMBOL(RTLdrIsLoadable); RTDECL(int) RTLdrGetSymbol(RTLDRMOD hLdrMod, const char *pszSymbol, void **ppvValue) { LogFlow(("RTLdrGetSymbol: hLdrMod=%RTldrm pszSymbol=%p:{%s} ppvValue=%p\n", hLdrMod, pszSymbol, pszSymbol, ppvValue)); /* * Validate input. */ AssertMsgReturn(rtldrIsValid(hLdrMod), ("hLdrMod=%p\n", hLdrMod), VERR_INVALID_HANDLE); AssertMsgReturn(pszSymbol, ("pszSymbol=%p\n", pszSymbol), VERR_INVALID_PARAMETER); AssertMsgReturn(VALID_PTR(ppvValue), ("ppvValue=%p\n", ppvValue), VERR_INVALID_PARAMETER); PRTLDRMODINTERNAL pMod = (PRTLDRMODINTERNAL)hLdrMod; //AssertMsgReturn(pMod->eState == LDR_STATE_OPENED, ("eState=%d\n", pMod->eState), VERR_WRONG_ORDER); /* * Do it. */ int rc; if (pMod->pOps->pfnGetSymbol) rc = pMod->pOps->pfnGetSymbol(pMod, pszSymbol, ppvValue); else { RTUINTPTR Value = 0; rc = pMod->pOps->pfnGetSymbolEx(pMod, NULL, 0, pszSymbol, &Value); if (RT_SUCCESS(rc)) { *ppvValue = (void *)(uintptr_t)Value; if ((uintptr_t)*ppvValue != Value) rc = VERR_BUFFER_OVERFLOW; } } LogFlow(("RTLdrGetSymbol: return %Rrc *ppvValue=%p\n", rc, *ppvValue)); return rc; } RT_EXPORT_SYMBOL(RTLdrGetSymbol); RTDECL(PFNRT) RTLdrGetFunction(RTLDRMOD hLdrMod, const char *pszSymbol) { PFNRT pfn; int rc = RTLdrGetSymbol(hLdrMod, pszSymbol, (void **)&pfn); if (RT_SUCCESS(rc)) return pfn; return NULL; } RT_EXPORT_SYMBOL(RTLdrGetFunction); RTDECL(RTLDRFMT) RTLdrGetFormat(RTLDRMOD hLdrMod) { AssertMsgReturn(rtldrIsValid(hLdrMod), ("hLdrMod=%p\n", hLdrMod), RTLDRFMT_INVALID); PRTLDRMODINTERNAL pMod = (PRTLDRMODINTERNAL)hLdrMod; return pMod->enmFormat; } RT_EXPORT_SYMBOL(RTLdrGetFormat); RTDECL(RTLDRTYPE) RTLdrGetType(RTLDRMOD hLdrMod) { AssertMsgReturn(rtldrIsValid(hLdrMod), ("hLdrMod=%p\n", hLdrMod), RTLDRTYPE_INVALID); PRTLDRMODINTERNAL pMod = (PRTLDRMODINTERNAL)hLdrMod; return pMod->enmType; } RT_EXPORT_SYMBOL(RTLdrGetType); RTDECL(RTLDRENDIAN) RTLdrGetEndian(RTLDRMOD hLdrMod) { AssertMsgReturn(rtldrIsValid(hLdrMod), ("hLdrMod=%p\n", hLdrMod), RTLDRENDIAN_INVALID); PRTLDRMODINTERNAL pMod = (PRTLDRMODINTERNAL)hLdrMod; return pMod->enmEndian; } RT_EXPORT_SYMBOL(RTLdrGetEndian); RTDECL(RTLDRARCH) RTLdrGetArch(RTLDRMOD hLdrMod) { AssertMsgReturn(rtldrIsValid(hLdrMod), ("hLdrMod=%p\n", hLdrMod), RTLDRARCH_INVALID); PRTLDRMODINTERNAL pMod = (PRTLDRMODINTERNAL)hLdrMod; return pMod->enmArch; } RT_EXPORT_SYMBOL(RTLdrGetArch); RTDECL(int) RTLdrClose(RTLDRMOD hLdrMod) { LogFlow(("RTLdrClose: hLdrMod=%RTldrm\n", hLdrMod)); /* * Validate input. */ AssertMsgReturn(rtldrIsValid(hLdrMod), ("hLdrMod=%p\n", hLdrMod), VERR_INVALID_HANDLE); PRTLDRMODINTERNAL pMod = (PRTLDRMODINTERNAL)hLdrMod; //AssertMsgReturn(pMod->eState == LDR_STATE_OPENED, ("eState=%d\n", pMod->eState), VERR_WRONG_ORDER); /* * Do it. */ int rc = pMod->pOps->pfnClose(pMod); AssertRC(rc); pMod->eState = LDR_STATE_INVALID; pMod->u32Magic++; if (pMod->pReader) { rc = pMod->pReader->pfnDestroy(pMod->pReader); AssertRC(rc); pMod->pReader = NULL; } RTMemFree(pMod); LogFlow(("RTLdrClose: returns VINF_SUCCESS\n")); return VINF_SUCCESS; } RT_EXPORT_SYMBOL(RTLdrClose);