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.

Methods

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: Relocation> DynasmApi for Modifier<'a, R>

fn offset(&self) -> AssemblyOffset

Report the current offset into the assembling target

fn push(&mut self, value: u8)

Push a byte into the assembling target

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

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

fn push_i8(&mut self, value: i8)

Push a signed byte into the assembling target

fn push_i16(&mut self, value: i16)

Push a signed word into the assembling target

fn push_i32(&mut self, value: i32)

Push a signed doubleword into the assembling target

fn push_i64(&mut self, value: i64)

Push a signed quadword into the assembling target

fn push_u16(&mut self, value: u16)

Push an usigned word into the assembling target

fn push_u32(&mut self, value: u32)

Push an usigned doubleword into the assembling target

fn push_u64(&mut self, value: u64)

Push an usigned quadword into the assembling target

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.

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

Record the definition of a local label

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

Record the definition of a global label

fn dynamic_label(&mut self, id: DynamicLabel)

Record the definition of a dynamic label

fn global_relocation(&mut self, name: &'static str, offset: isize, kind: R)

fn dynamic_relocation(&mut self, id: DynamicLabel, offset: isize, kind: R)

fn forward_relocation(&mut self, name: &'static str, offset: isize, kind: R)

Equivalents of the previous functions but taking non-encoded relocations

fn backward_relocation(&mut self, name: &'static str, offset: isize, kind: R)

fn bare_relocation(&mut self, target: usize, kind: R)

fn forward_reloc(
    &mut self,
    name: &'static str,
    offset: isize,
    kind: <Self::Relocation as Relocation>::Encoding
)

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

fn backward_reloc(
    &mut self,
    name: &'static str,
    offset: isize,
    kind: <Self::Relocation as Relocation>::Encoding
)

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

fn global_reloc(
    &mut self,
    name: &'static str,
    offset: isize,
    kind: <Self::Relocation as Relocation>::Encoding
)

Record a relocation spot for a reference to a global label

fn dynamic_reloc(
    &mut self,
    id: DynamicLabel,
    offset: isize,
    kind: <Self::Relocation as Relocation>::Encoding
)

Record a relocation spot for a reference to a dynamic label

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

Record a relocation spot to an arbitrary target.

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

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

Extends a collection with the contents of an iterator.

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

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

Extends a collection with the contents of an iterator.

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

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.