expr.h 31.4 KB
Newer Older
Richard Kenner committed
1
/* Definitions for code generation pass of GNU compiler.
Jeff Law committed
2 3
   Copyright (C) 1987, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
   1999, 2000 Free Software Foundation, Inc.
Richard Kenner committed
4

5
This file is part of GCC.
Richard Kenner committed
6

7 8 9 10
GCC is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.
Richard Kenner committed
11

12 13 14 15
GCC is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.
Richard Kenner committed
16 17

You should have received a copy of the GNU General Public License
18 19 20
along with GCC; see the file COPYING.  If not, write to the Free
Software Foundation, 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA.  */
Richard Kenner committed
21 22 23 24 25 26 27 28 29 30 31 32 33

/* The default branch cost is 1.  */
#ifndef BRANCH_COST
#define BRANCH_COST 1
#endif

/* Macros to access the slots of a QUEUED rtx.
   Here rather than in rtl.h because only the expansion pass
   should ever encounter a QUEUED.  */

/* The variable for which an increment is queued.  */
#define QUEUED_VAR(P) XEXP (P, 0)
/* If the increment has been emitted, this is the insn
34 35
   that does the increment.  It is zero before the increment is emitted.
   If more than one insn is emitted, this is the first insn.  */
Richard Kenner committed
36 37 38 39 40 41 42 43 44 45 46 47 48 49
#define QUEUED_INSN(P) XEXP (P, 1)
/* If a pre-increment copy has been generated, this is the copy
   (it is a temporary reg).  Zero if no copy made yet.  */
#define QUEUED_COPY(P) XEXP (P, 2)
/* This is the body to use for the insn to do the increment.
   It is used to emit the increment.  */
#define QUEUED_BODY(P) XEXP (P, 3)
/* Next QUEUED in the queue.  */
#define QUEUED_NEXT(P) XEXP (P, 4)

/* This is the 4th arg to `expand_expr'.
   EXPAND_SUM means it is ok to return a PLUS rtx or MULT rtx.
   EXPAND_INITIALIZER is similar but also record any labels on forced_labels.
   EXPAND_CONST_ADDRESS means it is ok to return a MEM whose address
50
    is a constant that is not a legitimate address.
51 52 53
   EXPAND_WRITE means we are only going to write to the resulting rtx.  */
enum expand_modifier {EXPAND_NORMAL, EXPAND_SUM, EXPAND_CONST_ADDRESS,
			EXPAND_INITIALIZER, EXPAND_WRITE};
Richard Kenner committed
54

55 56 57 58 59 60 61
/* Prevent the compiler from deferring stack pops.  See
   inhibit_defer_pop for more information.  */
#define NO_DEFER_POP (inhibit_defer_pop += 1)

/* Allow the compiler to defer stack pops.  See inhibit_defer_pop for
   more information.  */
#define OK_DEFER_POP (inhibit_defer_pop -= 1)
Richard Kenner committed
62 63 64

#ifdef TREE_CODE /* Don't lose if tree.h not included.  */
/* Structure to record the size of a sequence of arguments
65 66 67
   as the sum of a tree-expression and a constant.  This structure is
   also used to store offsets from the stack, which might be negative,
   so the variable part must be ssizetype, not sizetype.  */
Richard Kenner committed
68 69 70

struct args_size
{
71
  HOST_WIDE_INT constant;
Richard Kenner committed
72 73 74 75 76 77
  tree var;
};
#endif

/* Add the value of the tree INC to the `struct args_size' TO.  */

78 79 80 81 82 83
#define ADD_PARM_SIZE(TO, INC)				\
do {							\
  tree inc = (INC);					\
  if (host_integerp (inc, 0))				\
    (TO).constant += tree_low_cst (inc, 0);		\
  else if ((TO).var == 0)				\
84
    (TO).var = convert (ssizetype, inc);		\
85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101
  else							\
    (TO).var = size_binop (PLUS_EXPR, (TO).var,		\
			   convert (ssizetype, inc));	\
} while (0)

#define SUB_PARM_SIZE(TO, DEC)				\
do {							\
  tree dec = (DEC);					\
  if (host_integerp (dec, 0))				\
    (TO).constant -= tree_low_cst (dec, 0);		\
  else if ((TO).var == 0)				\
    (TO).var = size_binop (MINUS_EXPR, ssize_int (0),	\
			   convert (ssizetype, dec));	\
  else							\
    (TO).var = size_binop (MINUS_EXPR, (TO).var,	\
			   convert (ssizetype, dec));	\
} while (0)
Richard Kenner committed
102

103 104 105 106
/* Convert the implicit sum in a `struct args_size' into a tree
   of type ssizetype.  */
#define ARGS_SIZE_TREE(SIZE)					\
((SIZE).var == 0 ? ssize_int ((SIZE).constant)			\
107 108
 : size_binop (PLUS_EXPR, convert (ssizetype, (SIZE).var),	\
	       ssize_int ((SIZE).constant)))
109

Richard Kenner committed
110
/* Convert the implicit sum in a `struct args_size' into an rtx.  */
111 112
#define ARGS_SIZE_RTX(SIZE)					\
((SIZE).var == 0 ? GEN_INT ((SIZE).constant)			\
113
 : expand_expr (ARGS_SIZE_TREE (SIZE), NULL_RTX, VOIDmode, 0))
