LIEF: Library to Instrument Executable Formats Version 0.15.0
Loading...
Searching...
No Matches
MachO/Relocation.hpp
1/* Copyright 2017 - 2024 R. Thomas
2 * Copyright 2017 - 2024 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_RELOCATION_COMMAND_H
17#define LIEF_MACHO_RELOCATION_COMMAND_H
18#include <ostream>
19#include <memory>
20
21#include "LIEF/Abstract/Relocation.hpp"
22
23#include "LIEF/MachO/Header.hpp"
24#include "LIEF/visibility.h"
25#include "LIEF/Object.hpp"
26
27namespace LIEF {
28namespace MachO {
29class BinaryParser;
30class Section;
31class SegmentCommand;
32class Symbol;
33
40class LIEF_API Relocation : public LIEF::Relocation {
41
42 friend class BinaryParser;
43
44 public:
47
48 enum class ORIGIN {
49 UNKNOWN = 0,
50 DYLDINFO = 1,
51 RELOC_TABLE = 2,
52 CHAINED_FIXUPS = 3,
53 };
54
55 static constexpr auto R_SCATTERED = uint32_t(0x80000000);
56 static constexpr auto R_ABS = uint32_t(0);
57
58 Relocation() = default;
59 Relocation(uint64_t address, uint8_t type);
60
61 Relocation& operator=(const Relocation& other);
62 Relocation(const Relocation& other);
63 void swap(Relocation& other) noexcept;
64
65 ~Relocation() override = default;
66
67 virtual std::unique_ptr<Relocation> clone() const = 0;
68
74 virtual bool is_pc_relative() const = 0;
75
86 virtual uint8_t type() const {
87 return type_;
88 }
89
91 Header::CPU_TYPE architecture() const {
92 return architecture_;
93 }
94
96 virtual ORIGIN origin() const = 0;
97
99 bool has_symbol() const {
100 return symbol() != nullptr;
101 }
102
106 return symbol_;
107 }
108 const Symbol* symbol() const {
109 return symbol_;
110 }
111
113 bool has_section() const {
114 return section() != nullptr;
115 }
116
120 return section_;
121 }
122 const Section* section() const {
123 return section_;
124 }
125
127 bool has_segment() const {
128 return segment() != nullptr;
129 }
130
134 return segment_;
135 }
136 const SegmentCommand* segment() const {
137 return segment_;
138 }
139
140 virtual void pc_relative(bool val) = 0;
141 virtual void type(uint8_t type);
142
143 void accept(Visitor& visitor) const override;
144
145 virtual std::ostream& print(std::ostream& os) const;
146
147 LIEF_API friend std::ostream& operator<<(std::ostream& os, const Relocation& relocation);
148
149 protected:
150 Symbol* symbol_ = nullptr;
151 uint8_t type_ = 0;
152 Header::CPU_TYPE architecture_ = Header::CPU_TYPE::ANY;
153 Section* section_ = nullptr;
154 SegmentCommand* segment_ = nullptr;
155};
156
157
158LIEF_API const char* to_string(Relocation::ORIGIN e);
159
160}
161}
162#endif
Class used to parse a single binary (i.e. non-FAT)
Definition BinaryParser.hpp:73
Class that represents a Mach-O relocation.
Definition MachO/Relocation.hpp:40
Header::CPU_TYPE architecture() const
Achitecture targeted by this relocation.
Definition MachO/Relocation.hpp:91
SegmentCommand * segment()
SegmentCommand associated with the relocation, if any, otherwise a nullptr.
Definition MachO/Relocation.hpp:133
virtual bool is_pc_relative() const =0
Indicates whether the item containing the address to be relocated is part of a CPU instruction that u...
Section * section()
Section associated with the relocation, if any, otherwise a nullptr.
Definition MachO/Relocation.hpp:119
bool has_symbol() const
true if the relocation has a symbol associated with
Definition MachO/Relocation.hpp:99
virtual ORIGIN origin() const =0
Origin of the relocation.
bool has_segment() const
true if the relocation has a SegmentCommand associated with
Definition MachO/Relocation.hpp:127
bool has_section() const
true if the relocation has a section associated with
Definition MachO/Relocation.hpp:113
virtual uint8_t type() const
Type of the relocation according to the Relocation::architecture and/or the Relocation::origin.
Definition MachO/Relocation.hpp:86
Symbol * symbol()
Symbol associated with the relocation, if any, otherwise a nullptr.
Definition MachO/Relocation.hpp:105
Class that represents a Mach-O section.
Definition MachO/Section.hpp:44
Class which represents a LoadCommand::TYPE::SEGMENT / LoadCommand::TYPE::SEGMENT_64 command.
Definition SegmentCommand.hpp:48
Class that represents a Symbol in a Mach-O file.
Definition MachO/Symbol.hpp:47
Class which represents an abstracted Relocation.
Definition Abstract/Relocation.hpp:27
virtual size_t size() const
Relocation size in bits
virtual uint64_t address() const
Relocation's address.
Class which represents an abstracted section.
Definition Abstract/Section.hpp:29
This class represents a symbol in an executable format.
Definition Abstract/Symbol.hpp:28
Definition Visitor.hpp:219
LIEF namespace.
Definition Abstract/Binary.hpp:32