Struct object::macho::DyldCacheHeader

#[repr(C)]
pub struct DyldCacheHeader<E: Endian> {

    pub magic: [u8; 16],
    pub mapping_offset: U32<E>,
    pub mapping_count: U32<E>,
    pub images_offset: U32<E>,
    pub images_count: U32<E>,
    pub dyld_base_address: U64<E>,
    pub local_symbols_offset: U64<E>,
    pub local_symbols_size: U64<E>,
    pub uuid: [u8; 16],
    pub subcaches_offset: U32<E>,
    pub subcaches_count: U32<E>,
    pub symbols_subcache_uuid: [u8; 16],
    pub images_across_all_subcaches_offset: U32<E>,
    pub images_across_all_subcaches_count: U32<E>,
    /* private fields */
}

The dyld cache header. Corresponds to struct dyld_cache_header from dyld_cache_format.h. This header has grown over time. Only the fields up to and including dyld_base_address are guaranteed to be present. For all other fields, check the header size before accessing the field. The header size is stored in mapping_offset; the mappings start right after the theader.

Fields

magic: [u8; 16]

e.g. “dyld_v0 i386”

mapping_offset: U32<E>

file offset to first dyld_cache_mapping_info

mapping_count: U32<E>

number of dyld_cache_mapping_info entries

images_offset: U32<E>

file offset to first dyld_cache_image_info

images_count: U32<E>

number of dyld_cache_image_info entries

dyld_base_address: U64<E>

base address of dyld when cache was built

local_symbols_offset: U64<E>

file offset of where local symbols are stored

local_symbols_size: U64<E>

size of local symbols information

uuid: [u8; 16]

unique value for each shared cache file

subcaches_offset: U32<E>

file offset to first dyld_subcache_info

subcaches_count: U32<E>

number of dyld_subcache_info entries

symbols_subcache_uuid: [u8; 16]

the UUID of the .symbols subcache

images_across_all_subcaches_offset: U32<E>

file offset to first dyld_cache_image_info Use this instead of images_offset if mapping_offset is at least 0x1c4.

images_across_all_subcaches_count: U32<E>

number of dyld_cache_image_info entries Use this instead of images_count if mapping_offset is at least 0x1c4.

Implementations

impl<E: Endian> DyldCacheHeader<E>

pub fn parse<'data, R: ReadRef<'data>>(data: R) -> Result<&'data Self>

Read the dyld cache header.

pub fn parse_magic(&self) -> Result<(Architecture, E)>

Returns (arch, endian) based on the magic string.

pub fn mappings<'data, R: ReadRef<'data>>( &self, endian: E, data: R ) -> Result<&'data [DyldCacheMappingInfo<E>]>

Return the mapping information table.

pub fn subcaches<'data, R: ReadRef<'data>>( &self, endian: E, data: R ) -> Result<Option<DyldSubCacheSlice<'data, E>>>

Return the information about subcaches, if present.

Returns None for dyld caches produced before dyld-940 (macOS 12).

pub fn symbols_subcache_uuid(&self, endian: E) -> Option<[u8; 16]>

Return the UUID for the .symbols subcache, if present.

pub fn images<'data, R: ReadRef<'data>>( &self, endian: E, data: R ) -> Result<&'data [DyldCacheImageInfo<E>]>

Return the image information table.

Trait Implementations

impl<E: Clone + Endian> Clone for DyldCacheHeader<E>

fn clone(&self) -> DyldCacheHeader<E>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<E: Debug + Endian> Debug for DyldCacheHeader<E>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<E: Copy + Endian> Copy for DyldCacheHeader<E>

impl<E: Endian> Pod for DyldCacheHeader<E>