Richard Kenner committed
114 115

/* Supply a default definition for FUNCTION_ARG_PADDING:
Richard Stallman committed
116
   usually pad upward, but pad short args downward on
Richard Kenner committed
117 118 119 120 121 122
   big-endian machines.  */

enum direction {none, upward, downward};  /* Value has this type.  */

#ifndef FUNCTION_ARG_PADDING
#define FUNCTION_ARG_PADDING(MODE, TYPE)				\
123 124 125 126 127 128 129
  (! BYTES_BIG_ENDIAN							\
   ? upward								\
   : (((MODE) == BLKmode						\
       ? ((TYPE) && TREE_CODE (TYPE_SIZE (TYPE)) == INTEGER_CST		\
	  && int_size_in_bytes (TYPE) < (PARM_BOUNDARY / BITS_PER_UNIT)) \
       : GET_MODE_BITSIZE (MODE) < PARM_BOUNDARY)			\
      ? downward : upward))
Richard Kenner committed
130 131 132 133 134
#endif

/* Supply a default definition for FUNCTION_ARG_BOUNDARY.  Normally, we let
   FUNCTION_ARG_PADDING, which also pads the length, handle any needed
   alignment.  */
Kazu Hirata committed
135

Richard Kenner committed
136 137 138 139
#ifndef FUNCTION_ARG_BOUNDARY
#define FUNCTION_ARG_BOUNDARY(MODE, TYPE)	PARM_BOUNDARY
#endif

140 141 142 143 144
/* Provide a default value for STRICT_ARGUMENT_NAMING.  */
#ifndef STRICT_ARGUMENT_NAMING
#define STRICT_ARGUMENT_NAMING 0
#endif

145 146 147 148 149 150 151 152 153 154 155
/* Provide a default value for PRETEND_OUTGOING_VARARGS_NAMED.  */
#ifdef SETUP_INCOMING_VARARGS
#ifndef PRETEND_OUTGOING_VARARGS_NAMED
#define PRETEND_OUTGOING_VARARGS_NAMED 1
#endif
#else
/* It is an error to define PRETEND_OUTGOING_VARARGS_NAMED without
   defining SETUP_INCOMING_VARARGS.  */
#define PRETEND_OUTGOING_VARARGS_NAMED 0
#endif

Richard Kenner committed
156 157 158 159 160 161 162
/* Nonzero if we do not know how to pass TYPE solely in registers.
   We cannot do so in the following cases:

   - if the type has variable size
   - if the type is marked as addressable (it is required to be constructed
     into the stack)
   - if the padding and mode of the type is such that a copy into a register
163 164
     would put it into the wrong part of the register.

165
   Which padding can't be supported depends on the byte endianness.
Richard Kenner committed
166

167
   A value in a register is implicitly padded at the most significant end.
Richard Kenner committed
168 169 170 171
   On a big-endian machine, that is the lower end in memory.
   So a value padded in memory at the upper end can't go in a register.
   For a little-endian machine, the reverse is true.  */

172
#ifndef MUST_PASS_IN_STACK
Richard Kenner committed
173 174 175 176 177
#define MUST_PASS_IN_STACK(MODE,TYPE)			\
  ((TYPE) != 0						\
   && (TREE_CODE (TYPE_SIZE (TYPE)) != INTEGER_CST	\
       || TREE_ADDRESSABLE (TYPE)			\
       || ((MODE) == BLKmode 				\
178 179 180
	   && ! ((TYPE) != 0 && TREE_CODE (TYPE_SIZE (TYPE)) == INTEGER_CST \
		 && 0 == (int_size_in_bytes (TYPE)	\
			  % (PARM_BOUNDARY / BITS_PER_UNIT))) \
Richard Kenner committed
181
	   && (FUNCTION_ARG_PADDING (MODE, TYPE)	\
182
	       == (BYTES_BIG_ENDIAN ? upward : downward)))))
183
#endif
Richard Kenner committed
184

185
/* Nonzero if type TYPE should be returned in memory.
Richard Kenner committed
186 187 188
   Most machines can use the following default definition.  */

#ifndef RETURN_IN_MEMORY
189
#define RETURN_IN_MEMORY(TYPE) (TYPE_MODE (TYPE) == BLKmode)
Richard Kenner committed
190
#endif
191

192 193 194 195 196 197 198
/* Supply a default definition of STACK_SAVEAREA_MODE for emit_stack_save.
   Normally move_insn, so Pmode stack pointer.  */

#ifndef STACK_SAVEAREA_MODE
#define STACK_SAVEAREA_MODE(LEVEL) Pmode
#endif

199 200 201 202 203 204 205
/* Supply a default definition of STACK_SIZE_MODE for
   allocate_dynamic_stack_space.  Normally PLUS/MINUS, so word_mode.  */

#ifndef STACK_SIZE_MODE
#define STACK_SIZE_MODE word_mode
#endif

206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244
/* Provide default values for the macros controlling stack checking.  */

#ifndef STACK_CHECK_BUILTIN
#define STACK_CHECK_BUILTIN 0
#endif

/* The default interval is one page.  */
#ifndef STACK_CHECK_PROBE_INTERVAL
#define STACK_CHECK_PROBE_INTERVAL 4096
#endif

