1/* Export function prototypes from explow.c.
2   Copyright (C) 2015-2016 Free Software Foundation, Inc.
3
4This file is part of GCC.
5
6GCC is free software; you can redistribute it and/or modify it under
7the terms of the GNU General Public License as published by the Free
8Software Foundation; either version 3, or (at your option) any later
9version.
10
11GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12WARRANTY; without even the implied warranty of MERCHANTABILITY or
13FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14for more details.
15
16You should have received a copy of the GNU General Public License
17along 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.  */
25extern rtx validize_mem (rtx);
26
27extern rtx use_anchored_address (rtx);
28
29/* Copy given rtx to a new temp reg and return that.  */
30extern rtx copy_to_reg (rtx);
31
32/* Like copy_to_reg but always make the reg Pmode.  */
33extern rtx copy_addr_to_reg (rtx);
34
35/* Like copy_to_reg but always make the reg the specified mode MODE.  */
36extern rtx copy_to_mode_reg (machine_mode, rtx);
37
38/* Copy given rtx to given temp reg and return that.  */
39extern 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.  */
43extern rtx force_reg (machine_mode, rtx);
44
45/* Return given rtx, copied into a new temp reg if it was in memory.  */
46extern 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.  */
50extern 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.  */
55extern machine_mode promote_mode (const_tree, machine_mode, int *);
56
57/* Return mode and signedness to use when object is promoted.  */
58machine_mode promote_decl_mode (const_tree, int *);
59
60/* Remove some bytes from the stack.  An rtx says how many.  */
61extern void adjust_stack (rtx);
62
63/* Add some bytes to the stack.  An rtx says how many.  */
64extern void anti_adjust_stack (rtx);
65
66/* Add some bytes to the stack while probing it.  An rtx says how many. */
67extern void anti_adjust_stack_and_probe (rtx, bool);
68
69/* This enum is used for the following two functions.  */
70enum save_level {SAVE_BLOCK, SAVE_FUNCTION, SAVE_NONLOCAL};
71
72/* Save the stack pointer at the specified level.  */
73extern void emit_stack_save (enum save_level, rtx *);
74
75/* Restore the stack pointer from a save area of the specified level.  */
76extern void emit_stack_restore (enum save_level, rtx);
77
78/* Invoke emit_stack_save for the nonlocal_goto_save_area.  */
79extern void update_nonlocal_goto_save_area (void);
80
81/* Allocate some space on the stack dynamically and return its address.  */
82extern rtx allocate_dynamic_stack_space (rtx, unsigned, unsigned, bool);
83
84/* Emit one stack probe at ADDRESS, an address within the stack.  */
85extern void emit_stack_probe (rtx);
86
87/* Probe a range of stack addresses from FIRST to FIRST+SIZE, inclusive.
88   FIRST is a constant and size is a Pmode RTX.  These are offsets from
89   the current stack pointer.  STACK_GROWS_DOWNWARD says whether to add
90   or subtract them from the stack pointer.  */
91extern void probe_stack_range (HOST_WIDE_INT, rtx);
92
93/* Return an rtx that refers to the value returned by a library call
94   in its original home.  This becomes invalid if any more code is emitted.  */
95extern rtx hard_libcall_value (machine_mode, rtx);
96
97/* Return an rtx that refers to the value returned by a function
98   in its original home.  This becomes invalid if any more code is emitted.  */
99extern rtx hard_function_value (const_tree, const_tree, const_tree, int);
100
101/* Convert arg to a valid memory address for specified machine mode that points
102   to a specific named address space, by emitting insns to perform arithmetic
103   if necessary.  */
104extern rtx memory_address_addr_space (machine_mode, rtx, addr_space_t);
105
106extern rtx eliminate_constant_term (rtx, rtx *);
107
108/* Like memory_address_addr_space, except assume the memory address points to
109   the generic named address space.  */
110#define memory_address(MODE,RTX) \
111	memory_address_addr_space ((MODE), (RTX), ADDR_SPACE_GENERIC)
112
113#endif /* GCC_EXPLOW_H */
114