1 /* params.h - Run-time parameters.
2 Copyright (C) 2001, 2003, 2004, 2005, 2007, 2008, 2009, 2010
3 Free Software Foundation, Inc.
4 Written by Mark Mitchell <mark@codesourcery.com>.
6 This file is part of GCC.
8 GCC is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 3, or (at your option) any later
13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18 You should have received a copy of the GNU General Public License
19 along with GCC; see the file COPYING3. If not see
20 <http://www.gnu.org/licenses/>. */
22 /* This module provides a means for setting integral parameters
23 dynamically. Instead of encoding magic numbers in various places,
24 use this module to organize all the magic numbers in a single
25 place. The values of the parameters can be set on the
26 command-line, thereby providing a way to control the amount of
27 effort spent on particular optimization passes, or otherwise tune
28 the behavior of the compiler.
30 Since their values can be set on the command-line, these parameters
31 should not be used for non-dynamic memory allocation. */
36 /* No parameter shall have this value. */
38 #define INVALID_PARAM_VAL (-1)
40 /* The information associated with each parameter. */
42 typedef struct param_info
44 /* The name used with the `--param <name>=<value>' switch to set this
46 const char *const option
;
47 /* The associated value. */
50 /* True if the parameter was explicitly set. */
53 /* Minimum acceptable value. */
56 /* Maximum acceptable value, if greater than minimum */
59 /* A short description of the option. */
60 const char *const help
;
63 /* An array containing the compiler parameters and their current
66 extern param_info
*compiler_params
;
68 /* Returns the number of entries in the table, for the use by plugins. */
69 extern size_t get_num_compiler_params (void);
71 /* Add the N PARAMS to the current list of compiler parameters. */
73 extern void add_params (const param_info params
[], size_t n
);
75 /* Set the VALUE associated with the parameter given by NAME. */
77 extern void set_param_value (const char *name
, int value
);
80 /* The parameters in use by language-independent code. */
82 typedef enum compiler_param
84 #define DEFPARAM(enumerator, option, msgid, default, min, max) \
91 /* The value of the parameter given by ENUM. Not an lvalue. */
92 #define PARAM_VALUE(ENUM) \
93 ((int) compiler_params[(int) ENUM].value)
95 /* Set the value of the parameter given by NUM to VALUE, implicitly,
96 if it has not been set explicitly by the user. */
98 extern void maybe_set_param_value (compiler_param num
, int value
);
100 /* Set the default value of a parameter given by NUM to VALUE, before
101 option processing. */
103 extern void set_default_param_value (compiler_param num
, int value
);
105 /* True if the value of the parameter was explicitly changed. Not an
107 #define PARAM_SET_P(ENUM) \
108 ((bool) compiler_params[(int) ENUM].set)
110 /* Macros for the various parameters. */
111 #define STRUCT_REORG_COLD_STRUCT_RATIO \
112 PARAM_VALUE (PARAM_STRUCT_REORG_COLD_STRUCT_RATIO)
113 #define MAX_INLINE_INSNS_SINGLE \
114 PARAM_VALUE (PARAM_MAX_INLINE_INSNS_SINGLE)
115 #define MAX_INLINE_INSNS \
116 PARAM_VALUE (PARAM_MAX_INLINE_INSNS)
117 #define MAX_INLINE_SLOPE \
118 PARAM_VALUE (PARAM_MAX_INLINE_SLOPE)
119 #define MIN_INLINE_INSNS \
120 PARAM_VALUE (PARAM_MIN_INLINE_INSNS)
121 #define MAX_INLINE_INSNS_AUTO \
122 PARAM_VALUE (PARAM_MAX_INLINE_INSNS_AUTO)
123 #define MAX_VARIABLE_EXPANSIONS \
124 PARAM_VALUE (PARAM_MAX_VARIABLE_EXPANSIONS)
125 #define MIN_VECT_LOOP_BOUND \
126 PARAM_VALUE (PARAM_MIN_VECT_LOOP_BOUND)
127 #define MAX_DELAY_SLOT_INSN_SEARCH \
128 PARAM_VALUE (PARAM_MAX_DELAY_SLOT_INSN_SEARCH)
129 #define MAX_DELAY_SLOT_LIVE_SEARCH \
130 PARAM_VALUE (PARAM_MAX_DELAY_SLOT_LIVE_SEARCH)
131 #define MAX_PENDING_LIST_LENGTH \
132 PARAM_VALUE (PARAM_MAX_PENDING_LIST_LENGTH)
133 #define MAX_GCSE_MEMORY \
134 ((size_t) PARAM_VALUE (PARAM_MAX_GCSE_MEMORY))
135 #define GCSE_AFTER_RELOAD_PARTIAL_FRACTION \
136 PARAM_VALUE (PARAM_GCSE_AFTER_RELOAD_PARTIAL_FRACTION)
137 #define GCSE_AFTER_RELOAD_CRITICAL_FRACTION \
138 PARAM_VALUE (PARAM_GCSE_AFTER_RELOAD_CRITICAL_FRACTION)
139 #define GCSE_COST_DISTANCE_RATIO \
140 PARAM_VALUE (PARAM_GCSE_COST_DISTANCE_RATIO)
141 #define GCSE_UNRESTRICTED_COST \
142 PARAM_VALUE (PARAM_GCSE_UNRESTRICTED_COST)
143 #define MAX_HOIST_DEPTH \
144 PARAM_VALUE (PARAM_MAX_HOIST_DEPTH)
145 #define MAX_UNROLLED_INSNS \
146 PARAM_VALUE (PARAM_MAX_UNROLLED_INSNS)
147 #define MAX_SMS_LOOP_NUMBER \
148 PARAM_VALUE (PARAM_MAX_SMS_LOOP_NUMBER)
149 #define SMS_MAX_II_FACTOR \
150 PARAM_VALUE (PARAM_SMS_MAX_II_FACTOR)
151 #define SMS_DFA_HISTORY \
152 PARAM_VALUE (PARAM_SMS_DFA_HISTORY)
153 #define SMS_LOOP_AVERAGE_COUNT_THRESHOLD \
154 PARAM_VALUE (PARAM_SMS_LOOP_AVERAGE_COUNT_THRESHOLD)
155 #define INTEGER_SHARE_LIMIT \
156 PARAM_VALUE (PARAM_INTEGER_SHARE_LIMIT)
157 #define MAX_LAST_VALUE_RTL \
158 PARAM_VALUE (PARAM_MAX_LAST_VALUE_RTL)
159 #define MIN_VIRTUAL_MAPPINGS \
160 PARAM_VALUE (PARAM_MIN_VIRTUAL_MAPPINGS)
161 #define VIRTUAL_MAPPINGS_TO_SYMS_RATIO \
162 PARAM_VALUE (PARAM_VIRTUAL_MAPPINGS_TO_SYMS_RATIO)
163 #define MAX_FIELDS_FOR_FIELD_SENSITIVE \
164 ((size_t) PARAM_VALUE (PARAM_MAX_FIELDS_FOR_FIELD_SENSITIVE))
165 #define MAX_SCHED_READY_INSNS \
166 PARAM_VALUE (PARAM_MAX_SCHED_READY_INSNS)
167 #define PREFETCH_LATENCY \
168 PARAM_VALUE (PARAM_PREFETCH_LATENCY)
169 #define SIMULTANEOUS_PREFETCHES \
170 PARAM_VALUE (PARAM_SIMULTANEOUS_PREFETCHES)
171 #define L1_CACHE_SIZE \
172 PARAM_VALUE (PARAM_L1_CACHE_SIZE)
173 #define L1_CACHE_LINE_SIZE \
174 PARAM_VALUE (PARAM_L1_CACHE_LINE_SIZE)
175 #define L2_CACHE_SIZE \
176 PARAM_VALUE (PARAM_L2_CACHE_SIZE)
177 #define USE_CANONICAL_TYPES \
178 PARAM_VALUE (PARAM_USE_CANONICAL_TYPES)
179 #define IRA_MAX_LOOPS_NUM \
180 PARAM_VALUE (PARAM_IRA_MAX_LOOPS_NUM)
181 #define IRA_MAX_CONFLICT_TABLE_SIZE \
182 PARAM_VALUE (PARAM_IRA_MAX_CONFLICT_TABLE_SIZE)
183 #define IRA_LOOP_RESERVED_REGS \
184 PARAM_VALUE (PARAM_IRA_LOOP_RESERVED_REGS)
185 #define SWITCH_CONVERSION_BRANCH_RATIO \
186 PARAM_VALUE (PARAM_SWITCH_CONVERSION_BRANCH_RATIO)
187 #define LOOP_INVARIANT_MAX_BBS_IN_LOOP \
188 PARAM_VALUE (PARAM_LOOP_INVARIANT_MAX_BBS_IN_LOOP)
189 #define SLP_MAX_INSNS_IN_BB \
190 PARAM_VALUE (PARAM_SLP_MAX_INSNS_IN_BB)
191 #define MIN_INSN_TO_PREFETCH_RATIO \
192 PARAM_VALUE (PARAM_MIN_INSN_TO_PREFETCH_RATIO)
193 #define PREFETCH_MIN_INSN_TO_MEM_RATIO \
194 PARAM_VALUE (PARAM_PREFETCH_MIN_INSN_TO_MEM_RATIO)
195 #define MIN_NONDEBUG_INSN_UID \
196 PARAM_VALUE (PARAM_MIN_NONDEBUG_INSN_UID)
197 #endif /* ! GCC_PARAMS_H */