arm.h revision 60484
1/* ARM COFF support for BFD.
2   Copyright (C) 1998, 1999 Free Software Foundation, Inc.
3
4   This file is part of BFD, the Binary File Descriptor library.
5
6   This program is free software; you can redistribute it and/or modify
7   it under the terms of the GNU General Public License as published by
8   the Free Software Foundation; either version 2 of the License, or
9   (at your option) any later version.
10
11   This program is distributed in the hope that it will be useful,
12   but WITHOUT ANY WARRANTY; without even the implied warranty of
13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14   GNU General Public License for more details.
15
16   You should have received a copy of the GNU General Public License
17   along with this program; if not, write to the Free Software Foundation,
18   Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
19
20#define COFFARM 1
21
22/********************** FILE HEADER **********************/
23
24struct external_filehdr
25{
26	char f_magic[2];	/* magic number			*/
27	char f_nscns[2];	/* number of sections		*/
28	char f_timdat[4];	/* time & date stamp		*/
29	char f_symptr[4];	/* file pointer to symtab	*/
30	char f_nsyms[4];	/* number of symtab entries	*/
31	char f_opthdr[2];	/* sizeof(optional hdr)		*/
32	char f_flags[2];	/* flags			*/
33};
34
35/* Bits for f_flags:
36 *	F_RELFLG	relocation info stripped from file
37 *	F_EXEC		file is executable (no unresolved external references)
38 *	F_LNNO		line numbers stripped from file
39 *	F_LSYMS		local symbols stripped from file
40 *      F_INTERWORK     file supports switching between ARM and Thumb instruction sets
41 *      F_INTERWORK_SET the F_INTERWORK bit is valid
42 *	F_APCS_FLOAT	code passes float arguments in float registers
43 *	F_PIC		code is reentrant/position-independent
44 *	F_AR32WR	file has byte ordering of an AR32WR machine (e.g. vax)
45 *	F_APCS_26	file uses 26 bit ARM Procedure Calling Standard
46 *	F_APCS_SET	the F_APCS_26, F_APCS_FLOAT and F_PIC bits have been initialised
47 *	F_SOFT_FLOAT	code does not use floating point instructions
48 */
49
50#define F_RELFLG	(0x0001)
51#define F_EXEC		(0x0002)
52#define F_LNNO		(0x0004)
53#define F_LSYMS		(0x0008)
54#define F_INTERWORK	(0x0010)
55#define F_INTERWORK_SET	(0x0020)
56#define F_APCS_FLOAT	(0x0040)
57#undef  F_AR16WR
58#define F_PIC		(0x0080)
59#define	F_AR32WR	(0x0100)
60#define F_APCS_26	(0x0400)
61#define F_APCS_SET	(0x0800)
62#define F_SOFT_FLOAT	(0x2000)
63
64/* Bits stored in flags field of the internal_f structure */
65
66#define F_INTERWORK	(0x0010)
67#define F_APCS_FLOAT	(0x0040)
68#define F_PIC		(0x0080)
69#define F_APCS26	(0x1000)
70#define F_ARM_ARCHITECTURE_MASK (0x4000+0x0800+0x0400)
71#define F_ARM_2		(0x0400)
72#define F_ARM_2a	(0x0800)
73#define F_ARM_3		(0x0c00)
74#define F_ARM_3M	(0x4000)
75#define F_ARM_4		(0x4400)
76#define F_ARM_4T	(0x4800)
77#define F_ARM_5		(0x4c00)
78
79/*
80 * ARMMAGIC ought to encoded the procesor type,
81 * but it is too late to change it now, instead
82 * the flags field of the internal_f structure
83 * is used as shown above.
84 *
85 * XXX - NC 5/6/97
86 */
87
88#define	ARMMAGIC	0xa00  /* I just made this up */
89
90#define ARMBADMAG(x) (((x).f_magic != ARMMAGIC))
91
92#define	ARMPEMAGIC	0x1c0
93#define	THUMBPEMAGIC	0x1c2
94
95#undef  ARMBADMAG
96#define ARMBADMAG(x) (((x).f_magic != ARMMAGIC) && ((x).f_magic != ARMPEMAGIC) && ((x).f_magic != THUMBPEMAGIC))
97
98#define	FILHDR	struct external_filehdr
99#define	FILHSZ	20
100
101
102/********************** AOUT "OPTIONAL HEADER" **********************/
103
104
105typedef struct
106{
107  char 	magic[2];		/* type of file				*/
108  char	vstamp[2];		/* version stamp			*/
109  char	tsize[4];		/* text size in bytes, padded to FW bdry*/
110  char	dsize[4];		/* initialized data "  "		*/
111  char	bsize[4];		/* uninitialized data "   "		*/
112  char	entry[4];		/* entry pt.				*/
113  char 	text_start[4];		/* base of text used for this file */
114  char 	data_start[4];		/* base of data used for this file */
115}
116AOUTHDR;
117
118
119#define AOUTSZ 28
120#define AOUTHDRSZ 28
121
122#define OMAGIC          0404    /* object files, eg as output */
123#define ZMAGIC          0413    /* demand load format, eg normal ld output */
124#define STMAGIC		0401	/* target shlib */
125#define SHMAGIC		0443	/* host   shlib */
126
127
128/* define some NT default values */
129/*  #define NT_IMAGE_BASE        0x400000 moved to internal.h */
130#define NT_SECTION_ALIGNMENT 0x1000
131#define NT_FILE_ALIGNMENT    0x200
132#define NT_DEF_RESERVE       0x100000
133#define NT_DEF_COMMIT        0x1000
134
135/********************** SECTION HEADER **********************/
136struct external_scnhdr
137{
138	char		s_name[8];	/* section name			*/
139	char		s_paddr[4];	/* physical address, aliased s_nlib */
140	char		s_vaddr[4];	/* virtual address		*/
141	char		s_size[4];	/* section size			*/
142	char		s_scnptr[4];	/* file ptr to raw data for section */
143	char		s_relptr[4];	/* file ptr to relocation	*/
144	char		s_lnnoptr[4];	/* file ptr to line numbers	*/
145	char		s_nreloc[2];	/* number of relocation entries	*/
146	char		s_nlnno[2];	/* number of line number entries*/
147	char		s_flags[4];	/* flags			*/
148};
149
150#define	SCNHDR	struct external_scnhdr
151#define	SCNHSZ	40
152
153/*
154 * names of "special" sections
155 */
156#define _TEXT	".text"
157#define _DATA	".data"
158#define _BSS	".bss"
159#define _COMMENT ".comment"
160#define _LIB ".lib"
161
162/* We use the .rdata section to hold read only data.  */
163#define _LIT	".rdata"
164
165/********************** LINE NUMBERS **********************/
166
167/* 1 line number entry for every "breakpointable" source line in a section.
168 * Line numbers are grouped on a per function basis; first entry in a function
169 * grouping will have l_lnno = 0 and in place of physical address will be the
170 * symbol table index of the function name.
171 */
172struct external_lineno
173{
174	union
175	{
176		char l_symndx[4];	/* function name symbol index, iff l_lnno == 0*/
177		char l_paddr[4];	/* (physical) address of line number	*/
178	} l_addr;
179	char l_lnno[2];	/* line number		*/
180};
181
182
183#define	LINENO	struct external_lineno
184#define	LINESZ	6
185
186
187/********************** SYMBOLS **********************/
188
189#define E_SYMNMLEN	8	/* # characters in a symbol name	*/
190#define E_FILNMLEN	14	/* # characters in a file name		*/
191#define E_DIMNUM	4	/* # array dimensions in auxiliary entry */
192
193struct external_syment
194{
195  union
196  {
197    char e_name[E_SYMNMLEN];
198    struct
199    {
200      char e_zeroes[4];
201      char e_offset[4];
202    } e;
203  } e;
204  char e_value[4];
205  char e_scnum[2];
206  char e_type[2];
207  char e_sclass[1];
208  char e_numaux[1];
209};
210
211#define N_BTMASK	(0xf)
212#define N_TMASK		(0x30)
213#define N_BTSHFT	(4)
214#define N_TSHIFT	(2)
215
216union external_auxent
217{
218	struct
219	{
220		char x_tagndx[4];	/* str, un, or enum tag indx */
221		union
222		{
223			struct
224			{
225			    char  x_lnno[2]; /* declaration line number */
226			    char  x_size[2]; /* str/union/array size */
227			} x_lnsz;
228			char x_fsize[4];	/* size of function */
229		} x_misc;
230		union
231		{
232			struct 			/* if ISFCN, tag, or .bb */
233			{
234			    char x_lnnoptr[4];	/* ptr to fcn line # */
235			    char x_endndx[4];	/* entry ndx past block end */
236			} x_fcn;
237			struct 			/* if ISARY, up to 4 dimen. */
238			{
239			    char x_dimen[E_DIMNUM][2];
240			} x_ary;
241		} x_fcnary;
242		char x_tvndx[2];		/* tv index */
243	} x_sym;
244
245	union
246	{
247		char x_fname[E_FILNMLEN];
248		struct
249		{
250			char x_zeroes[4];
251			char x_offset[4];
252		} x_n;
253	} x_file;
254
255	struct
256	{
257		char x_scnlen[4];	/* section length */
258		char x_nreloc[2];	/* # relocation entries */
259		char x_nlinno[2];	/* # line numbers */
260		char x_checksum[4];	/* section COMDAT checksum */
261		char x_associated[2];	/* COMDAT associated section index */
262		char x_comdat[1];	/* COMDAT selection number */
263	} x_scn;
264
265        struct
266	{
267		char x_tvfill[4];	/* tv fill value */
268		char x_tvlen[2];	/* length of .tv */
269		char x_tvran[2][2];	/* tv range */
270	} x_tv;		/* info about .tv section (in auxent of symbol .tv)) */
271};
272
273#define	SYMENT	struct external_syment
274#define	SYMESZ	18
275#define	AUXENT	union external_auxent
276#define	AUXESZ	18
277
278#define _ETEXT	"etext"
279
280/********************** RELOCATION DIRECTIVES **********************/
281#ifdef ARM_WINCE
282struct external_reloc
283{
284  char r_vaddr[4];
285  char r_symndx[4];
286  char r_type[2];
287};
288
289#define RELOC struct external_reloc
290#define RELSZ 10
291
292#else
293struct external_reloc
294{
295  char r_vaddr[4];
296  char r_symndx[4];
297  char r_type[2];
298  char r_offset[4];
299};
300
301#define RELOC struct external_reloc
302#define RELSZ 14
303#endif
304