/* The default is to do a store into the stack.  */
#ifndef STACK_CHECK_PROBE_LOAD
#define STACK_CHECK_PROBE_LOAD 0
#endif

/* This value is arbitrary, but should be sufficient for most machines.  */
#ifndef STACK_CHECK_PROTECT
#define STACK_CHECK_PROTECT (75 * UNITS_PER_WORD)
#endif

/* Make the maximum frame size be the largest we can and still only need
   one probe per function.  */
#ifndef STACK_CHECK_MAX_FRAME_SIZE
#define STACK_CHECK_MAX_FRAME_SIZE \
  (STACK_CHECK_PROBE_INTERVAL - UNITS_PER_WORD)
#endif

/* This is arbitrary, but should be large enough everywhere.  */
#ifndef STACK_CHECK_FIXED_FRAME_SIZE
#define STACK_CHECK_FIXED_FRAME_SIZE (4 * UNITS_PER_WORD)
#endif

/* Provide a reasonable default for the maximum size of an object to
   allocate in the fixed frame.  We may need to be able to make this
   controllable by the user at some point.  */
#ifndef STACK_CHECK_MAX_VAR_SIZE
#define STACK_CHECK_MAX_VAR_SIZE (STACK_CHECK_MAX_FRAME_SIZE / 100)
#endif
Richard Kenner committed
245

246 247
/* Functions from optabs.c, commonly used, and without need for the optabs
   tables:  */
Richard Kenner committed
248

249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276
/* Passed to expand_simple_binop and expand_binop to say which options
   to try to use if the requested operation can't be open-coded on the
   requisite mode.  Either OPTAB_LIB or OPTAB_LIB_WIDEN says try using
   a library call.  Either OPTAB_WIDEN or OPTAB_LIB_WIDEN says try
   using a wider mode.  OPTAB_MUST_WIDEN says try widening and don't
   try anything else.  */

enum optab_methods
{
  OPTAB_DIRECT,
  OPTAB_LIB,
  OPTAB_WIDEN,
  OPTAB_LIB_WIDEN,
  OPTAB_MUST_WIDEN
};

/* Generate code for a simple binary or unary operation.  "Simple" in
   this case means "can be unambiguously described by a (mode, code)
   pair and mapped to a single optab."  */
extern rtx expand_simple_binop PARAMS ((enum machine_mode, enum rtx_code, rtx,
					rtx, rtx, int, enum optab_methods));
extern rtx expand_simple_unop PARAMS ((enum machine_mode, enum rtx_code,
				       rtx, rtx, int));

/* Report whether the machine description contains an insn which can
   perform the operation described by CODE and MODE.  */
extern int have_insn_for PARAMS ((enum rtx_code, enum machine_mode));

277
/* Emit code to make a call to a constant function or a library call.  */
278
extern void emit_libcall_block PARAMS ((rtx, rtx, rtx, rtx));
Richard Kenner committed
279

280 281 282 283 284 285 286
/* Create but don't emit one rtl instruction to perform certain operations.
   Modes must match; operands must meet the operation's predicates.
   Likewise for subtraction and for just copying.
   These do not call protect_from_queue; caller must do so.  */
extern rtx gen_add2_insn PARAMS ((rtx, rtx));
extern rtx gen_add3_insn PARAMS ((rtx, rtx, rtx));
extern rtx gen_sub2_insn PARAMS ((rtx, rtx));
287
extern rtx gen_sub3_insn PARAMS ((rtx, rtx, rtx));
288 289 290
extern rtx gen_move_insn PARAMS ((rtx, rtx));
extern int have_add2_insn PARAMS ((rtx, rtx));
extern int have_sub2_insn PARAMS ((rtx, rtx));
291

Kazu Hirata committed
292
/* Emit a pair of rtl insns to compare two rtx's and to jump
293
   to a label if the comparison is true.  */
294
extern void emit_cmp_and_jump_insns PARAMS ((rtx, rtx, enum rtx_code, rtx,
295
					     enum machine_mode, int, rtx));
296

297
/* Generate code to indirectly jump to a location given in the rtx LOC.  */
298
extern void emit_indirect_jump PARAMS ((rtx));
299

300 301
#ifdef HAVE_conditional_move
/* Emit a conditional move operation.  */
302 303 304
rtx emit_conditional_move PARAMS ((rtx, enum rtx_code, rtx, rtx,
				   enum machine_mode, rtx, rtx,
				   enum machine_mode, int));
305

306
/* Return nonzero if the conditional move is supported.  */
307
int can_conditionally_move_p PARAMS ((enum machine_mode mode));
308

309 310
#endif

311

312
/* Functions from expmed.c:  */
Richard Kenner committed
313

314 315
/* Arguments MODE, RTX: return an rtx for the negation of that value.
   May emit insns.  */
316
extern rtx negate_rtx PARAMS ((enum machine_mode, rtx));
Richard Kenner committed
317

318
/* Expand a logical AND operation.  */
319
extern rtx expand_and PARAMS ((enum machine_mode, rtx, rtx, rtx));
Richard Kenner committed
320

