lief 1.0.0

Official Rust bindings for LIEF
use std::marker::PhantomData;

use super::commands::segment::Segment;
use super::section::Section;
use super::symbol::Symbol;
use crate::common::{FromFFI, into_optional};
use crate::declare_iterator;
use crate::generic;
use lief_ffi as ffi;

#[derive(Debug)]
/// Enum that represents the different to encode/represent a relocation
/// in a Mach-O file
pub enum Relocation<'a> {
    /// Relocation encoded in the rebase bytecode of `LC_DYLD_INFO`
    Dyld(Dyld<'a>),

    /// Relocation encoded in chained fixup `LC_DYLD_CHAINED_FIXUPS`
    Fixup(Fixup<'a>),

    /// Relocation of Mach-O object files (`.o`) wrapped by the sections
    Object(Object<'a>),

    /// Fallback structure
    Generic(Generic<'a>),
}

impl<'a> FromFFI<ffi::MachO_Relocation> for Relocation<'a> {
    fn from_ffi(ffi_entry: cxx::UniquePtr<ffi::MachO_Relocation>) -> Self {
        unsafe {
            let cmd_ref = ffi_entry.as_ref().unwrap();

            if ffi::MachO_RelocationDyld::classof(cmd_ref) {
                let raw = {
                    type From = cxx::UniquePtr<ffi::MachO_Relocation>;
                    type To = cxx::UniquePtr<ffi::MachO_RelocationDyld>;
                    std::mem::transmute::<From, To>(ffi_entry)
                };
                Relocation::Dyld(Dyld::from_ffi(raw))
            } else if ffi::MachO_RelocationFixup::classof(cmd_ref) {
                let raw = {
                    type From = cxx::UniquePtr<ffi::MachO_Relocation>;
                    type To = cxx::UniquePtr<ffi::MachO_RelocationFixup>;
                    std::mem::transmute::<From, To>(ffi_entry)
                };
                Relocation::Fixup(Fixup::from_ffi(raw))
            } else if ffi::MachO_RelocationObject::classof(cmd_ref) {
                let raw = {
                    type From = cxx::UniquePtr<ffi::MachO_Relocation>;
                    type To = cxx::UniquePtr<ffi::MachO_RelocationObject>;
                    std::mem::transmute::<From, To>(ffi_entry)
                };
                Relocation::Object(Object::from_ffi(raw))
            } else {
                Relocation::Generic(Generic::from_ffi(ffi_entry))
            }
        }
    }
}

/// Trait shared by **all** the relocations defined in [`Relocation`]
pub trait RelocationBase {
    #[doc(hidden)]
    fn get_base(&self) -> &ffi::MachO_Relocation;

    /// 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.
    fn is_pc_relative(&self) -> bool {
        self.get_base().is_pc_relative()
    }

    /// CPU architecture targeted by this relocation
    fn architecture(&self) -> u32 {
        self.get_base().architecture()
    }

    /// Origin of the relocation
    fn origin(&self) -> Origin {
        Origin::from(self.get_base().origin())
    }

    /// Symbol associated with the relocation (if any)
    fn symbol(&self) -> Option<Symbol<'_>> {
        into_optional(self.get_base().symbol())
    }

    /// Section associated with the section (if any)
    fn section(&self) -> Option<Section<'_>> {
        into_optional(self.get_base().section())
    }

    /// Segment command associated with the relocation (if any)
    fn segment(&self) -> Option<Segment<'_>> {
        into_optional(self.get_base().segment())
    }
}

/// Origin of a Mach-O relocation
#[allow(non_camel_case_types)]
#[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)]
pub enum Origin {
    UNKNOWN,
    DYLDINFO,
    RELOC_TABLE,
    CHAINED_FIXUPS,
}

impl From<u32> for Origin {
    fn from(value: u32) -> Self {
        match value {
            0 => Origin::UNKNOWN,
            1 => Origin::DYLDINFO,
            2 => Origin::RELOC_TABLE,
            3 => Origin::CHAINED_FIXUPS,
            _ => Origin::UNKNOWN,
        }
    }
}

impl RelocationBase for Relocation<'_> {
    fn get_base(&self) -> &ffi::MachO_Relocation {
        match &self {
            Relocation::Dyld(reloc) => reloc.get_base(),

            Relocation::Fixup(reloc) => reloc.get_base(),

            Relocation::Object(reloc) => reloc.get_base(),

            Relocation::Generic(reloc) => reloc.get_base(),
        }
    }
}

impl generic::Relocation for Relocation<'_> {
    fn as_generic(&self) -> &ffi::AbstractRelocation {
        match &self {
            Relocation::Dyld(reloc) => reloc.as_generic(),

            Relocation::Fixup(reloc) => reloc.as_generic(),

            Relocation::Object(reloc) => reloc.as_generic(),

            Relocation::Generic(reloc) => reloc.as_generic(),
        }
    }
}

impl std::fmt::Debug for &dyn RelocationBase {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("Section")
            .field("is_pc_relative", &self.is_pc_relative())
            .field("symbol", &self.symbol())
            .field("section", &self.section())
            .field("segment", &self.segment())
            .finish()
    }
}

