OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [gnu-old/] [gdb-6.8/] [include/] [coff/] [ti.h] - Blame information for rev 157

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 24 jeremybenn
/* COFF information for TI COFF support.  Definitions in this file should be
2
   customized in a target-specific file, and then this file included (see
3
   tic54x.h for an example).
4
 
5
   Copyright 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
6
 
7
   This program is free software; you can redistribute it and/or modify
8
   it under the terms of the GNU General Public License as published by
9
   the Free Software Foundation; either version 2 of the License, or
10
   (at your option) any later version.
11
 
12
   This program is distributed in the hope that it will be useful,
13
   but WITHOUT ANY WARRANTY; without even the implied warranty of
14
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15
   GNU General Public License for more details.
16
 
17
   You should have received a copy of the GNU General Public License
18
   along with this program; if not, write to the Free Software
19
   Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.  */
20
#ifndef COFF_TI_H
21
#define COFF_TI_H
22
 
23
/* Note "coff/external.h is not used because TI adds extra fields to the structures.  */
24
 
25
/********************** FILE HEADER **********************/
26
 
27
struct external_filehdr
28
  {
29
    char f_magic[2];    /* magic number                 */
30
    char f_nscns[2];    /* number of sections           */
31
    char f_timdat[4];   /* time & date stamp            */
32
    char f_symptr[4];   /* file pointer to symtab       */
33
    char f_nsyms[4];    /* number of symtab entries     */
34
    char f_opthdr[2];   /* sizeof(optional hdr)         */
35
    char f_flags[2];    /* flags                        */
36
    char f_target_id[2];    /* magic no. (TI COFF-specific) */
37
  };
38
 
39
/* COFF0 has magic number in f_magic, and omits f_target_id from the file
40
   header; for later versions, f_magic is 0xC1 for COFF1 and 0xC2 for COFF2
41
   and the target-specific magic number is found in f_target_id */
42
 
43
#define TICOFF0MAGIC    TI_TARGET_ID
44
#define TICOFF1MAGIC    0x00C1
45
#define TICOFF2MAGIC    0x00C2
46
#define TICOFF_AOUT_MAGIC    0x0108 /* magic number in optional header */
47
#define TICOFF          1 /* customize coffcode.h */
48
 
49
/* The target_id field changes depending on the particular CPU target */
50
/* for COFF0, the target id appeared in f_magic, where COFFX magic is now */
51
#ifndef TI_TARGET_ID
52
#error "TI_TARGET_ID needs to be defined for your CPU"
53
#endif
54
 
55
/* Which bfd_arch to use... */
56
#ifndef TICOFF_TARGET_ARCH
57
#error "TICOFF_TARGET_ARCH needs to be defined for your CPU"
58
#endif
59
 
60
#ifndef TICOFF_TARGET_MACHINE_GET
61
#define TICOFF_TARGET_MACHINE_GET(FLAGS) 0
62
#endif
63
 
64
#ifndef TICOFF_TARGET_MACHINE_SET
65
#define TICOFF_TARGET_MACHINE_SET(FLAGSP, MACHINE)
66
#endif
67
 
68
/* Default to COFF2 for file output */
69
#ifndef TICOFF_DEFAULT_MAGIC
70
#define TICOFF_DEFAULT_MAGIC TICOFF2MAGIC
71
#endif
72
 
73
/* This value is made available in the rare case where a bfd is unavailable */
74
#ifndef OCTETS_PER_BYTE_POWER
75
#error "OCTETS_PER_BYTE_POWER not defined for this CPU"
76
#else
77
#define OCTETS_PER_BYTE (1<<OCTETS_PER_BYTE_POWER)
78
#endif
79
 
80
/* default alignment is on a byte (not octet!) boundary */
81
#ifndef COFF_DEFAULT_SECTION_ALIGNMENT_POWER
82
#define COFF_DEFAULT_SECTION_ALIGNMENT_POWER 0
83
#endif
84
 
