exepe.h

来自「开放源码的编译器open watcom 1.6.0版的源代码」· C头文件 代码 · 共 368 行

/****************************************************************************
*
*                            Open Watcom Project
*
*    Portions Copyright (c) 1983-2002 Sybase, Inc. All Rights Reserved.
*
*  ========================================================================
*
*    This file contains Original Code and/or Modifications of Original
*    Code as defined in and that are subject to the Sybase Open Watcom
*    Public License version 1.0 (the 'License'). You may not use this file
*    except in compliance with the License. BY USING THIS FILE YOU AGREE TO
*    ALL TERMS AND CONDITIONS OF THE LICENSE. A copy of the License is
*    provided with the Original Code and Modifications, and is also
*    available at www.sybase.com/developer/opensource.
*
*    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 SYBASE AND ALL CONTRIBUTORS HEREBY DISCLAIM
*    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.
*
*  ========================================================================
*
* Description:  Portable Executable (PE) format structures and constants.
*
****************************************************************************/


#ifndef _EXEPE_H

/* type of a [relative] virtual address */
typedef unsigned_32     pe_va;

/* PE header table types */
enum {
        PE_TBL_EXPORT,
        PE_TBL_IMPORT,
        PE_TBL_RESOURCE,
        PE_TBL_EXCEPTION,
        PE_TBL_SECURITY,
        PE_TBL_FIXUP,
        PE_TBL_DEBUG,
        PE_TBL_ARCHITECTURE,
        PE_TBL_GLOB_PTR,
        PE_TBL_THREAD,
        PE_TBL_LOAD_CONF,
        PE_TBL_BOUND_IMPORT,
        PE_TBL_IAT,
        PE_TBL_DELAY_IMP,
        PE_TBL_COMPLUS_RTHDR,
        PE_TBL_NUMBER = 16
};

#define OLD_PE_TBL_NUMBER 9

typedef struct {
        pe_va           rva;
        unsigned_32     size;
} pe_hdr_table_entry;

/* PE header structure */
typedef struct {
    unsigned_32         signature;
    unsigned_16         cpu_type;
    unsigned_16         num_objects;
    unsigned_32         time_stamp;
    unsigned_32         sym_table;
    unsigned_32         num_syms;
    unsigned_16         nt_hdr_size;    /* # of bytes after the flags field */
    unsigned_16         flags;
    unsigned_16         magic;          /* currently 0x10b */
    unsigned_8          lnk_major;
    unsigned_8          lnk_minor;
    unsigned_32         code_size;
    unsigned_32         init_data_size;
    unsigned_32         uninit_data_size;
    pe_va               entry_rva;
    unsigned_32         code_base;
    unsigned_32         data_base;
    unsigned_32         image_base;
    unsigned_32         object_align;
    unsigned_32         file_align;
    unsigned_16         os_major;
    unsigned_16         os_minor;
    unsigned_16         user_major;
    unsigned_16         user_minor;
    unsigned_16         subsys_major;
    unsigned_16         subsys_minor;
    unsigned_32         rsvd1;
    unsigned_32         image_size;
    unsigned_32         header_size;  //size of dos hdr, nt hdr, obj table & pad
    unsigned_32         file_checksum;
    unsigned_16         subsystem;
    unsigned_16         dll_flags;
    unsigned_32         stack_reserve_size;
    unsigned_32         stack_commit_size;
    unsigned_32         heap_reserve_size;
    unsigned_32         heap_commit_size;
    unsigned_32         tls_idx_addr;
    unsigned_32         num_tables;
    pe_hdr_table_entry  table[PE_TBL_NUMBER];
} pe_header;

#define OLD_PE_TBL_SIZE (sizeof(pe_header) - 2 * (16 - 9) * sizeof(pe_va))

#define PE_SIGNATURE 0x4550
#define PL_SIGNATURE 0x4c50

/* CPU type field values */
enum {
        PE_CPU_UNKNOWN          = 0,
        PE_CPU_386              = 0x014c,
        PE_CPU_I860             = 0x014d,
        PE_CPU_MIPS_R3000       = 0x0162,
        PE_CPU_MIPS_R4000       = 0x0166,
        PE_CPU_ALPHA            = 0x184,
        PE_CPU_POWERPC          = 0x1F0
};

/* FLAG field bit values */
enum {
        PE_FLG_PROGRAM          = 0x0000,
        PE_FLG_RELOCS_STRIPPED  = 0x0001,
        PE_FLG_IS_EXECUTABLE    = 0x0002,
        PE_FLG_LINNUM_STRIPPED  = 0x0004,
        PE_FLG_LOCALS_STRIPPED  = 0x0008,
        PE_FLG_MINIMAL_OBJ      = 0x0010,
        PE_FLG_UPDATE_OBJ       = 0x0020,
        PE_FLG_16BIT_MACHINE    = 0x0040,
        PE_FLG_REVERSE_BYTE_LO  = 0x0080,       // bytes are reversed.
        PE_FLG_32BIT_MACHINE    = 0x0100,
        PE_FLG_FIXED            = 0x0200,
        PE_FLG_FILE_PATCH       = 0x0400,
        PE_FLG_FILE_SYSTEM      = 0x1000,
        PE_FLG_LIBRARY          = 0x2000,
        PE_FLG_REVERSE_BYTE_HI  = 0x8000
};


