[deliverable/binutils-gdb.git] / gas / write.h

/* write.h
   Copyright 1987, 1992, 1993, 1994, 1995, 1996, 1997, 1999, 2000, 2001
   Free Software Foundation, Inc.

   This file is part of GAS, the GNU Assembler.

   GAS 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, or (at your option)
   any later version.

   GAS 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 GAS; see the file COPYING.  If not, write to the Free
   Software Foundation, 59 Temple Place - Suite 330, Boston, MA
   02111-1307, USA.  */

#ifndef __write_h__
#define __write_h__

#ifndef TC_I960
#ifdef hpux
#define EXEC_MACHINE_TYPE HP9000S200_ID
#endif
#endif /* TC_I960 */

#ifndef BFD_ASSEMBLER

#ifndef LOCAL_LABEL
#define LOCAL_LABEL(name) (name [0] == 'L' )
#endif

#define S_LOCAL_NAME(s) (LOCAL_LABEL (S_GET_NAME (s)))

#endif /* ! BFD_ASSEMBLER */

/* This is the name of a fake symbol which will never appear in the
   assembler output.  S_IS_LOCAL detects it because of the \001.  */
#define FAKE_LABEL_NAME "L0\001"

#include "bit_fix.h"

/*
 * FixSs may be built up in any order.
 */

struct fix
{
  /* These small fields are grouped together for compactness of
     this structure, and efficiency of access on some architectures.  */

  /* pc-relative offset adjust (only used by m68k) */
  char fx_pcrel_adjust;

  /* How many bytes are involved? */
  unsigned char fx_size;

  /* Is this a pc-relative relocation?  */
  unsigned fx_pcrel : 1;

  /* Is this a relocation to a procedure linkage table entry?  If so,
     some of the reductions we try to apply are invalid.  A better way
     might be to represent PLT entries with different kinds of
     symbols, and use normal relocations (with undefined symbols);
     look into it for version 2.6.  */
  unsigned fx_plt : 1;

  /* Is this value an immediate displacement?  */
  /* Only used on i960 and ns32k; merge it into TC_FIX_TYPE sometime.  */
  unsigned fx_im_disp : 2;

  /* A bit for the CPU specific code.
     This probably can be folded into tc_fix_data, below.  */
  unsigned fx_tcbit : 1;

  /* Has this relocation already been applied?  */
  unsigned fx_done : 1;

  /* Suppress overflow complaints on large addends.  This is used
     in the PowerPC ELF config to allow large addends on the
     BFD_RELOC_{LO16,HI16,HI16_S} relocations.

     @@ Can this be determined from BFD?  */
  unsigned fx_no_overflow : 1;

  /* The value is signed when checking for overflow.  */
  unsigned fx_signed : 1;

  /* Which frag does this fix apply to?  */
  fragS *fx_frag;

  /* Where is the first byte to fix up?  */
  long fx_where;

  /* NULL or Symbol whose value we add in.  */
  symbolS *fx_addsy;

  /* NULL or Symbol whose value we subtract.  */
  symbolS *fx_subsy;

  /* Absolute number we add in.  */
  valueT fx_offset;

  /* Next fixS in linked list, or NULL.  */
  struct fix *fx_next;

  /* If NULL, no bitfix's to do.  */
  /* Only i960-coff and ns32k use this, and i960-coff stores an
     integer.  This can probably be folded into tc_fix_data, below.
     @@ Alpha also uses it, but only to disable certain relocation
     processing.  */
  bit_fixS *fx_bit_fixP;

#ifdef BFD_ASSEMBLER
  bfd_reloc_code_real_type fx_r_type;
#else
#ifdef NEED_FX_R_TYPE
  /* Hack for machines where the type of reloc can't be
     worked out by looking at how big it is.  */
  int fx_r_type;
#endif
#endif

