[2949] | 1 | /* $Id $ */
|
---|
| 2 | /** @file
|
---|
| 3 | * Mach-0 structures, types and defines.
|
---|
| 4 | */
|
---|
| 5 |
|
---|
| 6 | #ifndef __kLdrModMachO_h__
|
---|
| 7 | #define __kLdrModMachO_h__
|
---|
| 8 |
|
---|
| 9 |
|
---|
| 10 | #ifndef IMAGE_FAT_SIGNATURE
|
---|
| 11 | /** The FAT signature (universal binaries). */
|
---|
| 12 | # define IMAGE_FAT_SIGNATURE UINT32_C(0xcafebabe)
|
---|
| 13 | #endif
|
---|
| 14 | #ifndef IMAGE_FAT_SIGNATURE_OE
|
---|
| 15 | /** The FAT signature (universal binaries), other endian. */
|
---|
| 16 | # define IMAGE_FAT_SIGNATURE_OE UINT32_C(0xbebafeca)
|
---|
| 17 | #endif
|
---|
| 18 |
|
---|
| 19 | /**
|
---|
| 20 | * The fat header found at the start of universal binaries.
|
---|
| 21 | * It is followed by \a nfat_arch numbers of \a fat_arch structures.
|
---|
| 22 | */
|
---|
| 23 | typedef struct fat_header
|
---|
| 24 | {
|
---|
| 25 | uint32_t magic;
|
---|
| 26 | uint32_t nfat_arch;
|
---|
[2950] | 27 | } fat_header_t;
|
---|
[2949] | 28 |
|
---|
| 29 | /**
|
---|
| 30 | * Description of fat file item.
|
---|
| 31 | */
|
---|
| 32 | struct fat_arch
|
---|
| 33 | {
|
---|
| 34 | int32_t cputype;
|
---|
| 35 | int32_t cpusubtype;
|
---|
| 36 | uint32_t offset;
|
---|
| 37 | uint32_t size;
|
---|
| 38 | uint32_t align; /**< Power of 2. */
|
---|
[2950] | 39 | } fat_arch_t;
|
---|
[2949] | 40 |
|
---|
| 41 |
|
---|
| 42 |
|
---|
[2952] | 43 | #ifndef IMAGE_MACHO32_SIGNATURE
|
---|
[2949] | 44 | /** The 32-bit Mach-O signature. */
|
---|
| 45 | # define IMAGE_MACHO32_SIGNATURE UINT32_C(0xfeedface)
|
---|
| 46 | #endif
|
---|
[2952] | 47 | #ifndef IMAGE_MACHO32_SIGNATURE_OE
|
---|
[2949] | 48 | /** The 32-bit Mach-O signature, other endian. */
|
---|
| 49 | # define IMAGE_MACHO32_SIGNATURE_OE UINT32_C(0xcefaedfe)
|
---|
| 50 | #endif
|
---|
| 51 | #define MH_MAGIC IMAGE_MACHO32_SIGNATURE
|
---|
| 52 | #define MH_CIGAM IMAGE_MACHO32_SIGNATURE_OE
|
---|
| 53 |
|
---|
| 54 | /**
|
---|
| 55 | * 32-bit Mach-O header.
|
---|
| 56 | * This is followed by \a ncmds number of load commands.
|
---|
| 57 | * @see mach_header_64
|
---|
| 58 | */
|
---|
| 59 | typedef struct mach_header_32
|
---|
| 60 | {
|
---|
| 61 | uint32_t magic;
|
---|
| 62 | int32_t cputype;
|
---|
| 63 | int32_t cpusubtype;
|
---|
| 64 | uint32_t filetype;
|
---|
| 65 | uint32_t ncmds;
|
---|
| 66 | uint32_t sizeofcmds;
|
---|
| 67 | uint32_t flags;
|
---|
[2950] | 68 | } mach_header_32_t;
|
---|
[2949] | 69 |
|
---|
| 70 |
|
---|
| 71 |
|
---|
[2952] | 72 | #ifndef IMAGE_MACHO64_SIGNATURE
|
---|
[2949] | 73 | /** The 64-bit Mach-O signature. */
|
---|
| 74 | # define IMAGE_MACHO64_SIGNATURE UINT32_C(0xfeedfacf)
|
---|
| 75 | #endif
|
---|
[2952] | 76 | #ifndef IMAGE_MACHO64_SIGNATURE_OE
|
---|
[2949] | 77 | /** The 64-bit Mach-O signature, other endian. */
|
---|
| 78 | # define IMAGE_MACHO64_SIGNATURE_OE UINT32_C(0xfefaedfe)
|
---|
| 79 | #endif
|
---|
| 80 | #define MH_MAGIC_64 IMAGE_MACHO64_SIGNATURE
|
---|
| 81 | #define MH_CIGAM_64 IMAGE_MACHO64_SIGNATURE_OE
|
---|
| 82 |
|
---|
| 83 | /**
|
---|
| 84 | * 64-bit Mach-O header.
|
---|
| 85 | * This is followed by \a ncmds number of load commands.
|
---|
| 86 | * @see mach_header
|
---|
| 87 | */
|
---|
| 88 | typedef struct mach_header_64
|
---|
| 89 | {
|
---|
| 90 | uint32_t magic;
|
---|
| 91 | int32_t cputype;
|
---|
| 92 | int32_t cpusubtype;
|
---|
| 93 | uint32_t filetype;
|
---|
| 94 | uint32_t ncmds;
|
---|
| 95 | uint32_t sizeofcmds;
|
---|
| 96 | uint32_t flags;
|
---|
| 97 | uint32_t reserved; /**< (for proper struct and command alignment I guess) */
|
---|
[2950] | 98 | } mach_header_64_t;
|
---|
[2949] | 99 |
|
---|
| 100 |
|
---|
[2950] | 101 | /** @name File types (mach_header_64::filetype, mach_header_32::filetype)
|
---|
| 102 | * @{
|
---|
| 103 | */
|
---|
| 104 | #define MH_OBJECT UINT32_C(1) /**< Object (relocatable). */
|
---|
| 105 | #define MH_EXECUTE UINT32_C(2) /**< Executable (demand paged). */
|
---|
| 106 | #define MH_FVMLIB UINT32_C(3) /**< Fixed VM shared library. */
|
---|
| 107 | #define MH_CORE UINT32_C(4) /**< Core file. */
|
---|
| 108 | #define MH_PRELOAD UINT32_C(5) /**< Preloaded executable. */
|
---|
| 109 | #define MH_DYLIB UINT32_C(6) /**< Dynamically bound shared library. */
|
---|
| 110 | #define MH_DYLINKER UINT32_C(7) /**< Dynamic linker. */
|
---|
| 111 | #define MH_BUNDLE UINT32_C(8) /**< Dymamically bound bundle. */
|
---|
| 112 | #define MH_DYLIB_STUB UINT32_C(9) /**< Shared library stub for static linking. */
|
---|
| 113 | #define MH_DSYM UINT32_C(10)/**< Debug symbols. */
|
---|
[2949] | 114 |
|
---|
[2950] | 115 | /** @} */
|
---|
| 116 |
|
---|
| 117 |
|
---|
| 118 | /** @name Mach-O Header flags (mach_header_64::flags, mach_header_32::flags)
|
---|
[2949] | 119 | * @{
|
---|
| 120 | */
|
---|
[2950] | 121 | #define MH_NOUNDEFS UINT32_C(0x00000001) /**< No undefined symbols. */
|
---|
| 122 | #define MH_INCRLINK UINT32_C(0x00000002) /**< Partial increment link output. */
|
---|
| 123 | #define MH_DYLDLINK UINT32_C(0x00000004) /**< Food for the dynamic linker, not for ld. */
|
---|
| 124 | #define MH_BINDATLOAD UINT32_C(0x00000008) /**< Bind all undefined symbols at load time. */
|
---|
| 125 | #define MH_PREBOUND UINT32_C(0x00000010) /**< Contains prebound undefined symbols. */
|
---|
| 126 | #define MH_SPLIT_SEGS UINT32_C(0x00000020) /**< Read-only and read-write segments are split. */
|
---|
| 127 | #define MH_LAZY_INIT UINT32_C(0x00000040) /**< Obsolete flag for doing lazy init when data is written. */
|
---|
| 128 | #define MH_TWOLEVEL UINT32_C(0x00000080) /**< Uses two-level name space bindings. */
|
---|
| 129 | #define MH_FORCE_FLAT UINT32_C(0x00000100) /**< Task: The executable forces all images to use flat name space bindings. */
|
---|
| 130 | #define MH_NOMULTIDEFS UINT32_C(0x00000200) /**< No multiple symbol definitions, safe to use two-level namespace hints. */
|
---|
| 131 | #define MH_NOFIXPREBINDING UINT32_C(0x00000400) /**< The dynamic linker should not notify the prebinding agent about this executable. */
|
---|
| 132 | #define MH_PREBINDABLE UINT32_C(0x00000800) /**< Not prebound, but it can be. Invalid if MH_PREBOUND is set. */
|
---|
| 133 | #define MH_ALLMODSBOUND UINT32_C(0x00001000) /**< Binds to all two-level namespace modules of preqs. Requires MH_PREBINDABLE and MH_TWOLEVEL to be set. */
|
---|
| 134 | #define MH_SUBSECTIONS_VIA_SYMBOLS UINT32_C(0x00002000) /**< Safe to divide sections into sub-sections via symbols for dead code stripping. */
|
---|
| 135 | #define MH_CANONICAL UINT32_C(0x00004000) /**< Canonicalized via unprebind. */
|
---|
| 136 | #define MH_WEAK_DEFINES UINT32_C(0x00008000) /**< The (finally) linked image has weak symbols. */
|
---|
| 137 | #define MH_BINDS_TO_WEAK UINT32_C(0x00010000) /**< The (finally) linked image uses weak symbols. */
|
---|
| 138 | #define MH_ALLOW_STACK_EXECUTION UINT32_C(0x00020000) /**< Task: allow stack execution. (MH_EXECUTE only) */
|
---|
[2952] | 139 | #define MH_VALID_FLAGS UINT32_C(0x0003ffff) /**< Mask containing the defined flags. */
|
---|
[2950] | 140 | /** @} */
|
---|
| 141 |
|
---|
| 142 |
|
---|
| 143 | /** @name CPU types / bits (mach_header_64::cputype, mach_header_32::cputype, fat_arch::cputype)
|
---|
| 144 | * @{
|
---|
| 145 | */
|
---|
[2949] | 146 | #define CPU_ARCH_MASK INT32_C(0xff000000)
|
---|
| 147 | #define CPU_ARCH_ABI64 INT32_C(0x01000000)
|
---|
| 148 | #define CPU_TYPE_ANY INT32_C(-1)
|
---|
| 149 | #define CPU_TYPE_VAX INT32_C(1)
|
---|
| 150 | #define CPU_TYPE_MC680x0 INT32_C(6)
|
---|
| 151 | #define CPU_TYPE_X86 INT32_C(7)
|
---|
| 152 | #define CPU_TYPE_I386 CPU_TYPE_X86
|
---|
| 153 | #define CPU_TYPE_X86_64 (CPU_TYPE_X86 | CPU_ARCH_ABI64)
|
---|
| 154 | #define CPU_TYPE_MC98000 INT32_C(10)
|
---|
| 155 | #define CPU_TYPE_HPPA INT32_C(11)
|
---|
| 156 | #define CPU_TYPE_MC88000 INT32_C(13)
|
---|
| 157 | #define CPU_TYPE_SPARC INT32_C(14)
|
---|
| 158 | #define CPU_TYPE_I860 INT32_C(15)
|
---|
| 159 | #define CPU_TYPE_POWERPC INT32_C(18)
|
---|
| 160 | #define CPU_TYPE_POWERPC64 (CPU_TYPE_POWERPC | CPU_ARCH_ABI64)
|
---|
| 161 | /** @} */
|
---|
| 162 |
|
---|
[2950] | 163 |
|
---|
| 164 | /** @name CPU subtypes (mach_header_64::cpusubtype, mach_header_32::cpusubtype, fat_arch::cpusubtype)
|
---|
[2949] | 165 | * @{ */
|
---|
| 166 | #define CPU_SUBTYPE_MULTIPLE INT32_C(-1)
|
---|
| 167 | #define CPU_SUBTYPE_LITTLE_ENDIAN INT32_C(0) /**< figure this one out. */
|
---|
| 168 | #define CPU_SUBTYPE_BIG_ENDIAN INT32_C(1) /**< ditto */
|
---|
| 169 |
|
---|
| 170 | /* VAX */
|
---|
| 171 | #define CPU_SUBTYPE_VAX_ALL INT32_C(0)
|
---|
| 172 | #define CPU_SUBTYPE_VAX780 INT32_C(1)
|
---|
| 173 | #define CPU_SUBTYPE_VAX785 INT32_C(2)
|
---|
| 174 | #define CPU_SUBTYPE_VAX750 INT32_C(3)
|
---|
| 175 | #define CPU_SUBTYPE_VAX730 INT32_C(4)
|
---|
| 176 | #define CPU_SUBTYPE_UVAXI INT32_C(5)
|
---|
| 177 | #define CPU_SUBTYPE_UVAXII INT32_C(6)
|
---|
| 178 | #define CPU_SUBTYPE_VAX8200 INT32_C(7)
|
---|
| 179 | #define CPU_SUBTYPE_VAX8500 INT32_C(8)
|
---|
| 180 | #define CPU_SUBTYPE_VAX8600 INT32_C(9)
|
---|
| 181 | #define CPU_SUBTYPE_VAX8650 INT32_C(10)
|
---|
| 182 | #define CPU_SUBTYPE_VAX8800 INT32_C(11)
|
---|
| 183 | #define CPU_SUBTYPE_UVAXIII INT32_C(12)
|
---|
| 184 |
|
---|
| 185 | /* MC680xx */
|
---|
| 186 | #define CPU_SUBTYPE_MC680x0_ALL INT32_C(1)
|
---|
| 187 | #define CPU_SUBTYPE_MC68030 INT32_C(1)
|
---|
| 188 | #define CPU_SUBTYPE_MC68040 INT32_C(2)
|
---|
| 189 | #define CPU_SUBTYPE_MC68030_ONLY INT32_C(3)
|
---|
| 190 |
|
---|
| 191 | /* I386 */
|
---|
| 192 | #define CPU_SUBTYPE_INTEL(fam, model) ( (int32_t)(((model) << 4) | (fam)) )
|
---|
| 193 | #define CPU_SUBTYPE_INTEL_FAMILY(subtype) ( (subtype) & 0xf )
|
---|
| 194 | #define CPU_SUBTYPE_INTEL_MODEL(subtype) ( (subtype) >> 4 )
|
---|
| 195 | #define CPU_SUBTYPE_INTEL_FAMILY_MAX 0xf
|
---|
| 196 | #define CPU_SUBTYPE_INTEL_MODEL_ALL 0
|
---|
| 197 |
|
---|
| 198 | #define CPU_SUBTYPE_I386_ALL CPU_SUBTYPE_INTEL(3, 0)
|
---|
| 199 | #define CPU_SUBTYPE_386 CPU_SUBTYPE_INTEL(3, 0)
|
---|
| 200 | #define CPU_SUBTYPE_486 CPU_SUBTYPE_INTEL(4, 0)
|
---|
| 201 | #define CPU_SUBTYPE_486SX CPU_SUBTYPE_INTEL(4, 8)
|
---|
| 202 | #define CPU_SUBTYPE_586 CPU_SUBTYPE_INTEL(5, 0)
|
---|
| 203 | #define CPU_SUBTYPE_PENT CPU_SUBTYPE_INTEL(5, 0)
|
---|
| 204 | #define CPU_SUBTYPE_PENTPRO CPU_SUBTYPE_INTEL(6, 1)
|
---|
| 205 | #define CPU_SUBTYPE_PENTII_M3 CPU_SUBTYPE_INTEL(6, 3)
|
---|
| 206 | #define CPU_SUBTYPE_PENTII_M5 CPU_SUBTYPE_INTEL(6, 5)
|
---|
| 207 | #define CPU_SUBTYPE_CELERON CPU_SUBTYPE_INTEL(7, 6)
|
---|
| 208 | #define CPU_SUBTYPE_CELERON_MOBILE CPU_SUBTYPE_INTEL(7, 7)
|
---|
| 209 | #define CPU_SUBTYPE_PENTIUM_3 CPU_SUBTYPE_INTEL(8, 0)
|
---|
| 210 | #define CPU_SUBTYPE_PENTIUM_3_M CPU_SUBTYPE_INTEL(8, 1)
|
---|
| 211 | #define CPU_SUBTYPE_PENTIUM_3_XEON CPU_SUBTYPE_INTEL(8, 2)
|
---|
| 212 | #define CPU_SUBTYPE_PENTIUM_M CPU_SUBTYPE_INTEL(9, 0)
|
---|
| 213 | #define CPU_SUBTYPE_PENTIUM_4 CPU_SUBTYPE_INTEL(10, 0)
|
---|
| 214 | #define CPU_SUBTYPE_PENTIUM_4_M CPU_SUBTYPE_INTEL(10, 1)
|
---|
| 215 | #define CPU_SUBTYPE_ITANIUM CPU_SUBTYPE_INTEL(11, 0)
|
---|
| 216 | #define CPU_SUBTYPE_ITANIUM_2 CPU_SUBTYPE_INTEL(11, 1)
|
---|
| 217 | #define CPU_SUBTYPE_XEON CPU_SUBTYPE_INTEL(12, 0)
|
---|
| 218 | #define CPU_SUBTYPE_XEON_MP CPU_SUBTYPE_INTEL(12, 1)
|
---|
| 219 |
|
---|
| 220 | /* X86 */
|
---|
| 221 | #define CPU_SUBTYPE_X86_ALL INT32_C(3) /* CPU_SUBTYPE_I386_ALL */
|
---|
| 222 | #define CPU_SUBTYPE_X86_64_ALL INT32_C(3) /* CPU_SUBTYPE_I386_ALL */
|
---|
| 223 | #define CPU_SUBTYPE_X86_ARCH1 INT32_C(4) /* CPU_SUBTYPE_I486_ALL */
|
---|
| 224 |
|
---|
| 225 | /* MIPS */
|
---|
| 226 | #define CPU_SUBTYPE_MIPS_ALL INT32_C(0)
|
---|
| 227 | #define CPU_SUBTYPE_MIPS_R2300 INT32_C(1)
|
---|
| 228 | #define CPU_SUBTYPE_MIPS_R2600 INT32_C(2)
|
---|
| 229 | #define CPU_SUBTYPE_MIPS_R2800 INT32_C(3)
|
---|
| 230 | #define CPU_SUBTYPE_MIPS_R2000a INT32_C(4)
|
---|
| 231 | #define CPU_SUBTYPE_MIPS_R2000 INT32_C(5)
|
---|
| 232 | #define CPU_SUBTYPE_MIPS_R3000a INT32_C(6)
|
---|
| 233 | #define CPU_SUBTYPE_MIPS_R3000 INT32_C(7)
|
---|
| 234 |
|
---|
| 235 | /* MC98000 (PowerPC) */
|
---|
| 236 | #define CPU_SUBTYPE_MC98000_ALL INT32_C(0)
|
---|
| 237 | #define CPU_SUBTYPE_MC98601 INT32_C(1)
|
---|
| 238 |
|
---|
| 239 | /* HP-PA */
|
---|
| 240 | #define CPU_SUBTYPE_HPPA_ALL INT32_C(0)
|
---|
| 241 | #define CPU_SUBTYPE_HPPA_7100 INT32_C(0)
|
---|
| 242 | #define CPU_SUBTYPE_HPPA_7100LC INT32_C(1)
|
---|
| 243 |
|
---|
| 244 | /* MC88000 */
|
---|
| 245 | #define CPU_SUBTYPE_MC88000_ALL INT32_C(0)
|
---|
| 246 | #define CPU_SUBTYPE_MC88100 INT32_C(1)
|
---|
| 247 | #define CPU_SUBTYPE_MC88110 INT32_C(2)
|
---|
| 248 |
|
---|
| 249 | /* SPARC */
|
---|
| 250 | #define CPU_SUBTYPE_SPARC_ALL INT32_C(0)
|
---|
| 251 |
|
---|
| 252 | /* I860 */
|
---|
| 253 | #define CPU_SUBTYPE_I860_ALL INT32_C(0)
|
---|
| 254 | #define CPU_SUBTYPE_I860_860 INT32_C(1)
|
---|
| 255 |
|
---|
| 256 | /* PowerPC */
|
---|
| 257 | #define CPU_SUBTYPE_POWERPC_ALL INT32_C(0)
|
---|
| 258 | #define CPU_SUBTYPE_POWERPC_601 INT32_C(1)
|
---|
| 259 | #define CPU_SUBTYPE_POWERPC_602 INT32_C(2)
|
---|
| 260 | #define CPU_SUBTYPE_POWERPC_603 INT32_C(3)
|
---|
| 261 | #define CPU_SUBTYPE_POWERPC_603e INT32_C(4)
|
---|
| 262 | #define CPU_SUBTYPE_POWERPC_603ev INT32_C(5)
|
---|
| 263 | #define CPU_SUBTYPE_POWERPC_604 INT32_C(6)
|
---|
| 264 | #define CPU_SUBTYPE_POWERPC_604e INT32_C(7)
|
---|
| 265 | #define CPU_SUBTYPE_POWERPC_620 INT32_C(8)
|
---|
| 266 | #define CPU_SUBTYPE_POWERPC_750 INT32_C(9)
|
---|
| 267 | #define CPU_SUBTYPE_POWERPC_7400 INT32_C(10)
|
---|
| 268 | #define CPU_SUBTYPE_POWERPC_7450 INT32_C(11)
|
---|
| 269 | #define CPU_SUBTYPE_POWERPC_Max INT32_C(10)
|
---|
| 270 | #define CPU_SUBTYPE_POWERPC_SCVger INT32_C(11)
|
---|
| 271 | #define CPU_SUBTYPE_POWERPC_970 INT32_C(100)
|
---|
| 272 |
|
---|
| 273 | /** @} */
|
---|
| 274 |
|
---|
[2950] | 275 |
|
---|
| 276 | /**
|
---|
| 277 | * The load command common core structure.
|
---|
| 278 | *
|
---|
| 279 | * After the Mach-O header follows an array of variable sized
|
---|
| 280 | * load command which all has this header in common.
|
---|
| 281 | */
|
---|
| 282 | typedef struct load_command
|
---|
| 283 | {
|
---|
| 284 | uint32_t cmd; /**< The load command id. */
|
---|
[2954] | 285 | uint32_t cmdsize; /**< The size of the command (including this header). */
|
---|
[2950] | 286 | } load_command_t;
|
---|
| 287 |
|
---|
| 288 | /** @name Load Command IDs (load_command::cmd)
|
---|
| 289 | * @{
|
---|
| 290 | */
|
---|
| 291 | /** Flag that when set requires the dynamic linker to fail if it doesn't
|
---|
| 292 | * grok the command. The dynamic linker will otherwise ignore commands it
|
---|
| 293 | * doesn't understand. Introduced with Mac OS X 10.1. */
|
---|
| 294 | #define LC_REQ_DYLD UINT32_C(0x80000000)
|
---|
| 295 |
|
---|
| 296 | #define LC_SEGMENT_32 UINT32_C(0x01) /**< Segment to be mapped (32-bit). See segment_command_32. */
|
---|
| 297 | #define LC_SYMTAB UINT32_C(0x02) /**< 'stab' symbol table. See symtab_command. */
|
---|
| 298 | #define LC_SYMSEG UINT32_C(0x03) /**< Obsoleted gdb symbol table. */
|
---|
| 299 | #define LC_THREAD UINT32_C(0x04) /**< Thread. See thread_command. */
|
---|
| 300 | #define LC_UNIXTHREAD UINT32_C(0x05) /**< Unix thread (includes stack and stuff). See thread_command. */
|
---|
| 301 | #define LC_LOADFVMLIB UINT32_C(0x06) /**< Load a specified fixed VM shared library (obsolete?). See fvmlib_command. */
|
---|
| 302 | #define LC_IDFVMLIB UINT32_C(0x07) /**< Fixed VM shared library id (obsolete?). See fvmlib_command. */
|
---|
| 303 | #define LC_IDENT UINT32_C(0x08) /**< Identification info (obsolete). See ident_command. */
|
---|
| 304 | #define LC_FVMFILE UINT32_C(0x09) /**< Fixed VM file inclusion (internal). See fvmfile_command. */
|
---|
| 305 | #define LC_PREPAGE UINT32_C(0x0a) /**< Prepage command (internal). See ?? */
|
---|
| 306 | #define LC_DYSYMTAB UINT32_C(0x0b) /**< Symbol table for dynamic linking. See dysymtab_command. */
|
---|
| 307 | #define LC_LOAD_DYLIB UINT32_C(0x0c) /**< Load a dynamically linked shared library. See dylib_command. */
|
---|
| 308 | #define LC_ID_DYLIB UINT32_C(0x0d) /**< Dynamically linked share library ident. See dylib_command. */
|
---|
| 309 | #define LC_LOAD_DYLINKER UINT32_C(0x0e) /**< Load a dynamical link editor. See dylinker_command. */
|
---|
[2954] | 310 | #define LC_ID_DYLINKER UINT32_C(0x0f) /**< Dynamic link editor ident. See dylinker_command. */
|
---|
[2950] | 311 | #define LC_PREBOUND_DYLIB UINT32_C(0x10) /**< Prebound modules for dynamically linking of a shared lib. See prebound_dylib_command. */
|
---|
| 312 | #define LC_ROUTINES UINT32_C(0x11) /**< Image routines. See routines_command_32. */
|
---|
| 313 | #define LC_SUB_FRAMEWORK UINT32_C(0x12) /**< Sub framework. See sub_framework_command. */
|
---|
| 314 | #define LC_SUB_UMBRELLA UINT32_C(0x13) /**< Sub umbrella. See sub_umbrella_command. */
|
---|
[2951] | 315 | #define LC_SUB_CLIENT UINT32_C(0x14) /**< Sub client. See sub_client_command. */
|
---|
[2950] | 316 | #define LC_SUB_LIBRARY UINT32_C(0x15) /**< Sub library. See sub_library_command. */
|
---|
| 317 | #define LC_TWOLEVEL_HINTS UINT32_C(0x16) /**< Two-level namespace lookup hints. See twolevel_hints_command. */
|
---|
| 318 | #define LC_PREBIND_CKSUM UINT32_C(0x17) /**< Prebind checksum. See prebind_cksum_command. */
|
---|
| 319 | #define LC_LOAD_WEAK_DYLIB (UINT32_C(0x18) | LC_REQ_DYLD) /**< Dylib that can be missing, all symbols weak. See dylib_command. */
|
---|
| 320 | #define LC_SEGMENT_64 UINT32_C(0x19) /**< segment to be mapped (64-bit). See segment_command_32. */
|
---|
| 321 | #define LC_ROUTINES_64 UINT32_C(0x1a) /**< Image routines (64-bit). See routines_command_32. */
|
---|
| 322 | #define LC_UUID UINT32_C(0x1b) /**< The UUID of the object module. See uuid_command. */
|
---|
| 323 | /** @} */
|
---|
| 324 |
|
---|
[2951] | 325 |
|
---|
| 326 | /**
|
---|
| 327 | * Load Command String.
|
---|
| 328 | */
|
---|
| 329 | typedef struct lc_str
|
---|
| 330 | {
|
---|
| 331 | /** Offset of the string relative to the load_command structure.
|
---|
| 332 | * The string is zero-terminated. the size of the load command
|
---|
| 333 | * is zero padded up to a multiple of 4 bytes. */
|
---|
| 334 | uint32_t offset;
|
---|
| 335 | } lc_str_t;
|
---|
| 336 |
|
---|
| 337 |
|
---|
| 338 | /**
|
---|
| 339 | * Segment load command (32-bit).
|
---|
| 340 | */
|
---|
| 341 | typedef struct segment_command_32
|
---|
| 342 | {
|
---|
| 343 | uint32_t cmd; /**< LC_SEGMENT */
|
---|
| 344 | uint32_t cmdsize; /**< sizeof(self) + sections. */
|
---|
| 345 | char segname[16]; /**< The segment name. */
|
---|
| 346 | uint32_t vmaddr; /**< Memory address of this segment. */
|
---|
| 347 | uint32_t vmsize; /**< Size of this segment. */
|
---|
| 348 | uint32_t fileoff; /**< The file location of the segment. */
|
---|
| 349 | uint32_t filesize; /**< The file size of the segment. */
|
---|
| 350 | uint32_t maxprot; /**< Maximum VM protection. */
|
---|
| 351 | uint32_t initprot; /**< Initial VM protection. */
|
---|
| 352 | uint32_t nsects; /**< Number of section desciptors following this structure. */
|
---|
| 353 | uint32_t flags; /**< Flags (SG_*). */
|
---|
| 354 | } segment_command_32_t;
|
---|
| 355 |
|
---|
| 356 |
|
---|
| 357 | /**
|
---|
| 358 | * Segment load command (64-bit).
|
---|
| 359 | * Same as segment_command_32 except 4 members has been blown up to 64-bit.
|
---|
| 360 | */
|
---|
| 361 | typedef struct segment_command_64
|
---|
| 362 | {
|
---|
| 363 | uint32_t cmd; /**< LC_SEGMENT */
|
---|
| 364 | uint32_t cmdsize; /**< sizeof(self) + sections. */
|
---|
| 365 | char segname[16]; /**< The segment name. */
|
---|
| 366 | uint64_t vmaddr; /**< Memory address of this segment. */
|
---|
| 367 | uint64_t vmsize; /**< Size of this segment. */
|
---|
| 368 | uint64_t fileoff; /**< The file location of the segment. */
|
---|
| 369 | uint64_t filesize; /**< The file size of the segment. */
|
---|
| 370 | uint32_t maxprot; /**< Maximum VM protection. */
|
---|
| 371 | uint32_t initprot; /**< Initial VM protection. */
|
---|
| 372 | uint32_t nsects; /**< Number of section desciptors following this structure. */
|
---|
| 373 | uint32_t flags; /**< Flags (SG_*). */
|
---|
| 374 | } segment_command_64_t;
|
---|
| 375 |
|
---|
| 376 | /** @name Segment flags (segment_command_64::flags, segment_command_32::flags)
|
---|
| 377 | * @{ */
|
---|
| 378 | /** Map the file bits in the top end of the memory area for the segment
|
---|
| 379 | * instead of the low end. Intended for stacks in core dumps.
|
---|
| 380 | * The part of the segment memory not covered by file bits will be zeroed. */
|
---|
| 381 | #define SG_HIGHVM UINT32_C(0x00000001)
|
---|
| 382 | /** This segment is the virtual memory allocated by a fixed VM library.
|
---|
| 383 | * (Used for overlap checking in the linker.) */
|
---|
| 384 | #define SG_FVMLIB UINT32_C(0x00000002)
|
---|
| 385 | /** No relocations for or symbols that's relocated to in this segment.
|
---|
| 386 | * The segment can therefore safely be replaced. */
|
---|
| 387 | #define SG_NORELOC UINT32_C(0x00000004)
|
---|
| 388 | /** The segment is protected.
|
---|
| 389 | * The first page isn't protected if it starts at file offset 0
|
---|
| 390 | * (so that the mach header and this load command can be easily mapped). */
|
---|
| 391 | #define SG_PROTECTED_VERSION_1 UINT32_C(0x00000008)
|
---|
| 392 | /** @} */
|
---|
| 393 |
|
---|
| 394 |
|
---|
| 395 | /**
|
---|
| 396 | * 32-bit section (part of a segment load command).
|
---|
| 397 | */
|
---|
| 398 | typedef struct section_32
|
---|
| 399 | {
|
---|
| 400 | char sectname[16]; /**< The section name. */
|
---|
| 401 | char segname[16]; /**< The name of the segment this section goes into. */
|
---|
| 402 | uint32_t addr; /**< The memory address of this section. */
|
---|
| 403 | uint32_t size; /**< The size of this section. */
|
---|
| 404 | uint32_t offset; /**< The file offset of this section. */
|
---|
| 405 | uint32_t align; /**< The section alignment (**2). */
|
---|
| 406 | uint32_t reloff; /**< The file offset of the relocations. */
|
---|
| 407 | uint32_t nreloc; /**< The number of relocations. */
|
---|
| 408 | uint32_t flags; /**< The section flags; section type and attribs */
|
---|
| 409 | uint32_t reserved1; /**< Reserved / offset / index. */
|
---|
| 410 | uint32_t reserved2; /**< Reserved / count / sizeof. */
|
---|
| 411 | } section_32_t;
|
---|
| 412 |
|
---|
| 413 | /**
|
---|
| 414 | * 64-bit section (part of a segment load command).
|
---|
| 415 | */
|
---|
| 416 | typedef struct section_64
|
---|
| 417 | {
|
---|
| 418 | char sectname[16]; /**< The section name. */
|
---|
| 419 | char segname[16]; /**< The name of the segment this section goes into. */
|
---|
| 420 | uint64_t addr; /**< The memory address of this section. */
|
---|
| 421 | uint64_t size; /**< The size of this section. */
|
---|
| 422 | uint32_t offset; /**< The file offset of this section. */
|
---|
| 423 | uint32_t align; /**< The section alignment (**2). */
|
---|
| 424 | uint32_t reloff; /**< The file offset of the relocations. */
|
---|
| 425 | uint32_t nreloc; /**< The number of relocations. */
|
---|
| 426 | uint32_t flags; /**< The section flags; section type and attribs */
|
---|
| 427 | uint32_t reserved1; /**< Reserved / offset / index. */
|
---|
| 428 | uint32_t reserved2; /**< Reserved / count / sizeof. */
|
---|
| 429 | uint32_t reserved3; /**< (Just) Reserved. */
|
---|
| 430 | } section_64_t;
|
---|
| 431 |
|
---|
| 432 | /** @name Section flags (section_64::flags, section_32::flags)
|
---|
| 433 | * @{
|
---|
| 434 | */
|
---|
| 435 | /** Section type mask. */
|
---|
| 436 | #define SECTION_TYPE UINT32_C(0x000000ff)
|
---|
| 437 | /** Regular section. */
|
---|
| 438 | #define S_REGULAR 0x0
|
---|
| 439 | /** Zero filled section. */
|
---|
| 440 | #define S_ZEROFILL 0x1
|
---|
| 441 | /** C literals. */
|
---|
| 442 | #define S_CSTRING_LITERALS 0x2
|
---|
| 443 | /** 4 byte literals. */
|
---|
| 444 | #define S_4BYTE_LITERALS 0x3
|
---|
| 445 | /** 8 byte literals. */
|
---|
| 446 | #define S_8BYTE_LITERALS 0x4
|
---|
| 447 | /** Pointer to literals. */
|
---|
| 448 | #define S_LITERAL_POINTERS 0x5
|
---|
| 449 | /** Section containing non-lazy symbol pointers.
|
---|
| 450 | * Reserved1 == start index in the indirect symbol table. */
|
---|
| 451 | #define S_NON_LAZY_SYMBOL_POINTERS 0x6
|
---|
| 452 | /** Section containing lazy symbol pointers.
|
---|
| 453 | * Reserved1 == start index in the indirect symbol table. */
|
---|
| 454 | #define S_LAZY_SYMBOL_POINTERS 0x7
|
---|
| 455 | /** Section containing symbol stubs.
|
---|
| 456 | * Reserved2 == stub size. */
|
---|
| 457 | #define S_SYMBOL_STUBS 0x8
|
---|
| 458 | /** Section containing function pointers for module initialization. . */
|
---|
| 459 | #define S_MOD_INIT_FUNC_POINTERS 0x9
|
---|
| 460 | /** Section containing function pointers for module termination. . */
|
---|
| 461 | #define S_MOD_TERM_FUNC_POINTERS 0xa
|
---|
| 462 | /** Section containing symbols that are to be coalesced. */
|
---|
| 463 | #define S_COALESCED 0xb
|
---|
| 464 | /** Zero filled section that be larger than 4GB. */
|
---|
| 465 | #define S_GB_ZEROFILL 0xc
|
---|
| 466 | /** Section containing pairs of function pointers for interposing. */
|
---|
| 467 | #define S_INTERPOSING 0xd
|
---|
| 468 | /** 16 byte literals. */
|
---|
| 469 | #define S_16BYTE_LITERALS 0xe
|
---|
| 470 |
|
---|
| 471 | /** Section attribute mask. */
|
---|
| 472 | #define SECTION_ATTRIBUTES UINT32_C(0xffffff00)
|
---|
| 473 |
|
---|
| 474 | /** User settable attribute mask. */
|
---|
| 475 | #define SECTION_ATTRIBUTES_USR UINT32_C(0xff000000)
|
---|
| 476 | /** Pure instruction (code). */
|
---|
| 477 | #define S_ATTR_PURE_INSTRUCTIONS UINT32_C(0x80000000)
|
---|
| 478 | /** ranlib, ignore my symbols... */
|
---|
| 479 | #define S_ATTR_NO_TOC UINT32_C(0x40000000)
|
---|
| 480 | /** May strip static symbols when linking int a MH_DYLDLINK file. */
|
---|
| 481 | #define S_ATTR_STRIP_STATIC_SYMS UINT32_C(0x20000000)
|
---|
| 482 | /** No dead stripping. */
|
---|
| 483 | #define S_ATTR_NO_DEAD_STRIP UINT32_C(0x10000000)
|
---|
| 484 | /** Live support. */
|
---|
| 485 | #define S_ATTR_LIVE_SUPPORT UINT32_C(0x08000000)
|
---|
| 486 | /** Contains self modifying code (generally i386 code stub for dyld). */
|
---|
| 487 | #define S_ATTR_SELF_MODIFYING_CODE UINT32_C(0x04000000)
|
---|
| 488 | /** Debug info (DWARF usually). */
|
---|
| 489 | #define S_ATTR_DEBUG UINT32_C(0x02000000)
|
---|
| 490 |
|
---|
| 491 | /** System settable attribute mask. */
|
---|
| 492 | #define SECTION_ATTRIBUTES_SYS UINT32_C(0x00ffff00)
|
---|
| 493 | /** Contains some instructions (code). */
|
---|
| 494 | #define S_ATTR_SOME_INSTRUCTIONS UINT32_C(0x00000400)
|
---|
| 495 | /** Has external relocations. */
|
---|
| 496 | #define S_ATTR_EXT_RELOC UINT32_C(0x00000200)
|
---|
| 497 | /** Has internal (local) relocations. */
|
---|
| 498 | #define S_ATTR_LOC_RELOC UINT32_C(0x00000100)
|
---|
| 499 | /** @} */
|
---|
| 500 |
|
---|
| 501 | /** @name Known Segment and Section Names.
|
---|
| 502 | * Some of these implies special linker behaviour.
|
---|
| 503 | * @{
|
---|
| 504 | */
|
---|
| 505 | /** Page zero - not-present page for catching invalid access. (MH_EXECUTE typically) */
|
---|
| 506 | #define SEG_PAGEZERO "__PAGEZERO"
|
---|
| 507 | /** Traditional UNIX text segment.
|
---|
| 508 | * Defaults to R-X. */
|
---|
| 509 | #define SEG_TEXT "__TEXT"
|
---|
| 510 | /** The text part of SEG_TEXT. */
|
---|
| 511 | #define SECT_TEXT "__text"
|
---|
| 512 | /** The fvmlib initialization. */
|
---|
| 513 | #define SECT_FVMLIB_INIT0 "__fvmlib_init0"
|
---|
| 514 | /** The section following the fvmlib initialization. */
|
---|
| 515 | #define SECT_FVMLIB_INIT1 "__fvmlib_init1"
|
---|
| 516 | /** The traditional UNIX data segment. (DGROUP to DOS and OS/2 people.) */
|
---|
| 517 | #define SEG_DATA "__DATA"
|
---|
| 518 | /** The initialized data section. */
|
---|
| 519 | #define SECT_DATA "__data"
|
---|
| 520 | /** The uninitialized data section. */
|
---|
| 521 | #define SECT_BSS "__bss"
|
---|
| 522 | /** The common symbol section. */
|
---|
| 523 | #define SECT_COMMON "__common"
|
---|
| 524 | /** Objective-C runtime segment. */
|
---|
| 525 | #define SEG_OBJC "__OBJC"
|
---|
| 526 | /** Objective-C symbol table section. */
|
---|
| 527 | #define SECT_OBJC_SYMBOLS "__symbol_table"
|
---|
| 528 | /** Objective-C module information section. */
|
---|
| 529 | #define SECT_OBJC_MODULES "__module_info"
|
---|
| 530 | /** Objective-C string table section. */
|
---|
| 531 | #define SECT_OBJC_STRINGS "__selector_strs"
|
---|
| 532 | /** Objective-C string table section. */
|
---|
| 533 | #define SECT_OBJC_REFS "__selector_refs"
|
---|
| 534 | /** Icon segment. */
|
---|
| 535 | #define SEG_ICON "__ICON"
|
---|
| 536 | /** The icon headers. */
|
---|
| 537 | #define SECT_ICON_HEADER "__header"
|
---|
| 538 | /** The icons in the TIFF format. */
|
---|
| 539 | #define SECT_ICON_TIFF "__tiff"
|
---|
| 540 | /** ld -seglinkedit segment containing all the structs create and maintained
|
---|
| 541 | * by the linker. MH_EXECUTE and MH_FVMLIB only. */
|
---|
| 542 | #define SEG_LINKEDIT "__LINKEDIT"
|
---|
| 543 | /** The unix stack segment. */
|
---|
| 544 | #define SEG_UNIXSTACK "__UNIXSTACK"
|
---|
| 545 | /** The segment for the self modifying code for dynamic linking.
|
---|
| 546 | * Implies RWX permissions. */
|
---|
| 547 | #define SEG_IMPORT "__IMPORT"
|
---|
| 548 | /** @} */
|
---|
| 549 |
|
---|
| 550 |
|
---|
| 551 | /** @todo fvmlib */
|
---|
| 552 | /** @todo fvmlib_command (LC_IDFVMLIB or LC_LOADFVMLIB) */
|
---|
| 553 | /** @todo dylib */
|
---|
| 554 | /** @todo dylib_command (LC_ID_DYLIB, LC_LOAD_DYLIB, LC_LOAD_WEAK_DYLIB) */
|
---|
| 555 | /** @todo sub_framework_command (LC_SUB_FRAMEWORK) */
|
---|
| 556 | /** @todo sub_client_command (LC_SUB_CLIENT) */
|
---|
| 557 | /** @todo sub_umbrella_command (LC_SUB_UMBRELLA) */
|
---|
| 558 | /** @todo sub_library_command (LC_SUB_LIBRARY) */
|
---|
| 559 | /** @todo prebound_dylib_command (LC_PREBOUND_DYLIB) */
|
---|
| 560 | /** @todo dylinker_command (LC_ID_DYLINKER or LC_LOAD_DYLINKER) */
|
---|
| 561 |
|
---|
| 562 |
|
---|
| 563 | /**
|
---|
| 564 | * Thread command.
|
---|
| 565 | *
|
---|
| 566 | * State description of a thread that is to be created. The description
|
---|
| 567 | * is made up of a number of state structures preceded by a 32-bit flavor
|
---|
| 568 | * and 32-bit count field stating the kind of stat structure and it's size
|
---|
| 569 | * in uint32_t items respecitvly.
|
---|
| 570 | *
|
---|
| 571 | * LC_UNIXTHREAD differs from LC_THREAD in that it implies stack creation
|
---|
| 572 | * and that it's started with the typical main(int, char **, char **) frame
|
---|
| 573 | * on the stack.
|
---|
| 574 | */
|
---|
| 575 | typedef struct thread_command
|
---|
| 576 | {
|
---|
| 577 | uint32_t cmd; /**< LC_UNIXTHREAD or LC_THREAD. */
|
---|
| 578 | uint32_t cmdsize; /**< The size of the command (including this header). */
|
---|
| 579 | } thread_command_t;
|
---|
| 580 |
|
---|
| 581 |
|
---|
| 582 | /** @todo routines_command (LC_ROUTINES) */
|
---|
| 583 | /** @todo routines_command_64 (LC_ROUTINES_64) */
|
---|
| 584 |
|
---|
| 585 |
|
---|
| 586 | /**
|
---|
| 587 | * Symbol table command.
|
---|
| 588 | * Contains a.out style symbol table with some tricks.
|
---|
| 589 | */
|
---|
| 590 | typedef struct symtab_command
|
---|
| 591 | {
|
---|
| 592 | uint32_t cmd; /**< LC_SYMTAB */
|
---|
| 593 | uint32_t cmdsize; /** sizeof(symtab_command_t) */
|
---|
| 594 | uint32_t symoff; /** The file offset of the symbol table. */
|
---|
| 595 | uint32_t nsyms; /** The number of symbols in the symbol table. */
|
---|
| 596 | uint32_t stroff; /** The file offset of the string table. */
|
---|
| 597 | uint32_t strsize; /** The size of the string table. */
|
---|
| 598 | } symtab_command_t;
|
---|
| 599 |
|
---|
| 600 |
|
---|
| 601 | /** @todo dysymtab_command (LC_DYSYMTAB) */
|
---|
| 602 | /** @todo dylib_table_of_contents */
|
---|
| 603 | /** @todo dylib_module_32 */
|
---|
| 604 | /** @todo dylib_module_64 */
|
---|
| 605 | /** @todo dylib_reference */
|
---|
| 606 | /** @todo twolevel_hints_command (LC_TWOLEVEL_HINTS) */
|
---|
| 607 | /** @todo twolevel_hint */
|
---|
| 608 | /** @todo prebind_cksum_command (LC_PREBIND_CKSUM) */
|
---|
| 609 |
|
---|
| 610 |
|
---|
| 611 | /**
|
---|
| 612 | * UUID generated by ld.
|
---|
| 613 | */
|
---|
| 614 | typedef struct uuid_command
|
---|
| 615 | {
|
---|
| 616 | uint32_t cmd; /**< LC_UUID */
|
---|
| 617 | uint32_t cmdsize; /**< sizeof(uuid_command_t) */
|
---|
| 618 | uint8_t uuid[16]; /** The UUID bytes. */
|
---|
| 619 | } uuid_command_t;
|
---|
| 620 |
|
---|
| 621 |
|
---|
| 622 | /** @todo symseg_command (LC_SYMSEG) */
|
---|
| 623 | /** @todo ident_command (LC_IDENT)
|
---|
| 624 | /** @todo fvmfile_command (LC_FVMFILE) */
|
---|
[2949] | 625 | #endif
|
---|
| 626 |
|
---|