LIEF: Library to Instrument Executable Formats Version 1.0.0
Loading...
Searching...
No Matches
DyldExportsTrie.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_MACHO_DYLD_EXPORTS_TRIE_H
17#define LIEF_MACHO_DYLD_EXPORTS_TRIE_H
18#include <memory>
19#include <string>
20#include "LIEF/span.hpp"
21#include "LIEF/iterators.hpp"
23#include "LIEF/visibility.h"
25
26namespace LIEF {
27namespace MachO {
28
29class BinaryParser;
30class Builder;
31class LinkEdit;
32class ExportInfo;
33class Binary;
34
35namespace details {
36struct linkedit_data_command;
37}
38
44 friend class BinaryParser;
45 friend class Builder;
46 friend class LinkEdit;
47 friend class Binary;
48
49 public:
51 using export_info_t = std::vector<std::unique_ptr<ExportInfo>>;
52
55
59
61 DyldExportsTrie(const details::linkedit_data_command& cmd);
62 std::unique_ptr<LoadCommand> clone() const override {
63 return std::unique_ptr<DyldExportsTrie>(new DyldExportsTrie(*this));
64 }
65
66 void swap(DyldExportsTrie& other) noexcept;
67
68 ~DyldExportsTrie() override;
69
72 uint32_t data_offset() const {
73 return data_offset_;
74 }
75
77 uint32_t data_size() const {
78 return data_size_;
79 }
80
81 void data_offset(uint32_t offset) {
82 data_offset_ = offset;
83 }
84 void data_size(uint32_t size) {
85 data_size_ = size;
86 }
87
89 return content_;
90 }
91
94 return export_info_;
95 }
96
98 return export_info_;
99 }
100
102 std::string show_export_trie() const;
103
106 ExportInfo* add(std::unique_ptr<ExportInfo> info) LIEF_LIFETIMEBOUND;
107
108 void accept(Visitor& visitor) const override;
109
110 std::ostream& print(std::ostream& os) const override;
111
112 static bool classof(const LoadCommand* cmd) {
114 }
115
116 private:
119
120 uint32_t data_offset_ = 0;
121 uint32_t data_size_ = 0;
122
123 // Raw payload of the DyldExportsTrie.
124 // This payload is located in the __LINKEDIT segment
125 span<uint8_t> content_;
126
127 export_info_t export_info_;
128};
129
130}
131}
132#endif
Class used to parse a single binary (i.e. non-FAT).
Definition BinaryParser.hpp:79
Class which represents a MachO binary.
Definition MachO/Binary.hpp:91
Class used to rebuild a Mach-O file.
Definition MachO/Builder.hpp:64
Class that represents the LC_DYLD_EXPORTS_TRIE command.
Definition DyldExportsTrie.hpp:43
std::unique_ptr< LoadCommand > clone() const override
Definition DyldExportsTrie.hpp:62
void accept(Visitor &visitor) const override
ref_iterator< export_info_t &, ExportInfo * > it_export_info
Iterator which outputs const ExportInfo&.
Definition DyldExportsTrie.hpp:54
span< const uint8_t > content() const
Definition DyldExportsTrie.hpp:88
DyldExportsTrie(const details::linkedit_data_command &cmd)
it_const_export_info exports() const
Definition DyldExportsTrie.hpp:97
friend class BinaryParser
Definition DyldExportsTrie.hpp:44
it_export_info exports()
Iterator over the ExportInfo entries.
Definition DyldExportsTrie.hpp:93
void data_size(uint32_t size)
Definition DyldExportsTrie.hpp:84
std::vector< std::unique_ptr< ExportInfo > > export_info_t
Internal container for storing ExportInfo.
Definition DyldExportsTrie.hpp:51
std::string show_export_trie() const
Print the exports trie in a human-readable way.
void data_offset(uint32_t offset)
Definition DyldExportsTrie.hpp:81
friend class Builder
Definition DyldExportsTrie.hpp:45
std::ostream & print(std::ostream &os) const override
friend class Binary
Definition DyldExportsTrie.hpp:47
const_ref_iterator< const export_info_t &, ExportInfo * > it_const_export_info
Iterator which outputs const ExportInfo&.
Definition DyldExportsTrie.hpp:57
friend class LinkEdit
Definition DyldExportsTrie.hpp:46
ExportInfo * add(std::unique_ptr< ExportInfo > info)
Add an entry in the current trie. See also: LIEF::MachO::Binary::add_exported_function.
uint32_t data_size() const
Size of the LC_DYLD_EXPORTS_TRIE payload.
Definition DyldExportsTrie.hpp:77
void swap(DyldExportsTrie &other) noexcept
static bool classof(const LoadCommand *cmd)
Definition DyldExportsTrie.hpp:112
uint32_t data_offset() const
Offset of the LC_DYLD_EXPORTS_TRIE. This offset should point in the __LINKEDIT segment.
Definition DyldExportsTrie.hpp:72
Class that provides an interface over the Dyld export info.
Definition ExportInfo.hpp:38
Definition LinkEdit.hpp:47
uint32_t size() const
Size of the command (should be greater than sizeof(load_command)).
Definition LoadCommand.hpp:135
LoadCommand::TYPE command() const
Command type.
Definition LoadCommand.hpp:130
@ DYLD_EXPORTS_TRIE
Definition LoadCommand.hpp:99
Definition Visitor.hpp:212
Iterator which returns reference on container's values.
Definition iterators.hpp:47
#define LIEF_LIFETIMEBOUND
Definition compiler_attributes.hpp:72
Definition endianness_support.hpp:60
Namespace related to the LIEF's Mach-O module.
Definition Abstract/Header.hpp:36
LIEF namespace.
Definition Abstract/Binary.hpp:41
tcb::span< ElementType, Extent > span
Definition span.hpp:22
ref_iterator< CT, U, typename decay_t< CT >::const_iterator > const_ref_iterator
Iterator which returns a const ref on container's values.
Definition iterators.hpp:320
#define LIEF_API
Definition visibility.h:45
#define LIEF_LOCAL
Definition visibility.h:46