85
/* TI COFF encodes the section alignment in the section header flags */
86
#define COFF_ALIGN_IN_SECTION_HEADER 1
87
#define COFF_ALIGN_IN_S_FLAGS 1
88
/* requires a power-of-two argument */
89
#define COFF_ENCODE_ALIGNMENT(S,X) ((S).s_flags |= (((unsigned)(X)&0xF)<<8))
90
/* result is a power of two */
91
#define COFF_DECODE_ALIGNMENT(X) (((X)>>8)&0xF)
92
 
93
#define COFF0_P(ABFD) (bfd_coff_filhsz(ABFD) == FILHSZ_V0)
94
#define COFF2_P(ABFD) (bfd_coff_scnhsz(ABFD) != SCNHSZ_V01)
95
 
96
#define COFF0_BADMAG(x) ((x).f_magic != TICOFF0MAGIC)
97
#define COFF1_BADMAG(x) ((x).f_magic != TICOFF1MAGIC || (x).f_target_id != TI_TARGET_ID)
98
#define COFF2_BADMAG(x) ((x).f_magic != TICOFF2MAGIC || (x).f_target_id != TI_TARGET_ID)
99
 
100
/* we need to read/write an extra field in the coff file header */
101
#ifndef COFF_ADJUST_FILEHDR_IN_POST
102
#define COFF_ADJUST_FILEHDR_IN_POST(abfd, src, dst) \
103
  do                                                                    \
104
    {                                                                   \
105
      ((struct internal_filehdr *)(dst))->f_target_id =                 \
106
        H_GET_16 (abfd, ((FILHDR *)(src))->f_target_id);                \
107
    }                                                                   \
108
  while (0)
109
#endif
110
 
111
#ifndef COFF_ADJUST_FILEHDR_OUT_POST
112
#define COFF_ADJUST_FILEHDR_OUT_POST(abfd, src, dst) \
113
  do                                                                    \
114
    {                                                                   \
115
      H_PUT_16 (abfd, ((struct internal_filehdr *)(src))->f_target_id,  \
116
               ((FILHDR *)(dst))->f_target_id);                         \
117
    }                                                                   \
118
  while (0)
119
#endif
120
 
121
#define FILHDR  struct external_filehdr
122
#define FILHSZ  22
123
#define FILHSZ_V0 20                /* COFF0 omits target_id field */
124
 
125
/* File header flags */
126
#define F_RELFLG        (0x0001)
127
#define F_EXEC          (0x0002)
128
#define F_LNNO          (0x0004)
129
#define F_VERS          (0x0010) /* TMS320C4x code */
130
/* F_LSYMS needs to be redefined in your source file */
131
#define F_LSYMS_TICOFF  (0x0010) /* normal COFF is 0x8 */
132
 
133
#define F_10            0x00    /* file built for TMS320C1x devices */
134
#define F_20            0x10    /* file built for TMS320C2x devices */
135
#define F_25            0x20    /* file built for TMS320C2x/C5x devices */
136
#define F_LENDIAN       0x0100  /* 16 bits/word, LSB first */
137
#define F_SYMMERGE      0x1000  /* duplicate symbols were removed */
138
 
139
/********************** OPTIONAL HEADER **********************/
140
 
141
 
142
typedef struct
143
{
144
  char  magic[2];               /* type of file (0x108)                 */
145
  char  vstamp[2];              /* version stamp                        */
146
  char  tsize[4];               /* text size in bytes, padded to FW bdry*/
147
  char  dsize[4];               /* initialized data "  "                */
148
  char  bsize[4];               /* uninitialized data "   "             */
149
  char  entry[4];               /* entry pt.                            */
150
  char  text_start[4];          /* base of text used for this file */
151
  char  data_start[4];          /* base of data used for this file */
152
}
153
AOUTHDR;
154
 
155
 
156
#define AOUTHDRSZ 28
157
#define AOUTSZ 28
158
 
159
 
