[deliverable/binutils-gdb.git] / include / coff / ti.h

/* COFF information for TI COFF support.  Definitions in this file should be
   customized in a target-specific file, and then this file included (see
   tic54x.h for an example). */
#ifndef COFF_TI_H
#define COFF_TI_H

/********************** FILE HEADER **********************/

struct external_filehdr {
	char f_magic[2];	/* magic number			*/
	char f_nscns[2];	/* number of sections		*/
	char f_timdat[4];	/* time & date stamp		*/
	char f_symptr[4];	/* file pointer to symtab	*/
	char f_nsyms[4];	/* number of symtab entries	*/
	char f_opthdr[2];	/* sizeof(optional hdr)		*/
	char f_flags[2];	/* flags			*/
        char f_target_id[2];    /* magic no. (TI COFF-specific) */
};

/* COFF0 has magic number in f_magic, and omits f_target_id from the file
   header; for later versions, f_magic is 0xC1 for COFF1 and 0xC2 for COFF2
   and the target-specific magic number is found in f_target_id */ 

#define TICOFF0MAGIC    TI_TARGET_ID
#define TICOFF1MAGIC    0x00C1
#define TICOFF2MAGIC    0x00C2
#define TICOFF_AOUT_MAGIC    0x0108 /* magic number in optional header */
#define TICOFF          1 /* customize coffcode.h */

/* The target_id field changes depending on the particular CPU target */
/* for COFF0, the target id appeared in f_magic, where COFFX magic is now */
#ifndef TI_TARGET_ID
#error "TI_TARGET_ID needs to be defined for your CPU"
#endif

/* Which bfd_arch to use... */
#ifndef TICOFF_TARGET_ARCH
#error "TICOFF_TARGET_ARCH needs to be defined for your CPU"
#endif

/* Default to COFF2 for file output */
#ifndef TICOFF_DEFAULT_MAGIC
#define TICOFF_DEFAULT_MAGIC TICOFF2MAGIC
#endif

/* This value is made available in the rare case where a bfd is unavailable */
#ifndef OCTETS_PER_BYTE_POWER
#warn OCTETS_PER_BYTE_POWER not defined for this CPU, it will default to 0
#else
#define OCTETS_PER_BYTE (1<<OCTETS_PER_BYTE_POWER)
#endif

/* default alignment is on a byte (not octet!) boundary */
#ifndef COFF_DEFAULT_SECTION_ALIGNMENT_POWER
#define COFF_DEFAULT_SECTION_ALIGNMENT_POWER 0
#endif

/* TI COFF encodes the section alignment in the section header flags */
#define COFF_ALIGN_IN_SECTION_HEADER 1
#define COFF_ALIGN_IN_S_FLAGS 1
/* requires a power-of-two argument */
#define COFF_ENCODE_ALIGNMENT(S,X) ((S).s_flags |= (((unsigned)(X)&0xF)<<8))
/* result is a power of two */
#define COFF_DECODE_ALIGNMENT(X) (((X)>>8)&0xF)

#define COFF0_P(ABFD) (bfd_coff_filhsz(ABFD) == FILHSZ_V0)
#define COFF2_P(ABFD) (bfd_coff_scnhsz(ABFD) != SCNHSZ_V01)

#define COFF0_BADMAG(x) ((x).f_magic != TICOFF0MAGIC)
#define COFF1_BADMAG(x) ((x).f_magic != TICOFF1MAGIC || (x).f_target_id != TI_TARGET_ID)
#define COFF2_BADMAG(x) ((x).f_magic != TICOFF2MAGIC || (x).f_target_id != TI_TARGET_ID)

/* we need to read/write an extra field in the coff file header */
#ifndef COFF_ADJUST_FILEHDR_IN_POST
#define COFF_ADJUST_FILEHDR_IN_POST(abfd,src,dst) \
do { ((struct internal_filehdr *)(dst))->f_target_id = \
bfd_h_get_16(abfd, (bfd_byte *)(((FILHDR *)(src))->f_target_id)); \
} while(0)
#endif

