AsmJit

Low-Latency Machine Code Generation

Docs

Interactive Parser

Support

GitHub

API Reference

Index Class List Build Instructions Breaking Changes Core Assembler Builder Compiler Function Logging Error Handling Instruction DB Virtual Memory Zone Memory Utilities X86 Backend ARM Commons AArch64 Backend

Index ⭢ Virtual Memory ⭢ asmjit::JitRuntime

asmjit::JitRuntime Class Reference

Inheritance diagram for asmjit::JitRuntime:

JIT execution runtime is a special Target that is designed to store and execute a generated code.

JIT runtime is the easiest way of using AsmJit as it abstracts allocation and deallocation of virtual memory where executable code can be placed and from which it can be executed as well.

Public Members

JitAllocator _allocator

 Public Attributes inherited from asmjit::Target

Environment _environment

CpuFeatures _cpuFeatures

Member Functions

JitRuntime(const JitRuntime& other) = delete

JitRuntime& operator=(const JitRuntime& other) = delete

Construction & Destruction

JitRuntime(const JitAllocator::CreateParams* params = nullptr) noexcept

~JitRuntime() noexcept override

Accessors

void reset(ResetPolicy resetPolicy = ResetPolicy::kSoft) noexcept

JitAllocator* allocator() const noexcept

Utilities

template<typename Func>

Error add(Func* dst, CodeHolder* code) noexcept

template<typename Func>

Error release(Func p) noexcept

Error _add(void** dst, CodeHolder* code) noexcept

Error _release(void* p) noexcept

 Public Member Functions inherited from asmjit::Target

Target(const Target& other) = delete

Target& operator=(const Target& other) = delete

Target() noexcept

~Target() noexcept

const Environment& environment() const noexcept

Arch arch() const noexcept

SubArch subArch() const noexcept

const CpuFeatures& cpuFeatures() const noexcept

JitRuntime::JitRuntime(

const JitAllocator::CreateParams* params = nullptr

)explicitnoexcept

Creates a JitRuntime instance.

JitRuntime::~JitRuntime()overridenoexcept

Destroys the JitRuntime instance.

void JitRuntime::reset(

ResetPolicy resetPolicy = ResetPolicy::kSoft

)noexcept

Resets the JitRuntime, freeing everything that was allocated by it.

Depending on resetPolicy the currently held memory can be either freed entirely when ResetPolicy::kHard is used, or the allocator can keep some of it for next allocations when ResetPolicy::kSoft is used, which is the default behavior.

JitAllocator* JitRuntime::allocator() constnoexcept

Returns the associated JitAllocator.

template<typename Func>

Error JitRuntime::add(

Func* dst,

CodeHolder* code

)noexcept

Allocates memory needed for a code stored in the CodeHolder and relocates the code to the pointer allocated.

The beginning of the memory allocated for the function is returned in dst. If failed Error code is returned and dst is explicitly set to nullptr (this means that you don't have to set it to null before calling add()).

template<typename Func>

Error JitRuntime::release(

Func p

)noexcept

Releases p which was obtained by calling add().

Error JitRuntime::_add(

void** dst,

CodeHolder* code

)virtualnoexcept

Type-unsafe version of add().

Error JitRuntime::_release(

void* p

)virtualnoexcept

Type-unsafe version of release().

JitAllocator JitRuntime::_allocator

Virtual memory allocator.

© 2018-2024 AsmJit Authors | GitHub | Chat | Blog

AsmJit and AsmTK libraries are open source software released under the Zlib license and can be used safely in any open-source or commercial product, statically or dynamically linked, and without having to advertise the use of the libraries. Code snippets and examples are released into public domain, see Unlicense for more details.