[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).
   
   Copyright 2000, 2001, 2002, 2003 Free Software Foundation, Inc.

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.
   
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
   
   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.  */
#ifndef COFF_TI_H
#define COFF_TI_H

/* Note "coff/external.h is not used because TI adds extra fields to the structures.  */

/********************** 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

#ifndef TICOFF_TARGET_MACHINE_GET
#define TICOFF_TARGET_MACHINE_GET(FLAGS) 0
#endif

#ifndef TICOFF_TARGET_MACHINE_SET
#define TICOFF_TARGET_MACHINE_SET(FLAGSP, MACHINE)
#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
#error "OCTETS_PER_BYTE_POWER not defined for this CPU"
#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 =			\
	H_GET_16 (abfd, ((FILHDR *)(src))->f_target_id);		\
    }									\
  while (0)
#endif

#ifndef COFF_ADJUST_FILEHDR_OUT_POST
#define COFF_ADJUST_FILEHDR_OUT_POST(abfd, src, dst) \
  do									\
    {									\
      H_PUT_16 (abfd, ((struct internal_filehdr *)(src))->f_target_id,	\
	       ((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)
#define F_VERS          (0x0010) /* TMS320C4x code */
/* 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, LOC) \
  (COFF2_P (ABFD) ? H_GET_32 (ABFD, LOC) : H_GET_16 (ABFD, LOC))
#define PUT_SCNHDR_NRELOC(ABFD, VAL, LOC) \
  (COFF2_P (ABFD) ? H_PUT_32 (ABFD, VAL, LOC) : H_PUT_16 (ABFD, VAL, LOC))
#define GET_SCNHDR_NLNNO(ABFD, LOC) \
  (COFF2_P (ABFD) ? H_GET_32 (ABFD, LOC) : H_GET_16 (ABFD, (LOC) - 2))
#define PUT_SCNHDR_NLNNO(ABFD, VAL, LOC) \
  (COFF2_P (ABFD) ? H_PUT_32 (ABFD, VAL, LOC) : H_PUT_16 (ABFD, VAL, (LOC) - 2))
#define GET_SCNHDR_FLAGS(ABFD, LOC) \
  (COFF2_P (ABFD) ? H_GET_32 (ABFD, LOC) : H_GET_16 (ABFD, (LOC) - 4))
#define PUT_SCNHDR_FLAGS(ABFD, VAL, LOC) \
  (COFF2_P (ABFD) ? H_PUT_32 (ABFD, VAL, LOC) : H_PUT_16 (ABFD, VAL, (LOC) - 4))
#define GET_SCNHDR_PAGE(ABFD, LOC) \
  (COFF2_P (ABFD) ? H_GET_16 (ABFD, LOC) : (unsigned) H_GET_8 (ABFD, (LOC) - 7))
/* on output, make sure that the "reserved" field is zero */
#define PUT_SCNHDR_PAGE(ABFD, VAL, LOC) \
  (COFF2_P (ABFD) \
   ? H_PUT_16 (ABFD, VAL, LOC) \
   : H_PUT_8 (ABFD, VAL, (LOC) - 7), H_PUT_8 (ABFD, 0, (LOC) - 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) \
  (H_GET_32 (ABFD, SZP) * bfd_octets_per_byte (ABFD))
#define PUT_SCNHDR_SIZE(ABFD, SZ, SZP) \
  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, ((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,  \
			((SCNHDR *)(EXT))->s_nlnno);			   \
      PUT_SCNHDR_NRELOC (ABFD, ((struct internal_scnhdr *)(INT))->s_nreloc,\
			 ((SCNHDR *)(EXT))->s_nreloc);			   \
      PUT_SCNHDR_FLAGS (ABFD, ((struct internal_scnhdr *)(INT))->s_flags,  \
			((SCNHDR *)(EXT))->s_flags);			   \
      PUT_SCNHDR_PAGE (ABFD, ((struct internal_scnhdr *)(INT))->s_page,    \
		       ((SCNHDR *)(EXT))->s_page);			   \
    }									   \
   while (0)

/*
 * 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) \
  (H_GET_32 (ABFD, (EXT)->x_scn.x_scnlen) * bfd_octets_per_byte (ABFD))
#define PUT_SCN_SCNLEN(ABFD, INT, EXT) \
  H_PUT_32 (ABFD, (INT) / bfd_octets_per_byte (ABFD), (EXT)->x_scn.x_scnlen)

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

#define PUT_LNSZ_SIZE(abfd, in, ext) \
  H_PUT_16 (abfd, ((class != C_FIELD) ? (in) * 8 : (in)), \
	   ext->x_sym.x_misc.x_lnsz.x_size)
 
/* TI COFF stores offsets for MOS and MOU in bits; BFD expects bytes 
   Also put the load page flag of the section into the symbol value if it's an
   address.  */
#ifndef NEEDS_PAGE
#define NEEDS_PAGE(X) 0
#define PAGE_MASK 0
#endif
#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;						\
      else if (NEEDS_PAGE (dst->n_sclass)) {                            \
        asection *scn = coff_section_from_bfd_index (abfd, dst->n_scnum); \
        dst->n_value |= (scn->lma & PAGE_MASK);                         \
      }									\
    }									\
   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)		\
	 H_PUT_32 (abfd, src->n_value * 8, dst->e_value);		\
       else if (NEEDS_PAGE (src->n_sclass)) {                           \
         H_PUT_32 (abfd, src->n_value &= ~PAGE_MASK, 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
a44f2895 TW	2	customized in a target-specific file, and then this file included (see
4f1d9bd8 NC	3	tic54x.h for an example).
4f1d9bd8 NC	4
c3aa17e9	5	Copyright 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
4f1d9bd8 NC	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
e172dbf8	19	Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */
a44f2895 TW	20	#ifndef COFF_TI_H
a44f2895 TW	21	#define COFF_TI_H
81635ce4	22
4f1d9bd8 NC	23	/* Note "coff/external.h is not used because TI adds extra fields to the structures. */
4f1d9bd8 NC	24
81635ce4 TW	25	/******************** FILE HEADER ********************/
81635ce4 TW	26
4f1d9bd8 NC	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	};
81635ce4 TW	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
0da35f8b SS	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
81635ce4 TW	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
d58c3cb8	75	#error "OCTETS_PER_BYTE_POWER not defined for this CPU"
81635ce4 TW	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
2eda3bbc AM	102	#define COFF_ADJUST_FILEHDR_IN_POST(abfd, src, dst) \
	103	do \
	104	{ \
	105	((struct internal_filehdr *)(dst))->f_target_id = \
6e917903	106	H_GET_16 (abfd, ((FILHDR *)(src))->f_target_id); \
2eda3bbc AM	107	} \
2eda3bbc AM	108	while (0)
81635ce4 TW	109	#endif
	110
	111	#ifndef COFF_ADJUST_FILEHDR_OUT_POST
2eda3bbc AM	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)
81635ce4 TW	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)
026df7c5	129	#define F_VERS (0x0010) /* TMS320C4x code */
81635ce4 TW	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
81635ce4	195	*/
81635ce4 TW	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.
a44f2895 TW	202	TI COFF puts the section alignment power of two in the section flags
a44f2895 TW	203	e.g. 2**N is alignment, flags \|= (N & 0xF) << 8
81635ce4 TW	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	*/
8cf3f354 AM	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))
81635ce4	232	/* on output, make sure that the "reserved" field is zero */
8cf3f354	233	#define PUT_SCNHDR_PAGE(ABFD, VAL, LOC) \
2eda3bbc	234	(COFF2_P (ABFD) \
8cf3f354 AM	235	? H_PUT_16 (ABFD, VAL, LOC) \
8cf3f354 AM	236	: H_PUT_8 (ABFD, VAL, (LOC) - 7), H_PUT_8 (ABFD, 0, (LOC) - 8))
81635ce4 TW	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 */
2eda3bbc AM	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)
81635ce4 TW	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	*/
2eda3bbc AM	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)
81635ce4	271
81635ce4 TW	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) */
2eda3bbc AM	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)
81635ce4 TW	393
	394	/* lnsz size is in bits in COFF file, in bytes in BFD */
	395	#define GET_LNSZ_SIZE(abfd, ext) \