321
/* Emit a store-flag operation.  */
322 323
extern rtx emit_store_flag PARAMS ((rtx, enum rtx_code, rtx, rtx,
				    enum machine_mode, int, int));
Richard Kenner committed
324

325
/* Like emit_store_flag, but always succeeds.  */
326 327
extern rtx emit_store_flag_force PARAMS ((rtx, enum rtx_code, rtx, rtx,
					  enum machine_mode, int, int));
328

329
/* Functions from loop.c:  */
Richard Kenner committed
330

331 332
/* Given an insn and condition, return a canonical description of
   the test being made.  */
333
extern rtx canonicalize_condition PARAMS ((rtx, rtx, int, rtx *, rtx));
334 335 336

/* Given a JUMP_INSN, return a canonical description of the test
   being made.  */
337
extern rtx get_condition PARAMS ((rtx, rtx *));
338 339

/* Generate a conditional trap instruction.  */
340
extern rtx gen_cond_trap PARAMS ((enum rtx_code, rtx, rtx, rtx));
341

342
/* Functions from builtins.c:  */
343
extern rtx expand_builtin PARAMS ((tree, rtx, rtx, enum machine_mode, int));
344
extern void std_expand_builtin_va_start PARAMS ((tree, rtx));
345 346
extern rtx std_expand_builtin_va_arg PARAMS ((tree, tree));
extern rtx expand_builtin_va_arg PARAMS ((tree, tree));
347 348 349
extern void default_init_builtins PARAMS ((void));
extern rtx default_expand_builtin PARAMS ((tree, rtx, rtx,
					   enum machine_mode, int));
350 351
extern void expand_builtin_setjmp_setup PARAMS ((rtx, rtx));
extern void expand_builtin_setjmp_receiver PARAMS ((rtx));
352 353
extern void expand_builtin_longjmp PARAMS ((rtx, rtx));
extern rtx expand_builtin_saveregs PARAMS ((void));
354
extern void expand_builtin_trap PARAMS ((void));
355 356 357 358 359 360
extern HOST_WIDE_INT get_varargs_alias_set PARAMS ((void));
extern HOST_WIDE_INT get_frame_alias_set PARAMS ((void));
extern void record_base_value		PARAMS ((unsigned int, rtx, int));
extern void record_alias_subset         PARAMS ((HOST_WIDE_INT,
						 HOST_WIDE_INT));
extern HOST_WIDE_INT new_alias_set		PARAMS ((void));
361
extern int can_address_p		PARAMS ((tree));
362

363
/* Functions from expr.c:  */
364

365 366
/* This is run once per compilation to set up which modes can be used
   directly in memory and to initialize the block move optab.  */
367
extern void init_expr_once PARAMS ((void));
368 369

/* This is run at the start of compiling a function.  */
370
extern void init_expr PARAMS ((void));
371

372
/* This is run at the end of compiling a function.  */
373
extern void finish_expr_for_function PARAMS ((void));
374

375 376
/* Use protect_from_queue to convert a QUEUED expression
   into something that you can put immediately into an instruction.  */
377
extern rtx protect_from_queue PARAMS ((rtx, int));
378 379

/* Perform all the pending incrementations.  */
380
extern void emit_queue PARAMS ((void));
381

382
/* Tell if something has a queued subexpression.  */
383
extern int queued_subexp_p PARAMS ((rtx));
384

Richard Kenner committed
385 386
/* Emit some rtl insns to move data between rtx's, converting machine modes.
   Both modes must be floating or both fixed.  */
387
extern void convert_move PARAMS ((rtx, rtx, int));
Richard Kenner committed
388 389

/* Convert an rtx to specified machine mode and return the result.  */
390
extern rtx convert_to_mode PARAMS ((enum machine_mode, rtx, int));
Richard Kenner committed
391

392
/* Convert an rtx to MODE from OLDMODE and return the result.  */
393 394
extern rtx convert_modes PARAMS ((enum machine_mode, enum machine_mode,
				  rtx, int));
395

396
/* Emit code to move a block Y to a block X.  */
397 398 399 400 401 402 403 404 405

enum block_op_methods
{
  BLOCK_OP_NORMAL,
  BLOCK_OP_CALL_PARM,
  BLOCK_OP_NO_LIBCALL
};

extern rtx emit_block_move PARAMS ((rtx, rtx, rtx, enum block_op_methods));
406 407 408

/* Copy all or part of a value X into registers starting at REGNO.
   The number of registers to be filled is NREGS.  */
409
extern void move_block_to_reg PARAMS ((int, rtx, int, enum machine_mode));
410 411 412

/* Copy all or part of a BLKmode value X out of registers starting at REGNO.
   The number of registers to be filled is NREGS.  */
413
extern void move_block_from_reg PARAMS ((int, rtx, int, int));
414

415 416 417
/* Generate a non-consecutive group of registers represented by a PARALLEL.  */
extern rtx gen_group_rtx PARAMS ((rtx));

418 419
/* Load a BLKmode value into non-consecutive registers represented by a
   PARALLEL.  */
420
extern void emit_group_load PARAMS ((rtx, rtx, int));
421

422 423 424 425
/* Move a non-consecutive group of registers represented by a PARALLEL into
   a non-consecutive group of registers represented by a PARALLEL.  */
extern void emit_group_move PARAMS ((rtx, rtx));

