Changeset 2951

Timestamp:

Jan 29, 2007, 3:10:52 AM (19 years ago)

Author:

bird

Message:

The command structures essential to MH_OBJECT.

File:

• trunk/kLdr/kLdrModMachO.h (modified) (2 diffs)

trunk/kLdr/kLdrModMachO.h

@@ -312 +312 @@
 #define LC_SUB_FRAMEWORK    UINT32_C(0x12)  /**< Sub framework. See sub_framework_command. */
 #define LC_SUB_UMBRELLA     UINT32_C(0x13)  /**< Sub umbrella. See sub_umbrella_command. */
-#define LC_SUB_CLIENT       UINT32_C(0x14)  /**< Sub client. See sub_client_command.
+#define LC_SUB_CLIENT       UINT32_C(0x14)  /**< Sub client. See sub_client_command. */
 #define LC_SUB_LIBRARY      UINT32_C(0x15)  /**< Sub library. See sub_library_command. */
 #define LC_TWOLEVEL_HINTS   UINT32_C(0x16)  /**< Two-level namespace lookup hints. See twolevel_hints_command. */
@@ -322 +322 @@
 /** @} */
 
+
+/**
+ * Load Command String.
+ */
+typedef struct lc_str
+{
+    /** Offset of the string relative to the load_command structure.
+     * The string is zero-terminated. the size of the load command
+     * is zero padded up to a multiple of 4 bytes. */
+    uint32_t        offset;
+} lc_str_t;
+
+
+/**
+ * Segment load command (32-bit).
+ */
+typedef struct segment_command_32
+{
+    uint32_t        cmd;            /**< LC_SEGMENT */
+    uint32_t        cmdsize;        /**< sizeof(self) + sections. */
+    char            segname[16];    /**< The segment name. */
+    uint32_t        vmaddr;         /**< Memory address of this segment. */
+    uint32_t        vmsize;         /**< Size of this segment. */
+    uint32_t        fileoff;        /**< The file location of the segment. */
+    uint32_t        filesize;       /**< The file size of the segment. */
+    uint32_t        maxprot;        /**< Maximum VM protection. */
+    uint32_t        initprot;       /**< Initial VM protection. */
+    uint32_t        nsects;         /**< Number of section desciptors following this structure. */
+    uint32_t        flags;          /**< Flags (SG_*). */
+} segment_command_32_t;
+
+
+/**
+ * Segment load command (64-bit).
+ * Same as segment_command_32 except 4 members has been blown up to 64-bit.
+ */
+typedef struct segment_command_64
+{
+    uint32_t        cmd;            /**< LC_SEGMENT */
+    uint32_t        cmdsize;        /**< sizeof(self) + sections. */
+    char            segname[16];    /**< The segment name. */
+    uint64_t        vmaddr;         /**< Memory address of this segment. */
+    uint64_t        vmsize;         /**< Size of this segment. */
+    uint64_t        fileoff;        /**< The file location of the segment. */
+    uint64_t        filesize;       /**< The file size of the segment. */
+    uint32_t        maxprot;        /**< Maximum VM protection. */
+    uint32_t        initprot;       /**< Initial VM protection. */
+    uint32_t        nsects;         /**< Number of section desciptors following this structure. */
+    uint32_t        flags;          /**< Flags (SG_*). */
+} segment_command_64_t;
+
+/** @name Segment flags (segment_command_64::flags, segment_command_32::flags)
+ * @{ */
+/** Map the file bits in the top end of the memory area for the segment
+ * instead of the low end. Intended for stacks in core dumps.
+ * The part of the segment memory not covered by file bits will be zeroed. */
+#define SG_HIGHVM           UINT32_C(0x00000001)
+/** This segment is the virtual memory allocated by a fixed VM library.
+ * (Used for overlap checking in the linker.) */
+#define SG_FVMLIB           UINT32_C(0x00000002)
+/** No relocations for or symbols that's relocated to in this segment.
+ * The segment can therefore safely be replaced. */
+#define SG_NORELOC          UINT32_C(0x00000004)
+/** The segment is protected.
+ * The first page isn't protected if it starts at file offset 0
+ * (so that the mach header and this load command can be easily mapped). */
+#define SG_PROTECTED_VERSION_1 UINT32_C(0x00000008)
+/** @} */
+
+
+/**
+ * 32-bit section (part of a segment load command).
+ */
+typedef struct section_32
+{
+    char            sectname[16];   /**< The section name. */
+    char            segname[16];    /**< The name of the segment this section goes into. */
+    uint32_t        addr;           /**< The memory address of this section. */
+    uint32_t        size;           /**< The size of this section. */
+    uint32_t        offset;         /**< The file offset of this section. */
+    uint32_t        align;          /**< The section alignment (**2). */
+    uint32_t        reloff;         /**< The file offset of the relocations. */
+    uint32_t        nreloc;         /**< The number of relocations. */
+    uint32_t        flags;          /**< The section flags; section type and attribs */
+    uint32_t        reserved1;      /**< Reserved / offset / index. */
+    uint32_t        reserved2;      /**< Reserved / count / sizeof. */
+} section_32_t;
+
+/**
+ * 64-bit section (part of a segment load command).
+ */
+typedef struct section_64
+{
+    char            sectname[16];   /**< The section name. */
+    char            segname[16];    /**< The name of the segment this section goes into. */
+    uint64_t        addr;           /**< The memory address of this section. */
+    uint64_t        size;           /**< The size of this section. */
+    uint32_t        offset;         /**< The file offset of this section. */
+    uint32_t        align;          /**< The section alignment (**2). */
+    uint32_t        reloff;         /**< The file offset of the relocations. */
+    uint32_t        nreloc;         /**< The number of relocations. */
+    uint32_t        flags;          /**< The section flags; section type and attribs */
+    uint32_t        reserved1;      /**< Reserved / offset / index. */
+    uint32_t        reserved2;      /**< Reserved / count / sizeof. */
+    uint32_t        reserved3;      /**< (Just) Reserved. */
+} section_64_t;
+
+/** @name Section flags (section_64::flags, section_32::flags)
+ * @{
+ */
+/** Section type mask. */
+#define SECTION_TYPE                UINT32_C(0x000000ff)
+/** Regular section. */
+#define S_REGULAR                   0x0
+/** Zero filled section. */
+#define S_ZEROFILL                  0x1
+/** C literals. */
+#define S_CSTRING_LITERALS          0x2
+/** 4 byte literals. */
+#define S_4BYTE_LITERALS            0x3
+/** 8 byte literals. */
+#define S_8BYTE_LITERALS            0x4
+/** Pointer to literals. */
+#define S_LITERAL_POINTERS          0x5
+/** Section containing non-lazy symbol pointers.
+ * Reserved1 == start index in the indirect symbol table. */
+#define S_NON_LAZY_SYMBOL_POINTERS  0x6
+/** Section containing lazy symbol pointers.
+ * Reserved1 == start index in the indirect symbol table. */
+#define S_LAZY_SYMBOL_POINTERS      0x7
+/** Section containing symbol stubs.
+ * Reserved2 == stub size. */
+#define S_SYMBOL_STUBS              0x8
+/** Section containing function pointers for module initialization. . */
+#define S_MOD_INIT_FUNC_POINTERS    0x9
+/** Section containing function pointers for module termination. . */
+#define S_MOD_TERM_FUNC_POINTERS    0xa
+/** Section containing symbols that are to be coalesced. */
+#define S_COALESCED                 0xb
+/** Zero filled section that be larger than 4GB. */
+#define S_GB_ZEROFILL               0xc
+/** Section containing pairs of function pointers for interposing. */
+#define S_INTERPOSING               0xd
+/** 16 byte literals. */
+#define S_16BYTE_LITERALS           0xe
+
+/** Section attribute mask. */
+#define SECTION_ATTRIBUTES          UINT32_C(0xffffff00)
+
+/** User settable attribute mask. */
+#define SECTION_ATTRIBUTES_USR      UINT32_C(0xff000000)
+/** Pure instruction (code). */
+#define S_ATTR_PURE_INSTRUCTIONS    UINT32_C(0x80000000)
+/** ranlib, ignore my symbols... */
+#define S_ATTR_NO_TOC               UINT32_C(0x40000000)
+/** May strip static symbols when linking int a MH_DYLDLINK file. */
+#define S_ATTR_STRIP_STATIC_SYMS    UINT32_C(0x20000000)
+/** No dead stripping. */
+#define S_ATTR_NO_DEAD_STRIP        UINT32_C(0x10000000)
+/** Live support. */
+#define S_ATTR_LIVE_SUPPORT         UINT32_C(0x08000000)
+/** Contains self modifying code (generally i386 code stub for dyld). */
+#define S_ATTR_SELF_MODIFYING_CODE  UINT32_C(0x04000000)
+/** Debug info (DWARF usually). */
+#define S_ATTR_DEBUG                UINT32_C(0x02000000)
+
+/** System settable attribute mask. */
+#define SECTION_ATTRIBUTES_SYS      UINT32_C(0x00ffff00)
+/** Contains some instructions (code). */
+#define S_ATTR_SOME_INSTRUCTIONS    UINT32_C(0x00000400)
+/** Has external relocations. */
+#define S_ATTR_EXT_RELOC            UINT32_C(0x00000200)
+/** Has internal (local) relocations. */
+#define S_ATTR_LOC_RELOC            UINT32_C(0x00000100)
+/** @} */
+
+/** @name Known Segment and Section Names.
+ * Some of these implies special linker behaviour.
+ * @{
+ */
+/** Page zero - not-present page for catching invalid access. (MH_EXECUTE typically) */
+#define SEG_PAGEZERO        "__PAGEZERO"
+/** Traditional UNIX text segment.
+ * Defaults to R-X. */
+#define SEG_TEXT            "__TEXT"
+/** The text part of SEG_TEXT. */
+#define SECT_TEXT               "__text"
+/** The fvmlib initialization. */
+#define SECT_FVMLIB_INIT0       "__fvmlib_init0"
+/** The section following the fvmlib initialization. */
+#define SECT_FVMLIB_INIT1       "__fvmlib_init1"
+/** The traditional UNIX data segment. (DGROUP to DOS and OS/2 people.) */
+#define SEG_DATA            "__DATA"
+/** The initialized data section. */
+#define SECT_DATA               "__data"
+/** The uninitialized data section. */
+#define SECT_BSS                "__bss"
+/** The common symbol section. */
+#define SECT_COMMON             "__common"
+/** Objective-C runtime segment. */
+#define SEG_OBJC            "__OBJC"
+/** Objective-C symbol table section. */
+#define SECT_OBJC_SYMBOLS       "__symbol_table"
+/** Objective-C module information section. */
+#define SECT_OBJC_MODULES       "__module_info"
+/** Objective-C string table section. */
+#define SECT_OBJC_STRINGS       "__selector_strs"
+/** Objective-C string table section. */
+#define SECT_OBJC_REFS          "__selector_refs"
+/** Icon segment. */
+#define SEG_ICON            "__ICON"
+/** The icon headers. */
+#define SECT_ICON_HEADER        "__header"
+/** The icons in the TIFF format. */
+#define SECT_ICON_TIFF          "__tiff"
+/** ld -seglinkedit segment containing all the structs create and maintained
+ * by the linker. MH_EXECUTE and MH_FVMLIB only. */
+#define SEG_LINKEDIT        "__LINKEDIT"
+/** The unix stack segment. */
+#define SEG_UNIXSTACK       "__UNIXSTACK"
+/** The segment for the self modifying code for dynamic linking.
+ * Implies RWX permissions. */
+#define SEG_IMPORT          "__IMPORT"
+/** @} */
+
+
+/** @todo fvmlib */
+/** @todo fvmlib_command (LC_IDFVMLIB or LC_LOADFVMLIB) */
+/** @todo dylib */
+/** @todo dylib_command (LC_ID_DYLIB, LC_LOAD_DYLIB, LC_LOAD_WEAK_DYLIB) */
+/** @todo sub_framework_command (LC_SUB_FRAMEWORK) */
+/** @todo sub_client_command (LC_SUB_CLIENT) */
+/** @todo sub_umbrella_command (LC_SUB_UMBRELLA) */
+/** @todo sub_library_command (LC_SUB_LIBRARY) */
+/** @todo prebound_dylib_command (LC_PREBOUND_DYLIB) */
+/** @todo dylinker_command (LC_ID_DYLINKER or LC_LOAD_DYLINKER) */
+
+
+/**
+ * Thread command.
+ *
+ * State description of a thread that is to be created. The description
+ * is made up of a number of state structures preceded by a 32-bit flavor
+ * and 32-bit count field stating the kind of stat structure and it's size
+ * in uint32_t items respecitvly.
+ *
+ * LC_UNIXTHREAD differs from LC_THREAD in that it implies stack creation
+ * and that it's started with the typical main(int, char **, char **) frame
+ * on the stack.
+ */
+typedef struct thread_command
+{
+    uint32_t        cmd;        /**< LC_UNIXTHREAD or LC_THREAD. */
+    uint32_t        cmdsize;    /**< The size of the command (including this header). */
+} thread_command_t;
+
+
+/** @todo routines_command (LC_ROUTINES) */
+/** @todo routines_command_64 (LC_ROUTINES_64) */
+
+
+/**
+ * Symbol table command.
+ * Contains a.out style symbol table with some tricks.
+ */
+typedef struct symtab_command
+{
+    uint32_t        cmd;        /**< LC_SYMTAB */
+    uint32_t        cmdsize;    /** sizeof(symtab_command_t) */
+    uint32_t        symoff;     /** The file offset of the symbol table. */
+    uint32_t        nsyms;      /** The number of symbols in the symbol table. */
+    uint32_t        stroff;     /** The file offset of the string table. */
+    uint32_t        strsize;    /** The size of the string table. */
+} symtab_command_t;
+
+
+/** @todo dysymtab_command (LC_DYSYMTAB)  */
+/** @todo dylib_table_of_contents */
+/** @todo dylib_module_32 */
+/** @todo dylib_module_64 */
+/** @todo dylib_reference */
+/** @todo twolevel_hints_command (LC_TWOLEVEL_HINTS) */
+/** @todo twolevel_hint */
+/** @todo prebind_cksum_command (LC_PREBIND_CKSUM) */
+
+
+/**
+ * UUID generated by ld.
+ */
+typedef struct uuid_command
+{
+    uint32_t        cmd;        /**< LC_UUID */
+    uint32_t        cmdsize;    /**< sizeof(uuid_command_t) */
+    uint8_t         uuid[16];   /** The UUID bytes. */
+} uuid_command_t;
+
+
+/** @todo symseg_command (LC_SYMSEG) */
+/** @todo ident_command (LC_IDENT)
+/** @todo fvmfile_command (LC_FVMFILE) */
 #endif