LIEF: Library to Instrument Executable Formats Version 2.0.0
Loading...
Searching...
No Matches
AuxiliarySectionDefinition.hpp
Go to the documentation of this file.
1/* Copyright 2017 - 2026 R. Thomas
2 *
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at
6 *
7 * http://www.apache.org/licenses/LICENSE-2.0
8 *
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15#ifndef LIEF_COFF_AUXILIARY_SEC_DEF_H
16#define LIEF_COFF_AUXILIARY_SEC_DEF_H
17
18#include <memory>
19
21#include "LIEF/visibility.h"
22
23
24namespace LIEF::COFF {
25
30 public:
31 LIEF_LOCAL static std::unique_ptr<AuxiliarySectionDefinition>
32 parse(const std::vector<uint8_t>& payload);
33
36
38 uint16_t nb_lines, uint32_t checksum,
39 uint32_t sec_idx, uint8_t selection,
40 uint8_t reserved) :
42 length_(length),
43 nb_relocs_(nb_relocs),
44 nb_lines_(nb_lines),
45 checksum_(checksum),
46 sec_idx_(sec_idx),
47 selection_((COMDAT_SELECTION)selection),
48 reserved_(reserved) {}
49
53
56
57 std::unique_ptr<AuxiliarySymbol> clone() const override {
58 return std::make_unique<AuxiliarySectionDefinition>(*this);
59 }
60
65 enum class COMDAT_SELECTION : uint8_t {
66 NONE = 0,
67
70 NODUPLICATES = 1,
71
74 ANY,
75
79 SAME_SIZE,
80
84 EXACT_MATCH,
85
97 ASSOCIATIVE,
98
102 LARGEST,
103 };
104
106 uint32_t length() const {
107 return length_;
108 }
109
111 uint16_t nb_relocs() const {
112 return nb_relocs_;
113 }
114
116 uint16_t nb_line_numbers() const {
117 return nb_lines_;
118 }
119
122 uint32_t checksum() const {
123 return checksum_;
124 }
125
128 uint32_t section_idx() const {
129 return sec_idx_;
130 }
131
135 return selection_;
136 }
137
139 uint8_t reserved() const {
140 return reserved_;
141 }
142
143 std::string to_string() const override;
144
145 static bool classof(const AuxiliarySymbol* sym) {
146 return sym->type() == AuxiliarySymbol::TYPE::SEC_DEF;
147 }
148
149 ~AuxiliarySectionDefinition() override = default;
150
151 private:
152 uint32_t length_ = 0;
153 uint16_t nb_relocs_ = 0;
154 uint16_t nb_lines_ = 0;
155 uint32_t checksum_ = 0;
156 uint32_t sec_idx_ = 0;
158 uint8_t reserved_ = 0;
159};
160
162
163}
164
165#endif
AuxiliarySectionDefinition & operator=(const AuxiliarySectionDefinition &)=default
uint32_t checksum() const
The checksum for communal data. It is applicable if the IMAGE_SCN_LNK_COMDAT flag is set in the secti...
Definition AuxiliarySectionDefinition.hpp:122
AuxiliarySectionDefinition()
Definition AuxiliarySectionDefinition.hpp:34
static std::unique_ptr< AuxiliarySectionDefinition > parse(const std::vector< uint8_t > &payload)
static bool classof(const AuxiliarySymbol *sym)
Definition AuxiliarySectionDefinition.hpp:145
uint32_t section_idx() const
One-based index into the section table for the associated section. This is used when the COMDAT selec...
Definition AuxiliarySectionDefinition.hpp:128
uint32_t length() const
The size of section data. The same as SizeOfRawData in the section header.
Definition AuxiliarySectionDefinition.hpp:106
COMDAT_SELECTION
Values for the AuxiliarySectionDefinition::selection attribute.
Definition AuxiliarySectionDefinition.hpp:65
@ NONE
Definition AuxiliarySectionDefinition.hpp:66
AuxiliarySectionDefinition & operator=(AuxiliarySectionDefinition &&)=default
uint16_t nb_line_numbers() const
The number of line-number entries for the section.
Definition AuxiliarySectionDefinition.hpp:116
COMDAT_SELECTION selection() const
The COMDAT selection number. This is applicable if the section is a COMDAT section.
Definition AuxiliarySectionDefinition.hpp:134
~AuxiliarySectionDefinition() override=default
AuxiliarySectionDefinition(AuxiliarySectionDefinition &&)=default
uint8_t reserved() const
Reserved value (should be 0).
Definition AuxiliarySectionDefinition.hpp:139
std::unique_ptr< AuxiliarySymbol > clone() const override
Definition AuxiliarySectionDefinition.hpp:57
AuxiliarySectionDefinition(const AuxiliarySectionDefinition &)=default
AuxiliarySectionDefinition(uint32_t length, uint16_t nb_relocs, uint16_t nb_lines, uint32_t checksum, uint32_t sec_idx, uint8_t selection, uint8_t reserved)
Definition AuxiliarySectionDefinition.hpp:37
std::string to_string() const override
uint16_t nb_relocs() const
The number of relocation entries for the section.
Definition AuxiliarySectionDefinition.hpp:111
span< const uint8_t > payload() const
For unknown type only, return the raw representation of this symbol.
Definition AuxiliarySymbol.hpp:84
TYPE type() const
Definition AuxiliarySymbol.hpp:79
TYPE
Type discriminator for the subclasses.
Definition AuxiliarySymbol.hpp:55
@ SEC_DEF
Auxiliary Format 5: Section Definitions from the PE-COFF documentation.
Definition AuxiliarySymbol.hpp:71
Definition AuxiliarySymbol.hpp:29
const char * to_string(AuxiliarySectionDefinition::COMDAT_SELECTION e)
#define LIEF_API
Definition visibility.h:44
#define LIEF_LOCAL
Definition visibility.h:45