gcc/expr.h

   1 /* Definitions for code generation pass of GNU compiler.
   2    Copyright (C) 1987, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
   3    1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 2, or (at your option) any later
  10 version.
  11
  12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING.  If not, write to the Free
  19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  20 02111-1307, USA.  */
  21
  22 /* The default branch cost is 1.  */
  23 #ifndef BRANCH_COST
  24 #define BRANCH_COST 1
  25 #endif
  26
  27 /* Macros to access the slots of a QUEUED rtx.
  28    Here rather than in rtl.h because only the expansion pass
  29    should ever encounter a QUEUED.  */
  30
  31 /* The variable for which an increment is queued.  */
  32 #define QUEUED_VAR(P) XEXP (P, 0)
  33 /* If the increment has been emitted, this is the insn
  34    that does the increment.  It is zero before the increment is emitted.
  35    If more than one insn is emitted, this is the first insn.  */
  36 #define QUEUED_INSN(P) XEXP (P, 1)
  37 /* If a pre-increment copy has been generated, this is the copy
  38    (it is a temporary reg).  Zero if no copy made yet.  */
  39 #define QUEUED_COPY(P) XEXP (P, 2)
  40 /* This is the body to use for the insn to do the increment.
  41    It is used to emit the increment.  */
  42 #define QUEUED_BODY(P) XEXP (P, 3)
  43 /* Next QUEUED in the queue.  */
  44 #define QUEUED_NEXT(P) XEXP (P, 4)
  45
  46 /* This is the 4th arg to `expand_expr'.
  47    EXPAND_STACK_PARM means we are possibly expanding a call param onto
  48    the stack.  Choosing a value of 2 isn't special;  It just allows
  49    some code optimization in store_expr.
  50    EXPAND_SUM means it is ok to return a PLUS rtx or MULT rtx.
  51    EXPAND_INITIALIZER is similar but also record any labels on forced_labels.
  52    EXPAND_CONST_ADDRESS means it is ok to return a MEM whose address
  53     is a constant that is not a legitimate address.
  54    EXPAND_WRITE means we are only going to write to the resulting rtx.  */
  55 enum expand_modifier {EXPAND_NORMAL = 0, EXPAND_STACK_PARM = 2, EXPAND_SUM,
  56                       EXPAND_CONST_ADDRESS, EXPAND_INITIALIZER, EXPAND_WRITE};
  57
  58 /* Prevent the compiler from deferring stack pops.  See
  59    inhibit_defer_pop for more information.  */
  60 #define NO_DEFER_POP (inhibit_defer_pop += 1)
  61
  62 /* Allow the compiler to defer stack pops.  See inhibit_defer_pop for
  63    more information.  */
  64 #define OK_DEFER_POP (inhibit_defer_pop -= 1)
  65 \f
  66 enum direction {none, upward, downward};
  67
  68 #ifdef TREE_CODE /* Don't lose if tree.h not included.  */
  69 /* Structure to record the size of a sequence of arguments
  70    as the sum of a tree-expression and a constant.  This structure is
  71    also used to store offsets from the stack, which might be negative,
  72    so the variable part must be ssizetype, not sizetype.  */
  73
  74 struct args_size
  75 {
  76   HOST_WIDE_INT constant;
  77   tree var;
  78 };
  79
  80 /* Package up various arg related fields of struct args for
  81    locate_and_pad_parm.  */
  82 struct locate_and_pad_arg_data
  83 {
  84   /* Size of this argument on the stack, rounded up for any padding it
  85      gets.  If REG_PARM_STACK_SPACE is defined, then register parms are
  86      counted here, otherwise they aren't.  */
  87   struct args_size size;
  88   /* Offset of this argument from beginning of stack-args.  */
  89   struct args_size offset;
  90   /* Offset to the start of the stack slot.  Different from OFFSET
  91      if this arg pads downward.  */
  92   struct args_size slot_offset;
  93   /* The amount that the stack pointer needs to be adjusted to
  94      force alignment for the next argument.  */
  95   struct args_size alignment_pad;
  96 };
  97 #endif
  98
  99 /* Add the value of the tree INC to the `struct args_size' TO.  */
 100
 101 #define ADD_PARM_SIZE(TO, INC)                          \
 102 do {                                                    \
 103   tree inc = (INC);                                     \
 104   if (host_integerp (inc, 0))                           \
 105     (TO).constant += tree_low_cst (inc, 0);             \
 106   else if ((TO).var == 0)                               \
 107     (TO).var = convert (ssizetype, inc);                \
 108   else                                                  \
 109     (TO).var = size_binop (PLUS_EXPR, (TO).var,         \
 110                            convert (ssizetype, inc));   \
 111 } while (0)
 112
 113 #define SUB_PARM_SIZE(TO, DEC)                          \
 114 do {                                                    \
 115   tree dec = (DEC);                                     \
 116   if (host_integerp (dec, 0))                           \
 117     (TO).constant -= tree_low_cst (dec, 0);             \
 118   else if ((TO).var == 0)                               \
 119     (TO).var = size_binop (MINUS_EXPR, ssize_int (0),   \
 120                            convert (ssizetype, dec));   \
 121   else                                                  \
 122     (TO).var = size_binop (MINUS_EXPR, (TO).var,        \
 123                            convert (ssizetype, dec));   \
 124 } while (0)
 125
 126 /* Convert the implicit sum in a `struct args_size' into a tree
 127    of type ssizetype.  */
 128 #define ARGS_SIZE_TREE(SIZE)                                    \
 129 ((SIZE).var == 0 ? ssize_int ((SIZE).constant)                  \
 130  : size_binop (PLUS_EXPR, convert (ssizetype, (SIZE).var),      \
 131                ssize_int ((SIZE).constant)))
 132
 133 /* Convert the implicit sum in a `struct args_size' into an rtx.  */
 134 #define ARGS_SIZE_RTX(SIZE)                                     \
 135 ((SIZE).var == 0 ? GEN_INT ((SIZE).constant)                    \
 136  : expand_expr (ARGS_SIZE_TREE (SIZE), NULL_RTX, VOIDmode, 0))
 137
 138 /* Supply a default definition for FUNCTION_ARG_PADDING:
 139    usually pad upward, but pad short args downward on
 140    big-endian machines.  */
 141
 142 #ifndef FUNCTION_ARG_PADDING
 143 #define FUNCTION_ARG_PADDING(MODE, TYPE)                                \
 144   (! BYTES_BIG_ENDIAN                                                   \
 145    ? upward                                                             \
 146    : (((MODE) == BLKmode                                                \
 147        ? ((TYPE) && TREE_CODE (TYPE_SIZE (TYPE)) == INTEGER_CST         \
 148           && int_size_in_bytes (TYPE) < (PARM_BOUNDARY / BITS_PER_UNIT)) \
 149        : GET_MODE_BITSIZE (MODE) < PARM_BOUNDARY)                       \
 150       ? downward : upward))
 151 #endif
 152
 153 /* Supply a default definition for FUNCTION_ARG_BOUNDARY.  Normally, we let
 154    FUNCTION_ARG_PADDING, which also pads the length, handle any needed
 155    alignment.  */
 156
 157 #ifndef FUNCTION_ARG_BOUNDARY
 158 #define FUNCTION_ARG_BOUNDARY(MODE, TYPE)       PARM_BOUNDARY
 159 #endif
 160
 161 /* Provide a default value for STRICT_ARGUMENT_NAMING.  */
 162 #ifndef STRICT_ARGUMENT_NAMING
 163 #define STRICT_ARGUMENT_NAMING 0
 164 #endif
 165
 166 /* Provide a default value for PRETEND_OUTGOING_VARARGS_NAMED.  */
 167 #ifdef SETUP_INCOMING_VARARGS
 168 #ifndef PRETEND_OUTGOING_VARARGS_NAMED
 169 #define PRETEND_OUTGOING_VARARGS_NAMED 1
 170 #endif
 171 #else
 172 /* It is an error to define PRETEND_OUTGOING_VARARGS_NAMED without
 173    defining SETUP_INCOMING_VARARGS.  */
 174 #define PRETEND_OUTGOING_VARARGS_NAMED 0
 175 #endif
 176
 177 /* Nonzero if we do not know how to pass TYPE solely in registers.  */
 178 extern bool default_must_pass_in_stack PARAMS((enum machine_mode, tree));
 179 #ifndef MUST_PASS_IN_STACK
 180 #define MUST_PASS_IN_STACK(MODE,TYPE) default_must_pass_in_stack(MODE, TYPE)
 181 #endif
 182
 183 /* Nonzero if type TYPE should be returned in memory.
 184    Most machines can use the following default definition.  */
 185
 186 #ifndef RETURN_IN_MEMORY
 187 #define RETURN_IN_MEMORY(TYPE) (TYPE_MODE (TYPE) == BLKmode)
 188 #endif
 189
 190 /* Supply a default definition of STACK_SAVEAREA_MODE for emit_stack_save.
 191    Normally move_insn, so Pmode stack pointer.  */
 192
 193 #ifndef STACK_SAVEAREA_MODE
 194 #define STACK_SAVEAREA_MODE(LEVEL) Pmode
 195 #endif
 196
 197 /* Supply a default definition of STACK_SIZE_MODE for
 198    allocate_dynamic_stack_space.  Normally PLUS/MINUS, so word_mode.  */
 199
 200 #ifndef STACK_SIZE_MODE
 201 #define STACK_SIZE_MODE word_mode
 202 #endif
 203
 204 /* Provide default values for the macros controlling stack checking.  */
 205
 206 #ifndef STACK_CHECK_BUILTIN
 207 #define STACK_CHECK_BUILTIN 0
 208 #endif
 209
 210 /* The default interval is one page.  */
 211 #ifndef STACK_CHECK_PROBE_INTERVAL
 212 #define STACK_CHECK_PROBE_INTERVAL 4096
 213 #endif
 214
 215 /* The default is to do a store into the stack.  */
 216 #ifndef STACK_CHECK_PROBE_LOAD
 217 #define STACK_CHECK_PROBE_LOAD 0
 218 #endif
 219
 220 /* This value is arbitrary, but should be sufficient for most machines.  */
 221 #ifndef STACK_CHECK_PROTECT
 222 #define STACK_CHECK_PROTECT (75 * UNITS_PER_WORD)
 223 #endif
 224
 225 /* Make the maximum frame size be the largest we can and still only need
 226    one probe per function.  */
 227 #ifndef STACK_CHECK_MAX_FRAME_SIZE
 228 #define STACK_CHECK_MAX_FRAME_SIZE \
 229   (STACK_CHECK_PROBE_INTERVAL - UNITS_PER_WORD)
 230 #endif
 231
 232 /* This is arbitrary, but should be large enough everywhere.  */
 233 #ifndef STACK_CHECK_FIXED_FRAME_SIZE
 234 #define STACK_CHECK_FIXED_FRAME_SIZE (4 * UNITS_PER_WORD)
 235 #endif
 236
 237 /* Provide a reasonable default for the maximum size of an object to
 238    allocate in the fixed frame.  We may need to be able to make this
 239    controllable by the user at some point.  */
 240 #ifndef STACK_CHECK_MAX_VAR_SIZE
 241 #define STACK_CHECK_MAX_VAR_SIZE (STACK_CHECK_MAX_FRAME_SIZE / 100)
 242 #endif
 243 \f
 244 /* Functions from optabs.c, commonly used, and without need for the optabs
 245    tables:  */
 246
 247 /* Passed to expand_simple_binop and expand_binop to say which options
 248    to try to use if the requested operation can't be open-coded on the
 249    requisite mode.  Either OPTAB_LIB or OPTAB_LIB_WIDEN says try using
 250    a library call.  Either OPTAB_WIDEN or OPTAB_LIB_WIDEN says try
 251    using a wider mode.  OPTAB_MUST_WIDEN says try widening and don't
 252    try anything else.  */
 253
 254 enum optab_methods
 255 {
 256   OPTAB_DIRECT,
 257   OPTAB_LIB,
 258   OPTAB_WIDEN,
 259   OPTAB_LIB_WIDEN,
 260   OPTAB_MUST_WIDEN
 261 };
 262
 263 /* Generate code for a simple binary or unary operation.  "Simple" in
 264    this case means "can be unambiguously described by a (mode, code)
 265    pair and mapped to a single optab."  */
 266 extern rtx expand_simple_binop PARAMS ((enum machine_mode, enum rtx_code, rtx,
 267                                         rtx, rtx, int, enum optab_methods));
 268 extern rtx expand_simple_unop PARAMS ((enum machine_mode, enum rtx_code,
 269                                        rtx, rtx, int));
 270
 271 /* Report whether the machine description contains an insn which can
 272    perform the operation described by CODE and MODE.  */
 273 extern int have_insn_for PARAMS ((enum rtx_code, enum machine_mode));
 274
 275 /* Emit code to make a call to a constant function or a library call.  */
 276 extern void emit_libcall_block PARAMS ((rtx, rtx, rtx, rtx));
 277
 278 /* Create but don't emit one rtl instruction to perform certain operations.
 279    Modes must match; operands must meet the operation's predicates.
 280    Likewise for subtraction and for just copying.
 281    These do not call protect_from_queue; caller must do so.  */
 282 extern rtx gen_add2_insn PARAMS ((rtx, rtx));
 283 extern rtx gen_add3_insn PARAMS ((rtx, rtx, rtx));
 284 extern rtx gen_sub2_insn PARAMS ((rtx, rtx));
 285 extern rtx gen_sub3_insn PARAMS ((rtx, rtx, rtx));
 286 extern rtx gen_move_insn PARAMS ((rtx, rtx));
 287 extern int have_add2_insn PARAMS ((rtx, rtx));
 288 extern int have_sub2_insn PARAMS ((rtx, rtx));
 289
 290 /* Emit a pair of rtl insns to compare two rtx's and to jump
 291    to a label if the comparison is true.  */
 292 extern void emit_cmp_and_jump_insns PARAMS ((rtx, rtx, enum rtx_code, rtx,
 293                                              enum machine_mode, int, rtx));
 294
 295 /* Generate code to indirectly jump to a location given in the rtx LOC.  */
 296 extern void emit_indirect_jump PARAMS ((rtx));
 297
 298 #ifdef HAVE_conditional_move
 299 /* Emit a conditional move operation.  */
 300 rtx emit_conditional_move PARAMS ((rtx, enum rtx_code, rtx, rtx,
 301                                    enum machine_mode, rtx, rtx,
 302                                    enum machine_mode, int));
 303
 304 /* Return nonzero if the conditional move is supported.  */
 305 int can_conditionally_move_p PARAMS ((enum machine_mode mode));
 306
 307 #endif
 308 rtx emit_conditional_add PARAMS ((rtx, enum rtx_code, rtx, rtx,
 309                                   enum machine_mode, rtx, rtx,
 310                                   enum machine_mode, int));
 311
 312 \f
 313 /* Functions from expmed.c:  */
 314
 315 /* Arguments MODE, RTX: return an rtx for the negation of that value.
 316    May emit insns.  */
 317 extern rtx negate_rtx PARAMS ((enum machine_mode, rtx));
 318
 319 /* Expand a logical AND operation.  */
 320 extern rtx expand_and PARAMS ((enum machine_mode, rtx, rtx, rtx));
 321
 322 /* Emit a store-flag operation.  */
 323 extern rtx emit_store_flag PARAMS ((rtx, enum rtx_code, rtx, rtx,
 324                                     enum machine_mode, int, int));
 325
 326 /* Like emit_store_flag, but always succeeds.  */
 327 extern rtx emit_store_flag_force PARAMS ((rtx, enum rtx_code, rtx, rtx,
 328                                           enum machine_mode, int, int));
 329
 330 /* Functions from loop.c:  */
 331
 332 /* Given an insn and condition, return a canonical description of
 333    the test being made.  */
 334 extern rtx canonicalize_condition PARAMS ((rtx, rtx, int, rtx *, rtx));
 335
 336 /* Given a JUMP_INSN, return a canonical description of the test
 337    being made.  */
 338 extern rtx get_condition PARAMS ((rtx, rtx *));
 339
 340 /* Generate a conditional trap instruction.  */
 341 extern rtx gen_cond_trap PARAMS ((enum rtx_code, rtx, rtx, rtx));
 342 \f
 343 /* Functions from builtins.c:  */
 344 extern rtx expand_builtin PARAMS ((tree, rtx, rtx, enum machine_mode, int));
 345 extern void std_expand_builtin_va_start PARAMS ((tree, rtx));
 346 extern rtx std_expand_builtin_va_arg PARAMS ((tree, tree));
 347 extern rtx expand_builtin_va_arg PARAMS ((tree, tree));
 348 extern void default_init_builtins PARAMS ((void));
 349 extern rtx default_expand_builtin PARAMS ((tree, rtx, rtx,
 350                                            enum machine_mode, int));
 351 extern void expand_builtin_setjmp_setup PARAMS ((rtx, rtx));
 352 extern void expand_builtin_setjmp_receiver PARAMS ((rtx));
 353 extern void expand_builtin_longjmp PARAMS ((rtx, rtx));
 354 extern rtx expand_builtin_saveregs PARAMS ((void));
 355 extern void expand_builtin_trap PARAMS ((void));
 356 extern HOST_WIDE_INT get_varargs_alias_set PARAMS ((void));
 357 extern HOST_WIDE_INT get_frame_alias_set PARAMS ((void));
 358 extern void record_base_value           PARAMS ((unsigned int, rtx, int));
 359 extern void record_alias_subset         PARAMS ((HOST_WIDE_INT,
 360                                                  HOST_WIDE_INT));
 361 extern HOST_WIDE_INT new_alias_set              PARAMS ((void));
 362 extern int can_address_p                PARAMS ((tree));
 363 \f
 364 /* Functions from expr.c:  */
 365
 366 /* This is run once per compilation to set up which modes can be used
 367    directly in memory and to initialize the block move optab.  */
 368 extern void init_expr_once PARAMS ((void));
 369
 370 /* This is run at the start of compiling a function.  */
 371 extern void init_expr PARAMS ((void));
 372
 373 /* This is run at the end of compiling a function.  */
 374 extern void finish_expr_for_function PARAMS ((void));
 375
 376 /* Use protect_from_queue to convert a QUEUED expression
 377    into something that you can put immediately into an instruction.  */
 378 extern rtx protect_from_queue PARAMS ((rtx, int));
 379
 380 /* Perform all the pending incrementations.  */
 381 extern void emit_queue PARAMS ((void));
 382
 383 /* Tell if something has a queued subexpression.  */
 384 extern int queued_subexp_p PARAMS ((rtx));
 385
 386 /* Emit some rtl insns to move data between rtx's, converting machine modes.
 387    Both modes must be floating or both fixed.  */
 388 extern void convert_move PARAMS ((rtx, rtx, int));
 389
 390 /* Convert an rtx to specified machine mode and return the result.  */
 391 extern rtx convert_to_mode PARAMS ((enum machine_mode, rtx, int));
 392
 393 /* Convert an rtx to MODE from OLDMODE and return the result.  */
 394 extern rtx convert_modes PARAMS ((enum machine_mode, enum machine_mode,
 395                                   rtx, int));
 396
 397 /* Emit code to move a block Y to a block X.  */
 398
 399 enum block_op_methods
 400 {
 401   BLOCK_OP_NORMAL,
 402   BLOCK_OP_NO_LIBCALL,
 403   BLOCK_OP_CALL_PARM
 404 };
 405
 406 extern void init_block_move_fn PARAMS ((const char *));
 407 extern void init_block_clear_fn PARAMS ((const char *));
 408
 409 extern rtx emit_block_move PARAMS ((rtx, rtx, rtx, enum block_op_methods));
 410
 411 /* Copy all or part of a value X into registers starting at REGNO.
 412    The number of registers to be filled is NREGS.  */
 413 extern void move_block_to_reg PARAMS ((int, rtx, int, enum machine_mode));
 414
 415 /* Copy all or part of a BLKmode value X out of registers starting at REGNO.
 416    The number of registers to be filled is NREGS.  */
 417 extern void move_block_from_reg PARAMS ((int, rtx, int));
 418
 419 /* Generate a non-consecutive group of registers represented by a PARALLEL.  */
 420 extern rtx gen_group_rtx PARAMS ((rtx));
 421
 422 /* Load a BLKmode value into non-consecutive registers represented by a
 423    PARALLEL.  */
 424 extern void emit_group_load PARAMS ((rtx, rtx, int));
 425
 426 /* Move a non-consecutive group of registers represented by a PARALLEL into
 427    a non-consecutive group of registers represented by a PARALLEL.  */
 428 extern void emit_group_move PARAMS ((rtx, rtx));
 429
 430 /* Store a BLKmode value from non-consecutive registers represented by a
 431    PARALLEL.  */
 432 extern void emit_group_store PARAMS ((rtx, rtx, int));
 433
 434 #ifdef TREE_CODE
 435 /* Copy BLKmode object from a set of registers.  */
 436 extern rtx copy_blkmode_from_reg PARAMS ((rtx, rtx, tree));
 437 #endif
 438
 439 /* Mark REG as holding a parameter for the next CALL_INSN.  */
 440 extern void use_reg PARAMS ((rtx *, rtx));
 441
 442 /* Mark NREGS consecutive regs, starting at REGNO, as holding parameters
 443    for the next CALL_INSN.  */
 444 extern void use_regs PARAMS ((rtx *, int, int));
 445
 446 /* Mark a PARALLEL as holding a parameter for the next CALL_INSN.  */
 447 extern void use_group_regs PARAMS ((rtx *, rtx));
 448
 449 /* Write zeros through the storage of OBJECT.
 450    If OBJECT has BLKmode, SIZE is its length in bytes.  */
 451 extern rtx clear_storage PARAMS ((rtx, rtx));
 452
 453 /* Determine whether the LEN bytes can be moved by using several move
 454    instructions.  Return nonzero if a call to move_by_pieces should
 455    succeed.  */
 456 extern int can_move_by_pieces PARAMS ((unsigned HOST_WIDE_INT, unsigned int));
 457
 458 /* Return nonzero if it is desirable to store LEN bytes generated by
 459    CONSTFUN with several move instructions by store_by_pieces
 460    function.  CONSTFUNDATA is a pointer which will be passed as argument
 461    in every CONSTFUN call.
 462    ALIGN is maximum alignment we can assume.  */
 463 extern int can_store_by_pieces PARAMS ((unsigned HOST_WIDE_INT,
 464                                         rtx (*) (PTR, HOST_WIDE_INT,
 465                                                  enum machine_mode),
 466                                         PTR, unsigned int));
 467
 468 /* Generate several move instructions to store LEN bytes generated by
 469    CONSTFUN to block TO.  (A MEM rtx with BLKmode).  CONSTFUNDATA is a
 470    pointer which will be passed as argument in every CONSTFUN call.
 471    ALIGN is maximum alignment we can assume.
 472    Returns TO + LEN.  */
 473 extern rtx store_by_pieces PARAMS ((rtx, unsigned HOST_WIDE_INT,
 474                                     rtx (*) (PTR, HOST_WIDE_INT,
 475                                              enum machine_mode),
 476                                     PTR, unsigned int, int));
 477
 478 /* Emit insns to set X from Y.  */
 479 extern rtx emit_move_insn PARAMS ((rtx, rtx));
 480
 481 /* Emit insns to set X from Y, with no frills.  */
 482 extern rtx emit_move_insn_1 PARAMS ((rtx, rtx));
 483
 484 /* Push a block of length SIZE (perhaps variable)
 485    and return an rtx to address the beginning of the block.  */
 486 extern rtx push_block PARAMS ((rtx, int, int));
 487
 488 #ifdef TREE_CODE
 489 /* Generate code to push something onto the stack, given its mode and type.  */
 490 extern void emit_push_insn PARAMS ((rtx, enum machine_mode, tree, rtx,
 491                                     unsigned int, int, rtx, int, rtx, rtx,
 492                                     int, rtx));
 493
 494 /* Expand an assignment that stores the value of FROM into TO.  */
 495 extern rtx expand_assignment PARAMS ((tree, tree, int, int));
 496
 497 /* Generate code for computing expression EXP,
 498    and storing the value into TARGET.
 499    If SUGGEST_REG is nonzero, copy the value through a register
 500    and return that register, if that is possible.  */
 501 extern rtx store_expr PARAMS ((tree, rtx, int));
 502 #endif
 503
 504 /* Given an rtx that may include add and multiply operations,
 505    generate them as insns and return a pseudo-reg containing the value.
 506    Useful after calling expand_expr with 1 as sum_ok.  */
 507 extern rtx force_operand PARAMS ((rtx, rtx));
 508
 509 /* Return an object on the placeholder list that matches EXP, a
 510    PLACEHOLDER_EXPR.  An object "matches" if it is of the type of the
 511    PLACEHOLDER_EXPR or a pointer type to it.  For further information, see
 512    tree.def.  If no such object is found, abort.  If PLIST is nonzero, it is
 513    a location which initially points to a starting location in the
 514    placeholder list (zero means start of the list) and where a pointer into
 515    the placeholder list at which the object is found is placed.  */
 516 extern tree find_placeholder PARAMS ((tree, tree *));
 517
 518 /* Generate code for computing expression EXP.
 519    An rtx for the computed value is returned.  The value is never null.
 520    In the case of a void EXP, const0_rtx is returned.  */
 521 extern rtx expand_expr PARAMS ((tree, rtx, enum machine_mode,
 522                                 enum expand_modifier));
 523
 524 /* At the start of a function, record that we have no previously-pushed
 525    arguments waiting to be popped.  */
 526 extern void init_pending_stack_adjust PARAMS ((void));
 527
 528 /* When exiting from function, if safe, clear out any pending stack adjust
 529    so the adjustment won't get done.  */
 530 extern void clear_pending_stack_adjust PARAMS ((void));
 531
 532 /* Pop any previously-pushed arguments that have not been popped yet.  */
 533 extern void do_pending_stack_adjust PARAMS ((void));
 534
 535 #ifdef TREE_CODE
 536 /* Return the tree node and offset if a given argument corresponds to
 537    a string constant.  */
 538 extern tree string_constant PARAMS ((tree, tree *));
 539
 540 /* Generate code to evaluate EXP and jump to LABEL if the value is zero.  */
 541 extern void jumpifnot PARAMS ((tree, rtx));
 542
 543 /* Generate code to evaluate EXP and jump to LABEL if the value is nonzero.  */
 544 extern void jumpif PARAMS ((tree, rtx));
 545
 546 /* Generate code to evaluate EXP and jump to IF_FALSE_LABEL if
 547    the result is zero, or IF_TRUE_LABEL if the result is one.  */
 548 extern void do_jump PARAMS ((tree, rtx, rtx));
 549 #endif
 550
 551 /* Generate rtl to compare two rtx's, will call emit_cmp_insn.  */
 552 extern rtx compare_from_rtx PARAMS ((rtx, rtx, enum rtx_code, int,
 553                                      enum machine_mode, rtx));
 554 extern void do_compare_rtx_and_jump PARAMS ((rtx, rtx, enum rtx_code, int,
 555                                              enum machine_mode, rtx,
 556                                              rtx, rtx));
 557
 558 /* Two different ways of generating switch statements.  */
 559 extern int try_casesi    PARAMS ((tree, tree, tree, tree, rtx, rtx));
 560 extern int try_tablejump PARAMS ((tree, tree, tree, tree, rtx, rtx));
 561
 562 /* Smallest number of adjacent cases before we use a jump table.
 563    XXX Should be a target hook.  */
 564 extern unsigned int case_values_threshold PARAMS ((void));
 565
 566 \f
 567 #ifdef TREE_CODE
 568 /* rtl.h and tree.h were included.  */
 569 /* Return an rtx for the size in bytes of the value of an expr.  */
 570 extern rtx expr_size PARAMS ((tree));
 571
 572 /* Return a wide integer for the size in bytes of the value of EXP, or -1
 573    if the size can vary or is larger than an integer.  */
 574 extern HOST_WIDE_INT int_expr_size PARAMS ((tree));
 575
 576 extern rtx lookup_static_chain PARAMS ((tree));
 577
 578 /* Convert a stack slot address ADDR valid in function FNDECL
 579    into an address valid in this function (using a static chain).  */
 580 extern rtx fix_lexical_addr PARAMS ((rtx, tree));
 581
 582 /* Return the address of the trampoline for entering nested fn FUNCTION.  */
 583 extern rtx trampoline_address PARAMS ((tree));
 584
 585 /* Return an rtx that refers to the value returned by a function
 586    in its original home.  This becomes invalid if any more code is emitted.  */
 587 extern rtx hard_function_value PARAMS ((tree, tree, int));
 588
 589 extern rtx prepare_call_address PARAMS ((rtx, tree, rtx *, int, int));
 590
 591 extern rtx expand_call PARAMS ((tree, rtx, int));
 592
 593 extern rtx expand_shift PARAMS ((enum tree_code, enum machine_mode, rtx, tree,
 594                                  rtx, int));
 595 extern rtx expand_divmod PARAMS ((int, enum tree_code, enum machine_mode, rtx,
 596                                   rtx, rtx, int));
 597 extern void locate_and_pad_parm PARAMS ((enum machine_mode, tree, int, int,
 598                                          tree, struct args_size *,
 599                                          struct locate_and_pad_arg_data *));
 600 extern rtx expand_inline_function PARAMS ((tree, tree, rtx, int, tree, rtx));
 601
 602 /* Return the CODE_LABEL rtx for a LABEL_DECL, creating it if necessary.  */
 603 extern rtx label_rtx PARAMS ((tree));
 604
 605 /* As label_rtx, but additionally the label is placed on the forced label
 606    list of its containing function (i.e. it is treated as reachable even
 607    if how is not obvious).  */
 608 extern rtx force_label_rtx PARAMS ((tree));
 609 #endif
 610
 611 /* Indicate how an input argument register was promoted.  */
 612 extern rtx promoted_input_arg PARAMS ((unsigned int, enum machine_mode *,
 613                                        int *));
 614
 615 /* Return an rtx like arg but sans any constant terms.
 616    Returns the original rtx if it has no constant terms.
 617    The constant terms are added and stored via a second arg.  */
 618 extern rtx eliminate_constant_term PARAMS ((rtx, rtx *));
 619
 620 /* Convert arg to a valid memory address for specified machine mode,
 621    by emitting insns to perform arithmetic if nec.  */
 622 extern rtx memory_address PARAMS ((enum machine_mode, rtx));
 623
 624 /* Like `memory_address' but pretent `flag_force_addr' is 0.  */
 625 extern rtx memory_address_noforce PARAMS ((enum machine_mode, rtx));
 626
 627 /* Set the alias set of MEM to SET.  */
 628 extern void set_mem_alias_set PARAMS ((rtx, HOST_WIDE_INT));
 629
 630 /* Set the alignment of MEM to ALIGN bits.  */
 631 extern void set_mem_align PARAMS ((rtx, unsigned int));
 632
 633 /* Set the expr for MEM to EXPR.  */
 634 extern void set_mem_expr PARAMS ((rtx, tree));
 635
 636 /* Set the offset for MEM to OFFSET.  */
 637 extern void set_mem_offset PARAMS ((rtx, rtx));
 638
 639 /* Set the size for MEM to SIZE.  */
 640 extern void set_mem_size PARAMS ((rtx, rtx));
 641
 642 /* Return a memory reference like MEMREF, but with its mode changed
 643    to MODE and its address changed to ADDR.
 644    (VOIDmode means don't change the mode.
 645    NULL for ADDR means don't change the address.)  */
 646 extern rtx change_address PARAMS ((rtx, enum machine_mode, rtx));
 647
 648 /* Return a memory reference like MEMREF, but with its mode changed
 649    to MODE and its address offset by OFFSET bytes.  */
 650 #define adjust_address(MEMREF, MODE, OFFSET) \
 651   adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1)
 652
 653 /* Likewise, but the reference is not required to be valid.  */
 654 #define adjust_address_nv(MEMREF, MODE, OFFSET) \
 655   adjust_address_1 (MEMREF, MODE, OFFSET, 0, 1)
 656
 657 /* Return a memory reference like MEMREF, but with its mode changed
 658    to MODE and its address changed to ADDR, which is assumed to be
 659    increased by OFFSET bytes from MEMREF.  */
 660 #define adjust_automodify_address(MEMREF, MODE, ADDR, OFFSET) \
 661   adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 1)
 662
 663 /* Likewise, but the reference is not required to be valid.  */
 664 #define adjust_automodify_address_nv(MEMREF, MODE, ADDR, OFFSET) \
 665   adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 0)
 666
 667 extern rtx adjust_address_1 PARAMS ((rtx, enum machine_mode, HOST_WIDE_INT,
 668                                      int, int));
 669 extern rtx adjust_automodify_address_1 PARAMS ((rtx, enum machine_mode,
 670                                                 rtx, HOST_WIDE_INT, int));
 671
 672 /* Return a memory reference like MEMREF, but whose address is changed by
 673    adding OFFSET, an RTX, to it.  POW2 is the highest power of two factor
 674    known to be in OFFSET (possibly 1).  */
 675 extern rtx offset_address PARAMS ((rtx, rtx, unsigned HOST_WIDE_INT));
 676
 677 /* Return a memory reference like MEMREF, but with its address changed to
 678    ADDR.  The caller is asserting that the actual piece of memory pointed
 679    to is the same, just the form of the address is being changed, such as
 680    by putting something into a register.  */
 681 extern rtx replace_equiv_address PARAMS ((rtx, rtx));
 682
 683 /* Likewise, but the reference is not required to be valid.  */
 684 extern rtx replace_equiv_address_nv PARAMS ((rtx, rtx));
 685
 686 /* Return a memory reference like MEMREF, but with its mode widened to
 687    MODE and adjusted by OFFSET.  */
 688 extern rtx widen_memory_access PARAMS ((rtx, enum machine_mode, HOST_WIDE_INT));
 689
 690 /* Return a memory reference like MEMREF, but which is known to have a
 691    valid address.  */
 692 extern rtx validize_mem PARAMS ((rtx));
 693
 694 #ifdef TREE_CODE
 695 /* Given REF, either a MEM or a REG, and T, either the type of X or
 696    the expression corresponding to REF, set RTX_UNCHANGING_P if
 697    appropriate.  */
 698 extern void maybe_set_unchanging PARAMS ((rtx, tree));
 699
 700 /* Given REF, a MEM, and T, either the type of X or the expression
 701    corresponding to REF, set the memory attributes.  OBJECTP is nonzero
 702    if we are making a new object of this type.  */
 703 extern void set_mem_attributes PARAMS ((rtx, tree, int));
 704
 705 /* Similar, except that BITPOS has not yet been applied to REF, so if
 706    we alter MEM_OFFSET according to T then we should subtract BITPOS
 707    expecting that it'll be added back in later.  */
 708 extern void set_mem_attributes_minus_bitpos PARAMS ((rtx, tree, int,
 709                                                      HOST_WIDE_INT));
 710 #endif
 711
 712 /* Assemble the static constant template for function entry trampolines.  */
 713 extern rtx assemble_trampoline_template PARAMS ((void));
 714
 715 /* Given rtx, return new rtx whose address won't be affected by
 716    any side effects.  It has been copied to a new temporary reg.  */
 717 extern rtx stabilize PARAMS ((rtx));
 718
 719 /* Given an rtx, copy all regs it refers to into new temps
 720    and return a modified copy that refers to the new temps.  */
 721 extern rtx copy_all_regs PARAMS ((rtx));
 722
 723 /* Copy given rtx to a new temp reg and return that.  */
 724 extern rtx copy_to_reg PARAMS ((rtx));
 725
 726 /* Like copy_to_reg but always make the reg Pmode.  */
 727 extern rtx copy_addr_to_reg PARAMS ((rtx));
 728
 729 /* Like copy_to_reg but always make the reg the specified mode MODE.  */
 730 extern rtx copy_to_mode_reg PARAMS ((enum machine_mode, rtx));
 731
 732 /* Copy given rtx to given temp reg and return that.  */
 733 extern rtx copy_to_suggested_reg PARAMS ((rtx, rtx, enum machine_mode));
 734
 735 /* Copy a value to a register if it isn't already a register.
 736    Args are mode (in case value is a constant) and the value.  */
 737 extern rtx force_reg PARAMS ((enum machine_mode, rtx));
 738
 739 /* Return given rtx, copied into a new temp reg if it was in memory.  */
 740 extern rtx force_not_mem PARAMS ((rtx));
 741
 742 #ifdef TREE_CODE
 743 /* Return mode and signedness to use when object is promoted.  */
 744 extern enum machine_mode promote_mode PARAMS ((tree, enum machine_mode,
 745                                                int *, int));
 746 #endif
 747
 748 /* Remove some bytes from the stack.  An rtx says how many.  */
 749 extern void adjust_stack PARAMS ((rtx));
 750
 751 /* Add some bytes to the stack.  An rtx says how many.  */
 752 extern void anti_adjust_stack PARAMS ((rtx));
 753
 754 /* This enum is used for the following two functions.  */
 755 enum save_level {SAVE_BLOCK, SAVE_FUNCTION, SAVE_NONLOCAL};
 756
 757 /* Save the stack pointer at the specified level.  */
 758 extern void emit_stack_save PARAMS ((enum save_level, rtx *, rtx));
 759
 760 /* Restore the stack pointer from a save area of the specified level.  */
 761 extern void emit_stack_restore PARAMS ((enum save_level, rtx, rtx));
 762
 763 /* Allocate some space on the stack dynamically and return its address.  An rtx
 764    says how many bytes.  */
 765 extern rtx allocate_dynamic_stack_space PARAMS ((rtx, rtx, int));
 766
 767 /* Probe a range of stack addresses from FIRST to FIRST+SIZE, inclusive.
 768    FIRST is a constant and size is a Pmode RTX.  These are offsets from the
 769    current stack pointer.  STACK_GROWS_DOWNWARD says whether to add or
 770    subtract from the stack.  If SIZE is constant, this is done
 771    with a fixed number of probes.  Otherwise, we must make a loop.  */
 772 extern void probe_stack_range PARAMS ((HOST_WIDE_INT, rtx));
 773
 774 /* Return an rtx that refers to the value returned by a library call
 775    in its original home.  This becomes invalid if any more code is emitted.  */
 776 extern rtx hard_libcall_value PARAMS ((enum machine_mode));
 777
 778 /* Given an rtx, return an rtx for a value rounded up to a multiple
 779    of STACK_BOUNDARY / BITS_PER_UNIT.  */
 780 extern rtx round_push PARAMS ((rtx));
 781
 782 /* Return the mode desired by operand N of a particular bitfield
 783    insert/extract insn, or MAX_MACHINE_MODE if no such insn is
 784    available.  */
 785
 786 enum extraction_pattern { EP_insv, EP_extv, EP_extzv };
 787 extern enum machine_mode
 788 mode_for_extraction PARAMS ((enum extraction_pattern, int));
 789
 790 extern rtx store_bit_field PARAMS ((rtx, unsigned HOST_WIDE_INT,
 791                                     unsigned HOST_WIDE_INT,
 792                                     enum machine_mode, rtx, HOST_WIDE_INT));
 793 extern rtx extract_bit_field PARAMS ((rtx, unsigned HOST_WIDE_INT,
 794                                       unsigned HOST_WIDE_INT, int, rtx,
 795                                       enum machine_mode, enum machine_mode,
 796                                       HOST_WIDE_INT));
 797 extern rtx expand_mult PARAMS ((enum machine_mode, rtx, rtx, rtx, int));
 798 extern bool const_mult_add_overflow_p PARAMS ((rtx, rtx, rtx, enum machine_mode, int));
 799 extern rtx expand_mult_add PARAMS ((rtx, rtx, rtx, rtx,enum machine_mode, int));
 800 extern rtx expand_mult_highpart_adjust PARAMS ((enum machine_mode, rtx, rtx, rtx, rtx, int));
 801
 802 extern rtx assemble_static_space PARAMS ((unsigned HOST_WIDE_INT));
 803 extern int safe_from_p PARAMS ((rtx, tree, int));
 804
 805 /* Call this once to initialize the contents of the optabs
 806    appropriately for the current target machine.  */
 807 extern void init_optabs                         PARAMS ((void));
 808 extern void init_all_optabs                     PARAMS ((void));
 809
 810 /* Call this to initialize an optab function entry.  */
 811 extern rtx init_one_libfunc                     PARAMS ((const char *));
 812
 813 extern void do_jump_by_parts_equality_rtx       PARAMS ((rtx, rtx, rtx));
 814 extern void do_jump_by_parts_greater_rtx        PARAMS ((enum machine_mode,
 815                                                          int, rtx, rtx, rtx,
 816                                                          rtx));
 817
 818 #ifdef TREE_CODE   /* Don't lose if tree.h not included.  */
 819 extern void mark_seen_cases                     PARAMS ((tree, unsigned char *,
 820                                                          HOST_WIDE_INT, int));
 821 #endif
 822
 823 extern int vector_mode_valid_p          PARAMS ((enum machine_mode));
 824
 825 extern tree placeholder_list;