16#ifndef LIEF_ELF_SECTION_H
17#define LIEF_ELF_SECTION_H
23#include "LIEF/utils.hpp"
24#include "LIEF/visibility.h"
25#include "LIEF/Abstract/Section.hpp"
27#include "LIEF/ELF/enums.hpp"
28#include "LIEF/iterators.hpp"
33namespace DataHandler {
42class ObjectFileLayout;
50 friend class ExeLayout;
51 friend class ObjectFileLayout;
54 using segments_t = std::vector<Segment*>;
58 static constexpr uint32_t MAX_SECTION_SIZE = 2_GB;
60 enum class TYPE : uint64_t {
80 ANDROID_REL = 0x60000001,
81 ANDROID_RELA = 0x60000002,
82 LLVM_ADDRSIG = 0x6fff4c03,
83 ANDROID_RELR = 0x6fffff00,
84 GNU_ATTRIBUTES = 0x6ffffff5,
85 GNU_HASH = 0x6ffffff6,
86 GNU_VERDEF = 0x6ffffffd,
87 GNU_VERNEED = 0x6ffffffe,
88 GNU_VERSYM = 0x6fffffff,
91 _ARM_ID_ = 1LLU, _HEX_ID_ = 2LLU, _X86_64_ID_ = 2LLU,
94 ARM_EXIDX = 0x70000001U + (_ARM_ID_ << _ID_SHIFT_),
95 ARM_PREEMPTMAP = 0x70000002U + (_ARM_ID_ << _ID_SHIFT_),
96 ARM_ATTRIBUTES = 0x70000003U + (_ARM_ID_ << _ID_SHIFT_),
97 ARM_DEBUGOVERLAY = 0x70000004U + (_ARM_ID_ << _ID_SHIFT_),
98 ARM_OVERLAYSECTION = 0x70000005U + (_ARM_ID_ << _ID_SHIFT_),
100 HEX_ORDERED = 0x70000000 + (_HEX_ID_ << _ID_SHIFT_),
103 X86_64_UNWIND = 0x70000001 + (_X86_64_ID_ << _ID_SHIFT_),
105 MIPS_REGINFO = 0x70000006 + (_MIPS_ID_ << _ID_SHIFT_),
106 MIPS_OPTIONS = 0x7000000d + (_MIPS_ID_ << _ID_SHIFT_),
107 MIPS_ABIFLAGS = 0x7000002a + (_MIPS_ID_ << _ID_SHIFT_),
114 EXECINSTR = 0x000000004,
116 STRINGS = 0x000000020,
117 INFO_LINK = 0x000000040,
118 LINK_ORDER = 0x000000080,
119 OS_NONCONFORMING = 0x000000100,
122 COMPRESSED = 0x000000800,
123 GNU_RETAIN = 0x000200000,
124 EXCLUDE = 0x080000000,
127 _XCORE_ID_ = 1LLU, _HEX_ID_ = 3LLU, _X86_64_ID_ = 2LLU,
128 _MIPS_ID_ = 4LLU, _ARM_ID_ = 5LLU,
130 XCORE_SHF_DP_SECTION = 0x010000000 + (_XCORE_ID_ << _ID_SHIFT_),
131 XCORE_SHF_CP_SECTION = 0x020000000 + (_XCORE_ID_ << _ID_SHIFT_),
133 X86_64_LARGE = 0x010000000 + (_X86_64_ID_ << _ID_SHIFT_),
135 HEX_GPREL = 0x010000000 + (_HEX_ID_ << _ID_SHIFT_),
137 MIPS_NODUPES = 0x010000000 + (_MIPS_ID_ << _ID_SHIFT_),
138 MIPS_NAMES = 0x020000000 + (_MIPS_ID_ << _ID_SHIFT_),
139 MIPS_LOCAL = 0x040000000 + (_MIPS_ID_ << _ID_SHIFT_),
140 MIPS_NOSTRIP = 0x080000000 + (_MIPS_ID_ << _ID_SHIFT_),
141 MIPS_GPREL = 0x010000000 + (_MIPS_ID_ << _ID_SHIFT_),
142 MIPS_MERGE = 0x020000000 + (_MIPS_ID_ << _ID_SHIFT_),
143 MIPS_ADDR = 0x040000000 + (_MIPS_ID_ << _ID_SHIFT_),
144 MIPS_STRING = 0x080000000 + (_MIPS_ID_ << _ID_SHIFT_),
146 ARM_PURECODE = 0x020000000 + (_ARM_ID_ << _ID_SHIFT_),
149 static constexpr uint64_t FLAG_MASK = (uint64_t(1) << uint8_t(FLAGS::_ID_SHIFT_)) - 1;
150 static constexpr uint64_t TYPE_MASK = (uint64_t(1) << uint8_t(TYPE::_ID_SHIFT_)) - 1;
152 static TYPE type_from(uint32_t value,
ARCH arch);
153 static uint32_t to_value(TYPE type) {
154 return static_cast<uint64_t
>(type) & TYPE_MASK;
158 Section(
const std::string& name, TYPE type = TYPE::PROGBITS) :
164 ~Section()
override =
default;
166 Section& operator=(Section other);
167 Section(
const Section& other);
168 void swap(Section& other);
178 void content(
const std::vector<uint8_t>& data)
override;
180 void content(std::vector<uint8_t>&& data);
196 uint64_t
size()
const override {
200 void size(uint64_t size)
override;
202 void offset(uint64_t offset)
override;
210 return this->offset();
218 return original_size_;
223 return address_align_;
256 void type(
TYPE type) {
260 void flags(uint64_t flags) {
268 void file_offset(uint64_t offset) {
269 this->offset(offset);
272 void link(uint32_t link) {
276 void information(uint32_t info) {
280 void alignment(uint64_t alignment) {
281 address_align_ = alignment;
284 void entry_size(uint64_t entry_size) {
285 entry_size_ = entry_size;
288 it_segments segments() {
292 it_const_segments segments()
const {
296 Section& as_frame() {
301 bool is_frame()
const {
305 void accept(Visitor& visitor)
const override;
307 Section& operator+=(FLAGS c) {
312 Section& operator-=(FLAGS c) {
317 LIEF_API
friend std::ostream& operator<<(std::ostream& os,
const Section& section);
321 LIEF_LOCAL Section(
const T& header, ARCH arch);
323 span<uint8_t> writable_content();
324 ARCH arch_ = ARCH::NONE;
325 TYPE type_ = TYPE::SHT_NULL;
327 uint64_t original_size_ = 0;
330 uint64_t address_align_ = 0;
331 uint64_t entry_size_ = 0;
332 segments_t segments_;
333 bool is_frame_ =
false;
334 DataHandler::Handler* datahandler_ =
nullptr;
335 std::vector<uint8_t> content_c_;
Class which represents an ELF binary.
Definition ELF/Binary.hpp:59
Class which takes an ELF::Binary object and reconstructs a valid binary.
Definition ELF/Builder.hpp:51
Class which parses and transforms an ELF file into a ELF::Binary object.
Definition ELF/Parser.hpp:45
Class wich represents an ELF Section.
Definition ELF/Section.hpp:46
void size(uint64_t size) override
Change the section size.
span< const uint8_t > content() const override
Section's content.
uint64_t original_size() const
Original size of the section's data.
Definition ELF/Section.hpp:217
uint64_t flags() const
Section flags.
Definition ELF/Section.hpp:183
void remove(FLAGS flag)
Remove the given ELF_SECTION_FLAGS.
std::vector< FLAGS > flags_list() const
Return section flags as a std::set
uint64_t file_offset() const
Definition ELF/Section.hpp:209
TYPE
Definition ELF/Section.hpp:60
uint32_t link() const
Index to another section.
Definition ELF/Section.hpp:243
uint64_t size() const override
section's size (size in the binary, not the virtual size)
Definition ELF/Section.hpp:196
void content(const std::vector< uint8_t > &data) override
Set section content.
Section & clear(uint8_t value=0)
Clear the content of the section with the given value
bool has(const Segment &segment) const
True if the section is wrapped by the given Segment
FLAGS
Definition ELF/Section.hpp:110
uint64_t information() const
Section information. This meaning of this value depends on the section's type.
Definition ELF/Section.hpp:228
uint64_t offset() const override
Offset in the binary.
Definition ELF/Section.hpp:204
void add(FLAGS flag)
Add the given ELF_SECTION_FLAGS.
uint64_t alignment() const
Section file alignment.
Definition ELF/Section.hpp:222
bool has(FLAGS flag) const
True if the section has the given flag
uint64_t entry_size() const
This function returns the size of an element in the case of a section that contains an array.
Definition ELF/Section.hpp:238
Class which represents the ELF segments.
Definition Segment.hpp:44
Class which represents an abstracted section.
Definition Abstract/Section.hpp:30
Iterator which returns reference on container's values.
Definition iterators.hpp:48
ARCH
Machine architectures See current registered ELF machine architectures at: http://www....
Definition ELF/enums.hpp:30
LIEF namespace.
Definition Abstract/Binary.hpp:32