| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* IBM RS/6000 "XCOFF" file definitions for BFD. | 
 | 2 |    Copyright (C) 1990, 1991 Free Software Foundation, Inc. | 
 | 3 |    FIXME: Can someone provide a transliteration of this name into ASCII? | 
 | 4 |    Using the following chars caused a compiler warning on HIUX (so I replaced | 
 | 5 |    them with octal escapes), and isn't useful without an understanding of what | 
 | 6 |    character set it is. | 
 | 7 |    Written by Mimi Ph\373\364ng-Th\345o V\365 of IBM | 
 | 8 |    and John Gilmore of Cygnus Support.  */ | 
 | 9 |  | 
 | 10 | /********************** FILE HEADER **********************/ | 
 | 11 |  | 
 | 12 | struct external_filehdr { | 
 | 13 | 	char f_magic[2];	/* magic number			*/ | 
 | 14 | 	char f_nscns[2];	/* number of sections		*/ | 
 | 15 | 	char f_timdat[4];	/* time & date stamp		*/ | 
 | 16 | 	char f_symptr[4];	/* file pointer to symtab	*/ | 
 | 17 | 	char f_nsyms[4];	/* number of symtab entries	*/ | 
 | 18 | 	char f_opthdr[2];	/* sizeof(optional hdr)		*/ | 
 | 19 | 	char f_flags[2];	/* flags			*/ | 
 | 20 | }; | 
 | 21 |  | 
 | 22 |         /* IBM RS/6000 */ | 
 | 23 | #define U802WRMAGIC     0730    /* writeable text segments **chh**      */ | 
 | 24 | #define U802ROMAGIC     0735    /* readonly sharable text segments      */ | 
 | 25 | #define U802TOCMAGIC    0737    /* readonly text segments and TOC       */ | 
 | 26 |  | 
 | 27 | #define BADMAG(x)	\ | 
 | 28 | 	((x).f_magic != U802ROMAGIC && (x).f_magic != U802WRMAGIC && \ | 
 | 29 | 	 (x).f_magic != U802TOCMAGIC) | 
 | 30 |  | 
 | 31 | #define	FILHDR	struct external_filehdr | 
 | 32 | #define	FILHSZ	20 | 
 | 33 |  | 
 | 34 |  | 
 | 35 | /********************** AOUT "OPTIONAL HEADER" **********************/ | 
 | 36 |  | 
 | 37 |  | 
 | 38 | typedef struct | 
 | 39 | { | 
 | 40 |   unsigned char	magic[2];	/* type of file			*/ | 
 | 41 |   unsigned char	vstamp[2];	/* version stamp		*/ | 
 | 42 |   unsigned char	tsize[4];	/* text size in bytes, padded to FW bdry */ | 
 | 43 |   unsigned char	dsize[4];	/* initialized data "  "	*/ | 
 | 44 |   unsigned char	bsize[4];	/* uninitialized data "   "	*/ | 
 | 45 |   unsigned char	entry[4];	/* entry pt.			*/ | 
 | 46 |   unsigned char	text_start[4];	/* base of text used for this file */ | 
 | 47 |   unsigned char	data_start[4];	/* base of data used for this file */ | 
 | 48 |   unsigned char	o_toc[4];	/* address of TOC */ | 
 | 49 |   unsigned char	o_snentry[2];	/* section number of entry point */ | 
 | 50 |   unsigned char	o_sntext[2];	/* section number of .text section */ | 
 | 51 |   unsigned char	o_sndata[2];	/* section number of .data section */ | 
 | 52 |   unsigned char	o_sntoc[2];	/* section number of TOC */ | 
 | 53 |   unsigned char	o_snloader[2];	/* section number of .loader section */ | 
 | 54 |   unsigned char	o_snbss[2];	/* section number of .bss section */ | 
 | 55 |   unsigned char	o_algntext[2];	/* .text alignment */ | 
 | 56 |   unsigned char	o_algndata[2];	/* .data alignment */ | 
 | 57 |   unsigned char	o_modtype[2];	/* module type (??) */ | 
 | 58 |   unsigned char o_cputype[2];	/* cpu type */ | 
 | 59 |   unsigned char	o_maxstack[4];	/* max stack size (??) */ | 
 | 60 |   unsigned char o_maxdata[4];	/* max data size (??) */ | 
 | 61 |   unsigned char	o_resv2[12];	/* reserved */ | 
 | 62 | } | 
 | 63 | AOUTHDR; | 
 | 64 |  | 
 | 65 | #define AOUTSZ 72 | 
 | 66 | #define SMALL_AOUTSZ (28) | 
 | 67 | #define AOUTHDRSZ 72 | 
 | 68 |  | 
 | 69 | #define	RS6K_AOUTHDR_OMAGIC	0x0107	/* old: text & data writeable */ | 
 | 70 | #define	RS6K_AOUTHDR_NMAGIC	0x0108	/* new: text r/o, data r/w */ | 
 | 71 | #define	RS6K_AOUTHDR_ZMAGIC	0x010B	/* paged: text r/o, both page-aligned */ | 
 | 72 |  | 
 | 73 |  | 
 | 74 | /********************** SECTION HEADER **********************/ | 
 | 75 |  | 
 | 76 |  | 
 | 77 | struct external_scnhdr { | 
 | 78 | 	char		s_name[8];	/* section name			*/ | 
 | 79 | 	char		s_paddr[4];	/* physical address, aliased s_nlib */ | 
 | 80 | 	char		s_vaddr[4];	/* virtual address		*/ | 
 | 81 | 	char		s_size[4];	/* section size			*/ | 
 | 82 | 	char		s_scnptr[4];	/* file ptr to raw data for section */ | 
 | 83 | 	char		s_relptr[4];	/* file ptr to relocation	*/ | 
 | 84 | 	char		s_lnnoptr[4];	/* file ptr to line numbers	*/ | 
 | 85 | 	char		s_nreloc[2];	/* number of relocation entries	*/ | 
 | 86 | 	char		s_nlnno[2];	/* number of line number entries*/ | 
 | 87 | 	char		s_flags[4];	/* flags			*/ | 
 | 88 | }; | 
 | 89 |  | 
 | 90 | /* | 
 | 91 |  * names of "special" sections | 
 | 92 |  */ | 
 | 93 | #define _TEXT	".text" | 
 | 94 | #define _DATA	".data" | 
 | 95 | #define _BSS	".bss" | 
 | 96 | #define _PAD	".pad" | 
 | 97 | #define _LOADER	".loader" | 
 | 98 |  | 
 | 99 | #define	SCNHDR	struct external_scnhdr | 
 | 100 | #define	SCNHSZ	40 | 
 | 101 |  | 
 | 102 | /* XCOFF uses a special .loader section with type STYP_LOADER.  */ | 
 | 103 | #define STYP_LOADER 0x1000 | 
 | 104 |  | 
 | 105 | /* XCOFF uses a special .debug section with type STYP_DEBUG.  */ | 
 | 106 | #define STYP_DEBUG 0x2000 | 
 | 107 |  | 
 | 108 | /* XCOFF handles line number or relocation overflow by creating | 
 | 109 |    another section header with STYP_OVRFLO set.  */ | 
 | 110 | #define STYP_OVRFLO 0x8000 | 
 | 111 |  | 
 | 112 | /********************** LINE NUMBERS **********************/ | 
 | 113 |  | 
 | 114 | /* 1 line number entry for every "breakpointable" source line in a section. | 
 | 115 |  * Line numbers are grouped on a per function basis; first entry in a function | 
 | 116 |  * grouping will have l_lnno = 0 and in place of physical address will be the | 
 | 117 |  * symbol table index of the function name. | 
 | 118 |  */ | 
 | 119 | struct external_lineno { | 
 | 120 | 	union { | 
 | 121 | 		char l_symndx[4];	/* function name symbol index, iff l_lnno == 0*/ | 
 | 122 | 		char l_paddr[4];	/* (physical) address of line number	*/ | 
 | 123 | 	} l_addr; | 
 | 124 | 	char l_lnno[2];	/* line number		*/ | 
 | 125 | }; | 
 | 126 |  | 
 | 127 |  | 
 | 128 | #define	LINENO	struct external_lineno | 
 | 129 | #define	LINESZ	6 | 
 | 130 |  | 
 | 131 |  | 
 | 132 | /********************** SYMBOLS **********************/ | 
 | 133 |  | 
 | 134 | #define E_SYMNMLEN	8	/* # characters in a symbol name	*/ | 
 | 135 | #define E_FILNMLEN	14	/* # characters in a file name		*/ | 
 | 136 | #define E_DIMNUM	4	/* # array dimensions in auxiliary entry */ | 
 | 137 |  | 
 | 138 | struct external_syment | 
 | 139 | { | 
 | 140 |   union { | 
 | 141 |     char e_name[E_SYMNMLEN]; | 
 | 142 |     struct { | 
 | 143 |       char e_zeroes[4]; | 
 | 144 |       char e_offset[4]; | 
 | 145 |     } e; | 
 | 146 |   } e; | 
 | 147 |   char e_value[4]; | 
 | 148 |   char e_scnum[2]; | 
 | 149 |   char e_type[2]; | 
 | 150 |   char e_sclass[1]; | 
 | 151 |   char e_numaux[1]; | 
 | 152 | }; | 
 | 153 |  | 
 | 154 |  | 
 | 155 |  | 
 | 156 | #define N_BTMASK	(017) | 
 | 157 | #define N_TMASK		(060) | 
 | 158 | #define N_BTSHFT	(4) | 
 | 159 | #define N_TSHIFT	(2) | 
 | 160 |  | 
 | 161 |  | 
 | 162 | union external_auxent { | 
 | 163 | 	struct { | 
 | 164 | 		char x_tagndx[4];	/* str, un, or enum tag indx */ | 
 | 165 | 		union { | 
 | 166 | 			struct { | 
 | 167 | 			    char  x_lnno[2]; /* declaration line number */ | 
 | 168 | 			    char  x_size[2]; /* str/union/array size */ | 
 | 169 | 			} x_lnsz; | 
 | 170 | 			char x_fsize[4];	/* size of function */ | 
 | 171 | 		} x_misc; | 
 | 172 | 		union { | 
 | 173 | 			struct {		/* if ISFCN, tag, or .bb */ | 
 | 174 | 			    char x_lnnoptr[4];	/* ptr to fcn line # */ | 
 | 175 | 			    char x_endndx[4];	/* entry ndx past block end */ | 
 | 176 | 			} x_fcn; | 
 | 177 | 			struct {		/* if ISARY, up to 4 dimen. */ | 
 | 178 | 			    char x_dimen[E_DIMNUM][2]; | 
 | 179 | 			} x_ary; | 
 | 180 | 		} x_fcnary; | 
 | 181 | 		char x_tvndx[2];		/* tv index */ | 
 | 182 | 	} x_sym; | 
 | 183 |  | 
 | 184 | 	union { | 
 | 185 | 		char x_fname[E_FILNMLEN]; | 
 | 186 | 		struct { | 
 | 187 | 			char x_zeroes[4]; | 
 | 188 | 			char x_offset[4]; | 
 | 189 | 		} x_n; | 
 | 190 | 	} x_file; | 
 | 191 |  | 
 | 192 | 	struct { | 
 | 193 | 		char x_scnlen[4];			/* section length */ | 
 | 194 | 		char x_nreloc[2];	/* # relocation entries */ | 
 | 195 | 		char x_nlinno[2];	/* # line numbers */ | 
 | 196 | 	} x_scn; | 
 | 197 |  | 
 | 198 |         struct { | 
 | 199 | 		char x_tvfill[4];	/* tv fill value */ | 
 | 200 | 		char x_tvlen[2];	/* length of .tv */ | 
 | 201 | 		char x_tvran[2][2];	/* tv range */ | 
 | 202 | 	} x_tv;		/* info about .tv section (in auxent of symbol .tv)) */ | 
 | 203 |  | 
 | 204 | 	struct { | 
 | 205 | 		unsigned char x_scnlen[4]; | 
 | 206 | 		unsigned char x_parmhash[4]; | 
 | 207 | 		unsigned char x_snhash[2]; | 
 | 208 | 		unsigned char x_smtyp[1]; | 
 | 209 | 		unsigned char x_smclas[1]; | 
 | 210 | 		unsigned char x_stab[4]; | 
 | 211 | 		unsigned char x_snstab[2]; | 
 | 212 | 	} x_csect; | 
 | 213 |  | 
 | 214 | }; | 
 | 215 |  | 
 | 216 | #define	SYMENT	struct external_syment | 
 | 217 | #define	SYMESZ	18 | 
 | 218 | #define	AUXENT	union external_auxent | 
 | 219 | #define	AUXESZ	18 | 
 | 220 | #define DBXMASK 0x80		/* for dbx storage mask */ | 
 | 221 | #define SYMNAME_IN_DEBUG(symptr) ((symptr)->n_sclass & DBXMASK) | 
 | 222 |  | 
 | 223 |  | 
 | 224 |  | 
 | 225 | /********************** RELOCATION DIRECTIVES **********************/ | 
 | 226 |  | 
 | 227 |  | 
 | 228 | struct external_reloc { | 
 | 229 |   char r_vaddr[4]; | 
 | 230 |   char r_symndx[4]; | 
 | 231 |   char r_size[1]; | 
 | 232 |   char r_type[1]; | 
 | 233 | }; | 
 | 234 |  | 
 | 235 |  | 
 | 236 | #define RELOC struct external_reloc | 
 | 237 | #define RELSZ 10 | 
 | 238 |  | 
 | 239 | #define DEFAULT_DATA_SECTION_ALIGNMENT 4 | 
 | 240 | #define DEFAULT_BSS_SECTION_ALIGNMENT 4 | 
 | 241 | #define DEFAULT_TEXT_SECTION_ALIGNMENT 4 | 
 | 242 | /* For new sections we havn't heard of before */ | 
 | 243 | #define DEFAULT_SECTION_ALIGNMENT 4 |