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