2 * Copyright (c) 2017 Apple Inc. All rights reserved.
4 * @APPLE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
21 * @APPLE_LICENSE_HEADER_END@
26 #ifndef __DYLD_ENTRY_VECTOR_H__
27 #define __DYLD_ENTRY_VECTOR_H__
29 #include <mach-o/loader.h>
30 #include <Availability.h>
34 struct dyld_all_image_infos
;
35 class DyldSharedCache
;
41 struct LibDyldEntryVector
43 enum { kCurrentVectorVersion
= 8 };
44 // The 32-bit caches steal bits to make rebase chains, so use 32-bits for the binary format version storage, but mask only some to actually use
45 enum { kBinaryFormatVersionMask
= 0x00FFFFFF };
47 uint32_t vectorVersion
; // should be kCurrentVectorVersion
48 uint32_t binaryFormatVersion
; // should be dyld3::closure::kFormatVersion
49 void (*setVars
)(const mach_header
* mainMH
, int argc
, const char* argv
[], const char* envp
[], const char* apple
[]);
50 void (*setHaltFunction
)(void (*func
)(const char* message
) __attribute__((noreturn
)) );
51 void (*setOldAllImageInfo
)(dyld_all_image_infos
*);
52 void (*setInitialImageList
)(const closure
::LaunchClosure
* closure
,
53 const DyldSharedCache
* dyldCacheLoadAddress
, const char* dyldCachePath
,
54 const Array
<LoadedImage
>& initialImages
, LoadedImage
& libSystem
);
55 void (*runInitialzersBottomUp
)(const mach_header
* topImageLoadAddress
);
58 void (*setChildForkFunction
)(void (*func
)());
60 void (*setLogFunction
)(void (*logFunction
)(const char* format
, va_list list
));
62 void (*setRestrictions
)(bool allowAtPaths
, bool allowEnvVars
, bool allowFallbackPaths
);
64 void (*setNotifyMonitoringDyldMain
)(void (*notifyMonitoringDyldMain
)());
65 void (*setNotifyMonitoringDyld
)(void (*notifyMonitoringDyldMain
)(bool unloading
, unsigned imageCount
,
66 const struct mach_header
* loadAddresses
[],
67 const char* imagePaths
[]));
69 void (*setHasCacheOverrides
)(bool someCacheImageOverriden
);
72 void (*setProgramVars
)(struct ProgramVars
* progVars
);
75 extern const LibDyldEntryVector entryVectorForDyld
;
77 extern int compatFuncLookup(const char* name
, void** address
) __API_AVAILABLE(ios(13.0));
82 #endif // __DYLD_ENTRY_VECTOR_H__