gcc/config/mips/mips-protos.h

   1 /* Prototypes of target machine for GNU compiler.  MIPS version.
   2    Copyright (C) 1989-2014 Free Software Foundation, Inc.
   3    Contributed by A. Lichnewsky (lich@inria.inria.fr).
   4    Changed by Michael Meissner  (meissner@osf.org).
   5    64-bit r4000 support by Ian Lance Taylor (ian@cygnus.com) and
   6    Brendan Eich (brendan@microunity.com).
   7
   8 This file is part of GCC.
   9
  10 GCC is free software; you can redistribute it and/or modify
  11 it under the terms of the GNU General Public License as published by
  12 the Free Software Foundation; either version 3, or (at your option)
  13 any later version.
  14
  15 GCC is distributed in the hope that it will be useful,
  16 but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 GNU General Public License for more details.
  19
  20 You should have received a copy of the GNU General Public License
  21 along with GCC; see the file COPYING3.  If not see
  22 <http://www.gnu.org/licenses/>.  */
  23
  24 #ifndef GCC_MIPS_PROTOS_H
  25 #define GCC_MIPS_PROTOS_H
  26
  27 /* Describes how a symbol is used.
  28
  29    SYMBOL_CONTEXT_CALL
  30        The symbol is used as the target of a call instruction.
  31
  32    SYMBOL_CONTEXT_LEA
  33        The symbol is used in a load-address operation.
  34
  35    SYMBOL_CONTEXT_MEM
  36        The symbol is used as the address in a MEM.  */
  37 enum mips_symbol_context {
  38   SYMBOL_CONTEXT_CALL,
  39   SYMBOL_CONTEXT_LEA,
  40   SYMBOL_CONTEXT_MEM
  41 };
  42
  43 /* Classifies a SYMBOL_REF, LABEL_REF or UNSPEC address.
  44
  45    SYMBOL_ABSOLUTE
  46        The symbol's value will be calculated using absolute relocations,
  47        such as %hi and %lo.
  48
  49    SYMBOL_GP_RELATIVE
  50        The symbol's value will be calculated by adding a 16-bit offset
  51        from $gp.
  52
  53    SYMBOL_PC_RELATIVE
  54        The symbol's value will be calculated using a MIPS16 PC-relative
  55        calculation.
  56
  57    SYMBOL_GOT_PAGE_OFST
  58        The symbol's value will be calculated by loading an address
  59        from the GOT and then applying a 16-bit offset.
  60
  61    SYMBOL_GOT_DISP
  62        The symbol's value will be loaded directly from the GOT.
  63
  64    SYMBOL_GOTOFF_PAGE
  65        An UNSPEC wrapper around a SYMBOL_GOT_PAGE_OFST.  It represents the
  66        offset from _gp of the GOT entry.
  67
  68    SYMBOL_GOTOFF_DISP
  69        An UNSPEC wrapper around a SYMBOL_GOT_DISP.  It represents the
  70        offset from _gp of the symbol's GOT entry.
  71
  72    SYMBOL_GOTOFF_CALL
  73        Like SYMBOL_GOTOFF_DISP, but used when calling a global function.
  74        The GOT entry is allowed to point to a stub rather than to the
  75        function itself.
  76
  77    SYMBOL_GOTOFF_LOADGP
  78        An UNSPEC wrapper around a function's address.  It represents the
  79        offset of _gp from the start of the function.
  80
  81    SYMBOL_TLS
  82        A thread-local symbol.
  83
  84    SYMBOL_TLSGD
  85    SYMBOL_TLSLDM
  86    SYMBOL_DTPREL
  87    SYMBOL_GOTTPREL
  88    SYMBOL_TPREL
  89        UNSPEC wrappers around SYMBOL_TLS, corresponding to the
  90        thread-local storage relocation operators.
  91
  92    SYMBOL_64_HIGH
  93        For a 64-bit symbolic address X, this is the value of
  94        (%highest(X) << 16) + %higher(X).
  95
  96    SYMBOL_64_MID
  97        For a 64-bit symbolic address X, this is the value of
  98        (%higher(X) << 16) + %hi(X).
  99
 100    SYMBOL_64_LOW
 101        For a 64-bit symbolic address X, this is the value of
 102        (%hi(X) << 16) + %lo(X).
 103
 104    SYMBOL_HALF
 105        An UNSPEC wrapper around any kind of address.  It represents the
 106        low 16 bits of that address.  */
 107 enum mips_symbol_type {
 108   SYMBOL_ABSOLUTE,
 109   SYMBOL_GP_RELATIVE,
 110   SYMBOL_PC_RELATIVE,
 111   SYMBOL_GOT_PAGE_OFST,
 112   SYMBOL_GOT_DISP,
 113   SYMBOL_GOTOFF_PAGE,
 114   SYMBOL_GOTOFF_DISP,
 115   SYMBOL_GOTOFF_CALL,
 116   SYMBOL_GOTOFF_LOADGP,
 117   SYMBOL_TLS,
 118   SYMBOL_TLSGD,
 119   SYMBOL_TLSLDM,
 120   SYMBOL_DTPREL,
 121   SYMBOL_GOTTPREL,
 122   SYMBOL_TPREL,
 123   SYMBOL_64_HIGH,
 124   SYMBOL_64_MID,
 125   SYMBOL_64_LOW,
 126   SYMBOL_HALF
 127 };
 128 #define NUM_SYMBOL_TYPES (SYMBOL_HALF + 1)
 129
 130 /* Identifiers a style of $gp initialization sequence.
 131
 132    LOADGP_NONE
 133         No initialization sequence is needed.
 134
 135    LOADGP_OLDABI
 136         The o32 and o64 PIC sequence (the kind traditionally generated
 137         by .cpload).
 138
 139    LOADGP_NEWABI
 140         The n32 and n64 PIC sequence (the kind traditionally generated
 141         by .cpsetup).
 142
 143    LOADGP_ABSOLUTE
 144         The GNU absolute sequence, as generated by loadgp_absolute.
 145
 146    LOADGP_RTP
 147         The VxWorks RTP PIC sequence, as generated by loadgp_rtp.  */
 148 enum mips_loadgp_style {
 149   LOADGP_NONE,
 150   LOADGP_OLDABI,
 151   LOADGP_NEWABI,
 152   LOADGP_ABSOLUTE,
 153   LOADGP_RTP
 154 };
 155
 156 struct mips16e_save_restore_info;
 157
 158 /* Classifies a type of call.
 159
 160    MIPS_CALL_NORMAL
 161         A normal call or call_value pattern.
 162
 163    MIPS_CALL_SIBCALL
 164         A sibcall or sibcall_value pattern.
 165
 166    MIPS_CALL_EPILOGUE
 167         A call inserted in the epilogue.  */
 168 enum mips_call_type {
 169   MIPS_CALL_NORMAL,
 170   MIPS_CALL_SIBCALL,
 171   MIPS_CALL_EPILOGUE
 172 };
 173
 174 /* Controls the conditions under which certain instructions are split.
 175
 176    SPLIT_IF_NECESSARY
 177         Only perform splits that are necessary for correctness
 178         (because no unsplit version exists).
 179
 180    SPLIT_FOR_SPEED
 181         Perform splits that are necessary for correctness or
 182         beneficial for code speed.
 183
 184    SPLIT_FOR_SIZE
 185         Perform splits that are necessary for correctness or
 186         beneficial for code size.  */
 187 enum mips_split_type {
 188   SPLIT_IF_NECESSARY,
 189   SPLIT_FOR_SPEED,
 190   SPLIT_FOR_SIZE
 191 };
 192
 193 extern bool mips_symbolic_constant_p (rtx, enum mips_symbol_context,
 194                                       enum mips_symbol_type *);
 195 extern int mips_regno_mode_ok_for_base_p (int, machine_mode, bool);
 196 extern bool mips_stack_address_p (rtx, machine_mode);
 197 extern int mips_address_insns (rtx, machine_mode, bool);
 198 extern int mips_const_insns (rtx);
 199 extern int mips_split_const_insns (rtx);
 200 extern int mips_load_store_insns (rtx, rtx_insn *);
 201 extern int mips_idiv_insns (void);
 202 extern rtx_insn *mips_emit_move (rtx, rtx);
 203 #ifdef RTX_CODE
 204 extern void mips_emit_binary (enum rtx_code, rtx, rtx, rtx);
 205 #endif
 206 extern rtx mips_pic_base_register (rtx);
 207 extern rtx mips_got_load (rtx, rtx, enum mips_symbol_type);
 208 extern bool mips_split_symbol (rtx, rtx, machine_mode, rtx *);
 209 extern rtx mips_unspec_address (rtx, enum mips_symbol_type);
 210 extern rtx mips_strip_unspec_address (rtx);
 211 extern void mips_move_integer (rtx, rtx, unsigned HOST_WIDE_INT);
 212 extern bool mips_legitimize_move (machine_mode, rtx, rtx);
 213
 214 extern rtx mips_subword (rtx, bool);
 215 extern bool mips_split_move_p (rtx, rtx, enum mips_split_type);
 216 extern void mips_split_move (rtx, rtx, enum mips_split_type);
 217 extern bool mips_split_move_insn_p (rtx, rtx, rtx);
 218 extern void mips_split_move_insn (rtx, rtx, rtx);
 219 extern const char *mips_output_move (rtx, rtx);
 220 extern bool mips_cfun_has_cprestore_slot_p (void);
 221 extern bool mips_cprestore_address_p (rtx, bool);
 222 extern void mips_save_gp_to_cprestore_slot (rtx, rtx, rtx, rtx);
 223 extern void mips_restore_gp_from_cprestore_slot (rtx);
 224 #ifdef RTX_CODE
 225 extern void mips_expand_scc (rtx *);
 226 extern void mips_expand_conditional_branch (rtx *);
 227 extern void mips_expand_vcondv2sf (rtx, rtx, rtx, enum rtx_code, rtx, rtx);
 228 extern void mips_expand_conditional_move (rtx *);
 229 extern void mips_expand_conditional_trap (rtx);
 230 #endif
 231 extern bool mips_use_pic_fn_addr_reg_p (const_rtx);
 232 extern rtx_insn *mips_expand_call (enum mips_call_type, rtx, rtx, rtx, rtx,
 233                                    bool);
 234 extern void mips_split_call (rtx, rtx);
 235 extern bool mips_get_pic_call_symbol (rtx *, int);
 236 extern void mips_set_return_address (rtx, rtx);
 237 extern bool mips_move_by_pieces_p (unsigned HOST_WIDE_INT, unsigned int);
 238 extern bool mips_store_by_pieces_p (unsigned HOST_WIDE_INT, unsigned int);
 239 extern bool mips_expand_block_move (rtx, rtx, rtx);
 240 extern void mips_expand_synci_loop (rtx, rtx);
 241
 242 extern void mips_init_cumulative_args (CUMULATIVE_ARGS *, tree);
 243 extern bool mips_pad_arg_upward (machine_mode, const_tree);
 244 extern bool mips_pad_reg_upward (machine_mode, tree);
 245
 246 extern bool mips_expand_ext_as_unaligned_load (rtx, rtx, HOST_WIDE_INT,
 247                                                HOST_WIDE_INT, bool);
 248 extern bool mips_expand_ins_as_unaligned_store (rtx, rtx, HOST_WIDE_INT,
 249                                                 HOST_WIDE_INT);
 250 extern bool mips_mem_fits_mode_p (machine_mode mode, rtx x);
 251 extern HOST_WIDE_INT mips_debugger_offset (rtx, HOST_WIDE_INT);
 252
 253 extern void mips_push_asm_switch (struct mips_asm_switch *);
 254 extern void mips_pop_asm_switch (struct mips_asm_switch *);
 255 extern void mips_output_external (FILE *, tree, const char *);
 256 extern void mips_output_ascii (FILE *, const char *, size_t);
 257 extern const char *mips_output_tls_reloc_directive (rtx *);
 258 extern void mips_output_aligned_decl_common (FILE *, tree, const char *,
 259                                              unsigned HOST_WIDE_INT,
 260                                              unsigned int);
 261 extern void mips_declare_common_object (FILE *, const char *,
 262                                         const char *, unsigned HOST_WIDE_INT,
 263                                         unsigned int, bool);
 264 extern void mips_declare_object (FILE *, const char *, const char *,
 265                                  const char *, ...) ATTRIBUTE_PRINTF_4;
 266 extern void mips_declare_object_name (FILE *, const char *, tree);
 267 extern void mips_finish_declare_object (FILE *, tree, int, int);
 268
 269 extern bool mips_small_data_pattern_p (rtx);
 270 extern rtx mips_rewrite_small_data (rtx);
 271 extern HOST_WIDE_INT mips_initial_elimination_offset (int, int);
 272 extern rtx mips_return_addr (int, rtx);
 273 extern bool mips_must_initialize_gp_p (void);
 274 extern enum mips_loadgp_style mips_current_loadgp_style (void);
 275 extern void mips_emit_save_slot_move (rtx, rtx, rtx);
 276 extern void mips_expand_prologue (void);
 277 extern void mips_expand_before_return (void);
 278 extern void mips_expand_epilogue (bool);
 279 extern bool mips_can_use_return_insn (void);
 280
 281 extern bool mips_secondary_memory_needed (enum reg_class, enum reg_class,
 282                                           machine_mode);
 283 extern bool mips_cannot_change_mode_class (machine_mode,
 284                                            machine_mode, enum reg_class);
 285 extern bool mips_dangerous_for_la25_p (rtx);
 286 extern bool mips_modes_tieable_p (machine_mode, machine_mode);
 287 extern enum reg_class mips_secondary_reload_class (enum reg_class,
 288                                                    machine_mode,
 289                                                    rtx, bool);
 290 extern int mips_class_max_nregs (enum reg_class, machine_mode);
 291
 292 extern machine_mode mips_hard_regno_caller_save_mode (unsigned int,
 293                                                       unsigned int,
 294                                                       machine_mode);
 295 extern int mips_adjust_insn_length (rtx_insn *, int);
 296 extern void mips_output_load_label (rtx);
 297 extern const char *mips_output_conditional_branch (rtx_insn *, rtx *,
 298                                                    const char *, const char *);
 299 extern const char *mips_output_order_conditional_branch (rtx_insn *, rtx *,
 300                                                          bool);
 301 extern const char *mips_output_sync (void);
 302 extern const char *mips_output_sync_loop (rtx_insn *, rtx *);
 303 extern unsigned int mips_sync_loop_insns (rtx_insn *, rtx *);
 304 extern const char *mips_output_division (const char *, rtx *);
 305 extern const char *mips_output_probe_stack_range (rtx, rtx);
 306 extern unsigned int mips_hard_regno_nregs (int, machine_mode);
 307 extern bool mips_linked_madd_p (rtx_insn *, rtx_insn *);
 308 extern bool mips_store_data_bypass_p (rtx_insn *, rtx_insn *);
 309 extern int mips_dspalu_bypass_p (rtx, rtx);
 310 extern rtx mips_prefetch_cookie (rtx, rtx);
 311
 312 extern const char *current_section_name (void);
 313 extern unsigned int current_section_flags (void);
 314 extern bool mips_use_ins_ext_p (rtx, HOST_WIDE_INT, HOST_WIDE_INT);
 315
 316 extern const char *mips16e_output_save_restore (rtx, HOST_WIDE_INT);
 317 extern bool mips16e_save_restore_pattern_p (rtx, HOST_WIDE_INT,
 318                                             struct mips16e_save_restore_info *);
 319
 320 extern bool mask_low_and_shift_p (machine_mode, rtx, rtx, int);
 321 extern int mask_low_and_shift_len (machine_mode, rtx, rtx);
 322 extern bool and_operands_ok (machine_mode, rtx, rtx);
 323 extern bool mips_fmadd_bypass (rtx_insn *, rtx_insn *);
 324
 325 union mips_gen_fn_ptrs
 326 {
 327   rtx (*fn_6) (rtx, rtx, rtx, rtx, rtx, rtx);
 328   rtx (*fn_5) (rtx, rtx, rtx, rtx, rtx);
 329   rtx (*fn_4) (rtx, rtx, rtx, rtx);
 330 };
 331
 332 extern void mips_expand_atomic_qihi (union mips_gen_fn_ptrs,
 333                                      rtx, rtx, rtx, rtx);
 334
 335 extern void mips_expand_vector_init (rtx, rtx);
 336 extern bool mips_expand_vec_perm_const (rtx op[4]);
 337 extern void mips_expand_vec_unpack (rtx op[2], bool, bool);
 338 extern void mips_expand_vec_reduc (rtx, rtx, rtx (*)(rtx, rtx, rtx));
 339 extern void mips_expand_vec_minmax (rtx, rtx, rtx,
 340                                     rtx (*) (rtx, rtx, rtx), bool);
 341
 342 extern bool mips_signed_immediate_p (unsigned HOST_WIDE_INT, int, int);
 343 extern bool mips_unsigned_immediate_p (unsigned HOST_WIDE_INT, int, int);
 344 extern const char *umips_output_save_restore (bool, rtx);
 345 extern bool umips_save_restore_pattern_p (bool, rtx);
 346 extern bool umips_load_store_pair_p (bool, rtx *);
 347 extern void umips_output_load_store_pair (bool, rtx *);
 348 extern bool umips_movep_target_p (rtx, rtx);
 349 extern bool umips_12bit_offset_address_p (rtx, machine_mode);
 350 extern bool mips_9bit_offset_address_p (rtx, machine_mode);
 351 extern bool lwsp_swsp_address_p (rtx, machine_mode);
 352 extern bool m16_based_address_p (rtx, machine_mode,
 353                                  int (*)(rtx_def*, machine_mode));
 354 extern rtx mips_expand_thread_pointer (rtx);
 355 extern void mips16_expand_get_fcsr (rtx);
 356 extern void mips16_expand_set_fcsr (rtx);
 357
 358 extern bool mips_eh_uses (unsigned int);
 359 extern bool mips_epilogue_uses (unsigned int);
 360 extern void mips_final_prescan_insn (rtx_insn *, rtx *, int);
 361 extern int mips_trampoline_code_size (void);
 362 extern void mips_function_profiler (FILE *);
 363
 364 typedef rtx (*mulsidi3_gen_fn) (rtx, rtx, rtx);
 365 #ifdef RTX_CODE
 366 extern mulsidi3_gen_fn mips_mulsidi3_gen_fn (enum rtx_code);
 367 #endif
 368
 369 #endif /* ! GCC_MIPS_PROTOS_H */