LIEF: Library to Instrument Executable Formats Version 0.16.2
|
Loading...
Searching...
No Matches
Go to the documentation of this file.
16#ifndef LIEF_DSC_DYLD_SHARED_CACHE_H
17#define LIEF_DSC_DYLD_SHARED_CACHE_H
42 enum class VERSION : uint32_t {
61 enum class DYLD_TARGET_PLATFORM : uint32_t {
73 WATCHOS_SIMULATOR = 9,
76 VISIONOS_SIMULATOR = 12,
82 enum class DYLD_TARGET_ARCH {
99 using dylib_iterator = iterator_range<Dylib::Iterator>;
102 using mapping_info_iterator = iterator_range<MappingInfo::Iterator>;
105 using subcache_iterator = iterator_range<SubCache::Iterator>;
109 using instructions_iterator = iterator_range<assembly::Instruction::Iterator>;
113 static std::unique_ptr<DyldSharedCache>
from_path(
const std::string& path,
116 const std::string& arch =
"");
117 static std::unique_ptr<DyldSharedCache>
from_files(
const std::vector<std::string>& path);
138 DYLD_TARGET_PLATFORM
platform()
const;
141 DYLD_TARGET_ARCH
arch()
const;
203 instructions_iterator
disassemble(uint64_t va)
const;
213 std::unique_ptr<DyldSharedCache>
main_cache()
const;
216 std::unique_ptr<DyldSharedCache>
find_subcache(
const std::string& filename)
const;
227 FileStream&
stream()
const;
259 std::unique_ptr<details::DyldSharedCache> impl_;
261inline std::unique_ptr<DyldSharedCache>
load(
const std::string& path,
282 const std::string& arch =
"")
286inline std::unique_ptr<DyldSharedCache>
load(
const std::vector<std::string>& files)
Stream interface over a std::ifstream
Definition FileStream.hpp:30
This class represents a dyld shared cache file.
Definition DyldSharedCache/DyldSharedCache.hpp:40
std::string filepath() const
Full path to the original dyld shared cache file associated with object (e.g. /home/lief/downloads/vi...
void flush_cache() const
Flush internal information into the on-disk cache (see: enable_caching)
uint64_t load_address() const
Based address of this cache.
instructions_iterator disassemble(uint64_t va) const
Disassemble instructions at the provided virtual address. This function returns an iterator over asse...
FileStream & stream() const
Return the stream associated with this dyld shared cache.
FileStream & stream()
Return the stream associated with this dyld shared cache.
dylib_iterator libraries() const
Return an interator over the libraries embedded in this dyld shared cache.
void enable_caching(const std::string &target_cache_dir) const
When enabled, this function allows to record and to keep in cache, dyld shared cache information that...
DyldSharedCache(std::unique_ptr< details::DyldSharedCache > impl)
bool has_subcaches() const
True if the subcaches are associated with this cache.
DYLD_TARGET_ARCH arch() const
Architecture targeted by this cache.
DYLD_TARGET_PLATFORM platform() const
Platform targeted by this cache (e.g. vision-os)
std::unique_ptr< Dylib > find_lib_from_path(const std::string &path) const
Find the Dylib whose Dylib::path matches the provided path.
static std::unique_ptr< DyldSharedCache > from_path(const std::string &path, const std::string &arch="")
See the load functions for the details.
std::unique_ptr< Dylib > find_lib_from_name(const std::string &name) const
Find the Dylib whose filename of Dylib::path matches the provided name.
std::unique_ptr< DyldSharedCache > cache_for_address(uint64_t va) const
Find the sub-DyldSharedCache that wraps the given virtual address.
std::vector< uint8_t > get_content_from_va(uint64_t va, uint64_t size) const
Return the content at the specified virtual address.
std::string arch_name() const
Name of the architecture targeted by this cache (x86_64h)
std::string filename() const
Filename of the dyld shared file associated with this object.
std::unique_ptr< Dylib > find_lib_from_va(uint64_t va) const
Find the Dylib that encompasses the given virtual address. It returns a nullptr if a Dylib can't be f...
mapping_info_iterator mapping_info() const
Return an interator over the mapping information of this dyld shared cache.
std::unique_ptr< DyldSharedCache > find_subcache(const std::string &filename) const
Try to find the DyldSharedCache associated with the filename given in the first parameter.
static std::unique_ptr< DyldSharedCache > from_files(const std::vector< std::string > &path)
See the load functions for the details.
result< uint64_t > va_to_offset(uint64_t va) const
Convert the given virtual address into an offset.
std::unique_ptr< DyldSharedCache > main_cache() const
Return the principal dyld shared cache in the case of multiple subcaches.
subcache_iterator subcaches() const
Return an interator over the subcaches associated with this (main) dyld shared cache.
VERSION version() const
Version of dyld used by this cache.
Definition DyldSharedCache/DyldSharedCache.hpp:35
Namespace related to the dyld shared cache support.
Definition caching.hpp:22
std::unique_ptr< DyldSharedCache > load(const std::string &path, const std::string &arch="")
Load a shared cache from a single file or from a directory specified by the path parameter.
Definition DyldSharedCache/DyldSharedCache.hpp:281
LIEF namespace.
Definition Abstract/Binary.hpp:36
#define LIEF_API
Definition visibility.h:41