ExecutionEngine-based ORC Utils

Collaboration diagram for ExecutionEngine-based ORC Utils:

Functions
LLVMOrcObjectLayerRef	LLVMOrcCreateRTDyldObjectLinkingLayerWithSectionMemoryManager (LLVMOrcExecutionSessionRef ES)
LLVMOrcObjectLayerRef	LLVMOrcCreateRTDyldObjectLinkingLayerWithMCJITMemoryManagerLikeCallbacks (LLVMOrcExecutionSessionRef ES, void *CreateContextCtx, LLVMMemoryManagerCreateContextCallback CreateContext, LLVMMemoryManagerNotifyTerminatingCallback NotifyTerminating, LLVMMemoryManagerAllocateCodeSectionCallback AllocateCodeSection, LLVMMemoryManagerAllocateDataSectionCallback AllocateDataSection, LLVMMemoryManagerFinalizeMemoryCallback FinalizeMemory, LLVMMemoryManagerDestroyCallback Destroy)
void	LLVMOrcRTDyldObjectLinkingLayerRegisterJITEventListener (LLVMOrcObjectLayerRef RTDyldObjLinkingLayer, LLVMJITEventListenerRef Listener)

Detailed Description

Function Documentation

LLVMOrcCreateRTDyldObjectLinkingLayerWithMCJITMemoryManagerLikeCallbacks()

LLVMOrcObjectLayerRef LLVMOrcCreateRTDyldObjectLinkingLayerWithMCJITMemoryManagerLikeCallbacks	(	LLVMOrcExecutionSessionRef	ES,
		void *	CreateContextCtx,
		LLVMMemoryManagerCreateContextCallback	CreateContext,
		LLVMMemoryManagerNotifyTerminatingCallback	NotifyTerminating,
		LLVMMemoryManagerAllocateCodeSectionCallback	AllocateCodeSection,
		LLVMMemoryManagerAllocateDataSectionCallback	AllocateDataSection,
		LLVMMemoryManagerFinalizeMemoryCallback	FinalizeMemory,
		LLVMMemoryManagerDestroyCallback	Destroy
	)

Create a RTDyldObjectLinkingLayer instance using MCJIT-memory-manager-like callbacks.

This is intended to simplify transitions for existing MCJIT clients. The callbacks used are similar (but not identical) to the callbacks for LLVMCreateSimpleMCJITMemoryManager: Unlike MCJIT, RTDyldObjectLinkingLayer will create a new memory manager for each object linked by calling the given CreateContext callback. This allows for code removal by destroying each allocator individually. Every allocator will be destroyed (if it has not been already) at RTDyldObjectLinkingLayer destruction time, and the NotifyTerminating callback will be called to indicate that no further allocation contexts will be created.

To implement MCJIT-like behavior clients can implement CreateContext, NotifyTerminating, and Destroy as:

void *CreateContext(void *CtxCtx) { return CtxCtx; } void NotifyTerminating(void *CtxCtx) { MyOriginalDestroy(CtxCtx); } void Destroy(void *Ctx) { }

This scheme simply reuses the CreateContextCtx pointer as the one-and-only allocation context.

LLVMOrcCreateRTDyldObjectLinkingLayerWithSectionMemoryManager()

LLVMOrcObjectLayerRef LLVMOrcCreateRTDyldObjectLinkingLayerWithSectionMemoryManager

(

LLVMOrcExecutionSessionRef

ES

)

Create a RTDyldObjectLinkingLayer instance using the standard SectionMemoryManager for memory management.

LLVMOrcRTDyldObjectLinkingLayerRegisterJITEventListener()

void LLVMOrcRTDyldObjectLinkingLayerRegisterJITEventListener	(	LLVMOrcObjectLayerRef	RTDyldObjLinkingLayer,
		LLVMJITEventListenerRef	Listener
	)

Add the given listener to the given RTDyldObjectLinkingLayer.

Note: Layer must be an RTDyldObjectLinkingLayer instance or behavior is undefined.