Struct Extent 

pub struct Extent {
    pub name: String,
    pub start: usize,
    pub len: usize,
    pub align: u32,
    pub binding: Binding,
    pub visibility: Visibility,
    pub patch: Option<Patch>,
    pub hooked: usize,
    pub landings: Vec<Site>,
}

Where one function ended up.

How long a function is is a fact ELF records and Mach-O has no way to, so it is handed over rather than worked out again: the writer that wants it has it and the one that does not ignores it.

Fields

name: String

The function’s name, as the C program spelled it. The underscore an Apple symbol carries is the object writer’s business, not this one’s.

start: usize

Where its first instruction is.

len: usize

How many bytes of instructions it is, not counting the padding in front of the next one.

align: u32

What this one function asked to be aligned to, which is not always what the section it is in was aligned to.

The two are the same number only when this function is the one that asked for the most. Under Sections::functions each function is a section of its own and this is what that section is aligned to, so the number has to survive the trip rather than be recovered from the offset, which says nothing once the function is at zero in a section of its own.

binding: Binding

How the linker sees the name, which is what the C static reaches the object file as.

visibility: Visibility

How far outside a shared library holding this the name reaches.

patch: Option<Patch>

Where the room a patcher was promised is, or None in a function promised none, which is every function on a command line that did not ask. See Patch.

hooked: usize

How many bytes of int3 a hot patcher was promised in front of Extent::start, from __attribute__((ms_hook_prologue)), which are in front of the room Patch says is there too. Zero in every other function.

landings: Vec<Site>

Each call an unwind lands somewhere from, in the order they are in the function, which is empty in every function with no cleanup handler to run on the way out. See Site.

Implementations

impl Extent

pub fn ahead(&self) -> usize

How many of the function’s bytes are in front of Self::start, which is where its own section begins under Sections::functions rather than where its symbol is.

Trait Implementations

impl Clone for Extent

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Extent

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

Formats the value using the given formatter.

impl Eq for Extent

impl PartialEq for Extent

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Extent