gcc/config/mips/mips-protos.h

   1 /* Prototypes of target machine for GNU compiler.  MIPS version.
   2    Copyright (C) 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
   3    1999, 2001, 2002, 2003, 2004, 2005, 2007, 2008
   4    Free Software Foundation, Inc.
   5    Contributed by A. Lichnewsky (lich@inria.inria.fr).
   6    Changed by Michael Meissner  (meissner@osf.org).
   7    64-bit r4000 support by Ian Lance Taylor (ian@cygnus.com) and
   8    Brendan Eich (brendan@microunity.com).
   9
  10 This file is part of GCC.
  11
  12 GCC is free software; you can redistribute it and/or modify
  13 it under the terms of the GNU General Public License as published by
  14 the Free Software Foundation; either version 3, or (at your option)
  15 any later version.
  16
  17 GCC is distributed in the hope that it will be useful,
  18 but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 GNU General Public License for more details.
  21
  22 You should have received a copy of the GNU General Public License
  23 along with GCC; see the file COPYING3.  If not see
  24 <http://www.gnu.org/licenses/>.  */
  25
  26 #ifndef GCC_MIPS_PROTOS_H
  27 #define GCC_MIPS_PROTOS_H
  28
  29 /* Describes how a symbol is used.
  30
  31    SYMBOL_CONTEXT_CALL
  32        The symbol is used as the target of a call instruction.
  33
  34    SYMBOL_CONTEXT_LEA
  35        The symbol is used in a load-address operation.
  36
  37    SYMBOL_CONTEXT_MEM
  38        The symbol is used as the address in a MEM.  */
  39 enum mips_symbol_context {
  40   SYMBOL_CONTEXT_CALL,
  41   SYMBOL_CONTEXT_LEA,
  42   SYMBOL_CONTEXT_MEM
  43 };
  44
  45 /* Classifies a SYMBOL_REF, LABEL_REF or UNSPEC address.
  46
  47    SYMBOL_ABSOLUTE
  48        The symbol's value will be calculated using absolute relocations,
  49        such as %hi and %lo.
  50
  51    SYMBOL_GP_RELATIVE
  52        The symbol's value will be calculated by adding a 16-bit offset
  53        from $gp.
  54
  55    SYMBOL_PC_RELATIVE
  56        The symbol's value will be calculated using a MIPS16 PC-relative
  57        calculation.
  58
  59    SYMBOL_FORCE_TO_MEM
  60        The symbol's value must be forced to memory and loaded from there.
  61
  62    SYMBOL_GOT_PAGE_OFST
  63        The symbol's value will be calculated by loading an address
  64        from the GOT and then applying a 16-bit offset.
  65
  66    SYMBOL_GOT_DISP
  67        The symbol's value will be loaded directly from the GOT.
  68
  69    SYMBOL_GOTOFF_PAGE
  70        An UNSPEC wrapper around a SYMBOL_GOT_PAGE_OFST.  It represents the
  71        offset from _gp of the GOT entry.
  72
  73    SYMBOL_GOTOFF_DISP
  74        An UNSPEC wrapper around a SYMBOL_GOT_DISP.  It represents the
  75        the offset from _gp of the symbol's GOT entry.
  76
  77    SYMBOL_GOTOFF_CALL
  78        Like SYMBOL_GOTOFF_DISP, but used when calling a global function.
  79        The GOT entry is allowed to point to a stub rather than to the
  80        function itself.
  81
  82    SYMBOL_GOTOFF_LOADGP
  83        An UNSPEC wrapper around a function's address.  It represents the
  84        offset of _gp from the start of the function.
  85
  86    SYMBOL_TLS
  87        A thread-local symbol.
  88
  89    SYMBOL_TLSGD
  90    SYMBOL_TLSLDM
  91    SYMBOL_DTPREL
  92    SYMBOL_GOTTPREL
  93    SYMBOL_TPREL
  94        UNSPEC wrappers around SYMBOL_TLS, corresponding to the
  95        thread-local storage relocation operators.
  96
  97    SYMBOL_32_HIGH
  98        For a 32-bit symbolic address X, this is the value of %hi(X).
  99
 100    SYMBOL_64_HIGH
 101        For a 64-bit symbolic address X, this is the value of
 102        (%highest(X) << 16) + %higher(X).
 103
 104    SYMBOL_64_MID
 105        For a 64-bit symbolic address X, this is the value of
 106        (%higher(X) << 16) + %hi(X).
 107
 108    SYMBOL_64_LOW
 109        For a 64-bit symbolic address X, this is the value of
 110        (%hi(X) << 16) + %lo(X).
 111
 112    SYMBOL_HALF
 113        An UNSPEC wrapper around any kind of address.  It represents the
 114        low 16 bits of that address.  */
 115 enum mips_symbol_type {
 116   SYMBOL_ABSOLUTE,
 117   SYMBOL_GP_RELATIVE,
 118   SYMBOL_PC_RELATIVE,
 119   SYMBOL_FORCE_TO_MEM,
 120   SYMBOL_GOT_PAGE_OFST,
 121   SYMBOL_GOT_DISP,
 122   SYMBOL_GOTOFF_PAGE,
 123   SYMBOL_GOTOFF_DISP,
 124   SYMBOL_GOTOFF_CALL,
 125   SYMBOL_GOTOFF_LOADGP,
 126   SYMBOL_TLS,
 127   SYMBOL_TLSGD,
 128   SYMBOL_TLSLDM,
 129   SYMBOL_DTPREL,
 130   SYMBOL_GOTTPREL,
 131   SYMBOL_TPREL,
 132   SYMBOL_32_HIGH,
 133   SYMBOL_64_HIGH,
 134   SYMBOL_64_MID,
 135   SYMBOL_64_LOW,
 136   SYMBOL_HALF
 137 };
 138 #define NUM_SYMBOL_TYPES (SYMBOL_HALF + 1)
 139
 140 /* Identifiers a style of $gp initialization sequence.
 141
 142    LOADGP_NONE
 143         No initialization sequence is needed.
 144
 145    LOADGP_OLDABI
 146         The o32 and o64 PIC sequence (the kind traditionally generated
 147         by .cpload).
 148
 149    LOADGP_NEWABI
 150         The n32 and n64 PIC sequence (the kind traditionally generated
 151         by .cpsetup).
 152
 153    LOADGP_ABSOLUTE
 154         The GNU absolute sequence, as generated by loadgp_absolute.
 155
 156    LOADGP_RTP
 157         The VxWorks RTP PIC sequence, as generated by loadgp_rtp.  */
 158 enum mips_loadgp_style {
 159   LOADGP_NONE,
 160   LOADGP_OLDABI,
 161   LOADGP_NEWABI,
 162   LOADGP_ABSOLUTE,
 163   LOADGP_RTP
 164 };
 165
 166 struct mips16e_save_restore_info;
 167
 168 /* Classifies a type of call.
 169
 170    MIPS_CALL_NORMAL
 171         A normal call or call_value pattern.
 172
 173    MIPS_CALL_SIBCALL
 174         A sibcall or sibcall_value pattern.
 175
 176    MIPS_CALL_EPILOGUE
 177         A call inserted in the epilogue.  */
 178 enum mips_call_type {
 179   MIPS_CALL_NORMAL,
 180   MIPS_CALL_SIBCALL,
 181   MIPS_CALL_EPILOGUE
 182 };
 183
 184 extern bool mips_symbolic_constant_p (rtx, enum mips_symbol_context,
 185                                       enum mips_symbol_type *);
 186 extern int mips_regno_mode_ok_for_base_p (int, enum machine_mode, bool);
 187 extern bool mips_legitimate_address_p (enum machine_mode, rtx, bool);
 188 extern bool mips_stack_address_p (rtx, enum machine_mode);
 189 extern int mips_address_insns (rtx, enum machine_mode, bool);
 190 extern int mips_const_insns (rtx);
 191 extern int mips_split_const_insns (rtx);
 192 extern int mips_load_store_insns (rtx, rtx);
 193 extern int mips_idiv_insns (void);
 194 extern rtx mips_emit_move (rtx, rtx);
 195 extern rtx mips_pic_base_register (rtx);
 196 extern rtx mips_got_load (rtx, rtx, enum mips_symbol_type);
 197 extern bool mips_split_symbol (rtx, rtx, enum machine_mode, rtx *);
 198 extern rtx mips_unspec_address (rtx, enum mips_symbol_type);
 199 extern void mips_move_integer (rtx, rtx, unsigned HOST_WIDE_INT);
 200 extern bool mips_legitimize_move (enum machine_mode, rtx, rtx);
 201
 202 extern int m16_uimm3_b (rtx, enum machine_mode);
 203 extern int m16_simm4_1 (rtx, enum machine_mode);
 204 extern int m16_nsimm4_1 (rtx, enum machine_mode);
 205 extern int m16_simm5_1 (rtx, enum machine_mode);
 206 extern int m16_nsimm5_1 (rtx, enum machine_mode);
 207 extern int m16_uimm5_4 (rtx, enum machine_mode);
 208 extern int m16_nuimm5_4 (rtx, enum machine_mode);
 209 extern int m16_simm8_1 (rtx, enum machine_mode);
 210 extern int m16_nsimm8_1 (rtx, enum machine_mode);
 211 extern int m16_uimm8_1 (rtx, enum machine_mode);
 212 extern int m16_nuimm8_1 (rtx, enum machine_mode);
 213 extern int m16_uimm8_m1_1 (rtx, enum machine_mode);
 214 extern int m16_uimm8_4 (rtx, enum machine_mode);
 215 extern int m16_nuimm8_4 (rtx, enum machine_mode);
 216 extern int m16_simm8_8 (rtx, enum machine_mode);
 217 extern int m16_nsimm8_8 (rtx, enum machine_mode);
 218
 219 extern rtx mips_subword (rtx, bool);
 220 extern bool mips_split_64bit_move_p (rtx, rtx);
 221 extern void mips_split_doubleword_move (rtx, rtx);
 222 extern const char *mips_output_move (rtx, rtx);
 223 extern void mips_restore_gp (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 mips_expand_call (enum mips_call_type, rtx, rtx, rtx, rtx, bool);
 233 extern void mips_split_call (rtx, rtx);
 234 extern void mips_expand_fcc_reload (rtx, rtx, rtx);
 235 extern void mips_set_return_address (rtx, rtx);
 236 extern bool mips_expand_block_move (rtx, rtx, rtx);
 237 extern void mips_expand_synci_loop (rtx, rtx);
 238
 239 extern void mips_init_cumulative_args (CUMULATIVE_ARGS *, tree);
 240 extern void mips_function_arg_advance (CUMULATIVE_ARGS *, enum machine_mode,
 241                                        tree, int);
 242 extern rtx mips_function_arg (const CUMULATIVE_ARGS *,
 243                               enum machine_mode, tree, int);
 244 extern int mips_function_arg_boundary (enum machine_mode, tree);
 245 extern bool mips_pad_arg_upward (enum machine_mode, const_tree);
 246 extern bool mips_pad_reg_upward (enum machine_mode, tree);
 247
 248 extern bool mips_expand_ext_as_unaligned_load (rtx, rtx, HOST_WIDE_INT,
 249                                                HOST_WIDE_INT);
 250 extern bool mips_expand_ins_as_unaligned_store (rtx, rtx, HOST_WIDE_INT,
 251                                                 HOST_WIDE_INT);
 252 extern bool mips_mem_fits_mode_p (enum machine_mode mode, rtx x);
 253 extern void mips_override_options (void);
 254 extern void mips_conditional_register_usage (void);
 255 extern void mips_order_regs_for_local_alloc (void);
 256 extern HOST_WIDE_INT mips_debugger_offset (rtx, HOST_WIDE_INT);
 257
 258 extern void mips_print_operand (FILE *, rtx, int);
 259 extern void mips_print_operand_address (FILE *, rtx);
 260 extern void mips_output_external (FILE *, tree, const char *);
 261 extern void mips_output_filename (FILE *, const char *);
 262 extern void mips_output_ascii (FILE *, const char *, size_t);
 263 extern void mips_output_aligned_decl_common (FILE *, tree, const char *,
 264                                              unsigned HOST_WIDE_INT,
 265                                              unsigned int);
 266 extern void mips_declare_common_object (FILE *, const char *,
 267                                         const char *, unsigned HOST_WIDE_INT,
 268                                         unsigned int, bool);
 269 extern void mips_declare_object (FILE *, const char *, const char *,
 270                                  const char *, ...) ATTRIBUTE_PRINTF_4;
 271 extern void mips_declare_object_name (FILE *, const char *, tree);
 272 extern void mips_finish_declare_object (FILE *, tree, int, int);
 273
 274 extern bool mips_small_data_pattern_p (rtx);
 275 extern rtx mips_rewrite_small_data (rtx);
 276 extern bool mips_frame_pointer_required (void);
 277 extern HOST_WIDE_INT mips_initial_elimination_offset (int, int);
 278 extern rtx mips_return_addr (int, rtx);
 279 extern enum mips_loadgp_style mips_current_loadgp_style (void);
 280 extern void mips_expand_prologue (void);
 281 extern void mips_expand_before_return (void);
 282 extern void mips_expand_epilogue (bool);
 283 extern bool mips_can_use_return_insn (void);
 284 extern rtx mips_function_value (const_tree, enum machine_mode);
 285
 286 extern bool mips_cannot_change_mode_class (enum machine_mode,
 287                                            enum machine_mode, enum reg_class);
 288 extern bool mips_dangerous_for_la25_p (rtx);
 289 extern bool mips_modes_tieable_p (enum machine_mode, enum machine_mode);
 290 extern enum reg_class mips_preferred_reload_class (rtx, enum reg_class);
 291 extern enum reg_class mips_secondary_reload_class (enum reg_class,
 292                                                    enum machine_mode,
 293                                                    rtx, bool);
 294 extern int mips_class_max_nregs (enum reg_class, enum machine_mode);
 295 extern int mips_register_move_cost (enum machine_mode, enum reg_class,
 296                                     enum reg_class);
 297
 298 extern int mips_adjust_insn_length (rtx, int);
 299 extern const char *mips_output_load_label (void);
 300 extern const char *mips_output_conditional_branch (rtx, rtx *, const char *,
 301                                                    const char *);
 302 extern const char *mips_output_order_conditional_branch (rtx, rtx *, bool);
 303 extern const char *mips_output_sync_loop (const char *);
 304 extern const char *mips_output_division (const char *, rtx *);
 305 extern unsigned int mips_hard_regno_nregs (int, enum machine_mode);
 306 extern bool mips_linked_madd_p (rtx, rtx);
 307 extern bool mips_store_data_bypass_p (rtx, rtx);
 308 extern rtx mips_prefetch_cookie (rtx, rtx);
 309
 310 extern void irix_asm_output_align (FILE *, unsigned);
 311 extern const char *current_section_name (void);
 312 extern unsigned int current_section_flags (void);
 313 extern bool mips_use_ins_ext_p (rtx, HOST_WIDE_INT, HOST_WIDE_INT);
 314
 315 extern const char *mips16e_output_save_restore (rtx, HOST_WIDE_INT);
 316 extern bool mips16e_save_restore_pattern_p (rtx, HOST_WIDE_INT,
 317                                             struct mips16e_save_restore_info *);
 318
 319 extern bool mask_low_and_shift_p (enum machine_mode, rtx, rtx, int);
 320 extern int mask_low_and_shift_len (enum machine_mode, rtx, rtx);
 321
 322 union mips_gen_fn_ptrs
 323 {
 324   rtx (*fn_6) (rtx, rtx, rtx, rtx, rtx, rtx);
 325   rtx (*fn_5) (rtx, rtx, rtx, rtx, rtx);
 326   rtx (*fn_4) (rtx, rtx, rtx, rtx);
 327 };
 328
 329 extern void mips_expand_atomic_qihi (union mips_gen_fn_ptrs,
 330                                      rtx, rtx, rtx, rtx);
 331
 332 extern void mips_expand_vector_init (rtx, rtx);
 333
 334 extern bool mips_epilogue_uses (unsigned int);
 335 extern void mips_final_prescan_insn (rtx, rtx *, int);
 336
 337 #endif /* ! GCC_MIPS_PROTOS_H */