Struct cranelift_jit::JITBuilder

pub struct JITBuilder { /* private fields */ }

A builder for JITModule.

Implementations

impl JITBuilder

pub fn new( libcall_names: Box<dyn Fn(LibCall) -> String + Send + Sync> ) -> ModuleResult<Self>

Create a new JITBuilder.

The libcall_names function provides a way to translate cranelift_codegen’s ir::LibCall enum to symbols. LibCalls are inserted in the IR as part of the legalization for certain floating point instructions, and for stack probes. If you don’t know what to use for this argument, use cranelift_module::default_libcall_names().

pub fn with_flags( flags: &[(&str, &str)], libcall_names: Box<dyn Fn(LibCall) -> String + Send + Sync> ) -> ModuleResult<Self>

Create a new JITBuilder with the given flags.

The libcall_names function provides a way to translate cranelift_codegen’s ir::LibCall enum to symbols. LibCalls are inserted in the IR as part of the legalization for certain floating point instructions, and for stack probes. If you don’t know what to use for this argument, use cranelift_module::default_libcall_names().

pub fn with_isa( isa: OwnedTargetIsa, libcall_names: Box<dyn Fn(LibCall) -> String + Send + Sync> ) -> Self

Create a new JITBuilder with an arbitrary target. This is mainly useful for testing.

To create a JITBuilder for native use, use the new or with_flags constructors instead.

The libcall_names function provides a way to translate cranelift_codegen’s ir::LibCall enum to symbols. LibCalls are inserted in the IR as part of the legalization for certain floating point instructions, and for stack probes. If you don’t know what to use for this argument, use cranelift_module::default_libcall_names().

pub fn symbol<K>(&mut self, name: K, ptr: *const u8) -> &mut Self

where K: Into<String>,

Define a symbol in the internal symbol table.

The JIT will use the symbol table to resolve names that are declared, but not defined, in the module being compiled. A common example is external functions. With this method, functions and data can be exposed to the code being compiled which are defined by the host.

If a symbol is defined more than once, the most recent definition will be retained.

If the JIT fails to find a symbol in its internal table, it will fall back to a platform-specific search (this typically involves searching the current process for public symbols, followed by searching the platform’s C runtime).

pub fn symbols<It, K>(&mut self, symbols: It) -> &mut Self

where It: IntoIterator<Item = (K, *const u8)>, K: Into<String>,

Define multiple symbols in the internal symbol table.

Using this is equivalent to calling symbol on each element.

pub fn symbol_lookup_fn( &mut self, symbol_lookup_fn: Box<dyn Fn(&str) -> Option<*const u8>> ) -> &mut Self

Add a symbol lookup fn.

Symbol lookup fn’s are used to lookup symbols when they couldn’t be found in the internal symbol table. Symbol lookup fn’s are called in reverse of the order in which they were added.

pub fn hotswap(&mut self, enabled: bool) -> &mut Self

Enable or disable hotswap support. See JITModule::prepare_for_function_redefine for more information.

Enabling hotswap support requires PIC code.