426 427
/* Store a BLKmode value from non-consecutive registers represented by a
   PARALLEL.  */
428
extern void emit_group_store PARAMS ((rtx, rtx, int));
429

430
#ifdef TREE_CODE
431
/* Copy BLKmode object from a set of registers.  */
432
extern rtx copy_blkmode_from_reg PARAMS ((rtx,rtx,tree));
433 434
#endif

435
/* Mark REG as holding a parameter for the next CALL_INSN.  */
436
extern void use_reg PARAMS ((rtx *, rtx));
437

438 439
/* Mark NREGS consecutive regs, starting at REGNO, as holding parameters
   for the next CALL_INSN.  */
440
extern void use_regs PARAMS ((rtx *, int, int));
441

442
/* Mark a PARALLEL as holding a parameter for the next CALL_INSN.  */
443
extern void use_group_regs PARAMS ((rtx *, rtx));
444 445

/* Write zeros through the storage of OBJECT.
446 447
   If OBJECT has BLKmode, SIZE is its length in bytes.  */
extern rtx clear_storage PARAMS ((rtx, rtx));
448

449
/* Return nonzero if it is desirable to store LEN bytes generated by
450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467
   CONSTFUN with several move instructions by store_by_pieces
   function.  CONSTFUNDATA is a pointer which will be passed as argument
   in every CONSTFUN call.
   ALIGN is maximum alignment we can assume.  */
extern int can_store_by_pieces PARAMS ((unsigned HOST_WIDE_INT,
					rtx (*) (PTR, HOST_WIDE_INT,
						 enum machine_mode),
					PTR, unsigned int));

/* Generate several move instructions to store LEN bytes generated by
   CONSTFUN to block TO.  (A MEM rtx with BLKmode).  CONSTFUNDATA is a
   pointer which will be passed as argument in every CONSTFUN call.
   ALIGN is maximum alignment we can assume.  */
extern void store_by_pieces PARAMS ((rtx, unsigned HOST_WIDE_INT,
				     rtx (*) (PTR, HOST_WIDE_INT,
					      enum machine_mode),
				     PTR, unsigned int));

468
/* Emit insns to set X from Y.  */
469
extern rtx emit_move_insn PARAMS ((rtx, rtx));
470 471

/* Emit insns to set X from Y, with no frills.  */
472
extern rtx emit_move_insn_1 PARAMS ((rtx, rtx));
473 474 475

/* Push a block of length SIZE (perhaps variable)
   and return an rtx to address the beginning of the block.  */
476
extern rtx push_block PARAMS ((rtx, int, int));
477 478 479

#ifdef TREE_CODE
/* Generate code to push something onto the stack, given its mode and type.  */
480 481 482
extern void emit_push_insn PARAMS ((rtx, enum machine_mode, tree, rtx,
				    unsigned int, int, rtx, int, rtx, rtx,
				    int, rtx));
483

484
/* Expand an assignment that stores the value of FROM into TO.  */
485
extern rtx expand_assignment PARAMS ((tree, tree, int, int));
486 487 488 489 490

/* Generate code for computing expression EXP,
   and storing the value into TARGET.
   If SUGGEST_REG is nonzero, copy the value through a register
   and return that register, if that is possible.  */
491
extern rtx store_expr PARAMS ((tree, rtx, int));
492
#endif
Richard Kenner committed
493 494 495 496

/* Given an rtx that may include add and multiply operations,
   generate them as insns and return a pseudo-reg containing the value.
   Useful after calling expand_expr with 1 as sum_ok.  */
497
extern rtx force_operand PARAMS ((rtx, rtx));
Richard Kenner committed
498

499 500
/* Return an object on the placeholder list that matches EXP, a
   PLACEHOLDER_EXPR.  An object "matches" if it is of the type of the
501 502 503 504 505
   PLACEHOLDER_EXPR or a pointer type to it.  For further information, see
   tree.def.  If no such object is found, abort.  If PLIST is nonzero, it is
   a location which initially points to a starting location in the
   placeholder list (zero means start of the list) and where a pointer into
   the placeholder list at which the object is found is placed.  */
506 507
extern tree find_placeholder PARAMS ((tree, tree *));

508 509 510
/* Generate code for computing expression EXP.
   An rtx for the computed value is returned.  The value is never null.
   In the case of a void EXP, const0_rtx is returned.  */
511 512
extern rtx expand_expr PARAMS ((tree, rtx, enum machine_mode,
				enum expand_modifier));
513 514 515

/* At the start of a function, record that we have no previously-pushed
   arguments waiting to be popped.  */
516
extern void init_pending_stack_adjust PARAMS ((void));
517 518 519

/* When exiting from function, if safe, clear out any pending stack adjust
   so the adjustment won't get done.  */
520
extern void clear_pending_stack_adjust PARAMS ((void));
521 522

/* Pop any previously-pushed arguments that have not been popped yet.  */
523
extern void do_pending_stack_adjust PARAMS ((void));
524 525

#ifdef TREE_CODE
526 527
/* Return the tree node and offset if a given argument corresponds to
   a string constant.  */
528
extern tree string_constant PARAMS ((tree, tree *));
529

530
/* Generate code to evaluate EXP and jump to LABEL if the value is zero.  */
531
extern void jumpifnot PARAMS ((tree, rtx));
532 533

