gcc/explow.h

   1 /* Export function prototypes from explow.c.
   2    Copyright (C) 2015-2020 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 it under
   7 the terms of the GNU General Public License as published by the Free
   8 Software Foundation; either version 3, or (at your option) any later
   9 version.
  10
  11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14 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_EXPLOW_H
  21 #define GCC_EXPLOW_H
  22
  23 /* Return a memory reference like MEMREF, but which is known to have a
  24    valid address.  */
  25 extern rtx validize_mem (rtx);
  26
  27 extern rtx use_anchored_address (rtx);
  28
  29 /* Copy given rtx to a new temp reg and return that.  */
  30 extern rtx copy_to_reg (rtx);
  31
  32 /* Like copy_to_reg but always make the reg Pmode.  */
  33 extern rtx copy_addr_to_reg (rtx);
  34
  35 /* Like copy_to_reg but always make the reg the specified mode MODE.  */
  36 extern rtx copy_to_mode_reg (machine_mode, rtx);
  37
  38 /* Copy given rtx to given temp reg and return that.  */
  39 extern rtx copy_to_suggested_reg (rtx, rtx, machine_mode);
  40
  41 /* Copy a value to a register if it isn't already a register.
  42    Args are mode (in case value is a constant) and the value.  */
  43 extern rtx force_reg (machine_mode, rtx);
  44
  45 /* Return given rtx, copied into a new temp reg if it was in memory.  */
  46 extern rtx force_not_mem (rtx);
  47
  48 /* Return mode and signedness to use when an argument or result in the
  49    given mode is promoted.  */
  50 extern machine_mode promote_function_mode (const_tree, machine_mode, int *,
  51                                                 const_tree, int);
  52
  53 /* Return mode and signedness to use when an object in the given mode
  54    is promoted.  */
  55 extern machine_mode promote_mode (const_tree, machine_mode, int *);
  56
  57 /* Return mode and signedness to use when object is promoted.  */
  58 machine_mode promote_decl_mode (const_tree, int *);
  59
  60 /* Return mode and signedness to use when object is promoted.  */
  61 machine_mode promote_ssa_mode (const_tree, int *);
  62
  63 /* Remove some bytes from the stack.  An rtx says how many.  */
  64 extern void adjust_stack (rtx);
  65
  66 /* Add some bytes to the stack.  An rtx says how many.  */
  67 extern void anti_adjust_stack (rtx);
  68
  69 /* Add some bytes to the stack while probing it.  An rtx says how many. */
  70 extern void anti_adjust_stack_and_probe (rtx, bool);
  71
  72 /* Support for building allocation/probing loops for stack-clash
  73    protection of dyamically allocated stack space.  */
  74 extern void compute_stack_clash_protection_loop_data (rtx *, rtx *, rtx *,
  75                                                       HOST_WIDE_INT *, rtx);
  76 extern void emit_stack_clash_protection_probe_loop_start (rtx *, rtx *,
  77                                                           rtx, bool);
  78 extern void emit_stack_clash_protection_probe_loop_end (rtx, rtx,
  79                                                         rtx, bool);
  80
  81 /* This enum is used for the following two functions.  */
  82 enum save_level {SAVE_BLOCK, SAVE_FUNCTION, SAVE_NONLOCAL};
  83
  84 /* Save the stack pointer at the specified level.  */
  85 extern void emit_stack_save (enum save_level, rtx *);
  86
  87 /* Restore the stack pointer from a save area of the specified level.  */
  88 extern void emit_stack_restore (enum save_level, rtx);
  89
  90 /* Invoke emit_stack_save for the nonlocal_goto_save_area.  */
  91 extern void update_nonlocal_goto_save_area (void);
  92
  93 /* Record a new stack level.  */
  94 extern void record_new_stack_level (void);
  95
  96 /* Allocate some space on the stack dynamically and return its address.  */
  97 extern rtx allocate_dynamic_stack_space (rtx, unsigned, unsigned,
  98                                          HOST_WIDE_INT, bool);
  99
 100 /* Calculate the necessary size of a constant dynamic stack allocation from the
 101    size of the variable area.  */
 102 extern void get_dynamic_stack_size (rtx *, unsigned, unsigned, HOST_WIDE_INT *);
 103
 104 /* Returns the address of the dynamic stack space without allocating it.  */
 105 extern rtx get_dynamic_stack_base (poly_int64, unsigned);
 106
 107 /* Return an rtx doing runtime alignment to REQUIRED_ALIGN on TARGET.  */
 108 extern rtx align_dynamic_address (rtx, unsigned);
 109
 110 /* Emit one stack probe at ADDRESS, an address within the stack.  */
 111 extern void emit_stack_probe (rtx);
 112
 113 /* Probe a range of stack addresses from FIRST to FIRST+SIZE, inclusive.
 114    FIRST is a constant and size is a Pmode RTX.  These are offsets from
 115    the current stack pointer.  STACK_GROWS_DOWNWARD says whether to add
 116    or subtract them from the stack pointer.  */
 117 extern void probe_stack_range (HOST_WIDE_INT, rtx);
 118
 119 /* Return an rtx that refers to the value returned by a library call
 120    in its original home.  This becomes invalid if any more code is emitted.  */
 121 extern rtx hard_libcall_value (machine_mode, rtx);
 122
 123 /* Return an rtx that refers to the value returned by a function
 124    in its original home.  This becomes invalid if any more code is emitted.  */
 125 extern rtx hard_function_value (const_tree, const_tree, const_tree, int);
 126
 127 /* Convert arg to a valid memory address for specified machine mode that points
 128    to a specific named address space, by emitting insns to perform arithmetic
 129    if necessary.  */
 130 extern rtx memory_address_addr_space (machine_mode, rtx, addr_space_t);
 131
 132 extern rtx eliminate_constant_term (rtx, rtx *);
 133
 134 /* Like memory_address_addr_space, except assume the memory address points to
 135    the generic named address space.  */
 136 #define memory_address(MODE,RTX) \
 137         memory_address_addr_space ((MODE), (RTX), ADDR_SPACE_GENERIC)
 138
 139 #endif /* GCC_EXPLOW_H */