Class that represents a Mach-O relocation. More...

#include <Relocation.hpp>

Inheritance diagram for LIEF::MachO::Relocation:

[legend]

Collaboration diagram for LIEF::MachO::Relocation:

[legend]

Public Types
enum class	ORIGIN { UNKNOWN = 0 , DYLDINFO = 1 , RELOC_TABLE = 2 , CHAINED_FIXUPS = 3 }

Public Types inherited from LIEF::Object
template<class T >
using	output_t = add_pointer_t<decay_t<T>>

template<class T >
using	output_const_t = add_pointer_t<add_const_t<decay_t<T>>>

Public Member Functions
	Relocation ()=default

	Relocation (uint64_t address, uint8_t type)

Relocation &	operator= (const Relocation &other)

	Relocation (const Relocation &other)

void	swap (Relocation &other) noexcept

	~Relocation () override=default

virtual std::unique_ptr< Relocation >	clone () const =0

virtual bool	is_pc_relative () const =0
	Indicates whether the item containing the address to be relocated is part of a CPU instruction that uses PC-relative addressing.

virtual uint8_t	type () const
	Type of the relocation according to the Relocation::architecture and/or the Relocation::origin.

Header::CPU_TYPE	architecture () const
	Achitecture targeted by this relocation.

virtual ORIGIN	origin () const =0
	Origin of the relocation.

bool	has_symbol () const
	`true` if the relocation has a symbol associated with

Symbol *	symbol ()
	Symbol associated with the relocation, if any, otherwise a nullptr.

const Symbol *	symbol () const

bool	has_section () const
	`true` if the relocation has a section associated with

Section *	section ()
	Section associated with the relocation, if any, otherwise a nullptr.

const Section *	section () const

bool	has_segment () const
	`true` if the relocation has a SegmentCommand associated with

SegmentCommand *	segment ()
	SegmentCommand associated with the relocation, if any, otherwise a nullptr.

const SegmentCommand *	segment () const

template<class T >
const T *	cast () const

template<class T >
T *	cast ()

virtual void	pc_relative (bool val)=0

virtual void	type (uint8_t type)

void	accept (Visitor &visitor) const override

virtual std::ostream &	print (std::ostream &os) const

virtual uint64_t	address () const
	Relocation's address.

virtual void	address (uint64_t address)

virtual size_t	size () const
	Relocation size in bits

virtual void	size (size_t size)

Public Member Functions inherited from LIEF::Relocation
	Relocation ()=default

	Relocation (uint64_t address, uint8_t size)
	Constructor from a relocation's address and size.

	~Relocation () override=default

Relocation &	operator= (const Relocation &)=default

	Relocation (const Relocation &)=default

void	swap (Relocation &other)

void	accept (Visitor &visitor) const override
	Method so that the `visitor` can visit us.

virtual bool	operator< (const Relocation &rhs) const
	Comparaison based on the Relocation's address

virtual bool	operator<= (const Relocation &rhs) const
	Comparaison based on the Relocation's address

virtual bool	operator> (const Relocation &rhs) const
	Comparaison based on the Relocation's address

virtual bool	operator>= (const Relocation &rhs) const
	Comparaison based on the Relocation's address

Public Member Functions inherited from LIEF::Object
	Object ()

	Object (const Object &other)

Object &	operator= (const Object &other)

template<class T >
output_t< T >	as ()

template<class T >
output_const_t< T >	as () const

virtual bool	operator== (const Object &other) const

virtual bool	operator!= (const Object &other) const

virtual	~Object ()

Static Public Attributes
static constexpr auto	R_SCATTERED = uint32_t(0x80000000)

static constexpr auto	R_ABS = uint32_t(0)

Detailed Description

Class that represents a Mach-O relocation.

See also

:

Member Enumeration Documentation

◆ ORIGIN

enum class LIEF::MachO::Relocation::ORIGIN

strong

Enumerator
UNKNOWN
DYLDINFO
RELOC_TABLE
CHAINED_FIXUPS

Constructor & Destructor Documentation

◆ Relocation() [1/3]

LIEF::MachO::Relocation::Relocation ( )

default

◆ Relocation() [2/3]

LIEF::MachO::Relocation::Relocation	(	uint64_t	address,
		uint8_t	type )

◆ Relocation() [3/3]

LIEF::MachO::Relocation::Relocation ( const Relocation & other )

◆ ~Relocation()

LIEF::MachO::Relocation::~Relocation ( )

overridedefault

Member Function Documentation

◆ accept()

void LIEF::MachO::Relocation::accept ( Visitor & visitor ) const

overridevirtual

Implements LIEF::Object.

Reimplemented in LIEF::MachO::RelocationDyld, LIEF::MachO::RelocationFixup, and LIEF::MachO::RelocationObject.

◆ address() [1/2]

virtual uint64_t LIEF::Relocation::address ( ) const

inlinevirtual

Relocation's address.

Reimplemented from LIEF::Relocation.

Reimplemented in LIEF::MachO::RelocationFixup, and LIEF::MachO::RelocationObject.

◆ address() [2/2]

virtual void LIEF::Relocation::address ( uint64_t address )

inlinevirtual

Reimplemented from LIEF::Relocation.

Reimplemented in LIEF::MachO::RelocationFixup.

◆ architecture()

Header::CPU_TYPE LIEF::MachO::Relocation::architecture ( ) const

inline

Achitecture targeted by this relocation.

◆ cast() [1/2]

template<class T >

