1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2023, Free Software Foundation, Inc. --
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 3, 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 COPYING3. If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 with System
.Strings
; use System
.Strings
;
28 with Atree
; use Atree
;
31 with Debug
; use Debug
;
38 with Ghost
; use Ghost
;
39 with Inline
; use Inline
;
41 with Lib
.Load
; use Lib
.Load
;
43 with Namet
; use Namet
;
44 with Nlists
; use Nlists
;
50 with Restrict
; use Restrict
;
51 with Rident
; use Rident
;
53 with Snames
; use Snames
;
60 with Sem_Elab
; use Sem_Elab
;
61 with Sem_Prag
; use Sem_Prag
;
63 with Sinfo
; use Sinfo
;
64 with Sinfo
.Nodes
; use Sinfo
.Nodes
;
65 with Sinfo
.Utils
; use Sinfo
.Utils
;
66 with Sinput
; use Sinput
;
67 with Sinput
.L
; use Sinput
.L
;
69 with Tbuild
; use Tbuild
;
70 with Types
; use Types
;
72 with Warnsw
; use Warnsw
;
76 -- Carry out package initializations. These are initializations which might
77 -- logically be performed at elaboration time, were it not for the fact
78 -- that we may be doing things more than once in the big loop over files.
79 -- Like elaboration, the order in which these calls are made is in some
80 -- cases important. For example, Lib cannot be initialized before Namet,
81 -- since it uses names table entries.
100 -- Create package Standard
102 CStand
.Create_Standard
;
104 -- Check possible symbol definitions specified by -gnateD switches
106 Prepcomp
.Process_Command_Line_Symbol_Definitions
;
108 -- If -gnatep= was specified, parse the preprocessing data file
110 if Preprocessing_Data_File
/= null then
111 Name_Len
:= Preprocessing_Data_File
'Length;
112 Name_Buffer
(1 .. Name_Len
) := Preprocessing_Data_File
.all;
113 Prepcomp
.Parse_Preprocessing_Data_File
(Name_Find
);
115 -- Otherwise, check if there were preprocessing symbols on the command
116 -- line and set preprocessing if there are.
119 Prepcomp
.Check_Symbols
;
122 -- We set Parsing_Main_Extended_Source true here to cover processing of all
123 -- the configuration pragma files, as well as the main source unit itself.
125 Parsing_Main_Extended_Source
:= True;
127 -- Now that the preprocessing situation is established, we are able to
128 -- load the main source (this is no longer done by Lib.Load.Initialize).
130 Lib
.Load
.Load_Main_Source
;
132 -- Return immediately if the main source could not be found
134 if Sinput
.Main_Source_File
<= No_Source_File
then
138 -- Read and process configuration pragma files if present
141 Dot_Gnat_Adc
: constant File_Name_Type
:= Name_Find
("./gnat.adc");
142 Gnat_Adc
: constant File_Name_Type
:= Name_Find
("gnat.adc");
144 Save_Style_Check
: constant Boolean := Opt
.Style_Check
;
145 -- Save style check mode so it can be restored later
147 Config_Pragmas
: List_Id
:= Empty_List
;
148 -- Gather configuration pragmas
150 Source_Config_File
: Source_File_Index
;
151 -- Source reference for -gnatec configuration file
156 -- We always analyze config files with style checks off, since we
157 -- don't want a miscellaneous gnat.adc that is around to discombobulate
158 -- intended -gnatg or -gnaty compilations. We also disconnect checking
159 -- for maximum line length.
161 Opt
.Style_Check
:= False;
162 Style_Check
:= False;
164 -- Capture current suppress options, which may get modified
166 Scope_Suppress
:= Opt
.Suppress_Options
;
168 -- First deal with gnat.adc file
170 if Opt
.Config_File
then
171 Source_gnat_adc
:= Load_Config_File
(Gnat_Adc
);
173 -- Case of gnat.adc file present
175 if Source_gnat_adc
> No_Source_File
then
177 -- Parse the gnat.adc file for configuration pragmas
179 Initialize_Scanner
(No_Unit
, Source_gnat_adc
);
180 Config_Pragmas
:= Par
(Configuration_Pragmas
=> True);
182 -- We add a compilation dependency for gnat.adc so that if it
183 -- changes, we force a recompilation.
185 Prepcomp
.Add_Dependency
(Source_gnat_adc
);
189 -- Now deal with specified config pragmas files if there are any
191 if Opt
.Config_File_Names
/= null then
193 -- Loop through config pragmas files
195 for Index
in Opt
.Config_File_Names
'Range loop
197 Len
: constant Natural := Config_File_Names
(Index
)'Length;
198 Str
: constant String (1 .. Len
) :=
199 Config_File_Names
(Index
).all;
201 Config_Name
: constant File_Name_Type
:= Name_Find
(Str
);
202 Temp_File
: constant Boolean :=
205 (Str
(Len
- 3 .. Len
) = ".TMP"
207 Str
(Len
- 3 .. Len
) = ".tmp");
208 -- Extension indicating a temporary config file?
211 -- Skip it if it's the default name, already loaded above.
212 -- Otherwise, we get confusing warning messages about seeing
213 -- the same thing twice.
215 if Config_Name
/= Gnat_Adc
216 and then Config_Name
/= Dot_Gnat_Adc
218 -- Load the file, error if we did not find it
220 Source_Config_File
:= Load_Config_File
(Config_Name
);
222 if Source_Config_File
<= No_Source_File
then
224 ("cannot find configuration pragmas file "
225 & Config_File_Names
(Index
).all);
227 -- If we did find the file, and it is not a temporary file,
228 -- then we add a compilation dependency for it so that if it
229 -- changes, we force a recompilation.
231 elsif not Temp_File
then
232 Prepcomp
.Add_Dependency
(Source_Config_File
);
235 -- Parse the config pragmas file, and accumulate results
237 Initialize_Scanner
(No_Unit
, Source_Config_File
);
239 (Config_Pragmas
, Par
(Configuration_Pragmas
=> True));
245 -- Now analyze all pragmas except those whose analysis must be
246 -- deferred till after the main unit is analyzed.
248 if Config_Pragmas
/= Error_List
249 and then Operating_Mode
/= Check_Syntax
251 Prag
:= First
(Config_Pragmas
);
252 while Present
(Prag
) loop
253 if not Delay_Config_Pragma_Analyze
(Prag
) then
254 Analyze_Pragma
(Prag
);
261 -- Restore style check, but if config file turned on checks, leave on
263 Opt
.Style_Check
:= Save_Style_Check
or Style_Check
;
265 -- Capture any modifications to suppress options from config pragmas
267 Opt
.Suppress_Options
:= Scope_Suppress
;
269 -- If a target dependency info file has been read through switch
270 -- -gnateT=, add it to the dependencies.
272 if Target_Dependent_Info_Read_Name
/= null then
274 Index
: Source_File_Index
;
277 Add_Str_To_Name_Buffer
(Target_Dependent_Info_Read_Name
.all);
278 Index
:= Load_Config_File
(Name_Enter
);
279 Prepcomp
.Add_Dependency
(Index
);
283 -- This is where we can capture the value of the compilation unit
284 -- specific restrictions that have been set by the config pragma
285 -- files (or from Targparm), for later restoration when processing
288 Save_Config_Cunit_Boolean_Restrictions
;
290 -- If there was a -gnatem switch, initialize the mappings of unit names
291 -- to file names and of file names to path names from the mapping file.
293 if Mapping_File_Name
/= null then
294 Fmap
.Initialize
(Mapping_File_Name
.all);
297 -- Adjust Optimize_Alignment mode from debug switches if necessary
299 if Debug_Flag_Dot_SS
then
300 Optimize_Alignment
:= 'S';
301 elsif Debug_Flag_Dot_TT
then
302 Optimize_Alignment
:= 'T';
305 -- We have now processed the command line switches, and the
306 -- configuration pragma files, so this is the point at which we want to
307 -- capture the values of the configuration switches (see Opt for further
310 Register_Config_Switches
;
312 -- Check for file which contains No_Body pragma
314 if Source_File_Is_No_Body
(Source_Index
(Main_Unit
)) then
315 Change_Main_Unit_To_Spec
;
318 -- Initialize the scanner. Note that we do this after the call to
319 -- Create_Standard, which uses the scanner in its processing of
320 -- floating-point bounds.
322 Initialize_Scanner
(Main_Unit
, Source_Index
(Main_Unit
));
324 -- Here we call the parser to parse the compilation unit (or units in
325 -- the check syntax mode, but in that case we won't go on to the
326 -- semantics in any case).
328 Discard_List
(Par
(Configuration_Pragmas
=> False));
329 Parsing_Main_Extended_Source
:= False;
331 -- The main unit is now loaded, and subunits of it can be loaded,
332 -- without reporting spurious loading circularities.
334 Set_Loading
(Main_Unit
, False);
336 -- Now that the main unit is installed, we can complete the analysis
337 -- of the pragmas in gnat.adc and the configuration file, that require
338 -- a context for their semantic processing.
340 if Config_Pragmas
/= Error_List
341 and then Operating_Mode
/= Check_Syntax
343 -- Do not attempt to process deferred configuration pragmas if the
344 -- main unit failed to load, to avoid cascaded inconsistencies that
345 -- can lead to a compiler crash.
347 and then Fatal_Error
(Main_Unit
) /= Error_Detected
349 -- Pragmas that require some semantic activity, such as
350 -- Interrupt_State, cannot be processed until the main unit is
351 -- installed, because they require a compilation unit on which to
352 -- attach with_clauses, etc. So analyze them now.
358 Prag
:= First
(Config_Pragmas
);
359 while Present
(Prag
) loop
361 -- Guard against the case where a configuration pragma may be
362 -- split into multiple pragmas and the original rewritten as a
365 if Nkind
(Prag
) = N_Pragma
366 and then Delay_Config_Pragma_Analyze
(Prag
)
368 Analyze_Pragma
(Prag
);
376 -- If we have restriction No_Exception_Propagation, and we did not have
377 -- an explicit switch turning off Warn_On_Non_Local_Exception, then turn
378 -- on this warning by default if we have encountered an exception
381 if Restriction_Check_Required
(No_Exception_Propagation
)
382 and then not No_Warn_On_Non_Local_Exception
383 and then Exception_Handler_Encountered
385 Warn_On_Non_Local_Exception
:= True;
388 -- Disable Initialize_Scalars for runtime files to avoid circular
391 if Initialize_Scalars
392 and then Fname
.Is_Predefined_File_Name
(File_Name
(Main_Source_File
))
394 Initialize_Scalars
:= False;
395 Init_Or_Norm_Scalars
:= Normalize_Scalars
;
398 -- Now on to the semantics. Skip if in syntax only mode
400 if Operating_Mode
/= Check_Syntax
then
402 -- Install the configuration pragmas in the tree
405 (Aux_Decls_Node
(Cunit
(Main_Unit
)), Config_Pragmas
);
407 -- Following steps are skipped if we had a fatal error during parsing
409 if Fatal_Error
(Main_Unit
) /= Error_Detected
then
411 -- Reset Operating_Mode to Check_Semantics for subunits. We cannot
412 -- actually generate code for subunits, so we suppress expansion.
413 -- This also corrects certain problems that occur if we try to
414 -- incorporate subunits at a lower level.
416 if Operating_Mode
= Generate_Code
417 and then Nkind
(Unit
(Cunit
(Main_Unit
))) = N_Subunit
419 Operating_Mode
:= Check_Semantics
;
422 -- Analyze (and possibly expand) main unit
424 Scope_Suppress
:= Suppress_Options
;
425 Semantics
(Cunit
(Main_Unit
));
427 -- Cleanup processing after completing main analysis
429 pragma Assert
(Operating_Mode
in Check_Semantics | Generate_Code
);
431 if Operating_Mode
= Generate_Code
or else GNATprove_Mode
then
433 -- In GNATprove_Mode we do not perform most expansions but body
434 -- instantiation is needed.
438 -- Analyze inlined bodies if required
440 if Inline_Processing_Required
then
441 Analyze_Inlined_Bodies
;
444 -- Remove entities from program that do not have any execution
447 if Debug_Flag_UU
then
448 Collect_Garbage_Entities
;
451 -- Check access-before-elaboration rules
453 if Legacy_Elaboration_Checks
then
457 -- Examine all top level scenarios collected during analysis
458 -- and resolution. Diagnose conditional ABEs, install run-time
459 -- checks to catch conditional ABEs, and guarantee the prior
460 -- elaboration of external units.
462 Check_Elaboration_Scenarios
;
464 -- Examine all top level scenarios collected during analysis and
465 -- resolution in order to diagnose conditional ABEs, even in the
466 -- presence of serious errors.
469 Check_Elaboration_Scenarios
;
472 -- List library units if requested
478 -- Output waiting warning messages
480 Sem_Warn
.Output_Non_Modified_In_Out_Warnings
;
481 Sem_Warn
.Output_Unreferenced_Messages
;
482 Sem_Warn
.Check_Unused_Withs
;
483 Sem_Warn
.Output_Unused_Warnings_Off_Warnings
;
485 -- Remove any ignored Ghost code as it must not appear in the
486 -- executable. This action must be performed very late because it
487 -- heavily alters the tree.
489 if Operating_Mode
= Generate_Code
or else GNATprove_Mode
then
490 Remove_Ignored_Ghost_Code
;
493 -- At this stage we can unnest subprogram bodies if required
495 if Total_Errors_Detected
= 0 then
496 Exp_Unst
.Unnest_Subprograms
(Cunit
(Main_Unit
));
503 -- Qualify all entity names in inner packages, package bodies, etc
505 if not GNATprove_Mode
then
506 Exp_Dbug
.Qualify_All_Entity_Names
;
509 -- SCIL backend requirement. Check that SCIL nodes associated with
510 -- dispatching calls reference subprogram calls.
512 if Generate_SCIL
then
513 pragma Debug
(Sem_SCIL
.Check_SCIL_Nodes
(Cunit
(Main_Unit
)));
517 -- Verify the validity of the tree
519 if Debug_Flag_Underscore_VV
then
520 VAST
.Check_Tree
(Cunit
(Main_Unit
));
523 -- Validate all the subprogram calls; this work will be done by VAST; in
524 -- the meantime it is done to check extra formals and it can be disabled
525 -- using -gnatd_X (which also disables all the other assertions on extra
526 -- formals). It is invoked using pragma Debug to avoid adding any cost
527 -- when the compiler is built with assertions disabled.
529 if not Debug_Flag_Underscore_XX
then
530 pragma Debug
(Exp_Ch6
.Validate_Subprogram_Calls
(Cunit
(Main_Unit
)));
533 -- Dump the source now. Note that we do this as soon as the analysis
534 -- of the tree is complete, because it is not just a dump in the case
535 -- of -gnatD, where it rewrites all source locations in the tree.
539 -- Check again for configuration pragmas that appear in the context
540 -- of the main unit. These pragmas only affect the main unit, and the
541 -- corresponding flag is reset after each call to Semantics, but they
542 -- may affect the generated ali for the unit, and therefore the flag
543 -- must be set properly after compilation. Currently we only check for
544 -- Initialize_Scalars, but others should be checked: as well???
550 Item
:= First
(Context_Items
(Cunit
(Main_Unit
)));
551 while Present
(Item
) loop
552 if Nkind
(Item
) = N_Pragma
553 and then Pragma_Name
(Item
) = Name_Initialize_Scalars
555 Initialize_Scalars
:= True;
562 -- If a mapping file has been specified by a -gnatem switch, update
563 -- it if there has been some sources that were not in the mappings.
565 if Mapping_File_Name
/= null then
566 Fmap
.Update_Mapping_File
(Mapping_File_Name
.all);