#ifndef COFF_ADJUST_FILEHDR_OUT_POST
#define COFF_ADJUST_FILEHDR_OUT_POST(abfd,src,dst) \
do { bfd_h_put_16(abfd, ((struct internal_filehdr *)(src))->f_target_id, \
             (bfd_byte *)(((FILHDR *)(dst))->f_target_id)); \
} while(0)
#endif

#define	FILHDR	struct external_filehdr
#define	FILHSZ	22
#define FILHSZ_V0 20                /* COFF0 omits target_id field */

/* File header flags */
#define	F_RELFLG	(0x0001)
#define	F_EXEC		(0x0002)
#define	F_LNNO		(0x0004)
/* F_LSYMS needs to be redefined in your source file */
#define	F_LSYMS_TICOFF	(0x0010) /* normal COFF is 0x8 */

#define F_10            0x00    /* file built for TMS320C1x devices */
#define F_20            0x10    /* file built for TMS320C2x devices */
#define F_25            0x20    /* file built for TMS320C2x/C5x devices */
#define F_LENDIAN       0x0100  /* 16 bits/word, LSB first */
#define F_SYMMERGE      0x1000  /* duplicate symbols were removed */

/********************** OPTIONAL HEADER **********************/


typedef struct 
{
  char 	magic[2];		/* type of file (0x108) 		*/
  char	vstamp[2];		/* version stamp			*/
  char	tsize[4];		/* text size in bytes, padded to FW bdry*/
  char	dsize[4];		/* initialized data "  "		*/
  char	bsize[4];		/* uninitialized data "   "		*/
  char	entry[4];		/* entry pt.				*/
  char 	text_start[4];		/* base of text used for this file */
  char 	data_start[4];		/* base of data used for this file */
}
AOUTHDR;


#define AOUTHDRSZ 28
#define AOUTSZ 28


/********************** SECTION HEADER **********************/
/* COFF0, COFF1 */
struct external_scnhdr_v01 {
	char		s_name[8];	/* section name			*/
	char		s_paddr[4];	/* physical address, aliased s_nlib */
	char		s_vaddr[4];	/* virtual address		*/
	char		s_size[4];	/* section size (in WORDS)      */
	char		s_scnptr[4];	/* file ptr to raw data for section */
	char		s_relptr[4];	/* file ptr to relocation	*/
	char		s_lnnoptr[4];	/* file ptr to line numbers	*/
	char		s_nreloc[2];	/* number of relocation entries	*/
	char		s_nlnno[2];	/* number of line number entries*/
	char		s_flags[2];	/* flags			*/
        char            s_reserved[1];  /* reserved                     */ 
        char            s_page[1];      /* section page number (LOAD)   */
};

/* COFF2 */
struct external_scnhdr {
	char		s_name[8];	/* section name			*/
	char		s_paddr[4];	/* physical address, aliased s_nlib */
	char		s_vaddr[4];	/* virtual address		*/
	char		s_size[4];	/* section size (in WORDS)      */
	char		s_scnptr[4];	/* file ptr to raw data for section */
	char		s_relptr[4];	/* file ptr to relocation	*/
	char		s_lnnoptr[4];	/* file ptr to line numbers	*/
	char		s_nreloc[4];	/* number of relocation entries	*/
	char		s_nlnno[4];	/* number of line number entries*/
	char		s_flags[4];	/* flags			*/
        char            s_reserved[2];  /* reserved                     */ 
        char            s_page[2];      /* section page number (LOAD)   */
};

/*
 * Special section flags
 */

/* TI COFF defines these flags; 
   STYP_CLINK: the section should be excluded from the final
   linker output if there are no references found to any symbol in the section
   STYP_BLOCK: the section should be blocked, i.e. if the section would cross
   a page boundary, it is started at a page boundary instead.
   TI COFF puts the section alignment power of two in the section flags
   e.g. 2**N is alignment, flags |= (N & 0xF) << 8
*/ 
#define STYP_CLINK      (0x4000)
#define STYP_BLOCK      (0x1000)
#define STYP_ALIGN      (0x0F00) /* TI COFF stores section alignment here */

