Adding two more people to the RELICENSING file.
[tinycc.git] / coff.h
Commit [+]AuthorDateLineData
ec7d3632 bellard2004-10-05 22:33:55 +00001/**************************************************************************/
2/* COFF.H */
3/* COFF data structures and related definitions used by the linker */
4/**************************************************************************/
5
6/*------------------------------------------------------------------------*/
7/* COFF FILE HEADER */
8/*------------------------------------------------------------------------*/
9struct filehdr {
10 unsigned short f_magic; /* magic number */
11 unsigned short f_nscns; /* number of sections */
12 long f_timdat; /* time & date stamp */
13 long f_symptr; /* file pointer to symtab */
14 long f_nsyms; /* number of symtab entries */
15 unsigned short f_opthdr; /* sizeof(optional hdr) */
16 unsigned short f_flags; /* flags */
17 unsigned short f_TargetID; /* for C6x = 0x0099 */
18 };
19
20/*------------------------------------------------------------------------*/
21/* File header flags */
22/*------------------------------------------------------------------------*/
23#define F_RELFLG 0x01 /* relocation info stripped from file */
24#define F_EXEC 0x02 /* file is executable (no unresolved refs) */
25#define F_LNNO 0x04 /* line nunbers stripped from file */
26#define F_LSYMS 0x08 /* local symbols stripped from file */
27#define F_GSP10 0x10 /* 34010 version */
28#define F_GSP20 0x20 /* 34020 version */
29#define F_SWABD 0x40 /* bytes swabbed (in names) */
30#define F_AR16WR 0x80 /* byte ordering of an AR16WR (PDP-11) */
31#define F_LITTLE 0x100 /* byte ordering of an AR32WR (vax) */
32#define F_BIG 0x200 /* byte ordering of an AR32W (3B, maxi) */
33#define F_PATCH 0x400 /* contains "patch" list in optional header */
89ad24e7 gus knight2015-07-29 16:53:57 -040034#define F_NODF 0x400
ec7d3632 bellard2004-10-05 22:33:55 +000035
89ad24e7 gus knight2015-07-29 16:53:57 -040036#define F_VERSION (F_GSP10 | F_GSP20)
ec7d3632 bellard2004-10-05 22:33:55 +000037#define F_BYTE_ORDER (F_LITTLE | F_BIG)
38#define FILHDR struct filehdr
39
0bdbd49e
UJ
Urs Janssen2013-02-17 00:48:51 +010040/* #define FILHSZ sizeof(FILHDR) */
41#define FILHSZ 22 /* above rounds to align on 4 bytes which causes problems */
ec7d3632 bellard2004-10-05 22:33:55 +000042
43#define COFF_C67_MAGIC 0x00c2
44
45/*------------------------------------------------------------------------*/
46/* Macros to recognize magic numbers */
47/*------------------------------------------------------------------------*/
48#define ISMAGIC(x) (((unsigned short)(x))==(unsigned short)magic)
49#define ISARCHIVE(x) ((((unsigned short)(x))==(unsigned short)ARTYPE))
50#define BADMAGIC(x) (((unsigned short)(x) & 0x8080) && !ISMAGIC(x))
51
52\f
53/*------------------------------------------------------------------------*/
54/* OPTIONAL FILE HEADER */
55/*------------------------------------------------------------------------*/
56typedef struct aouthdr {
57 short magic; /* see magic.h */
58 short vstamp; /* version stamp */
59 long tsize; /* text size in bytes, padded to FW bdry*/
60 long dsize; /* initialized data " " */
61 long bsize; /* uninitialized data " " */
62 long entrypt; /* entry pt. */
63 long text_start; /* base of text used for this file */
64 long data_start; /* base of data used for this file */
65} AOUTHDR;
66
67#define AOUTSZ sizeof(AOUTHDR)
68
69/*----------------------------------------------------------------------*/
70/* When a UNIX aout header is to be built in the optional header, */
89ad24e7 gus knight2015-07-29 16:53:57 -040071/* the following magic numbers can appear in that header: */
ec7d3632 bellard2004-10-05 22:33:55 +000072/* */
73/* AOUT1MAGIC : default : readonly sharable text segment */
74/* AOUT2MAGIC: : writable text segment */
75/* PAGEMAGIC : : configured for paging */
76/*----------------------------------------------------------------------*/
77#define AOUT1MAGIC 0410
78#define AOUT2MAGIC 0407
79#define PAGEMAGIC 0413
80
81\f
82/*------------------------------------------------------------------------*/
83/* COMMON ARCHIVE FILE STRUCTURES */
84/* */
85/* ARCHIVE File Organization: */
86/* _______________________________________________ */
87/* |__________ARCHIVE_MAGIC_STRING_______________| */
88/* |__________ARCHIVE_FILE_MEMBER_1______________| */
89/* | | */
90/* | Archive File Header "ar_hdr" | */
91/* |.............................................| */
92/* | Member Contents | */
93/* | 1. External symbol directory | */
94/* | 2. Text file | */
95/* |_____________________________________________| */
96/* |________ARCHIVE_FILE_MEMBER_2________________| */
97/* | "ar_hdr" | */
98/* |.............................................| */
99/* | Member Contents (.o or text file) | */
100/* |_____________________________________________| */
101/* | . . . | */
102/* | . . . | */
103/* | . . . | */
104/* |_____________________________________________| */
105/* |________ARCHIVE_FILE_MEMBER_n________________| */
106/* | "ar_hdr" | */
107/* |.............................................| */
108/* | Member Contents | */
109/* |_____________________________________________| */
110/* */
111/*------------------------------------------------------------------------*/
112
113#define COFF_ARMAG "!<arch>\n"
114#define SARMAG 8
115#define ARFMAG "`\n"
116
117struct ar_hdr /* archive file member header - printable ascii */
118{
119 char ar_name[16]; /* file member name - `/' terminated */
120 char ar_date[12]; /* file member date - decimal */
121 char ar_uid[6]; /* file member user id - decimal */
122 char ar_gid[6]; /* file member group id - decimal */
123 char ar_mode[8]; /* file member mode - octal */
124 char ar_size[10]; /* file member size - decimal */
125 char ar_fmag[2]; /* ARFMAG - string to end header */
126};
127
128\f
129/*------------------------------------------------------------------------*/
130/* SECTION HEADER */
131/*------------------------------------------------------------------------*/
132struct scnhdr {
133 char s_name[8]; /* section name */
134 long s_paddr; /* physical address */
135 long s_vaddr; /* virtual address */
136 long s_size; /* section size */
137 long s_scnptr; /* file ptr to raw data for section */
138 long s_relptr; /* file ptr to relocation */
139 long s_lnnoptr; /* file ptr to line numbers */
140 unsigned int s_nreloc; /* number of relocation entries */
141 unsigned int s_nlnno; /* number of line number entries */
142 unsigned int s_flags; /* flags */
143 unsigned short s_reserved; /* reserved byte */
144 unsigned short s_page; /* memory page id */
145 };
146
147#define SCNHDR struct scnhdr
148#define SCNHSZ sizeof(SCNHDR)
149
150/*------------------------------------------------------------------------*/
151/* Define constants for names of "special" sections */
152/*------------------------------------------------------------------------*/
0bdbd49e Urs Janssen2013-02-17 00:48:51 +0100153/* #define _TEXT ".text" */
ec7d3632 bellard2004-10-05 22:33:55 +0000154#define _DATA ".data"
155#define _BSS ".bss"
156#define _CINIT ".cinit"
157#define _TV ".tv"
158
159/*------------------------------------------------------------------------*/
160/* The low 4 bits of s_flags is used as a section "type" */
161/*------------------------------------------------------------------------*/
162#define STYP_REG 0x00 /* "regular" : allocated, relocated, loaded */
163#define STYP_DSECT 0x01 /* "dummy" : not allocated, relocated, not loaded */
164#define STYP_NOLOAD 0x02 /* "noload" : allocated, relocated, not loaded */
165#define STYP_GROUP 0x04 /* "grouped" : formed of input sections */
166#define STYP_PAD 0x08 /* "padding" : not allocated, not relocated, loaded */
89ad24e7 gus knight2015-07-29 16:53:57 -0400167#define STYP_COPY 0x10 /* "copy" : used for C init tables -
ec7d3632 bellard2004-10-05 22:33:55 +0000168 not allocated, relocated,
169 loaded; reloc & lineno
170 entries processed normally */
171#define STYP_TEXT 0x20 /* section contains text only */
172#define STYP_DATA 0x40 /* section contains data only */
173#define STYP_BSS 0x80 /* section contains bss only */
174
175#define STYP_ALIGN 0x100 /* align flag passed by old version assemblers */
176#define ALIGN_MASK 0x0F00 /* part of s_flags that is used for align vals */
177#define ALIGNSIZE(x) (1 << ((x & ALIGN_MASK) >> 8))
178
179\f
180/*------------------------------------------------------------------------*/
181/* RELOCATION ENTRIES */
182/*------------------------------------------------------------------------*/
183struct reloc
184{
185 long r_vaddr; /* (virtual) address of reference */
186 short r_symndx; /* index into symbol table */
187 unsigned short r_disp; /* additional bits for address calculation */
188 unsigned short r_type; /* relocation type */
189};
190
191#define RELOC struct reloc
192#define RELSZ 10 /* sizeof(RELOC) */
193
194/*--------------------------------------------------------------------------*/
195/* define all relocation types */
196/*--------------------------------------------------------------------------*/
197
198#define R_ABS 0 /* absolute address - no relocation */
199#define R_DIR16 01 /* UNUSED */
200#define R_REL16 02 /* UNUSED */
201#define R_DIR24 04 /* UNUSED */
202#define R_REL24 05 /* 24 bits, direct */
203#define R_DIR32 06 /* UNUSED */
204#define R_RELBYTE 017 /* 8 bits, direct */
205#define R_RELWORD 020 /* 16 bits, direct */
206#define R_RELLONG 021 /* 32 bits, direct */
207#define R_PCRBYTE 022 /* 8 bits, PC-relative */
208#define R_PCRWORD 023 /* 16 bits, PC-relative */
209#define R_PCRLONG 024 /* 32 bits, PC-relative */
210#define R_OCRLONG 030 /* GSP: 32 bits, one's complement direct */
211#define R_GSPPCR16 031 /* GSP: 16 bits, PC relative (in words) */
212#define R_GSPOPR32 032 /* GSP: 32 bits, direct big-endian */
213#define R_PARTLS16 040 /* Brahma: 16 bit offset of 24 bit address*/
214#define R_PARTMS8 041 /* Brahma: 8 bit page of 24 bit address */
215#define R_PARTLS7 050 /* DSP: 7 bit offset of 16 bit address */
216#define R_PARTMS9 051 /* DSP: 9 bit page of 16 bit address */
217#define R_REL13 052 /* DSP: 13 bits, direct */
218
219\f
220/*------------------------------------------------------------------------*/
221/* LINE NUMBER ENTRIES */
222/*------------------------------------------------------------------------*/
223struct lineno
224{
225 union
226 {
227 long l_symndx ; /* sym. table index of function name
228 iff l_lnno == 0 */
229 long l_paddr ; /* (physical) address of line number */
230 } l_addr ;
231 unsigned short l_lnno ; /* line number */
232};
233
234#define LINENO struct lineno
235#define LINESZ 6 /* sizeof(LINENO) */
236
237\f
238/*------------------------------------------------------------------------*/
239/* STORAGE CLASSES */
240/*------------------------------------------------------------------------*/
241#define C_EFCN -1 /* physical end of function */
242#define C_NULL 0
243#define C_AUTO 1 /* automatic variable */
244#define C_EXT 2 /* external symbol */
245#define C_STAT 3 /* static */
246#define C_REG 4 /* register variable */
247#define C_EXTDEF 5 /* external definition */
248#define C_LABEL 6 /* label */
249#define C_ULABEL 7 /* undefined label */
250#define C_MOS 8 /* member of structure */
251#define C_ARG 9 /* function argument */
252#define C_STRTAG 10 /* structure tag */
253#define C_MOU 11 /* member of union */
254#define C_UNTAG 12 /* union tag */
255#define C_TPDEF 13 /* type definition */
256#define C_USTATIC 14 /* undefined static */
257#define C_ENTAG 15 /* enumeration tag */
258#define C_MOE 16 /* member of enumeration */
259#define C_REGPARM 17 /* register parameter */
260#define C_FIELD 18 /* bit field */
261
262#define C_BLOCK 100 /* ".bb" or ".eb" */
263#define C_FCN 101 /* ".bf" or ".ef" */
264#define C_EOS 102 /* end of structure */
265#define C_FILE 103 /* file name */
266#define C_LINE 104 /* dummy sclass for line number entry */
267#define C_ALIAS 105 /* duplicate tag */
268#define C_HIDDEN 106 /* special storage class for external */
269 /* symbols in dmert public libraries */
270\f
271/*------------------------------------------------------------------------*/
272/* SYMBOL TABLE ENTRIES */
273/*------------------------------------------------------------------------*/
274
275#define SYMNMLEN 8 /* Number of characters in a symbol name */
276#define FILNMLEN 14 /* Number of characters in a file name */
277#define DIMNUM 4 /* Number of array dimensions in auxiliary entry */
278
279
280struct syment
281{
282 union
283 {
284 char _n_name[SYMNMLEN]; /* old COFF version */
285 struct
286 {
287 long _n_zeroes; /* new == 0 */
288 long _n_offset; /* offset into string table */
289 } _n_n;
290 char *_n_nptr[2]; /* allows for overlaying */
291 } _n;
292 long n_value; /* value of symbol */
293 short n_scnum; /* section number */
294 unsigned short n_type; /* type and derived type */
295 char n_sclass; /* storage class */
296 char n_numaux; /* number of aux. entries */
297};
298
299#define n_name _n._n_name
300#define n_nptr _n._n_nptr[1]
301#define n_zeroes _n._n_n._n_zeroes
302#define n_offset _n._n_n._n_offset
303
304/*------------------------------------------------------------------------*/
305/* Relocatable symbols have a section number of the */
306/* section in which they are defined. Otherwise, section */
307/* numbers have the following meanings: */
308/*------------------------------------------------------------------------*/
309#define N_UNDEF 0 /* undefined symbol */
310#define N_ABS -1 /* value of symbol is absolute */
311#define N_DEBUG -2 /* special debugging symbol */
312#define N_TV (unsigned short)-3 /* needs transfer vector (preload) */
313#define P_TV (unsigned short)-4 /* needs transfer vector (postload) */
314
315\f
316/*------------------------------------------------------------------------*/
317/* The fundamental type of a symbol packed into the low */
318/* 4 bits of the word. */
319/*------------------------------------------------------------------------*/
320#define _EF ".ef"
321
322#define T_NULL 0 /* no type info */
323#define T_ARG 1 /* function argument (only used by compiler) */
324#define T_CHAR 2 /* character */
325#define T_SHORT 3 /* short integer */
326#define T_INT 4 /* integer */
327#define T_LONG 5 /* long integer */
328#define T_FLOAT 6 /* floating point */
329#define T_DOUBLE 7 /* double word */
330#define T_STRUCT 8 /* structure */
331#define T_UNION 9 /* union */
332#define T_ENUM 10 /* enumeration */
333#define T_MOE 11 /* member of enumeration */
334#define T_UCHAR 12 /* unsigned character */
335#define T_USHORT 13 /* unsigned short */
336#define T_UINT 14 /* unsigned integer */
337#define T_ULONG 15 /* unsigned long */
338
339/*------------------------------------------------------------------------*/
340/* derived types are: */
341/*------------------------------------------------------------------------*/
342#define DT_NON 0 /* no derived type */
343#define DT_PTR 1 /* pointer */
344#define DT_FCN 2 /* function */
345#define DT_ARY 3 /* array */
346
347#define MKTYPE(basic, d1,d2,d3,d4,d5,d6) \
348 ((basic) | ((d1) << 4) | ((d2) << 6) | ((d3) << 8) |\
349 ((d4) << 10) | ((d5) << 12) | ((d6) << 14))
350
351/*------------------------------------------------------------------------*/
352/* type packing constants and macros */
353/*------------------------------------------------------------------------*/
354#define N_BTMASK_COFF 017
355#define N_TMASK_COFF 060
356#define N_TMASK1_COFF 0300
357#define N_TMASK2_COFF 0360
358#define N_BTSHFT_COFF 4
359#define N_TSHIFT_COFF 2
360
89ad24e7 gus knight2015-07-29 16:53:57 -0400361#define BTYPE_COFF(x) ((x) & N_BTMASK_COFF)
ec7d3632 bellard2004-10-05 22:33:55 +0000362#define ISINT(x) (((x) >= T_CHAR && (x) <= T_LONG) || \
363 ((x) >= T_UCHAR && (x) <= T_ULONG) || (x) == T_ENUM)
364#define ISFLT_COFF(x) ((x) == T_DOUBLE || (x) == T_FLOAT)
89ad24e7 gus knight2015-07-29 16:53:57 -0400365#define ISPTR_COFF(x) (((x) & N_TMASK_COFF) == (DT_PTR << N_BTSHFT_COFF))
ec7d3632 bellard2004-10-05 22:33:55 +0000366#define ISFCN_COFF(x) (((x) & N_TMASK_COFF) == (DT_FCN << N_BTSHFT_COFF))
367#define ISARY_COFF(x) (((x) & N_TMASK_COFF) == (DT_ARY << N_BTSHFT_COFF))
368#define ISTAG_COFF(x) ((x)==C_STRTAG || (x)==C_UNTAG || (x)==C_ENTAG)
369
370#define INCREF_COFF(x) ((((x)&~N_BTMASK_COFF)<<N_TSHIFT_COFF)|(DT_PTR<<N_BTSHFT_COFF)|(x&N_BTMASK_COFF))
371#define DECREF_COFF(x) ((((x)>>N_TSHIFT_COFF)&~N_BTMASK_COFF)|((x)&N_BTMASK_COFF))
372
89ad24e7 gus knight2015-07-29 16:53:57 -0400373\f
ec7d3632 bellard2004-10-05 22:33:55 +0000374/*------------------------------------------------------------------------*/
375/* AUXILIARY SYMBOL ENTRY */
376/*------------------------------------------------------------------------*/
377union auxent
378{
379 struct
380 {
381 long x_tagndx; /* str, un, or enum tag indx */
382 union
383 {
384 struct
385 {
386 unsigned short x_lnno; /* declaration line number */
387 unsigned short x_size; /* str, union, array size */
388 } x_lnsz;
389 long x_fsize; /* size of function */
390 } x_misc;
391 union
392 {
393 struct /* if ISFCN, tag, or .bb */
394 {
395 long x_lnnoptr; /* ptr to fcn line # */
396 long x_endndx; /* entry ndx past block end */
397 } x_fcn;
398 struct /* if ISARY, up to 4 dimen. */
399 {
400 unsigned short x_dimen[DIMNUM];
401 } x_ary;
402 } x_fcnary;
403 unsigned short x_regcount; /* number of registers used by func */
404 } x_sym;
405 struct
406 {
407 char x_fname[FILNMLEN];
408 } x_file;
409 struct
410 {
411 long x_scnlen; /* section length */
412 unsigned short x_nreloc; /* number of relocation entries */
413 unsigned short x_nlinno; /* number of line numbers */
414 } x_scn;
415};
416
417#define SYMENT struct syment
418#define SYMESZ 18 /* sizeof(SYMENT) */
419
420#define AUXENT union auxent
421#define AUXESZ 18 /* sizeof(AUXENT) */
422
423/*------------------------------------------------------------------------*/
424/* NAMES OF "SPECIAL" SYMBOLS */
425/*------------------------------------------------------------------------*/
426#define _STEXT ".text"
427#define _ETEXT "etext"
428#define _SDATA ".data"
429#define _EDATA "edata"
430#define _SBSS ".bss"
431#define _END "end"
432#define _CINITPTR "cinit"
433
434/*--------------------------------------------------------------------------*/
435/* ENTRY POINT SYMBOLS */
436/*--------------------------------------------------------------------------*/
437#define _START "_start"
438#define _MAIN "_main"
439 /* _CSTART "_c_int00" (defined in params.h) */
440
441
442#define _TVORIG "_tvorig"
443#define _TORIGIN "_torigin"
444#define _DORIGIN "_dorigin"
445
446#define _SORIGIN "_sorigin"