LIEF: Library to Instrument Executable Formats Version 1.0.0
Loading...
Searching...
No Matches
NoteGnuProperty.hpp
Go to the documentation of this file.
1/* Copyright 2017 - 2026 R. Thomas
2 * Copyright 2017 - 2026 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_ELF_NOTE_GNU_PROPERTY_H
17#define LIEF_ELF_NOTE_GNU_PROPERTY_H
18
19#include <vector>
20#include <ostream>
21#include <memory>
22
23#include "LIEF/visibility.h"
24#include "LIEF/ELF/Note.hpp"
25
26namespace LIEF {
27namespace ELF {
28
31 public:
34 class LIEF_API Property {
35 public:
37 enum class TYPE {
38 UNKNOWN = 0,
39 GENERIC,
40 AARCH64_FEATURES,
41 AARCH64_PAUTH,
42 STACK_SIZE,
43 NO_COPY_ON_PROTECTED,
44 X86_ISA,
46 X86_FEATURE,
47 NEEDED,
48 };
49
51 TYPE type() const {
52 return type_;
53 }
54
55 virtual void dump(std::ostream& os) const;
56
57 virtual ~Property() = default;
58
59 LIEF_API friend std::ostream& operator<<(std::ostream& os,
60 const Property& prop) {
61 prop.dump(os);
62 return os;
63 }
64
65 protected:
66 Property() = delete;
68 type_(type) {}
69 TYPE type_ = TYPE::UNKNOWN;
70 };
71
72 using properties_t = std::vector<std::unique_ptr<NoteGnuProperty::Property>>;
73
74 NoteGnuProperty(ARCH arch, Header::CLASS cls, std::string name, uint32_t type,
75 description_t description, std::string secname) :
76 Note(std::move(name), TYPE::GNU_PROPERTY_TYPE_0, type, std::move(description),
77 std::move(secname)),
78 arch_(arch),
79 class_(cls) {}
80
81 std::unique_ptr<Note> clone() const override {
82 return std::unique_ptr<Note>(new NoteGnuProperty(*this));
83 }
84
86 std::unique_ptr<NoteGnuProperty::Property> find(Property::TYPE type) const;
87
90
91 void dump(std::ostream& os) const override;
92
93 void accept(Visitor& visitor) const override;
94
95 static bool classof(const Note* note) {
96 return note->type() == Note::TYPE::GNU_PROPERTY_TYPE_0;
97 }
98
99 ~NoteGnuProperty() override = default;
100
101 LIEF_API friend std::ostream& operator<<(std::ostream& os,
102 const NoteGnuProperty& note) {
103 note.dump(os);
104 return os;
105 }
106
107 protected:
108 ARCH arch_ = ARCH::NONE;
110};
111
113
114} // namepsace ELF
115} // namespace LIEF
116
117#endif
CLASS
Match the result of Elfxx_Ehdr.e_ident[EI_CLASS].
Definition ELF/Header.hpp:74
@ NONE
Definition ELF/Header.hpp:75
This class wraps the different properties that can be used in a NT_GNU_PROPERTY_TYPE_0 note.
Definition NoteGnuProperty.hpp:34
friend std::ostream & operator<<(std::ostream &os, const Property &prop)
Definition NoteGnuProperty.hpp:59
TYPE
LIEF's mirror types of the original GNU_PROPERTY_ values.
Definition NoteGnuProperty.hpp:37
TYPE type() const
Return the LIEF's mirror type of the note.
Definition NoteGnuProperty.hpp:51
virtual void dump(std::ostream &os) const
std::vector< std::unique_ptr< NoteGnuProperty::Property > > properties_t
Definition NoteGnuProperty.hpp:72
static bool classof(const Note *note)
Definition NoteGnuProperty.hpp:95
std::unique_ptr< Note > clone() const override
Clone the current note and keep its polymorphic type.
Definition NoteGnuProperty.hpp:81
~NoteGnuProperty() override=default
std::unique_ptr< NoteGnuProperty::Property > find(Property::TYPE type) const
Find the property with the given type or return a nullptr.
void dump(std::ostream &os) const override
NoteGnuProperty(ARCH arch, Header::CLASS cls, std::string name, uint32_t type, description_t description, std::string secname)
Definition NoteGnuProperty.hpp:74
void accept(Visitor &visitor) const override
properties_t properties() const
Return the properties as a list of Property.
friend std::ostream & operator<<(std::ostream &os, const NoteGnuProperty &note)
Definition NoteGnuProperty.hpp:101
std::vector< uint8_t > description_t
Container used to handle the description data.
Definition Note.hpp:46
TYPE
LIEF representation of the ELF NT_ values.
Definition Note.hpp:49
@ GNU_PROPERTY_TYPE_0
Match NT_GNU_PROPERTY_TYPE_0: Program property note, as described in "Linux Extensions to the gABI".
Definition Note.hpp:63
TYPE type() const
Return the type of the note. This type does not match the NT_ type value. For accessing the original ...
Definition Note.hpp:196
const std::string & name() const
Return the name of the note (also known as 'owner' ).
Definition Note.hpp:185
Note(const Note &copy)=default
span< const uint8_t > description() const
Return the description associated with the note.
Definition Note.hpp:207
Definition Visitor.hpp:212
Namespace related to the LIEF's ELF module.
Definition Abstract/Header.hpp:28
const char * to_string(DynamicEntry::TAG e)
ARCH
Definition ELF/enums.hpp:30
@ NONE
Definition ELF/enums.hpp:31
LIEF namespace.
Definition Abstract/Binary.hpp:40
Definition string.h:155
#define LIEF_API
Definition visibility.h:43