xref: /linux/arch/powerpc/boot/rs6000.h (revision ab93e0dd72c37d378dd936f031ffb83ff2bd87ce)
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 
9 struct 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 
35 typedef 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 }
60 AOUTHDR;
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 
74 struct 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  */
116 struct 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 
135 struct 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 
159 union 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 
225 struct 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
241