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;
157 Section(
const std::string& name, TYPE type = TYPE::PROGBITS) :
163 ~Section()
override =
default;
165 Section& operator=(Section other) {
169 Section(
const Section& other);
170 void swap(Section& other)
noexcept;
180 void content(
const std::vector<uint8_t>& data)
override;
182 void content(std::vector<uint8_t>&& data);
198 uint64_t
size()
const override {
202 void size(uint64_t size)
override;
204 void offset(uint64_t offset)
override;
212 return this->offset();
220 return original_size_;
225 return address_align_;
258 void type(
TYPE type) {
262 void flags(uint64_t flags) {
270 void file_offset(uint64_t offset) {
271 this->offset(offset);
274 void link(uint32_t link) {
278 void information(uint32_t info) {
282 void alignment(uint64_t alignment) {
283 address_align_ = alignment;
286 void entry_size(uint64_t entry_size) {
287 entry_size_ = entry_size;
290 it_segments segments() {
294 it_const_segments segments()
const {
298 Section& as_frame() {
303 bool is_frame()
const {
307 void accept(Visitor& visitor)
const override;
309 Section& operator+=(FLAGS c) {
314 Section& operator-=(FLAGS c) {
319 LIEF_API
friend std::ostream& operator<<(std::ostream& os,
const Section& section);
323 LIEF_LOCAL Section(
const T& header, ARCH arch);
325 span<uint8_t> writable_content();
326 ARCH arch_ = ARCH::NONE;
327 TYPE type_ = TYPE::SHT_NULL;
329 uint64_t original_size_ = 0;
332 uint64_t address_align_ = 0;
333 uint64_t entry_size_ = 0;
334 segments_t segments_;
335 bool is_frame_ =
false;
336 DataHandler::Handler* datahandler_ =
nullptr;
337 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:219
uint64_t flags() const
Section flags.
Definition ELF/Section.hpp:185
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:211
TYPE
Definition ELF/Section.hpp:60
uint32_t link() const
Index to another section.
Definition ELF/Section.hpp:245
uint64_t size() const override
section's size (size in the binary, not the virtual size)
Definition ELF/Section.hpp:198
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:230
uint64_t offset() const override
Offset in the binary.
Definition ELF/Section.hpp:206
void add(FLAGS flag)
Add the given ELF_SECTION_FLAGS.
uint64_t alignment() const
Section file alignment.
Definition ELF/Section.hpp:224
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:240
Class which represents the ELF segments.
Definition Segment.hpp:44
Class which represents an abstracted section.
Definition Abstract/Section.hpp:29
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