llvm::orc::shared::WrapperFunctionCall Class Reference

Represents a serialized wrapper function call. More...

#include "llvm/ExecutionEngine/Orc/Shared/WrapperFunctionUtils.h"

Public Types
using	ArgDataBufferType = SmallVector< char, 24 >

Public Member Functions
	WrapperFunctionCall ()=default
	WrapperFunctionCall (ExecutorAddr FnAddr, ArgDataBufferType ArgData)
	Create a WrapperFunctionCall from a target function and arg buffer.
const ExecutorAddr &	getCallee () const
	Returns the address to be called.
const ArgDataBufferType &	getArgData () const
	Returns the argument data.
	operator bool () const
	WrapperFunctionCalls convert to true if the callee is non-null.
shared::WrapperFunctionResult	run () const
	Run call returning raw WrapperFunctionResult.
template<typename SPSRetT , typename RetT >
std::enable_if_t<!std::is_same< SPSRetT, void >::value, Error >	runWithSPSRet (RetT &RetVal) const
	Run call and deserialize result using SPS.
template<typename SPSRetT >
std::enable_if_t< std::is_same< SPSRetT, void >::value, Error >	runWithSPSRet () const
	Overload for SPS functions returning void.
Error	runWithSPSRetErrorMerged () const
	Run call and deserialize an SPSError result.

Static Public Member Functions
template<typename SPSSerializer , typename... ArgTs>
static Expected< WrapperFunctionCall >	Create (ExecutorAddr FnAddr, const ArgTs &...Args)
	Create a WrapperFunctionCall using the given SPS serializer to serialize the arguments.

Detailed Description

Represents a serialized wrapper function call.

Serializing calls themselves allows us to batch them: We can make one "run-wrapper-functions" utility and send it a list of calls to run.

The motivating use-case for this API is JITLink allocation actions, where we want to run multiple functions to finalize linked memory without having to make separate IPC calls for each one.

Definition at line 628 of file WrapperFunctionUtils.h.

Member Typedef Documentation

ArgDataBufferType

using llvm::orc::shared::WrapperFunctionCall::ArgDataBufferType = SmallVector<char, 24>

Definition at line 630 of file WrapperFunctionUtils.h.

Constructor & Destructor Documentation

WrapperFunctionCall() [1/2]

llvm::orc::shared::WrapperFunctionCall::WrapperFunctionCall ( )

default

Referenced by Create().

WrapperFunctionCall() [2/2]

llvm::orc::shared::WrapperFunctionCall::WrapperFunctionCall ( ExecutorAddr  FnAddr, ArgDataBufferType  ArgData  )

inline

Create a WrapperFunctionCall from a target function and arg buffer.

Definition at line 651 of file WrapperFunctionUtils.h.

Member Function Documentation

Create()

template<typename SPSSerializer , typename... ArgTs>

static Expected< WrapperFunctionCall > llvm::orc::shared::WrapperFunctionCall::Create ( ExecutorAddr  FnAddr, const ArgTs &...  Args  )

inlinestatic

Create a WrapperFunctionCall using the given SPS serializer to serialize the arguments.

Definition at line 635 of file WrapperFunctionUtils.h.

References llvm::SmallVectorTemplateCommon< T, typename >::data(), llvm::SmallVectorBase< Size_T >::empty(), llvm::inconvertibleErrorCode(), llvm::SmallVectorImpl< T >::resize(), llvm::SmallVectorBase< Size_T >::size(), and WrapperFunctionCall().

Referenced by llvm::orc::EPCGenericRTDyldMemoryManager::finalizeMemory(), and llvm::orc::PerfSupportPlugin::modifyPassConfig().

getArgData()

const ArgDataBufferType & llvm::orc::shared::WrapperFunctionCall::getArgData ( ) const

inline

Returns the argument data.

Definition at line 658 of file WrapperFunctionUtils.h.

Referenced by llvm::orc::shared::SPSSerializationTraits< SPSWrapperFunctionCall, WrapperFunctionCall >::serialize(), and llvm::orc::shared::SPSSerializationTraits< SPSWrapperFunctionCall, WrapperFunctionCall >::size().

getCallee()

const ExecutorAddr & llvm::orc::shared::WrapperFunctionCall::getCallee ( ) const

inline

Returns the address to be called.

Definition at line 655 of file WrapperFunctionUtils.h.

Referenced by llvm::orc::shared::SPSSerializationTraits< SPSWrapperFunctionCall, WrapperFunctionCall >::serialize(), and llvm::orc::shared::SPSSerializationTraits< SPSWrapperFunctionCall, WrapperFunctionCall >::size().

operator bool()

llvm::orc::shared::WrapperFunctionCall::operator bool ( ) const

inlineexplicit

WrapperFunctionCalls convert to true if the callee is non-null.

Definition at line 661 of file WrapperFunctionUtils.h.

run()

shared::WrapperFunctionResult llvm::orc::shared::WrapperFunctionCall::run ( ) const

inline

Run call returning raw WrapperFunctionResult.

Definition at line 664 of file WrapperFunctionUtils.h.

References llvm::orc::ExecutorAddr::toPtr().

Referenced by runWithSPSRet().

runWithSPSRet() [1/2]

template<typename SPSRetT >

std::enable_if_t< std::is_same< SPSRetT, void >::value, Error > llvm::orc::shared::WrapperFunctionCall::runWithSPSRet ( ) const

inline

Overload for SPS functions returning void.

Definition at line 689 of file WrapperFunctionUtils.h.

References E.

runWithSPSRet() [2/2]

template<typename SPSRetT , typename RetT >

std::enable_if_t<!std::is_same< SPSRetT, void >::value, Error > llvm::orc::shared::WrapperFunctionCall::runWithSPSRet ( RetT &  RetVal ) const

inline

Run call and deserialize result using SPS.

Definition at line 674 of file WrapperFunctionUtils.h.

References llvm::inconvertibleErrorCode(), run(), and llvm::Error::success().

runWithSPSRetErrorMerged()

Error llvm::orc::shared::WrapperFunctionCall::runWithSPSRetErrorMerged ( ) const

inline

Run call and deserialize an SPSError result.

SPSError returns and deserialization failures are merged into the returned error.

Definition at line 696 of file WrapperFunctionUtils.h.

References llvm::orc::shared::detail::fromSPSSerializable().

---

The documentation for this class was generated from the following file:

• include/llvm/ExecutionEngine/Orc/Shared/WrapperFunctionUtils.h