#define	SCNHDR_V01 struct external_scnhdr_v01
#define SCNHDR struct external_scnhdr
#define	SCNHSZ_V01 40                  /* for v0 and v1 */
#define SCNHSZ 48

/* COFF2 changes the offsets and sizes of these fields 
   Assume we're dealing with the COFF2 scnhdr structure, and adjust
   accordingly 
 */
#define GET_SCNHDR_NRELOC(ABFD,PTR) \
(COFF2_P(ABFD) ? bfd_h_get_32 (ABFD,PTR) : bfd_h_get_16 (ABFD, PTR))
#define PUT_SCNHDR_NRELOC(ABFD,VAL,PTR) \
(COFF2_P(ABFD) ? bfd_h_put_32 (ABFD,VAL,PTR) : bfd_h_put_16 (ABFD,VAL,PTR))
#define GET_SCNHDR_NLNNO(ABFD,PTR) \
(COFF2_P(ABFD) ? bfd_h_get_32 (ABFD,PTR) : bfd_h_get_16 (ABFD, (PTR)-2))
#define PUT_SCNHDR_NLNNO(ABFD,VAL,PTR) \
(COFF2_P(ABFD) ? bfd_h_put_32 (ABFD,VAL,PTR) : bfd_h_put_16 (ABFD,VAL,(PTR)-2))
#define GET_SCNHDR_FLAGS(ABFD,PTR) \
(COFF2_P(ABFD) ? bfd_h_get_32 (ABFD,PTR) : bfd_h_get_16 (ABFD, (PTR)-4))
#define PUT_SCNHDR_FLAGS(ABFD,VAL,PTR) \
(COFF2_P(ABFD) ? bfd_h_put_32 (ABFD,VAL,PTR) : bfd_h_put_16 (ABFD,VAL,(PTR)-4))
#define GET_SCNHDR_PAGE(ABFD,PTR) \
(COFF2_P(ABFD) ? bfd_h_get_16 (ABFD,PTR) : bfd_h_get_8 (ABFD, (PTR)-7))
/* on output, make sure that the "reserved" field is zero */
#define PUT_SCNHDR_PAGE(ABFD,VAL,PTR) \
(COFF2_P(ABFD) ? bfd_h_put_16 (ABFD,VAL,PTR) : \
bfd_h_put_8 (ABFD,VAL,(PTR)-7), bfd_h_put_8 (ABFD, 0, (PTR)-8))

/* TI COFF stores section size as number of bytes (address units, not octets),
   so adjust to be number of octets, which is what BFD expects */ 
#define GET_SCNHDR_SIZE(ABFD,SZP) \
(bfd_h_get_32(ABFD,SZP)*bfd_octets_per_byte(ABFD))
#define PUT_SCNHDR_SIZE(ABFD,SZ,SZP) \
bfd_h_put_32(ABFD,(SZ)/bfd_octets_per_byte(ABFD),SZP)

#define COFF_ADJUST_SCNHDR_IN_POST(ABFD,EXT,INT) \
do { ((struct internal_scnhdr *)(INT))->s_page = \
GET_SCNHDR_PAGE(ABFD,(bfd_byte *)((SCNHDR *)(EXT))->s_page); \
} while(0)

/* The line number and reloc overflow checking in coff_swap_scnhdr_out in
   coffswap.h doesn't use PUT_X for s_nlnno and s_nreloc.
   Due to different sized v0/v1/v2 section headers, we have to re-write these
   fields.
 */
#define COFF_ADJUST_SCNHDR_OUT_POST(ABFD,INT,EXT) \
do { \
PUT_SCNHDR_NLNNO(ABFD,((struct internal_scnhdr *)(INT))->s_nlnno,\
                (bfd_byte *)((SCNHDR *)(EXT))->s_nlnno); \
PUT_SCNHDR_NRELOC(ABFD,((struct internal_scnhdr *)(INT))->s_nreloc,\
                (bfd_byte *)((SCNHDR *)(EXT))->s_nreloc); \
PUT_SCNHDR_FLAGS(ABFD,((struct internal_scnhdr *)(INT))->s_flags, \
                (bfd_byte *)((SCNHDR *)(EXT))->s_flags); \
PUT_SCNHDR_PAGE(ABFD,((struct internal_scnhdr *)(INT))->s_page, \
                (bfd_byte *)((SCNHDR *)(EXT))->s_page); \
} while(0)