160
/********************** SECTION HEADER **********************/
161
/* COFF0, COFF1 */
162
struct external_scnhdr_v01 {
163
        char            s_name[8];      /* section name                 */
164
        char            s_paddr[4];     /* physical address, aliased s_nlib */
165
        char            s_vaddr[4];     /* virtual address              */
166
        char            s_size[4];      /* section size (in WORDS)      */
167
        char            s_scnptr[4];    /* file ptr to raw data for section */
168
        char            s_relptr[4];    /* file ptr to relocation       */
169
        char            s_lnnoptr[4];   /* file ptr to line numbers     */
170
        char            s_nreloc[2];    /* number of relocation entries */
171
        char            s_nlnno[2];     /* number of line number entries*/
172
        char            s_flags[2];     /* flags                        */
173
        char            s_reserved[1];  /* reserved                     */
174
        char            s_page[1];      /* section page number (LOAD)   */
175
};
176
 
177
/* COFF2 */
178
struct external_scnhdr {
179
        char            s_name[8];      /* section name                 */
180
        char            s_paddr[4];     /* physical address, aliased s_nlib */
181
        char            s_vaddr[4];     /* virtual address              */
182
        char            s_size[4];      /* section size (in WORDS)      */
183
        char            s_scnptr[4];    /* file ptr to raw data for section */
184
        char            s_relptr[4];    /* file ptr to relocation       */
185
        char            s_lnnoptr[4];   /* file ptr to line numbers     */
186
        char            s_nreloc[4];    /* number of relocation entries */
187
        char            s_nlnno[4];     /* number of line number entries*/
188
        char            s_flags[4];     /* flags                        */
189
        char            s_reserved[2];  /* reserved                     */
190
        char            s_page[2];      /* section page number (LOAD)   */
191
};
192
 
193
/*
194
 * Special section flags
195
 */
196
 
197
/* TI COFF defines these flags;
198
   STYP_CLINK: the section should be excluded from the final
199
   linker output if there are no references found to any symbol in the section
200
   STYP_BLOCK: the section should be blocked, i.e. if the section would cross
201
   a page boundary, it is started at a page boundary instead.
202
   TI COFF puts the section alignment power of two in the section flags
203
   e.g. 2**N is alignment, flags |= (N & 0xF) << 8
204
*/
205
#define STYP_CLINK      (0x4000)
206
#define STYP_BLOCK      (0x1000)
207
#define STYP_ALIGN      (0x0F00) /* TI COFF stores section alignment here */
208
 
209
#define SCNHDR_V01 struct external_scnhdr_v01
210
#define SCNHDR struct external_scnhdr
211
#define SCNHSZ_V01 40                  /* for v0 and v1 */
212
#define SCNHSZ 48
213
 
214
/* COFF2 changes the offsets and sizes of these fields
215
   Assume we're dealing with the COFF2 scnhdr structure, and adjust
216
   accordingly
217
 */
218
#define GET_SCNHDR_NRELOC(ABFD, LOC) \
219
  (COFF2_P (ABFD) ? H_GET_32 (ABFD, LOC) : H_GET_16 (ABFD, LOC))
220
#define PUT_SCNHDR_NRELOC(ABFD, VAL, LOC) \
221
  (COFF2_P (ABFD) ? H_PUT_32 (ABFD, VAL, LOC) : H_PUT_16 (ABFD, VAL, LOC))
222
#define GET_SCNHDR_NLNNO(ABFD, LOC) \
223
  (COFF2_P (ABFD) ? H_GET_32 (ABFD, LOC) : H_GET_16 (ABFD, (LOC) - 2))
224
#define PUT_SCNHDR_NLNNO(ABFD, VAL, LOC) \
225
  (COFF2_P (ABFD) ? H_PUT_32 (ABFD, VAL, LOC) : H_PUT_16 (ABFD, VAL, (LOC) - 2))
226
#define GET_SCNHDR_FLAGS(ABFD, LOC) \
227
  (COFF2_P (ABFD) ? H_GET_32 (ABFD, LOC) : H_GET_16 (ABFD, (LOC) - 4))
