Debugger support for ELF platforms with the GDB JIT Interface. More...

#include "llvm/ExecutionEngine/Orc/Debugging/ELFDebugObjectPlugin.h"

Inheritance diagram for llvm::orc::ELFDebugObjectPlugin:

Public Member Functions
	ELFDebugObjectPlugin (ExecutionSession &ES, bool RequireDebugSections, Error &Err)
	Create the plugin for the given session and set additional options.
	~ELFDebugObjectPlugin () override
void	notifyMaterializing (MaterializationResponsibility &MR, jitlink::LinkGraph &G, jitlink::JITLinkContext &Ctx, MemoryBufferRef InputObj) override
Error	notifyFailed (MaterializationResponsibility &MR) override
Error	notifyRemovingResources (JITDylib &JD, ResourceKey K) override
void	notifyTransferringResources (JITDylib &JD, ResourceKey DstKey, ResourceKey SrcKey) override
void	modifyPassConfig (MaterializationResponsibility &MR, jitlink::LinkGraph &LG, jitlink::PassConfiguration &PassConfig) override

Detailed Description

Debugger support for ELF platforms with the GDB JIT Interface.

The plugin emits and manages a separate debug object allocation in addition to the LinkGraph's own allocation and it notifies the debugger when necessary.

Definition at line 39 of file ELFDebugObjectPlugin.h.

Constructor & Destructor Documentation

◆ ELFDebugObjectPlugin()

llvm::orc::ELFDebugObjectPlugin::ELFDebugObjectPlugin	(	ExecutionSession &	ES,
		bool	RequireDebugSections,
		Error &	Err )

Create the plugin for the given session and set additional options.

RequireDebugSections: Emit debug objects only if the LinkGraph contains debug info. Turning this off allows minimal debugging based on raw symbol names, but it comes with significant overhead for release configurations.

Definition at line 194 of file ELFDebugObjectPlugin.cpp.

References _, and llvm::orc::rt::RegisterJITLoaderGDBAllocActionName.

◆ ~ELFDebugObjectPlugin()

llvm::orc::ELFDebugObjectPlugin::~ELFDebugObjectPlugin ( )

overridedefault

References G, modifyPassConfig(), notifyFailed(), notifyMaterializing(), notifyRemovingResources(), and notifyTransferringResources().

Member Function Documentation

◆ modifyPassConfig()

void llvm::orc::ELFDebugObjectPlugin::modifyPassConfig	(	MaterializationResponsibility &	MR,
		jitlink::LinkGraph &	LG,
		jitlink::PassConfiguration &	PassConfig )

override

Definition at line 270 of file ELFDebugObjectPlugin.cpp.

References llvm::Alloc, assert(), llvm::orc::DebugObject::awaitTargetMem(), llvm::cantFail(), llvm::orc::DebugObject::collectTargetAlloc(), llvm::dbgs(), llvm::orc::DebugObject::failMaterialization(), G, llvm::jitlink::SectionRange::getStart(), llvm::orc::DebugObject::hasPendingTargetMem(), isDwarfSection(), LLVM_DEBUG, modifyPassConfig(), llvm::jitlink::PassConfiguration::PostAllocationPasses, llvm::jitlink::PassConfiguration::PostFixupPasses, llvm::orc::Read, llvm::orc::DebugObject::reportTargetMem(), llvm::Error::success(), llvm::Expected< T >::takeError(), llvm::orc::DebugObject::trackFinalizedAlloc(), llvm::orc::DebugObject::visitSections(), and llvm::orc::MaterializationResponsibility::withResourceKeyDo().

Referenced by modifyPassConfig(), and ~ELFDebugObjectPlugin().

◆ notifyFailed()

Error llvm::orc::ELFDebugObjectPlugin::notifyFailed ( MaterializationResponsibility & MR )

override

Definition at line 386 of file ELFDebugObjectPlugin.cpp.

References notifyFailed(), and llvm::Error::success().

Referenced by notifyFailed(), and ~ELFDebugObjectPlugin().

◆ notifyMaterializing()

void llvm::orc::ELFDebugObjectPlugin::notifyMaterializing	(	MaterializationResponsibility &	MR,
		jitlink::LinkGraph &	G,
		jitlink::JITLinkContext &	Ctx,
		MemoryBufferRef	InputObj )