1  /* Prototypes for exported functions of Andes NDS32 cpu for GNU compiler
       2     Copyright (C) 2012-2023 Free Software Foundation, Inc.
       3     Contributed by Andes Technology Corporation.
       4  
       5     This file is part of GCC.
       6  
       7     GCC is free software; you can redistribute it and/or modify it
       8     under the terms of the GNU General Public License as published
       9     by the Free Software Foundation; either version 3, or (at your
      10     option) any later version.
      11  
      12     GCC is distributed in the hope that it will be useful, but WITHOUT
      13     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
      14     or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
      15     License for more details.
      16  
      17     You should have received a copy of the GNU General Public License
      18     along with GCC; see the file COPYING3.  If not see
      19     <http://www.gnu.org/licenses/>.  */
      20  
      21  
      22  /* ------------------------------------------------------------------------ */
      23  
      24  /* Defining Data Structures for Per-function Information.  */
      25  
      26  extern void nds32_init_expanders (void);
      27  
      28  
      29  /* Register Usage.  */
      30  
      31  /* -- Order of Allocation of Registers.  */
      32  extern void nds32_adjust_reg_alloc_order (void);
      33  
      34  /* Register Classes.  */
      35  
      36  extern enum reg_class nds32_regno_reg_class (int);
      37  
      38  
      39  /* Stack Layout and Calling Conventions.  */
      40  
      41  /* -- Basic Stack Layout.  */
      42  
      43  extern rtx nds32_dynamic_chain_address (rtx);
      44  extern rtx nds32_return_addr_rtx (int, rtx);
      45  
      46  /* -- Eliminating Frame Pointer and Arg Pointer.  */
      47  
      48  extern HOST_WIDE_INT nds32_initial_elimination_offset (unsigned int,
      49  						       unsigned int);
      50  
      51  /* -- Passing Arguments in Registers.  */
      52  
      53  extern void nds32_init_cumulative_args (CUMULATIVE_ARGS *,
      54  					tree, rtx, tree, int);
      55  
      56  /* -- Function Entry and Exit.  */
      57  
      58  extern void nds32_expand_prologue (void);
      59  extern void nds32_expand_epilogue (bool);
      60  extern void nds32_expand_prologue_v3push (void);
      61  extern void nds32_expand_epilogue_v3pop (bool);
      62  extern void nds32_emit_push_fpr_callee_saved (int);
      63  extern void nds32_emit_pop_fpr_callee_saved (int);
      64  extern void nds32_emit_v3pop_fpr_callee_saved (int);
      65  
      66  /* Controlling Debugging Information Format.  */
      67  
      68  extern unsigned int nds32_debugger_regno (unsigned int);
      69  
      70  /* ------------------------------------------------------------------------ */
      71  
      72  /* Auxiliary functions for manipulation DI mode.  */
      73  
      74  extern rtx nds32_di_high_part_subreg(rtx);
      75  extern rtx nds32_di_low_part_subreg(rtx);
      76  
      77  /* Auxiliary functions for expanding rtl used in nds32-multiple.md.  */
      78  
      79  extern rtx nds32_expand_load_multiple (int, int, rtx, rtx, bool, rtx *);
      80  extern rtx nds32_expand_store_multiple (int, int, rtx, rtx, bool, rtx *);
      81  extern bool nds32_expand_cpymemsi (rtx, rtx, rtx, rtx);
      82  extern bool nds32_expand_setmem (rtx, rtx, rtx, rtx, rtx, rtx);
      83  extern bool nds32_expand_strlen (rtx, rtx, rtx, rtx);
      84  
      85  /* Auxiliary functions for expand unalign load instruction.  */
      86  
      87  extern void nds32_expand_unaligned_load (rtx *, enum machine_mode);
      88  
      89  /* Auxiliary functions for expand unalign store instruction.  */
      90  
      91  extern void nds32_expand_unaligned_store (rtx *, enum machine_mode);
      92  
      93  /* Auxiliary functions for multiple load/store predicate checking.  */
      94  
      95  extern bool nds32_valid_multiple_load_store_p (rtx, bool, bool);
      96  
      97  /* Auxiliary functions for guard function checking in pipelines.md.  */
      98  
      99  extern bool nds32_n7_load_to_ii_p (rtx_insn *, rtx_insn *);
     100  extern bool nds32_n7_last_load_to_ii_p (rtx_insn *, rtx_insn *);
     101  
     102  extern bool nds32_n8_load_to_ii_p (rtx_insn *, rtx_insn *);
     103  extern bool nds32_n8_load_bi_to_ii_p (rtx_insn *, rtx_insn *);
     104  extern bool nds32_n8_load_to_ex_p (rtx_insn *, rtx_insn *);
     105  extern bool nds32_n8_ex_to_ii_p (rtx_insn *, rtx_insn *);
     106  extern bool nds32_n8_last_load_to_ii_p (rtx_insn *, rtx_insn *);
     107  extern bool nds32_n8_last_load_two_to_ii_p (rtx_insn *, rtx_insn *);
     108  extern bool nds32_n8_last_load_to_ex_p (rtx_insn *, rtx_insn *);
     109  
     110  extern bool nds32_e8_load_to_ii_p (rtx_insn *, rtx_insn *);
     111  extern bool nds32_e8_load_to_ex_p (rtx_insn *, rtx_insn *);
     112  extern bool nds32_e8_ex_to_ii_p (rtx_insn *, rtx_insn *);
     113  extern bool nds32_e8_last_load_to_ii_p (rtx_insn *, rtx_insn *);
     114  extern bool nds32_e8_last_load_to_ex_p (rtx_insn *, rtx_insn *);
     115  
     116  extern bool nds32_n9_2r1w_mm_to_ex_p (rtx_insn *, rtx_insn *);
     117  extern bool nds32_n9_3r2w_mm_to_ex_p (rtx_insn *, rtx_insn *);
     118  extern bool nds32_n9_last_load_to_ex_p (rtx_insn *, rtx_insn *);
     119  
     120  extern bool nds32_n10_ex_to_ex_p (rtx_insn *, rtx_insn *);
     121  extern bool nds32_n10_mm_to_ex_p (rtx_insn *, rtx_insn *);
     122  extern bool nds32_n10_last_load_to_ex_p (rtx_insn *, rtx_insn *);
     123  
     124  extern bool nds32_gw_ex_to_ex_p (rtx_insn *, rtx_insn *);
     125  extern bool nds32_gw_mm_to_ex_p (rtx_insn *, rtx_insn *);
     126  extern bool nds32_gw_last_load_to_ex_p (rtx_insn *, rtx_insn *);
     127  
     128  extern bool nds32_n13_e2_to_e1_p (rtx_insn *, rtx_insn *);
     129  extern bool nds32_n13_load_to_e1_p (rtx_insn *, rtx_insn *);
     130  extern bool nds32_n13_load_to_e2_p (rtx_insn *, rtx_insn *);
     131  extern bool nds32_n13_last_load_to_e1_p (rtx_insn *, rtx_insn *);
     132  extern bool nds32_n13_last_load_to_e2_p (rtx_insn *, rtx_insn *);
     133  extern bool nds32_n13_last_two_load_to_e1_p (rtx_insn *, rtx_insn *);
     134  
     135  /* Auxiliary functions for stack operation predicate checking.  */
     136  
     137  extern bool nds32_valid_stack_push_pop_p (rtx, bool);
     138  
     139  /* Auxiliary functions for bit operation detection.  */
     140  
     141  extern bool nds32_can_use_bclr_p (HOST_WIDE_INT);
     142  extern bool nds32_can_use_bset_p (HOST_WIDE_INT);
     143  extern bool nds32_can_use_btgl_p (HOST_WIDE_INT);
     144  
     145  extern bool nds32_can_use_bitci_p (HOST_WIDE_INT);
     146  
     147  extern bool nds32_const_double_range_ok_p (rtx, machine_mode,
     148  					   HOST_WIDE_INT, HOST_WIDE_INT);
     149  
     150  extern bool nds32_const_unspec_p (rtx x);
     151  
     152  /* Auxiliary function for 'Computing the Length of an Insn'.  */
     153  
     154  extern int nds32_adjust_insn_length (rtx_insn *, int);
     155  
     156  /* Auxiliary functions for FP_AS_GP detection.  */
     157  
     158  extern bool nds32_symbol_load_store_p (rtx_insn *);
     159  extern bool nds32_naked_function_p (tree);
     160  
     161  /* Auxiliary functions for jump table generation.  */
     162  
     163  extern const char *nds32_output_casesi_pc_relative (rtx *);
     164  extern const char *nds32_output_casesi (rtx *);
     165  
     166  /* Auxiliary functions for conditional branch generation.  */
     167  
     168  extern enum nds32_expand_result_type nds32_expand_cbranch (rtx *);
     169  extern enum nds32_expand_result_type nds32_expand_cstore (rtx *);
     170  extern void nds32_expand_float_cbranch (rtx *);
     171  extern void nds32_expand_float_cstore (rtx *);
     172  
     173  /* Auxiliary functions for conditional move generation.  */
     174  
     175  extern enum nds32_expand_result_type nds32_expand_movcc (rtx *);
     176  extern void nds32_expand_float_movcc (rtx *);
     177  
     178  /* Auxiliary functions for expand extv/insv instruction.  */
     179  
     180  extern enum nds32_expand_result_type nds32_expand_extv (rtx *);
     181  extern enum nds32_expand_result_type nds32_expand_insv (rtx *);
     182  
     183  /* Auxiliary functions for expand PIC instruction.  */
     184  
     185  extern void nds32_expand_pic_move (rtx *);
     186  
     187  /* Auxiliary functions to legitimize PIC address.  */
     188  
     189  extern rtx nds32_legitimize_pic_address (rtx);
     190  
     191  /* Auxiliary functions for expand TLS instruction.  */
     192  
     193  extern void nds32_expand_tls_move (rtx *);
     194  
     195  /* Auxiliary functions to legitimize TLS address.  */
     196  
     197  extern rtx nds32_legitimize_tls_address (rtx);
     198  
     199  /* Auxiliary functions to identify thread-local symbol.  */
     200  
     201  extern bool nds32_tls_referenced_p (rtx);
     202  
     203  /* Auxiliary functions for expand ICT instruction.  */
     204  
     205  extern void nds32_expand_ict_move (rtx *);
     206  
     207  /* Auxiliary functions to legitimize address for indirect-call symbol.  */
     208  
     209  extern rtx nds32_legitimize_ict_address (rtx);
     210  
     211  /* Auxiliary functions to identify indirect-call symbol.  */
     212  
     213  extern bool nds32_indirect_call_referenced_p (rtx);
     214  
     215  /* Auxiliary functions to identify long-call symbol.  */
     216  extern bool nds32_long_call_p (rtx);
     217  
     218  /* Auxiliary functions to identify SYMBOL_REF and LABEL_REF pattern.  */
     219  
     220  extern bool symbolic_reference_mentioned_p (rtx);
     221  
     222  /* Auxiliary functions to identify conditional move comparison operand.  */
     223  
     224  extern int nds32_cond_move_p (rtx);
     225  
     226  /* Auxiliary functions to identify 16 bit addresing mode.  */
     227  
     228  extern enum nds32_16bit_address_type nds32_mem_format (rtx);
     229  
     230  /* Auxiliary functions to identify floating-point addresing mode.  */
     231  
     232  extern bool nds32_float_mem_operand_p (rtx);
     233  
     234  /* Auxiliary functions to output assembly code.  */
     235  
     236  extern const char *nds32_output_16bit_store (rtx *, int);
     237  extern const char *nds32_output_16bit_load (rtx *, int);
     238  extern const char *nds32_output_32bit_store (rtx *, int);
     239  extern const char *nds32_output_32bit_load (rtx *, int);
     240  extern const char *nds32_output_32bit_load_s (rtx *, int);
     241  extern const char *nds32_output_float_load(rtx *);
     242  extern const char *nds32_output_float_store(rtx *);
     243  extern const char *nds32_output_smw_single_word (rtx *);
     244  extern const char *nds32_output_smw_double_word (rtx *);
     245  extern const char *nds32_output_lmw_single_word (rtx *);
     246  extern const char *nds32_output_double (rtx *, bool);
     247  extern const char *nds32_output_cbranchsi4_equality_zero (rtx_insn *, rtx *);
     248  extern const char *nds32_output_cbranchsi4_equality_reg (rtx_insn *, rtx *);
     249  extern const char *nds32_output_cbranchsi4_equality_reg_or_const_int (rtx_insn *,
     250  								      rtx *);
     251  extern const char *nds32_output_cbranchsi4_greater_less_zero (rtx_insn *, rtx *);
     252  
     253  extern const char *nds32_output_unpkd8 (rtx, rtx, rtx, rtx, bool);
     254  
     255  extern const char *nds32_output_call (rtx, rtx *, rtx,
     256  				      const char *, const char *, bool);
     257  extern const char *nds32_output_tls_desc (rtx *);
     258  extern const char *nds32_output_tls_ie (rtx *);
     259  extern const char *nds32_output_symrel (rtx *);
     260  
     261  /* Auxiliary functions to output stack push/pop instruction.  */
     262  
     263  extern const char *nds32_output_stack_push (rtx);
     264  extern const char *nds32_output_stack_pop (rtx);
     265  extern const char *nds32_output_return (void);
     266  
     267  
     268  /* Auxiliary functions to split/output sms pattern.  */
     269  extern bool nds32_need_split_sms_p (rtx, rtx, rtx, rtx);
     270  extern const char *nds32_output_sms (rtx, rtx, rtx, rtx);
     271  extern void nds32_split_sms (rtx, rtx, rtx, rtx, rtx, rtx, rtx);
     272  
     273  /* Auxiliary functions to split double word RTX pattern.  */
     274  
     275  extern void nds32_spilt_doubleword (rtx *, bool);
     276  extern void nds32_split_ashiftdi3 (rtx, rtx, rtx);
     277  extern void nds32_split_ashiftrtdi3 (rtx, rtx, rtx);
     278  extern void nds32_split_lshiftrtdi3 (rtx, rtx, rtx);
     279  extern void nds32_split_rotatertdi3 (rtx, rtx, rtx);
     280  
     281  /* Auxiliary functions to split large constant RTX pattern.  */
     282  
     283  extern void nds32_expand_constant (machine_mode,
     284  				   HOST_WIDE_INT, rtx, rtx);
     285  
     286  /* Auxiliary functions to check using return with null epilogue.  */
     287  
     288  extern int nds32_can_use_return_insn (void);
     289  extern scalar_int_mode nds32_case_vector_shorten_mode (int, int, rtx);
     290  
     291  /* Auxiliary functions to decide output alignment or not.  */
     292  
     293  extern int nds32_target_alignment (rtx_insn *);
     294  extern unsigned int nds32_data_alignment (tree, unsigned int);
     295  extern unsigned int nds32_local_alignment (tree, unsigned int);
     296  
     297  /* Auxiliary functions to expand builtin functions.  */
     298  
     299  extern void nds32_init_builtins_impl (void);
     300  extern rtx nds32_expand_builtin_impl (tree, rtx, rtx,
     301  				      machine_mode, int);
     302  extern tree nds32_builtin_decl_impl (unsigned, bool);
     303  
     304  /* Auxiliary functions for ISR implementation.  */
     305  
     306  extern void nds32_check_isr_attrs_conflict (tree, tree);
     307  extern void nds32_construct_isr_vectors_information (tree, const char *);
     308  extern void nds32_asm_file_start_for_isr (void);
     309  extern void nds32_asm_file_end_for_isr (void);
     310  extern bool nds32_isr_function_p (tree);
     311  extern bool nds32_isr_function_critical_p (tree);
     312  
     313  /* Auxiliary functions for cost calculation.  */
     314  
     315  extern void nds32_init_rtx_costs (void);
     316  extern bool nds32_rtx_costs_impl (rtx, machine_mode, int, int, int *, bool);
     317  extern int nds32_address_cost_impl (rtx, machine_mode, addr_space_t, bool);
     318  
     319  /* Auxiliary functions for pre-define marco.  */
     320  extern void nds32_cpu_cpp_builtins(struct cpp_reader *);
     321  
     322  /* Auxiliary functions for const_vector's constraints.  */
     323  
     324  extern HOST_WIDE_INT const_vector_to_hwint (rtx);
     325  extern bool nds32_valid_CVp5_p (rtx);
     326  extern bool nds32_valid_CVs5_p (rtx);
     327  extern bool nds32_valid_CVs2_p (rtx);
     328  extern bool nds32_valid_CVhi_p (rtx);
     329  
     330  /* Auxiliary functions for lwm/smw.  */
     331  
     332  extern bool nds32_valid_smw_lwm_base_p (rtx);
     333  
     334  extern bool nds32_split_double_word_load_store_p (rtx *,bool);
     335  
     336  namespace nds32 {
     337  
     338  extern rtx extract_pattern_from_insn (rtx);
     339  
     340  size_t parallel_elements (rtx);
     341  rtx parallel_element (rtx, int);
     342  bool load_single_p (rtx_insn *);
     343  bool store_single_p (rtx_insn *);
     344  bool load_double_p (rtx_insn *);
     345  bool store_double_p (rtx_insn *);
     346  bool store_offset_reg_p (rtx_insn *);
     347  bool post_update_insn_p (rtx_insn *);
     348  bool immed_offset_p (rtx);
     349  int find_post_update_rtx (rtx_insn *);
     350  rtx extract_mem_rtx (rtx_insn *);
     351  rtx extract_base_reg (rtx_insn *);
     352  rtx extract_offset_rtx (rtx_insn *);
     353  
     354  rtx extract_shift_reg (rtx);
     355  
     356  bool movd44_insn_p (rtx_insn *);
     357  rtx extract_movd44_odd_reg (rtx_insn *);
     358  
     359  rtx extract_mac_non_acc_rtx (rtx_insn *);
     360  
     361  bool divmod_p (rtx_insn *);
     362  
     363  rtx extract_branch_target_rtx (rtx_insn *);
     364  rtx extract_branch_condition_rtx (rtx_insn *);
     365  } // namespace nds32
     366  
     367  extern bool nds32_use_load_post_increment(machine_mode);
     368  
     369  /* Functions for create nds32 specific optimization pass.  */
     370  extern rtl_opt_pass *make_pass_nds32_relax_opt (gcc::context *);
     371  extern rtl_opt_pass *make_pass_nds32_fp_as_gp (gcc::context *);
     372  
     373  extern int nds32_alloc_relax_group_id ();
     374  
     375  /* ------------------------------------------------------------------------ */