Struct juicebox_asm::Runtime

impl Runtime

pub fn new() -> Runtime

Create a new Runtime.

+Runtime in juicebox_asm - Rust +

Struct juicebox_asm::Runtime

source ·

pub struct Runtime { /* private fields */ }

Expand description

A simple mmaped runtime with executable pages.

+

Implementations§

impl Runtime

pub fn new() -> Runtime

Create a new Runtime.

Panics

Panics if the mmap call fails.

-

pub unsafe fn add_code<F>(&mut self, code: impl AsRef<[u8]>) -> F

Add the block of code to the runtime and a get function pointer of type F.

+

pub fn with_profile() -> Runtime

pub unsafe fn add_code<F>(&mut self, code: impl AsRef<[u8]>) -> F

Add the block of code to the runtime and a get function pointer of type F.

Panics

Panics if the code does not fit on the mmaped pages or is empty.

Safety

@@ -12,26 +13,26 @@ pointer is only valid until the

let mut rt = juicebox_asm::Runtime::new();
 
 let code = [ 0x90 /* nop */, 0xc3 /* ret */ ];
-let nop = unsafe { rt.add_code::<extern "C" fn()>(&code) };
+let nop = unsafe { rt.add_code::<extern "C" fn()>(&code) };
 
 nop();

-

pub fn dump(&self)

Dump the code added so far to the runtime into a file called jit.asm in the processes +

pub fn dump(&self)

Dump the code added so far to the runtime into a file called jit.asm in the processes current working directory.

The code can be inspected with a disassembler as for example ndiasm from nasm.us.

ndisasm -b 64 jit.asm

Panics

Panics if writing the file failed.

-

Trait Implementations§

impl Drop for Runtime

fn drop(&mut self)

Unmaps the code page. This invalidates all the function pointer returned by +

Trait Implementations§

impl Drop for Runtime

fn drop(&mut self)

Unmaps the code page. This invalidates all the function pointer returned by Runtime::add_code.

-

Auto Trait Implementations§

impl UnwindSafe for Runtime

Blanket Implementations§

impl<T> Any for Twhere - T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for Twhere - T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for Twhere - T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

-

impl<T, U> Into for Twhere - U: From<T>,

fn into(self) -> U

Calls U::from(self).

+

Auto Trait Implementations§

impl RefUnwindSafe for Runtime

impl !Send for Runtime

impl !Sync for Runtime

impl Unpin for Runtime

impl UnwindSafe for Runtime

Blanket Implementations§

impl<T> Any for T
where + T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where + T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where + T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

+

impl<T, U> Into for T
where + U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of -From<T> for U chooses to do.

-

impl<T, U> TryFrom for Twhere - U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

impl<T, U> TryInto for Twhere - U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.