LIEF: Library to Instrument Executable Formats Version 0.17.0
Loading...
Searching...
No Matches
ExportEntry.hpp
Go to the documentation of this file.
1/* Copyright 2017 - 2024 R. Thomas
2 * Copyright 2017 - 2024 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_EXPORT_ENTRY_H
17#define LIEF_PE_EXPORT_ENTRY_H
18
19#include <string>
20#include <ostream>
21
22#include "LIEF/Object.hpp"
23#include "LIEF/visibility.h"
25
26namespace LIEF {
27namespace PE {
28
29class Builder;
30class Parser;
31class LIEF_API ExportEntry : public LIEF::Symbol {
34
35 friend class Builder;
36 friend class Parser;
37
38 public:
39 struct LIEF_API forward_information_t {
40 std::string library;
41 std::string function;
42
43 operator bool() const {
44 return !library.empty() || !function.empty();
45 }
46
47 LIEF_API friend std::ostream& operator<<(std::ostream& os, const forward_information_t& info) {
48 os << info.library << '.' << info.function;
49 return os;
50 }
51 };
52
53 public:
54 ExportEntry() = default;
55 ExportEntry(uint32_t address, bool is_extern,
56 uint16_t ordinal, uint32_t function_rva) :
57 function_rva_{function_rva},
58 ordinal_{ordinal},
59 address_{address},
60 is_extern_{is_extern}
61 {}
62
63 ExportEntry(const ExportEntry&) = default;
64 ExportEntry& operator=(const ExportEntry&) = default;
65 ~ExportEntry() override = default;
66 std::string demangled_name() const;
70
71 uint16_t ordinal() const {
72 return ordinal_;
73 }
74 uint32_t address() const {
75 return address_;
76 }
77 bool is_extern() const {
78 return is_extern_;
79 }
80 bool is_forwarded() const {
81 return forward_info_;
82 }
83
84 forward_information_t forward_information() const {
85 return is_forwarded() ? forward_info_ : forward_information_t{};
86 }
87
88 uint32_t function_rva() const {
89 return function_rva_;
90 }
91
92 void ordinal(uint16_t ordinal) {
93 ordinal_ = ordinal;
94 }
95
96 void address(uint32_t address) {
97 address_ = address;
98 }
99
100 void is_extern(bool is_extern) {
101 is_extern_ = is_extern;
102 }
103
104 uint64_t value() const override {
105 return address();
106 }
107
108 void value(uint64_t value) override {
109 address(static_cast<uint32_t>(value));
110 }
111
112 void set_forward_info(std::string lib, std::string function) {
113 forward_info_.library = std::move(lib);
114 forward_info_.function = std::move(function);
115 }
116
117 void accept(Visitor& visitor) const override;
118
119
120 LIEF_API friend std::ostream& operator<<(std::ostream& os, const ExportEntry& exportEntry);
121
122 private:
123 uint32_t function_rva_ = 0;
124 uint16_t ordinal_ = 0;
125 uint32_t address_ = 0;
126 bool is_extern_ = false;
127
128 forward_information_t forward_info_;
129
130};
131
132}
133}
134
135#endif /* PE_EXPORTENTRY_H */
Class that is used to rebuild a raw PE binary from a PE::Binary object.
Definition PE/Builder.hpp:45
Class which represents a PE Export entry (cf. PE::Export)
Definition ExportEntry.hpp:33
ExportEntry & operator=(const ExportEntry &)=default
friend std::ostream & operator<<(std::ostream &os, const ExportEntry &exportEntry)
bool is_forwarded() const
Definition ExportEntry.hpp:80
uint64_t value() const override
Definition ExportEntry.hpp:104
bool is_extern() const
Definition ExportEntry.hpp:77
uint32_t address() const
Definition ExportEntry.hpp:74
void value(uint64_t value) override
Definition ExportEntry.hpp:108
void is_extern(bool is_extern)
Definition ExportEntry.hpp:100
void accept(Visitor &visitor) const override
ExportEntry(uint32_t address, bool is_extern, uint16_t ordinal, uint32_t function_rva)
Definition ExportEntry.hpp:55
void set_forward_info(std::string lib, std::string function)
Definition ExportEntry.hpp:112
ExportEntry(const ExportEntry &)=default
~ExportEntry() override=default
uint16_t ordinal() const
Definition ExportEntry.hpp:71
uint32_t function_rva() const
Definition ExportEntry.hpp:88
forward_information_t forward_information() const
Definition ExportEntry.hpp:84
void ordinal(uint16_t ordinal)
Definition ExportEntry.hpp:92
void address(uint32_t address)
Definition ExportEntry.hpp:96
std::string demangled_name() const
Demangled representation of the symbol or an empty string if it can't be demangled.
Main interface to parse PE binaries. In particular the static functions: Parser::parse should be used...
Definition PE/Parser.hpp:47
Namespace related to the LIEF's PE module.
Definition Abstract/Header.hpp:32
LIEF namespace.
Definition Abstract/Binary.hpp:36
friend std::ostream & operator<<(std::ostream &os, const forward_information_t &info)
Definition ExportEntry.hpp:47
#define LIEF_API
Definition visibility.h:41