ref: 330cfd2833ed695dac4462c0035925e2187d17fe
dir: /src/libmach/coff32/coff-help.h/
/* ****************************************************************** ** 29K COFF Declarations ** ** ** ** ** ** This file contains the declarations required to define ** ** the COFF format as proposed for use by AMD for the 29K ** ** family of RISC microprocessors. ** ** ** ** No attempt is made here to describe in detail those portions ** ** of COFF which have not been modified or extended. Pertinent ** ** #define's and struct's are included for completeness. Those ** ** declarations are distributed in several System V headers. ** ** ** ** For a better and more complete description of COFF with ** ** general and 29K Family specific clarifications, see the ** ** AMD's "Programmer's Guide to the Common Object File Format ** ** (COFF) for the Am29000" Application Note, order number 11963.** ** ** ** For non-29K-Family specific COFF information, consult AT&T ** ** UNIX System V Release 3, Programmer's Guide, Chapter 11 ** ** (Manual 307-225, Issue 1). ** ** ** ** ** ** Revision history: ** ** ** ** 0.01 JG - first published ** ** 0.02 JG - added relocation type R_IFAR and renumbered ** ** 0.03 RC - COFF spec now compiles without error ** ** 0.04 RC - removed R_IPAIR and R_IFAR and renumbered ** ** 0.05 RC - added R_HWORD relocation type ** ** 0.06 RC - section types ** ** changed value of STYP_BSSREG ** ** replaced STYP_RDATA and STYP_IDATA ** ** with STYP_LIT, STYP_ABS, and STYP_ENVIR ** ** - relocation types ** ** added R_IABS ** ** replaced R_IBYTE with R_BYTE and renumbered ** ** - changed comments and removed comments ** ** 0.07 RC - relocation types ** ** Added R_IHCONST to support relocation offsets ** ** for CONSTH instruction. Added commentary, ** ** and renumbered to make room for R_IHCONST, ** ** putting the (as yet unused) global reloc ** ** types at the end. ** ** - bug fix (typo) ** ** Added slash to terminate comment field on ** ** C_EXT so now C_STAT is defined. ** ** 0.08 RC - official magic numbers assigned by AT&T. ** ** 0.09 RC - support multiple address spaces by adding magic ** ** a.out header numbers SASMAGIC and MASMAGIC. ** ** 0.10 RC - No changes. Just added the comments below and ** ** corrected comments on tsize, dsize, and bsize. ** ** - All portions of the COFF file described as C ** ** structs must use Host Endian byte ordering. ** ** Files created on a machine with a byte ** ** ordering different from the host may be ** ** converted using the UNIX conv(1) command. ** ** - Assemblers and compilers must create section ** ** headers for .text, .data, and .bss (in that ** ** order) even if they are 0 length. ** ** - tsize, dsize, and bsize are the size of .text, ** ** .data, and .bss respectively. Other sections ** ** of type STYP_TEXT, STYP_DATA, and STYP_BSS ** ** are not included in the byte count. ** ** - Assemblers and compilers must create output ** ** sections to the exact byte length (and not ** ** round them up). The linker will take care ** ** of rounding. ** ** 2.1.01 - Added C_STARTOF storage class for support of ** ** assembler $startof(sect_name) and ** ** $sizeof(sect_name) operators. ** ** 2.1.02 - Added a few more defines for completeness. ** ** 2.1.03 - Added more magic numbers for completeness. ** ****************************************************************** */ /* ** Overall structure of a COFF file */ /* *--------------------------------* | File Header | ---------------------------------- | Optional Information | ---------------------------------- | Section 1 Header | ---------------------------------- | ... | ---------------------------------- | Section n Header | ---------------------------------- | Raw Data for Section 1 | ---------------------------------- | ... | ---------------------------------- | Raw Data for Section n | ---------------------------------- | Relocation Info for Section 1 | ---------------------------------- | ... | ---------------------------------- | Relocation Info for Section n | ---------------------------------- | Line Numbers for Section 1 | ---------------------------------- | ... | ---------------------------------- | Line Numbers for Section n | ---------------------------------- | Symbol Table | ---------------------------------- | String Table | *--------------------------------* */ /****************************************************************/ /* ** File Header and related definitions */ struct filehdr { unsigned short f_magic; /* magic number */ unsigned short f_nscns; /* number of sections */ long f_timdat; /* time & date stamp */ long f_symptr; /* file pointer to symtab */ long f_nsyms; /* number of symtab entries */ unsigned short f_opthdr; /* sizeof(optional hdr) */ unsigned short f_flags; /* flags */ }; #define FILHDR struct filehdr #define FILHSZ sizeof (FILHDR) /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ /* ** Magic numbers currently known to us, ** Plus 29K magic numbers assigned by AT&T. */ #define M68MAGIC 0210 #define M68TVMAGIC 0211 #define B16MAGIC 0502 #define BTVMAGIC 0503 #define IAPX16 0504 #define IAPX16TV 0505 #define IAPX20 0506 #define IAPX20TV 0507 #define X86MAGIC 0510 #define XTVMAGIC 0511 #define I286SMAGIC 0512 #define I386MAGIC 0514 #define MC68MAGIC 0520 #define MC68KWRMAGIC 0520 /* 68K writeable text sections */ #define MC68TVMAGIC 0521 #define MC68KPGMAGIC 0522 /* 68K demand paged text (shared with i286) */ #define I286LMAGIC 0522 /* i286 (shared with 68K) */ /* 0524 * reserved for NSC */ /* 0525 * reserved for NSC */ /* 0544 * reserved for Zilog */ /* 0545 * reserved for Zilog */ #define N3BMAGIC 0550 /* 3B20S executable, no TV */ #define NTVMAGIC 0551 /* 3B20 executable with TV */ #define FBOMAGIC 0560 /* WE*-32 (Forward Byte Ordering) */ #define WE32MAGIC 0560 /* WE 32000, no TV */ #define MTVMAGIC 0561 /* WE 32000 with TV */ #define RBOMAGIC 0562 /* WE-32 (Reverse Byte Ordering) */ #define VAXWRMAGIC 0570 /* VAX-11/750 and VAX-11/780 */ /* (writable text sections) */ #define VAXROMAGIC 0575 /* VAX-11/750 and VAX-11780 */ /* (read-only text sections) */ #define U370WRMAGIC 0530 /* IBM 370 (writable text sections) */ #define AMDWRMAGIC 0531 /* Amdahl 470/580 writable text sections */ #define AMDROMAGIC 0534 /* Amdahl 470/580 read only sharable text */ #define U370ROMAGIC 0535 /* IBM 370 (read-only sharable text sections) */ #define SIPFBOMAGIC 0572 /* 29K Family (Byte 0 is MSB - Big Endian) */ #define SIPRBOMAGIC 0573 /* 29K Family (Byte 0 is LSB - Little Endian) */ /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ /* ** File header flags currently known to us. ** ** Am29000 will use the F_AR32WR and F_AR32W flags to indicate ** the byte ordering in the file. */ #define F_RELFLG 00001 /* Relocation information stripped */ /* from the file. */ #define F_EXEC 00002 /* File is executable (i.e. no */ /* unresolved external references). */ #define F_LNNO 00004 /* Line numbers stripped from */ /* the file. */ #define F_LSYMS 00010 /* Local symbols stripped from */ /* the file. */ #define F_MINMAL 00020 /* Not used by UNIX. */ #define F_UPDATE 00040 /* Not used by UNIX. */ #define F_SWABD 00100 /* Not used by UNIX. */ #define F_AR16WR 00200 /* File has the byte ordering used */ /* by the PDP*-11/70 processor. */ #define F_AR32WR 00400 /* File has 32 bits per word, */ /* least significant byte first. */ #define F_AR32W 01000 /* File has 32 bits per word, */ /* most significant byte first. */ #define F_PATCH 02000 /* Not used by UNIX. */ #define F_BM32BRST 0010000 /* 32100 required; has RESTORE work-around. */ #define F_BM32B 0020000 /* 32100 required. */ #define F_BM32MAU 0040000 /* MAU required. */ #define F_BM32ID 0160000 /* WE 32000 processor ID field. */ /*--------------------------------------------------------------*/ /* ** Optional (a.out) header */ typedef struct aouthdr { short magic; /* magic number */ short vstamp; /* version stamp */ long tsize; /* size of .text in bytes */ long dsize; /* size of .data (initialized data) */ long bsize; /* size of .bss (uninitialized data) */ long entry; /* entry point */ long text_start; /* base of text used for this file */ long data_start; /* base of data used for this file */ } AOUTHDR; /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ /* ** Magic a.out header numbers for cross development (non-UNIX), ** support of separate I and D address spaces. */ #define SASMAGIC 010000 /* Single Address Space */ #define MASMAGIC 020000 /* Multiple (separate I & D) Address Spaces */ /*--------------------------------------------------------------*/ /* ** Section header and related definitions */ struct scnhdr { char s_name[8]; /* section name */ long s_paddr; /* physical address */ long s_vaddr; /* virtual address */ long s_size; /* section size */ long s_scnptr; /* file ptr to raw data for section */ long s_relptr; /* file ptr to relocation */ long s_lnnoptr; /* file ptr to line numbers */ unsigned short s_nreloc; /* number of relocation entries */ unsigned short s_nlnno; /* number of line number entries */ long s_flags; /* flags */ }; #define SCNHDR struct scnhdr #define SCNHSZ sizeof (SCNHDR) /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ /* ** Section types - with additional section type for global ** registers which will be relocatable for the Am29000. ** ** In instances where it is necessary for a linker to produce an ** output file which contains text or data not based at virtual ** address 0, e.g. for a ROM, then the linker should accept ** address base information as command input and use PAD sections ** to skip over unused addresses. */ #define STYP_REG 0x00 /* Regular section (allocated, */ /* relocated, loaded) */ #define STYP_DSECT 0x01 /* Dummy section (not allocated, */ /* relocated, not loaded) */ #define STYP_NOLOAD 0x02 /* Noload section (allocated, */ /* relocated, not loaded) */ #define STYP_GROUP 0x04 /* Grouped section (formed from */ /* input sections) */ #define STYP_PAD 0x08 /* Padded section (not allocated, */ /* not relocated, loaded) */ #define STYP_COPY 0x10 /* Copy section (for a decision */ /* function used in updating fields; */ /* not allocated, not relocated, */ /* loaded, relocation and line */ /* number entries processed */ /* normally) */ #define STYP_TEXT 0x20 /* Section contains executable text */ #define STYP_DATA 0x40 /* Section contains initialized data */ #define STYP_BSS 0x80 /* Section contains only uninitialized data */ #define STYP_INFO 0x200 /* Comment section (not allocated, */ /* not relocated, not loaded) */ #define STYP_OVER 0x400 /* Overlay section (relocated, */ /* not allocated, not loaded) */ #define STYP_LIB 0x800 /* For .lib section (like STYP_INFO) */ #define STYP_BSSREG 0x1200 /* Global register area (like STYP_INFO) */ #define STYP_ENVIR 0x2200 /* Environment (like STYP_INFO) */ #define STYP_ABS 0x4000 /* Absolute (allocated, not reloc, loaded) */ #define STYP_LIT 0x8020 /* Literal data (like STYP_TEXT) */ /* NOTE: The use of STYP_BSSREG for relocation is not yet defined. */ /*--------------------------------------------------------------*/ /* ** Relocation information declaration and related definitions */ struct reloc { long r_vaddr; /* (virtual) address of reference */ long r_symndx; /* index into symbol table */ unsigned short r_type; /* relocation type */ }; #define RELOC struct reloc #define RELSZ 10 /* sizeof (RELOC) */ /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ /* ** Relocation types for the Am29000 */ #define R_ABS 0 /* reference is absolute */ #define R_IREL 030 /* instruction relative (jmp/call) */ #define R_IABS 031 /* instruction absolute (jmp/call) */ #define R_ILOHALF 032 /* instruction low half (const) */ #define R_IHIHALF 033 /* instruction high half (consth) part 1 */ #define R_IHCONST 034 /* instruction high half (consth) part 2 */ /* constant offset of R_IHIHALF relocation */ #define R_BYTE 035 /* relocatable byte value */ #define R_HWORD 036 /* relocatable halfword value */ #define R_WORD 037 /* relocatable word value */ #define R_IGLBLRC 040 /* instruction global register RC */ #define R_IGLBLRA 041 /* instruction global register RA */ #define R_IGLBLRB 042 /* instruction global register RB */ /* NOTE: All the "I" forms refer to Am29000 instruction formats. The linker is expected to know how the numeric information is split and/or aligned within the instruction word(s). R_BYTE works for instructions, too. If the parameter to a CONSTH instruction is a relocatable type, two relocation records are written. The first has an r_type of R_IHIHALF (33 octal) and a normal r_vaddr and r_symndx. The second relocation record has an r_type of R_IHCONST (34 octal), a normal r_vaddr (which is redundant), and an r_symndx containing the 32-bit constant offset to the relocation instead of the actual symbol table index. This second record is always written, even if the constant offset is zero. The constant fields of the instruction are set to zero. */ /*--------------------------------------------------------------*/ /* ** Line number entry declaration and related definitions */ struct lineno { union { long l_symndx; /* sym table index of function name */ long l_paddr; /* (physical) address of line number */ } l_addr; unsigned short l_lnno; /* line number */ }; #define LINENO struct lineno #define LINESZ 6 /* sizeof (LINENO) */ /*--------------------------------------------------------------*/ /* ** Symbol entry declaration and related definitions */ #define SYMNMLEN 8 /* Number of characters in a symbol name */ struct syment { union { char _n_name [SYMNMLEN]; /* symbol name */ struct { long _n_zeroes; /* symbol name */ long _n_offset; /* offset into string table */ } _n_n; char *_n_nptr[2]; /* allows for overlaying */ } _n; #ifndef pdp11 unsigned #endif long n_value; /* value of symbol */ short n_scnum; /* section number */ unsigned short n_type; /* type and derived type */ char n_sclass; /* storage class */ char n_numaux; /* number of aux entries */ }; #define n_name _n._n_name #define n_nptr _n._n_nptr[1] #define n_zeroes _n._n_n._n_zeroes #define n_offset _n._n_n._n_offset #define SYMENT struct syment #define SYMESZ 18 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ /* ** Storage class definitions - new classes for global registers. */ #define C_EFCN -1 /* physical end of a function */ #define C_NULL 0 /* - */ #define C_AUTO 1 /* automatic variable */ #define C_EXT 2 /* external symbol */ #define C_STAT 3 /* static */ #define C_REG 4 /* (local) register variable */ #define C_EXTDEF 5 /* external definition */ #define C_LABEL 6 /* label */ #define C_ULABEL 7 /* undefined label */ #define C_MOS 8 /* member of structure */ #define C_ARG 9 /* function argument */ #define C_STRTAG 10 /* structure tag */ #define C_MOU 11 /* member of union */ #define C_UNTAG 12 /* union tag */ #define C_TPDEF 13 /* type definition */ #define C_UNSTATIC 14 /* uninitialized static */ #define C_USTATIC 14 /* uninitialized static */ #define C_ENTAG 15 /* enumeration tag */ #define C_MOE 16 /* member of enumeration */ #define C_REGPARM 17 /* register parameter */ #define C_FIELD 18 /* bit field */ #define C_GLBLREG 19 /* global register */ #define C_EXTREG 20 /* external global register */ #define C_DEFREG 21 /* ext. def. of global register */ #define C_STARTOF 22 /* as29 $SIZEOF and $STARTOF symbols */ #define C_BLOCK 100 /* beginning and end of block */ #define C_FCN 101 /* beginning and end of function */ #define C_EOS 102 /* end of structure */ #define C_FILE 103 /* file name */ #define C_LINE 104 /* used only by utility programs */ #define C_ALIAS 105 /* duplicated tag */ #define C_HIDDEN 106 /* like static, used to avoid name */ /* conflicts */ #define C_SHADOW 107 /* shadow symbol */ /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ /* ** Special section number definitions used in symbol entries. ** (Section numbers 1-65535 are used to indicate the section ** where the symbol was defined.) */ #define N_DEBUG -2 /* special symbolic debugging symbol */ #define N_ABS -1 /* absolute symbol */ #define N_UNDEF 0 /* undefined external symbol */ #define N_SCNUM 1-65535 /* section num where symbol defined */ /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ /* ** Fundamental symbol types. */ #define T_NULL 0 /* type not assigned */ #define T_VOID 1 /* void */ #define T_CHAR 2 /* character */ #define T_SHORT 3 /* short integer */ #define T_INT 4 /* integer */ #define T_LONG 5 /* long integer */ #define T_FLOAT 6 /* floating point */ #define T_DOUBLE 7 /* double word */ #define T_STRUCT 8 /* structure */ #define T_UNION 9 /* union */ #define T_ENUM 10 /* enumeration */ #define T_MOE 11 /* member of enumeration */ #define T_UCHAR 12 /* unsigned character */ #define T_USHORT 13 /* unsigned short */ #define T_UINT 14 /* unsigned integer */ #define T_ULONG 15 /* unsigned long */ /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ /* ** Derived symbol types. */ #define DT_NON 0 /* no derived type */ #define DT_PTR 1 /* pointer */ #define DT_FCN 2 /* function */ #define DT_ARY 3 /* array */ /*--------------------------------------------------------------*/ /* ** Auxiliary symbol table entry declaration and related ** definitions. */ #define FILNMLEN 14 /* Number of characters in a file name */ #define DIMNUM 4 /* Number of array dimensions in auxiliary entry */ union auxent { struct { long x_tagndx; /* str, un, or enum tag indx */ union { struct { unsigned short x_lnno; /* declaration line number */ unsigned short x_size; /* str, union, array size */ } x_lnsz; long x_size; /* size of functions */ } x_misc; union { struct /* if ISFCN, tag, or .bb */ { long x_lnnoptr; /* ptr to fcn line # */ long x_endndx; /* entry ndx past block end */ } x_fcn; struct /* if ISARY, up to 4 dimen */ { unsigned short x_dimen[DIMNUM]; } x_ary; } x_fcnary; unsigned short x_tvndx; /* tv index */ } x_sym; struct { char x_fname[FILNMLEN]; } x_file; struct { long x_scnlen; /* section length */ unsigned short x_nreloc; /* number of relocation entries */ unsigned short x_nlinno; /* number of line numbers */ } x_scn; struct { long x_tvfill; /* tv fill value */ unsigned short x_tvlen; /* length of tv */ unsigned short x_tvrna[2]; /* tv range */ } x_tv; /* info about tv section (in auxent of symbol tv)) */ }; #define AUXENT union auxent #define AUXESZ 18 /* sizeof(AUXENT) */ </pre></div></body></html>