/* Generate code to evaluate EXP and jump to LABEL if the value is nonzero.  */
534
extern void jumpif PARAMS ((tree, rtx));
535 536 537

/* Generate code to evaluate EXP and jump to IF_FALSE_LABEL if
   the result is zero, or IF_TRUE_LABEL if the result is one.  */
538
extern void do_jump PARAMS ((tree, rtx, rtx));
539 540 541
#endif

/* Generate rtl to compare two rtx's, will call emit_cmp_insn.  */
542
extern rtx compare_from_rtx PARAMS ((rtx, rtx, enum rtx_code, int,
543
				     enum machine_mode, rtx));
544
extern void do_compare_rtx_and_jump PARAMS ((rtx, rtx, enum rtx_code, int,
545
					     enum machine_mode, rtx,
546
					     rtx, rtx));
547

548 549 550 551 552 553 554 555
/* Two different ways of generating switch statements.  */
extern int try_casesi    PARAMS ((tree, tree, tree, tree, rtx, rtx));
extern int try_tablejump PARAMS ((tree, tree, tree, tree, rtx, rtx));

/* Smallest number of adjacent cases before we use a jump table.
   XXX Should be a target hook.  */
extern unsigned int case_values_threshold PARAMS ((void));

556 557

#ifdef TREE_CODE
558 559
/* rtl.h and tree.h were included.  */
/* Return an rtx for the size in bytes of the value of an expr.  */
560
extern rtx expr_size PARAMS ((tree));
561

562 563 564 565
/* Return a wide integer for the size in bytes of the value of EXP, or -1
   if the size can vary or is larger than an integer.  */
extern HOST_WIDE_INT int_expr_size PARAMS ((tree));

566
extern rtx lookup_static_chain PARAMS ((tree));
567 568 569

/* Convert a stack slot address ADDR valid in function FNDECL
   into an address valid in this function (using a static chain).  */
570
extern rtx fix_lexical_addr PARAMS ((rtx, tree));
571 572

/* Return the address of the trampoline for entering nested fn FUNCTION.  */
573
extern rtx trampoline_address PARAMS ((tree));
574 575 576

/* Return an rtx that refers to the value returned by a function
   in its original home.  This becomes invalid if any more code is emitted.  */
577
extern rtx hard_function_value PARAMS ((tree, tree, int));
578

579
extern rtx prepare_call_address	PARAMS ((rtx, tree, rtx *, int, int));
580

581
extern rtx expand_call PARAMS ((tree, rtx, int));
582

583 584 585 586 587 588 589 590 591
extern rtx expand_shift PARAMS ((enum tree_code, enum machine_mode, rtx, tree,
				 rtx, int));
extern rtx expand_divmod PARAMS ((int, enum tree_code, enum machine_mode, rtx,
				  rtx, rtx, int));
extern void locate_and_pad_parm PARAMS ((enum machine_mode, tree, int, tree,
					 struct args_size *,
					 struct args_size *,
					 struct args_size *,
					 struct args_size *));
592
extern rtx expand_inline_function PARAMS ((tree, tree, rtx, int, tree, rtx));
593

594
/* Return the CODE_LABEL rtx for a LABEL_DECL, creating it if necessary.  */
595
extern rtx label_rtx PARAMS ((tree));
596 597
#endif

598
/* Indicate how an input argument register was promoted.  */
599 600
extern rtx promoted_input_arg PARAMS ((unsigned int, enum machine_mode *,
				       int *));
601

Richard Kenner committed
602 603 604
/* Return an rtx like arg but sans any constant terms.
   Returns the original rtx if it has no constant terms.
   The constant terms are added and stored via a second arg.  */
605
extern rtx eliminate_constant_term PARAMS ((rtx, rtx *));
Richard Kenner committed
606 607 608

/* Convert arg to a valid memory address for specified machine mode,
   by emitting insns to perform arithmetic if nec.  */
609
extern rtx memory_address PARAMS ((enum machine_mode, rtx));
Richard Kenner committed
610 611

/* Like `memory_address' but pretent `flag_force_addr' is 0.  */
612
extern rtx memory_address_noforce PARAMS ((enum machine_mode, rtx));
Richard Kenner committed
613

614 615 616
/* Set the alias set of MEM to SET.  */
extern void set_mem_alias_set PARAMS ((rtx, HOST_WIDE_INT));

617
/* Set the alignment of MEM to ALIGN bits.  */
618 619
extern void set_mem_align PARAMS ((rtx, unsigned int));

620 621 622 623 624
/* Set the expr for MEM to EXPR.  */
extern void set_mem_expr PARAMS ((rtx, tree));

/* Set the offset for MEM to OFFSET.  */
extern void set_mem_offset PARAMS ((rtx, rtx));
625

626 627 628
/* Set the size for MEM to SIZE.  */
extern void set_mem_size PARAMS ((rtx, rtx));

Richard Kenner committed
629 630 631
/* Return a memory reference like MEMREF, but with its mode changed
   to MODE and its address changed to ADDR.
   (VOIDmode means don't change the mode.
632 633
   NULL for ADDR means don't change the address.)  */
extern rtx change_address PARAMS ((rtx, enum machine_mode, rtx));
Richard Kenner committed
634