228
#define PUT_SCNHDR_FLAGS(ABFD, VAL, LOC) \
229
  (COFF2_P (ABFD) ? H_PUT_32 (ABFD, VAL, LOC) : H_PUT_16 (ABFD, VAL, (LOC) - 4))
230
#define GET_SCNHDR_PAGE(ABFD, LOC) \
231
  (COFF2_P (ABFD) ? H_GET_16 (ABFD, LOC) : (unsigned) H_GET_8 (ABFD, (LOC) - 7))
232
/* on output, make sure that the "reserved" field is zero */
233
#define PUT_SCNHDR_PAGE(ABFD, VAL, LOC) \
234
  (COFF2_P (ABFD) \
235
   ? H_PUT_16 (ABFD, VAL, LOC) \
236
   : H_PUT_8 (ABFD, VAL, (LOC) - 7), H_PUT_8 (ABFD, 0, (LOC) - 8))
237
 
238
/* TI COFF stores section size as number of bytes (address units, not octets),
239
   so adjust to be number of octets, which is what BFD expects */
240
#define GET_SCNHDR_SIZE(ABFD, SZP) \
241
  (H_GET_32 (ABFD, SZP) * bfd_octets_per_byte (ABFD))
242
#define PUT_SCNHDR_SIZE(ABFD, SZ, SZP) \
243
  H_PUT_32 (ABFD, (SZ) / bfd_octets_per_byte (ABFD), SZP)
244
 
245
#define COFF_ADJUST_SCNHDR_IN_POST(ABFD, EXT, INT) \
246
  do                                                                    \
247
    {                                                                   \
248
      ((struct internal_scnhdr *)(INT))->s_page =                       \
249
        GET_SCNHDR_PAGE (ABFD, ((SCNHDR *)(EXT))->s_page);              \
250
    }                                                                   \
251
   while (0)
252
 
253
/* The line number and reloc overflow checking in coff_swap_scnhdr_out in
254
   coffswap.h doesn't use PUT_X for s_nlnno and s_nreloc.
255
   Due to different sized v0/v1/v2 section headers, we have to re-write these
256
   fields.
257
 */
258
#define COFF_ADJUST_SCNHDR_OUT_POST(ABFD, INT, EXT) \
259
  do                                                                       \
260
    {                                                                      \
261
      PUT_SCNHDR_NLNNO (ABFD, ((struct internal_scnhdr *)(INT))->s_nlnno,  \
262
                        ((SCNHDR *)(EXT))->s_nlnno);                       \
263
      PUT_SCNHDR_NRELOC (ABFD, ((struct internal_scnhdr *)(INT))->s_nreloc,\
264
                         ((SCNHDR *)(EXT))->s_nreloc);                     \
265
      PUT_SCNHDR_FLAGS (ABFD, ((struct internal_scnhdr *)(INT))->s_flags,  \
266
                        ((SCNHDR *)(EXT))->s_flags);                       \
267
      PUT_SCNHDR_PAGE (ABFD, ((struct internal_scnhdr *)(INT))->s_page,    \
268
                       ((SCNHDR *)(EXT))->s_page);                         \
269
    }                                                                      \
270
   while (0)
271
 
272
/*
273
 * names of "special" sections
274
 */
275
#define _TEXT   ".text"
276
#define _DATA   ".data"
277
#define _BSS    ".bss"
278
#define _CINIT  ".cinit"            /* initialized C data */
279
#define _SCONST  ".const"           /* constants */
280
#define _SWITCH ".switch"           /* switch tables */
281
#define _STACK  ".stack"            /* C stack */
282
#define _SYSMEM ".sysmem"           /* used for malloc et al. syscalls */
283
 
284
/********************** LINE NUMBERS **********************/
285
 
286
/* 1 line number entry for every "breakpointable" source line in a section.
287
 * Line numbers are grouped on a per function basis; first entry in a function
288
 * grouping will have l_lnno = 0 and in place of physical address will be the
289
 * symbol table index of the function name.
290
 */