  /* This field is sort of misnamed.  It appears to be a sort of random
     scratch field, for use by the back ends.  The main gas code doesn't
     do anything but initialize it to zero.  The use of it does need to
     be coordinated between the cpu and format files, though.  E.g., some
     coff targets pass the `addend' field from the cpu file via this
     field.  I don't know why the `fx_offset' field above can't be used
     for that; investigate later and document. KR  */
  valueT fx_addnumber;

  /* The location of the instruction which created the reloc, used
     in error messages.  */
  char *fx_file;
  unsigned fx_line;

#ifdef USING_CGEN
  struct {
    /* CGEN_INSN entry for this instruction.  */
    const struct cgen_insn *insn;
    /* Target specific data, usually reloc number.  */
    int opinfo;
  } fx_cgen;
#endif

#ifdef TC_FIX_TYPE
  /* Location where a backend can attach additional data
     needed to perform fixups.  */
  TC_FIX_TYPE tc_fix_data;
#endif
};

typedef struct fix fixS;

#ifndef BFD_ASSEMBLER
extern char *next_object_file_charP;

#ifndef MANY_SEGMENTS
COMMON fixS *text_fix_root, *text_fix_tail;	/* Chains fixSs.  */
COMMON fixS *data_fix_root, *data_fix_tail;	/* Chains fixSs.  */
COMMON fixS *bss_fix_root, *bss_fix_tail;	/* Chains fixSs.  */
extern struct frag *text_last_frag;		/* Last frag in segment.  */
extern struct frag *data_last_frag;		/* Last frag in segment.  */
#endif
COMMON fixS **seg_fix_rootP, **seg_fix_tailP;	/* -> one of above.  */
#endif

extern long string_byte_count;
extern int section_alignment[];

extern bit_fixS *bit_fix_new
  PARAMS ((int size, int offset, long base_type, long base_adj, long min,
	   long max, long add));
extern void append PARAMS ((char **charPP, char *fromP, unsigned long length));
extern void record_alignment PARAMS ((segT seg, int align));
extern int get_recorded_alignment PARAMS ((segT seg));
extern void subsegs_finish PARAMS ((void));
extern void write_object_file PARAMS ((void));
extern long relax_frag PARAMS ((segT, fragS *, long));
extern void relax_segment
  PARAMS ((struct frag * seg_frag_root, segT seg_type));

extern void number_to_chars_littleendian PARAMS ((char *, valueT, int));
extern void number_to_chars_bigendian    PARAMS ((char *, valueT, int));

#ifdef BFD_ASSEMBLER
extern fixS *fix_new
  PARAMS ((fragS * frag, int where, int size, symbolS * add_symbol,
	   offsetT offset, int pcrel, bfd_reloc_code_real_type r_type));
extern fixS *fix_new_exp
  PARAMS ((fragS * frag, int where, int size, expressionS *exp, int pcrel,
	   bfd_reloc_code_real_type r_type));
#else
extern fixS *fix_new
  PARAMS ((fragS * frag, int where, int size, symbolS * add_symbol,
	   offsetT offset, int pcrel, int r_type));
extern fixS *fix_new_exp
  PARAMS ((fragS * frag, int where, int size, expressionS *exp, int pcrel,
	   int r_type));
#endif

extern void write_print_statistics PARAMS ((FILE *));