/* Page macros

   The first GDB port requires flags in its remote memory access commands to
   distinguish between data/prog space.  hopefully we can make this go away
   eventually.  stuff the page in the upper bits of a 32-bit address, since
   the c5x family only uses 16 or 23 bits.

   c2x, c5x and most c54x devices have 16-bit addresses, but the c548 has
   23-bit program addresses.  make sure the page flags don't interfere 
   These flags are used by GDB to identify the destination page for
   addresses. 
*/

/* recognized load pages */
#define PG_PROG         0x0         /* PROG page */
#define PG_DATA         0x1         /* DATA page */

#define ADDR_MASK       0x00FFFFFF
#define PG_TO_FLAG(p)   (((unsigned long)(p) & 0xFF) << 24)
#define FLAG_TO_PG(f)   (((f) >> 24) & 0xFF)

/*
 * names of "special" sections
 */
#define _TEXT	".text"
#define _DATA	".data"
#define _BSS	".bss"
#define _CINIT  ".cinit"            /* initialized C data */
#define _SCONST  ".const"           /* constants */
#define _SWITCH ".switch"           /* switch tables */
#define _STACK  ".stack"            /* C stack */
#define _SYSMEM ".sysmem"           /* used for malloc et al. syscalls */

/********************** LINE NUMBERS **********************/

/* 1 line number entry for every "breakpointable" source line in a section.
 * Line numbers are grouped on a per function basis; first entry in a function
 * grouping will have l_lnno = 0 and in place of physical address will be the
 * symbol table index of the function name.
 */
struct external_lineno {
  union {
    char l_symndx[4];	/* function name symbol index, iff l_lnno == 0*/
    char l_paddr[4];	/* (physical) address of line number	*/
  } l_addr;
  char l_lnno[2];	/* line number		*/
};

#define	LINENO	struct external_lineno
#define	LINESZ	6


/********************** SYMBOLS **********************/

/* NOTE: this is what a local label looks like in assembly source; what it
   looks like in COFF output is undefined */
#define TICOFF_LOCAL_LABEL_P(NAME) \
((NAME[0] == '$' && NAME[1] >= '0' && NAME[1] <= '9' && NAME[2] == '\0') \
 || NAME[strlen(NAME)-1] == '?')

#define E_SYMNMLEN	8	/* # characters in a symbol name	*/
#define E_FILNMLEN	14	/* # characters in a file name		*/
#define E_DIMNUM	4	/* # array dimensions in auxiliary entry */

struct external_syment 
{
  union {
    char e_name[E_SYMNMLEN];
    struct {
      char e_zeroes[4];
      char e_offset[4];
    } e;
  } e;
  char e_value[4];
  char e_scnum[2];
  char e_type[2];
  char e_sclass[1];
  char e_numaux[1];
};


#define N_BTMASK	(017)
#define N_TMASK		(060)
#define N_BTSHFT	(4)
#define N_TSHIFT	(2)
  

union external_auxent {
  struct {
	char x_tagndx[4];	/* str, un, or enum tag indx */
	union {
	  struct {
		char  x_lnno[2]; /* declaration line number */
		char  x_size[2]; /* str/union/array size */
	  } x_lnsz;
	  char x_fsize[4];	/* size of function */
	} x_misc;
	union {
	  struct {		/* if ISFCN, tag, or .bb */
		char x_lnnoptr[4];	/* ptr to fcn line # */
		char x_endndx[4];	/* entry ndx past block end */
	  } x_fcn;
	  struct {		/* if ISARY, up to 4 dimen. */
		char x_dimen[E_DIMNUM][2];
	  } x_ary;
	} x_fcnary;
	char x_tvndx[2];		/* tv index */
  } x_sym;
  
