Struct dynasmrt::Modifier

pub struct Modifier<'a, R: Relocation> { /* fields omitted */ }

Allows modification of already committed assembly code. Contains an internal cursor into the emitted assembly, initialized to the start, that can be moved around either with the goto function, or just by assembling new code into this Modifier.

Implementations

impl<'a, R: Relocation> Modifier<'a, R>

pub fn goto(&mut self, offset: AssemblyOffset)

Move the modifier cursor to the selected location.

pub fn check(&self, offset: AssemblyOffset) -> Result<(), DynasmError>

Check that the modifier cursor has not moved past the specified location.

pub fn check_exact(&self, offset: AssemblyOffset) -> Result<(), DynasmError>

Check that the modifier cursor is exactly at the specified location.

Trait Implementations

impl<'a, R: Debug + Relocation> Debug for Modifier<'a, R>

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a, R: Relocation> DynasmApi for Modifier<'a, R>

pub fn offset(&self) -> AssemblyOffset

Report the current offset into the assembling target

pub fn push(&mut self, value: u8)

Push a byte into the assembling target

pub fn align(&mut self, alignment: usize, with: u8)

Push filler until the assembling target end is aligned to the given alignment.

pub fn push_i8(&mut self, value: i8)

Push a signed byte into the assembling target

pub fn push_i16(&mut self, value: i16)

Push a signed word into the assembling target

pub fn push_i32(&mut self, value: i32)

Push a signed doubleword into the assembling target

pub fn push_i64(&mut self, value: i64)

Push a signed quadword into the assembling target

pub fn push_u16(&mut self, value: u16)

Push an usigned word into the assembling target

pub fn push_u32(&mut self, value: u32)

Push an usigned doubleword into the assembling target

pub fn push_u64(&mut self, value: u64)

Push an usigned quadword into the assembling target

pub fn runtime_error(&self, msg: &'static str) -> !

This function is called in when a runtime error has to be generated. It panics.

impl<'a, R: Relocation> DynasmLabelApi for Modifier<'a, R>

type Relocation = R

The relocation info type this assembler uses.

pub fn local_label(&mut self, name: &'static str)

Record the definition of a local label

pub fn global_label(&mut self, name: &'static str)

Record the definition of a global label

pub fn dynamic_label(&mut self, id: DynamicLabel)

Record the definition of a dynamic label

pub fn global_relocation(
    &mut self,
    name: &'static str,
    target_offset: isize,
    field_offset: u8,
    ref_offset: u8,
    kind: R
)

Equivalent of global_reloc, but takes a non-encoded relocation

pub fn dynamic_relocation(
    &mut self,
    id: DynamicLabel,
    target_offset: isize,
    field_offset: u8,
    ref_offset: u8,
    kind: R
)

Equivalent of dynamic_reloc, but takes a non-encoded relocation

pub fn forward_relocation(
    &mut self,
    name: &'static str,
    target_offset: isize,
    field_offset: u8,
    ref_offset: u8,
    kind: R
)

Equivalent of forward_reloc, but takes a non-encoded relocation

pub fn backward_relocation(
    &mut self,
    name: &'static str,
    target_offset: isize,
    field_offset: u8,
    ref_offset: u8,
    kind: R
)

Equivalent of backward_reloc, but takes a non-encoded relocation

pub fn bare_relocation(
    &mut self,
    target: usize,
    field_offset: u8,
    ref_offset: u8,
    kind: R
)

Equivalent of bare_reloc, but takes a non-encoded relocation

pub fn forward_reloc(
    &mut self,
    name: &'static str,
    target_offset: isize,
    field_offset: u8,
    ref_offset: u8,
    kind: <Self::Relocation as Relocation>::Encoding
)

Record a relocation spot for a forward reference to a local label

pub fn backward_reloc(
    &mut self,
    name: &'static str,
    target_offset: isize,
    field_offset: u8,
    ref_offset: u8,
    kind: <Self::Relocation as Relocation>::Encoding
)

Record a relocation spot for a backward reference to a local label

pub fn global_reloc(
    &mut self,
    name: &'static str,
    target_offset: isize,
    field_offset: u8,
    ref_offset: u8,
    kind: <Self::Relocation as Relocation>::Encoding
)

Record a relocation spot for a reference to a global label

pub fn dynamic_reloc(
    &mut self,
    id: DynamicLabel,
    target_offset: isize,
    field_offset: u8,
    ref_offset: u8,
    kind: <Self::Relocation as Relocation>::Encoding
)

Record a relocation spot for a reference to a dynamic label

pub fn bare_reloc(
    &mut self,
    target: usize,
    field_offset: u8,
    ref_offset: u8,
    kind: <Self::Relocation as Relocation>::Encoding
)

Record a relocation spot to an arbitrary target.

impl<'a, 'b, R: Relocation> Extend<&'b u8> for Modifier<'a, R>

pub fn extend<T>(&mut self, iter: T) where
    T: IntoIterator<Item = &'b u8>, 

Extends a collection with the contents of an iterator.

pub fn extend_one(&mut self, item: A)

🔬 This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

pub fn extend_reserve(&mut self, additional: usize)

🔬 This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<'a, R: Relocation> Extend<u8> for Modifier<'a, R>

pub fn extend<T>(&mut self, iter: T) where
    T: IntoIterator<Item = u8>, 

Extends a collection with the contents of an iterator.

pub fn extend_one(&mut self, item: A)

🔬 This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

pub fn extend_reserve(&mut self, additional: usize)

🔬 This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.