Enum Reference 

pub enum Reference {
    Call,
    Data,
    Got,
    Address {
        bytes: u8,
    },
}

What kind of thing a relocation is asking the linker for.

The first three are the distance from the end of an instruction to something, which is what every reference the code makes is, because this compiler generates position independent code and nothing else. They are told apart by what the linker is allowed to do about each one. The fourth is not a distance at all and is the only kind an image asks for, since an initializer holding the address of something holds the address itself.

Variants

Call

A call, which the linker may satisfy with a stub that reaches further than the four bytes would. R_X86_64_PLT32 on ELF, and the same relocation a branch gets on the other two.

Data

A datum, reached from the instruction pointer. R_X86_64_PC32 on ELF.

Got

A slot of the global offset table, reached from the instruction pointer, holding the address of something another object may be the one that defines.

The distance to the slot rather than to the thing, which is the whole difference: the distance to the thing is a number only a link that puts the thing in this program can work out, and a shared library is a link that does not. R_X86_64_REX_GOTPCRELX on ELF, which says the instruction is a mov with a REX prefix and lets the linker turn it back into the lea it would have been if the symbol had been here all along.

Address

The address itself, written into an image. int *p = &y; and nothing else in C.

Fields

bytes: u8

How many bytes of it are written, which is the pointer width except on a target with a narrower relocation for it. R_X86_64_64 and R_X86_64_32 on ELF.

Trait Implementations

impl Clone for Reference

fn clone(&self) -> Reference

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Reference

impl Debug for Reference

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

Formats the value using the given formatter.

impl Eq for Reference

impl PartialEq for Reference

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Reference