635 636
/* Return a memory reference like MEMREF, but with its mode changed
   to MODE and its address offset by OFFSET bytes.  */
637
#define adjust_address(MEMREF, MODE, OFFSET) \
Jakub Jelinek committed
638
  adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1)
639

Richard Kenner committed
640
/* Likewise, but the reference is not required to be valid.  */
641
#define adjust_address_nv(MEMREF, MODE, OFFSET) \
Jakub Jelinek committed
642 643 644 645 646 647 648 649 650 651 652
  adjust_address_1 (MEMREF, MODE, OFFSET, 0, 1)

/* Return a memory reference like MEMREF, but with its mode changed
   to MODE and its address changed to ADDR, which is assumed to be
   increased by OFFSET bytes from MEMREF.  */
#define adjust_automodify_address(MEMREF, MODE, ADDR, OFFSET) \
  adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 1)

/* Likewise, but the reference is not required to be valid.  */
#define adjust_automodify_address_nv(MEMREF, MODE, ADDR, OFFSET) \
  adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 0)
653 654

extern rtx adjust_address_1 PARAMS ((rtx, enum machine_mode, HOST_WIDE_INT,
Jakub Jelinek committed
655 656 657
				     int, int));
extern rtx adjust_automodify_address_1 PARAMS ((rtx, enum machine_mode,
						rtx, HOST_WIDE_INT, int));
Richard Kenner committed
658

659 660 661 662 663
/* Return a memory reference like MEMREF, but whose address is changed by
   adding OFFSET, an RTX, to it.  POW2 is the highest power of two factor
   known to be in OFFSET (possibly 1).  */
extern rtx offset_address PARAMS ((rtx, rtx, HOST_WIDE_INT));

664 665 666 667 668 669
/* Return a memory reference like MEMREF, but with its address changed to
   ADDR.  The caller is asserting that the actual piece of memory pointed
   to is the same, just the form of the address is being changed, such as
   by putting something into a register.  */
extern rtx replace_equiv_address PARAMS ((rtx, rtx));

Richard Kenner committed
670 671 672
/* Likewise, but the reference is not required to be valid.  */
extern rtx replace_equiv_address_nv PARAMS ((rtx, rtx));

673 674 675 676
/* Return a memory reference like MEMREF, but with its mode widened to
   MODE and adjusted by OFFSET.  */
extern rtx widen_memory_access PARAMS ((rtx, enum machine_mode, HOST_WIDE_INT));

Richard Kenner committed
677 678
/* Return a memory reference like MEMREF, but which is known to have a
   valid address.  */
679
extern rtx validize_mem PARAMS ((rtx));
Richard Kenner committed
680

681
#ifdef TREE_CODE
682 683 684 685 686
/* Given REF, either a MEM or a REG, and T, either the type of X or
   the expression corresponding to REF, set RTX_UNCHANGING_P if
   appropriate.  */
extern void maybe_set_unchanging PARAMS ((rtx, tree));

687 688 689 690
/* Given REF, a MEM, and T, either the type of X or the expression
   corresponding to REF, set the memory attributes.  OBJECTP is nonzero
   if we are making a new object of this type.  */
extern void set_mem_attributes PARAMS ((rtx, tree, int));
691 692 693 694 695 696

/* Similar, except that BITPOS has not yet been applied to REF, so if
   we alter MEM_OFFSET according to T then we should subtract BITPOS
   expecting that it'll be added back in later.  */
extern void set_mem_attributes_minus_bitpos PARAMS ((rtx, tree, int,
						     HOST_WIDE_INT));
697 698
#endif

Richard Kenner committed
699
/* Assemble the static constant template for function entry trampolines.  */
700
extern rtx assemble_trampoline_template PARAMS ((void));
Richard Kenner committed
701 702 703

/* Given rtx, return new rtx whose address won't be affected by
   any side effects.  It has been copied to a new temporary reg.  */
704
extern rtx stabilize PARAMS ((rtx));
Richard Kenner committed
705 706 707

/* Given an rtx, copy all regs it refers to into new temps
   and return a modified copy that refers to the new temps.  */
708
extern rtx copy_all_regs PARAMS ((rtx));
Richard Kenner committed
709 710

/* Copy given rtx to a new temp reg and return that.  */
711
extern rtx copy_to_reg PARAMS ((rtx));
Richard Kenner committed
712 713

/* Like copy_to_reg but always make the reg Pmode.  */
714
extern rtx copy_addr_to_reg PARAMS ((rtx));
Richard Kenner committed
715 716

/* Like copy_to_reg but always make the reg the specified mode MODE.  */
717
extern rtx copy_to_mode_reg PARAMS ((enum machine_mode, rtx));
Richard Kenner committed
718 719

/* Copy given rtx to given temp reg and return that.  */
720
extern rtx copy_to_suggested_reg PARAMS ((rtx, rtx, enum machine_mode));
Richard Kenner committed
721 722 723

/* Copy a value to a register if it isn't already a register.
   Args are mode (in case value is a constant) and the value.  */
724
extern rtx force_reg PARAMS ((enum machine_mode, rtx));
Richard Kenner committed
725 726

