--- documentID: "1dacedc968429ba2ba47e5b9daf0ed1d492bdd2c414696821647ea1c1cb87f32" docname: "extended/dsc/cpp" title: "Dyld Shared Cache C++ API - LIEF Documentation" description: "Dyld Shared Cache C++ API reference documentation for LIEF, including APIs and examples for parsing, inspecting, modifying, and writing executable formats." canonical: "https://lief.re/doc/latest/extended/dsc/cpp.html" markdownURL: "https://lief.re/doc/latest/extended/dsc/cpp.md" documentationVersion: "2.0.0" documentationChannel: "latest" language: "en" contentHash: "ea526a360d569fa63b7d9af9cb9022d314617c8401c1feb9c9f8e4305d7d9e43" --- # [C++]() > **Note** > > You can also find the Doxygen documentation here: [here]() ## [` LIEF::dsc::load `]() inline std::unique\_ptr<[DyldSharedCache]( "LIEF::dsc::DyldSharedCache")> LIEF::dsc::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. In the case where multiple architectures are available in the `path` directory, the `arch` parameter can be used to define which architecture should be preferred. **Example:** ```cpp // From a directory (split caches) auto cache = LIEF::dsc::load("vision-pro-2.0/"); // From a single cache file auto cache = LIEF::dsc::load("ios-14.2/dyld_shared_cache_arm64"); // From a directory with multiple architectures auto cache = LIEF::dsc::load("macos-12.6/", /*arch=*‍/"x86_64h"); ``` ## [` LIEF::dsc::load `]() inline std::unique\_ptr<[DyldSharedCache]( "LIEF::dsc::DyldSharedCache")> LIEF::dsc::load(const std::vector<std::string> &files) Load a shared cache from a list of files. ```cpp std::vector files = { "/tmp/dsc/dyld_shared_cache_arm64e", "/tmp/dsc/dyld_shared_cache_arm64e.1" }; auto cache = LIEF::dsc::load(files); ``` ## [Cache Processing]() > **Warning** > > If you aim at extracting several libraries from a dyld shared cache, it is **highly** recommended to enable caching. Otherwise, performances can be impacted. ### [` LIEF::dsc::enable_cache `]() bool LIEF::dsc::enable\_cache() Enable globally cache/memoization. One can also leverage this function by setting the environment variable `DYLDSC_ENABLE_CACHE` to `1`. By default, LIEF will use the directory specified by the environment variable `DYLDSC_CACHE_DIR` as its cache-root directory: ```bash DYLDSC_ENABLE_CACHE=1 DYLDSC_CACHE_DIR=/tmp/my_dir ./my-program ``` Otherwise, if `DYLDSC_CACHE_DIR` is not set, LIEF will use the following directory (in this priority): 1. System or user cache directory - macOS: `DARWIN_USER_TEMP_DIR` / `DARWIN_USER_CACHE_DIR` + `/dyld_shared_cache` - Linux: `${XDG_CACHE_HOME}/dyld_shared_cache` - Windows: `LOCALAPPDATA%\dyld_shared_cache` 2. Home directory - macOS/Linux: `$HOME/.dyld_shared_cache` - Windows: `USERPROFILE%\.dyld_shared_cache` > **See also** > > [LIEF::dsc::DyldSharedCache::enable\_caching]() for a finer granularity ### [` LIEF::dsc::enable_cache `]() bool LIEF::dsc::enable\_cache(const std::string &dir) Same behavior as [enable\_cache()]() but with a user-provided cache directory. ## [DyldSharedCache]() ### [` DyldSharedCache `]() class DyldSharedCache This class represents a dyld shared cache file. Public Types #### [` VERSION `]() enum class VERSION : uint32\_t This enum wraps the dyld’s git tags for which the structure of dyld shared cache evolved. *Values:* ##### [` UNKNOWN `]() enumerator UNKNOWN = 0 ##### [` DYLD_95_3 `]() enumerator DYLD\_95\_3 dyld-95.3 (2007-10-30) ##### [` DYLD_195_5 `]() enumerator DYLD\_195\_5 dyld-195.5 (2011-07-13) ##### [` DYLD_239_3 `]() enumerator DYLD\_239\_3 dyld-239.3 (2013-10-29) ##### [` DYLD_360_14 `]() enumerator DYLD\_360\_14 dyld-360.14 (2015-09-04) ##### [` DYLD_421_1 `]() enumerator DYLD\_421\_1 dyld-421.1 (2016-09-22) ##### [` DYLD_832_7_1 `]() enumerator DYLD\_832\_7\_1 dyld-832.7.1 (2020-11-19) ##### [` DYLD_940 `]() enumerator DYLD\_940 dyld-940 (2021-02-09) ##### [` DYLD_1042_1 `]() enumerator DYLD\_1042\_1 dyld-1042.1 (2022-10-19) ##### [` DYLD_1231_3 `]() enumerator DYLD\_1231\_3 dyld-1231.3 (2024-09-24) ##### [` DYLD_1284_13 `]() enumerator DYLD\_1284\_13 dyld-1284.13 (2025-04-25) ##### [` UNRELEASED `]() enumerator UNRELEASED This value is used for versions of dyld not publicly released or not yet supported by LIEF. #### [` DYLD_TARGET_PLATFORM `]() enum class DYLD\_TARGET\_PLATFORM : uint32\_t Platforms supported by the dyld shared cache. *Values:* ##### [` UNKNOWN `]() enumerator UNKNOWN = 0 ##### [` MACOS `]() enumerator MACOS = 1 ##### [` IOS `]() enumerator IOS = 2 ##### [` TVOS `]() enumerator TVOS = 3 ##### [` WATCHOS `]() enumerator WATCHOS = 4 ##### [` BRIDGEOS `]() enumerator BRIDGEOS = 5 ##### [` IOSMAC `]() enumerator IOSMAC = 6 ##### [` IOS_SIMULATOR `]() enumerator IOS\_SIMULATOR = 7 ##### [` TVOS_SIMULATOR `]() enumerator TVOS\_SIMULATOR = 8 ##### [` WATCHOS_SIMULATOR `]() enumerator WATCHOS\_SIMULATOR = 9 ##### [` DRIVERKIT `]() enumerator DRIVERKIT = 10 ##### [` VISIONOS `]() enumerator VISIONOS = 11 ##### [` VISIONOS_SIMULATOR `]() enumerator VISIONOS\_SIMULATOR = 12 ##### [` FIRMWARE `]() enumerator FIRMWARE = 13 ##### [` SEPOS `]() enumerator SEPOS = 14 ##### [` ANY `]() enumerator ANY = 0xFFFFFFFF #### [` DYLD_TARGET_ARCH `]() enum class DYLD\_TARGET\_ARCH Architecture supported by the dyld shared cache. *Values:* ##### [` UNKNOWN `]() enumerator UNKNOWN = 0 ##### [` I386 `]() enumerator I386 ##### [` X86_64 `]() enumerator X86\_64 ##### [` X86_64H `]() enumerator X86\_64H ##### [` ARMV5 `]() enumerator ARMV5 ##### [` ARMV6 `]() enumerator ARMV6 ##### [` ARMV7 `]() enumerator ARMV7 ##### [` ARM64 `]() enumerator ARM64 ##### [` ARM64E `]() enumerator ARM64E #### [` dylib_iterator `]() using dylib\_iterator = [iterator\_range]( "LIEF::iterator_range")<[Dylib]( "LIEF::dsc::Dylib")::[Iterator]( "LIEF::dsc::Dylib::Iterator")> Iterator over the libraries in the shared cache. #### [` mapping_info_iterator `]() using mapping\_info\_iterator = [iterator\_range]( "LIEF::iterator_range")<[MappingInfo]( "LIEF::dsc::MappingInfo")::[Iterator]( "LIEF::dsc::MappingInfo::Iterator")> Iterator over the mapping info in the shared cache. #### [` subcache_iterator `]() using subcache\_iterator = [iterator\_range]( "LIEF::iterator_range")<[SubCache]( "LIEF::dsc::SubCache")::[Iterator]( "LIEF::dsc::SubCache::Iterator")> Iterator over the split/sub-cache in this **main** shared cache. #### [` instructions_iterator `]() using instructions\_iterator = [iterator\_range]( "LIEF::iterator_range")<assembly::[Instruction]( "LIEF::assembly::Instruction")::[Iterator]( "LIEF::assembly::Instruction::Iterator")> Public Functions #### [` DyldSharedCache `]() DyldSharedCache(std::unique\_ptr<details::DyldSharedCache> impl) #### [` ~DyldSharedCache `]() ~DyldSharedCache() #### [` filename `]() std::string filename() const Filename of the dyld shared file associated with this object. For instance: `dyld_shared_cache_arm64e, dyld_shared_cache_arm64e.62.dyldlinkedit` #### [` version `]() [VERSION]( "LIEF::dsc::DyldSharedCache::VERSION") version() const Version of dyld used by this cache. #### [` filepath `]() std::string filepath() const Full path to the original dyld shared cache file associated with object (e.g. `/home/lief/downloads/visionos/dyld_shared_cache_arm64e.42`). #### [` load_address `]() uint64\_t load\_address() const Based address of this cache. #### [` arch_name `]() std::string arch\_name() const Name of the architecture targeted by this cache (`x86_64h`). #### [` platform `]() [DYLD\_TARGET\_PLATFORM]( "LIEF::dsc::DyldSharedCache::DYLD_TARGET_PLATFORM") platform() const Platform targeted by this cache (e.g. visionOS). #### [` arch `]() [DYLD\_TARGET\_ARCH]( "LIEF::dsc::DyldSharedCache::DYLD_TARGET_ARCH") arch() const Architecture targeted by this cache. #### [` find_lib_from_va `]() std::unique\_ptr<[Dylib]( "LIEF::dsc::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 found. #### [` find_lib_from_path `]() std::unique\_ptr<[Dylib]( "LIEF::dsc::Dylib")> find\_lib\_from\_path(const std::string &path) const Find the [Dylib]() whose [Dylib::path]() matches the provided path. #### [` find_lib_from_name `]() std::unique\_ptr<[Dylib]( "LIEF::dsc::Dylib")> find\_lib\_from\_name(const std::string &name) const Find the [Dylib]() whose filename of [Dylib::path]() matches the provided name. If multiple libraries have the same name (but with a different path), the **first one** matching the provided name is returned. #### [` has_subcaches `]() bool has\_subcaches() const True if the subcaches are associated with this cache. #### [` libraries `]() [dylib\_iterator]( "LIEF::dsc::DyldSharedCache::dylib_iterator") libraries() const Return an iterator over the libraries embedded in this dyld shared cache. This iterator implements the *random access* trait. Thus, one can use [iterator\_range::size](), [iterator\_range::at](), [iterator\_range::operator[]]() to access [Dylib]() at an arbitrary index: ```cpp auto libraries = cache.libaries(); for (size_t i = 0; i < libraries.size(); ++i) { std::string path = libaries[i]->path(); } ``` #### [` mapping_info `]() [mapping\_info\_iterator]( "LIEF::dsc::DyldSharedCache::mapping_info_iterator") mapping\_info() const Return an iterator over the mapping information of this dyld shared cache. This iterator implements the *random access* trait. Thus, one can use [iterator\_range::size](), [iterator\_range::at](), [iterator\_range::operator[]]() to access a [MappingInfo]() at an arbitrary index: ```cpp auto mapping = cache.mapping_info(); for (size_t i = 0; i < mapping.size(); ++i) { const uint64_t addr = mapping[i]->address(); } ``` #### [` subcaches `]() [subcache\_iterator]( "LIEF::dsc::DyldSharedCache::subcache_iterator") subcaches() const Return an iterator over the subcaches associated with this (main) dyld shared cache. This iterator implements the *random access* trait. Thus, one can use [iterator\_range::size](), [iterator\_range::at](), [iterator\_range::operator[]]() to access a [SubCache]() at an arbitrary index: ```cpp auto subcaches = cache.subcaches(); for (size_t i = 0; i < subcaches.size(); ++i) { std::unique_ptr impl = subcaches[i]->cache(); } ``` #### [` disassemble `]() [instructions\_iterator]( "LIEF::dsc::DyldSharedCache::instructions_iterator") disassemble(uint64\_t va) const Disassemble instructions at the provided virtual address. This function returns an iterator over [assembly::Instruction](). #### [` get_content_from_va `]() std::vector<uint8\_t> get\_content\_from\_va(uint64\_t va, uint64\_t size) const Return the content at the specified virtual address. #### [` cache_for_address `]() std::unique\_ptr<[DyldSharedCache]( "LIEF::dsc::DyldSharedCache")> cache\_for\_address(uint64\_t va) const Find the sub-DyldSharedCache that wraps the given virtual address. #### [` main_cache `]() std::unique\_ptr<[DyldSharedCache]( "LIEF::dsc::DyldSharedCache")> main\_cache() const Return the principal dyld shared cache in the case of multiple subcaches. #### [` find_subcache `]() std::unique\_ptr<[DyldSharedCache]( "LIEF::dsc::DyldSharedCache")> find\_subcache(const std::string &filename) const Try to find the [DyldSharedCache]() associated with the filename given in the first parameter. #### [` va_to_offset `]() [result]( "LIEF::result")<uint64\_t> va\_to\_offset(uint64\_t va) const Convert the given virtual address into an offset. > **Warning** > > If the shared cache contains multiple subcaches, this function needs to be called on the targeted subcache. See [cache\_for\_address()]() to find the associated subcache. #### [` stream `]() [FileStream]( "LIEF::FileStream") &stream() const Return the stream associated with this dyld shared cache. #### [` stream `]() [FileStream]( "LIEF::FileStream") &stream() Return the stream associated with this dyld shared cache. #### [` enable_caching `]() void enable\_caching(const std::string &target\_cache\_dir) const When enabled, this function records and keeps in *cache* the dyld shared cache information that is costly to access. For instance, GOT symbols, rebases information, stub symbols, … It is **highly** recommended to enable this function when processing a dyld shared cache several times or when extracting a large number of [LIEF::dsc::Dylib]() with enhanced extraction options (e.g. [Dylib::extract\_opt\_t::fix\_branches]()) One can enable caching by calling this function: ```cpp auto dyld_cache = LIEF::dsc::load("macos-15.0.1/"); dyld_cache->enable_caching("/home/user/.cache/lief-dsc"); ``` One can also enable this cache optimization **globally** using the function: [LIEF::dsc::enable\_cache]() or by setting the environment variable `DYLDSC_ENABLE_CACHE` to 1. #### [` flush_cache `]() void flush\_cache() const Flush internal information into the on-disk cache (see: enable\_caching). Public Static Functions #### [` from_path `]() static std::unique\_ptr<[DyldSharedCache]( "LIEF::dsc::DyldSharedCache")> from\_path(const std::string &path, const std::string &arch = "") See the [load]() functions for the details. #### [` from_files `]() static std::unique\_ptr<[DyldSharedCache]( "LIEF::dsc::DyldSharedCache")> from\_files(const std::vector<std::string> &path) See the [load]() functions for the details. ## [Dylib]() ### [` Dylib `]() class Dylib This class represents a library embedded in a dyld shared cache. It mirrors the original `dyld_cache_image_info` structure. Public Functions #### [` Dylib `]() Dylib(std::unique\_ptr<details::Dylib> impl) #### [` ~Dylib `]() ~Dylib() #### [` path `]() std::string path() const Original path of the library (e.g. `/usr/lib/libcryptex.dylib`). #### [` address `]() uint64\_t address() const In-memory address of the library. #### [` modtime `]() uint64\_t modtime() const Modification time of the library matching `stat.st_mtime`, or 0. #### [` inode `]() uint64\_t inode() const File serial number matching `stat.st_ino` or 0. Note that for shared cache targeting iOS, this value can hold a hash of the path (if modtime is set to 0) #### [` padding `]() uint64\_t padding() const Padding alignment value (should be 0). #### [` get `]() std::unique\_ptr<LIEF::MachO::[Binary]( "LIEF::MachO::Binary")> get(const [extract\_opt\_t]( "LIEF::dsc::Dylib::extract_opt_t") &opt = [extract\_opt\_t]( "LIEF::dsc::Dylib::extract_opt_t")()) const Get a [MachO::Binary]() representation for this [Dylib](). One can use this function to write back the Mach-O binary on the disk: ```cpp dyld_cache->libraries()[12]->get()->write("liblockdown.dylib"); ``` #### [` Iterator `]() class Iterator : public LIEF::iterator\_facade\_base<[Iterator]( "LIEF::dsc::Dylib::Iterator"), std::random\_access\_iterator\_tag, [Dylib]( "LIEF::dsc::Dylib"), std::ptrdiff\_t, const [Dylib]( "LIEF::dsc::Dylib")\*, const [Dylib]( "LIEF::dsc::Dylib")&> [Dylib]() [Iterator](). Public Types ##### [` implementation `]() using implementation = details::DylibIt Public Functions ##### [` Iterator `]() Iterator() ##### [` Iterator `]() Iterator(std::unique\_ptr<details::DylibIt> impl) ##### [` Iterator `]() Iterator(const [Iterator]( "LIEF::dsc::Dylib::Iterator::Iterator")&) ##### [` operator= `]() [Iterator]( "LIEF::dsc::Dylib::Iterator") &operator=(const [Iterator]( "LIEF::dsc::Dylib::Iterator")&) ##### [` Iterator `]() Iterator([Iterator]( "LIEF::dsc::Dylib::Iterator::Iterator")&&) noexcept ##### [` operator= `]() [Iterator]( "LIEF::dsc::Dylib::Iterator") &operator=([Iterator]( "LIEF::dsc::Dylib::Iterator")&&) noexcept ##### [` ~Iterator `]() ~Iterator() ##### [` operator< `]() bool operator<(const [Iterator]( "LIEF::dsc::Dylib::Iterator") &rhs) const ##### [` operator- `]() std::ptrdiff\_t operator-(const [Iterator]( "LIEF::dsc::Dylib::Iterator") &R) const ##### [` operator+= `]() [Iterator]( "LIEF::dsc::Dylib::Iterator") &operator+=(std::ptrdiff\_t n) ##### [` operator-= `]() [Iterator]( "LIEF::dsc::Dylib::Iterator") &operator-=(std::ptrdiff\_t n) ##### [` operator* `]() const [Dylib]( "LIEF::dsc::Dylib") &operator\*() const ##### [` operator-> `]() const [Dylib]( "LIEF::dsc::Dylib") \*operator->() const ##### [` yield `]() std::unique\_ptr<[Dylib]( "LIEF::dsc::Dylib")> yield() Transfer ownership of the dylib at the current position to the caller. Returns `nullptr` if the iterator is past-the-end. Friends ##### [` operator== `]() friend bool operator==(const [Iterator]( "LIEF::dsc::Dylib::Iterator") &LHS, const [Iterator]( "LIEF::dsc::Dylib::Iterator") &RHS) ##### [` operator!= `]() inline friend bool operator!=(const [Iterator]( "LIEF::dsc::Dylib::Iterator") &LHS, const [Iterator]( "LIEF::dsc::Dylib::Iterator") &RHS) #### [` extract_opt_t `]() struct extract\_opt\_t This structure is used to tweak the extraction process while calling [Dylib::get](). These options allow deoptimizing the dylib to get an accurate representation of the origin Mach-O binary. Public Functions ##### [` extract_opt_t `]() extract\_opt\_t() Public Members ##### [` pack `]() bool pack = true Whether the segment’s offsets should be packed to avoid an in-memory size while writing back the binary. > **Note** > > This option does not have an impact on the performances ##### [` fix_branches `]() bool fix\_branches = false Fix call instructions that target addresses outside the current dylib virtual space. > **Warning** > > Enabling this option can have a significant impact on the performances. Make sure to enable the internal cache mechanism: [LIEF::dsc::enable\_cache]() or [LIEF::dsc::DyldSharedCache::enable\_caching]() ##### [` fix_memory `]() bool fix\_memory = false Fix memory accesses performed outside the dylib’s virtual space. > **Warning** > > Enabling this option can have a significant impact on the performances. Make sure to enable the internal cache mechanism: [LIEF::dsc::enable\_cache]() or [LIEF::dsc::DyldSharedCache::enable\_caching]() ##### [` fix_relocations `]() bool fix\_relocations = false Recover and fix relocations. > **Warning** > > Enabling this option can have a significant impact on the performances. Make sure to enable the internal cache mechanism: [LIEF::dsc::enable\_cache]() or [LIEF::dsc::DyldSharedCache::enable\_caching]() ##### [` fix_objc `]() bool fix\_objc = false Fix Objective-C information. ##### [` create_dyld_chained_fixup_cmd `]() LIEF::[result]( "LIEF::result")<bool> create\_dyld\_chained\_fixup\_cmd Whether the `LC_DYLD_CHAINED_FIXUPS` command should be (re)created. If this value is not set, LIEF will add the command only if it’s meaningful regarding the other options ## [MappingInfo]() ### [` MappingInfo `]() class MappingInfo This class represents a `dyld_cache_mapping_info` entry. It provides information about the relationship between on-disk shared cache and in-memory shared cache. Public Functions #### [` MappingInfo `]() MappingInfo(std::unique\_ptr<details::MappingInfo> impl) #### [` ~MappingInfo `]() ~MappingInfo() #### [` address `]() uint64\_t address() const The in-memory address where this dyld shared cache region is mapped. #### [` size `]() uint64\_t size() const Size of the region being mapped. #### [` end_address `]() inline uint64\_t end\_address() const End virtual address of the region. #### [` file_offset `]() uint64\_t file\_offset() const On-disk file offset. #### [` max_prot `]() uint32\_t max\_prot() const Max memory protection. #### [` init_prot `]() uint32\_t init\_prot() const Initial memory protection. #### [` Iterator `]() class Iterator : public LIEF::iterator\_facade\_base<[Iterator]( "LIEF::dsc::MappingInfo::Iterator"), std::random\_access\_iterator\_tag, [MappingInfo]( "LIEF::dsc::MappingInfo"), std::ptrdiff\_t, const [MappingInfo]( "LIEF::dsc::MappingInfo")\*, const [MappingInfo]( "LIEF::dsc::MappingInfo")&> [MappingInfo]() [Iterator](). Public Types ##### [` implementation `]() using implementation = details::MappingInfoIt Public Functions ##### [` Iterator `]() Iterator() ##### [` Iterator `]() Iterator(std::unique\_ptr<details::MappingInfoIt> impl) ##### [` Iterator `]() Iterator(const [Iterator]( "LIEF::dsc::MappingInfo::Iterator::Iterator")&) ##### [` operator= `]() [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &operator=(const [Iterator]( "LIEF::dsc::MappingInfo::Iterator")&) ##### [` Iterator `]() Iterator([Iterator]( "LIEF::dsc::MappingInfo::Iterator::Iterator")&&) noexcept ##### [` operator= `]() [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &operator=([Iterator]( "LIEF::dsc::MappingInfo::Iterator")&&) noexcept ##### [` ~Iterator `]() ~Iterator() ##### [` operator< `]() bool operator<(const [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &rhs) const ##### [` operator- `]() std::ptrdiff\_t operator-(const [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &R) const ##### [` operator+= `]() [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &operator+=(std::ptrdiff\_t n) ##### [` operator-= `]() [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &operator-=(std::ptrdiff\_t n) ##### [` operator* `]() const [MappingInfo]( "LIEF::dsc::MappingInfo") &operator\*() const ##### [` operator-> `]() const [MappingInfo]( "LIEF::dsc::MappingInfo") \*operator->() const ##### [` yield `]() std::unique\_ptr<[MappingInfo]( "LIEF::dsc::MappingInfo")> yield() Transfer ownership of the mapping info at the current position to the caller. Returns `nullptr` if the iterator is past-the-end. Friends ##### [` operator== `]() friend bool operator==(const [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &LHS, const [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &RHS) ##### [` operator!= `]() inline friend bool operator!=(const [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &LHS, const [Iterator]( "LIEF::dsc::MappingInfo::Iterator") &RHS) ## [SubCache]() ### [` SubCache `]() class SubCache This class represents a subcache in the case of large/split dyld shared cache. It mirrors (and abstracts) the original `dyld_subcache_entry` / `dyld_subcache_entry_v1` Public Functions #### [` SubCache `]() SubCache(std::unique\_ptr<details::SubCache> impl) #### [` ~SubCache `]() ~SubCache() #### [` uuid `]() sc\_uuid\_t uuid() const The uuid of the subcache file. #### [` vm_offset `]() uint64\_t vm\_offset() const The offset of this subcache from the main cache base address. #### [` suffix `]() std::string suffix() const The file name suffix of the subCache file (e.g. `.25.data`, `.03.development`). #### [` cache `]() std::unique\_ptr<const [DyldSharedCache]( "LIEF::dsc::DyldSharedCache")> cache() const The associated [DyldSharedCache]() object for this subcache. Friends #### [` operator<< `]() friend std::ostream &operator<<(std::ostream &os, const [SubCache]( "LIEF::dsc::SubCache") &subcache) #### [` Iterator `]() class Iterator : public LIEF::iterator\_facade\_base<[Iterator]( "LIEF::dsc::SubCache::Iterator"), std::random\_access\_iterator\_tag, [SubCache]( "LIEF::dsc::SubCache"), std::ptrdiff\_t, const [SubCache]( "LIEF::dsc::SubCache")\*, const [SubCache]( "LIEF::dsc::SubCache")&> [SubCache]() [Iterator](). Public Types ##### [` implementation `]() using implementation = details::SubCacheIt Public Functions ##### [` Iterator `]() Iterator() ##### [` Iterator `]() Iterator(std::unique\_ptr<details::SubCacheIt> impl) ##### [` Iterator `]() Iterator(const [Iterator]( "LIEF::dsc::SubCache::Iterator::Iterator")&) ##### [` operator= `]() [Iterator]( "LIEF::dsc::SubCache::Iterator") &operator=(const [Iterator]( "LIEF::dsc::SubCache::Iterator")&) ##### [` Iterator `]() Iterator([Iterator]( "LIEF::dsc::SubCache::Iterator::Iterator")&&) noexcept ##### [` operator= `]() [Iterator]( "LIEF::dsc::SubCache::Iterator") &operator=([Iterator]( "LIEF::dsc::SubCache::Iterator")&&) noexcept ##### [` ~Iterator `]() ~Iterator() ##### [` operator< `]() bool operator<(const [Iterator]( "LIEF::dsc::SubCache::Iterator") &rhs) const ##### [` operator- `]() std::ptrdiff\_t operator-(const [Iterator]( "LIEF::dsc::SubCache::Iterator") &R) const ##### [` operator+= `]() [Iterator]( "LIEF::dsc::SubCache::Iterator") &operator+=(std::ptrdiff\_t n) ##### [` operator-= `]() [Iterator]( "LIEF::dsc::SubCache::Iterator") &operator-=(std::ptrdiff\_t n) ##### [` operator* `]() const [SubCache]( "LIEF::dsc::SubCache") &operator\*() const ##### [` operator-> `]() const [SubCache]( "LIEF::dsc::SubCache") \*operator->() const ##### [` yield `]() std::unique\_ptr<[SubCache]( "LIEF::dsc::SubCache")> yield() Transfer ownership of the subcache at the current position to the caller. Returns `nullptr` if the iterator is past-the-end. Friends ##### [` operator== `]() friend bool operator==(const [Iterator]( "LIEF::dsc::SubCache::Iterator") &LHS, const [Iterator]( "LIEF::dsc::SubCache::Iterator") &RHS) ##### [` operator!= `]() inline friend bool operator!=(const [Iterator]( "LIEF::dsc::SubCache::Iterator") &LHS, const [Iterator]( "LIEF::dsc::SubCache::Iterator") &RHS) ## [Utilities]() ### [` LIEF::dsc::is_shared_cache `]() bool LIEF::dsc::is\_shared\_cache([BinaryStream]( "LIEF::BinaryStream") &stream) Check if the given stream wraps a Dyld Shared Cache. ### [` LIEF::dsc::is_shared_cache `]() inline bool LIEF::dsc::is\_shared\_cache(const std::vector<uint8\_t> &buffer) Check if the given buffer points to a dyld shared cache file. ### [` LIEF::dsc::is_shared_cache `]() inline bool LIEF::dsc::is\_shared\_cache(const uint8\_t \*buffer, size\_t size) Check if the given buffer points to a dyld shared cache file.