/* Copyright 2017 - 2022 R. Thomas * Copyright 2017 - 2022 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 "LIEF/MachO/hash.hpp" #include "LIEF/MachO/Section.hpp" #include "LIEF/MachO/Relocation.hpp" #include "LIEF/MachO/SegmentCommand.hpp" #include "pyMachO.hpp" #include "pyIterators.hpp" namespace LIEF { namespace MachO { template using getter_t = T (Section::*)(void) const; template using setter_t = void (Section::*)(T); template using no_const_getter = T (Section::*)(void); template<> void create
(py::module& m) { py::class_ sec(m, "Section", "Class that represents a Mach-O section"); try { /* * it_relocations could be already registered by the SegmentCommand */ init_ref_iterator(sec, "it_relocations"); } catch (const std::runtime_error&) { } sec .def(py::init<>()) .def(py::init(), "Constructor from a section's name", "section_name"_a) .def(py::init(), "Constructor from a section's name and its content", "section_name"_a, "content"_a) .def_property("alignment", static_cast>(&Section::alignment), static_cast>(&Section::alignment), "Section's alignment as a power of 2") .def_property("relocation_offset", static_cast>(&Section::relocation_offset), static_cast>(&Section::relocation_offset), R"delim( Offset of the relocation table. This value should be 0 for executable and libraries as the relocations are managed by the :attr:`lief.MachO.DyldInfo.rebase` Other the other hand, for object files (``.o``) this value should not be 0 )delim") .def_property("numberof_relocations", static_cast>(&Section::numberof_relocations), static_cast>(&Section::numberof_relocations), "Number of relocations associated with this section") .def_property("type", static_cast>(&Section::type), static_cast>(&Section::type), R"delim( Type of the section. This value can help to determine the purpose of the section (c.f. :class:`~lief.MachO.MACHO_SECTION_TYPES`) )delim") .def_property_readonly("relocations", static_cast>(&Section::relocations), "Iterator over the " RST_CLASS_REF(lief.MachO.Relocation) " (if any)", py::return_value_policy::reference_internal) .def_property("reserved1", static_cast>(&Section::reserved1), static_cast>(&Section::reserved1), "According to the official ``loader.h`` file, this value is reserved for *offset* or *index*") .def_property("reserved2", static_cast>(&Section::reserved2), static_cast>(&Section::reserved2), "According to the official ``loader.h`` file, this value is reserved for *offset* or *index*") .def_property("reserved3", static_cast>(&Section::reserved3), static_cast>(&Section::reserved3), "According to the official ``loader.h`` file, this value is reserved for *offset* or *index*") .def_property("flags", static_cast>(&Section::flags), static_cast>(&Section::flags), "Section's flags masked with SECTION_FLAGS_MASK (see: :class:`~lief.MachO.MACHO_SECTION_FLAGS`)") .def_property_readonly("flags_list", static_cast>(&Section::flags_list), py::return_value_policy::reference_internal) .def_property_readonly("segment", static_cast(&Section::segment), "" RST_CLASS_REF(lief.MachO.SegmentCommand) " associated with the section or None if not present", py::return_value_policy::reference) .def_property("segment_name", static_cast>(&Section::segment_name), static_cast>(&Section::segment_name), R"delim( The segment name associated with the section )delim") .def_property_readonly("has_segment", &Section::has_segment, "True if the current section has a segment associated with") .def("has", static_cast(&Section::has), "Check if the section has the given " RST_CLASS_REF(lief.MachO.SECTION_FLAGS) "", "flag"_a) .def("add", static_cast(&Section::add), "Add the given " RST_CLASS_REF(lief.MachO.SECTION_FLAGS) "", "flag"_a) .def("remove", static_cast(&Section::remove), "Remove the given " RST_CLASS_REF(lief.MachO.SECTION_FLAGS) "", "flag"_a) .def(py::self += MACHO_SECTION_FLAGS()) .def(py::self -= MACHO_SECTION_FLAGS()) .def("__contains__", static_cast(&Section::has), "Check if the given " RST_CLASS_REF(lief.MachO.MACHO_SECTION_FLAGS) " is present") .def("__eq__", &Section::operator==) .def("__ne__", &Section::operator!=) .def("__hash__", [] (const Section& section) { return Hash::hash(section); }) .def("__str__", [] (const Section& section) { std::ostringstream stream; stream << section; std::string str = stream.str(); return str; }); } } }