/* Linker major/minor version numbers */
#define PE_LNK_MAJOR    2
#define PE_LNK_MINOR    0x12

#define PE_IMAGE_BASE   (0x400000UL)    /* default image base */
#define PE_OBJECT_ALIGN (64UL*1024)     /* default object alignment */
#define PE_FILE_ALIGN   (0x200U)        /* default file alignment */

/* OS major/minor version numbers */
#define PE_OS_MAJOR     1
#define PE_OS_MINOR     0
/* Subsystem major/minor version numbers */
#define PE_SS_MAJOR     0
#define PE_SS_MINOR     0

/* SUBSYSTEM field values */
enum {
        PE_SS_UNKNOWN           = 0x0000,
        PE_SS_NATIVE            = 0x0001,
        PE_SS_WINDOWS_GUI       = 0x0002,
        PE_SS_WINDOWS_CHAR      = 0x0003,
        PE_SS_OS2_CHAR          = 0x0005,
        PE_SS_POSIX_CHAR        = 0x0007,
        PE_SS_PL_DOSSTYLE       = 0x0042
};

/* DLL FLAGS field bit values */
enum {
        PE_DLL_PERPROC_INIT     = 0x0001,
        PE_DLL_PERPROC_TERM     = 0x0002,
        PE_DLL_PERTHRD_INIT     = 0x0004,
        PE_DLL_PERTHRD_TERM     = 0x0008
};

/* PE object table structure */
#define PE_OBJ_NAME_LEN 8
typedef struct {
    unsigned_8          name[PE_OBJ_NAME_LEN];
    unsigned_32         virtual_size;
    pe_va               rva;
    unsigned_32         physical_size;
    unsigned_32         physical_offset;
    unsigned_32         relocs_rva;
    unsigned_32         linnum_rva;
    unsigned_16         num_relocs;
    unsigned_16         num_linnums;
    unsigned_32         flags;
} pe_object;

/* object table flag field bit values */
#define PE_OBJ_DUMMY            0x00000001UL    // reserved
#define PE_OBJ_NOLOAD           0x00000002UL
#define PE_OBJ_GROUPED          0x00000004UL    // for 16-bit offset code
#define PE_OBJ_NOPAD            0x00000008UL    // don't pad sect to next bndry
#define PE_OBJ_TYPE_COPY        0x00000010UL    // reserved
#define PE_OBJ_CODE             0x00000020UL
#define PE_OBJ_INIT_DATA        0x00000040UL
#define PE_OBJ_UNINIT_DATA      0x00000080UL
#define PE_OBJ_OTHER            0x00000100UL    // reserved
#define PE_OBJ_LINK_INFO        0x00000200UL    // contains link information
#define PE_OBJ_OVERLAY          0x00000400UL    // contains an overlay
#define PE_OBJ_REMOVE           0x00000800UL
#define PE_OBJ_COMDAT           0x00001000UL    // comdat section
#define PE_OBJ_ALIGN_1          0x00100000UL
#define PE_OBJ_ALIGN_2          0x00200000UL
#define PE_OBJ_ALIGN_4          0x00300000UL
#define PE_OBJ_ALIGN_8          0x00400000UL
#define PE_OBJ_ALIGN_16         0x00500000UL
#define PE_OBJ_ALIGN_32         0x00600000UL
#define PE_OBJ_ALIGN_64         0x00700000UL
#define PE_OBJ_DISCARDABLE      0x02000000UL
#define PE_OBJ_NOT_CACHED       0x04000000UL
#define PE_OBJ_NOT_PAGABLE      0x08000000UL
#define PE_OBJ_SHARED           0x10000000UL
#define PE_OBJ_EXECUTABLE       0x20000000UL
#define PE_OBJ_READABLE         0x40000000UL
#define PE_OBJ_WRITABLE         0x80000000UL

#define PE_OBJ_ALIGN_MASK       0x00700000UL
#define PE_OBJ_ALIGN_SHIFT      20

/* PE export directory table structure */
typedef struct {
    unsigned_32         flags;
    unsigned_32         time_stamp;
    unsigned_16         major;
    unsigned_16         minor;
    pe_va               name_rva;
    unsigned_32         ordinal_base;
    unsigned_32         num_eat_entries;
    unsigned_32         num_name_ptrs;
    pe_va               address_table_rva;
    pe_va               name_ptr_table_rva;
    pe_va               ordinal_table_rva;
} pe_export_directory;