291
struct external_lineno {
292
  union {
293
    char l_symndx[4];   /* function name symbol index, iff l_lnno == 0*/
294
    char l_paddr[4];    /* (physical) address of line number    */
295
  } l_addr;
296
  char l_lnno[2];       /* line number          */
297
};
298
 
299
#define LINENO  struct external_lineno
300
#define LINESZ  6
301
 
302
 
303
/********************** SYMBOLS **********************/
304
 
305
/* NOTE: this is what a local label looks like in assembly source; what it
306
   looks like in COFF output is undefined */
307
#define TICOFF_LOCAL_LABEL_P(NAME) \
308
((NAME[0] == '$' && NAME[1] >= '0' && NAME[1] <= '9' && NAME[2] == '\0') \
309
 || NAME[strlen(NAME)-1] == '?')
310
 
311
#define E_SYMNMLEN      8       /* # characters in a symbol name        */
312
#define E_FILNMLEN      14      /* # characters in a file name          */
313
#define E_DIMNUM        4       /* # array dimensions in auxiliary entry */
314
 
315
struct external_syment
316
{
317
  union {
318
    char e_name[E_SYMNMLEN];
319
    struct {
320
      char e_zeroes[4];
321
      char e_offset[4];
322
    } e;
323
  } e;
324
  char e_value[4];
325
  char e_scnum[2];
326
  char e_type[2];
327
  char e_sclass[1];
328
  char e_numaux[1];
329
};
330
 
331
 
332
#define N_BTMASK        (017)
333
#define N_TMASK         (060)
334
#define N_BTSHFT        (4)
335
#define N_TSHIFT        (2)
336
 
337
 
338
union external_auxent {
339
  struct {
340
        char x_tagndx[4];       /* str, un, or enum tag indx */
341
        union {
342
          struct {
343
                char  x_lnno[2]; /* declaration line number */
344
                char  x_size[2]; /* str/union/array size */
345
          } x_lnsz;
346
          char x_fsize[4];      /* size of function */
347
        } x_misc;
348
        union {
349
          struct {              /* if ISFCN, tag, or .bb */
350
                char x_lnnoptr[4];      /* ptr to fcn line # */
351
                char x_endndx[4];       /* entry ndx past block end */
352
          } x_fcn;
353
          struct {              /* if ISARY, up to 4 dimen. */
354
                char x_dimen[E_DIMNUM][2];
355
          } x_ary;
356
        } x_fcnary;
357
        char x_tvndx[2];                /* tv index */
358
  } x_sym;
359
 
360
  union {
361
        char x_fname[E_FILNMLEN];
362
        struct {
363
          char x_zeroes[4];
364
          char x_offset[4];
365
        } x_n;
366
  } x_file;
367
 
368
  struct {
369
        char x_scnlen[4];                       /* section length */
370
        char x_nreloc[2];       /* # relocation entries */
371
        char x_nlinno[2];       /* # line numbers */
372
  } x_scn;
373
 
374
  struct {
375
        char x_tvfill[4];       /* tv fill value */
376
        char x_tvlen[2];        /* length of .tv */
377
        char x_tvran[2][2];     /* tv range */
378
  } x_tv;               /* info about .tv section (in auxent of symbol .tv)) */
379
 
380
 
381
};
382
 
383
#define SYMENT  struct external_syment
384
#define SYMESZ  18      
385
#define AUXENT  union external_auxent
386
#define AUXESZ  18
387
 
388
/* section lengths are in target bytes (not host bytes) */
389
#define GET_SCN_SCNLEN(ABFD, EXT) \
390
  (H_GET_32 (ABFD, (EXT)->x_scn.x_scnlen) * bfd_octets_per_byte (ABFD))
391
#define PUT_SCN_SCNLEN(ABFD, INT, EXT) \
392
  H_PUT_32 (ABFD, (INT) / bfd_octets_per_byte (ABFD), (EXT)->x_scn.x_scnlen)
393
 
