Enum RelocationKind

pub enum RelocationKind {
    Absolute,
    AbsoluteAArch64,
    Relative,
    SymRelGotBase,
    GotRelGotBase,
    Got,
    PltRelGotBase,
    PltRelative,
    GotRelative,
    TlsGd,
    TlsGdGot,
    TlsGdGotBase,
    TlsLd,
    TlsLdGot,
    TlsLdGotBase,
    DtpOff,
    GotTpOff,
    GotTpOffGot,
    GotTpOffGotBase,
    TpOff,
    TpOffAArch64,
    TlsDesc,
    TlsDescGot,
    TlsDescGotBase,
    TlsDescCall,
    None,
}

For additional information on ELF relocation types, see “ELF-64 Object File Format” - https://uclibc.org/docs/elf-64-gen.pdf. For information on the TLS related relocations, see “ELF Handling For Thread-Local Storage” - https://www.uclibc.org/docs/tls.pdf.

Variants

Absolute

The absolute address of a symbol or section.

AbsoluteAArch64

The absolute address of a symbol or section. We are going to extract only the offset within a page, so dynamic relocation creation must be skipped.

Relative

The address of the symbol, relative to the place of the relocation.

SymRelGotBase

The address of the symbol, relative to the base address of the GOT.

GotRelGotBase

The offset of the symbol’s GOT entry, relative to the start of the GOT.

Got

The address of the symbol’s GOT entry.

PltRelGotBase

The address of the symbol’s PLT entry, relative to the base address of the GOT.

PltRelative

The address of the symbol’s PLT entry, relative to the place of relocation.

GotRelative

The address of the symbol’s GOT entry, relative to the place of the relocation.

TlsGd

The address of a TLSGD structure, relative to the place of the relocation. A TLSGD (thread-local storage general dynamic) structure is a pair of values containing a module ID and the offset within that module’s TLS storage.

TlsGdGot

The address of the symbol’s TLSGD GOT entry.

TlsGdGotBase

The address of the symbol’s TLSGD GOT entry, relative to the start of the GOT.

TlsLd

The address of the TLS module ID for the shared object that we’re writing, relative to the place of the relocation. This is used when a TLS variable is defined and used within the same shared object.

TlsLdGot

The address of the TLS module ID for the shared object that we’re writing.

TlsLdGotBase

The address of the TLS module ID for the shared object that we’re writing, relative to the start of the GOT.

DtpOff

The offset of a thread-local within the TLS storage of DSO that defines that thread-local.

GotTpOff

The address of a GOT entry containing the offset of a TLS variable within the executable’s TLS storage, relative to the place of the relocation.

GotTpOffGot

The address of a GOT entry containing the offset of a TLS variable within the executable’s TLS storage.

GotTpOffGotBase

The address of a GOT entry containing the offset of a TLS variable within the executable’s TLS storage, relative to the start of the GOT.

TpOff

The offset of a TLS variable within the executable’s TLS storage.

TpOffAArch64

The offset of a TLS variable within the executable’s TLS storage, AArch64 TLS block layout.

TlsDesc

The address of a TLS descriptor structure, relative to the place of the relocation.

TlsDescGot

The address of a TLS descriptor structure.

TlsDescGotBase

The address of a TLS descriptor structure, relative to the start of the GOT.

TlsDescCall

Call to the TLS descriptor trampoline. Used only as a placeholder for a linker relaxation opportunity.

None

No relocation needs to be applied. Produced when we eliminate a relocation due to an optimisation.

Implementations

impl RelocationKind

pub fn is_tls(self) -> bool

Trait Implementations

impl Clone for RelocationKind

fn clone(&self) -> RelocationKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RelocationKind

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

Formats the value using the given formatter.

impl PartialEq for RelocationKind

fn eq(&self, other: &RelocationKind) -> 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 Copy for RelocationKind

impl Eq for RelocationKind

impl StructuralPartialEq for RelocationKind