/* PE import directory table structure */
typedef struct {
    pe_va               import_lookup_table_rva;        /* was flags */
    unsigned_32         time_stamp;
    unsigned_16         major;
    unsigned_16         minor;
    pe_va               name_rva;
    pe_va               import_address_table_rva;
} pe_import_directory;

/* bit flags for the import address table */
#define PE_IMPORT_BY_NAME       0x00000000UL
#define PE_IMPORT_BY_ORDINAL    0x80000000UL

/* PE import hint-name table structure */
typedef struct {
    unsigned_16         hint;
    unsigned_8          name[2]; /* variable size, padded to even boundry */
} pe_hint_name_entry;

#define PE_HINT_DEFAULT         0

/* PE fixup table structure */
typedef unsigned_16     pe_fixup_entry;

typedef struct {
    pe_va               page_rva;
    unsigned_32         block_size;
/*  pe_fixup_entry      fixups[] */     /* variable size */
} pe_fixup_header;

#define PEUP 12


typedef struct {
    pe_va       virt_addr;
    unsigned_32 value;
    unsigned_16 type;
    unsigned_16 pad;
} old_pe_fixup_entry;

#define OLD_PEUP 0

/* PE fixup types (stashed in 4 high bits of a pe_fixup_entry) */
#define PE_FIX_ABS      (0x0<<PEUP)     /* absolute, skipped */
#define PE_FIX_HIGH     (0x1<<PEUP)     /* add high 16 of delta */
#define PE_FIX_LOW      (0x2<<PEUP)     /* add low 16 of delta */
#define PE_FIX_HIGHLOW  (0x3<<PEUP)     /* add all 32 bits of delta */
#define PE_FIX_HIGHADJ  (0x4<<PEUP)     /* see the doc */
#define PE_FIX_MIPSJMP  (0x5<<PEUP)     /* see the doc */

/* PE fixup types (stashed in 4 high bits of a pe_fixup_entry) */
#define OLD_PE_FIX_ABS          (0x0<<OLD_PEUP) /* absolute, skipped */
#define OLD_PE_FIX_HIGH         (0x1<<OLD_PEUP) /* add high 16 of delta */
#define OLD_PE_FIX_LOW          (0x2<<OLD_PEUP) /* add low 16 of delta */
#define OLD_PE_FIX_HIGHLOW      (0x3<<OLD_PEUP) /* add all 32 bits of delta */
#define OLD_PE_FIX_HIGHADJ      (0x4<<OLD_PEUP) /* see the doc */
#define OLD_PE_FIX_MIPSJMP      (0x5<<OLD_PEUP) /* see the doc */

/* PE debug directory structure */
#define DEBUG_TYPE_UNKNOWN    0
#define DEBUG_TYPE_COFF       1
#define DEBUG_TYPE_CODEVIEW   2
typedef struct {
   unsigned_32          flags;
   unsigned_32          time_stamp;
   unsigned_16          major;
   unsigned_16          minor;
   unsigned_32          debug_type;
   unsigned_32          debug_size;
   pe_va                data_rva;
   unsigned_32          data_seek;
} debug_directory;

/* procedure descriptor format for alpha and powerpc */

typedef struct {
    unsigned_32 beginaddress;
    unsigned_32 endaddress;
    unsigned_32 exceptionhandler;
    unsigned_32 handlerdata;
    unsigned_32 prologendaddress;
} procedure_descriptor;

/* PE resource directory structure */
typedef struct {
    unsigned_32         flags;
    unsigned_32         time_stamp;
    unsigned_16         major;
    unsigned_16         minor;
    unsigned_16         num_name_entries;
    unsigned_16         num_id_entries;
} resource_dir_header;

/*
A resource directory is a resource_dir_header followed immediately by
(num_name_entries + num_id_entries) resource_dir_entry's. The entries are
ordered sorted name entries then sorted id entries.
*/

typedef struct {
    unsigned_32         id_name;        /* see below */
    pe_va               entry_rva;      /* see below */
} resource_dir_entry;
#define PE_RESOURCE_MASK    0x7fffffff
#define PE_RESOURCE_MASK_ON 0x80000000

/*
If id_name & PE_RESOURCE_MASK_ON then id_name & PE_RESOURCE_MASK is a rva
(relative to the start of the resource object) to the name string otherwise
it is an integer id. The name string is an unsigned_16 length followed by a
unicode string of that length.

If entry_rva & PE_RESOURCE_MASK_ON the entry_rva & PE_RESOURCE_MASK is a rva
(relative to the start of the resource object) to another resource directory
otherwise it is a rva to a resource_entry.
*/

typedef struct {
    unsigned_32     data_rva;       /* relative to Image Base */
    unsigned_32     size;
    unsigned_32     code_page;
    unsigned_32     rsvd;           /* must be 0 */
} resource_entry;

#define _EXEPE_H
#endif