394
/* lnsz size is in bits in COFF file, in bytes in BFD */
395
#define GET_LNSZ_SIZE(abfd, ext) \
396
 (H_GET_16 (abfd, ext->x_sym.x_misc.x_lnsz.x_size) / (class != C_FIELD ? 8 : 1))
397
 
398
#define PUT_LNSZ_SIZE(abfd, in, ext) \
399
  H_PUT_16 (abfd, ((class != C_FIELD) ? (in) * 8 : (in)), \
400
           ext->x_sym.x_misc.x_lnsz.x_size)
401
 
402
/* TI COFF stores offsets for MOS and MOU in bits; BFD expects bytes
403
   Also put the load page flag of the section into the symbol value if it's an
404
   address.  */
405
#ifndef NEEDS_PAGE
406
#define NEEDS_PAGE(X) 0
407
#define PAGE_MASK 0
408
#endif
409
#define COFF_ADJUST_SYM_IN_POST(ABFD, EXT, INT) \
410
  do                                                                    \
411
    {                                                                   \
412
      struct internal_syment *dst = (struct internal_syment *)(INT);    \
413
      if (dst->n_sclass == C_MOS || dst->n_sclass == C_MOU)             \
414
        dst->n_value /= 8;                                              \
415
      else if (NEEDS_PAGE (dst->n_sclass)) {                            \
416
        asection *scn = coff_section_from_bfd_index (abfd, dst->n_scnum); \
417
        dst->n_value |= (scn->lma & PAGE_MASK);                         \
418
      }                                                                 \
419
    }                                                                   \
420
   while (0)
421
 
422
#define COFF_ADJUST_SYM_OUT_POST(ABFD, INT, EXT) \
423
  do                                                                    \
424
    {                                                                   \
425
       struct internal_syment *src = (struct internal_syment *)(INT);   \
426
       SYMENT *dst = (SYMENT *)(EXT);                                   \
427
       if (src->n_sclass == C_MOU || src->n_sclass == C_MOS)            \
428
         H_PUT_32 (abfd, src->n_value * 8, dst->e_value);               \
429
       else if (NEEDS_PAGE (src->n_sclass)) {                           \
430
         H_PUT_32 (abfd, src->n_value &= ~PAGE_MASK, dst->e_value);     \
431
       }                                                                \
432
    }                                                                   \
433
   while (0)
434
 
435
/* Detect section-relative absolute symbols so they get flagged with a sym
436
   index of -1.
437
*/
438
#define SECTION_RELATIVE_ABSOLUTE_SYMBOL_P(RELOC, SECT) \
439
  ((*(RELOC)->sym_ptr_ptr)->section->output_section == (SECT) \
440
   && (RELOC)->howto->name[0] == 'A')
441
 
442
/********************** RELOCATION DIRECTIVES **********************/
443
 
444
struct external_reloc_v0
445
{
446
  char r_vaddr[4];
447
  char r_symndx[2];
448
  char r_reserved[2];
449
  char r_type[2];
450
};
451
 
452
struct external_reloc
453
{
454
  char r_vaddr[4];
455
  char r_symndx[4];
456
  char r_reserved[2]; /* extended pmad byte for COFF2 */
457
  char r_type[2];
458
};
459
 
460
#define RELOC struct external_reloc
461
#define RELSZ_V0 10                 /* FIXME -- coffcode.h needs fixing */
462
#define RELSZ 12                    /* for COFF1/2 */
463
 
464
/* various relocation types.  */
465
#define R_ABS     0x0000            /* no relocation */
466
#define R_REL13   0x002A            /* 13-bit direct reference (???) */
467
#define R_PARTLS7 0x0028            /* 7 LSBs of an address */
468
#define R_PARTMS9 0x0029            /* 9MSBs of an address */
469
#define R_EXTWORD 0x002B            /* 23-bit direct reference */
470
#define R_EXTWORD16 0x002C          /* 16-bit direct reference to 23-bit addr*/
471
#define R_EXTWORDMS7 0x002D         /* upper 7 bits of 23-bit address */
472
 
473
#endif /* COFF_TI_H */

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.