]>
Commit | Line | Data |
---|---|---|
38cbfe40 RK |
1 | ------------------------------------------------------------------------------ |
2 | -- -- | |
3 | -- GNAT COMPILER COMPONENTS -- | |
4 | -- -- | |
5 | -- O P T -- | |
6 | -- -- | |
7 | -- S p e c -- | |
8 | -- -- | |
1b24ada5 | 9 | -- Copyright (C) 1992-2008, Free Software Foundation, Inc. -- |
38cbfe40 RK |
10 | -- -- |
11 | -- GNAT is free software; you can redistribute it and/or modify it under -- | |
12 | -- terms of the GNU General Public License as published by the Free Soft- -- | |
13 | -- ware Foundation; either version 2, or (at your option) any later ver- -- | |
14 | -- sion. GNAT is distributed in the hope that it will be useful, but WITH- -- | |
15 | -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY -- | |
16 | -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License -- | |
17 | -- for more details. You should have received a copy of the GNU General -- | |
18 | -- Public License distributed with GNAT; see file COPYING. If not, write -- | |
cb5fee25 KC |
19 | -- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, -- |
20 | -- Boston, MA 02110-1301, USA. -- | |
38cbfe40 RK |
21 | -- -- |
22 | -- As a special exception, if other files instantiate generics from this -- | |
23 | -- unit, or you link this unit with other files to produce an executable, -- | |
24 | -- this unit does not by itself cause the resulting executable to be -- | |
25 | -- covered by the GNU General Public License. This exception does not -- | |
26 | -- however invalidate any other reasons why the executable file might be -- | |
27 | -- covered by the GNU Public License. -- | |
28 | -- -- | |
29 | -- GNAT was originally developed by the GNAT team at New York University. -- | |
71ff80dc | 30 | -- Extensive contributions were provided by Ada Core Technologies Inc. -- |
38cbfe40 RK |
31 | -- -- |
32 | ------------------------------------------------------------------------------ | |
33 | ||
f81e6250 RD |
34 | -- This package contains global flags set by the initialization routine from |
35 | -- the command line and referenced throughout the compiler, the binder, or | |
36 | -- other GNAT tools. The comments indicate which options are used by which | |
383b2b42 | 37 | -- programs (GNAT, GNATBIND, GNATLINK, GNATMAKE, GPRMAKE, etc). |
38cbfe40 | 38 | |
395b5080 VC |
39 | -- Some flags are labelled "PROJECT MANAGER". These are used by tools that |
40 | -- use the Project Manager. These tools include gnatmake, gnatname, the gnat | |
41 | -- driver, gnatclean, gprbuild and gprclean. | |
42 | ||
67ce0d7e | 43 | with Debug; |
fbf5a39b AC |
44 | with Hostparm; use Hostparm; |
45 | with Types; use Types; | |
46 | ||
fbe627af | 47 | with System.Strings; use System.Strings; |
38cbfe40 RK |
48 | with System.WCh_Con; use System.WCh_Con; |
49 | ||
50 | package Opt is | |
51 | ||
52 | ---------------------------------------------- | |
53 | -- Settings of Modes for Current Processing -- | |
54 | ---------------------------------------------- | |
55 | ||
56 | -- The following mode values represent the current state of processing. | |
57 | -- The values set here are the default values. Unless otherwise noted, | |
dec55d76 | 58 | -- the value may be reset in Switch-? with an appropriate switch. In |
38cbfe40 RK |
59 | -- some cases, the values can also be modified by pragmas, and in the |
60 | -- case of some binder variables, Gnatbind.Scan_Bind_Arg may modify | |
61 | -- the default values. | |
62 | ||
63 | Ada_Bind_File : Boolean := True; | |
07fc65c4 | 64 | -- GNATBIND, GNATLINK |
38cbfe40 RK |
65 | -- Set True if binder file to be generated in Ada rather than C |
66 | ||
0ab80019 | 67 | type Ada_Version_Type is (Ada_83, Ada_95, Ada_05); |
383b2b42 | 68 | pragma Warnings (Off, Ada_Version_Type); |
0ab80019 AC |
69 | -- Versions of Ada for Ada_Version below. Note that these are ordered, |
70 | -- so that tests like Ada_Version >= Ada_95 are legitimate and useful. | |
383b2b42 RD |
71 | -- The Warnings_Off pragma stops warnings for Ada_Version >= Ada_05, |
72 | -- which we want to allow, so that things work OK when Ada_15 is added! | |
73 | -- This warning is now removed, so this pragma can be removed some time??? | |
0ab80019 | 74 | |
3f806915 | 75 | Ada_Version_Default : Ada_Version_Type := Ada_05; |
38cbfe40 | 76 | -- GNAT |
0ab80019 | 77 | -- Default Ada version if no switch given |
38cbfe40 | 78 | |
0ab80019 | 79 | Ada_Version : Ada_Version_Type := Ada_Version_Default; |
38cbfe40 | 80 | -- GNAT |
f81e6250 RD |
81 | -- Current Ada version for compiler, as set by configuration pragmas, |
82 | -- compiler switches, or implicitly (to Ada_Version_Runtime) when a | |
83 | -- predefined or internal file is compiled. | |
84 | ||
85 | Ada_Version_Explicit : Ada_Version_Type := Ada_Version_Default; | |
86 | -- GNAT | |
87 | -- Like Ada_Version, but does not get set implicitly for predefined | |
88 | -- or internal units, so it reflects the Ada version explicitly set | |
89 | -- using configuration pragmas or compiler switches (or if neither | |
90 | -- appears, it remains set to Ada_Version_Default). This is used in | |
91 | -- the rare cases (notably for pragmas Preelaborate_05 and Pure_05) | |
92 | -- where in the run-time we want the explicit version set. | |
38cbfe40 | 93 | |
c885d7a1 AC |
94 | Ada_Version_Runtime : Ada_Version_Type := Ada_05; |
95 | -- GNAT | |
f81e6250 RD |
96 | -- Ada version used to compile the runtime. Used to set Ada_Version (but |
97 | -- not Ada_Version_Explicit) when compiling predefined or internal units. | |
c885d7a1 | 98 | |
38cbfe40 | 99 | Ada_Final_Suffix : constant String := "final"; |
1f6a2b51 | 100 | Ada_Final_Name : String_Ptr := new String'("ada" & Ada_Final_Suffix); |
38cbfe40 RK |
101 | -- GNATBIND |
102 | -- The name of the procedure that performs the finalization at the end of | |
103 | -- execution. This variable may be modified by Gnatbind.Scan_Bind_Arg. | |
104 | ||
105 | Ada_Init_Suffix : constant String := "init"; | |
1f6a2b51 | 106 | Ada_Init_Name : String_Ptr := new String'("ada" & Ada_Init_Suffix); |
38cbfe40 RK |
107 | -- GNATBIND |
108 | -- The name of the procedure that performs initialization at the start | |
109 | -- of execution. This variable may be modified by Gnatbind.Scan_Bind_Arg. | |
110 | ||
111 | Ada_Main_Name_Suffix : constant String := "main"; | |
112 | -- GNATBIND | |
113 | -- The suffix for Ada_Main_Name. Defined as a constant here so that it | |
114 | -- can be referenced in a uniform manner to create either the default | |
115 | -- value of Ada_Main_Name (declared below), or the non-default name | |
116 | -- set by Gnatbind.Scan_Bind_Arg. | |
117 | ||
118 | Ada_Main_Name : String_Ptr := new String'("ada_" & Ada_Main_Name_Suffix); | |
119 | -- GNATBIND | |
120 | -- The name of the Ada package generated by the binder (when in Ada mode). | |
121 | -- This variable may be modified by Gnatbind.Scan_Bind_Arg. | |
122 | ||
123 | Address_Clause_Overlay_Warnings : Boolean := True; | |
124 | -- GNAT | |
125 | -- Set False to disable address clause warnings | |
126 | ||
0b6eb8e1 RD |
127 | Address_Is_Private : Boolean := False; |
128 | -- GNAT, GNATBIND | |
129 | -- Set True if package System has the line "type Address is private;" | |
130 | ||
38cbfe40 RK |
131 | All_Errors_Mode : Boolean := False; |
132 | -- GNAT | |
133 | -- Flag set to force display of multiple errors on a single line and | |
134 | -- also repeated error messages for references to undefined identifiers | |
4ecc031c | 135 | -- and certain other repeated error messages. Set by use of -gnatf. |
38cbfe40 RK |
136 | |
137 | All_Sources : Boolean := False; | |
138 | -- GNATBIND | |
139 | -- Set to True to require all source files to be present. This flag is | |
140 | -- directly modified by gnatmake to affect the shared binder routines. | |
141 | ||
142 | Alternate_Main_Name : String_Ptr := null; | |
07fc65c4 | 143 | -- GNATBIND |
38cbfe40 RK |
144 | -- Set to non null when Bind_Alternate_Main_Name is True. This value |
145 | -- is modified as needed by Gnatbind.Scan_Bind_Arg. | |
146 | ||
fbf5a39b AC |
147 | ASIS_Mode : Boolean := False; |
148 | -- GNAT | |
149 | -- Enable semantic checks and tree transformations that are important | |
150 | -- for ASIS but that are usually skipped if Operating_Mode is set to | |
151 | -- Check_Semantics. This flag does not have the corresponding option to set | |
152 | -- it ON. It is set ON when Tree_Output is set ON, it can also be set ON | |
153 | -- from the code of GNSA-based tool (a client may need to set ON the | |
154 | -- Back_Annotate_Rep_Info flag in this case. At the moment this does not | |
383b2b42 | 155 | -- make very much sense, because GNSA cannot do back annotation). |
fbf5a39b | 156 | |
2743d81d AC |
157 | Assertions_Enabled : Boolean := False; |
158 | -- GNAT | |
159 | -- Enable assertions made using pragma Assert | |
160 | ||
4351c21b AC |
161 | Assume_No_Invalid_Values : Boolean := True; |
162 | -- ??? true for now, enable by setting to false later | |
163 | -- GNAT | |
164 | -- Normallly, in accordance with (RM 13.9.1 (9-11)) the front end assumes | |
165 | -- that values could have invalid representations, unless it can clearly | |
166 | -- prove that the values are valid. If this switch is set (by -gnatB or by | |
167 | -- pragma Assume_No_Invalid_Values (Off)), then the compiler assumes values | |
168 | -- are valid and in range of their representations. | |
169 | ||
38cbfe40 RK |
170 | Back_Annotate_Rep_Info : Boolean := False; |
171 | -- GNAT | |
fbf5a39b AC |
172 | -- If set True, enables back annotation of representation information |
173 | -- by gigi, even in -gnatc mode. This is set True by the use of -gnatR | |
174 | -- (list representation information) or -gnatt (generate tree). It is | |
175 | -- also set true if certain Unchecked_Conversion instantiations require | |
176 | -- checking based on annotated values. | |
38cbfe40 RK |
177 | |
178 | Bind_Alternate_Main_Name : Boolean := False; | |
179 | -- GNATBIND | |
07fc65c4 GB |
180 | -- True if main should be called Alternate_Main_Name.all. |
181 | -- This variable may be set to True by Gnatbind.Scan_Bind_Arg. | |
38cbfe40 RK |
182 | |
183 | Bind_Main_Program : Boolean := True; | |
184 | -- GNATBIND | |
f81e6250 | 185 | -- Set to False if not binding main Ada program |
38cbfe40 RK |
186 | |
187 | Bind_For_Library : Boolean := False; | |
188 | -- GNATBIND | |
189 | -- Set to True if the binder needs to generate a file designed for | |
190 | -- building a library. May be set to True by Gnatbind.Scan_Bind_Arg. | |
191 | ||
7ffa903f | 192 | Bind_Only : Boolean := False; |
395b5080 | 193 | -- GNATMAKE, GPRMAKE, GPRBUILD |
7ffa903f VC |
194 | -- Set to True to skip compile and link steps |
195 | -- (except when Compile_Only and/or Link_Only are True). | |
196 | ||
fbf5a39b AC |
197 | Blank_Deleted_Lines : Boolean := False; |
198 | -- GNAT, GNATPREP | |
199 | -- Output empty lines for each line of preprocessed input that is deleted | |
200 | -- in the output, including preprocessor lines starting with a '#'. | |
201 | ||
38cbfe40 RK |
202 | Brief_Output : Boolean := False; |
203 | -- GNAT, GNATBIND | |
204 | -- Force brief error messages to standard error, even if verbose mode is | |
205 | -- set (so that main error messages go to standard output). | |
206 | ||
91b1417d AC |
207 | Build_Bind_And_Link_Full_Project : Boolean := False; |
208 | -- GNATMAKE | |
209 | -- Set to True to build, bind and link all the sources of a project file | |
210 | -- (switch -B) | |
211 | ||
38cbfe40 RK |
212 | Check_Object_Consistency : Boolean := False; |
213 | -- GNATBIND, GNATMAKE | |
214 | -- Set to True to check whether every object file is consistent with | |
07fc65c4 GB |
215 | -- its corresponding ada library information (ALI) file. An object |
216 | -- file is inconsistent with the corresponding ALI file if the object | |
217 | -- file does not exist or if it has an older time stamp than the ALI file. | |
38cbfe40 | 218 | -- Default above is for GNATBIND. GNATMAKE overrides this default to |
07fc65c4 GB |
219 | -- True (see Make.Initialize) since we normally do need to check source |
220 | -- consistencies in gnatmake. | |
38cbfe40 RK |
221 | |
222 | Check_Only : Boolean := False; | |
223 | -- GNATBIND | |
f81e6250 | 224 | -- Set to True to do checks only, no output of binder file |
38cbfe40 | 225 | |
ce4a6e84 RD |
226 | Check_Policy_List : Node_Id := Empty; |
227 | -- GNAT | |
228 | -- This points to the list of N_Pragma nodes for Check_Policy pragmas | |
229 | -- that are linked through the Next_Pragma fields, with the list being | |
230 | -- terminated by Empty. The order is most recently processed first. | |
231 | ||
38cbfe40 RK |
232 | Check_Readonly_Files : Boolean := False; |
233 | -- GNATMAKE | |
f81e6250 | 234 | -- Set to True to check readonly files during the make process |
38cbfe40 RK |
235 | |
236 | Check_Source_Files : Boolean := True; | |
07fc65c4 | 237 | -- GNATBIND, GNATMAKE |
38cbfe40 RK |
238 | -- Set to True to enable consistency checking for any source files that |
239 | -- are present (i.e. date must match the date in the library info file). | |
240 | -- Set to False for object file consistency check only. This flag is | |
241 | -- directly modified by gnatmake, to affect the shared binder routines. | |
242 | ||
243 | Check_Switches : Boolean := False; | |
395b5080 | 244 | -- GNATMAKE, GPRMAKE, GPBUILD |
f81e6250 | 245 | -- Set to True to check compiler options during the make process |
38cbfe40 RK |
246 | |
247 | Check_Unreferenced : Boolean := False; | |
248 | -- GNAT | |
07fc65c4 GB |
249 | -- Set to True to enable checking for unreferenced entities other |
250 | -- than formal parameters (for which see Check_Unreferenced_Formals) | |
251 | ||
252 | Check_Unreferenced_Formals : Boolean := False; | |
253 | -- GNAT | |
f81e6250 RD |
254 | -- Set True to check for unreferenced formals. This is turned on by |
255 | -- -gnatwa/wf/wu and turned off by -gnatwA/wF/wU. | |
38cbfe40 RK |
256 | |
257 | Check_Withs : Boolean := False; | |
258 | -- GNAT | |
259 | -- Set to True to enable checking for unused withs, and also the case | |
260 | -- of withing a package and using none of the entities in the package. | |
261 | ||
4ecc031c RD |
262 | Commands_To_Stdout : Boolean := False; |
263 | -- GNATMAKE | |
264 | -- True if echoed commands to be written to stdout instead of stderr | |
265 | ||
fbf5a39b AC |
266 | Comment_Deleted_Lines : Boolean := False; |
267 | -- GNATPREP | |
268 | -- True if source lines removed by the preprocessor should be commented | |
269 | -- in the output file. | |
38cbfe40 | 270 | |
fbf5a39b | 271 | Compile_Only : Boolean := False; |
395b5080 VC |
272 | -- GNATMAKE, GNATCLEAN, GPRMAKE, GPBUILD, GPRCLEAN |
273 | -- GNATMAKE, GPRMAKE, GPRMAKE: | |
274 | -- set to True to skip bind and link steps (except when Bind_Only is | |
275 | -- True). | |
276 | -- GNATCLEAN, GPRCLEAN: | |
277 | -- set to True to delete only the files produced by the compiler but not | |
278 | -- the library files or the executable files. | |
38cbfe40 RK |
279 | |
280 | Config_File : Boolean := True; | |
281 | -- GNAT | |
282 | -- Set to False to inhibit reading and processing of gnat.adc file | |
283 | ||
fbf5a39b | 284 | Config_File_Names : String_List_Access := null; |
38cbfe40 | 285 | -- GNAT |
fbf5a39b AC |
286 | -- Names of configuration pragmas files (given by switches -gnatec) |
287 | ||
288 | Configurable_Run_Time_Mode : Boolean := False; | |
289 | -- GNAT, GNATBIND | |
290 | -- Set True if the compiler is operating in configurable run-time mode. | |
291 | -- This happens if the flag Targparm.Configurable_Run_TimeMode_On_Target | |
292 | -- is set True, or if pragma No_Run_Time is used. See the spec of Rtsfind | |
293 | -- for details on the handling of the latter pragma. | |
38cbfe40 RK |
294 | |
295 | Constant_Condition_Warnings : Boolean := False; | |
296 | -- GNAT | |
297 | -- Set to True to activate warnings on constant conditions | |
298 | ||
07fc65c4 | 299 | Create_Mapping_File : Boolean := False; |
383b2b42 RD |
300 | -- GNATMAKE, GPRMAKE |
301 | -- Set to True (-C switch) to indicate that the compiler will be invoked | |
302 | -- with a mapping file (-gnatem compiler switch). | |
07fc65c4 | 303 | |
6e18b0e5 RD |
304 | Debug_Pragmas_Enabled : Boolean := False; |
305 | -- GNAT | |
306 | -- Enable debug statements from pragma Debug | |
307 | ||
38cbfe40 RK |
308 | subtype Debug_Level_Value is Nat range 0 .. 3; |
309 | Debugger_Level : Debug_Level_Value := 0; | |
310 | -- GNATBIND | |
0da2c8ac AC |
311 | -- The value given to the -g parameter. The default value for -g with |
312 | -- no value is 2. This is usually ignored by GNATBIND, except in the | |
313 | -- VMS version where it is passed as an argument to __gnat_initialize | |
314 | -- to trigger the activation of the remote debugging interface. | |
315 | -- Is this still true ??? | |
38cbfe40 RK |
316 | |
317 | Debug_Generated_Code : Boolean := False; | |
318 | -- GNAT | |
319 | -- Set True (-gnatD switch) to debug generated expanded code instead | |
320 | -- of the original source code. Causes debugging information to be | |
321 | -- written with respect to the generated code file that is written. | |
322 | ||
82c80734 RD |
323 | Default_Exit_Status : Int := 0; |
324 | -- GNATBIND | |
325 | -- Set the default exit status value. Set by the -Xnnn switch for the | |
326 | -- binder. | |
327 | ||
1f6a2b51 RD |
328 | Default_Stack_Size : Int := -1; |
329 | -- GNATBIND | |
330 | -- Set to default primary stack size in units of bytes. Set by | |
331 | -- the -dnnn switch for the binder. A value of -1 indicates that no | |
332 | -- default was set by the binder. | |
333 | ||
91b1417d AC |
334 | Default_Sec_Stack_Size : Int := -1; |
335 | -- GNATBIND | |
1f6a2b51 | 336 | -- Set to default secondary stack size in units of bytes. Set by |
91b1417d AC |
337 | -- the -Dnnn switch for the binder. A value of -1 indicates that no |
338 | -- default was set by the binder, and that the default should be the | |
339 | -- initial value of System.Secondary_Stack.Default_Secondary_Stack_Size. | |
340 | ||
0da2c8ac AC |
341 | Detect_Blocking : Boolean := False; |
342 | -- GNAT | |
343 | -- Set True to force the run time to raise Program_Error if calls to | |
344 | -- potentially blocking operations are detected from protected actions. | |
345 | ||
38cbfe40 | 346 | Display_Compilation_Progress : Boolean := False; |
395b5080 | 347 | -- GNATMAKE, GPRMAKE, GPRBUILD |
38cbfe40 | 348 | -- Set True (-d switch) to display information on progress while compiling |
0da2c8ac | 349 | -- files. Internal flag to be used in conjunction with an IDE (e.g GPS). |
38cbfe40 RK |
350 | |
351 | type Distribution_Stub_Mode_Type is | |
352 | -- GNAT | |
353 | (No_Stubs, | |
354 | -- Normal mode, no generation/compilation of distribution stubs | |
355 | ||
356 | Generate_Receiver_Stub_Body, | |
357 | -- The unit being compiled is the RCI body, and the compiler will | |
358 | -- generate the body for the receiver stubs and compile it. | |
359 | ||
360 | Generate_Caller_Stub_Body); | |
361 | -- The unit being compiled is the RCI spec, and the compiler will | |
362 | -- generate the body for the caller stubs and compile it. | |
363 | ||
364 | Distribution_Stub_Mode : Distribution_Stub_Mode_Type := No_Stubs; | |
365 | -- GNAT | |
366 | -- This enumeration variable indicates the five states of distribution | |
367 | -- annex stub generation/compilation. | |
368 | ||
369 | Do_Not_Execute : Boolean := False; | |
370 | -- GNATMAKE | |
371 | -- Set to True if no actual compilations should be undertaken. | |
372 | ||
4ecc031c RD |
373 | Dump_Source_Text : Boolean := False; |
374 | -- GNAT | |
375 | -- Set to True (by -gnatL) to dump source text intermingled with generated | |
376 | -- code. Effective only if either of Debug/Print_Generated_Code is true. | |
377 | ||
38cbfe40 RK |
378 | Dynamic_Elaboration_Checks : Boolean := False; |
379 | -- GNAT | |
380 | -- Set True for dynamic elaboration checking mode, as set by the -gnatE | |
381 | -- switch or by the use of pragma Elaboration_Checks (Dynamic). | |
382 | ||
81408d49 DR |
383 | Dynamic_Stack_Measurement : Boolean := False; |
384 | -- GNATBIND | |
385 | -- Set True to enable dynamic stack measurement (-u flag for gnatbind) | |
386 | ||
387 | Dynamic_Stack_Measurement_Array_Size : Nat := 100; | |
388 | -- GNATBIND | |
389 | -- Number of measurements we want to store during dynamic stack analysis. | |
390 | -- When the buffer is full, non-storable results will be output on the fly. | |
391 | -- The value is relevant only if Dynamic_Stack_Measurement is set. Set | |
392 | -- by processing of -u flag for gnatbind. | |
393 | ||
38cbfe40 RK |
394 | Elab_Dependency_Output : Boolean := False; |
395 | -- GNATBIND | |
396 | -- Set to True to output complete list of elaboration constraints | |
397 | ||
398 | Elab_Order_Output : Boolean := False; | |
399 | -- GNATBIND | |
400 | -- Set to True to output chosen elaboration order | |
401 | ||
402 | Elab_Warnings : Boolean := False; | |
403 | -- GNAT | |
404 | -- Set to True to generate full elaboration warnings (-gnatwl) | |
405 | ||
07fc65c4 GB |
406 | Enable_Overflow_Checks : Boolean := False; |
407 | -- GNAT | |
408 | -- Set to True if -gnato (enable overflow checks) switch is set, | |
409 | -- but not -gnatp. | |
410 | ||
4ecc031c RD |
411 | Error_Msg_Line_Length : Nat := 0; |
412 | -- GNAT | |
413 | -- Records the error message line length limit. If this is set to zero, | |
414 | -- then we get the old style behavior, in which each call to the error | |
415 | -- message routines generates one line of output as a separate message. | |
416 | -- If it is set to a non-zero value, then continuation lines are folded | |
417 | -- to make a single long message, and then this message is split up into | |
ce4a6e84 | 418 | -- multiple lines not exceeding the specified length. Set by -gnatj=nn. |
4ecc031c | 419 | |
fbf5a39b AC |
420 | Exception_Locations_Suppressed : Boolean := False; |
421 | -- GNAT | |
422 | -- This flag is set True if a Suppress_Exception_Locations configuration | |
423 | -- pragma is currently active. | |
424 | ||
425 | type Exception_Mechanism_Type is | |
426 | -- Determines the handling of exceptions. See Exp_Ch11 for details | |
427 | -- | |
428 | (Front_End_Setjmp_Longjmp_Exceptions, | |
429 | -- Exceptions use setjmp/longjmp generated explicitly by the | |
430 | -- front end (this includes gigi or other equivalent parts of | |
431 | -- the code generator). AT END handlers are converted into | |
432 | -- exception handlers by the front end in this mode. | |
433 | ||
6e18b0e5 | 434 | Back_End_Exceptions); |
fbf5a39b AC |
435 | -- Exceptions are handled by the back end. The front end simply |
436 | -- generates the handlers as they appear in the source, and AT | |
437 | -- END handlers are left untouched (they are not converted into | |
6e18b0e5 | 438 | -- exception handlers when operating in this mode. |
07fc65c4 GB |
439 | pragma Convention (C, Exception_Mechanism_Type); |
440 | ||
fbf5a39b AC |
441 | Exception_Mechanism : Exception_Mechanism_Type := |
442 | Front_End_Setjmp_Longjmp_Exceptions; | |
38cbfe40 RK |
443 | -- GNAT |
444 | -- Set to the appropriate value depending on the default as given in | |
6e18b0e5 RD |
445 | -- system.ads (ZCX_By_Default, GCC_ZCX_Support). |
446 | -- The C convention is there to make this variable accessible to gigi. | |
38cbfe40 RK |
447 | |
448 | Exception_Tracebacks : Boolean := False; | |
449 | -- GNATBIND | |
450 | -- Set to True to store tracebacks in exception occurrences (-E) | |
451 | ||
452 | Extensions_Allowed : Boolean := False; | |
453 | -- GNAT | |
07fc65c4 | 454 | -- Set to True by switch -gnatX if GNAT specific language extensions |
a9a5b8ac RD |
455 | -- are allowed. For example, the use of 'Constrained with objects of |
456 | -- generic types is a GNAT extension. | |
38cbfe40 RK |
457 | |
458 | type External_Casing_Type is ( | |
459 | As_Is, -- External names cased as they appear in the Ada source | |
460 | Uppercase, -- External names forced to all uppercase letters | |
461 | Lowercase); -- External names forced to all lowercase letters | |
462 | ||
463 | External_Name_Imp_Casing : External_Casing_Type := Lowercase; | |
07fc65c4 GB |
464 | -- GNAT |
465 | -- The setting of this flag determines the casing of external names | |
38cbfe40 RK |
466 | -- when the name is implicitly derived from an entity name (i.e. either |
467 | -- no explicit External_Name or Link_Name argument is used, or, in the | |
468 | -- case of extended DEC pragmas, the external name is given using an | |
469 | -- identifier. The As_Is setting is not permitted here (since this would | |
470 | -- create Ada source programs that were case sensitive). | |
471 | ||
472 | External_Name_Exp_Casing : External_Casing_Type := As_Is; | |
07fc65c4 GB |
473 | -- GNAT |
474 | -- The setting of this flag determines the casing of an external name | |
38cbfe40 RK |
475 | -- specified explicitly with a string literal. As_Is means the string |
476 | -- literal is used as given with no modification to the casing. If | |
477 | -- Lowercase or Uppercase is set, then the string is forced to all | |
478 | -- lowercase or all uppercase letters as appropriate. Note that this | |
479 | -- setting has no effect if the external name is given using an identifier | |
480 | -- in the case of extended DEC import/export pragmas (in this case the | |
481 | -- casing is controlled by External_Name_Imp_Casing), and also has no | |
482 | -- effect if an explicit Link_Name is supplied (a link name is always | |
483 | -- used exactly as given). | |
484 | ||
5950a3ac AC |
485 | External_Unit_Compilation_Allowed : Boolean := False; |
486 | -- GNATMAKE | |
487 | -- When True (set by gnatmake switch -x), allow compilation of sources | |
488 | -- that are not part of any project file. | |
489 | ||
395b5080 VC |
490 | Fast_Math : Boolean := False; |
491 | -- GNAT | |
492 | -- Indicates the current setting of Fast_Math mode, as set by the use | |
493 | -- of a Fast_Math pragma (set on by Fast_Math (On)). | |
494 | ||
38cbfe40 RK |
495 | Float_Format : Character := ' '; |
496 | -- GNAT | |
497 | -- A non-blank value indicates that a Float_Format pragma has been | |
498 | -- processed, in which case this variable is set to 'I' for IEEE or | |
499 | -- to 'V' for VAX. The setting of 'V' is only possible on OpenVMS | |
500 | -- versions of GNAT. | |
501 | ||
502 | Float_Format_Long : Character := ' '; | |
503 | -- GNAT | |
504 | -- A non-blank value indicates that a Long_Float pragma has been | |
505 | -- processed (this pragma is recognized only in OpenVMS versions | |
506 | -- of GNAT), in which case this variable is set to D or G for | |
507 | -- D_Float or G_Float. | |
508 | ||
509 | Force_ALI_Tree_File : Boolean := False; | |
510 | -- GNAT | |
07fc65c4 | 511 | -- Force generation of ALI file even if errors are encountered. |
38cbfe40 RK |
512 | -- Also forces generation of tree file if -gnatt is also set. |
513 | ||
fbf5a39b AC |
514 | Force_Checking_Of_Elaboration_Flags : Boolean := False; |
515 | -- GNATBIND | |
516 | -- True if binding with forced checking of the elaboration flags | |
517 | -- (-F switch set). | |
518 | ||
38cbfe40 | 519 | Force_Compilations : Boolean := False; |
395b5080 | 520 | -- GNATMAKE, GPRMAKE, GPRBUILD |
38cbfe40 RK |
521 | -- Set to force recompilations even when the objects are up-to-date. |
522 | ||
fbf5a39b | 523 | Full_Path_Name_For_Brief_Errors : Boolean := False; |
395b5080 | 524 | -- PROJECT MANAGER |
fbf5a39b AC |
525 | -- When True, in Brief_Output mode, each error message line |
526 | -- will start with the full path name of the source. | |
527 | -- When False, only the file name without directory information | |
528 | -- is used. | |
529 | ||
38cbfe40 RK |
530 | Full_List : Boolean := False; |
531 | -- GNAT | |
532 | -- Set True to generate full source listing with embedded errors | |
533 | ||
4ecc031c RD |
534 | Full_List_File_Name : String_Ptr := null; |
535 | -- GNAT | |
536 | -- Set to file name to generate full source listing to named file (or if | |
537 | -- the name is of the form .xxx, then to name.xxx where name is the source | |
538 | -- file name with extension stripped. | |
539 | ||
a037f912 VC |
540 | Generate_Processed_File : Boolean := False; |
541 | -- GNAT | |
542 | -- True when switch -gnateG is used. When True, create in a file | |
543 | -- <source>.prep, if the source is preprocessed. | |
544 | ||
fbe627af RD |
545 | Generating_Code : Boolean := False; |
546 | -- GNAT | |
547 | -- True if the frontend finished its work and has called the backend to | |
dec55d76 | 548 | -- process the tree and generate the object file. |
9bc43c53 | 549 | |
38cbfe40 | 550 | Global_Discard_Names : Boolean := False; |
fbf5a39b | 551 | -- GNAT, GNATBIND |
fbe627af RD |
552 | -- True if a pragma Discard_Names appeared as a configuration pragma for |
553 | -- the current compilation unit. | |
38cbfe40 RK |
554 | |
555 | GNAT_Mode : Boolean := False; | |
556 | -- GNAT | |
07fc65c4 | 557 | -- True if compiling in GNAT system mode (-gnatg switch) |
38cbfe40 RK |
558 | |
559 | HLO_Active : Boolean := False; | |
560 | -- GNAT | |
07fc65c4 | 561 | -- True if High Level Optimizer is activated (-gnatH switch) |
38cbfe40 | 562 | |
38cbfe40 RK |
563 | Identifier_Character_Set : Character; |
564 | -- GNAT | |
565 | -- This variable indicates the character set to be used for identifiers. | |
566 | -- The possible settings are: | |
07fc65c4 GB |
567 | -- '1' Latin-5 (ISO-8859-1) |
568 | -- '2' Latin-5 (ISO-8859-2) | |
569 | -- '3' Latin-5 (ISO-8859-3) | |
570 | -- '4' Latin-5 (ISO-8859-4) | |
571 | -- '5' Latin-5 (ISO-8859-5, Cyrillic) | |
572 | -- '9' Latin-5 (ISO-8859-9) | |
38cbfe40 RK |
573 | -- 'p' PC (US, IBM page 437) |
574 | -- '8' PC (European, IBM page 850) | |
575 | -- 'f' Full upper set (all distinct) | |
0ab80019 | 576 | -- 'n' No upper characters (Ada 83 rules) |
38cbfe40 RK |
577 | -- 'w' Latin-1 plus wide characters allowed in identifiers |
578 | -- | |
579 | -- The setting affects the set of letters allowed in identifiers and the | |
580 | -- upper/lower case equivalences. It does not affect the interpretation of | |
581 | -- character and string literals, which are always stored using the actual | |
582 | -- coding in the source program. This variable is initialized to the | |
583 | -- default value appropriate to the system (in Osint.Initialize), and then | |
584 | -- reset if a command line switch is used to change the setting. | |
585 | ||
c690a2ec RD |
586 | Ignore_Rep_Clauses : Boolean := False; |
587 | -- GNAT | |
588 | -- Set True to ignore all representation clauses. Useful when compiling | |
589 | -- code from foreign compilers for checking or ASIS purposes. Can be | |
590 | -- set True by use of -gnatI. | |
591 | ||
592 | Implementation_Unit_Warnings : Boolean := True; | |
593 | -- GNAT | |
594 | -- Set True to active warnings for use of implementation internal units. | |
595 | -- Can be controlled by use of -gnatwi/-gnatwI. | |
596 | ||
597 | Implicit_Packing : Boolean := False; | |
598 | -- GNAT | |
599 | -- If set True, then a Size attribute clause on an array is allowed to | |
600 | -- cause implicit packing instead of generating an error message. Set by | |
601 | -- use of pragma Implicit_Packing. | |
602 | ||
38cbfe40 RK |
603 | Ineffective_Inline_Warnings : Boolean := False; |
604 | -- GNAT | |
605 | -- Set True to activate warnings if front-end inlining (-gnatN) is not | |
606 | -- able to actually inline a particular call (or all calls). Can be | |
607 | -- controlled by use of -gnatwp/-gnatwP. | |
608 | ||
609 | Init_Or_Norm_Scalars : Boolean := False; | |
fbf5a39b | 610 | -- GNAT, GANTBIND |
38cbfe40 RK |
611 | -- Set True if a pragma Initialize_Scalars applies to the current unit. |
612 | -- Also set True if a pragma Normalize_Scalars applies. | |
613 | ||
614 | Initialize_Scalars : Boolean := False; | |
615 | -- GNAT | |
616 | -- Set True if a pragma Initialize_Scalars applies to the current unit. | |
617 | -- Note that Init_Or_Norm_Scalars is also set to True if this is True. | |
618 | ||
fbf5a39b AC |
619 | Initialize_Scalars_Mode1 : Character := 'I'; |
620 | Initialize_Scalars_Mode2 : Character := 'N'; | |
38cbfe40 | 621 | -- GNATBIND |
fbf5a39b AC |
622 | -- Set to two characters from -S switch (IN/LO/HI/EV/xx). The default |
623 | -- is IN (invalid values), used if no -S switch is used. | |
38cbfe40 RK |
624 | |
625 | Inline_Active : Boolean := False; | |
626 | -- GNAT | |
627 | -- Set True to activate pragma Inline processing across modules. Default | |
628 | -- for now is not to inline across module boundaries. | |
629 | ||
fbf5a39b AC |
630 | Interface_Library_Unit : Boolean := False; |
631 | -- GNATBIND | |
632 | -- Set to True to indicate that at least one ALI file is an interface ALI: | |
633 | -- then elaboration flag checks are to be generated in the binder | |
634 | -- generated file. | |
635 | ||
67ce0d7e RD |
636 | Inspector_Mode : Boolean renames Debug.Debug_Flag_Dot_II; |
637 | -- GNAT | |
638 | -- True if compiling in inspector mode (-gnatd.I switch). | |
639 | -- Only relevant when VM_Target /= None. The compiler will attempt to | |
640 | -- generate code even in case of unsupported construct, so that the byte | |
641 | -- code can be used by static analysis tools. | |
642 | ||
ce4a6e84 RD |
643 | Invalid_Value_Used : Boolean := False; |
644 | -- GNAT | |
645 | -- Set True if a valid Invalid_Value attribute is encountered | |
646 | ||
395b5080 VC |
647 | Follow_Links_For_Files : Boolean := False; |
648 | -- PROJECT MANAGER | |
7324bf49 | 649 | -- Set to True (-eL) to process the project files in trusted mode |
395b5080 VC |
650 | -- If Follow_Links is False, it is assumed that the project doesn't contain |
651 | -- any file duplicated through symbolic links (although the latter are | |
652 | -- still valid if they point to a file which is outside of the project), | |
653 | -- and that no directory has a name which is a valid source name. | |
654 | ||
655 | Follow_Links_For_Dirs : Boolean := True; | |
656 | -- PROJECT MANAGER | |
657 | -- Whether directories can be links in this project, and therefore | |
658 | -- additional system calls should be performed to ensure we always see the | |
659 | -- same full name for each directory. | |
7324bf49 | 660 | |
38cbfe40 RK |
661 | Front_End_Inlining : Boolean := False; |
662 | -- GNAT | |
f81e6250 | 663 | -- Set True to activate inlining by front-end expansion |
38cbfe40 RK |
664 | |
665 | Inline_Processing_Required : Boolean := False; | |
666 | -- GNAT | |
667 | -- Set True if inline processing is required. Inline processing is | |
668 | -- required if an active Inline pragma is processed. The flag is set | |
669 | -- for a pragma Inline or Inline_Always that is actually active. | |
670 | ||
671 | In_Place_Mode : Boolean := False; | |
672 | -- GNATMAKE | |
dec55d76 | 673 | -- Set True to store ALI and object files in place i.e. in the object |
38cbfe40 RK |
674 | -- directory if these files already exist or in the source directory |
675 | -- if not. | |
676 | ||
677 | Keep_Going : Boolean := False; | |
395b5080 | 678 | -- GNATMAKE, GPRMAKE, GPRBUILD |
383b2b42 | 679 | -- When True signals to ignore compilation errors and keep |
38cbfe40 RK |
680 | -- processing sources until there is no more work. |
681 | ||
15ce9ca2 AC |
682 | Keep_Temporary_Files : Boolean := False; |
683 | -- GNATCMD | |
684 | -- When True the temporary files created by the GNAT driver are not | |
685 | -- deleted. Set by switch -dn or qualifier /KEEP_TEMPORARY_FILES. | |
686 | ||
d409ec50 HK |
687 | Leap_Seconds_Support : Boolean := False; |
688 | -- GNATBIND | |
689 | -- Set to True to enable leap seconds support in Ada.Calendar and its | |
690 | -- children. | |
691 | ||
7ffa903f | 692 | Link_Only : Boolean := False; |
395b5080 | 693 | -- GNATMAKE, GPRMAKE, GPRBUILD |
7ffa903f VC |
694 | -- Set to True to skip compile and bind steps |
695 | -- (except when Bind_Only is set to True). | |
696 | ||
07fc65c4 GB |
697 | List_Restrictions : Boolean := False; |
698 | -- GNATBIND | |
699 | -- Set to True to list restrictions pragmas that could apply to partition | |
700 | ||
38cbfe40 RK |
701 | List_Units : Boolean := False; |
702 | -- GNAT | |
07fc65c4 | 703 | -- List units in the active library for a compilation (-gnatu switch) |
38cbfe40 | 704 | |
fbe627af RD |
705 | List_Closure : Boolean := False; |
706 | -- GNATBIND | |
707 | -- List all sources in the closure of a main (-R gnatbind switch) | |
708 | ||
38cbfe40 RK |
709 | List_Dependencies : Boolean := False; |
710 | -- GNATMAKE | |
711 | -- When True gnatmake verifies that the objects are up to date and | |
07fc65c4 GB |
712 | -- outputs the list of object dependencies (-M switch). |
713 | -- Output depends if -a switch is used or not. | |
714 | -- This list can be used directly in a Makefile. | |
38cbfe40 RK |
715 | |
716 | List_Representation_Info : Int range 0 .. 3 := 0; | |
717 | -- GNAT | |
07fc65c4 | 718 | -- Set non-zero by -gnatR switch to list representation information. |
38cbfe40 RK |
719 | -- The settings are as follows: |
720 | -- | |
721 | -- 0 = no listing of representation information (default as above) | |
722 | -- 1 = list rep info for user defined record and array types | |
723 | -- 2 = list rep info for all user defined types and objects | |
724 | -- 3 = like 2, but variable fields are decoded symbolically | |
725 | ||
07fc65c4 GB |
726 | List_Representation_Info_To_File : Boolean := False; |
727 | -- GNAT | |
728 | -- Set true by -gnatRs switch. Causes information from -gnatR/1/2/3 | |
729 | -- to be written to file.rep (where file is the name of the source | |
730 | -- file) instead of stdout. For example, if file x.adb is compiled | |
731 | -- using -gnatR2s then representation info is written to x.adb.ref. | |
732 | ||
fbf5a39b AC |
733 | List_Representation_Info_Mechanisms : Boolean := False; |
734 | -- GNAT | |
735 | -- Set true by -gnatRm switch. Causes information on mechanisms to | |
736 | -- be included in the representation output information. | |
737 | ||
738 | List_Preprocessing_Symbols : Boolean := False; | |
739 | -- GNAT, GNATPREP | |
740 | -- Set to True if symbols for preprocessing a source are to be listed | |
741 | -- before preprocessing occurs. Set to True by switch -s of gnatprep | |
742 | -- or -s in preprocessing data file for the compiler. | |
743 | ||
fbe627af | 744 | type Create_Repinfo_File_Proc is access procedure (Src : String); |
4ecc031c RD |
745 | type Write_Repinfo_Line_Proc is access procedure (Info : String); |
746 | type Close_Repinfo_File_Proc is access procedure; | |
07fc65c4 GB |
747 | -- Types used for procedure addresses below |
748 | ||
4ecc031c RD |
749 | Create_Repinfo_File_Access : Create_Repinfo_File_Proc := null; |
750 | Write_Repinfo_Line_Access : Write_Repinfo_Line_Proc := null; | |
751 | Close_Repinfo_File_Access : Close_Repinfo_File_Proc := null; | |
07fc65c4 GB |
752 | -- GNAT |
753 | -- These three locations are left null when operating in non-compiler | |
754 | -- (e.g. ASIS mode), but when operating in compiler mode, they are | |
4ecc031c | 755 | -- set to point to the three corresponding procedures in Osint-C. The |
07fc65c4 GB |
756 | -- reason for this slightly strange interface is to prevent Repinfo |
757 | -- from dragging in Osint in ASIS mode, which would include a lot of | |
758 | -- unwanted units in the ASIS build. | |
759 | ||
4ecc031c RD |
760 | type Create_List_File_Proc is access procedure (S : String); |
761 | type Write_List_Info_Proc is access procedure (S : String); | |
762 | type Close_List_File_Proc is access procedure; | |
763 | -- Types used for procedure addresses below | |
764 | ||
765 | Create_List_File_Access : Create_List_File_Proc := null; | |
766 | Write_List_Info_Access : Write_List_Info_Proc := null; | |
767 | Close_List_File_Access : Close_List_File_Proc := null; | |
768 | -- GNAT | |
769 | -- These three locations are left null when operating in non-compiler | |
770 | -- (e.g. from the binder), but when operating in compiler mode, they are | |
771 | -- set to point to the three corresponding procedures in Osint-C. The | |
772 | -- reason for this slightly strange interface is to prevent Repinfo | |
773 | -- from dragging in Osint-C in the binder, which would include unwanted | |
774 | -- units in the binder. | |
775 | ||
38cbfe40 | 776 | Locking_Policy : Character := ' '; |
fbf5a39b | 777 | -- GNAT, GNATBIND |
38cbfe40 RK |
778 | -- Set to ' ' for the default case (no locking policy specified). |
779 | -- Reset to first character (uppercase) of locking policy name if a | |
780 | -- valid pragma Locking_Policy is encountered. | |
781 | ||
fbf5a39b AC |
782 | Locking_Policy_Sloc : Source_Ptr := No_Location; |
783 | -- GNAT, GNATBIND | |
784 | -- Remember location of previous Locking_Policy pragma. This is used | |
785 | -- for inconsistency error messages. A value of System_Location is | |
786 | -- used if the policy is set in package System. | |
787 | ||
38cbfe40 | 788 | Look_In_Primary_Dir : Boolean := True; |
fbf5a39b | 789 | -- GNAT, GNATBIND, GNATMAKE, GNATCLEAN |
38cbfe40 RK |
790 | -- Set to False if a -I- was present on the command line. |
791 | -- When True we are allowed to look in the primary directory to locate | |
792 | -- other source or library files. | |
793 | ||
fbf5a39b AC |
794 | Make_Steps : Boolean := False; |
795 | -- GNATMAKE | |
796 | -- Set to True when either Compile_Only, Bind_Only or Link_Only is | |
797 | -- set to True. | |
798 | ||
aa720a54 AC |
799 | Main_Index : Int := 0; |
800 | -- GNATMAKE | |
801 | -- This is set to non-zero by gnatmake switch -eInnn to indicate that | |
802 | -- the main program is the nnn unit in a multi-unit source file. | |
803 | ||
6510f4c9 GB |
804 | Mapping_File_Name : String_Ptr := null; |
805 | -- GNAT | |
806 | -- File name of mapping between unit names, file names and path names. | |
807 | -- (given by switch -gnatem) | |
808 | ||
38cbfe40 RK |
809 | Maximum_Errors : Int := 9999; |
810 | -- GNAT, GNATBIND | |
fbf5a39b AC |
811 | -- Maximum default number of errors before compilation is terminated. |
812 | -- Can be overridden using -gnatm (GNAT) or -m (GNATBIND) switch. | |
38cbfe40 RK |
813 | |
814 | Maximum_File_Name_Length : Int; | |
815 | -- GNAT, GNATBIND | |
816 | -- Maximum number of characters allowed in a file name, not counting the | |
817 | -- extension, as set by the appropriate switch. If no switch is given, | |
818 | -- then this value is initialized by Osint to the appropriate value. | |
819 | ||
820 | Maximum_Processes : Positive := 1; | |
395b5080 | 821 | -- GNATMAKE, GPRMAKE, GPRBUILD |
38cbfe40 RK |
822 | -- Maximum number of processes that should be spawned to carry out |
823 | -- compilations. | |
824 | ||
825 | Minimal_Recompilation : Boolean := False; | |
826 | -- GNATMAKE | |
f81e6250 | 827 | -- Set to True if minimal recompilation mode requested |
38cbfe40 | 828 | |
fbe627af RD |
829 | Special_Exception_Package_Used : Boolean := False; |
830 | -- GNAT | |
831 | -- Set to True if either of the unit GNAT.Most_Recent_Exception or | |
832 | -- GNAT.Exception_Traces is with'ed. Used to inhibit transformation of | |
833 | -- local raise statements into gotos in the presence of either package. | |
834 | ||
2820d220 AC |
835 | Multiple_Unit_Index : Int; |
836 | -- GNAT | |
837 | -- This is set non-zero if the current unit is being compiled in multiple | |
838 | -- unit per file mode, meaning that the current unit is selected from the | |
839 | -- sequence of units in the current source file, using the value stored | |
840 | -- in this variable (e.g. 2 = select second unit in file). A value of | |
841 | -- zero indicates that we are in normal (one unit per file) mode. | |
842 | ||
38cbfe40 RK |
843 | No_Main_Subprogram : Boolean := False; |
844 | -- GNATMAKE, GNATBIND | |
845 | -- Set to True if compilation/binding of a program without main | |
846 | -- subprogram requested. | |
847 | ||
fbf5a39b AC |
848 | No_Run_Time_Mode : Boolean := False; |
849 | -- GNAT, GNATBIND | |
850 | -- This flag is set True if a No_Run_Time pragma is encountered. See | |
851 | -- spec of Rtsfind for a full description of handling of this pragma. | |
852 | ||
8a6a52dc AC |
853 | No_Stdinc : Boolean := False; |
854 | -- GNAT, GNATBIND, GNATMAKE, GNATFIND, GNATXREF | |
855 | -- Set to True if no default source search dirs added to search list | |
856 | ||
857 | No_Stdlib : Boolean := False; | |
858 | -- GNATMAKE, GNATBIND, GNATFIND, GNATXREF | |
859 | -- Set to True if no default library search dirs added to search list | |
860 | ||
861 | No_Strict_Aliasing : Boolean := False; | |
862 | -- GNAT | |
863 | -- Set True if pragma No_Strict_Aliasing with no parameters encountered | |
864 | ||
38cbfe40 | 865 | Normalize_Scalars : Boolean := False; |
fbf5a39b | 866 | -- GNAT, GNATBIND |
38cbfe40 RK |
867 | -- Set True if a pragma Normalize_Scalars applies to the current unit. |
868 | -- Note that Init_Or_Norm_Scalars is also set to True if this is True. | |
869 | ||
fbf5a39b AC |
870 | Object_Directory_Present : Boolean := False; |
871 | -- GNATMAKE | |
872 | -- Set to True when an object directory is specified with option -D | |
38cbfe40 RK |
873 | |
874 | type Operating_Mode_Type is (Check_Syntax, Check_Semantics, Generate_Code); | |
875 | Operating_Mode : Operating_Mode_Type := Generate_Code; | |
876 | -- GNAT | |
877 | -- Indicates the operating mode of the compiler. The default is generate | |
878 | -- code, which runs the parser, semantics and backend. Switches can be | |
879 | -- used to set syntax checking only mode, or syntax and semantics checking | |
880 | -- only mode. Operating_Mode can also be modified as a result of detecting | |
fbf5a39b AC |
881 | -- errors during the compilation process. In particular if any serious |
882 | -- error is detected then this flag is reset from Generate_Code to | |
883 | -- Check_Semantics after generating an error message. | |
884 | ||
1b24ada5 | 885 | Optimize_Alignment : Character := 'O'; |
dec55d76 | 886 | -- Setting of Optimize_Alignment, set to T/S/O for time/space/off. Can |
1b24ada5 RD |
887 | -- be modified by use of pragma Optimize_Alignment. |
888 | ||
ce4a6e84 RD |
889 | Optimize_Alignment_Local : Boolean := False; |
890 | -- Set True if Optimize_Alignment mode is set by a local configuration | |
891 | -- pragma that overrides the gnat.adc (or other configuration file) default | |
892 | -- so that the unit is not dependent on the default setting. Also always | |
893 | -- set True for internal units, since these always have a default setting | |
894 | -- of Optimize_Alignment (Off) that is enforced (essentially equivalent to | |
895 | -- them all having such an explicit pragma in each unit). | |
896 | ||
fbf5a39b AC |
897 | Original_Operating_Mode : Operating_Mode_Type := Generate_Code; |
898 | -- GNAT | |
899 | -- Indicates the original operating mode of the compiler as set by | |
900 | -- compiler options. This is identical to Operating_Mode except that | |
901 | -- this is not affected by errors. | |
902 | ||
903 | Optimization_Level : Int; | |
904 | pragma Import (C, Optimization_Level, "optimize"); | |
ce4a6e84 | 905 | -- Constant reflecting the optimization level (0,1,2,3 for -O0,-O1,-O2,-O3) |
38cbfe40 RK |
906 | |
907 | Output_File_Name_Present : Boolean := False; | |
383b2b42 | 908 | -- GNATBIND, GNAT, GNATMAKE, GPRMAKE |
38cbfe40 | 909 | -- Set to True when the output C file name is given with option -o |
07fc65c4 GB |
910 | -- for GNATBIND, when the object file name is given with option |
911 | -- -gnatO for GNAT or when the executable is given with option -o | |
383b2b42 | 912 | -- for GNATMAKE or GPRMAKE. |
38cbfe40 RK |
913 | |
914 | Output_Linker_Option_List : Boolean := False; | |
915 | -- GNATBIND | |
916 | -- True if output of list of linker options is requested (-K switch set) | |
917 | ||
918 | Output_Object_List : Boolean := False; | |
919 | -- GNATBIND | |
920 | -- True if output of list of objects is requested (-O switch set) | |
921 | ||
c690a2ec RD |
922 | Overflow_Checks_Unsuppressed : Boolean := False; |
923 | -- GNAT | |
924 | -- Set to True if at least one pragma Unsuppress | |
925 | -- (All_Checks|Overflow_Checks) has been processed. | |
926 | ||
f81e6250 RD |
927 | Persistent_BSS_Mode : Boolean := False; |
928 | -- GNAT | |
929 | -- True if a Persistent_BSS configuration pragma is in effect, causing | |
930 | -- potentially persistent data to be placed in the persistent_bss section. | |
931 | ||
38cbfe40 RK |
932 | Pessimistic_Elab_Order : Boolean := False; |
933 | -- GNATBIND | |
934 | -- True if pessimistic elaboration order is to be chosen (-p switch set) | |
935 | ||
936 | Polling_Required : Boolean := False; | |
937 | -- GNAT | |
938 | -- Set to True if polling for asynchronous abort is enabled by using | |
939 | -- the -gnatP option for GNAT. | |
940 | ||
fbf5a39b AC |
941 | Preprocessing_Data_File : String_Ptr := null; |
942 | -- GNAT | |
dec55d76 | 943 | -- Set by switch -gnatep=. The file name of the preprocessing data file. |
fbf5a39b | 944 | |
38cbfe40 RK |
945 | Print_Generated_Code : Boolean := False; |
946 | -- GNAT | |
947 | -- Set to True to enable output of generated code in source form. This | |
948 | -- flag is set by the -gnatG switch. | |
949 | ||
9596236a AC |
950 | Print_Standard : Boolean := False; |
951 | -- GNAT | |
952 | -- Set to true to enable printing of package standard in source form. | |
953 | -- This flag is set by the -gnatS switch | |
954 | ||
38cbfe40 RK |
955 | Propagate_Exceptions : Boolean := False; |
956 | -- GNAT | |
957 | -- Indicates if subprogram descriptor exception tables should be | |
958 | -- built for imported subprograms. Set True if a Propagate_Exceptions | |
959 | -- pragma applies to the extended main unit. | |
960 | ||
fbf5a39b AC |
961 | type Usage is (Unknown, Not_In_Use, In_Use); |
962 | Project_File_In_Use : Usage := Unknown; | |
38cbfe40 | 963 | -- GNAT |
fbf5a39b AC |
964 | -- Indicates if a project file is used or not. |
965 | -- Set to In_Use by the first SFNP pragma. | |
966 | ||
967 | Queuing_Policy : Character := ' '; | |
968 | -- GNAT, GNATBIND | |
07fc65c4 | 969 | -- Set to ' ' for the default case (no queuing policy specified). |
38cbfe40 RK |
970 | -- Reset to first character (uppercase) of locking policy name if a valid |
971 | -- Queuing_Policy pragma is encountered. | |
972 | ||
fbf5a39b AC |
973 | Queuing_Policy_Sloc : Source_Ptr := No_Location; |
974 | -- GNAT, GNATBIND | |
975 | -- Remember location of previous Queuing_Policy pragma. This is used | |
976 | -- for inconsistency error messages. A value of System_Location is | |
977 | -- used if the policy is set in package System. | |
978 | ||
38cbfe40 | 979 | Quiet_Output : Boolean := False; |
395b5080 | 980 | -- GNATMAKE, GNATCLEAN, GPRMAKE, GPRBUILD, GPRCLEAN |
fbf5a39b AC |
981 | -- Set to True if the tool should not have any output if there are no |
982 | -- errors or warnings. | |
983 | ||
383b2b42 RD |
984 | Replace_In_Comments : Boolean := False; |
985 | -- GNATPREP | |
986 | -- Set to True if -C switch used | |
987 | ||
fbf5a39b AC |
988 | RTS_Lib_Path_Name : String_Ptr := null; |
989 | RTS_Src_Path_Name : String_Ptr := null; | |
990 | -- GNAT | |
991 | -- Set to the "adalib" and "adainclude" directories of the run time | |
992 | -- specified by --RTS=. | |
38cbfe40 | 993 | |
07fc65c4 GB |
994 | RTS_Switch : Boolean := False; |
995 | -- GNAT, GNATMAKE, GNATBIND, GNATLS, GNATFIND, GNATXREF | |
996 | -- Set to True when the --RTS switch is set | |
997 | ||
fbf5a39b AC |
998 | Run_Path_Option : Boolean := True; |
999 | -- GNATMAKE, GNATLINK | |
1000 | -- Set to False when no run_path_option should be issued to the linker | |
1001 | ||
1f6a2b51 RD |
1002 | Search_Directory_Present : Boolean := False; |
1003 | -- GNAT | |
1004 | -- Set to True when argument is -I. Reset to False when next argument, | |
1005 | -- a search directory path is taken into account. Note that this is | |
1006 | -- quite different from other switches in this section in that it is | |
1007 | -- only set in a transitory manner as a result of scanning a -I switch | |
1008 | -- with no file name, and if set, is an indication that the next argument | |
1009 | -- is to be treated as a file name. | |
1010 | ||
91b1417d AC |
1011 | Sec_Stack_Used : Boolean := False; |
1012 | -- GNAT, GBATBIND | |
1013 | -- Set True if generated code uses the System.Secondary_Stack package. | |
1014 | -- For the binder, set if any unit uses the secondary stack package. | |
1015 | ||
615cbd95 AC |
1016 | Setup_Projects : Boolean := False; |
1017 | -- GNAT DRIVER | |
1018 | -- Set to True for GNAT SETUP: the Project Manager creates non existing | |
1019 | -- object, library and exec directories. | |
1020 | ||
38cbfe40 RK |
1021 | Shared_Libgnat : Boolean; |
1022 | -- GNATBIND | |
1023 | -- Set to True if a shared libgnat is requested by using the -shared | |
1024 | -- option for GNATBIND and to False when using the -static option. The | |
07fc65c4 | 1025 | -- value of this flag is set by Gnatbind.Scan_Bind_Arg. |
38cbfe40 RK |
1026 | |
1027 | Stack_Checking_Enabled : Boolean; | |
1028 | -- GNAT | |
f81e6250 RD |
1029 | -- Set to indicate if -fstack-check switch is set for the compilation. True |
1030 | -- means that the switch is set, so that stack checking is enabled. False | |
1031 | -- means that the switch is not set (no stack checking). This value is | |
1032 | -- obtained from the external imported value flag_stack_check in the gcc | |
1033 | -- backend (see Frontend) and may be referenced throughout the compilation | |
1034 | -- phases. | |
38cbfe40 | 1035 | |
38cbfe40 RK |
1036 | Style_Check : Boolean := False; |
1037 | -- GNAT | |
1038 | -- Set True to perform style checks. Activates checks carried out | |
1039 | -- in package Style (see body of this package for details of checks) | |
1040 | -- This flag is set True by either the -gnatg or -gnaty switches. | |
1041 | ||
395b5080 VC |
1042 | Suppress_All_Inlining : Boolean := False; |
1043 | -- GNAT | |
1044 | -- Set by -fno-inline. Suppresses all inlining, both front end and back end | |
1045 | -- regardless of any other switches that are set. | |
1046 | ||
38cbfe40 RK |
1047 | System_Extend_Pragma_Arg : Node_Id := Empty; |
1048 | -- GNAT | |
1049 | -- Set non-empty if and only if a correct Extend_System pragma was present | |
1050 | -- in which case it points to the argument of the pragma, and the name can | |
1051 | -- be located as Chars (Expression (System_Extend_Pragma_Arg)). | |
1052 | ||
fbf5a39b AC |
1053 | System_Extend_Unit : Node_Id := Empty; |
1054 | -- GNAT | |
1055 | -- This is set to Empty if GNAT_Mode is set, since pragma Extend_System | |
1056 | -- is never appropriate in GNAT_Mode (and causes troubles, including | |
1057 | -- bogus circularities, if we try to compile the run-time library with | |
1058 | -- a System extension). If GNAT_Mode is not set, then System_Extend_Unit | |
f81e6250 | 1059 | -- is a copy of the value set in System_Extend_Pragma_Arg. |
fbf5a39b | 1060 | |
38cbfe40 | 1061 | Subunits_Missing : Boolean := False; |
07fc65c4 | 1062 | -- GNAT |
38cbfe40 RK |
1063 | -- This flag is set true if missing subunits are detected with code |
1064 | -- generation active. This causes code generation to be skipped. | |
1065 | ||
07fc65c4 GB |
1066 | Suppress_Checks : Boolean := False; |
1067 | -- GNAT | |
1068 | -- Set to True if -gnatp (suppress all checks) switch present. | |
1069 | ||
fbf5a39b | 1070 | Suppress_Options : Suppress_Array; |
38cbfe40 RK |
1071 | -- GNAT |
1072 | -- Flags set True to suppress corresponding check, i.e. add an implicit | |
1073 | -- pragma Suppress at the outer level of each unit compiled. Note that | |
1074 | -- these suppress actions can be overridden by the use of the Unsuppress | |
1075 | -- pragma. This variable is initialized by Osint.Initialize. | |
1076 | ||
fbf5a39b AC |
1077 | Suppress_Back_Annotation : Boolean := False; |
1078 | -- GNAT | |
1079 | -- This flag is set True if back annotation of representation information | |
1080 | -- is to be suppressed. This is set if neither -gnatt or -gnatR0-3 is set. | |
1081 | -- This avoids unnecessary time being spent on back annotation. | |
1082 | ||
38cbfe40 | 1083 | Table_Factor : Int := 1; |
07fc65c4 | 1084 | -- GNAT |
38cbfe40 | 1085 | -- Factor by which all initial table sizes set in Alloc are multiplied. |
f81e6250 RD |
1086 | -- Used in Table to calculate initial table sizes (the initial table size |
1087 | -- is the value in Alloc, used as the Table_Initial parameter value, | |
1088 | -- multiplied by the factor given here. The default value is used if no | |
1089 | -- -gnatT switch appears. | |
38cbfe40 RK |
1090 | |
1091 | Task_Dispatching_Policy : Character := ' '; | |
fbf5a39b | 1092 | -- GNAT, GNATBIND |
38cbfe40 RK |
1093 | -- Set to ' ' for the default case (no task dispatching policy specified). |
1094 | -- Reset to first character (uppercase) of task dispatching policy name | |
1095 | -- if a valid Task_Dispatching_Policy pragma is encountered. | |
1096 | ||
fbf5a39b AC |
1097 | Task_Dispatching_Policy_Sloc : Source_Ptr := No_Location; |
1098 | -- GNAT, GNATBIND | |
1099 | -- Remember location of previous Task_Dispatching_Policy pragma. This is | |
1100 | -- used for inconsistency error messages. A value of System_Location is | |
1101 | -- used if the policy is set in package System. | |
1102 | ||
38cbfe40 RK |
1103 | Tasking_Used : Boolean := False; |
1104 | -- Set True if any tasking construct is encountered. Used to activate the | |
07fc65c4 | 1105 | -- output of the Q, L and T lines in ALI files. |
38cbfe40 RK |
1106 | |
1107 | Time_Slice_Set : Boolean := False; | |
07fc65c4 | 1108 | -- GNATBIND |
38cbfe40 | 1109 | -- Set True if a pragma Time_Slice is processed in the main unit, or |
07fc65c4 | 1110 | -- if the -gnatTnn switch is present to set a time slice value. |
38cbfe40 RK |
1111 | |
1112 | Time_Slice_Value : Nat; | |
07fc65c4 | 1113 | -- GNATBIND |
f81e6250 RD |
1114 | -- Time slice value. Valid only if Time_Slice_Set is True, i.e. if |
1115 | -- Time_Slice pragma has been processed. Set to the time slice value in | |
1116 | -- microseconds. Negative values are stored as zero, and the value is not | |
1117 | -- larger than 1_000_000_000 (1000 seconds). Values larger than this are | |
1118 | -- reset to this maximum. This can also be set with the -gnatTnn switch. | |
38cbfe40 RK |
1119 | |
1120 | Tolerate_Consistency_Errors : Boolean := False; | |
1121 | -- GNATBIND | |
f81e6250 RD |
1122 | -- Tolerate time stamp and other consistency errors. If this flag is set to |
1123 | -- True (-t), then inconsistencies result in warnings rather than errors. | |
38cbfe40 | 1124 | |
23e6615e RD |
1125 | Treat_Restrictions_As_Warnings : Boolean := False; |
1126 | -- GNAT | |
1127 | -- Set True to treat pragma Restrictions as Restriction_Warnings. Set by | |
1128 | -- -gnatr switch. | |
1129 | ||
38cbfe40 RK |
1130 | Tree_Output : Boolean := False; |
1131 | -- GNAT | |
07fc65c4 | 1132 | -- Set to True (-gnatt) to generate output tree file |
38cbfe40 | 1133 | |
395b5080 VC |
1134 | True_VMS_Target : Boolean := False; |
1135 | -- Set True if we are on a VMS target. The setting of this flag reflects | |
1136 | -- the true state of the compile, unlike Targparm.OpenVMS_On_Target which | |
1137 | -- can also be true when debug flag m is set (-gnatdm). This is used in the | |
1138 | -- few cases where we do NOT want -gnatdm to trigger the VMS behavior. | |
1139 | ||
38cbfe40 RK |
1140 | Try_Semantics : Boolean := False; |
1141 | -- GNAT | |
1142 | -- Flag set to force attempt at semantic analysis, even if parser errors | |
1143 | -- occur. This will probably cause blowups at this stage in the game. On | |
1144 | -- the other hand, most such blowups will be caught cleanly and simply | |
07fc65c4 | 1145 | -- say compilation abandoned. This flag is set to True by -gnatq or -gnatQ. |
38cbfe40 | 1146 | |
fbf5a39b AC |
1147 | Undefined_Symbols_Are_False : Boolean := False; |
1148 | -- GNAT, GNATPREP | |
1149 | -- Set to True by switch -u of gnatprep or -u in the preprocessing data | |
1150 | -- file for the compiler. Indicates that while preprocessing sources, | |
1151 | -- symbols that are not defined have the value FALSE. | |
1152 | ||
38cbfe40 RK |
1153 | Unique_Error_Tag : Boolean := Tag_Errors; |
1154 | -- GNAT | |
1155 | -- Indicates if error messages are to be prefixed by the string error: | |
1156 | -- Initialized from Tag_Errors, can be forced on with the -gnatU switch. | |
1157 | ||
fbf5a39b AC |
1158 | Universal_Addressing_On_AAMP : Boolean := False; |
1159 | -- GNAAMP | |
f81e6250 RD |
1160 | -- Indicates if library-level objects should be accessed and updated using |
1161 | -- universal addressing instructions on the AAMP architecture. This flag is | |
1162 | -- set to True when pragma Universal_Data is given as a configuration | |
1163 | -- pragma. | |
fbf5a39b | 1164 | |
38cbfe40 RK |
1165 | Unreserve_All_Interrupts : Boolean := False; |
1166 | -- GNAT, GNATBIND | |
f81e6250 RD |
1167 | -- Normally set False, set True if a valid Unreserve_All_Interrupts pragma |
1168 | -- appears anywhere in the main unit for GNAT, or if any ALI file has the | |
1169 | -- corresponding attribute set in GNATBIND. | |
38cbfe40 RK |
1170 | |
1171 | Upper_Half_Encoding : Boolean := False; | |
395b5080 | 1172 | -- GNAT, GNATBIND |
ce4a6e84 | 1173 | -- Normally set False, indicating that upper half ISO 8859-1 characters are |
38cbfe40 | 1174 | -- used in the normal way to represent themselves. If the wide character |
f81e6250 RD |
1175 | -- encoding method uses the upper bit for this encoding, then this flag is |
1176 | -- set True, and upper half characters in the source indicate the start of | |
395b5080 | 1177 | -- a wide character sequence. Set by -gnatW or -W switches. |
38cbfe40 RK |
1178 | |
1179 | Usage_Requested : Boolean := False; | |
1180 | -- GNAT, GNATBIND, GNATMAKE | |
07fc65c4 GB |
1181 | -- Set to True if -h (-gnath for the compiler) switch encountered |
1182 | -- requesting usage information | |
38cbfe40 | 1183 | |
df956773 VC |
1184 | Use_Pragma_Linker_Constructor : Boolean := False; |
1185 | -- GNATBIND | |
1186 | -- True if pragma Linker_Constructor applies to adainit | |
1187 | ||
38cbfe40 RK |
1188 | Use_VADS_Size : Boolean := False; |
1189 | -- GNAT | |
1190 | -- Set to True if a valid pragma Use_VADS_Size is processed | |
1191 | ||
1192 | Validity_Checks_On : Boolean := True; | |
07fc65c4 | 1193 | -- GNAT |
38cbfe40 RK |
1194 | -- This flag determines if validity checking is on or off. The initial |
1195 | -- state is on, and the required default validity checks are active. The | |
f81e6250 | 1196 | -- actual set of checks that is performed if Validity_Checks_On is set is |
383b2b42 | 1197 | -- defined by the switches in package Validsw. The Validity_Checks_On flag |
f81e6250 RD |
1198 | -- is controlled by pragma Validity_Checks (On | Off), and also some |
1199 | -- generated compiler code (typically code that has to do with validity | |
1200 | -- check generation) is compiled with this flag set to False. This flag is | |
1201 | -- set to False by the -gnatp switch. | |
38cbfe40 RK |
1202 | |
1203 | Verbose_Mode : Boolean := False; | |
383b2b42 | 1204 | -- GNAT, GNATBIND, GNATMAKE, GNATLINK, GNATLS, GNATNAME, GNATCLEAN, |
395b5080 | 1205 | -- GPRMAKE, GPRBUILD, GPRCLEAN |
38cbfe40 RK |
1206 | -- Set to True to get verbose mode (full error message text and location |
1207 | -- information sent to standard output, also header, copyright and summary) | |
1208 | ||
383b2b42 RD |
1209 | type Verbosity_Level_Type is (None, Low, Medium, High); |
1210 | Verbosity_Level : Verbosity_Level_Type := High; | |
1211 | -- GNATMAKE, GPRMAKE | |
1212 | -- Modified by gnatmake or gprmake switches -v, -vl, -vm, -vh. Indicates | |
1213 | -- the level of verbosity of informational messages: | |
1214 | -- | |
1215 | -- In Low Verbosity, the reasons why a source is recompiled, the name | |
1216 | -- of the executable and the reason it must be rebuilt is output. | |
1217 | -- | |
1218 | -- In Medium Verbosity, additional lines are output for each ALI file | |
1219 | -- that is checked. | |
1220 | -- | |
1221 | -- In High Verbosity, additional lines are output when the ALI file | |
1222 | -- is part of an Ada library, is read-only or is part of the runtime. | |
1223 | ||
f81e6250 RD |
1224 | Warn_On_Ada_2005_Compatibility : Boolean := True; |
1225 | -- GNAT | |
4ecc031c | 1226 | -- Set to True to generate all warnings on Ada 2005 compatibility issues, |
f81e6250 RD |
1227 | -- including warnings on Ada 2005 obsolescent features used in Ada 2005 |
1228 | -- mode. Set False by -gnatwY. | |
1229 | ||
ce4a6e84 RD |
1230 | Warn_On_Parameter_Order : Boolean := False; |
1231 | -- GNAT | |
1232 | -- Set to True to generate warnings for cases where the argument list for | |
1233 | -- a call is a sequence of identifiers that match the formal identifiers, | |
1234 | -- but are in the wrong order. | |
1235 | ||
395b5080 VC |
1236 | Warn_On_Assertion_Failure : Boolean := True; |
1237 | -- GNAT | |
1238 | -- Set to True to activate warnings on assertions that can be determined | |
1239 | -- at compile time will always fail. Set false by -gnatw.A. | |
1240 | ||
4ecc031c RD |
1241 | Warn_On_Assumed_Low_Bound : Boolean := True; |
1242 | -- GNAT | |
1243 | -- Set to True to activate warnings for string parameters that are indexed | |
1244 | -- with literals or S'Length, presumably assuming a lower bound of one. Set | |
1245 | -- False by -gnatwW. | |
1246 | ||
bc5f3720 RD |
1247 | Warn_On_Bad_Fixed_Value : Boolean := False; |
1248 | -- GNAT | |
1249 | -- Set to True to generate warnings for static fixed-point expression | |
1250 | -- values that are not an exact multiple of the small value of the type. | |
1251 | ||
4ae23b62 AC |
1252 | Warn_On_Biased_Representation : Boolean := True; |
1253 | -- GNAT | |
1254 | -- Set to True to generate warnings for size clauses, component clauses | |
1255 | -- and component_size clauses that force biased representation. Set False | |
1256 | -- by -gnatw.B. | |
1257 | ||
fbf5a39b | 1258 | Warn_On_Constant : Boolean := False; |
38cbfe40 | 1259 | -- GNAT |
fbf5a39b AC |
1260 | -- Set to True to generate warnings for variables that could be declared |
1261 | -- as constants. Modified by use of -gnatwk/K. | |
38cbfe40 | 1262 | |
4ecc031c RD |
1263 | Warn_On_Deleted_Code : Boolean := False; |
1264 | -- GNAT | |
1265 | -- Set to True to generate warnings for code deleted by the front end | |
1266 | -- for conditional statements whose outcome is known at compile time. | |
1267 | -- Modified by use of -gnatwt/T. | |
1268 | ||
07fc65c4 GB |
1269 | Warn_On_Dereference : Boolean := False; |
1270 | -- GNAT | |
1271 | -- Set to True to generate warnings for implicit dereferences for array | |
1272 | -- indexing and record component access. Modified by use of -gnatwd/D. | |
1273 | ||
fbf5a39b AC |
1274 | Warn_On_Export_Import : Boolean := True; |
1275 | -- GNAT | |
1276 | -- Set to True to generate warnings for suspicious use of export or | |
1277 | -- import pragmas. Modified by use of -gnatwx/X. | |
1278 | ||
38cbfe40 RK |
1279 | Warn_On_Hiding : Boolean := False; |
1280 | -- GNAT | |
1281 | -- Set to True to generate warnings if a declared entity hides another | |
1282 | -- entity. The default is that this warning is suppressed. | |
1283 | ||
fbf5a39b AC |
1284 | Warn_On_Modified_Unread : Boolean := False; |
1285 | -- GNAT | |
f81e6250 | 1286 | -- Set to True to generate warnings if a variable is assigned but is never |
395b5080 VC |
1287 | -- read. Also controls warnings for similar cases involving out parameters, |
1288 | -- but only if there is only one out parameter for the procedure involved. | |
1289 | -- The default is that this warning is suppressed. | |
67ce0d7e | 1290 | |
395b5080 | 1291 | Warn_On_All_Unread_Out_Parameters : Boolean := False; |
67ce0d7e | 1292 | -- GNAT |
395b5080 VC |
1293 | -- Set to True to generate warnings in all cases where a variable is |
1294 | -- modified by being passed as to an OUT formal, but the resulting value is | |
1295 | -- never read. The default is that this warning is suppressed, except in | |
1296 | -- the case of | |
fbf5a39b AC |
1297 | |
1298 | Warn_On_No_Value_Assigned : Boolean := True; | |
1299 | -- GNAT | |
1300 | -- Set to True to generate warnings if no value is ever assigned to a | |
1301 | -- variable that is at least partially uninitialized. Set to false to | |
1302 | -- suppress such warnings. The default is that such warnings are enabled. | |
1303 | ||
c690a2ec | 1304 | Warn_On_Non_Local_Exception : Boolean := False; |
a9a5b8ac RD |
1305 | -- GNAT |
1306 | -- Set to True to generate warnings for non-local exception raises and also | |
1307 | -- handlers that can never handle a local raise. This warning is only ever | |
1308 | -- generated if pragma Restrictions (No_Exception_Propagation) is set. The | |
c690a2ec | 1309 | -- default is not to generate the warnings even if the restriction is set. |
a9a5b8ac | 1310 | |
fbf5a39b AC |
1311 | Warn_On_Obsolescent_Feature : Boolean := False; |
1312 | -- GNAT | |
f81e6250 RD |
1313 | -- Set to True to generate warnings on use of any feature in Annex or if a |
1314 | -- subprogram is called for which a pragma Obsolescent applies. | |
fbf5a39b | 1315 | |
a9a5b8ac | 1316 | Warn_On_Questionable_Missing_Parens : Boolean := True; |
4ecc031c | 1317 | -- GNAT |
dec55d76 | 1318 | -- Set to True to generate warnings for cases where parentheses are missing |
4ecc031c RD |
1319 | -- and the usage is questionable, because the intent is unclear. |
1320 | ||
38cbfe40 RK |
1321 | Warn_On_Redundant_Constructs : Boolean := False; |
1322 | -- GNAT | |
1323 | -- Set to True to generate warnings for redundant constructs (e.g. useless | |
1324 | -- assignments/conversions). The default is that this warning is disabled. | |
1325 | ||
fbe627af RD |
1326 | Warn_On_Object_Renames_Function : Boolean := False; |
1327 | -- GNAT | |
1328 | -- Set to True to generate warnings when a function result is renamed as | |
1329 | -- an object. The default is that this warning is disabled. | |
1330 | ||
a9a5b8ac RD |
1331 | Warn_On_Reverse_Bit_Order : Boolean := True; |
1332 | -- GNAT | |
1333 | -- Set to True to generate warning (informational) messages for component | |
1334 | -- clauses that are affected by non-standard bit-order. The default is | |
1335 | -- that this warning is enabled. | |
1336 | ||
fbf5a39b AC |
1337 | Warn_On_Unchecked_Conversion : Boolean := True; |
1338 | -- GNAT | |
1339 | -- Set to True to generate warnings for unchecked conversions that may have | |
1340 | -- non-portable semantics (e.g. because sizes of types differ). The default | |
1341 | -- is that this warning is enabled. | |
1342 | ||
1343 | Warn_On_Unrecognized_Pragma : Boolean := True; | |
1344 | -- GNAT | |
1345 | -- Set to True to generate warnings for unrecognized pragmas. The default | |
1346 | -- is that this warning is enabled. | |
1347 | ||
fbe627af RD |
1348 | Warn_On_Unrepped_Components : Boolean := False; |
1349 | -- GNAT | |
1350 | -- Set to True to generate warnings for the case of components of record | |
1351 | -- which have a record representation clause but this component does not | |
1352 | -- have a component clause. The default is that this warning is disabled. | |
1353 | ||
1b24ada5 RD |
1354 | Warn_On_Warnings_Off : Boolean := False; |
1355 | -- GNAT | |
1356 | -- Set to True to generate warnings for use of Pragma Warnings (Off, ent), | |
1357 | -- where either the pragma is never used, or it could be replaced by a | |
1358 | -- pragma Unmodified or Unreferenced. | |
1359 | ||
38cbfe40 RK |
1360 | type Warning_Mode_Type is (Suppress, Normal, Treat_As_Error); |
1361 | Warning_Mode : Warning_Mode_Type := Normal; | |
1362 | -- GNAT, GNATBIND | |
1363 | -- Controls treatment of warning messages. If set to Suppress, warning | |
1364 | -- messages are not generated at all. In Normal mode, they are generated | |
1365 | -- but do not count as errors. In Treat_As_Error mode, warning messages | |
1366 | -- are generated and are treated as errors. | |
1367 | ||
1368 | Wide_Character_Encoding_Method : WC_Encoding_Method := WCEM_Brackets; | |
395b5080 | 1369 | -- GNAT, GNATBIND |
38cbfe40 RK |
1370 | -- Method used for encoding wide characters in the source program. See |
1371 | -- description of type in unit System.WCh_Con for a list of the methods | |
1372 | -- that are currently supported. Note that brackets notation is always | |
1373 | -- recognized in source programs regardless of the setting of this | |
f81e6250 RD |
1374 | -- variable. The default setting causes only the brackets notation to be |
1375 | -- recognized. If this is the main unit, this setting also controls the | |
1376 | -- output of the W=? parameter in the ALI file, which is used to provide | |
395b5080 VC |
1377 | -- the default for encoding [Wide_[Wide_]]Text_IO files. For the binder, |
1378 | -- the value set here overrides this main unit default. | |
1379 | ||
1380 | Wide_Character_Encoding_Method_Specified : Boolean := False; | |
1381 | -- GNAT, GNATBIND | |
1382 | -- Set True if the value in Wide_Character_Encoding_Method was set as | |
1383 | -- a result of an explicit -gnatW? or -W? switch. False otherwise. | |
38cbfe40 RK |
1384 | |
1385 | Xref_Active : Boolean := True; | |
1386 | -- GNAT | |
07fc65c4 | 1387 | -- Set if cross-referencing is enabled (i.e. xref info in ALI files) |
38cbfe40 | 1388 | |
fbe627af RD |
1389 | Zero_Formatting : Boolean := False; |
1390 | -- GNATBIND | |
1391 | -- Do no formatting (no title, no leading spaces, no empty lines) in | |
1392 | -- auxiliary outputs (-e, -K, -l, -R). | |
1393 | ||
38cbfe40 RK |
1394 | ---------------------------- |
1395 | -- Configuration Settings -- | |
1396 | ---------------------------- | |
1397 | ||
f81e6250 RD |
1398 | -- These are settings that are used to establish the mode at the start of |
1399 | -- each unit. The values defined below can be affected either by command | |
1b24ada5 RD |
1400 | -- line switches, or by the use of appropriate configuration pragmas in a |
1401 | -- configuration pragma file. | |
38cbfe40 | 1402 | |
0ab80019 | 1403 | Ada_Version_Config : Ada_Version_Type; |
38cbfe40 | 1404 | -- GNAT |
0ab80019 | 1405 | -- This is the value of the configuration switch for the Ada 83 mode, as |
f81e6250 RD |
1406 | -- set by the command line switches -gnat83/95/05, and possibly modified by |
1407 | -- the use of configuration pragmas Ada_83/Ada95/Ada05. This switch is used | |
1408 | -- to set the initial value for Ada_Version mode at the start of analysis | |
1409 | -- of a unit. Note however, that the setting of this flag is ignored for | |
1410 | -- internal and predefined units (which are always compiled in the most up | |
1411 | -- to date version of Ada). | |
1412 | ||
1413 | Ada_Version_Explicit_Config : Ada_Version_Type; | |
1414 | -- GNAT | |
1f6a2b51 RD |
1415 | -- This is set in the same manner as Ada_Version_Config. The difference is |
1416 | -- that the setting of this flag is not ignored for internal and predefined | |
1417 | -- units, which for some purposes do indeed access this value, regardless | |
dec55d76 | 1418 | -- of the fact that they are compiled the most up to date ada version). |
f81e6250 RD |
1419 | |
1420 | Assertions_Enabled_Config : Boolean; | |
1421 | -- GNAT | |
1422 | -- This is the value of the configuration switch for assertions enabled | |
1423 | -- mode, as possibly set by the command line switch -gnata, and possibly | |
1424 | -- modified by the use of the configuration pragma Assertion_Policy. | |
38cbfe40 | 1425 | |
4351c21b AC |
1426 | Assume_No_Invalid_Values_Config : Boolean; |
1427 | -- GNAT | |
1428 | -- This is the value of the configuration switch for assuming no invalid | |
1429 | -- values enabled mode mode, as possibly set by the command line switch | |
1430 | -- -gnatB, and possibly modified by the use of the configuration pragma | |
1431 | -- Assume_No_Invalid_Values. | |
1432 | ||
ce4a6e84 RD |
1433 | Check_Policy_List_Config : Node_Id; |
1434 | -- GNAT | |
1435 | -- This points to the list of N_Pragma nodes for Check_Policy pragmas | |
1436 | -- that are linked through the Next_Pragma fields, with the list being | |
1437 | -- terminated by Empty. The order is most recently processed first. This | |
1438 | -- list includes only those pragmas in configuration pragma files. | |
1439 | ||
6e18b0e5 RD |
1440 | Debug_Pragmas_Enabled_Config : Boolean; |
1441 | -- GNAT | |
1442 | -- This is the value of the configuration switch for debug pragmas enabled | |
1443 | -- mode, as possibly set by the command line switch -gnata and possibly | |
1444 | -- modified by the use of the configuration pragma Debug_Policy. | |
1445 | ||
38cbfe40 RK |
1446 | Dynamic_Elaboration_Checks_Config : Boolean := False; |
1447 | -- GNAT | |
1448 | -- Set True for dynamic elaboration checking mode, as set by the -gnatE | |
1449 | -- switch or by the use of pragma Elaboration_Checking (Dynamic). | |
1450 | ||
fbf5a39b AC |
1451 | Exception_Locations_Suppressed_Config : Boolean := False; |
1452 | -- GNAT | |
1453 | -- Set True by use of the configuration pragma Suppress_Exception_Messages | |
1454 | ||
38cbfe40 RK |
1455 | Extensions_Allowed_Config : Boolean; |
1456 | -- GNAT | |
f81e6250 RD |
1457 | -- This is the flag that indicates whether extensions are allowed. It can |
1458 | -- be set True either by use of the -gnatX switch, or by use of the | |
1459 | -- configuration pragma Extensions_Allowed (On). It is always set to True | |
1460 | -- for internal GNAT units, since extensions are always permitted in such | |
1461 | -- units. | |
38cbfe40 RK |
1462 | |
1463 | External_Name_Exp_Casing_Config : External_Casing_Type; | |
1464 | -- GNAT | |
f81e6250 RD |
1465 | -- This is the value of the configuration switch that controls casing of |
1466 | -- external symbols for which an explicit external name is given. It can be | |
1467 | -- set to Uppercase by the command line switch -gnatF, and further modified | |
1468 | -- by the use of the configuration pragma External_Name_Casing in the | |
1469 | -- gnat.adc file. This flag is used to set the initial value for | |
1470 | -- External_Name_Exp_Casing at the start of analyzing each unit. Note | |
1471 | -- however that the setting of this flag is ignored for internal and | |
1472 | -- predefined units (which are always compiled with As_Is mode). | |
38cbfe40 RK |
1473 | |
1474 | External_Name_Imp_Casing_Config : External_Casing_Type; | |
1475 | -- GNAT | |
f81e6250 RD |
1476 | -- This is the value of the configuration switch that controls casing of |
1477 | -- external symbols where the external name is implicitly given. It can be | |
1478 | -- set to Uppercase by the command line switch -gnatF, and further modified | |
1479 | -- by the use of the configuration pragma External_Name_Casing in the | |
1480 | -- gnat.adc file. This flag is used to set the initial value for | |
1481 | -- External_Name_Imp_Casing at the start of analyzing each unit. Note | |
1482 | -- however that the setting of this flag is ignored for internal and | |
1483 | -- predefined units (which are always compiled with Lowercase mode). | |
1484 | ||
395b5080 VC |
1485 | Fast_Math_Config : Boolean; |
1486 | -- GNAT | |
1487 | -- This is the value of the configuration switch that controls Fast_Math | |
1488 | -- mode, as set by a Fast_Math pragma in configuration pragmas. It is | |
1489 | -- used to set the initial value of Fast_Math at the start of each new | |
1490 | -- compilation unit. | |
1491 | ||
1b24ada5 RD |
1492 | Optimize_Alignment_Config : Character; |
1493 | -- GNAT | |
1494 | -- This is the value of the configuration switch that controls the | |
1495 | -- alignment optimization mode, as set by an Optimize_Alignment pragma. | |
1496 | -- It is used to set the initial value of Optimize_Alignment at the start | |
1497 | -- of each new compilation unit, except that it is always set to 'O' (off) | |
1498 | -- for internal units. | |
1499 | ||
f81e6250 RD |
1500 | Persistent_BSS_Mode_Config : Boolean; |
1501 | -- GNAT | |
1502 | -- This is the value of the configuration switch that controls whether | |
1503 | -- potentially persistent data is to be placed in the persistent_bss | |
1504 | -- section. It can be set True by use of the pragma Persistent_BSS. | |
1505 | -- This flag is used to set the initial value of Persistent_BSS_Mode | |
1506 | -- at the start of each compilation unit, except that it is always | |
1507 | -- set False for predefined units. | |
38cbfe40 RK |
1508 | |
1509 | Polling_Required_Config : Boolean; | |
1510 | -- GNAT | |
1511 | -- This is the value of the configuration switch that controls polling | |
1512 | -- mode. It can be set True by the command line switch -gnatP, and then | |
f81e6250 RD |
1513 | -- further modified by the use of pragma Polling in the gnat.adc file. This |
1514 | -- flag is used to set the initial value for Polling_Required at the start | |
1515 | -- of analyzing each unit. | |
38cbfe40 RK |
1516 | |
1517 | Use_VADS_Size_Config : Boolean; | |
1518 | -- GNAT | |
f81e6250 | 1519 | -- This is the value of the configuration switch that controls the use of |
dec55d76 | 1520 | -- VADS_Size instead of Size wherever the attribute Size is used. It can |
f81e6250 RD |
1521 | -- be set True by the use of the pragma Use_VADS_Size in the gnat.adc file. |
1522 | -- This flag is used to set the initial value for Use_VADS_Size at the | |
1523 | -- start of analyzing each unit. Note however that the setting of this flag | |
1524 | -- is ignored for internal and predefined units (which are always compiled | |
1525 | -- with the standard Size semantics). | |
38cbfe40 RK |
1526 | |
1527 | type Config_Switches_Type is private; | |
1528 | -- Type used to save values of the switches set from Config values | |
1529 | ||
1530 | procedure Save_Opt_Config_Switches (Save : out Config_Switches_Type); | |
1531 | -- This procedure saves the current values of the switches which are | |
f81e6250 RD |
1532 | -- initialized from the above Config values, and then resets these switches |
1533 | -- according to the Config value settings. | |
38cbfe40 | 1534 | |
6e18b0e5 RD |
1535 | procedure Set_Opt_Config_Switches |
1536 | (Internal_Unit : Boolean; | |
1537 | Main_Unit : Boolean); | |
f81e6250 RD |
1538 | -- This procedure sets the switches to the appropriate initial values. The |
1539 | -- parameter Internal_Unit is True for an internal or predefined unit, and | |
6e18b0e5 RD |
1540 | -- affects the way the switches are set (see above). Main_Unit is true if |
1541 | -- switches are being set for the main unit (this affects setting of the | |
c690a2ec RD |
1542 | -- assert/debug pragma switches, which are normally set false by default |
1543 | -- for an internal unit, except when the internal unit is the main unit, | |
1544 | -- in which case we use the command line settings). | |
38cbfe40 RK |
1545 | |
1546 | procedure Restore_Opt_Config_Switches (Save : Config_Switches_Type); | |
f81e6250 RD |
1547 | -- This procedure restores a set of switch values previously saved by a |
1548 | -- call to Save_Opt_Switches. | |
38cbfe40 RK |
1549 | |
1550 | procedure Register_Opt_Config_Switches; | |
ce4a6e84 RD |
1551 | -- This procedure is called after processing the gnat.adc file and other |
1552 | -- configuration pragma files to record the values of the Config switches, | |
1553 | -- as possibly modified by the use of command line switches and pragmas | |
1554 | -- appearing in these files. | |
38cbfe40 RK |
1555 | |
1556 | ------------------------ | |
1557 | -- Other Global Flags -- | |
1558 | ------------------------ | |
1559 | ||
1560 | Expander_Active : Boolean := False; | |
1561 | -- A flag that indicates if expansion is active (True) or deactivated | |
1562 | -- (False). When expansion is deactivated all calls to expander routines | |
1563 | -- have no effect. Note that the initial setting of False is merely to | |
1564 | -- prevent saving of an undefined value for an initial call to the | |
f81e6250 RD |
1565 | -- Expander_Mode_Save_And_Set procedure. For more information on the use of |
1566 | -- this flag, see package Expander. Indeed this flag might more logically | |
1567 | -- be in the spec of Expander, but it is referenced by Errout, and it | |
1568 | -- really seems wrong for Errout to depend on Expander. | |
38cbfe40 | 1569 | |
c690a2ec RD |
1570 | Static_Dispatch_Tables : Boolean := True; |
1571 | -- This flag indicates if the backend supports generation of statically | |
1572 | -- allocated dispatch tables. If it is True, then the front end will | |
1573 | -- generate static aggregates for dispatch tables that contain forward | |
1574 | -- references to addresses of subprograms not seen yet, and the back end | |
1575 | -- must be prepared to handle this case. If it is False, then the front | |
1576 | -- end generates assignments to initialize the dispatch table, and there | |
1577 | -- are no such forward references. By default we build statically allocated | |
1578 | -- dispatch tables for all library level tagged types in all platforms.This | |
1579 | -- behavior can be disabled using switch -gnatd.t which will set this flag | |
1580 | -- to False and revert to the previous dynamic behavior. | |
1581 | ||
38cbfe40 RK |
1582 | ----------------------- |
1583 | -- Tree I/O Routines -- | |
1584 | ----------------------- | |
1585 | ||
1586 | procedure Tree_Read; | |
1587 | -- Reads switch settings from current tree file using Tree_Read | |
1588 | ||
1589 | procedure Tree_Write; | |
1590 | -- Writes out switch settings to current tree file using Tree_Write | |
1591 | ||
fbf5a39b AC |
1592 | -------------------------- |
1593 | -- ASIS Version Control -- | |
1594 | -------------------------- | |
1595 | ||
1596 | -- These two variables (Tree_Version_String and Tree_ASIS_Version_Number) | |
1597 | -- are supposed to be used in the GNAT/ASIS version check performed in | |
1598 | -- the ASIS code (this package is also a part of the ASIS implementation). | |
1599 | -- They are set by Tree_Read procedure, so they represent the version | |
1600 | -- number (and the version string) of the compiler which has created the | |
1601 | -- tree, and they are supposed to be compared with the corresponding values | |
e29bd38f TQ |
1602 | -- from the Tree_IO and Gnatvsn packages which also are a part of ASIS |
1603 | -- implementation. | |
fbf5a39b | 1604 | |
1f6a2b51 | 1605 | Tree_Version_String : String_Access; |
f81e6250 | 1606 | -- Used to store the compiler version string read from a tree file to check |
1f6a2b51 RD |
1607 | -- if it is from the same date as stored in the version string in Gnatvsn. |
1608 | -- We require that ASIS Pro can be used only with GNAT Pro, but we allow | |
1609 | -- non-Pro ASIS and ASIS-based tools to be used with any version of the | |
1610 | -- GNAT compiler. Therefore, we need the possibility to compare the dates | |
1611 | -- of the corresponding source sets, using version strings that may be | |
1612 | -- of different lengths. | |
fbf5a39b AC |
1613 | |
1614 | Tree_ASIS_Version_Number : Int; | |
1615 | -- Used to store the ASIS version number read from a tree file to check if | |
e29bd38f | 1616 | -- it is the same as stored in the ASIS version number in Tree_IO. |
fbf5a39b | 1617 | |
38cbfe40 RK |
1618 | private |
1619 | ||
1f6a2b51 RD |
1620 | -- The following type is used to save and restore settings of switches in |
1621 | -- Opt that represent the configuration (i.e. result of config pragmas). | |
1622 | ||
1623 | -- Note that Ada_Version_Explicit is not included, since this is a sticky | |
1624 | -- flag that once set does not get reset, since the whole idea of this flag | |
1625 | -- is to record the setting for the main unit. | |
1626 | ||
38cbfe40 | 1627 | type Config_Switches_Type is record |
0ab80019 | 1628 | Ada_Version : Ada_Version_Type; |
f81e6250 RD |
1629 | Ada_Version_Explicit : Ada_Version_Type; |
1630 | Assertions_Enabled : Boolean; | |
4351c21b | 1631 | Assume_No_Invalid_Values : Boolean; |
ce4a6e84 | 1632 | Check_Policy_List : Node_Id; |
6e18b0e5 | 1633 | Debug_Pragmas_Enabled : Boolean; |
fbf5a39b AC |
1634 | Dynamic_Elaboration_Checks : Boolean; |
1635 | Exception_Locations_Suppressed : Boolean; | |
1636 | Extensions_Allowed : Boolean; | |
1637 | External_Name_Exp_Casing : External_Casing_Type; | |
1638 | External_Name_Imp_Casing : External_Casing_Type; | |
395b5080 | 1639 | Fast_Math : Boolean; |
1b24ada5 | 1640 | Optimize_Alignment : Character; |
ce4a6e84 | 1641 | Optimize_Alignment_Local : Boolean; |
f81e6250 | 1642 | Persistent_BSS_Mode : Boolean; |
fbf5a39b AC |
1643 | Polling_Required : Boolean; |
1644 | Use_VADS_Size : Boolean; | |
38cbfe40 RK |
1645 | end record; |
1646 | ||
fbe627af RD |
1647 | -- The following declarations are for GCC version dependent flags. We do |
1648 | -- not let client code in the compiler test GCC_Version directly, but | |
1649 | -- instead use deferred constants for relevant feature tags. | |
1650 | ||
c690a2ec RD |
1651 | -- Note: there currently are no such constants defined in this section, |
1652 | -- since the compiler front end is currently entirely independent of the | |
1653 | -- GCC version, which is a desirable state of affairs. | |
1654 | ||
fbe627af RD |
1655 | function get_gcc_version return Int; |
1656 | pragma Import (C, get_gcc_version, "get_gcc_version"); | |
1657 | ||
1658 | GCC_Version : constant Nat := get_gcc_version; | |
1659 | -- GNATMAKE | |
1660 | -- Indicates which version of gcc is in use (3 = 3.x, 4 = 4.x). Note that | |
1661 | -- gcc 2.8.1 (which used to be a value of 2) is no longer supported. | |
1662 | ||
38cbfe40 | 1663 | end Opt; |