#endif /* __write_h__ */
Commit	Line	Data
252b5132	1	/* write.h
f7e42eb4	2	Copyright 1987, 1992, 1993, 1994, 1995, 1996, 1997, 1999, 2000, 2001
a01b9fa4	3	Free Software Foundation, Inc.
252b5132 RH	4
	5	This file is part of GAS, the GNU Assembler.
	6
	7	GAS 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, or (at your option)
	10	any later version.
	11
	12	GAS 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 GAS; see the file COPYING. If not, write to the Free
	19	Software Foundation, 59 Temple Place - Suite 330, Boston, MA
	20	02111-1307, USA. */
	21
	22	#ifndef __write_h__
	23	#define __write_h__
	24
	25	#ifndef TC_I960
	26	#ifdef hpux
	27	#define EXEC_MACHINE_TYPE HP9000S200_ID
	28	#endif
	29	#endif /* TC_I960 */
	30
	31	#ifndef BFD_ASSEMBLER
	32
	33	#ifndef LOCAL_LABEL
	34	#define LOCAL_LABEL(name) (name [0] == 'L' )
	35	#endif
	36
	37	#define S_LOCAL_NAME(s) (LOCAL_LABEL (S_GET_NAME (s)))
	38
	39	#endif /* ! BFD_ASSEMBLER */
	40
	41	/* This is the name of a fake symbol which will never appear in the
	42	assembler output. S_IS_LOCAL detects it because of the \001. */
	43	#define FAKE_LABEL_NAME "L0\001"
	44
	45	#include "bit_fix.h"
	46
	47	/*
	48	* FixSs may be built up in any order.
	49	*/
	50
	51	struct fix
	52	{
	53	/* These small fields are grouped together for compactness of
	54	this structure, and efficiency of access on some architectures. */
	55
	56	/* pc-relative offset adjust (only used by m68k) */
	57	char fx_pcrel_adjust;
	58
	59	/* How many bytes are involved? */
	60	unsigned char fx_size;
	61
	62	/* Is this a pc-relative relocation? */
	63	unsigned fx_pcrel : 1;
	64
	65	/* Is this a relocation to a procedure linkage table entry? If so,
	66	some of the reductions we try to apply are invalid. A better way
	67	might be to represent PLT entries with different kinds of
68	symbols, and use normal relocations (with undefined symbols);
69	look into it for version 2.6. */
70	unsigned fx_plt : 1;
71
72	/* Is this value an immediate displacement? */
73	/* Only used on i960 and ns32k; merge it into TC_FIX_TYPE sometime. */
74	unsigned fx_im_disp : 2;
75
76	/* A bit for the CPU specific code.
77	This probably can be folded into tc_fix_data, below. */
78	unsigned fx_tcbit : 1;
79
80	/* Has this relocation already been applied? */
81	unsigned fx_done : 1;
82
83	/* Suppress overflow complaints on large addends. This is used
84	in the PowerPC ELF config to allow large addends on the
85	BFD_RELOC_{LO16,HI16,HI16_S} relocations.
86
87	@@ Can this be determined from BFD? */
88	unsigned fx_no_overflow : 1;
89
90	/* The value is signed when checking for overflow. */
91	unsigned fx_signed : 1;
92
93	/* Which frag does this fix apply to? */
94	fragS *fx_frag;
95
96	/* Where is the first byte to fix up? */
97	long fx_where;
98
a01b9fa4	99	/* NULL or Symbol whose value we add in. */
252b5132 RH	100	symbolS *fx_addsy;
252b5132 RH	101
a01b9fa4	102	/* NULL or Symbol whose value we subtract. */
252b5132 RH	103	symbolS *fx_subsy;
252b5132 RH	104
a01b9fa4	105	/* Absolute number we add in. */
252b5132 RH	106	valueT fx_offset;
	107
	108	/* Next fixS in linked list, or NULL. */
	109	struct fix *fx_next;
	110
	111	/* If NULL, no bitfix's to do. */
	112	/* Only i960-coff and ns32k use this, and i960-coff stores an
	113	integer. This can probably be folded into tc_fix_data, below.
	114	@@ Alpha also uses it, but only to disable certain relocation
	115	processing. */
	116	bit_fixS *fx_bit_fixP;
	117
	118	#ifdef BFD_ASSEMBLER
	119	bfd_reloc_code_real_type fx_r_type;
	120	#else
	121	#ifdef NEED_FX_R_TYPE
	122	/* Hack for machines where the type of reloc can't be
	123	worked out by looking at how big it is. */
	124	int fx_r_type;
	125	#endif
	126	#endif
	127
	128	/* This field is sort of misnamed. It appears to be a sort of random
	129	scratch field, for use by the back ends. The main gas code doesn't
	130	do anything but initialize it to zero. The use of it does need to
	131	be coordinated between the cpu and format files, though. E.g., some
	132	coff targets pass the `addend' field from the cpu file via this
	133	field. I don't know why the `fx_offset' field above can't be used
	134	for that; investigate later and document. KR */
	135	valueT fx_addnumber;
	136
	137	/* The location of the instruction which created the reloc, used
	138	in error messages. */
	139	char *fx_file;
	140	unsigned fx_line;
	141
	142	#ifdef USING_CGEN
	143	struct {
	144	/* CGEN_INSN entry for this instruction. */
	145	const struct cgen_insn *insn;
	146	/* Target specific data, usually reloc number. */
	147	int opinfo;
	148	} fx_cgen;
	149	#endif
	150
	151	#ifdef TC_FIX_TYPE
	152	/* Location where a backend can attach additional data
	153	needed to perform fixups. */
	154	TC_FIX_TYPE tc_fix_data;
	155	#endif
	156	};
	157
	158	typedef struct fix fixS;
	159
	160	#ifndef BFD_ASSEMBLER
	161	extern char *next_object_file_charP;
	162
	163	#ifndef MANY_SEGMENTS