  union {
	char x_fname[E_FILNMLEN];
	struct {
	  char x_zeroes[4];
	  char x_offset[4];
	} x_n;
  } x_file;
  
  struct {
	char x_scnlen[4];			/* section length */
	char x_nreloc[2];	/* # relocation entries */
	char x_nlinno[2];	/* # line numbers */
  } x_scn;
  
  struct {
	char x_tvfill[4];	/* tv fill value */
	char x_tvlen[2];	/* length of .tv */
	char x_tvran[2][2];	/* tv range */
  } x_tv;		/* info about .tv section (in auxent of symbol .tv)) */
  

};

#define	SYMENT	struct external_syment
#define	SYMESZ	18	
#define	AUXENT	union external_auxent
#define	AUXESZ	18

/* section lengths are in target bytes (not host bytes) */
#define GET_SCN_SCNLEN(ABFD,EXT) \
(bfd_h_get_32(ABFD,(bfd_byte *)(EXT)->x_scn.x_scnlen)*bfd_octets_per_byte(ABFD))
#define PUT_SCN_SCNLEN(ABFD,INT,EXT) \
bfd_h_put_32(ABFD,(INT)/bfd_octets_per_byte(ABFD),\
             (bfd_byte *)(EXT)->x_scn.x_scnlen)

/* lnsz size is in bits in COFF file, in bytes in BFD */
#define GET_LNSZ_SIZE(abfd, ext) \
(bfd_h_get_16(abfd, (bfd_byte *)ext->x_sym.x_misc.x_lnsz.x_size) / \
 (class != C_FIELD ? 8 : 1))

#define PUT_LNSZ_SIZE(abfd, in, ext) \
 bfd_h_put_16(abfd, ((class != C_FIELD) ? (in)*8 : (in)), \
              (bfd_byte*) ext->x_sym.x_misc.x_lnsz.x_size)
 
/* TI COFF stores offsets for MOS and MOU in bits; BFD expects bytes */
#define COFF_ADJUST_SYM_IN_POST(ABFD,EXT,INT) \
do { struct internal_syment *dst = (struct internal_syment *)(INT); \
if (dst->n_sclass == C_MOS || dst->n_sclass == C_MOU) dst->n_value /= 8; \
} while (0)

#define COFF_ADJUST_SYM_OUT_POST(ABFD,INT,EXT) \
do { struct internal_syment *src = (struct internal_syment *)(INT); \
SYMENT *dst = (SYMENT *)(EXT); \
if(src->n_sclass == C_MOU || src->n_sclass == C_MOS) \
bfd_h_put_32(abfd,src->n_value * 8,(bfd_byte *)dst->e_value); \
} while (0)

/* Detect section-relative absolute symbols so they get flagged with a sym
   index of -1.
*/
#define SECTION_RELATIVE_ABSOLUTE_SYMBOL_P(RELOC,SECT) \
((*(RELOC)->sym_ptr_ptr)->section->output_section == (SECT) \
 && (RELOC)->howto->name[0] == 'A')

/********************** RELOCATION DIRECTIVES **********************/

struct external_reloc_v0 {
  char r_vaddr[4];
  char r_symndx[2];
  char r_reserved[2];
  char r_type[2];
};

struct external_reloc {
  char r_vaddr[4];
  char r_symndx[4];
  char r_reserved[2]; /* extended pmad byte for COFF2 */
  char r_type[2];
};

#define RELOC struct external_reloc
#define RELSZ_V0 10                 /* FIXME -- coffcode.h needs fixing */
#define RELSZ 12                    /* for COFF1/2 */

/* various relocation types.  */
#define R_ABS     0x0000            /* no relocation */
#define R_REL13   0x002A            /* 13-bit direct reference (???) */
#define R_PARTLS7 0x0028            /* 7 LSBs of an address */
#define R_PARTMS9 0x0029            /* 9MSBs of an address */
#define R_EXTWORD 0x002B            /* 23-bit direct reference */
#define R_EXTWORD16 0x002C          /* 16-bit direct reference to 23-bit addr*/
#define R_EXTWORDMS7 0x002D         /* upper 7 bits of 23-bit address */

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