/* Copyright 2017 - 2021 R. Thomas * Copyright 2017 - 2021 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/Relocation.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (Relocation::*)(void) const; template using setter_t = void (Relocation::*)(T); template<> void create(py::module& m) { py::class_(m, "Relocation") .def_property("address", static_cast>(&Relocation::address), static_cast>(&Relocation::address), "For :attr:`~lief.MachO.FILE_TYPES.OBJECT` or (:attr:`~lief.MachO.Relocation.origin` is :attr:`~lief.MachO.RELOCATION_ORIGINS.RELOC_TABLE`) this is an " "offset from the start of the " RST_CLASS_REF(lief.MachO.Section) " " "to the item containing the address requiring relocation.\n\n" "For :attr:`~lief.MachO.FILE_TYPES.EXECUTE` / :attr:`~lief.MachO.FILE_TYPES.DYLIB` or " "(:attr:`~lief.MachO.Relocation.origin` is :attr:`~lief.MachO.RELOCATION_ORIGINS.DYLDINFO`) " " this is an :attr:`~lief.MachO.SegmentCommand.virtual_address`", py::return_value_policy::reference_internal) .def_property("pc_relative", static_cast>(&Relocation::is_pc_relative), static_cast>(&Relocation::pc_relative), "Indicates whether the item containing the address to be " "relocated is part of a CPU instruction that uses PC-relative addressing.\n\n" "For addresses contained in PC-relative instructions, the CPU adds the address of " "the instruction to the address contained in the instruction.", py::return_value_policy::reference_internal) .def_property("type", static_cast>(&Relocation::type), static_cast>(&Relocation::type), "Type of the relocation according to the :attr:`~lief.MachO.Relocation.architecture` and/or :attr:`~lief.MachO.Relocation.origin` \n\n" "If :attr:`~lief.MachO.Relocation.origin` is :attr:`~lief.MachO.RELOCATION_ORIGINS.RELOC_TABLE`: \n\n" "See:\n" "\t * " RST_CLASS_REF(lief.MachO.X86_RELOCATION) "\n" "\t * " RST_CLASS_REF(lief.MachO.X86_64_RELOCATION) "\n" "\t * " RST_CLASS_REF(lief.MachO.PPC_RELOCATION) "\n" "\t * " RST_CLASS_REF(lief.MachO.ARM_RELOCATION) "\n" "\t * " RST_CLASS_REF(lief.MachO.ARM64_RELOCATION) "\n\n" "If :attr:`~lief.MachO.Relocation.origin` is :attr:`~lief.MachO.RELOCATION_ORIGINS.DYLDINFO`: \n\n" "See:\n" "\t * " RST_CLASS_REF(lief.MachO.REBASE_TYPES) "\n", py::return_value_policy::reference_internal) .def_property_readonly("architecture", &Relocation::architecture, "" RST_CLASS_REF(lief.MachO.CPU_TYPES) " of the relocation") .def_property_readonly("has_symbol", &Relocation::has_symbol, "``True`` if the relocation has a " RST_CLASS_REF(lief.MachO.Symbol) " associated with") .def_property_readonly("symbol", static_cast(&Relocation::symbol), "" RST_CLASS_REF(lief.MachO.Symbol) " associated with the relocation (if any)", py::return_value_policy::reference) .def_property_readonly("has_section", &Relocation::has_section, "``True`` if the relocation has a " RST_CLASS_REF(lief.MachO.Section) " associated with") .def_property_readonly("section", static_cast(&Relocation::section), "" RST_CLASS_REF(lief.MachO.Section) " associated with the relocation (if any)", py::return_value_policy::reference) .def_property_readonly("origin", &Relocation::origin, "" RST_CLASS_REF(lief.MachO.RELOCATION_ORIGINS) " of the relocation\n\n" "For :attr:`~lief.MachO.FILE_TYPES.OBJECT` file it should be :attr:`~lief.MachO.RELOCATION_ORIGINS.RELOC_TABLE` " "for :attr:`~lief.MachO.FILE_TYPES.EXECUTE` / :attr:`~lief.MachO.FILE_TYPES.DYLIB` it should be :attr:`~lief.MachO.RELOCATION_ORIGINS.DYLDINFO`") .def_property_readonly("has_segment", &Relocation::has_segment, "``True`` if the relocation has a " RST_CLASS_REF(lief.MachO.SegmentCommand) " associated with") .def_property_readonly("segment", static_cast(&Relocation::segment), "" RST_CLASS_REF(lief.MachO.SegmentCommand) " associated with the relocation (if any)", py::return_value_policy::reference) .def("__eq__", &Relocation::operator==) .def("__ne__", &Relocation::operator!=) .def("__hash__", [] (const Relocation& relocation) { return Hash::hash(relocation); }) .def("__str__", [] (const Relocation& relocation) { std::ostringstream stream; stream << relocation; std::string str = stream.str(); return str; }); } } }