(root)/
binutils-2.41/
gas/
config/
tc-nds32.h
       1  /* tc-nds32.h -- Header file for tc-nds32.c.
       2     Copyright (C) 2012-2023 Free Software Foundation, Inc.
       3     Contributed by Andes Technology Corporation.
       4  
       5     This file is part of GAS.
       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 3, 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, 51 Franklin Street - Fifth Floor, Boston, MA
      20     02110-1301, USA.  */
      21  
      22  #ifndef TC_NDS32
      23  #define TC_NDS32
      24  
      25  #include <stdint.h>
      26  
      27  /* Enum mapping symbol.  */
      28  enum mstate
      29  {
      30    MAP_UNDEFINED = 0,	/* Must be zero, for seginfo in new sections.  */
      31    MAP_DATA,
      32    MAP_CODE,
      33  };
      34  #define TC_SEGMENT_INFO_TYPE struct nds32_segment_info_type
      35  
      36  /* For mapping symbol.  */
      37  struct nds32_segment_info_type
      38  {
      39    enum mstate mapstate;
      40  };
      41  
      42  #define LISTING_HEADER \
      43    (target_big_endian ? "NDS32 GAS" : "NDS32 GAS Little Endian")
      44  
      45  /* The target BFD architecture.  */
      46  #define TARGET_ARCH		bfd_arch_nds32
      47  
      48  /* mapping to mach_table[5] */
      49  #define ISA_V1      bfd_mach_n1h
      50  #define ISA_V2      bfd_mach_n1h_v2
      51  #define ISA_V3      bfd_mach_n1h_v3
      52  #define ISA_V3M     bfd_mach_n1h_v3m
      53  
      54  /* Default to big endian. Please note that for Andes architecture,
      55     instructions are always in big-endian format.  */
      56  #ifndef TARGET_BYTES_BIG_ENDIAN
      57  #define TARGET_BYTES_BIG_ENDIAN	1
      58  #endif
      59  
      60  /* as.c.  */
      61  /* Extend GAS command line option handling capability.  */
      62  extern int nds32_parse_option (int, const char *);
      63  extern void nds32_after_parse_args (void);
      64  /* The endianness of the target format may change based on command
      65     line arguments.  */
      66  extern const char * nds32_target_format (void);
      67  
      68  #define md_parse_option(optc, optarg)	nds32_parse_option (optc, optarg)
      69  #define md_after_parse_args()		nds32_after_parse_args ()
      70  #define TARGET_FORMAT nds32_target_format()
      71  
      72  /* expr.c */
      73  extern int nds32_parse_name (char const *, expressionS *, enum expr_mode, char *);
      74  extern bool nds32_allow_local_subtract (expressionS *, expressionS *, segT);
      75  #define md_parse_name(name, exprP, mode, nextcharP) \
      76  	nds32_parse_name (name, exprP, mode, nextcharP)
      77  #define md_allow_local_subtract(lhs,rhs,sect)	nds32_allow_local_subtract (lhs, rhs, sect)
      78  
      79  /* dwarf2dbg.c.  */
      80  #define DWARF2_USE_FIXED_ADVANCE_PC		1
      81  
      82  /* write.c.  */
      83  extern long nds32_pcrel_from_section (struct fix *, segT);
      84  extern bool nds32_fix_adjustable (struct fix *);
      85  extern void nds32_frob_file (void);
      86  extern void nds32_post_relax_hook (void);
      87  extern void nds32_frob_file_before_fix (void);
      88  extern void elf_nds32_final_processing (void);
      89  extern int nds32_validate_fix_sub (struct fix *, segT);
      90  extern int nds32_force_relocation (struct fix *);
      91  
      92  /* Fill in rs_align_code fragments.  TODO: Review this.  */
      93  extern void nds32_handle_align (fragS *);
      94  extern int nds32_relax_frag (segT, fragS *, long);
      95  extern int tc_nds32_regname_to_dw2regnum (char *);
      96  extern void tc_nds32_frame_initial_instructions (void);
      97  
      98  #define MD_PCREL_FROM_SECTION(fix, sect)	nds32_pcrel_from_section (fix, sect)
      99  #define TC_FINALIZE_SYMS_BEFORE_SIZE_SEG	0
     100  #define tc_fix_adjustable(FIX)			nds32_fix_adjustable (FIX)
     101  #define md_apply_fix(fixP, addn, seg)		nds32_apply_fix (fixP, addn, seg)
     102  #define md_post_relax_hook			nds32_post_relax_hook ()
     103  #define tc_frob_file_before_fix()		nds32_frob_file_before_fix ()
     104  #define elf_tc_final_processing()		elf_nds32_final_processing ()
     105  /* For DIFF relocations.  The default behavior is inconsistent with the
     106     asm internal document.  */
     107  #define TC_FORCE_RELOCATION_SUB_SAME(FIX, SEC)		\
     108    (GENERIC_FORCE_RELOCATION_SUB_SAME (FIX, SEC)		\
     109     || TC_FORCE_RELOCATION (FIX))
     110  #define TC_FORCE_RELOCATION(fix)		nds32_force_relocation (fix)
     111  #define TC_VALIDATE_FIX_SUB(FIX,SEG)		nds32_validate_fix_sub (FIX,SEG)
     112  #define GAS_SORT_RELOCS				1
     113  /* Values passed to md_apply_fix don't include the symbol value.  */
     114  #define MD_APPLY_SYM_VALUE(FIX)			0
     115  #define HANDLE_ALIGN(f)				nds32_handle_align (f)
     116  #undef DIFF_EXPR_OK				/* They should be fixed in linker.  */
     117  #define md_relax_frag(segment, fragP, stretch)	nds32_relax_frag (segment, fragP, stretch)
     118  #define WORKING_DOT_WORD			/* We don't need to handle .word strangely.  */
     119  /* Using to chain fixup with previous fixup.  */
     120  #define TC_FIX_TYPE struct fix *
     121  #define TC_INIT_FIX_DATA(fixP)		\
     122    do					\
     123      {					\
     124        fixP->tc_fix_data = NULL;		\
     125      }					\
     126    while (0)
     127  
     128  /* read.c.  */
     129  /* Extend GAS macro handling capability.  */
     130  extern void nds32_macro_start (void);
     131  extern void nds32_macro_end (void);
     132  extern void nds32_macro_info (void *);
     133  extern void nds32_start_line_hook (void);
     134  extern void nds32_elf_section_change_hook (void);
     135  extern void md_begin (void);
     136  extern void md_finish (void);
     137  extern int nds32_start_label (int, int);
     138  extern void nds32_cleanup (void);
     139  extern void nds32_flush_pending_output (void);
     140  extern void nds32_cons_align (int);
     141  extern void nds32_check_label (symbolS *);
     142  extern void nds32_frob_label (symbolS *);
     143  extern void nds32_pre_do_align (int, char *, int, int);
     144  extern void nds32_do_align (int);
     145  
     146  #define md_macro_start()			nds32_macro_start ()
     147  #define md_macro_end()				nds32_macro_end ()
     148  #define md_macro_info(args)			nds32_macro_info (args)
     149  #define TC_START_LABEL(STR, NUL_CHAR, NEXT_CHAR)	\
     150    (NEXT_CHAR == ':' && nds32_start_label (0, 0))
     151  #define tc_check_label(label)			nds32_check_label (label)
     152  #define tc_frob_label(label)			nds32_frob_label (label)
     153  #define md_finish					md_finish
     154  #define md_start_line_hook()			nds32_start_line_hook ()
     155  #define md_cons_align(n)			nds32_cons_align (n)
     156  /* COLE: TODO: Review md_do_align.  */
     157  #define md_do_align(N, FILL, LEN, MAX, LABEL)	\
     158    nds32_pre_do_align (N, FILL, LEN, MAX);	\
     159    if ((N) > 1 && (subseg_text_p (now_seg)	\
     160        || startswith (now_seg->name, ".gcc_except_table"))) \
     161      nds32_do_align (N);				\
     162    goto LABEL;
     163  #define md_elf_section_change_hook()		nds32_elf_section_change_hook ()
     164  #define md_flush_pending_output()		nds32_flush_pending_output ()
     165  #define md_cleanup()				nds32_cleanup ()
     166  #define LOCAL_LABELS_FB				1 /* Permit temporary numeric labels.  */
     167  
     168  /* frags.c.  */
     169  
     170  enum FRAG_ATTR
     171  {
     172    NDS32_FRAG_RELAXABLE  = 0x1,
     173    NDS32_FRAG_RELAXED = 0x2,
     174    NDS32_FRAG_BRANCH = 0x4,
     175    NDS32_FRAG_LABEL = 0x8,
     176    NDS32_FRAG_FINAL = 0x10,
     177    NDS32_FRAG_RELAXABLE_BRANCH = 0x20,
     178    NDS32_FRAG_ALIGN = 0x40
     179  };
     180  
     181  struct nds32_frag_type
     182  {
     183    relax_substateT flag;
     184    struct nds32_opcode *opcode;
     185    uint32_t insn;
     186    /* To Save previous label fixup if existence.  */
     187    struct fix *fixup;
     188  };
     189  
     190  extern void nds32_frag_init (fragS *);
     191  
     192  #define TC_FRAG_TYPE				struct nds32_frag_type
     193  #define TC_FRAG_INIT(fragP, max_bytes)		nds32_frag_init (fragP)
     194  
     195  /* CFI directive.  */
     196  extern void nds32_elf_frame_initial_instructions (void);
     197  extern int tc_nds32_regname_to_dw2regnum (char *);
     198  
     199  #define TARGET_USE_CFIPOP			1
     200  #define DWARF2_DEFAULT_RETURN_COLUMN		30
     201  #define DWARF2_CIE_DATA_ALIGNMENT		-4
     202  #define DWARF2_LINE_MIN_INSN_LENGTH		2
     203  
     204  #define tc_regname_to_dw2regnum			tc_nds32_regname_to_dw2regnum
     205  #define tc_cfi_frame_initial_instructions	tc_nds32_frame_initial_instructions
     206  
     207  /* COLE: TODO: Review These. They seem to be obsoleted.  */
     208  #if 1
     209  #define TC_RELOC_RTSYM_LOC_FIXUP(FIX)				\
     210     ((FIX)->fx_addsy == NULL					\
     211      || (! S_IS_EXTERNAL ((FIX)->fx_addsy)			\
     212  	&& ! S_IS_WEAK ((FIX)->fx_addsy)			\
     213  	&& S_IS_DEFINED ((FIX)->fx_addsy)			\
     214  	&& ! S_IS_COMMON ((FIX)->fx_addsy)))
     215  #define TC_HANDLES_FX_DONE
     216  #endif
     217  
     218  /* Because linker may relax the code, assemble-time expression
     219     optimization is not allowed.  */
     220  #define md_allow_eh_opt 0
     221  
     222  /* For nds32 relax.  */
     223  enum nds32_br_range
     224  {
     225    BR_RANGE_S256 = 0,
     226    BR_RANGE_S16K,
     227    BR_RANGE_S64K,
     228    BR_RANGE_S16M,
     229    BR_RANGE_U4G,
     230    BR_RANGE_NUM
     231  };
     232  
     233  enum nds32_ramp
     234  {
     235    NDS32_CREATE_LABEL = 1,
     236    NDS32_RELAX = (1 << 1), /* Obsolete in the future.  */
     237    NDS32_ORIGIN = (1 << 2),
     238    NDS32_INSN16 = (1 << 3),
     239    NDS32_PTR = (1 << 4),
     240    NDS32_ABS = (1 << 5),
     241    NDS32_HINT = (1 << 6),
     242    NDS32_FIX = (1 << 7),
     243    NDS32_ADDEND = (1 << 8),
     244    NDS32_SYM = (1 << 9),
     245    NDS32_PCREL = (1 << 10),
     246    NDS32_PTR_PATTERN = (1 << 11),
     247    NDS32_PTR_MULTIPLE = (1 << 12),
     248    NDS32_GROUP = (1 << 13),
     249    NDS32_SYM_DESC_MEM = (1 << 14)
     250  };
     251  
     252  typedef struct nds32_relax_fixup_info
     253  {
     254    int offset;
     255    int size;
     256    /* Reverse branch has to jump to the end of instruction pattern.  */
     257    int ramp;
     258    enum bfd_reloc_code_real r_type;
     259  } nds32_relax_fixup_info_t;
     260  
     261  typedef struct nds32_cond_field
     262  {
     263    int offset;
     264    int bitpos; /* Register position.  */
     265    int bitmask; /* Number of register bits.  */
     266    bool signed_extend;
     267  } nds32_cond_field_t;
     268  
     269  /* The max relaxation pattern is 20-bytes including the nop.  */
     270  #define NDS32_MAXCHAR 20
     271  /* In current, the max extended number of instruction for one pseudo instruction
     272     is 6, but its number of relocation may be 12.  */
     273  #define MAX_RELAX_NUM 6
     274  #define MAX_RELAX_FIX 12
     275  
     276  typedef struct nds32_relax_info
     277  {
     278    /* Opcode for the instruction.  */
     279    const char *opcode;
     280    enum nds32_br_range br_range;
     281    nds32_cond_field_t cond_field[MAX_RELAX_NUM]; /* TODO: Reuse nds32_field?  */
     282    /* Code sequences for different branch range.  */
     283    uint32_t relax_code_seq[BR_RANGE_NUM][MAX_RELAX_NUM];
     284    nds32_cond_field_t relax_code_condition[BR_RANGE_NUM][MAX_RELAX_NUM];
     285    unsigned int relax_code_size[BR_RANGE_NUM];
     286    int relax_branch_isize[BR_RANGE_NUM];
     287    nds32_relax_fixup_info_t relax_fixup[BR_RANGE_NUM][MAX_RELAX_FIX];
     288  } relax_info_t;
     289  
     290  enum nds32_relax_hint_type
     291  {
     292    NDS32_RELAX_HINT_NONE = 0,
     293    NDS32_RELAX_HINT_LA_FLSI,
     294    NDS32_RELAX_HINT_LALS,
     295    NDS32_RELAX_HINT_LA_PLT,
     296    NDS32_RELAX_HINT_LA_GOT,
     297    NDS32_RELAX_HINT_LA_GOTOFF,
     298    NDS32_RELAX_HINT_TLS_START = 0x100,
     299    NDS32_RELAX_HINT_TLS_LE_LS,
     300    NDS32_RELAX_HINT_TLS_IE_LS,
     301    NDS32_RELAX_HINT_TLS_IE_LA,
     302    NDS32_RELAX_HINT_TLS_IEGP_LA,
     303    NDS32_RELAX_HINT_TLS_DESC_LS,
     304  };
     305  
     306  struct nds32_relax_hint_table
     307  {
     308    enum nds32_relax_hint_type main_type;
     309    unsigned int relax_code_size;
     310    uint32_t relax_code_seq[MAX_RELAX_NUM];
     311    nds32_relax_fixup_info_t relax_fixup[MAX_RELAX_FIX];
     312  };
     313  
     314  #endif /* TC_NDS32 */