gcc/optabs.h

   1 /* Definitions for code generation pass of GNU compiler.
   2    Copyright (C) 2001-2013 Free Software Foundation, Inc.
   3
   4 This file is part of GCC.
   5
   6 GCC is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 3, or (at your option)
   9 any later version.
  10
  11 GCC is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 GNU General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GCC; see the file COPYING3.  If not see
  18 <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef GCC_OPTABS_H
  21 #define GCC_OPTABS_H
  22
  23 #include "insn-codes.h"
  24 #include "insn-opinit.h"
  25
  26 typedef enum optab_tag optab;
  27 typedef enum optab_tag convert_optab;
  28 typedef enum optab_tag direct_optab;
  29
  30 struct optab_libcall_d
  31 {
  32   char libcall_suffix;
  33   const char *libcall_basename;
  34   void (*libcall_gen) (optab, const char *name,
  35                        char suffix, enum machine_mode);
  36 };
  37
  38 struct convert_optab_libcall_d
  39 {
  40   const char *libcall_basename;
  41   void (*libcall_gen) (convert_optab, const char *name,
  42                        enum machine_mode, enum machine_mode);
  43 };
  44
  45 /* Given an enum insn_code, access the function to construct
  46    the body of that kind of insn.  */
  47 #define GEN_FCN(CODE) (insn_data[CODE].genfun)
  48
  49 /* Contains the optab used for each rtx code, and vice-versa.  */
  50 extern const optab code_to_optab_[NUM_RTX_CODE];
  51 extern const enum rtx_code optab_to_code_[NUM_OPTABS];
  52
  53 static inline optab
  54 code_to_optab (enum rtx_code code)
  55 {
  56   return code_to_optab_[code];
  57 }
  58
  59 static inline enum rtx_code
  60 optab_to_code (optab op)
  61 {
  62   return optab_to_code_[op];
  63 }
  64
  65 extern const struct convert_optab_libcall_d convlib_def[NUM_CONVLIB_OPTABS];
  66 extern const struct optab_libcall_d normlib_def[NUM_NORMLIB_OPTABS];
  67
  68 /* Returns the active icode for the given (encoded) optab.  */
  69 extern enum insn_code raw_optab_handler (unsigned);
  70 extern bool swap_optab_enable (optab, enum machine_mode, bool);
  71
  72 /* Target-dependent globals.  */
  73 struct target_optabs {
  74   /* Patterns that are used by optabs that are enabled for this target.  */
  75   bool pat_enable[NUM_OPTAB_PATTERNS];
  76 };
  77
  78 extern struct target_optabs default_target_optabs;
  79 extern struct target_optabs *this_fn_optabs;
  80 #if SWITCHABLE_TARGET
  81 extern struct target_optabs *this_target_optabs;
  82 #else
  83 #define this_target_optabs (&default_target_optabs)
  84 #endif
  85 \f
  86 /* Define functions given in optabs.c.  */
  87
  88 extern rtx expand_widen_pattern_expr (sepops ops, rtx op0, rtx op1, rtx wide_op,
  89                                       rtx target, int unsignedp);
  90
  91 extern rtx expand_ternary_op (enum machine_mode mode, optab ternary_optab,
  92                               rtx op0, rtx op1, rtx op2, rtx target,
  93                               int unsignedp);
  94
  95 /* Expand a binary operation given optab and rtx operands.  */
  96 extern rtx expand_binop (enum machine_mode, optab, rtx, rtx, rtx, int,
  97                          enum optab_methods);
  98
  99 extern rtx simplify_expand_binop (enum machine_mode mode, optab binoptab,
 100                                   rtx op0, rtx op1, rtx target, int unsignedp,
 101                                   enum optab_methods methods);
 102
 103 extern bool force_expand_binop (enum machine_mode, optab, rtx, rtx, rtx, int,
 104                                 enum optab_methods);
 105
 106 /* Expand a binary operation with both signed and unsigned forms.  */
 107 extern rtx sign_expand_binop (enum machine_mode, optab, optab, rtx, rtx,
 108                               rtx, int, enum optab_methods);
 109
 110 /* Generate code to perform an operation on one operand with two results.  */
 111 extern int expand_twoval_unop (optab, rtx, rtx, rtx, int);
 112
 113 /* Generate code to perform an operation on two operands with two results.  */
 114 extern int expand_twoval_binop (optab, rtx, rtx, rtx, rtx, int);
 115
 116 /* Generate code to perform an operation on two operands with two
 117    results, using a library function.  */
 118 extern bool expand_twoval_binop_libfunc (optab, rtx, rtx, rtx, rtx,
 119                                          enum rtx_code);
 120
 121 /* Expand a unary arithmetic operation given optab rtx operand.  */
 122 extern rtx expand_unop (enum machine_mode, optab, rtx, rtx, int);
 123
 124 /* Expand the absolute value operation.  */
 125 extern rtx expand_abs_nojump (enum machine_mode, rtx, rtx, int);
 126 extern rtx expand_abs (enum machine_mode, rtx, rtx, int, int);
 127
 128 /* Expand the one's complement absolute value operation.  */
 129 extern rtx expand_one_cmpl_abs_nojump (enum machine_mode, rtx, rtx);
 130
 131 /* Expand the copysign operation.  */
 132 extern rtx expand_copysign (rtx, rtx, rtx);
 133
 134 /* Generate an instruction with a given INSN_CODE with an output and
 135    an input.  */
 136 extern void emit_unop_insn (enum insn_code, rtx, rtx, enum rtx_code);
 137 extern bool maybe_emit_unop_insn (enum insn_code, rtx, rtx, enum rtx_code);
 138
 139 /* Find a widening optab even if it doesn't widen as much as we want.  */
 140 #define find_widening_optab_handler(A,B,C,D) \
 141   find_widening_optab_handler_and_mode (A, B, C, D, NULL)
 142 extern enum insn_code find_widening_optab_handler_and_mode (optab,
 143                                                             enum machine_mode,
 144                                                             enum machine_mode,
 145                                                             int,
 146                                                             enum machine_mode *);
 147
 148 /* An extra flag to control optab_for_tree_code's behavior.  This is needed to
 149    distinguish between machines with a vector shift that takes a scalar for the
 150    shift amount vs. machines that take a vector for the shift amount.  */
 151 enum optab_subtype
 152 {
 153   optab_default,
 154   optab_scalar,
 155   optab_vector
 156 };
 157
 158 /* Return the optab used for computing the given operation on the type given by
 159    the second argument.  The third argument distinguishes between the types of
 160    vector shifts and rotates */
 161 extern optab optab_for_tree_code (enum tree_code, const_tree, enum optab_subtype);
 162
 163 /* The various uses that a comparison can have; used by can_compare_p:
 164    jumps, conditional moves, store flag operations.  */
 165 enum can_compare_purpose
 166 {
 167   ccp_jump,
 168   ccp_cmov,
 169   ccp_store_flag
 170 };
 171
 172 /* Nonzero if a compare of mode MODE can be done straightforwardly
 173    (without splitting it into pieces).  */
 174 extern int can_compare_p (enum rtx_code, enum machine_mode,
 175                           enum can_compare_purpose);
 176
 177 /* Return the INSN_CODE to use for an extend operation.  */
 178 extern enum insn_code can_extend_p (enum machine_mode, enum machine_mode, int);
 179
 180 /* Generate the body of an insn to extend Y (with mode MFROM)
 181    into X (with mode MTO).  Do zero-extension if UNSIGNEDP is nonzero.  */
 182 extern rtx gen_extend_insn (rtx, rtx, enum machine_mode,
 183                             enum machine_mode, int);
 184
 185 /* Call this to reset the function entry for one optab.  */
 186 extern void set_optab_libfunc (optab, enum machine_mode, const char *);
 187 extern void set_conv_libfunc (convert_optab, enum machine_mode,
 188                               enum machine_mode, const char *);
 189
 190 /* Call this to install all of the __sync libcalls up to size MAX.  */
 191 extern void init_sync_libfuncs (int max);
 192
 193 /* Generate code for a FIXED_CONVERT_EXPR.  */
 194 extern void expand_fixed_convert (rtx, rtx, int, int);
 195
 196 /* Generate code for a FLOAT_EXPR.  */
 197 extern void expand_float (rtx, rtx, int);
 198
 199 /* Return the insn_code for a FLOAT_EXPR.  */
 200 enum insn_code can_float_p (enum machine_mode, enum machine_mode, int);
 201
 202 /* Return true if there is an inline compare and swap pattern.  */
 203 extern bool can_compare_and_swap_p (enum machine_mode, bool);
 204
 205 /* Return true if there is an inline atomic exchange pattern.  */
 206 extern bool can_atomic_exchange_p (enum machine_mode, bool);
 207
 208 /* Generate code for a compare and swap.  */
 209 extern bool expand_atomic_compare_and_swap (rtx *, rtx *, rtx, rtx, rtx, bool,
 210                                             enum memmodel, enum memmodel);
 211
 212 /* Generate memory barriers.  */
 213 extern void expand_mem_thread_fence (enum memmodel);
 214 extern void expand_mem_signal_fence (enum memmodel);
 215
 216 /* Check whether an operation represented by the code CODE is a
 217    convert operation that is supported by the target platform in
 218    vector form */
 219 bool supportable_convert_operation (enum tree_code, tree, tree, tree *,
 220                                     enum tree_code *);
 221
 222 /* Generate code for a FIX_EXPR.  */
 223 extern void expand_fix (rtx, rtx, int);
 224
 225 /* Generate code for float to integral conversion.  */
 226 extern bool expand_sfix_optab (rtx, rtx, convert_optab);
 227
 228 /* Generate code for a widening multiply.  */
 229 extern rtx expand_widening_mult (enum machine_mode, rtx, rtx, rtx, int, optab);
 230
 231 /* Return tree if target supports vector operations for COND_EXPR.  */
 232 bool expand_vec_cond_expr_p (tree, tree);
 233
 234 /* Generate code for VEC_COND_EXPR.  */
 235 extern rtx expand_vec_cond_expr (tree, tree, tree, tree, rtx);
 236 /* Generate code for VEC_LSHIFT_EXPR and VEC_RSHIFT_EXPR.  */
 237 extern rtx expand_vec_shift_expr (sepops, rtx);
 238
 239 /* Return true if target supports vector operations for VEC_PERM_EXPR.  */
 240 extern bool can_vec_perm_p (enum machine_mode, bool, const unsigned char *);
 241
 242 /* Generate code for VEC_PERM_EXPR.  */
 243 extern rtx expand_vec_perm (enum machine_mode, rtx, rtx, rtx, rtx);
 244
 245 /* Return non-zero if target supports a given highpart multiplication.  */
 246 extern int can_mult_highpart_p (enum machine_mode, bool);
 247
 248 /* Generate code for MULT_HIGHPART_EXPR.  */
 249 extern rtx expand_mult_highpart (enum machine_mode, rtx, rtx, rtx, bool);
 250
 251 /* Return true if target supports vector masked load/store for mode.  */
 252 extern bool can_vec_mask_load_store_p (enum machine_mode, bool);
 253
 254 /* Return the insn used to implement mode MODE of OP, or CODE_FOR_nothing
 255    if the target does not have such an insn.  */
 256
 257 static inline enum insn_code
 258 optab_handler (optab op, enum machine_mode mode)
 259 {
 260   unsigned scode = (op << 16) | mode;
 261   gcc_assert (op > LAST_CONV_OPTAB);
 262   return raw_optab_handler (scode);
 263 }
 264
 265 /* Return the insn used to perform conversion OP from mode FROM_MODE
 266    to mode TO_MODE; return CODE_FOR_nothing if the target does not have
 267    such an insn.  */
 268
 269 static inline enum insn_code
 270 convert_optab_handler (convert_optab op, enum machine_mode to_mode,
 271                        enum machine_mode from_mode)
 272 {
 273   unsigned scode = (op << 16) | (from_mode << 8) | to_mode;
 274   gcc_assert (op > unknown_optab && op <= LAST_CONV_OPTAB);
 275   return raw_optab_handler (scode);
 276 }
 277
 278 /* Like optab_handler, but for widening_operations that have a
 279    TO_MODE and a FROM_MODE.  */
 280
 281 static inline enum insn_code
 282 widening_optab_handler (optab op, enum machine_mode to_mode,
 283                         enum machine_mode from_mode)
 284 {
 285   unsigned scode = (op << 16) | to_mode;
 286   if (to_mode != from_mode && from_mode != VOIDmode)
 287     {
 288       /* ??? Why does find_widening_optab_handler_and_mode attempt to
 289          widen things that can't be widened?  E.g. add_optab... */
 290       if (op > LAST_CONV_OPTAB)
 291         return CODE_FOR_nothing;
 292       scode |= from_mode << 8;
 293     }
 294   return raw_optab_handler (scode);
 295 }
 296
 297 /* Return the insn used to implement mode MODE of OP, or CODE_FOR_nothing
 298    if the target does not have such an insn.  */
 299
 300 static inline enum insn_code
 301 direct_optab_handler (direct_optab op, enum machine_mode mode)
 302 {
 303   return optab_handler (op, mode);
 304 }
 305
 306 /* Return true if UNOPTAB is for a trapping-on-overflow operation.  */
 307
 308 static inline bool
 309 trapv_unoptab_p (optab unoptab)
 310 {
 311   return (unoptab == negv_optab
 312           || unoptab == absv_optab);
 313 }
 314
 315 /* Return true if BINOPTAB is for a trapping-on-overflow operation.  */
 316
 317 static inline bool
 318 trapv_binoptab_p (optab binoptab)
 319 {
 320   return (binoptab == addv_optab
 321           || binoptab == subv_optab
 322           || binoptab == smulv_optab);
 323 }
 324
 325 extern rtx optab_libfunc (optab optab, enum machine_mode mode);
 326 extern rtx convert_optab_libfunc (convert_optab optab, enum machine_mode mode1,
 327                                   enum machine_mode mode2);
 328
 329 /* Describes an instruction that inserts or extracts a bitfield.  */
 330 struct extraction_insn
 331 {
 332   /* The code of the instruction.  */
 333   enum insn_code icode;
 334
 335   /* The mode that the structure operand should have.  This is byte_mode
 336      when using the legacy insv, extv and extzv patterns to access memory.  */
 337   enum machine_mode struct_mode;
 338
 339   /* The mode of the field to be inserted or extracted, and by extension
 340      the mode of the insertion or extraction itself.  */
 341   enum machine_mode field_mode;
 342
 343   /* The mode of the field's bit position.  This is only important
 344      when the position is variable rather than constant.  */
 345   enum machine_mode pos_mode;
 346 };
 347
 348 /* Enumerates the possible extraction_insn operations.  */
 349 enum extraction_pattern { EP_insv, EP_extv, EP_extzv };
 350
 351 extern bool get_best_reg_extraction_insn (extraction_insn *,
 352                                           enum extraction_pattern,
 353                                           unsigned HOST_WIDE_INT,
 354                                           enum machine_mode);
 355
 356 extern bool get_best_mem_extraction_insn (extraction_insn *,
 357                                           enum extraction_pattern,
 358                                           HOST_WIDE_INT, HOST_WIDE_INT,
 359                                           enum machine_mode);
 360
 361 extern bool insn_operand_matches (enum insn_code icode, unsigned int opno,
 362                                   rtx operand);
 363
 364 /* Describes the type of an expand_operand.  Each value is associated
 365    with a create_*_operand function; see the comments above those
 366    functions for details.  */
 367 enum expand_operand_type {
 368   EXPAND_FIXED,
 369   EXPAND_OUTPUT,
 370   EXPAND_INPUT,
 371   EXPAND_CONVERT_TO,
 372   EXPAND_CONVERT_FROM,
 373   EXPAND_ADDRESS,
 374   EXPAND_INTEGER
 375 };
 376
 377 /* Information about an operand for instruction expansion.  */
 378 struct expand_operand {
 379   /* The type of operand.  */
 380   ENUM_BITFIELD (expand_operand_type) type : 8;
 381
 382   /* True if any conversion should treat VALUE as being unsigned
 383      rather than signed.  Only meaningful for certain types.  */
 384   unsigned int unsigned_p : 1;
 385
 386   /* Unused; available for future use.  */
 387   unsigned int unused : 7;
 388
 389   /* The mode passed to the convert_*_operand function.  It has a
 390      type-dependent meaning.  */
 391   ENUM_BITFIELD (machine_mode) mode : 16;
 392
 393   /* The value of the operand.  */
 394   rtx value;
 395 };
 396
 397 /* Initialize OP with the given fields.  Initialise the other fields
 398    to their default values.  */
 399
 400 static inline void
 401 create_expand_operand (struct expand_operand *op,
 402                        enum expand_operand_type type,
 403                        rtx value, enum machine_mode mode,
 404                        bool unsigned_p)
 405 {
 406   op->type = type;
 407   op->unsigned_p = unsigned_p;
 408   op->unused = 0;
 409   op->mode = mode;
 410   op->value = value;
 411 }
 412
 413 /* Make OP describe an operand that must use rtx X, even if X is volatile.  */
 414
 415 static inline void
 416 create_fixed_operand (struct expand_operand *op, rtx x)
 417 {
 418   create_expand_operand (op, EXPAND_FIXED, x, VOIDmode, false);
 419 }
 420
 421 /* Make OP describe an output operand that must have mode MODE.
 422    X, if nonnull, is a suggestion for where the output should be stored.
 423    It is OK for VALUE to be inconsistent with MODE, although it will just
 424    be ignored in that case.  */
 425
 426 static inline void
 427 create_output_operand (struct expand_operand *op, rtx x,
 428                        enum machine_mode mode)
 429 {
 430   create_expand_operand (op, EXPAND_OUTPUT, x, mode, false);
 431 }
 432
 433 /* Make OP describe an input operand that must have mode MODE and
 434    value VALUE; MODE cannot be VOIDmode.  The backend may request that
 435    VALUE be copied into a different kind of rtx before being passed
 436    as an operand.  */
 437
 438 static inline void
 439 create_input_operand (struct expand_operand *op, rtx value,
 440                       enum machine_mode mode)
 441 {
 442   create_expand_operand (op, EXPAND_INPUT, value, mode, false);
 443 }
 444
 445 /* Like create_input_operand, except that VALUE must first be converted
 446    to mode MODE.  UNSIGNED_P says whether VALUE is unsigned.  */
 447
 448 static inline void
 449 create_convert_operand_to (struct expand_operand *op, rtx value,
 450                            enum machine_mode mode, bool unsigned_p)
 451 {
 452   create_expand_operand (op, EXPAND_CONVERT_TO, value, mode, unsigned_p);
 453 }
 454
 455 /* Make OP describe an input operand that should have the same value
 456    as VALUE, after any mode conversion that the backend might request.
 457    If VALUE is a CONST_INT, it should be treated as having mode MODE.
 458    UNSIGNED_P says whether VALUE is unsigned.  */
 459
 460 static inline void
 461 create_convert_operand_from (struct expand_operand *op, rtx value,
 462                              enum machine_mode mode, bool unsigned_p)
 463 {
 464   create_expand_operand (op, EXPAND_CONVERT_FROM, value, mode, unsigned_p);
 465 }
 466
 467 extern void create_convert_operand_from_type (struct expand_operand *op,
 468                                               rtx value, tree type);
 469
 470 /* Make OP describe an input Pmode address operand.  VALUE is the value
 471    of the address, but it may need to be converted to Pmode first.  */
 472
 473 static inline void
 474 create_address_operand (struct expand_operand *op, rtx value)
 475 {
 476   create_expand_operand (op, EXPAND_ADDRESS, value, Pmode, false);
 477 }
 478
 479 /* Make OP describe an input operand that has value INTVAL and that has
 480    no inherent mode.  This function should only be used for operands that
 481    are always expand-time constants.  The backend may request that INTVAL
 482    be copied into a different kind of rtx, but it must specify the mode
 483    of that rtx if so.  */
 484
 485 static inline void
 486 create_integer_operand (struct expand_operand *op, HOST_WIDE_INT intval)
 487 {
 488   create_expand_operand (op, EXPAND_INTEGER, GEN_INT (intval), VOIDmode, false);
 489 }
 490
 491 extern bool valid_multiword_target_p (rtx);
 492
 493 extern bool maybe_legitimize_operands (enum insn_code icode,
 494                                        unsigned int opno, unsigned int nops,
 495                                        struct expand_operand *ops);
 496 extern rtx maybe_gen_insn (enum insn_code icode, unsigned int nops,
 497                            struct expand_operand *ops);
 498 extern bool maybe_expand_insn (enum insn_code icode, unsigned int nops,
 499                                struct expand_operand *ops);
 500 extern bool maybe_expand_jump_insn (enum insn_code icode, unsigned int nops,
 501                                     struct expand_operand *ops);
 502 extern void expand_insn (enum insn_code icode, unsigned int nops,
 503                          struct expand_operand *ops);
 504 extern void expand_jump_insn (enum insn_code icode, unsigned int nops,
 505                               struct expand_operand *ops);
 506
 507 extern rtx prepare_operand (enum insn_code, rtx, int, enum machine_mode,
 508                             enum machine_mode, int);
 509
 510 extern void gen_int_libfunc (optab, const char *, char, enum machine_mode);
 511 extern void gen_fp_libfunc (optab, const char *, char, enum machine_mode);
 512 extern void gen_fixed_libfunc (optab, const char *, char, enum machine_mode);
 513 extern void gen_signed_fixed_libfunc (optab, const char *, char,
 514                                       enum machine_mode);
 515 extern void gen_unsigned_fixed_libfunc (optab, const char *, char,
 516                                         enum machine_mode);
 517 extern void gen_int_fp_libfunc (optab, const char *, char, enum machine_mode);
 518 extern void gen_intv_fp_libfunc (optab, const char *, char, enum machine_mode);
 519 extern void gen_int_fp_fixed_libfunc (optab, const char *, char,
 520                                       enum machine_mode);
 521 extern void gen_int_fp_signed_fixed_libfunc (optab, const char *, char,
 522                                              enum machine_mode);
 523 extern void gen_int_fixed_libfunc (optab, const char *, char,
 524                                    enum machine_mode);
 525 extern void gen_int_signed_fixed_libfunc (optab, const char *, char,
 526                                           enum machine_mode);
 527 extern void gen_int_unsigned_fixed_libfunc (optab, const char *, char,
 528                                             enum machine_mode);
 529
 530 extern void gen_interclass_conv_libfunc (convert_optab, const char *,
 531                                          enum machine_mode, enum machine_mode);
 532 extern void gen_int_to_fp_conv_libfunc (convert_optab, const char *,
 533                                         enum machine_mode, enum machine_mode);
 534 extern void gen_ufloat_conv_libfunc (convert_optab, const char *,
 535                                      enum machine_mode, enum machine_mode);
 536 extern void gen_int_to_fp_nondecimal_conv_libfunc  (convert_optab,
 537                                                     const char *,
 538                                                     enum machine_mode,
 539                                                     enum machine_mode);
 540 extern void gen_fp_to_int_conv_libfunc (convert_optab, const char *,
 541                                         enum machine_mode, enum machine_mode);
 542 extern void gen_intraclass_conv_libfunc (convert_optab, const char *,
 543                                          enum machine_mode, enum machine_mode);
 544 extern void gen_trunc_conv_libfunc (convert_optab, const char *,
 545                                     enum machine_mode, enum machine_mode);
 546 extern void gen_extend_conv_libfunc (convert_optab, const char *,
 547                                      enum machine_mode, enum machine_mode);
 548 extern void gen_fract_conv_libfunc (convert_optab, const char *,
 549                                     enum machine_mode, enum machine_mode);
 550 extern void gen_fractuns_conv_libfunc (convert_optab, const char *,
 551                                        enum machine_mode, enum machine_mode);
 552 extern void gen_satfract_conv_libfunc (convert_optab, const char *,
 553                                        enum machine_mode, enum machine_mode);
 554 extern void gen_satfractuns_conv_libfunc (convert_optab, const char *,
 555                                           enum machine_mode,
 556                                           enum machine_mode);
 557 extern void init_tree_optimization_optabs (tree);
 558
 559 #endif /* GCC_OPTABS_H */