LIEF: Library to Instrument Executable Formats Version 0.17.0
Loading...
Searching...
No Matches
SymbolVersionRequirement.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_SYMBOL_VERSION_REQUIREMENTS_H
17#define LIEF_ELF_SYMBOL_VERSION_REQUIREMENTS_H
18
19#include <cstdint>
20#include <string>
21#include <ostream>
22#include <vector>
23#include <memory>
24
25#include "LIEF/Object.hpp"
26#include "LIEF/visibility.h"
27#include "LIEF/iterators.hpp"
28
29namespace LIEF {
30namespace ELF {
31class Parser;
33
34namespace details {
35struct Elf64_Verneed;
36struct Elf32_Verneed;
37}
38class LIEF_API SymbolVersionRequirement : public Object {
41 friend class Parser;
42
43 public:
44 using aux_requirement_t = std::vector<std::unique_ptr<SymbolVersionAuxRequirement>>;
45 using it_aux_requirement = ref_iterator<aux_requirement_t&, SymbolVersionAuxRequirement*>;
46 using it_const_aux_requirement = const_ref_iterator<const aux_requirement_t&, const SymbolVersionAuxRequirement*>;
47
49 SymbolVersionRequirement(const details::Elf64_Verneed& header);
50 SymbolVersionRequirement(const details::Elf32_Verneed& header);
51 ~SymbolVersionRequirement() override = default;
52
53 SymbolVersionRequirement& operator=(SymbolVersionRequirement other);
54 SymbolVersionRequirement(const SymbolVersionRequirement& other);
55 void swap(SymbolVersionRequirement& other);
56 uint16_t version() const {
62 return version_;
63 }
64 size_t cnt() const {
67 return aux_requirements_.size();
68 }
69 it_aux_requirement auxiliary_symbols() {
72 return aux_requirements_;
73 }
74
75 it_const_aux_requirement auxiliary_symbols() const {
76 return aux_requirements_;
77 }
78 const std::string& name() const {
81 return name_;
82 }
83
84 void version(uint16_t version) {
85 version_ = version;
86 }
87
88 void name(const std::string& name) {
89 name_ = name;
90 }
91 SymbolVersionAuxRequirement& add_aux_requirement(const SymbolVersionAuxRequirement& aux_requirement);
94 const SymbolVersionAuxRequirement* find_aux(const std::string& name) const;
97
98 SymbolVersionAuxRequirement* find_aux(const std::string& name) {
99 return const_cast<SymbolVersionAuxRequirement*>(static_cast<const SymbolVersionRequirement*>(this)->find_aux(name));
100 }
101 bool remove_aux_requirement(const std::string& name) {
110 if (SymbolVersionAuxRequirement* aux = find_aux(name)) {
111 return remove_aux_requirement(*aux);
112 }
113 return false;
114 }
115 bool remove_aux_requirement(SymbolVersionAuxRequirement& aux);
124
125 void accept(Visitor& visitor) const override;
126
127 LIEF_API friend
128 std::ostream& operator<<(std::ostream& os, const SymbolVersionRequirement& symr) {
129 os << symr.version() << " " << symr.name();
130 return os;
131 }
132
133 private:
134 aux_requirement_t aux_requirements_;
135 uint16_t version_ = 0;
136 std::string name_;
137};
138
139}
140}
141#endif
142
Object.hpp
LIEF::ELF::Parser
Class which parses and transforms an ELF file into a ELF::Binary object.
Definition ELF/Parser.hpp:45
LIEF::ELF::SymbolVersionAuxRequirement
Definition SymbolVersionAuxRequirement.hpp:35
LIEF::ELF::SymbolVersionRequirement
Class which represents an entry in the DT_VERNEED or .gnu.version_r table.
Definition SymbolVersionRequirement.hpp:40
LIEF::ELF::SymbolVersionRequirement::accept
void accept(Visitor &visitor) const override
LIEF::ELF::SymbolVersionRequirement::cnt
size_t cnt() const
Number of auxiliary entries.
Definition SymbolVersionRequirement.hpp:66
LIEF::ELF::SymbolVersionRequirement::swap
void swap(SymbolVersionRequirement &other)
LIEF::ELF::SymbolVersionRequirement::remove_aux_requirement
bool remove_aux_requirement(SymbolVersionAuxRequirement &aux)
Try to remove the given auxiliary requirement symbol. The function returns true if the operation succ...
LIEF::ELF::SymbolVersionRequirement::version
void version(uint16_t version)
Definition SymbolVersionRequirement.hpp:84
LIEF::ELF::SymbolVersionRequirement::find_aux
const SymbolVersionAuxRequirement * find_aux(const std::string &name) const
Try to find the SymbolVersionAuxRequirement with the given name (e.g. GLIBC_2.27)
LIEF::ELF::SymbolVersionRequirement::auxiliary_symbols
it_const_aux_requirement auxiliary_symbols() const
Definition SymbolVersionRequirement.hpp:75
LIEF::ELF::SymbolVersionRequirement::SymbolVersionRequirement
SymbolVersionRequirement(const details::Elf64_Verneed &header)
LIEF::ELF::SymbolVersionRequirement::name
const std::string & name() const
Return the library name associated with this requirement (e.g. libc.so.6)
Definition SymbolVersionRequirement.hpp:80
LIEF::ELF::SymbolVersionRequirement::version
uint16_t version() const
Version revision.
Definition SymbolVersionRequirement.hpp:61
LIEF::ELF::SymbolVersionRequirement::remove_aux_requirement
bool remove_aux_requirement(const std::string &name)
Try to remove the auxiliary requirement symbol with the given name. The function returns true if the ...
Definition SymbolVersionRequirement.hpp:109
LIEF::ELF::SymbolVersionRequirement::operator=
SymbolVersionRequirement & operator=(SymbolVersionRequirement other)
LIEF::ELF::SymbolVersionRequirement::auxiliary_symbols
it_aux_requirement auxiliary_symbols()
Auxiliary entries as an iterator over SymbolVersionAuxRequirement.
Definition SymbolVersionRequirement.hpp:71
LIEF::ELF::SymbolVersionRequirement::operator<<
friend std::ostream & operator<<(std::ostream &os, const SymbolVersionRequirement &symr)
Definition SymbolVersionRequirement.hpp:128
LIEF::ELF::SymbolVersionRequirement::SymbolVersionRequirement
SymbolVersionRequirement(const SymbolVersionRequirement &other)
LIEF::ELF::SymbolVersionRequirement::find_aux
SymbolVersionAuxRequirement * find_aux(const std::string &name)
Definition SymbolVersionRequirement.hpp:98
LIEF::ELF::SymbolVersionRequirement::~SymbolVersionRequirement
~SymbolVersionRequirement() override=default
LIEF::ELF::SymbolVersionRequirement::name
void name(const std::string &name)
Definition SymbolVersionRequirement.hpp:88
LIEF::ELF::SymbolVersionRequirement::add_aux_requirement
SymbolVersionAuxRequirement & add_aux_requirement(const SymbolVersionAuxRequirement &aux_requirement)
Add a version auxiliary requirement to the existing list.
LIEF::ELF::SymbolVersionRequirement::SymbolVersionRequirement
SymbolVersionRequirement()=default
LIEF::ELF::SymbolVersionRequirement::SymbolVersionRequirement
SymbolVersionRequirement(const details::Elf32_Verneed &header)
iterators.hpp
LIEF::ELF::details
Definition DynamicEntry.hpp:29
LIEF::ELF
Namespace related to the LIEF's ELF module.
Definition Abstract/Header.hpp:28
LIEF
LIEF namespace.
Definition Abstract/Binary.hpp:39
visibility.h
LIEF_API
#define LIEF_API
Definition visibility.h:41