build_string comments
[official-gcc.git] / gcc / params.c
blob793ddef924173e3057b2ade463dc14957953b6bf
1 /* params.c - Run-time parameters.
2 Copyright (C) 2001, 2003, 2004, 2005, 2007, 2008, 2009, 2010, 2011
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
11 version.
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
16 for more details.
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 #include "config.h"
23 #include "system.h"
24 #include "coretypes.h"
25 #include "common/common-target.h"
26 #include "params.h"
27 #include "diagnostic-core.h"
29 /* An array containing the compiler parameters and their current
30 values. */
32 param_info *compiler_params;
34 /* The number of entries in the table. */
35 static size_t num_compiler_params;
37 /* Whether the parameters have all been initialized and had their
38 default values determined. */
39 static bool params_finished;
41 static const param_info lang_independent_params[] = {
42 #define DEFPARAM(ENUM, OPTION, HELP, DEFAULT, MIN, MAX) \
43 { OPTION, DEFAULT, MIN, MAX, HELP },
44 #include "params.def"
45 #undef DEFPARAM
46 { NULL, 0, 0, 0, NULL }
49 /* Add the N PARAMS to the current list of compiler parameters. */
51 void
52 add_params (const param_info params[], size_t n)
54 gcc_assert (!params_finished);
56 /* Allocate enough space for the new parameters. */
57 compiler_params = XRESIZEVEC (param_info, compiler_params,
58 num_compiler_params + n);
59 /* Copy them into the table. */
60 memcpy (compiler_params + num_compiler_params,
61 params,
62 n * sizeof (param_info));
63 /* Keep track of how many parameters we have. */
64 num_compiler_params += n;
67 /* Add all parameters and default values that can be set in both the
68 driver and the compiler proper. */
70 void
71 global_init_params (void)
73 add_params (lang_independent_params, LAST_PARAM);
74 targetm_common.option_default_params ();
77 /* Note that all parameters have been added and all default values
78 set. */
80 void
81 finish_params (void)
83 params_finished = true;
86 /* Set the value of the parameter given by NUM to VALUE in PARAMS and
87 PARAMS_SET. If EXPLICIT_P, this is being set by the user;
88 otherwise it is being set implicitly by the compiler. */
90 static void
91 set_param_value_internal (compiler_param num, int value,
92 int *params, int *params_set,
93 bool explicit_p)
95 size_t i = (size_t) num;
97 gcc_assert (params_finished);
99 params[i] = value;
100 if (explicit_p)
101 params_set[i] = true;
104 /* Set the VALUE associated with the parameter given by NAME in PARAMS
105 and PARAMS_SET. */
107 void
108 set_param_value (const char *name, int value,
109 int *params, int *params_set)
111 size_t i;
113 /* Make sure nobody tries to set a parameter to an invalid value. */
114 gcc_assert (value != INVALID_PARAM_VAL);
116 /* Scan the parameter table to find a matching entry. */
117 for (i = 0; i < num_compiler_params; ++i)
118 if (strcmp (compiler_params[i].option, name) == 0)
120 if (value < compiler_params[i].min_value)
121 error ("minimum value of parameter %qs is %u",
122 compiler_params[i].option,
123 compiler_params[i].min_value);
124 else if (compiler_params[i].max_value > compiler_params[i].min_value
125 && value > compiler_params[i].max_value)
126 error ("maximum value of parameter %qs is %u",
127 compiler_params[i].option,
128 compiler_params[i].max_value);
129 else
130 set_param_value_internal ((compiler_param) i, value,
131 params, params_set, true);
132 return;
135 /* If we didn't find this parameter, issue an error message. */
136 error ("invalid parameter %qs", name);
139 /* Set the value of the parameter given by NUM to VALUE in PARAMS and
140 PARAMS_SET, implicitly, if it has not been set explicitly by the
141 user. */
143 void
144 maybe_set_param_value (compiler_param num, int value,
145 int *params, int *params_set)
147 if (!params_set[(int) num])
148 set_param_value_internal (num, value, params, params_set, false);
151 /* Set the default value of a parameter given by NUM to VALUE, before
152 option processing. */
154 void
155 set_default_param_value (compiler_param num, int value)
157 gcc_assert (!params_finished);
159 compiler_params[(int) num].default_value = value;
162 /* Return the default value of parameter NUM. */
165 default_param_value (compiler_param num)
167 return compiler_params[(int) num].default_value;
170 /* Initialize an array PARAMS with default values of the
171 parameters. */
173 void
174 init_param_values (int *params)
176 size_t i;
178 gcc_assert (params_finished);
180 for (i = 0; i < num_compiler_params; i++)
181 params[i] = compiler_params[i].default_value;
184 /* Return the current value of num_compiler_params, for the benefit of
185 plugins that use parameters as features. */
187 size_t
188 get_num_compiler_params (void)
190 return num_compiler_params;