GenericPlatformSymbolication.h

Go to the documentation of this file.

// Copyright Epic Games, Inc. All Rights Reserved.
 
#pragma once
 
#include "Containers/Array.h"
#include "Containers/Set.h"
#include "Containers/UnrealString.h"
#include "CoreTypes.h"
#include "GenericPlatform/GenericPlatformStackWalk.h"
#include "Serialization/Archive.h"
#include "Templates/UnrealTypeTraits.h"
 
struct FProgramCounterSymbolInfo;
template <typename T> struct TCallTraits;
 
struct FGenericPlatformSymbolInfo
{
    uint32 Line;
    uint64 Start;
    uint64 Length;
    int32 PathIdx;
    
    friend FArchive& operator<<( FArchive& Ar, FGenericPlatformSymbolInfo& Info )
    {
        return Ar << Info.Line << Info.Start << Info.Length << Info.PathIdx;
    }
};
 
 
struct FGenericPlatformSymbolData
{
    uint64 Start;
    uint64 Length;
    int32 NameIdx;
    TArray<FGenericPlatformSymbolInfo> SymbolInfo;
    
    friend FArchive& operator<<( FArchive& Ar, FGenericPlatformSymbolData& Info )
    {
        return Ar << Info.Start << Info.Length << Info.NameIdx << Info.SymbolInfo;
    }
};
 
 
struct FGenericPlatformSymbolDatabase
{
    FString Signature;
    FString Name;
    TArray<FGenericPlatformSymbolData> Symbols;
    TArray<FString> StringTable;
    
    friend FArchive& operator<<( FArchive& Ar, FGenericPlatformSymbolDatabase& Info )
    {
        return Ar << Info.Signature << Info.Name << Info.Symbols << Info.StringTable;
    }
};
 
 
struct FGenericPlatformSymbolDatabaseKeyFuncs
{
    enum { bAllowDuplicateKeys = 0 };
    typedef TCallTraits<FString>::ParamType KeyInitType;
    typedef TCallTraits<FGenericPlatformSymbolDatabase>::ParamType ElementInitType;
 
    static UE_FORCEINLINE_HINT KeyInitType GetSetKey(ElementInitType Element)
    {
        return Element.Signature;
    }
 
    static UE_FORCEINLINE_HINT bool Matches(KeyInitType A,KeyInitType B)
    {
        return A == B;
    }
 
    static UE_FORCEINLINE_HINT uint32 GetKeyHash(KeyInitType Key)
    {
        return GetTypeHash(Key);
    }
};
 
 
typedef TSet<FGenericPlatformSymbolDatabase, FGenericPlatformSymbolDatabaseKeyFuncs> FGenericPlatformSymbolDatabaseSet;
 
 
struct FGenericPlatformSymbolication
{
    static CORE_API bool LoadSymbolDatabaseForBinary(FString SourceFolder, FString BinaryPath, FString BinarySignature, TOptional<FString> Architecture, FGenericPlatformSymbolDatabase& OutDatabase);
    static CORE_API bool SaveSymbolDatabaseForBinary(FString TargetFolder, FString Name, FGenericPlatformSymbolDatabase& Database);
    
    static CORE_API bool SymbolInfoForStrippedSymbol(FGenericPlatformSymbolDatabase const& Database, uint64 ProgramCounter, uint64 ModuleOffset, FString ModuleSignature, FProgramCounterSymbolInfo& Info);
    
    static bool SymbolInfoForAddress(uint64 ProgramCounter, FProgramCounterSymbolInfo& Info) { return false; }
};