a01b9fa4 KH	164	COMMON fixS text_fix_root, text_fix_tail; /* Chains fixSs. */
	165	COMMON fixS data_fix_root, data_fix_tail; /* Chains fixSs. */
	166	COMMON fixS bss_fix_root, bss_fix_tail; /* Chains fixSs. */
	167	extern struct frag text_last_frag; / Last frag in segment. */
	168	extern struct frag data_last_frag; / Last frag in segment. */
252b5132	169	#endif
a01b9fa4	170	COMMON fixS seg_fix_rootP, seg_fix_tailP; /* -> one of above. */
252b5132 RH	171	#endif
	172
	173	extern long string_byte_count;
	174	extern int section_alignment[];
	175
	176	extern bit_fixS *bit_fix_new
	177	PARAMS ((int size, int offset, long base_type, long base_adj, long min,
	178	long max, long add));
	179	extern void append PARAMS ((char *charPP, char fromP, unsigned long length));
	180	extern void record_alignment PARAMS ((segT seg, int align));
0a9ef439	181	extern int get_recorded_alignment PARAMS ((segT seg));
252b5132 RH	182	extern void subsegs_finish PARAMS ((void));
252b5132 RH	183	extern void write_object_file PARAMS ((void));
c842b53a	184	extern long relax_frag PARAMS ((segT, fragS *, long));
252b5132 RH	185	extern void relax_segment
	186	PARAMS ((struct frag * seg_frag_root, segT seg_type));
	187
	188	extern void number_to_chars_littleendian PARAMS ((char *, valueT, int));
	189	extern void number_to_chars_bigendian PARAMS ((char *, valueT, int));
	190
	191	#ifdef BFD_ASSEMBLER
	192	extern fixS *fix_new
	193	PARAMS ((fragS * frag, int where, int size, symbolS * add_symbol,
	194	offsetT offset, int pcrel, bfd_reloc_code_real_type r_type));
	195	extern fixS *fix_new_exp
	196	PARAMS ((fragS * frag, int where, int size, expressionS *exp, int pcrel,
	197	bfd_reloc_code_real_type r_type));
	198	#else
	199	extern fixS *fix_new
	200	PARAMS ((fragS * frag, int where, int size, symbolS * add_symbol,
	201	offsetT offset, int pcrel, int r_type));
	202	extern fixS *fix_new_exp
	203	PARAMS ((fragS * frag, int where, int size, expressionS *exp, int pcrel,
	204	int r_type));
	205	#endif
	206
	207	extern void write_print_statistics PARAMS ((FILE *));
	208
	209	#endif /* __write_h__ */