LIEF: Library to Instrument Executable Formats Version 2.0.0
Loading...
Searching...
No Matches
DelayImport.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_PE_DELAY_IMPORT_H
16#define LIEF_PE_DELAY_IMPORT_H
17
18#include <string_view>
19#include <memory>
20#include <ostream>
21#include <string>
22
23#include "LIEF/Object.hpp"
24#include "LIEF/iterators.hpp"
25#include "LIEF/visibility.h"
26
28
29
30namespace LIEF::PE {
31
32namespace details {
33struct delay_imports;
34}
35
37class LIEF_API DelayImport : public Object {
38
39 friend class Parser;
40 friend class Builder;
41
42 public:
43 using entries_t = std::vector<std::unique_ptr<DelayImportEntry>>;
47
48 DelayImport() = default;
49 DelayImport(const details::delay_imports& import, PE_TYPE type);
50 DelayImport(std::string name) :
51 name_(std::move(name)) {}
52
53 ~DelayImport() override = default;
54
55 DelayImport(const DelayImport& other);
57 swap(other);
58 return *this;
59 }
60
61 DelayImport(DelayImport&&) noexcept = default;
62 DelayImport& operator=(DelayImport&&) noexcept = default;
63
64 void swap(DelayImport& other);
65
72 uint32_t attribute() const {
73 return attribute_;
74 }
75
76 void attribute(uint32_t hdl) {
77 attribute_ = hdl;
78 }
79
82 bool is_rva_based() const {
83 return (attribute_ & 0x1) != 0;
84 }
85
87 std::string_view name() const LIEF_LIFETIMEBOUND {
88 return name_;
89 }
90
91 void name(std::string name) {
92 name_ = std::move(name);
93 }
94
98 uint32_t handle() const {
99 return handle_;
100 }
101
102 void handle(uint32_t hdl) {
103 handle_ = hdl;
104 }
105
107 uint32_t iat() const {
108 return iat_;
109 }
110
111 void iat(uint32_t iat) {
112 iat_ = iat;
113 }
114
117 uint32_t names_table() const {
118 return names_table_;
119 }
120
121 void names_table(uint32_t value) {
122 names_table_ = value;
123 }
124
127 uint32_t biat() const {
128 return bound_iat_;
129 }
130
131 void biat(uint32_t value) {
132 bound_iat_ = value;
133 }
134
141 uint32_t uiat() const {
142 return unload_iat_;
143 }
144
145 void uiat(uint32_t value) {
146 unload_iat_ = value;
147 }
148
150 uint32_t timestamp() const {
151 return timestamp_;
152 }
153
154 void timestamp(uint32_t value) {
155 timestamp_ = value;
156 }
157
160 return entries_;
161 }
162
165 return entries_;
166 }
167
168 void accept(Visitor& visitor) const override;
169
170 LIEF_API friend std::ostream& operator<<(std::ostream& os,
171 const DelayImport& entry);
172
173 private:
174 uint32_t attribute_ = 0;
175 std::string name_;
176 uint32_t handle_ = 0;
177 uint32_t iat_ = 0;
178 uint32_t names_table_ = 0;
179 uint32_t bound_iat_ = 0;
180 uint32_t unload_iat_ = 0;
181 uint32_t timestamp_ = 0;
182 entries_t entries_;
183
184 PE_TYPE type_ = PE_TYPE::PE32;
185};
186
187}
188
189
190#endif
bool is_rva_based() const
Check if the dlattrRva flag of attribute() is set, i.e. if the addresses of the descriptor are RVAs.
Definition DelayImport.hpp:82
DelayImport & operator=(DelayImport other)
Definition DelayImport.hpp:56
uint32_t uiat() const
RVA of the unload delay-load import address table or 0 if the table does not exist.
Definition DelayImport.hpp:141
const_ref_iterator< const entries_t &, const DelayImportEntry * > it_const_entries
Definition DelayImport.hpp:45
uint32_t timestamp() const
The timestamp of the DLL to which this image has been bound.
Definition DelayImport.hpp:150
~DelayImport() override=default
void name(std::string name)
Definition DelayImport.hpp:91
void timestamp(uint32_t value)
Definition DelayImport.hpp:154
DelayImport(const details::delay_imports &import, PE_TYPE type)
it_const_entries entries() const
Iterator over the DelayImport's entries (DelayImportEntry).
Definition DelayImport.hpp:164
uint32_t handle() const
The RVA of the module handle (in the .data section) It is used for storage by the routine that is sup...
Definition DelayImport.hpp:98
std::vector< std::unique_ptr< DelayImportEntry > > entries_t
Definition DelayImport.hpp:43
DelayImport(const DelayImport &other)
std::string_view name() const
Return the library's name (e.g. kernel32.dll).
Definition DelayImport.hpp:87
uint32_t names_table() const
RVA of the delay-load import names table. The content of this table has the layout as the Import look...
Definition DelayImport.hpp:117
friend std::ostream & operator<<(std::ostream &os, const DelayImport &entry)
uint32_t biat() const
RVA of the bound delay-load import address table or 0 if the table does not exist.
Definition DelayImport.hpp:127
void accept(Visitor &visitor) const override
void biat(uint32_t value)
Definition DelayImport.hpp:131
void attribute(uint32_t hdl)
Definition DelayImport.hpp:76
friend class Builder
Definition DelayImport.hpp:40
it_entries entries()
Iterator over the DelayImport's entries (DelayImportEntry).
Definition DelayImport.hpp:159
void iat(uint32_t iat)
Definition DelayImport.hpp:111
friend class Parser
Definition DelayImport.hpp:39
DelayImport(std::string name)
Definition DelayImport.hpp:50
uint32_t attribute() const
Raw Attributes value of the descriptor.
Definition DelayImport.hpp:72
void names_table(uint32_t value)
Definition DelayImport.hpp:121
uint32_t iat() const
RVA of the delay-load import address table.
Definition DelayImport.hpp:107
DelayImport(DelayImport &&) noexcept=default
ref_iterator< entries_t &, DelayImportEntry * > it_entries
Definition DelayImport.hpp:44
void handle(uint32_t hdl)
Definition DelayImport.hpp:102
void swap(DelayImport &other)
void uiat(uint32_t value)
Definition DelayImport.hpp:145
Definition Visitor.hpp:211
Iterator which returns reference on container's values.
Definition iterators.hpp:120
#define LIEF_LIFETIMEBOUND
Definition compiler_attributes.hpp:72
Definition DataDirectory.hpp:37
Namespace related to the LIEF's PE module.
Definition Abstract/Header.hpp:31
PE_TYPE
Definition PE/enums.hpp:22
@ PE32
32bits
Definition PE/enums.hpp:23
ref_iterator< CT, U, typename decay_t< CT >::const_iterator > const_ref_iterator
Iterator which returns a const ref on container's values.
Definition iterators.hpp:385
#define LIEF_API
Definition visibility.h:44