2017-03-30 16:56:49 +02:00
|
|
|
/* Copyright 2017 R. Thomas
|
|
|
|
* Copyright 2017 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.
|
|
|
|
*/
|
2018-09-12 14:44:18 +02:00
|
|
|
#include "pyAbstract.hpp"
|
2017-03-30 16:56:49 +02:00
|
|
|
#include "LIEF/Abstract/Section.hpp"
|
|
|
|
|
2018-09-12 14:44:18 +02:00
|
|
|
namespace LIEF {
|
2017-03-30 16:56:49 +02:00
|
|
|
template<class T>
|
2018-09-12 14:44:18 +02:00
|
|
|
using getter_t = T (Section::*)(void) const;
|
2017-03-30 16:56:49 +02:00
|
|
|
|
|
|
|
template<class T>
|
2018-09-12 14:44:18 +02:00
|
|
|
using setter_t = void (Section::*)(T);
|
2017-03-30 16:56:49 +02:00
|
|
|
|
2018-09-12 14:44:18 +02:00
|
|
|
template<>
|
|
|
|
void create<Section>(py::module& m) {
|
|
|
|
py::class_<Section, Object>(m, "Section")
|
Improve the ELF part of LIEF
Major changes (features):
* Enable adding multiple sections/segments - Executable (PIE or not), Library
* Enable adding multiple dynamic entries (DT_NEEDED, DT_INIT etc)
* Enable adding multiple relocations
* Enable adding multiple dynamic symbols
* Enable segment replacement
Major changes (API):
* Getters Binary::get_*name*() has been renamed to "name()"
* Binary::add(const DynamicEntry& entry) - To add an entry in the dynamic table
* Section& Binary::add(const Section& section, bool loaded = true) - To add a section(s)
* Segment& Binary::add(const Segment& segment, uint64_t base = 0) - To add segments
* Segment& replace(const Segment& new_segment, const Segment& original_segment, uint64_t base = 0)
* Binary's last_offset_section(), last_offset_segment(), next_virtual_address()
to have information about offset
* Binary's add_library(), get_library(), has_library() to handle
DT_NEEDED entries
Other changes:
* Binary::insert_content() - Use add(const Section&) or add(const Segment&) instead
* ELF's DataHandler has been cleaned
* Through LIEF::Section one can look for integers, strings, data
within the section (see LIEF::Section::search,
LIEF::Section::search_all)
* Through LIEF::Binary one can get *xref* of a number (or address)
see LIEF::Binary::xref function
* To access to the Abstract binary in Python, one can now use
the 'abstract' attribute. (e.g. binary.abstract.header.is_32)
Resolve: #83
Resolve: #66
Resolve: #48
2017-09-02 08:54:54 +02:00
|
|
|
.def(py::init(),
|
|
|
|
"Default constructor")
|
|
|
|
|
|
|
|
.def(py::init<const std::string&>(),
|
|
|
|
"Constructor from section name",
|
|
|
|
"name"_a)
|
2017-03-30 16:56:49 +02:00
|
|
|
|
|
|
|
.def_property("name",
|
2018-09-12 14:44:18 +02:00
|
|
|
[] (const Section& obj) {
|
2017-07-15 14:15:16 +02:00
|
|
|
return safe_string_converter(obj.name());
|
|
|
|
},
|
2018-09-12 14:44:18 +02:00
|
|
|
static_cast<setter_t<const std::string&>>(&Section::name),
|
2017-03-30 16:56:49 +02:00
|
|
|
"Section's name")
|
|
|
|
|
|
|
|
.def_property("size",
|
2018-09-12 14:44:18 +02:00
|
|
|
static_cast<getter_t<uint64_t>>(&Section::size),
|
|
|
|
static_cast<setter_t<uint64_t>>(&Section::size),
|
2017-03-30 16:56:49 +02:00
|
|
|
"Section's size")
|
|
|
|
|
|
|
|
.def_property("offset",
|
2018-09-12 14:44:18 +02:00
|
|
|
static_cast<getter_t<uint64_t>>(&Section::offset),
|
|
|
|
static_cast<setter_t<uint64_t>>(&Section::offset),
|
2017-03-30 16:56:49 +02:00
|
|
|
"Section's offset")
|
|
|
|
|
|
|
|
.def_property("virtual_address",
|
2018-09-12 14:44:18 +02:00
|
|
|
static_cast<getter_t<uint64_t>>(&Section::virtual_address),
|
|
|
|
static_cast<setter_t<uint64_t>>(&Section::virtual_address),
|
2019-05-03 20:40:13 +02:00
|
|
|
"Section's virtual address")
|
2017-03-30 16:56:49 +02:00
|
|
|
|
|
|
|
.def_property("content",
|
2018-09-12 14:44:18 +02:00
|
|
|
static_cast<getter_t<std::vector<uint8_t>>>(&Section::content),
|
|
|
|
static_cast<setter_t<const std::vector<uint8_t>&>>(&Section::content),
|
2017-04-16 10:21:23 +02:00
|
|
|
"Section's content")
|
2017-03-30 16:56:49 +02:00
|
|
|
|
|
|
|
.def_property_readonly("entropy",
|
2018-09-12 14:44:18 +02:00
|
|
|
&Section::entropy,
|
Improve the ELF part of LIEF
Major changes (features):
* Enable adding multiple sections/segments - Executable (PIE or not), Library
* Enable adding multiple dynamic entries (DT_NEEDED, DT_INIT etc)
* Enable adding multiple relocations
* Enable adding multiple dynamic symbols
* Enable segment replacement
Major changes (API):
* Getters Binary::get_*name*() has been renamed to "name()"
* Binary::add(const DynamicEntry& entry) - To add an entry in the dynamic table
* Section& Binary::add(const Section& section, bool loaded = true) - To add a section(s)
* Segment& Binary::add(const Segment& segment, uint64_t base = 0) - To add segments
* Segment& replace(const Segment& new_segment, const Segment& original_segment, uint64_t base = 0)
* Binary's last_offset_section(), last_offset_segment(), next_virtual_address()
to have information about offset
* Binary's add_library(), get_library(), has_library() to handle
DT_NEEDED entries
Other changes:
* Binary::insert_content() - Use add(const Section&) or add(const Segment&) instead
* ELF's DataHandler has been cleaned
* Through LIEF::Section one can look for integers, strings, data
within the section (see LIEF::Section::search,
LIEF::Section::search_all)
* Through LIEF::Binary one can get *xref* of a number (or address)
see LIEF::Binary::xref function
* To access to the Abstract binary in Python, one can now use
the 'abstract' attribute. (e.g. binary.abstract.header.is_32)
Resolve: #83
Resolve: #66
Resolve: #48
2017-09-02 08:54:54 +02:00
|
|
|
"Section's entropy")
|
|
|
|
|
|
|
|
.def("search",
|
2018-09-12 14:44:18 +02:00
|
|
|
static_cast<size_t (Section::*)(uint64_t, size_t, size_t) const>(&Section::search),
|
Improve the ELF part of LIEF
Major changes (features):
* Enable adding multiple sections/segments - Executable (PIE or not), Library
* Enable adding multiple dynamic entries (DT_NEEDED, DT_INIT etc)
* Enable adding multiple relocations
* Enable adding multiple dynamic symbols
* Enable segment replacement
Major changes (API):
* Getters Binary::get_*name*() has been renamed to "name()"
* Binary::add(const DynamicEntry& entry) - To add an entry in the dynamic table
* Section& Binary::add(const Section& section, bool loaded = true) - To add a section(s)
* Segment& Binary::add(const Segment& segment, uint64_t base = 0) - To add segments
* Segment& replace(const Segment& new_segment, const Segment& original_segment, uint64_t base = 0)
* Binary's last_offset_section(), last_offset_segment(), next_virtual_address()
to have information about offset
* Binary's add_library(), get_library(), has_library() to handle
DT_NEEDED entries
Other changes:
* Binary::insert_content() - Use add(const Section&) or add(const Segment&) instead
* ELF's DataHandler has been cleaned
* Through LIEF::Section one can look for integers, strings, data
within the section (see LIEF::Section::search,
LIEF::Section::search_all)
* Through LIEF::Binary one can get *xref* of a number (or address)
see LIEF::Binary::xref function
* To access to the Abstract binary in Python, one can now use
the 'abstract' attribute. (e.g. binary.abstract.header.is_32)
Resolve: #83
Resolve: #66
Resolve: #48
2017-09-02 08:54:54 +02:00
|
|
|
"Look for **integer** within the current section",
|
|
|
|
"number"_a, "pos"_a = 0, "size"_a = 0)
|
|
|
|
|
|
|
|
.def("search",
|
2018-09-12 14:44:18 +02:00
|
|
|
static_cast<size_t (Section::*)(const std::string&, size_t) const>(&Section::search),
|
Improve the ELF part of LIEF
Major changes (features):
* Enable adding multiple sections/segments - Executable (PIE or not), Library
* Enable adding multiple dynamic entries (DT_NEEDED, DT_INIT etc)
* Enable adding multiple relocations
* Enable adding multiple dynamic symbols
* Enable segment replacement
Major changes (API):
* Getters Binary::get_*name*() has been renamed to "name()"
* Binary::add(const DynamicEntry& entry) - To add an entry in the dynamic table
* Section& Binary::add(const Section& section, bool loaded = true) - To add a section(s)
* Segment& Binary::add(const Segment& segment, uint64_t base = 0) - To add segments
* Segment& replace(const Segment& new_segment, const Segment& original_segment, uint64_t base = 0)
* Binary's last_offset_section(), last_offset_segment(), next_virtual_address()
to have information about offset
* Binary's add_library(), get_library(), has_library() to handle
DT_NEEDED entries
Other changes:
* Binary::insert_content() - Use add(const Section&) or add(const Segment&) instead
* ELF's DataHandler has been cleaned
* Through LIEF::Section one can look for integers, strings, data
within the section (see LIEF::Section::search,
LIEF::Section::search_all)
* Through LIEF::Binary one can get *xref* of a number (or address)
see LIEF::Binary::xref function
* To access to the Abstract binary in Python, one can now use
the 'abstract' attribute. (e.g. binary.abstract.header.is_32)
Resolve: #83
Resolve: #66
Resolve: #48
2017-09-02 08:54:54 +02:00
|
|
|
"Look for **string** within the current section",
|
|
|
|
"str"_a, "pos"_a = 0)
|
|
|
|
|
|
|
|
.def("search_all",
|
2018-09-12 14:44:18 +02:00
|
|
|
static_cast<std::vector<size_t> (Section::*)(uint64_t, size_t) const>(&Section::search_all),
|
Improve the ELF part of LIEF
Major changes (features):
* Enable adding multiple sections/segments - Executable (PIE or not), Library
* Enable adding multiple dynamic entries (DT_NEEDED, DT_INIT etc)
* Enable adding multiple relocations
* Enable adding multiple dynamic symbols
* Enable segment replacement
Major changes (API):
* Getters Binary::get_*name*() has been renamed to "name()"
* Binary::add(const DynamicEntry& entry) - To add an entry in the dynamic table
* Section& Binary::add(const Section& section, bool loaded = true) - To add a section(s)
* Segment& Binary::add(const Segment& segment, uint64_t base = 0) - To add segments
* Segment& replace(const Segment& new_segment, const Segment& original_segment, uint64_t base = 0)
* Binary's last_offset_section(), last_offset_segment(), next_virtual_address()
to have information about offset
* Binary's add_library(), get_library(), has_library() to handle
DT_NEEDED entries
Other changes:
* Binary::insert_content() - Use add(const Section&) or add(const Segment&) instead
* ELF's DataHandler has been cleaned
* Through LIEF::Section one can look for integers, strings, data
within the section (see LIEF::Section::search,
LIEF::Section::search_all)
* Through LIEF::Binary one can get *xref* of a number (or address)
see LIEF::Binary::xref function
* To access to the Abstract binary in Python, one can now use
the 'abstract' attribute. (e.g. binary.abstract.header.is_32)
Resolve: #83
Resolve: #66
Resolve: #48
2017-09-02 08:54:54 +02:00
|
|
|
"Look for **all** integers within the current section",
|
|
|
|
"number"_a, "size"_a = 0)
|
|
|
|
|
|
|
|
.def("search_all",
|
2018-09-12 14:44:18 +02:00
|
|
|
static_cast<std::vector<size_t> (Section::*)(const std::string&) const>(&Section::search_all),
|
Improve the ELF part of LIEF
Major changes (features):
* Enable adding multiple sections/segments - Executable (PIE or not), Library
* Enable adding multiple dynamic entries (DT_NEEDED, DT_INIT etc)
* Enable adding multiple relocations
* Enable adding multiple dynamic symbols
* Enable segment replacement
Major changes (API):
* Getters Binary::get_*name*() has been renamed to "name()"
* Binary::add(const DynamicEntry& entry) - To add an entry in the dynamic table
* Section& Binary::add(const Section& section, bool loaded = true) - To add a section(s)
* Segment& Binary::add(const Segment& segment, uint64_t base = 0) - To add segments
* Segment& replace(const Segment& new_segment, const Segment& original_segment, uint64_t base = 0)
* Binary's last_offset_section(), last_offset_segment(), next_virtual_address()
to have information about offset
* Binary's add_library(), get_library(), has_library() to handle
DT_NEEDED entries
Other changes:
* Binary::insert_content() - Use add(const Section&) or add(const Segment&) instead
* ELF's DataHandler has been cleaned
* Through LIEF::Section one can look for integers, strings, data
within the section (see LIEF::Section::search,
LIEF::Section::search_all)
* Through LIEF::Binary one can get *xref* of a number (or address)
see LIEF::Binary::xref function
* To access to the Abstract binary in Python, one can now use
the 'abstract' attribute. (e.g. binary.abstract.header.is_32)
Resolve: #83
Resolve: #66
Resolve: #48
2017-09-02 08:54:54 +02:00
|
|
|
"Look for all **strings** within the current section",
|
|
|
|
"str"_a)
|
|
|
|
|
|
|
|
.def("__str__",
|
2018-09-12 14:44:18 +02:00
|
|
|
[] (const Section& section)
|
Improve the ELF part of LIEF
Major changes (features):
* Enable adding multiple sections/segments - Executable (PIE or not), Library
* Enable adding multiple dynamic entries (DT_NEEDED, DT_INIT etc)
* Enable adding multiple relocations
* Enable adding multiple dynamic symbols
* Enable segment replacement
Major changes (API):
* Getters Binary::get_*name*() has been renamed to "name()"
* Binary::add(const DynamicEntry& entry) - To add an entry in the dynamic table
* Section& Binary::add(const Section& section, bool loaded = true) - To add a section(s)
* Segment& Binary::add(const Segment& segment, uint64_t base = 0) - To add segments
* Segment& replace(const Segment& new_segment, const Segment& original_segment, uint64_t base = 0)
* Binary's last_offset_section(), last_offset_segment(), next_virtual_address()
to have information about offset
* Binary's add_library(), get_library(), has_library() to handle
DT_NEEDED entries
Other changes:
* Binary::insert_content() - Use add(const Section&) or add(const Segment&) instead
* ELF's DataHandler has been cleaned
* Through LIEF::Section one can look for integers, strings, data
within the section (see LIEF::Section::search,
LIEF::Section::search_all)
* Through LIEF::Binary one can get *xref* of a number (or address)
see LIEF::Binary::xref function
* To access to the Abstract binary in Python, one can now use
the 'abstract' attribute. (e.g. binary.abstract.header.is_32)
Resolve: #83
Resolve: #66
Resolve: #48
2017-09-02 08:54:54 +02:00
|
|
|
{
|
|
|
|
std::ostringstream stream;
|
|
|
|
stream << section;
|
|
|
|
std::string str = stream.str();
|
|
|
|
return str;
|
|
|
|
});
|
2018-09-12 14:44:18 +02:00
|
|
|
}
|
2017-03-30 16:56:49 +02:00
|
|
|
}
|