LIEF: Library to Instrument Executable Formats Version 0.17.0
Loading...
Searching...
No Matches
AuxiliaryWeakExternal.hpp
Go to the documentation of this file.
1/* Copyright 2017 - 2025 R. Thomas
2 * Copyright 2017 - 2025 Quarkslab
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16#ifndef LIEF_PE_AUXILIARY_WEAK_EXTERNAL_H
17#define LIEF_PE_AUXILIARY_WEAK_EXTERNAL_H
18
19#include <memory>
20#include <cassert>
21
22#include "LIEF/visibility.h"
24
25namespace LIEF {
26
27namespace PE {
43 public:
44 enum class CHARACTERISTICS : uint32_t { SEARCH_NOLIBRARY = 1, SEARCH_LIBRARY = 2, SEARCH_ALIAS = 3,
51 ANTI_DEPENDENCY = 4
52 };
53
54 LIEF_LOCAL static std::unique_ptr<AuxiliaryWeakExternal>
55 parse(const std::vector<uint8_t>& payload);
56
58 AuxiliarySymbol(AuxiliarySymbol::TYPE::WEAK_EXTERNAL)
59 {}
60
61 AuxiliaryWeakExternal(uint32_t sym_idx, uint32_t characteristics,
62 std::vector<uint8_t> padding) :
63 AuxiliarySymbol(AuxiliarySymbol::TYPE::WEAK_EXTERNAL),
64 sym_idx_(sym_idx),
65 characteristics_(characteristics),
66 padding_(std::move(padding))
67 {
68 assert(padding_.size() == 10);
69 }
70
71 AuxiliaryWeakExternal(const AuxiliaryWeakExternal&) = default;
72 AuxiliaryWeakExternal& operator=(const AuxiliaryWeakExternal&) = default;
73
74 AuxiliaryWeakExternal(AuxiliaryWeakExternal&&) = default;
75 AuxiliaryWeakExternal& operator=(AuxiliaryWeakExternal&&) = default;
76
77 std::unique_ptr<AuxiliarySymbol> clone() const override {
78 return std::unique_ptr<AuxiliaryWeakExternal>(new AuxiliaryWeakExternal{*this});
79 }
80 uint32_t sym_idx() const {
84 return sym_idx_;
85 }
86
87 CHARACTERISTICS characteristics() const {
88 return (CHARACTERISTICS)characteristics_;
89 }
90
91 span<const uint8_t> padding() const {
92 return padding_;
93 }
94
95 std::string to_string() const override;
96
97 static bool classof(const AuxiliarySymbol* sym) {
98 return sym->type() == AuxiliarySymbol::TYPE::WEAK_EXTERNAL;
99 }
100
101 ~AuxiliaryWeakExternal() override = default;
102
103 private:
104 uint32_t sym_idx_ = 0;
105 uint32_t characteristics_ = 0;
106 std::vector<uint8_t> padding_;
107};
108
109LIEF_API const char* to_string(AuxiliaryWeakExternal::CHARACTERISTICS e);
110
111}
112}
113#endif
Class that represents an auxiliary symbol.
Definition AuxiliarySymbol.hpp:36
TYPE type() const
Definition AuxiliarySymbol.hpp:78
"Weak externals" are a mechanism for object files that allows flexibility at link time....
Definition AuxiliaryWeakExternal.hpp:42
CHARACTERISTICS characteristics() const
Definition AuxiliaryWeakExternal.hpp:87
AuxiliaryWeakExternal & operator=(const AuxiliaryWeakExternal &)=default
span< const uint8_t > padding() const
Definition AuxiliaryWeakExternal.hpp:91
AuxiliaryWeakExternal(uint32_t sym_idx, uint32_t characteristics, std::vector< uint8_t > padding)
Definition AuxiliaryWeakExternal.hpp:61
uint32_t sym_idx() const
The symbol-table index of sym2, the symbol to be linked if sym1 is not found.
Definition AuxiliaryWeakExternal.hpp:83
CHARACTERISTICS
Definition AuxiliaryWeakExternal.hpp:44
std::string to_string() const override
AuxiliaryWeakExternal()
Definition AuxiliaryWeakExternal.hpp:57
static std::unique_ptr< AuxiliaryWeakExternal > parse(const std::vector< uint8_t > &payload)
static bool classof(const AuxiliarySymbol *sym)
Definition AuxiliaryWeakExternal.hpp:97
AuxiliaryWeakExternal(const AuxiliaryWeakExternal &)=default
AuxiliaryWeakExternal(AuxiliaryWeakExternal &&)=default
std::unique_ptr< AuxiliarySymbol > clone() const override
Definition AuxiliaryWeakExternal.hpp:77
AuxiliaryWeakExternal & operator=(AuxiliaryWeakExternal &&)=default
~AuxiliaryWeakExternal() override=default
Namespace related to the LIEF's PE module.
Definition Abstract/Header.hpp:32
const char * to_string(AuxiliaryWeakExternal::CHARACTERISTICS e)
LIEF namespace.
Definition Abstract/Binary.hpp:36
#define LIEF_API
Definition visibility.h:41
#define LIEF_LOCAL
Definition visibility.h:42