/* -*- mode: C++; c-basic-offset: 4; tab-width: 4 -*- * * Copyright (c) 2003-2010 Apple Inc. All rights reserved. * * @APPLE_LICENSE_HEADER_START@ * * This file contains Original Code and/or Modifications of Original Code * as defined in and that are subject to the Apple Public Source License * Version 2.0 (the 'License'). You may not use this file except in * compliance with the License. Please obtain a copy of the License at * http://www.opensource.apple.com/apsl/ and read it before using this * file. * * The Original Code and all software distributed under the License are * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. * Please see the License for the specific language governing rights and * limitations under the License. * * @APPLE_LICENSE_HEADER_END@ */ #ifndef _CACHE_PATCHING_H_ #define _CACHE_PATCHING_H_ #include // // MARK: --- V1 patching. This is for old caches, before Large/Split caches --- // struct dyld_cache_patch_info_v1 { uint64_t patchTableArrayAddr; // (unslid) address of array for dyld_cache_image_patches for each image uint64_t patchTableArrayCount; // count of patch table entries uint64_t patchExportArrayAddr; // (unslid) address of array for patch exports for each image uint64_t patchExportArrayCount; // count of patch exports entries uint64_t patchLocationArrayAddr; // (unslid) address of array for patch locations for each patch uint64_t patchLocationArrayCount;// count of patch location entries uint64_t patchExportNamesAddr; // blob of strings of export names for patches uint64_t patchExportNamesSize; // size of string blob of export names for patches }; struct dyld_cache_image_patches_v1 { uint32_t patchExportsStartIndex; uint32_t patchExportsCount; }; struct dyld_cache_patchable_export_v1 { uint32_t cacheOffsetOfImpl; uint32_t patchLocationsStartIndex; uint32_t patchLocationsCount; uint32_t exportNameOffset; }; struct dyld_cache_patchable_location_v1 { uint32_t cacheOffset; uint64_t high7 : 7, addend : 5, // 0..31 authenticated : 1, usesAddressDiversity : 1, key : 2, discriminator : 16; }; // // MARK: --- V2 patching. This is for Large/Split caches and newer --- // struct dyld_cache_patch_info_v2 { uint32_t patchTableVersion; // == 2 uint32_t patchLocationVersion; // == 0 for now uint64_t patchTableArrayAddr; // (unslid) address of array for dyld_cache_image_patches_v2 for each image uint64_t patchTableArrayCount; // count of patch table entries uint64_t patchImageExportsArrayAddr; // (unslid) address of array for dyld_cache_image_export_v2 for each image uint64_t patchImageExportsArrayCount; // count of patch table entries uint64_t patchClientsArrayAddr; // (unslid) address of array for dyld_cache_image_clients_v2 for each image uint64_t patchClientsArrayCount; // count of patch clients entries uint64_t patchClientExportsArrayAddr; // (unslid) address of array for patch exports for each client image uint64_t patchClientExportsArrayCount; // count of patch exports entries uint64_t patchLocationArrayAddr; // (unslid) address of array for patch locations for each patch uint64_t patchLocationArrayCount; // count of patch location entries uint64_t patchExportNamesAddr; // blob of strings of export names for patches uint64_t patchExportNamesSize; // size of string blob of export names for patches }; struct dyld_cache_image_patches_v2 { uint32_t patchClientsStartIndex; uint32_t patchClientsCount; uint32_t patchExportsStartIndex; // Points to dyld_cache_image_export_v2[] uint32_t patchExportsCount; }; struct dyld_cache_image_export_v2 { uint32_t dylibOffsetOfImpl; // Offset from the dylib we used to find a dyld_cache_image_patches_v2 uint32_t exportNameOffset : 28; uint32_t patchKind : 4; // One of DyldSharedCache::patchKind }; struct dyld_cache_image_clients_v2 { uint32_t clientDylibIndex; uint32_t patchExportsStartIndex; // Points to dyld_cache_patchable_export_v2[] uint32_t patchExportsCount; }; struct dyld_cache_patchable_export_v2 { uint32_t imageExportIndex; // Points to dyld_cache_image_export_v2 uint32_t patchLocationsStartIndex; // Points to dyld_cache_patchable_location_v2[] uint32_t patchLocationsCount; }; struct dyld_cache_patchable_location_v2 { uint32_t dylibOffsetOfUse; // Offset from the dylib we used to get a dyld_cache_image_clients_v2 uint32_t high7 : 7, addend : 5, // 0..31 authenticated : 1, usesAddressDiversity : 1, key : 2, discriminator : 16; }; // // MARK: --- V3 patching. This is V2 plus support for GOT combining --- // struct dyld_cache_patch_info_v3 { struct dyld_cache_patch_info_v2 infoV2; // uint32_t patchTableVersion; // == 3 // ... other fields from dyld_cache_patch_info_v2 uint64_t gotClientsArrayAddr; // (unslid) address of array for dyld_cache_image_got_clients_v3 for each image uint64_t gotClientsArrayCount; // count of got clients entries. Should always match the patchTableArrayCount uint64_t gotClientExportsArrayAddr; // (unslid) address of array for patch exports for each GOT image uint64_t gotClientExportsArrayCount; // count of patch exports entries uint64_t gotLocationArrayAddr; // (unslid) address of array for patch locations for each GOT patch uint64_t gotLocationArrayCount; // count of patch location entries }; struct dyld_cache_image_got_clients_v3 { uint32_t patchExportsStartIndex; // Points to dyld_cache_patchable_export_v3[] uint32_t patchExportsCount; }; struct dyld_cache_patchable_export_v3 { uint32_t imageExportIndex; // Points to dyld_cache_image_export_v2 uint32_t patchLocationsStartIndex; // Points to dyld_cache_patchable_location_v3[] uint32_t patchLocationsCount; }; struct dyld_cache_patchable_location_v3 { uint64_t cacheOffsetOfUse; // Offset from the cache header uint32_t high7 : 7, addend : 5, // 0..31 authenticated : 1, usesAddressDiversity : 1, key : 2, discriminator : 16; }; struct dyld_cache_patchable_location_v4 { uint64_t dylibOffsetOfUse; // Offset from the cache header union { struct { uint32_t authenticated : 1, // == 1 high7 : 7, isWeakImport : 1, addend : 5, // 0..31 usesAddressDiversity : 1, keyIsD : 1, // B keys are not permitted. So this is just whether the A key is I or D (0 => I, 1 => D) discriminator : 16; } auth; struct { uint32_t authenticated : 1, // == 0 high7 : 7, isWeakImport : 1, addend : 23; } regular; }; }; #endif /* _CACHE_PATCHING_H_ */