LIEF: Library to Instrument Executable Formats Version 0.17.0
Loading...
Searching...
No Matches
Dylib.hpp
Go to the documentation of this file.
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_DSC_DYLIB_H
17#define LIEF_DSC_DYLIB_H
18#include "LIEF/visibility.h"
19#include "LIEF/iterators.hpp"
20#include "LIEF/errors.hpp"
21
22#include <memory>
23#include <string>
24
25namespace LIEF {
26
27namespace MachO {
28class Binary;
29}
30
31namespace dsc {
32
33namespace details {
34class Dylib;
35class DylibIt;
36}
37class LIEF_API Dylib {
41 public: class LIEF_API Iterator :
44 public iterator_facade_base<Iterator, std::random_access_iterator_tag,
45 std::unique_ptr<Dylib>, std::ptrdiff_t, Dylib*,
46 std::unique_ptr<Dylib>>
47 {
48 public:
49 using implementation = details::DylibIt;
50
51 Iterator(std::unique_ptr<details::DylibIt> impl);
52 Iterator(const Iterator&);
53 Iterator& operator=(const Iterator&);
54
55 Iterator(Iterator&&) noexcept;
56 Iterator& operator=(Iterator&&) noexcept;
57
58 ~Iterator();
59 bool operator<(const Iterator& rhs) const;
60
61 std::ptrdiff_t operator-(const Iterator& R) const;
62
63 Iterator& operator+=(std::ptrdiff_t n);
64 Iterator& operator-=(std::ptrdiff_t n);
65
66 friend LIEF_API bool operator==(const Iterator& LHS, const Iterator& RHS);
67
68 friend LIEF_API bool operator!=(const Iterator& LHS, const Iterator& RHS) {
69 return !(LHS == RHS);
70 }
71
72 std::unique_ptr<Dylib> operator*() const;
73
74 private:
75 std::unique_ptr<details::DylibIt> impl_;
76 };
77 public: struct LIEF_API extract_opt_t {
83 bool pack = true;
89 bool fix_branches = false;
97 bool fix_memory = false;
104 bool fix_relocations = false;
111 bool fix_objc = false;
114 LIEF::result<bool> create_dyld_chained_fixup_cmd;
120 };
121
122 Dylib(std::unique_ptr<details::Dylib> impl);
123 ~Dylib();
124 std::string path() const;
127 uint64_t address() const;
130 uint64_t modtime() const;
133 uint64_t inode() const;
139 uint64_t padding() const;
142 std::unique_ptr<LIEF::MachO::Binary> get(const extract_opt_t& opt = extract_opt_t()) const;
151
152 private:
153 std::unique_ptr<details::Dylib> impl_;
154};
155
156}
157}
158#endif
LIEF::MachO::Binary
Class which represents a MachO binary.
Definition MachO/Binary.hpp:86
LIEF::dsc::Dylib::Iterator::operator=
Iterator & operator=(const Iterator &)
LIEF::dsc::Dylib::Iterator::operator*
std::unique_ptr< Dylib > operator*() const
LIEF::dsc::Dylib::Iterator::Iterator
Iterator(const Iterator &)
LIEF::dsc::Dylib::Iterator::Iterator
Iterator(std::unique_ptr< details::DylibIt > impl)
LIEF::dsc::Dylib::Iterator::Iterator
Iterator(Iterator &&) noexcept
LIEF::dsc::Dylib
This class represents a library embedded in a dyld shared cache. It mirrors the original dyld_cache_i...
Definition Dylib.hpp:40
LIEF::dsc::Dylib::path
std::string path() const
Original path of the library (e.g. /usr/lib/libcryptex.dylib)
LIEF::dsc::Dylib::modtime
uint64_t modtime() const
Modification time of the library matching stat.st_mtime, or 0.
LIEF::dsc::Dylib::padding
uint64_t padding() const
Padding alignment value (should be 0)
LIEF::dsc::Dylib::get
std::unique_ptr< LIEF::MachO::Binary > get(const extract_opt_t &opt=extract_opt_t()) const
Get a MachO::Binary representation for this Dylib.
LIEF::dsc::Dylib::inode
uint64_t inode() const
File serial number matching stat.st_ino or 0.
LIEF::dsc::Dylib::address
uint64_t address() const
In-memory address of the library.
LIEF::dsc::Dylib::Dylib
Dylib(std::unique_ptr< details::Dylib > impl)
LIEF::dsc::Dylib::~Dylib
~Dylib()
errors.hpp
iterators.hpp
LIEF::MachO
Namespace related to the LIEF's Mach-O module.
Definition Abstract/Header.hpp:36
LIEF::dsc::details
Definition DyldSharedCache/DyldSharedCache.hpp:35
LIEF::dsc
Namespace related to the dyld shared cache support.
Definition caching.hpp:22
LIEF
LIEF namespace.
Definition Abstract/Binary.hpp:36
LIEF::result
tl::expected< T, lief_errors > result
Wrapper that contains an Object (T) or an error.
Definition errors.hpp:75
LIEF::dsc::Dylib::extract_opt_t::extract_opt_t
extract_opt_t()
visibility.h
LIEF_API
#define LIEF_API
Definition visibility.h:41