/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 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/Section.hpp" #include "LIEF/MachO/Symbol.hpp" #include "LIEF/MachO/BindingInfo.hpp" #include "LIEF/MachO/ExportInfo.hpp" #include "pyIterator.hpp" #include "MachO/pyMachO.hpp" #include "enums_wrapper.hpp" namespace LIEF::MachO::py { template<> void create(nb::module_& m) { nb::class_ symbol(m, "Symbol", R"delim( Class that represents a Symbol in a Mach-O file. A Mach-O symbol can come from: 1. The symbols command (LC_SYMTAB / SymbolCommand) 2. The Dyld Export trie 3. The Dyld Symbol bindings )delim"_doc); enum_(symbol, "TOOLS") .value("NONE", Symbol::CATEGORY::NONE) .value("LOCAL", Symbol::CATEGORY::LOCAL) .value("EXTERNAL", Symbol::CATEGORY::EXTERNAL) .value("UNDEFINED", Symbol::CATEGORY::UNDEFINED) .value("INDIRECT_ABS", Symbol::CATEGORY::INDIRECT_ABS) .value("INDIRECT_LOCAL", Symbol::CATEGORY::INDIRECT_LOCAL); symbol .def(nb::init<>()) .def_prop_ro("demangled_name", &Symbol::demangled_name, "Symbol's unmangled name"_doc) .def_prop_rw("type", nb::overload_cast<>(&Symbol::type, nb::const_), nb::overload_cast(&Symbol::type)) .def_prop_rw("numberof_sections", nb::overload_cast<>(&Symbol::numberof_sections, nb::const_), nb::overload_cast(&Symbol::numberof_sections), R"delim( It returns the number of sections in which this symbol can be found. If the symbol can't be found in any section, it returns 0 (NO_SECT) )delim"_doc) .def_prop_rw("description", nb::overload_cast<>(&Symbol::description, nb::const_), nb::overload_cast(&Symbol::description), "Return information about the symbol (:class:`~lief.MachO.SYMBOL_DESCRIPTIONS`)"_doc) .def_prop_ro("has_export_info", &Symbol::has_export_info, "``True`` if the symbol has an " RST_CLASS_REF(lief.MachO.ExportInfo) " associated with"_doc) .def_prop_ro("origin", &Symbol::origin, "Return the " RST_CLASS_REF(lief.MachO.SYMBOL_ORIGINS) " of this symbol"_doc) .def_prop_ro("export_info", nb::overload_cast<>(&Symbol::export_info), "" RST_CLASS_REF(lief.MachO.ExportInfo) " associated with the symbol if any, or None"_doc, nb::rv_policy::reference_internal) .def_prop_ro("has_binding_info", &Symbol::has_binding_info, "``True`` if the symbol has an " RST_CLASS_REF(lief.MachO.BindingInfo) " associated with"_doc) .def_prop_ro("binding_info", nb::overload_cast<>(&Symbol::binding_info), "" RST_CLASS_REF(lief.MachO.BindingInfo) " associated with the symbol if any, or None"_doc, nb::rv_policy::reference_internal) LIEF_DEFAULT_STR(Symbol); } }