/* Return given rtx, copied into a new temp reg if it was in memory.  */
727
extern rtx force_not_mem PARAMS ((rtx));
Richard Kenner committed
728

729 730
#ifdef TREE_CODE
/* Return mode and signedness to use when object is promoted.  */
731 732
extern enum machine_mode promote_mode PARAMS ((tree, enum machine_mode,
					       int *, int));
733 734
#endif

Richard Kenner committed
735
/* Remove some bytes from the stack.  An rtx says how many.  */
736
extern void adjust_stack PARAMS ((rtx));
Richard Kenner committed
737 738

/* Add some bytes to the stack.  An rtx says how many.  */
739
extern void anti_adjust_stack PARAMS ((rtx));
Richard Kenner committed
740

741 742 743 744
/* This enum is used for the following two functions.  */
enum save_level {SAVE_BLOCK, SAVE_FUNCTION, SAVE_NONLOCAL};

/* Save the stack pointer at the specified level.  */
745
extern void emit_stack_save PARAMS ((enum save_level, rtx *, rtx));
746 747

/* Restore the stack pointer from a save area of the specified level.  */
748
extern void emit_stack_restore PARAMS ((enum save_level, rtx, rtx));
749

Richard Kenner committed
750 751
/* Allocate some space on the stack dynamically and return its address.  An rtx
   says how many bytes.  */
752
extern rtx allocate_dynamic_stack_space PARAMS ((rtx, rtx, int));
Richard Kenner committed
753

Kazu Hirata committed
754
/* Probe a range of stack addresses from FIRST to FIRST+SIZE, inclusive.
755 756 757 758
   FIRST is a constant and size is a Pmode RTX.  These are offsets from the
   current stack pointer.  STACK_GROWS_DOWNWARD says whether to add or
   subtract from the stack.  If SIZE is constant, this is done
   with a fixed number of probes.  Otherwise, we must make a loop.  */
759
extern void probe_stack_range PARAMS ((HOST_WIDE_INT, rtx));
760

Richard Kenner committed
761 762
/* Return an rtx that refers to the value returned by a library call
   in its original home.  This becomes invalid if any more code is emitted.  */
763
extern rtx hard_libcall_value PARAMS ((enum machine_mode));
Richard Kenner committed
764 765 766

/* Given an rtx, return an rtx for a value rounded up to a multiple
   of STACK_BOUNDARY / BITS_PER_UNIT.  */
767
extern rtx round_push PARAMS ((rtx));
Richard Kenner committed
768

769 770 771 772 773 774 775 776
/* Return the mode desired by operand N of a particular bitfield
   insert/extract insn, or MAX_MACHINE_MODE if no such insn is
   available.  */

enum extraction_pattern { EP_insv, EP_extv, EP_extzv };
extern enum machine_mode
mode_for_extraction PARAMS ((enum extraction_pattern, int));

777 778
extern rtx store_bit_field PARAMS ((rtx, unsigned HOST_WIDE_INT,
				    unsigned HOST_WIDE_INT,
779
				    enum machine_mode, rtx, HOST_WIDE_INT));
780 781
extern rtx extract_bit_field PARAMS ((rtx, unsigned HOST_WIDE_INT,
				      unsigned HOST_WIDE_INT, int, rtx,
782
				      enum machine_mode, enum machine_mode,
783
				      HOST_WIDE_INT));
784
extern rtx expand_mult PARAMS ((enum machine_mode, rtx, rtx, rtx, int));
785
extern bool const_mult_add_overflow_p PARAMS ((rtx, rtx, rtx, enum machine_mode, int));
786 787
extern rtx expand_mult_add PARAMS ((rtx, rtx, rtx, rtx,enum machine_mode, int));
extern rtx expand_mult_highpart_adjust PARAMS ((enum machine_mode, rtx, rtx, rtx, rtx, int));
Richard Kenner committed
788

789
extern rtx assemble_static_space PARAMS ((int));
Richard Kenner committed
790 791 792 793

/* Hook called by expand_expr for language-specific tree codes.
   It is up to the language front end to install a hook
   if it has any such codes that expand_expr needs to know about.  */
794 795 796
extern rtx (*lang_expand_expr) PARAMS ((union tree_node *, rtx,
					enum machine_mode,
					enum expand_modifier modifier));
797

798 799
extern int safe_from_p PARAMS ((rtx, tree, int));

800 801 802
/* Call this once to initialize the contents of the optabs
   appropriately for the current target machine.  */
extern void init_optabs				PARAMS ((void));
803
extern void init_all_optabs			PARAMS ((void));
804 805 806 807

/* Call this to initialize an optab function entry.  */
extern rtx init_one_libfunc			PARAMS ((const char *));

808 809 810 811
extern void do_jump_by_parts_equality_rtx	PARAMS ((rtx, rtx, rtx));
extern void do_jump_by_parts_greater_rtx	PARAMS ((enum machine_mode,
							 int, rtx, rtx, rtx,
							 rtx));
812

813
#ifdef TREE_CODE   /* Don't lose if tree.h not included.  */
814
extern void mark_seen_cases			PARAMS ((tree, unsigned char *,
815
							 HOST_WIDE_INT, int));
816
#endif
Aldy Hernandez committed
817 818

extern int vector_mode_valid_p		PARAMS ((enum machine_mode));