pub struct Generic<'a> {
    ptr: cxx::UniquePtr<ffi::MachO_Relocation>,
    _owner: PhantomData<&'a ()>,
}

impl RelocationBase for Generic<'_> {
    fn get_base(&self) -> &ffi::MachO_Relocation {
        self.ptr.as_ref().unwrap()
    }
}

impl generic::Relocation for Generic<'_> {
    fn as_generic(&self) -> &ffi::AbstractRelocation {
        self.ptr.as_ref().unwrap().as_ref()
    }
}

impl std::fmt::Debug for Generic<'_> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let base = self as &dyn RelocationBase;
        f.debug_struct("Generic").field("base", &base).finish()
    }
}

impl FromFFI<ffi::MachO_Relocation> for Generic<'_> {
    fn from_ffi(ptr: cxx::UniquePtr<ffi::MachO_Relocation>) -> Self {
        Self {
            ptr,
            _owner: PhantomData,
        }
    }
}

/// Structure that represents a bytecode rebase operation (from `LC_DYLD_INFO`)
pub struct Dyld<'a> {
    ptr: cxx::UniquePtr<ffi::MachO_RelocationDyld>,
    _owner: PhantomData<&'a ()>,
}

impl FromFFI<ffi::MachO_RelocationDyld> for Dyld<'_> {
    fn from_ffi(ptr: cxx::UniquePtr<ffi::MachO_RelocationDyld>) -> Self {
        Self {
            ptr,
            _owner: PhantomData,
        }
    }
}

impl RelocationBase for Dyld<'_> {
    fn get_base(&self) -> &ffi::MachO_Relocation {
        self.ptr.as_ref().unwrap().as_ref()
    }
}

impl generic::Relocation for Dyld<'_> {
    fn as_generic(&self) -> &ffi::AbstractRelocation {
        self.ptr.as_ref().unwrap().as_ref().as_ref()
    }
}

impl std::fmt::Debug for Dyld<'_> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let base = self as &dyn RelocationBase;
        f.debug_struct("Dyld").field("base", &base).finish()
    }
}

/// Structure that represents a fixup (i.e. relocation) from the `LC_DYLD_CHAINED_FIXUPS`
/// command
pub struct Fixup<'a> {
    ptr: cxx::UniquePtr<ffi::MachO_RelocationFixup>,
    _owner: PhantomData<&'a ()>,
}

impl Fixup<'_> {
    /// The value that should be set at the address pointed by [`crate::Relocation::address`]
    /// if the imagebase chosen by the loader is [`crate::generic::Binary::imagebase`].
    /// Otherwise: [`Fixup::target`] - [`crate::generic::Binary::imagebase`] + new_imagebase.
    pub fn target(&self) -> u64 {
        self.ptr.target()
    }
    pub fn ptr_format(&self) -> u32 {
        self.ptr.ptr_format()
    }

    /// The address of this relocation is bound to its offset
    pub fn offset(&self) -> u32 {
        self.ptr.offset()
    }

    /// Return the (unscaled) next offset in the chain
    pub fn next(&self) -> u32 {
        self.ptr.next()
    }
}

impl FromFFI<ffi::MachO_RelocationFixup> for Fixup<'_> {
    fn from_ffi(ptr: cxx::UniquePtr<ffi::MachO_RelocationFixup>) -> Self {
        Self {
            ptr,
            _owner: PhantomData,
        }
    }
}

impl RelocationBase for Fixup<'_> {
    fn get_base(&self) -> &ffi::MachO_Relocation {
        self.ptr.as_ref().unwrap().as_ref()
    }
}

impl generic::Relocation for Fixup<'_> {
    fn as_generic(&self) -> &ffi::AbstractRelocation {
        self.ptr.as_ref().unwrap().as_ref().as_ref()
    }
}

impl std::fmt::Debug for Fixup<'_> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let base = self as &dyn RelocationBase;
        f.debug_struct("Fixup")
            .field("base", &base)
            .field("target", &self.target())
            .field("ptr_format", &self.ptr_format())
            .field("offset", &self.offset())
            .finish()
    }
}

/// This structure represents a relocation in a Mach-O object file (`.o`)
pub struct Object<'a> {
    ptr: cxx::UniquePtr<ffi::MachO_RelocationObject>,
    _owner: PhantomData<&'a ()>,
}

impl FromFFI<ffi::MachO_RelocationObject> for Object<'_> {
    fn from_ffi(ptr: cxx::UniquePtr<ffi::MachO_RelocationObject>) -> Self {
        Self {
            ptr,
            _owner: PhantomData,
        }
    }
}

impl RelocationBase for Object<'_> {
    fn get_base(&self) -> &ffi::MachO_Relocation {
        self.ptr.as_ref().unwrap().as_ref()
    }
}

impl generic::Relocation for Object<'_> {
    fn as_generic(&self) -> &ffi::AbstractRelocation {
        self.ptr.as_ref().unwrap().as_ref().as_ref()
    }
}

impl std::fmt::Debug for Object<'_> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let base = self as &dyn RelocationBase;
        f.debug_struct("Object").field("base", &base).finish()
    }
}

declare_iterator!(
    Relocations,
    Relocation<'a>,
    ffi::MachO_Relocation,
    ffi::MachO_Binary,
    ffi::MachO_Binary_it_relocations
);