T * LIEF::MachO::Relocation::cast ( )

inline

◆ cast() [2/2]

template<class T >

const T * LIEF::MachO::Relocation::cast ( ) const

inline

◆ clone()

virtual std::unique_ptr< Relocation > LIEF::MachO::Relocation::clone ( ) const

pure virtual

Implemented in LIEF::MachO::RelocationDyld, LIEF::MachO::RelocationFixup, and LIEF::MachO::RelocationObject.

◆ has_section()

bool LIEF::MachO::Relocation::has_section ( ) const

inline

true if the relocation has a section associated with

◆ has_segment()

bool LIEF::MachO::Relocation::has_segment ( ) const

inline

true if the relocation has a SegmentCommand associated with

◆ has_symbol()

bool LIEF::MachO::Relocation::has_symbol ( ) const

inline

true if the relocation has a symbol associated with

◆ is_pc_relative()

virtual bool LIEF::MachO::Relocation::is_pc_relative ( ) const

pure virtual

Indicates whether the item containing the address to be relocated is part of a CPU instruction that uses PC-relative addressing.

For addresses contained in PC-relative instructions, the CPU adds the address of the instruction to the address contained in the instruction.

Implemented in LIEF::MachO::RelocationDyld, LIEF::MachO::RelocationFixup, and LIEF::MachO::RelocationObject.

◆ operator=()

Relocation & LIEF::MachO::Relocation::operator= ( const Relocation & other )

◆ origin()

virtual ORIGIN LIEF::MachO::Relocation::origin ( ) const

pure virtual

Origin of the relocation.

Implemented in LIEF::MachO::RelocationDyld, LIEF::MachO::RelocationFixup, and LIEF::MachO::RelocationObject.

Referenced by LIEF::MachO::RelocationDyld::classof(), LIEF::MachO::RelocationFixup::classof(), and LIEF::MachO::RelocationObject::classof().

◆ pc_relative()

virtual void LIEF::MachO::Relocation::pc_relative ( bool val )

pure virtual

Implemented in LIEF::MachO::RelocationDyld, LIEF::MachO::RelocationFixup, and LIEF::MachO::RelocationObject.

◆ print()

virtual std::ostream & LIEF::MachO::Relocation::print ( std::ostream & os ) const

virtual

Reimplemented in LIEF::MachO::RelocationDyld, LIEF::MachO::RelocationFixup, and LIEF::MachO::RelocationObject.

◆ section() [1/2]

Section * LIEF::MachO::Relocation::section ( )

inline

Section associated with the relocation, if any, otherwise a nullptr.

◆ section() [2/2]

const Section * LIEF::MachO::Relocation::section ( ) const

inline

◆ segment() [1/2]

SegmentCommand * LIEF::MachO::Relocation::segment ( )

inline

SegmentCommand associated with the relocation, if any, otherwise a nullptr.

◆ segment() [2/2]

const SegmentCommand * LIEF::MachO::Relocation::segment ( ) const

inline

◆ size() [1/2]

virtual size_t LIEF::Relocation::size ( ) const

inlinevirtual

Relocation size in bits

Reimplemented from LIEF::Relocation.

Reimplemented in LIEF::MachO::RelocationObject.

◆ size() [2/2]

virtual void LIEF::Relocation::size ( size_t size )

inlinevirtual

Reimplemented from LIEF::Relocation.

Reimplemented in LIEF::MachO::RelocationObject.

◆ swap()

void LIEF::MachO::Relocation::swap ( Relocation & other )

noexcept

◆ symbol() [1/2]

Symbol * LIEF::MachO::Relocation::symbol ( )

inline

Symbol associated with the relocation, if any, otherwise a nullptr.

◆ symbol() [2/2]

const Symbol * LIEF::MachO::Relocation::symbol ( ) const

inline

◆ type() [1/2]

virtual uint8_t LIEF::MachO::Relocation::type ( ) const

inlinevirtual

Type of the relocation according to the Relocation::architecture and/or the Relocation::origin.

See:

◆ type() [2/2]

virtual void LIEF::MachO::Relocation::type ( uint8_t type )

virtual

Member Data Documentation

◆ R_ABS

auto LIEF::MachO::Relocation::R_ABS = uint32_t(0)

staticconstexpr

◆ R_SCATTERED

auto LIEF::MachO::Relocation::R_SCATTERED = uint32_t(0x80000000)

staticconstexpr

The documentation for this class was generated from the following file:

MachO/Relocation.hpp

Public Types

Public Member Functions

Static Public Attributes

Detailed Description

Member Enumeration Documentation

◆ ORIGIN

Constructor & Destructor Documentation

◆ Relocation() [1/3]

◆ Relocation() [2/3]

◆ Relocation() [3/3]

◆ ~Relocation()

Member Function Documentation

◆ accept()

◆ address() [1/2]

◆ address() [2/2]

◆ architecture()

◆ cast() [1/2]

◆ cast() [2/2]

◆ clone()

◆ has_section()

◆ has_segment()

◆ has_symbol()

◆ is_pc_relative()

◆ operator=()

◆ origin()

◆ pc_relative()

◆ print()

◆ section() [1/2]

◆ section() [2/2]

◆ segment() [1/2]

◆ segment() [2/2]

◆ size() [1/2]

◆ size() [2/2]

◆ swap()

◆ symbol() [1/2]

◆ symbol() [2/2]

◆ type() [1/2]

◆ type() [2/2]

Member Data Documentation

◆ R_ABS

◆ R_SCATTERED