LIEF: Library to Instrument Executable Formats Version 0.17.0
Loading...
Searching...
No Matches
NoteGnuProperty.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_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:
32
35 class LIEF_API Property {
36 public:
37
50
52 TYPE type() const {
53 return type_;
54 }
55
56 virtual void dump(std::ostream& os) const;
57
58 virtual ~Property() = default;
59
60 LIEF_API friend
61 std::ostream& operator<<(std::ostream& os, const Property& prop) {
62 prop.dump(os);
63 return os;
64 }
65
66 protected:
67 Property() = delete;
69 type_(type) {}
70 TYPE type_ = TYPE::UNKNOWN;
71 };
72
73 using properties_t = std::vector<std::unique_ptr<NoteGnuProperty::Property>>;
74
75 NoteGnuProperty(ARCH arch, Header::CLASS cls, std::string name,
77 std::string secname) :
78 Note(std::move(name), TYPE::GNU_PROPERTY_TYPE_0, type, std::move(description),
79 std::move(secname)),
80 arch_(arch), class_(cls)
81 {}
82
83 std::unique_ptr<Note> clone() const override {
84 return std::unique_ptr<Note>(new NoteGnuProperty(*this));
85 }
86
88 std::unique_ptr<NoteGnuProperty::Property> find(Property::TYPE type) const;
89
92
93 void dump(std::ostream& os) const override;
94
95 void accept(Visitor& visitor) const override;
96
97 static bool classof(const Note* note) {
98 return note->type() == Note::TYPE::GNU_PROPERTY_TYPE_0;
99 }
100
101 ~NoteGnuProperty() override = default;
102
103 LIEF_API friend
104 std::ostream& operator<<(std::ostream& os, const NoteGnuProperty& note) {
105 note.dump(os);
106 return os;
107 }
108
109 protected:
110 ARCH arch_ = ARCH::NONE;
112};
113
115
116} // namepsace ELF
117} // namespace LIEF
118
119#endif
CLASS
Match the result of Elfxx_Ehdr.e_ident[EI_CLASS].
Definition ELF/Header.hpp:73
@ NONE
Definition ELF/Header.hpp:74
This class wraps the different properties that can be used in a NT_GNU_PROPERTY_TYPE_0 note.
Definition NoteGnuProperty.hpp:35
friend std::ostream & operator<<(std::ostream &os, const Property &prop)
Definition NoteGnuProperty.hpp:61
TYPE
LIEF's mirror types of the original GNU_PROPERTY_ values.
Definition NoteGnuProperty.hpp:39
@ X86_FEATURE
Mirror of GNU_PROPERTY_X86_FEATURE_*.
Definition NoteGnuProperty.hpp:47
@ NEEDED
Definition NoteGnuProperty.hpp:48
@ UNKNOWN
Definition NoteGnuProperty.hpp:40
@ X86_ISA
Mirror of GNU_PROPERTY_X86_ISA_1_* and GNU_PROPERTY_X86_COMPAT_*.
Definition NoteGnuProperty.hpp:46
@ AARCH64_FEATURES
Mirror of GNU_PROPERTY_AARCH64_FEATURE_1_AND.
Definition NoteGnuProperty.hpp:42
@ STACK_SIZE
Mirror of GNU_PROPERTY_STACK_SIZE.
Definition NoteGnuProperty.hpp:44
@ AARCH64_PAUTH
Mirror of GNU_PROPERTY_AARCH64_FEATURE_PAUTH.
Definition NoteGnuProperty.hpp:43
@ GENERIC
Property that dont' have special implementation.
Definition NoteGnuProperty.hpp:41
@ NO_COPY_ON_PROTECTED
Mirror of GNU_PROPERTY_NO_COPY_ON_PROTECTED.
Definition NoteGnuProperty.hpp:45
TYPE type() const
Return the LIEF's mirror type of the note.
Definition NoteGnuProperty.hpp:52
virtual void dump(std::ostream &os) const
std::vector< std::unique_ptr< NoteGnuProperty::Property > > properties_t
Definition NoteGnuProperty.hpp:73
static bool classof(const Note *note)
Definition NoteGnuProperty.hpp:97
std::unique_ptr< Note > clone() const override
Clone the current note and keep its polymorphic type.
Definition NoteGnuProperty.hpp:83
~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:75
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:104
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:195
const std::string & name() const
Return the name of the note (also known as 'owner' ).
Definition Note.hpp:184
Note(const Note &copy)=default
span< const uint8_t > description() const
Return the description associated with the note.
Definition Note.hpp:206
Definition Visitor.hpp:210
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
#define LIEF_API
Definition visibility.h:41