LIEF: Library to Instrument Executable Formats Version 0.17.0
Loading...
Searching...
No Matches
Pogo.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_POGO_H
17#define LIEF_PE_POGO_H
18#include <ostream>
19
20#include "LIEF/visibility.h"
21#include "LIEF/iterators.hpp"
24
25namespace LIEF {
26namespace PE {
27
28class Builder;
29class Parser;
30class LIEF_API Pogo : public Debug {
34
35 friend class Builder;
36 friend class Parser;
37
38 public:
39 using entries_t = std::vector<PogoEntry>;
40 using it_entries = ref_iterator<entries_t&>;
41 using it_const_entries = const_ref_iterator<const entries_t&>;
42
43 enum class SIGNATURES {
44 UNKNOWN = 0x0fffffff,
45 ZERO = 0x00000000,
46 LCTG = 0x4C544347, // LCTG
47 PGI = 0x50474900, // PGI\0
48 };
49
50 Pogo() {
51 type_ = Debug::TYPES::POGO;
52 }
53
54 Pogo(SIGNATURES sig) :
55 Debug{Debug::TYPES::POGO},
56 sig_{sig}
57 {}
58
59 Pogo(const details::pe_debug& debug, SIGNATURES sig, Section* sec) :
60 Debug(debug, sec),
61 sig_(sig)
62 {}
63
64 Pogo(const Pogo&) = default;
65 Pogo& operator=(const Pogo&) = default;
66
67 Pogo(Pogo&&) = default;
68 Pogo& operator=(Pogo&&) = default;
69
70 std::unique_ptr<Debug> clone() const override {
71 return std::unique_ptr<Debug>(new Pogo(*this));
72 }
73
74 SIGNATURES signature() const {
75 return sig_;
76 }
77 it_entries entries() {
80 return entries_;
81 }
82
83 it_const_entries entries() const {
84 return entries_;
85 }
86
87 void add(PogoEntry entry) {
88 entries_.push_back(std::move(entry));
89 }
90
91 static bool classof(const Debug* debug) {
92 return debug->type() == Debug::TYPES::POGO;
93 }
94
95 void accept(Visitor& visitor) const override;
96
97 std::string to_string() const override;
98
99 ~Pogo() override = default;
100
101 protected:
102 SIGNATURES sig_ = SIGNATURES::UNKNOWN;
103 entries_t entries_;
104};
105
106LIEF_API const char* to_string(Pogo::SIGNATURES e);
107
108} // Namespace PE
109} // Namespace LIEF
110
111#endif
Class that is used to rebuild a raw PE binary from a PE::Binary object.
Definition PE/Builder.hpp:45
This class represents a generic entry in the debug data directory. For known types,...
Definition debug/Debug.hpp:40
Main interface to parse PE binaries. In particular the static functions: Parser::parse should be used...
Definition PE/Parser.hpp:52
This class represents a Profile Guided Optimization entry from the debug directory (IMAGE_DEBUG_TYPE_...
Definition Pogo.hpp:33
Pogo(SIGNATURES sig)
Definition Pogo.hpp:54
std::unique_ptr< Debug > clone() const override
Definition Pogo.hpp:70
~Pogo() override=default
static bool classof(const Debug *debug)
Definition Pogo.hpp:91
SIGNATURES
Definition Pogo.hpp:43
Pogo(const Pogo &)=default
void accept(Visitor &visitor) const override
Pogo & operator=(const Pogo &)=default
it_entries entries()
An iterator over the different POGO elements.
Definition Pogo.hpp:79
it_const_entries entries() const
Definition Pogo.hpp:83
Pogo()
Definition Pogo.hpp:50
void add(PogoEntry entry)
Definition Pogo.hpp:87
Pogo & operator=(Pogo &&)=default
SIGNATURES signature() const
Definition Pogo.hpp:74
Pogo(const details::pe_debug &debug, SIGNATURES sig, Section *sec)
Definition Pogo.hpp:59
Pogo(Pogo &&)=default
std::string to_string() const override
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