Struct MachBufferFinalized

pub struct MachBufferFinalized<T: CompilePhase> {
    pub unwind_info: SmallVec<[(CodeOffset, UnwindInst); 8]>,
    pub alignment: u32,
    /* private fields */
}

A MachBuffer once emission is completed: holds generated code and records, without fixups. This allows the type to be independent of the backend.

Fields

unwind_info: SmallVec<[(CodeOffset, UnwindInst); 8]>

Any unwind info at a given location.

alignment: u32

The required alignment of this buffer.

Implementations

impl MachBufferFinalized<Stencil>

pub fn apply_base_srcloc( self, base_srcloc: SourceLoc, ) -> MachBufferFinalized<Final>

Get a finalized machine buffer by applying the function’s base source location.

impl<T: CompilePhase> MachBufferFinalized<T>

pub fn get_srclocs_sorted(&self) -> &[T::MachSrcLocType]

Get a list of source location mapping tuples in sorted-by-start-offset order.

pub fn total_size(&self) -> CodeOffset

Get the total required size for the code.

pub fn stringify_code_bytes(&self) -> String

Return the code in this mach buffer as a hex string for testing purposes.

pub fn data(&self) -> &[u8]

Get the code bytes.

pub fn relocs(&self) -> &[FinalizedMachReloc]

Get the list of external relocations for this code.

pub fn traps(&self) -> &[MachTrap]

Get the list of trap records for this code.

pub fn user_stack_maps(&self) -> &[(CodeOffset, u32, UserStackMap)]

Get the user stack map metadata for this code.

pub fn take_user_stack_maps( &mut self, ) -> SmallVec<[(CodeOffset, u32, UserStackMap); 8]>

Take this buffer’s user strack map metadata.

pub fn call_sites(&self) -> impl Iterator<Item = FinalizedMachCallSite<'_>> + '_

Get the list of call sites for this code, along with associated exception handlers.

Each item yielded by the returned iterator is a struct with:

• The call site metadata record, with a ret_addr field directly accessible and denoting the offset of the return address into this buffer’s code.
• The slice of pairs of exception tags and code offsets denoting exception-handler entry points associated with this call site.

Trait Implementations

impl<T: Clone + CompilePhase> Clone for MachBufferFinalized<T>

where T::MachSrcLocType: Clone,

fn clone(&self) -> MachBufferFinalized<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + CompilePhase> Debug for MachBufferFinalized<T>

where T::MachSrcLocType: Debug,

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

Formats the value using the given formatter.

impl<'de, T: CompilePhase> Deserialize<'de> for MachBufferFinalized<T>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: PartialEq + CompilePhase> PartialEq for MachBufferFinalized<T>

where T::MachSrcLocType: PartialEq,

fn eq(&self, other: &MachBufferFinalized<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: CompilePhase> Serialize for MachBufferFinalized<T>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: CompilePhase> StructuralPartialEq for MachBufferFinalized<T>