rs6000.h

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