2eda3bbc	396	(H_GET_16 (abfd, ext->x_sym.x_misc.x_lnsz.x_size) / (class != C_FIELD ? 8 : 1))
81635ce4 TW	397
81635ce4 TW	398	#define PUT_LNSZ_SIZE(abfd, in, ext) \
2eda3bbc AM	399	H_PUT_16 (abfd, ((class != C_FIELD) ? (in) * 8 : (in)), \
2eda3bbc AM	400	ext->x_sym.x_misc.x_lnsz.x_size)
81635ce4	401
6e917903 TW	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
2eda3bbc AM	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; \
6e917903 TW	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	} \
2eda3bbc AM	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); \
6e917903 TW	429	else if (NEEDS_PAGE (src->n_sclass)) { \
	430	H_PUT_32 (abfd, src->n_value &= ~PAGE_MASK, dst->e_value); \
	431	} \
2eda3bbc AM	432	} \
2eda3bbc AM	433	while (0)
81635ce4	434
a44f2895 TW	435	/* Detect section-relative absolute symbols so they get flagged with a sym
a44f2895 TW	436	index of -1.
81635ce4	437	*/
2eda3bbc AM	438	#define SECTION_RELATIVE_ABSOLUTE_SYMBOL_P(RELOC, SECT) \
	439	((*(RELOC)->sym_ptr_ptr)->section->output_section == (SECT) \
	440	&& (RELOC)->howto->name[0] == 'A')
81635ce4 TW	441
	442	/******************** RELOCATION DIRECTIVES ********************/
	443
4f1d9bd8 NC	444	struct external_reloc_v0
4f1d9bd8 NC	445	{
81635ce4 TW	446	char r_vaddr[4];
	447	char r_symndx[2];
	448	char r_reserved[2];
	449	char r_type[2];
	450	};
	451
4f1d9bd8 NC	452	struct external_reloc
4f1d9bd8 NC	453	{
81635ce4 TW	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 */
a44f2895 TW	472
a44f2895 TW	473	#endif /* COFF_TI_H */