source: trunk/kLdr/kLdrModMachO.h@ 3067

Last change on this file since 3067 was 2971, checked in by bird, 19 years ago

typos.
File size: 40.9 KB
Line 
1/* $Id $ */
2/** @file
3 * Mach-0 structures, types and defines.
4 */
5
6#ifndef __kLdrModMachO_h__
7#define __kLdrModMachO_h__
8
9/** @defgroup grp_mach_o The Mach-O Structures, Types, and Defines.
10 * @{
11 */
12
13
14#ifndef IMAGE_FAT_SIGNATURE
15/** The FAT signature (universal binaries). */
16# define IMAGE_FAT_SIGNATURE UINT32_C(0xcafebabe)
17#endif
18#ifndef IMAGE_FAT_SIGNATURE_OE
19/** The FAT signature (universal binaries), other endian. */
20# define IMAGE_FAT_SIGNATURE_OE UINT32_C(0xbebafeca)
21#endif
22
23/**
24 * The fat header found at the start of universal binaries.
25 * It is followed by \a nfat_arch numbers of \a fat_arch structures.
26 */
27typedef struct fat_header
28{
29 uint32_t magic;
30 uint32_t nfat_arch;
31} fat_header_t;
32
33/**
34 * Description of fat file item.
35 */
36typedef struct fat_arch
37{
38 int32_t cputype;
39 int32_t cpusubtype;
40 uint32_t offset;
41 uint32_t size;
42 uint32_t align; /**< Power of 2. */
43} fat_arch_t;
44
45
46
47#ifndef IMAGE_MACHO32_SIGNATURE
48/** The 32-bit Mach-O signature. */
49# define IMAGE_MACHO32_SIGNATURE UINT32_C(0xfeedface)
50#endif
51#ifndef IMAGE_MACHO32_SIGNATURE_OE
52/** The 32-bit Mach-O signature, other endian. */
53# define IMAGE_MACHO32_SIGNATURE_OE UINT32_C(0xcefaedfe)
54#endif
55#define MH_MAGIC IMAGE_MACHO32_SIGNATURE
56#define MH_CIGAM IMAGE_MACHO32_SIGNATURE_OE
57
58/**
59 * 32-bit Mach-O header.
60 * This is followed by \a ncmds number of load commands.
61 * @see mach_header_64
62 */
63typedef struct mach_header_32
64{
65 uint32_t magic;
66 int32_t cputype;
67 int32_t cpusubtype;
68 uint32_t filetype;
69 uint32_t ncmds;
70 uint32_t sizeofcmds;
71 uint32_t flags;
72} mach_header_32_t;
73
74
75
76#ifndef IMAGE_MACHO64_SIGNATURE
77/** The 64-bit Mach-O signature. */
78# define IMAGE_MACHO64_SIGNATURE UINT32_C(0xfeedfacf)
79#endif
80#ifndef IMAGE_MACHO64_SIGNATURE_OE
81/** The 64-bit Mach-O signature, other endian. */
82# define IMAGE_MACHO64_SIGNATURE_OE UINT32_C(0xfefaedfe)
83#endif
84#define MH_MAGIC_64 IMAGE_MACHO64_SIGNATURE
85#define MH_CIGAM_64 IMAGE_MACHO64_SIGNATURE_OE
86
87/**
88 * 64-bit Mach-O header.
89 * This is followed by \a ncmds number of load commands.
90 * @see mach_header
91 */
92typedef struct mach_header_64
93{
94 uint32_t magic;
95 int32_t cputype;
96 int32_t cpusubtype;
97 uint32_t filetype;
98 uint32_t ncmds;
99 uint32_t sizeofcmds;
100 uint32_t flags;
101 uint32_t reserved; /**< (for proper struct and command alignment I guess) */
102} mach_header_64_t;
103
104
105/** @name File types (mach_header_64::filetype, mach_header_32::filetype)
106 * @{
107 */
108#define MH_OBJECT UINT32_C(1) /**< Object (relocatable). */
109#define MH_EXECUTE UINT32_C(2) /**< Executable (demand paged). */
110#define MH_FVMLIB UINT32_C(3) /**< Fixed VM shared library. */
111#define MH_CORE UINT32_C(4) /**< Core file. */
112#define MH_PRELOAD UINT32_C(5) /**< Preloaded executable. */
113#define MH_DYLIB UINT32_C(6) /**< Dynamically bound shared library. */
114#define MH_DYLINKER UINT32_C(7) /**< Dynamic linker. */
115#define MH_BUNDLE UINT32_C(8) /**< Dymamically bound bundle. */
116#define MH_DYLIB_STUB UINT32_C(9) /**< Shared library stub for static linking. */
117#define MH_DSYM UINT32_C(10)/**< Debug symbols. */
118
119/** @} */
120
121
122/** @name Mach-O Header flags (mach_header_64::flags, mach_header_32::flags)
123 * @{
124 */
125#define MH_NOUNDEFS UINT32_C(0x00000001) /**< No undefined symbols. */
126#define MH_INCRLINK UINT32_C(0x00000002) /**< Partial increment link output. */
127#define MH_DYLDLINK UINT32_C(0x00000004) /**< Food for the dynamic linker, not for ld. */
128#define MH_BINDATLOAD UINT32_C(0x00000008) /**< Bind all undefined symbols at load time. */
129#define MH_PREBOUND UINT32_C(0x00000010) /**< Contains prebound undefined symbols. */
130#define MH_SPLIT_SEGS UINT32_C(0x00000020) /**< Read-only and read-write segments are split. */
131#define MH_LAZY_INIT UINT32_C(0x00000040) /**< Obsolete flag for doing lazy init when data is written. */
132#define MH_TWOLEVEL UINT32_C(0x00000080) /**< Uses two-level name space bindings. */
133#define MH_FORCE_FLAT UINT32_C(0x00000100) /**< Task: The executable forces all images to use flat name space bindings. */
134#define MH_NOMULTIDEFS UINT32_C(0x00000200) /**< No multiple symbol definitions, safe to use two-level namespace hints. */
135#define MH_NOFIXPREBINDING UINT32_C(0x00000400) /**< The dynamic linker should not notify the prebinding agent about this executable. */
136#define MH_PREBINDABLE UINT32_C(0x00000800) /**< Not prebound, but it can be. Invalid if MH_PREBOUND is set. */
137#define MH_ALLMODSBOUND UINT32_C(0x00001000) /**< Binds to all two-level namespace modules of preqs. Requires MH_PREBINDABLE and MH_TWOLEVEL to be set. */
138#define MH_SUBSECTIONS_VIA_SYMBOLS UINT32_C(0x00002000) /**< Safe to divide sections into sub-sections via symbols for dead code stripping. */
139#define MH_CANONICAL UINT32_C(0x00004000) /**< Canonicalized via unprebind. */
140#define MH_WEAK_DEFINES UINT32_C(0x00008000) /**< The (finally) linked image has weak symbols. */
141#define MH_BINDS_TO_WEAK UINT32_C(0x00010000) /**< The (finally) linked image uses weak symbols. */
142#define MH_ALLOW_STACK_EXECUTION UINT32_C(0x00020000) /**< Task: allow stack execution. (MH_EXECUTE only) */
143#define MH_VALID_FLAGS UINT32_C(0x0003ffff) /**< Mask containing the defined flags. */
144/** @} */
145
146
147/** @name CPU types / bits (mach_header_64::cputype, mach_header_32::cputype, fat_arch::cputype)
148 * @{
149 */
150#define CPU_ARCH_MASK INT32_C(0xff000000)
151#define CPU_ARCH_ABI64 INT32_C(0x01000000)
152#define CPU_TYPE_ANY INT32_C(-1)
153#define CPU_TYPE_VAX INT32_C(1)
154#define CPU_TYPE_MC680x0 INT32_C(6)
155#define CPU_TYPE_X86 INT32_C(7)
156#define CPU_TYPE_I386 CPU_TYPE_X86
157#define CPU_TYPE_X86_64 (CPU_TYPE_X86 | CPU_ARCH_ABI64)
158#define CPU_TYPE_MC98000 INT32_C(10)
159#define CPU_TYPE_HPPA INT32_C(11)
160#define CPU_TYPE_MC88000 INT32_C(13)
161#define CPU_TYPE_SPARC INT32_C(14)
162#define CPU_TYPE_I860 INT32_C(15)
163#define CPU_TYPE_POWERPC INT32_C(18)
164#define CPU_TYPE_POWERPC64 (CPU_TYPE_POWERPC | CPU_ARCH_ABI64)
165/** @} */
166
167
168/** @name CPU subtypes (mach_header_64::cpusubtype, mach_header_32::cpusubtype, fat_arch::cpusubtype)
169 * @{ */
170#define CPU_SUBTYPE_MULTIPLE INT32_C(-1)
171#define CPU_SUBTYPE_LITTLE_ENDIAN INT32_C(0) /**< figure this one out. */
172#define CPU_SUBTYPE_BIG_ENDIAN INT32_C(1) /**< ditto */
173
174/* VAX */
175#define CPU_SUBTYPE_VAX_ALL INT32_C(0)
176#define CPU_SUBTYPE_VAX780 INT32_C(1)
177#define CPU_SUBTYPE_VAX785 INT32_C(2)
178#define CPU_SUBTYPE_VAX750 INT32_C(3)
179#define CPU_SUBTYPE_VAX730 INT32_C(4)
180#define CPU_SUBTYPE_UVAXI INT32_C(5)
181#define CPU_SUBTYPE_UVAXII INT32_C(6)
182#define CPU_SUBTYPE_VAX8200 INT32_C(7)
183#define CPU_SUBTYPE_VAX8500 INT32_C(8)
184#define CPU_SUBTYPE_VAX8600 INT32_C(9)
185#define CPU_SUBTYPE_VAX8650 INT32_C(10)
186#define CPU_SUBTYPE_VAX8800 INT32_C(11)
187#define CPU_SUBTYPE_UVAXIII INT32_C(12)
188
189/* MC680xx */
190#define CPU_SUBTYPE_MC680x0_ALL INT32_C(1)
191#define CPU_SUBTYPE_MC68030 INT32_C(1)
192#define CPU_SUBTYPE_MC68040 INT32_C(2)
193#define CPU_SUBTYPE_MC68030_ONLY INT32_C(3)
194
195/* I386 */
196#define CPU_SUBTYPE_INTEL(fam, model) ( (int32_t)(((model) << 4) | (fam)) )
197#define CPU_SUBTYPE_INTEL_FAMILY(subtype) ( (subtype) & 0xf )
198#define CPU_SUBTYPE_INTEL_MODEL(subtype) ( (subtype) >> 4 )
199#define CPU_SUBTYPE_INTEL_FAMILY_MAX 0xf
200#define CPU_SUBTYPE_INTEL_MODEL_ALL 0
201
202#define CPU_SUBTYPE_I386_ALL CPU_SUBTYPE_INTEL(3, 0)
203#define CPU_SUBTYPE_386 CPU_SUBTYPE_INTEL(3, 0)
204#define CPU_SUBTYPE_486 CPU_SUBTYPE_INTEL(4, 0)
205#define CPU_SUBTYPE_486SX CPU_SUBTYPE_INTEL(4, 8)
206#define CPU_SUBTYPE_586 CPU_SUBTYPE_INTEL(5, 0)
207#define CPU_SUBTYPE_PENT CPU_SUBTYPE_INTEL(5, 0)
208#define CPU_SUBTYPE_PENTPRO CPU_SUBTYPE_INTEL(6, 1)
209#define CPU_SUBTYPE_PENTII_M3 CPU_SUBTYPE_INTEL(6, 3)
210#define CPU_SUBTYPE_PENTII_M5 CPU_SUBTYPE_INTEL(6, 5)
211#define CPU_SUBTYPE_CELERON CPU_SUBTYPE_INTEL(7, 6)
212#define CPU_SUBTYPE_CELERON_MOBILE CPU_SUBTYPE_INTEL(7, 7)
213#define CPU_SUBTYPE_PENTIUM_3 CPU_SUBTYPE_INTEL(8, 0)
214#define CPU_SUBTYPE_PENTIUM_3_M CPU_SUBTYPE_INTEL(8, 1)
215#define CPU_SUBTYPE_PENTIUM_3_XEON CPU_SUBTYPE_INTEL(8, 2)
216#define CPU_SUBTYPE_PENTIUM_M CPU_SUBTYPE_INTEL(9, 0)
217#define CPU_SUBTYPE_PENTIUM_4 CPU_SUBTYPE_INTEL(10, 0)
218#define CPU_SUBTYPE_PENTIUM_4_M CPU_SUBTYPE_INTEL(10, 1)
219#define CPU_SUBTYPE_ITANIUM CPU_SUBTYPE_INTEL(11, 0)
220#define CPU_SUBTYPE_ITANIUM_2 CPU_SUBTYPE_INTEL(11, 1)
221#define CPU_SUBTYPE_XEON CPU_SUBTYPE_INTEL(12, 0)
222#define CPU_SUBTYPE_XEON_MP CPU_SUBTYPE_INTEL(12, 1)
223
224/* X86 */
225#define CPU_SUBTYPE_X86_ALL INT32_C(3) /* CPU_SUBTYPE_I386_ALL */
226#define CPU_SUBTYPE_X86_64_ALL INT32_C(3) /* CPU_SUBTYPE_I386_ALL */
227#define CPU_SUBTYPE_X86_ARCH1 INT32_C(4) /* CPU_SUBTYPE_I486_ALL */
228
229/* MIPS */
230#define CPU_SUBTYPE_MIPS_ALL INT32_C(0)
231#define CPU_SUBTYPE_MIPS_R2300 INT32_C(1)
232#define CPU_SUBTYPE_MIPS_R2600 INT32_C(2)
233#define CPU_SUBTYPE_MIPS_R2800 INT32_C(3)
234#define CPU_SUBTYPE_MIPS_R2000a INT32_C(4)
235#define CPU_SUBTYPE_MIPS_R2000 INT32_C(5)
236#define CPU_SUBTYPE_MIPS_R3000a INT32_C(6)
237#define CPU_SUBTYPE_MIPS_R3000 INT32_C(7)
238
239/* MC98000 (PowerPC) */
240#define CPU_SUBTYPE_MC98000_ALL INT32_C(0)
241#define CPU_SUBTYPE_MC98601 INT32_C(1)
242
243/* HP-PA */
244#define CPU_SUBTYPE_HPPA_ALL INT32_C(0)
245#define CPU_SUBTYPE_HPPA_7100 INT32_C(0)
246#define CPU_SUBTYPE_HPPA_7100LC INT32_C(1)
247
248/* MC88000 */
249#define CPU_SUBTYPE_MC88000_ALL INT32_C(0)
250#define CPU_SUBTYPE_MC88100 INT32_C(1)
251#define CPU_SUBTYPE_MC88110 INT32_C(2)
252
253/* SPARC */
254#define CPU_SUBTYPE_SPARC_ALL INT32_C(0)
255
256/* I860 */
257#define CPU_SUBTYPE_I860_ALL INT32_C(0)
258#define CPU_SUBTYPE_I860_860 INT32_C(1)
259
260/* PowerPC */
261#define CPU_SUBTYPE_POWERPC_ALL INT32_C(0)
262#define CPU_SUBTYPE_POWERPC_601 INT32_C(1)
263#define CPU_SUBTYPE_POWERPC_602 INT32_C(2)
264#define CPU_SUBTYPE_POWERPC_603 INT32_C(3)
265#define CPU_SUBTYPE_POWERPC_603e INT32_C(4)
266#define CPU_SUBTYPE_POWERPC_603ev INT32_C(5)
267#define CPU_SUBTYPE_POWERPC_604 INT32_C(6)
268#define CPU_SUBTYPE_POWERPC_604e INT32_C(7)
269#define CPU_SUBTYPE_POWERPC_620 INT32_C(8)
270#define CPU_SUBTYPE_POWERPC_750 INT32_C(9)
271#define CPU_SUBTYPE_POWERPC_7400 INT32_C(10)
272#define CPU_SUBTYPE_POWERPC_7450 INT32_C(11)
273#define CPU_SUBTYPE_POWERPC_Max INT32_C(10)
274#define CPU_SUBTYPE_POWERPC_SCVger INT32_C(11)
275#define CPU_SUBTYPE_POWERPC_970 INT32_C(100)
276
277/** @} */
278
279
280
281/** @defgroup grp_macho_o_lc Load Commands
282 * @{ */
283
284/**
285 * The load command common core structure.
286 *
287 * After the Mach-O header follows an array of variable sized
288 * load command which all has this header in common.
289 */
290typedef struct load_command
291{
292 uint32_t cmd; /**< The load command id. */
293 uint32_t cmdsize; /**< The size of the command (including this header). */
294} load_command_t;
295
296/** @name Load Command IDs (load_command::cmd)
297 * @{
298 */
299/** Flag that when set requires the dynamic linker to fail if it doesn't
300 * grok the command. The dynamic linker will otherwise ignore commands it
301 * doesn't understand. Introduced with Mac OS X 10.1. */
302#define LC_REQ_DYLD UINT32_C(0x80000000)
303
304#define LC_SEGMENT_32 UINT32_C(0x01) /**< Segment to be mapped (32-bit). See segment_command_32. */
305#define LC_SYMTAB UINT32_C(0x02) /**< 'stab' symbol table. See symtab_command. */
306#define LC_SYMSEG UINT32_C(0x03) /**< Obsoleted gdb symbol table. */
307#define LC_THREAD UINT32_C(0x04) /**< Thread. See thread_command. */
308#define LC_UNIXTHREAD UINT32_C(0x05) /**< Unix thread (includes stack and stuff). See thread_command. */
309#define LC_LOADFVMLIB UINT32_C(0x06) /**< Load a specified fixed VM shared library (obsolete?). See fvmlib_command. */
310#define LC_IDFVMLIB UINT32_C(0x07) /**< Fixed VM shared library id (obsolete?). See fvmlib_command. */
311#define LC_IDENT UINT32_C(0x08) /**< Identification info (obsolete). See ident_command. */
312#define LC_FVMFILE UINT32_C(0x09) /**< Fixed VM file inclusion (internal). See fvmfile_command. */
313#define LC_PREPAGE UINT32_C(0x0a) /**< Prepage command (internal). See ?? */
314#define LC_DYSYMTAB UINT32_C(0x0b) /**< Symbol table for dynamic linking. See dysymtab_command. */
315#define LC_LOAD_DYLIB UINT32_C(0x0c) /**< Load a dynamically linked shared library. See dylib_command. */
316#define LC_ID_DYLIB UINT32_C(0x0d) /**< Dynamically linked share library ident. See dylib_command. */
317#define LC_LOAD_DYLINKER UINT32_C(0x0e) /**< Load a dynamical link editor. See dylinker_command. */
318#define LC_ID_DYLINKER UINT32_C(0x0f) /**< Dynamic link editor ident. See dylinker_command. */
319#define LC_PREBOUND_DYLIB UINT32_C(0x10) /**< Prebound modules for dynamically linking of a shared lib. See prebound_dylib_command. */
320#define LC_ROUTINES UINT32_C(0x11) /**< Image routines. See routines_command_32. */
321#define LC_SUB_FRAMEWORK UINT32_C(0x12) /**< Sub framework. See sub_framework_command. */
322#define LC_SUB_UMBRELLA UINT32_C(0x13) /**< Sub umbrella. See sub_umbrella_command. */
323#define LC_SUB_CLIENT UINT32_C(0x14) /**< Sub client. See sub_client_command. */
324#define LC_SUB_LIBRARY UINT32_C(0x15) /**< Sub library. See sub_library_command. */
325#define LC_TWOLEVEL_HINTS UINT32_C(0x16) /**< Two-level namespace lookup hints. See twolevel_hints_command. */
326#define LC_PREBIND_CKSUM UINT32_C(0x17) /**< Prebind checksum. See prebind_cksum_command. */
327#define LC_LOAD_WEAK_DYLIB (UINT32_C(0x18) | LC_REQ_DYLD) /**< Dylib that can be missing, all symbols weak. See dylib_command. */
328#define LC_SEGMENT_64 UINT32_C(0x19) /**< segment to be mapped (64-bit). See segment_command_32. */
329#define LC_ROUTINES_64 UINT32_C(0x1a) /**< Image routines (64-bit). See routines_command_32. */
330#define LC_UUID UINT32_C(0x1b) /**< The UUID of the object module. See uuid_command. */
331/** @} */
332
333
334/**
335 * Load Command String.
336 */
337typedef struct lc_str
338{
339 /** Offset of the string relative to the load_command structure.
340 * The string is zero-terminated. the size of the load command
341 * is zero padded up to a multiple of 4 bytes. */
342 uint32_t offset;
343} lc_str_t;
344
345
346/**
347 * Segment load command (32-bit).
348 */
349typedef struct segment_command_32
350{
351 uint32_t cmd; /**< LC_SEGMENT */
352 uint32_t cmdsize; /**< sizeof(self) + sections. */
353 char segname[16]; /**< The segment name. */
354 uint32_t vmaddr; /**< Memory address of this segment. */
355 uint32_t vmsize; /**< Size of this segment. */
356 uint32_t fileoff; /**< The file location of the segment. */
357 uint32_t filesize; /**< The file size of the segment. */
358 uint32_t maxprot; /**< Maximum VM protection. */
359 uint32_t initprot; /**< Initial VM protection. */
360 uint32_t nsects; /**< Number of section desciptors following this structure. */
361 uint32_t flags; /**< Flags (SG_*). */
362} segment_command_32_t;
363
364
365/**
366 * Segment load command (64-bit).
367 * Same as segment_command_32 except 4 members has been blown up to 64-bit.
368 */
369typedef struct segment_command_64
370{
371 uint32_t cmd; /**< LC_SEGMENT */
372 uint32_t cmdsize; /**< sizeof(self) + sections. */
373 char segname[16]; /**< The segment name. */
374 uint64_t vmaddr; /**< Memory address of this segment. */
375 uint64_t vmsize; /**< Size of this segment. */
376 uint64_t fileoff; /**< The file location of the segment. */
377 uint64_t filesize; /**< The file size of the segment. */
378 uint32_t maxprot; /**< Maximum VM protection. */
379 uint32_t initprot; /**< Initial VM protection. */
380 uint32_t nsects; /**< Number of section desciptors following this structure. */
381 uint32_t flags; /**< Flags (SG_*). */
382} segment_command_64_t;
383
384/** @name Segment flags (segment_command_64::flags, segment_command_32::flags)
385 * @{ */
386/** Map the file bits in the top end of the memory area for the segment
387 * instead of the low end. Intended for stacks in core dumps.
388 * The part of the segment memory not covered by file bits will be zeroed. */
389#define SG_HIGHVM UINT32_C(0x00000001)
390/** This segment is the virtual memory allocated by a fixed VM library.
391 * (Used for overlap checking in the linker.) */
392#define SG_FVMLIB UINT32_C(0x00000002)
393/** No relocations for or symbols that's relocated to in this segment.
394 * The segment can therefore safely be replaced. */
395#define SG_NORELOC UINT32_C(0x00000004)
396/** The segment is protected.
397 * The first page isn't protected if it starts at file offset 0
398 * (so that the mach header and this load command can be easily mapped). */
399#define SG_PROTECTED_VERSION_1 UINT32_C(0x00000008)
400/** @} */
401
402
403/**
404 * 32-bit section (part of a segment load command).
405 */
406typedef struct section_32
407{
408 char sectname[16]; /**< The section name. */
409 char segname[16]; /**< The name of the segment this section goes into. */
410 uint32_t addr; /**< The memory address of this section. */
411 uint32_t size; /**< The size of this section. */
412 uint32_t offset; /**< The file offset of this section. */
413 uint32_t align; /**< The section alignment (**2). */
414 uint32_t reloff; /**< The file offset of the relocations. */
415 uint32_t nreloc; /**< The number of relocations. */
416 uint32_t flags; /**< The section flags; section type and attribs */
417 uint32_t reserved1; /**< Reserved / offset / index. */
418 uint32_t reserved2; /**< Reserved / count / sizeof. */
419} section_32_t;
420
421/**
422 * 64-bit section (part of a segment load command).
423 */
424typedef struct section_64
425{
426 char sectname[16]; /**< The section name. */
427 char segname[16]; /**< The name of the segment this section goes into. */
428 uint64_t addr; /**< The memory address of this section. */
429 uint64_t size; /**< The size of this section. */
430 uint32_t offset; /**< The file offset of this section. */
431 uint32_t align; /**< The section alignment (**2). */
432 uint32_t reloff; /**< The file offset of the relocations. */
433 uint32_t nreloc; /**< The number of relocations. */
434 uint32_t flags; /**< The section flags; section type and attribs */
435 uint32_t reserved1; /**< Reserved / offset / index. */
436 uint32_t reserved2; /**< Reserved / count / sizeof. */
437 uint32_t reserved3; /**< (Just) Reserved. */
438} section_64_t;
439
440/** @name Section flags (section_64::flags, section_32::flags)
441 * @{
442 */
443/** Section type mask. */
444#define SECTION_TYPE UINT32_C(0x000000ff)
445/** Regular section. */
446#define S_REGULAR 0x0
447/** Zero filled section. */
448#define S_ZEROFILL 0x1
449/** C literals. */
450#define S_CSTRING_LITERALS 0x2
451/** 4 byte literals. */
452#define S_4BYTE_LITERALS 0x3
453/** 8 byte literals. */
454#define S_8BYTE_LITERALS 0x4
455/** Pointer to literals. */
456#define S_LITERAL_POINTERS 0x5
457/** Section containing non-lazy symbol pointers.
458 * Reserved1 == start index in the indirect symbol table. */
459#define S_NON_LAZY_SYMBOL_POINTERS 0x6
460/** Section containing lazy symbol pointers.
461 * Reserved1 == start index in the indirect symbol table. */
462#define S_LAZY_SYMBOL_POINTERS 0x7
463/** Section containing symbol stubs.
464 * Reserved2 == stub size. */
465#define S_SYMBOL_STUBS 0x8
466/** Section containing function pointers for module initialization. . */
467#define S_MOD_INIT_FUNC_POINTERS 0x9
468/** Section containing function pointers for module termination. . */
469#define S_MOD_TERM_FUNC_POINTERS 0xa
470/** Section containing symbols that are to be coalesced. */
471#define S_COALESCED 0xb
472/** Zero filled section that be larger than 4GB. */
473#define S_GB_ZEROFILL 0xc
474/** Section containing pairs of function pointers for interposing. */
475#define S_INTERPOSING 0xd
476/** 16 byte literals. */
477#define S_16BYTE_LITERALS 0xe
478
479/** Section attribute mask. */
480#define SECTION_ATTRIBUTES UINT32_C(0xffffff00)
481
482/** User settable attribute mask. */
483#define SECTION_ATTRIBUTES_USR UINT32_C(0xff000000)
484/** Pure instruction (code). */
485#define S_ATTR_PURE_INSTRUCTIONS UINT32_C(0x80000000)
486/** ranlib, ignore my symbols... */
487#define S_ATTR_NO_TOC UINT32_C(0x40000000)
488/** May strip static symbols when linking int a MH_DYLDLINK file. */
489#define S_ATTR_STRIP_STATIC_SYMS UINT32_C(0x20000000)
490/** No dead stripping. */
491#define S_ATTR_NO_DEAD_STRIP UINT32_C(0x10000000)
492/** Live support. */
493#define S_ATTR_LIVE_SUPPORT UINT32_C(0x08000000)
494/** Contains self modifying code (generally i386 code stub for dyld). */
495#define S_ATTR_SELF_MODIFYING_CODE UINT32_C(0x04000000)
496/** Debug info (DWARF usually). */
497#define S_ATTR_DEBUG UINT32_C(0x02000000)
498
499/** System settable attribute mask. */
500#define SECTION_ATTRIBUTES_SYS UINT32_C(0x00ffff00)
501/** Contains some instructions (code). */
502#define S_ATTR_SOME_INSTRUCTIONS UINT32_C(0x00000400)
503/** Has external relocations. */
504#define S_ATTR_EXT_RELOC UINT32_C(0x00000200)
505/** Has internal (local) relocations. */
506#define S_ATTR_LOC_RELOC UINT32_C(0x00000100)
507/** @} */
508
509/** @name Known Segment and Section Names.
510 * Some of these implies special linker behaviour.
511 * @{
512 */
513/** Page zero - not-present page for catching invalid access. (MH_EXECUTE typically) */
514#define SEG_PAGEZERO "__PAGEZERO"
515/** Traditional UNIX text segment.
516 * Defaults to R-X. */
517#define SEG_TEXT "__TEXT"
518/** The text part of SEG_TEXT. */
519#define SECT_TEXT "__text"
520/** The fvmlib initialization. */
521#define SECT_FVMLIB_INIT0 "__fvmlib_init0"
522/** The section following the fvmlib initialization. */
523#define SECT_FVMLIB_INIT1 "__fvmlib_init1"
524/** The traditional UNIX data segment. (DGROUP to DOS and OS/2 people.) */
525#define SEG_DATA "__DATA"
526/** The initialized data section. */
527#define SECT_DATA "__data"
528/** The uninitialized data section. */
529#define SECT_BSS "__bss"
530/** The common symbol section. */
531#define SECT_COMMON "__common"
532/** Objective-C runtime segment. */
533#define SEG_OBJC "__OBJC"
534/** Objective-C symbol table section. */
535#define SECT_OBJC_SYMBOLS "__symbol_table"
536/** Objective-C module information section. */
537#define SECT_OBJC_MODULES "__module_info"
538/** Objective-C string table section. */
539#define SECT_OBJC_STRINGS "__selector_strs"
540/** Objective-C string table section. */
541#define SECT_OBJC_REFS "__selector_refs"
542/** Icon segment. */
543#define SEG_ICON "__ICON"
544/** The icon headers. */
545#define SECT_ICON_HEADER "__header"
546/** The icons in the TIFF format. */
547#define SECT_ICON_TIFF "__tiff"
548/** ld -seglinkedit segment containing all the structs create and maintained
549 * by the linker. MH_EXECUTE and MH_FVMLIB only. */
550#define SEG_LINKEDIT "__LINKEDIT"
551/** The unix stack segment. */
552#define SEG_UNIXSTACK "__UNIXSTACK"
553/** The segment for the self modifying code for dynamic linking.
554 * Implies RWX permissions. */
555#define SEG_IMPORT "__IMPORT"
556/** @} */
557
558
559/** @todo fvmlib */
560/** @todo fvmlib_command (LC_IDFVMLIB or LC_LOADFVMLIB) */
561/** @todo dylib */
562/** @todo dylib_command (LC_ID_DYLIB, LC_LOAD_DYLIB, LC_LOAD_WEAK_DYLIB) */
563/** @todo sub_framework_command (LC_SUB_FRAMEWORK) */
564/** @todo sub_client_command (LC_SUB_CLIENT) */
565/** @todo sub_umbrella_command (LC_SUB_UMBRELLA) */
566/** @todo sub_library_command (LC_SUB_LIBRARY) */
567/** @todo prebound_dylib_command (LC_PREBOUND_DYLIB) */
568/** @todo dylinker_command (LC_ID_DYLINKER or LC_LOAD_DYLINKER) */
569
570
571/**
572 * Thread command.
573 *
574 * State description of a thread that is to be created. The description
575 * is made up of a number of state structures preceded by a 32-bit flavor
576 * and 32-bit count field stating the kind of stat structure and it's size
577 * in uint32_t items respecitvly.
578 *
579 * LC_UNIXTHREAD differs from LC_THREAD in that it implies stack creation
580 * and that it's started with the typical main(int, char **, char **) frame
581 * on the stack.
582 */
583typedef struct thread_command
584{
585 uint32_t cmd; /**< LC_UNIXTHREAD or LC_THREAD. */
586 uint32_t cmdsize; /**< The size of the command (including this header). */
587} thread_command_t;
588
589
590/** @todo routines_command (LC_ROUTINES) */
591/** @todo routines_command_64 (LC_ROUTINES_64) */
592
593
594/**
595 * Symbol table command.
596 * Contains a.out style symbol table with some tricks.
597 */
598typedef struct symtab_command
599{
600 uint32_t cmd; /**< LC_SYMTAB */
601 uint32_t cmdsize; /** sizeof(symtab_command_t) */
602 uint32_t symoff; /** The file offset of the symbol table. */
603 uint32_t nsyms; /** The number of symbols in the symbol table. */
604 uint32_t stroff; /** The file offset of the string table. */
605 uint32_t strsize; /** The size of the string table. */
606} symtab_command_t;
607
608
609/** @todo dysymtab_command (LC_DYSYMTAB) */
610/** @todo dylib_table_of_contents */
611/** @todo dylib_module_32 */
612/** @todo dylib_module_64 */
613/** @todo dylib_reference */
614/** @todo twolevel_hints_command (LC_TWOLEVEL_HINTS) */
615/** @todo twolevel_hint */
616/** @todo prebind_cksum_command (LC_PREBIND_CKSUM) */
617
618
619/**
620 * UUID generated by ld.
621 */
622typedef struct uuid_command
623{
624 uint32_t cmd; /**< LC_UUID */
625 uint32_t cmdsize; /**< sizeof(uuid_command_t) */
626 uint8_t uuid[16]; /** The UUID bytes. */
627} uuid_command_t;
628
629
630/** @todo symseg_command (LC_SYMSEG) */
631/** @todo ident_command (LC_IDENT) */
632/** @todo fvmfile_command (LC_FVMFILE) */
633
634/** @} */
635
636
637
638/** @defgroup grp_macho_o_syms Symbol Table
639 * @{ */
640
641/**
642 * The 32-bit Mach-O version of the nlist structure.
643 *
644 * This differs from the a.out nlist struct in that the unused n_other field
645 * was renamed to n_sect and used for keeping the relevant section number.
646 * @remark This structure is not name mach_nlist_32 in the Apple headers, but nlist.
647 */
648typedef struct macho_nlist_32
649{
650 union
651 {
652 int32_t n_strx; /**< Offset (index) into the string table. 0 means "". */
653 } n_un;
654 uint8_t n_type; /**< Symbol type. */
655 uint8_t n_sect; /**< Section number of NO_SECT. */
656 int16_t n_desc; /**< Type specific, debug info details mostly.*/
657 uint32_t n_value; /**< The symbol value or stab offset. */
658} macho_nlist_32_t;
659
660
661/**
662 * The 64-bit Mach-O version of the nlist structure.
663 * @see macho_nlist_32
664 */
665typedef struct macho_nlist_64
666{
667 union
668 {
669 uint32_t n_strx; /**< Offset (index) into the string table. 0 means "". */
670 } n_un;
671 uint8_t n_type; /**< Symbol type. */
672 uint8_t n_sect; /**< Section number of NO_SECT. */
673 int16_t n_desc; /**< Type specific, debug info details mostly.*/
674 uint64_t n_value; /**< The symbol value or stab offset. */
675} macho_nlist_64_t;
676
677
678/** @name Symbol Type Constants (macho_nlist_32_t::n_type, macho_nlist_64_t::n_type)
679 *
680 * In the Mach-O world n_type is somewhat similar to a.out, meaning N_EXT, N_UNDF, N_ABS
681 * and the debug symbols are essentially the same, but the remaining stuff is different.
682 * The main reason for this is that the encoding of section has been moved to n_sect
683 * to permit up to 255 sections instead of the fixed 3 a.out sections (not counting
684 * the abs symbols and set vectors).
685 *
686 * To avoid confusion with a.out the Mach-O constants has been fitted with a MACHO_
687 * prefix here.
688 *
689 * Common symbols (aka communal symbols and comdefs) are represented by
690 * n_type = MACHO_N_EXT | MACHO_N_UNDF, n_sect = NO_SECT and n_value giving
691 * the size.
692 *
693 *
694 * Symbol table entries can be inserted directly in the assembly code using
695 * this notation:
696 * @code
697 * .stabs "n_name", n_type, n_sect, n_desc, n_value
698 * @endcode
699 *
700 * (1) The line number is optional, GCC doesn't set it.
701 * (2) The type is optional, GCC doesn't set it.
702 * (3) The binutil header is "skeptical" about the line. I'm skeptical about the whole thing... :-)
703 * (M) Mach-O specific?
704 * (S) Sun specific?
705 * @{
706 */
707
708/* Base masks. */
709#define MACHO_N_EXT UINT8_C(0x01) /**< External symbol (when set) (N_EXT). */
710#define MACHO_N_TYPE UINT8_C(0x0e) /**< Symbol type (N_TYPE without the 8th bit). */
711#define MACHO_N_PEXT UINT8_C(0x10) /**< Private extern symbol (when set). (M) */
712#define MACHO_N_STAB UINT8_C(0xe0) /**< Debug symbol mask (N_STAB). */
713
714/* MACHO_N_TYPE values. */
715#define MACHO_N_UNDF UINT8_C(0x00) /**< MACHO_N_TYPE: Undefined symbol (N_UNDF). n_sect = NO_SECT. */
716#define MACHO_N_ABS UINT8_C(0x02) /**< MACHO_N_TYPE: Absolute symbol (N_UNDF). n_sect = NO_SECT. */
717#define MACHO_N_INDR UINT8_C(0x0a) /**< MACHO_N_TYPE: Indirect symbol, n_value is the index of the symbol. (M) */
718#define MACHO_N_PBUD UINT8_C(0x0c) /**< MACHO_N_TYPE: Prebound undefined symbo (defined in a dylib). (M) */
719#define MACHO_N_SECT UINT8_C(0x0e) /**< MACHO_N_TYPE: Defined in the section given by n_sects. (M) */
720
721/* Debug symbols. */
722#define MACHO_N_GSYM UINT8_C(0x20) /**< Global variable. "name",, NO_SECT, type, 0 (2) */
723#define MACHO_N_FNAME UINT8_C(0x22) /**< Function name (F77). "name",, NO_SECT, 0, 0 */
724#define MACHO_N_FUN UINT8_C(0x24) /**< Function / text var. "name",, section, line, address (1) */
725#define MACHO_N_STSYM UINT8_C(0x26) /**< Static data symbol. "name",, section, type, address (2) */
726#define MACHO_N_LCSYM UINT8_C(0x28) /**< static bss symbol. "name",, section, type, address (2) */
727 /* omits N_MAIN and N_ROSYM. */
728#define MACHO_N_BNSYM UINT8_C(0x2e) /**< Begin nsect symbol. 0,, section, 0, address (M) */
729#define MACHO_N_PC UINT8_C(0x30) /**< Global pascal symbol. "name",, NO_SECT, subtype?, line (3) */
730 /* omits N_NSYMS, N_NOMAP and N_OBJ. */
731#define MACHO_N_OPT UINT8_C(0x3c) /**< Options for the debugger related to the language of the
732 source file. "options?",,,, */
733#define MACHO_N_RSYM UINT8_C(0x40) /**< Register variable. "name",, NO_SECT, type, register */
734 /* omits N_M2C */
735#define MACHO_N_SLINE UINT8_C(0x44) /**< Source line. 0,, section, line, address */
736 /* omits N_DSLINE, N_BSLINE / N_BROWS, N_DEFD and N_FLINE. */
737#define MACHO_N_ENSYM UINT8_C(0x4e) /**< End nsect symbol. 0,, section, 0, address (M) */
738 /* omits N_EHDECL / N_MOD2 and N_CATCH. */
739#define MACHO_N_SSYM UINT8_C(0x60) /**< Struct/union element. "name",, NO_SECT, type, offset */
740 /* omits N_ENDM */
741#define MACHO_N_SO UINT8_C(0x64) /**< Source file name. "fname",, section, 0, address */
742#define MACHO_N_OSO UINT8_C(0x66) /**< Object file name. "fname",, 0, 0, st_mtime (M?) */
743 /* omits N_ALIAS */
744#define MACHO_N_LSYM UINT8_C(0x80) /**< Stack variable. "name",, NO_SECT, type, frame_offset */
745#define MACHO_N_BINCL UINT8_C(0x82) /**< Begin #include. "fname",, NO_SECT, 0, sum? */
746#define MACHO_N_SOL UINT8_C(0x84) /**< #included file. "fname",, section, 0, start_address (S) */
747#define MACHO_N_PARAMS UINT8_C(0x86) /**< Compiler params. "params",, NO_SECT, 0, 0 */
748#define MACHO_N_VERSION UINT8_C(0x88) /**< Compiler version. "version",, NO_SECT, 0, 0 */
749#define MACHO_N_OLEVEL UINT8_C(0x8A) /**< Compiler -O level. "level",, NO_SECT, 0, 0 */
750#define MACHO_N_PSYM UINT8_C(0xa0) /**< Parameter variable. "name",, NO_SECT, type, frame_offset */
751#define MACHO_N_EINCL UINT8_C(0xa2) /**< End #include. "fname",, NO_SECT, 0, 0 (S) */
752#define MACHO_N_ENTRY UINT8_C(0xa4) /**< Alternate entry point. "name",, section, line, address */
753#define MACHO_N_LBRAC UINT8_C(0xc0) /**< Left bracket. 0,, NO_SECT, nesting_level, address */
754#define MACHO_N_EXCL UINT8_C(0xc2) /**< Deleted include file. "fname",, NO_SECT, 0, sum? (S) */
755 /* omits N_SCOPE */
756#define MACHO_N_RBRAC UINT8_C(0xe0) /**< Right bracket. 0,, NO_SECT, nesting_level, address */
757#define MACHO_N_BCOMM UINT8_C(0xe2) /**< Begin common. "name",, NO_SECT?, 0, 0 */
758#define MACHO_N_ECOMM UINT8_C(0xe4) /**< End common. "name",, section, 0, 0 */
759#define MACHO_N_ECOML UINT8_C(0xe8) /**< End local common. 0,, section, 0, address */
760#define MACHO_N_LENG UINT8_C(0xfe) /**< Length-value of the preceding entry.
761 "name",, NO_SECT, 0, length */
762
763/** @} */
764
765/** @name Symbol Description Bits (macho_nlist_32_t::n_desc, macho_nlist_64_t::n_desc)
766 *
767 * Mach-O puts the n_desc field to a number of uses, like lazy binding , library
768 * ordinal numbers for -twolevel_namespace, stripping and weak symbol handling.
769 *
770 * @remark The REFERENCE_FLAGS_* are really not flags in the normal sense (bit),
771 * they are more like enum values.
772 * @{
773 */
774
775#define REFERENCE_TYPE UINT16_C(0x000f) /**< The reference type mask. */
776#define REFERENCE_FLAG_UNDEFINED_NON_LAZY 0 /**< Normal undefined symbol. */
777#define REFERENCE_FLAG_UNDEFINED_LAZY 1 /**< Lazy undefined symbol. */
778#define REFERENCE_FLAG_DEFINED 2 /**< Defined symbol (dynamic linking). */
779#define REFERENCE_FLAG_PRIVATE_DEFINED 3 /**< Defined private symbol (dynamic linking). */
780#define REFERENCE_FLAG_PRIVATE_UNDEFINED_NON_LAZY 4 /**< Normal undefined private symbol. */
781#define REFERENCE_FLAG_PRIVATE_UNDEFINED_LAZY 5 /**< Lazy undefined private symbol. */
782
783#define REFERENCED_DYNAMICALLY UINT16_C(0x0010) /**< Don't strip. */
784
785
786/** Get the dynamic library ordinal. */
787#define GET_LIBRARY_ORDINAL(n_desc) \
788 (((n_desc) >> 8) & 0xff)
789/** Set the dynamic library ordinal. */
790#define SET_LIBRARY_ORDINAL(n_desc, ordinal) \
791 (n_desc) = (((n_desc) & 0xff) | (((ordinal) & 0xff) << 8))
792#define SELF_LIBRARY_ORDINAL 0x00 /**< Special ordinal for refering to onself. */
793#define MAX_LIBRARY_ORDINAL 0xfd /**< Maximum ordinal number. */
794#define DYNAMIC_LOOKUP_ORDINAL 0xfe /**< Special ordinal number for dynamic lookup. (Mac OS X 10.3 and later) */
795#define EXECUTABLE_ORDINAL 0xff /**< Special ordinal number for the executable. */
796
797
798/** Only MH_OBJECT: Never dead strip me! */
799#define N_NO_DEAD_STRIP UINT16_C(0x0020)
800/** Not MH_OBJECT: Discarded symbol. */
801#define N_DESC_DISCARDED UINT16_C(0x0020)
802/** Weak external symbol. Symbol can be missing, in which case it's will have the value 0. */
803#define N_WEAK_REF UINT16_C(0x0040)
804/** Weak symbol definition. The symbol can be overridden by another weak
805 * symbol already present or by a non-weak (strong) symbol definition.
806 * Currently only supported for coalesed symbols.
807 * @remark This bit means something differently for undefined symbols, see N_REF_TO_WEAK.
808 */
809#define N_WEAK_DEF UINT16_C(0x0080)
810/** Reference to a weak symbol, resolve using flat namespace searching.
811 * @remark This bit means something differently for defined symbols, see N_WEAK_DEF. */
812#define N_REF_TO_WEAK UINT16_C(0x0080)
813
814/** @} */
815
816/** @} */
817
818
819/** @defgroup grp_macho_o_relocs Relocations
820 * @{ */
821
822/**
823 * Relocation entry.
824 *
825 * Differs from a.out in the meaning of r_symbolnum when r_extern=0 and
826 * that r_pad is made into r_type.
827 *
828 * @remark This structure and type has been prefixed with macho_ to avoid
829 * confusion with the original a.out type.
830 */
831typedef struct macho_relocation_info
832{
833 int32_t r_address; /**< Section relative address of the fixup.
834 The top bit (signed) indicates that this is a scattered
835 relocation if set, see scattered_relocation_info_t. */
836 uint32_t r_symbolnum : 24, /**< r_extern=1: Symbol table index, relocate with the address of this symbol.
837 r_extern=0: Section ordinal, relocate with the address of this section. */
838 r_pcrel : 1, /**< PC (program counter) relative fixup; subtract the fixup address. */
839 r_length : 2, /**< Fixup length: 0=uint8_t, 1=uint16_t, 2=uint32_t, 3=uint64_t. */
840 r_extern : 1, /**< External or internal fixup, decides the r_symbolnum interpretation.. */
841 r_type : 4; /**< Relocation type; 0 is standard, non-zero are machine specific. */
842} macho_relocation_info_t;
843
844/** Special section ordinal value for absolute relocations. */
845#define R_ABS 0
846
847/** Flag in r_address indicating that the relocation is of the
848 * scattered_relocation_info_t kind and not macho_relocation_info_t. */
849#define R_SCATTERED UINT32_C(0x80000000)
850
851/**
852 * Scattered relocation.
853 *
854 * This is a hack mainly for RISC machines which restricts section size
855 * to 16MB among other things.
856 *
857 * The reason for the big/little endian differences here is of course because
858 * of the R_SCATTERED mask and the way bitfields are implemented by the
859 * C/C++ compilers.
860 */
861typedef struct scattered_relocation_info
862{
863#ifdef KLDR_LITTLE_ENDIAN
864 uint32_t r_address : 24, /**< Section relative address of the fixup. (macho_relocation_info_t::r_address) */
865 r_type : 4, /**< Relocation type; 0 is standard, non-zero are machine specific. (macho_relocation_info_t::r_type) */
866 r_length : 2, /**< Fixup length: 0=uint8_t, 1=uint16_t, 2=uint32_t, 3=uint64_t. (macho_relocation_info_t::r_length) */
867 r_pcrel : 1, /**< PC (program counter) relative fixup; subtract the fixup address. (macho_relocation_info_t::r_pcrel) */
868 r_scattered : 1; /**< Set if scattered relocation, clear if normal relocation. */
869#elif defined(KLDR_BIG_ENDIAN)
870 uint32_t r_scattered : 1, /**< Set if scattered relocation, clear if normal relocation. */
871 r_pcrel : 1, /**< PC (program counter) relative fixup; subtract the fixup address. (macho_relocation_info_t::r_pcrel) */
872 r_length : 2, /**< Fixup length: 0=uint8_t, 1=uint16_t, 2=uint32_t, 3=uint64_t. (macho_relocation_info_t::r_length) */
873 r_type : 4, /**< Relocation type; 0 is standard, non-zero are machine specific. (macho_relocation_info_t::r_type) */
874 r_address : 24; /**< Section relative address of the fixup. (macho_relocation_info_t::r_address) */
875#else
876# error "Neither KLDR_LITTLE_ENDIAN nor KLDR_BIG_ENDIAN is defined!"
877#endif
878 int32_t r_value; /**< The value the fixup is refering to (without offset added). */
879} scattered_relocation_info_t;
880
881/**
882 * Relocation type values for a generic implementation (for r_type).
883 */
884typedef enum reloc_type_generic
885{
886 GENERIC_RELOC_VANILLA = 0, /**< Standard relocation. */
887 GENERIC_RELOC_PAIR, /**< Follows GENERIC_RELOC_SECTDIFF. */
888 GENERIC_RELOC_SECTDIFF, /**< ??? */
889 GENERIC_RELOC_PB_LA_PTR, /**< Prebound lazy pointer whatever that. */
890 GENERIC_RELOC_LOCAL_SECTDIFF /**< ??? */
891} reloc_type_generic_t;
892
893/** @} */
894
895
896/** @} */
897#endif
898
Note: See TracBrowser for help on using the repository browser.