1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2018, 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 ------------------------------------------------------------------------------
27 with Atree
; use Atree
;
28 with Casing
; use Casing
;
29 with Debug
; use Debug
;
30 with Einfo
; use Einfo
;
31 with Errout
; use Errout
;
32 with Fname
; use Fname
;
33 with Fname
.UF
; use Fname
.UF
;
34 with Lib
.Util
; use Lib
.Util
;
35 with Lib
.Xref
; use Lib
.Xref
;
36 with Nlists
; use Nlists
;
37 with Gnatvsn
; use Gnatvsn
;
39 with Osint
; use Osint
;
40 with Osint
.C
; use Osint
.C
;
41 with Output
; use Output
;
43 with Par_SCO
; use Par_SCO
;
44 with Restrict
; use Restrict
;
45 with Rident
; use Rident
;
46 with Stand
; use Stand
;
48 with Sem_Eval
; use Sem_Eval
;
49 with Sinfo
; use Sinfo
;
50 with Sinput
; use Sinput
;
51 with Snames
; use Snames
;
52 with Stringt
; use Stringt
;
53 with Tbuild
; use Tbuild
;
54 with Uname
; use Uname
;
56 with System
.Case_Util
; use System
.Case_Util
;
57 with System
.WCh_Con
; use System
.WCh_Con
;
59 package body Lib
.Writ
is
61 -----------------------
62 -- Local Subprograms --
63 -----------------------
65 procedure Write_Unit_Name
(N
: Node_Id
);
66 -- Used to write out the unit name for R (pragma Restriction) lines
67 -- for uses of Restriction (No_Dependence => unit-name).
69 ----------------------------------
70 -- Add_Preprocessing_Dependency --
71 ----------------------------------
73 procedure Add_Preprocessing_Dependency
(S
: Source_File_Index
) is
76 Units
.Table
(Units
.Last
) :=
77 (Unit_File_Name
=> File_Name
(S
),
78 Unit_Name
=> No_Unit_Name
,
79 Expected_Unit
=> No_Unit_Name
,
82 Cunit_Entity
=> Empty
,
84 Dynamic_Elab
=> False,
86 Generate_Code
=> False,
89 Ident_String
=> Empty
,
90 Is_Predefined_Renaming
=> False,
91 Is_Internal_Unit
=> False,
92 Is_Predefined_Unit
=> False,
98 No_Elab_Code_All
=> False,
99 Primary_Stack_Count
=> 0,
100 Sec_Stack_Count
=> 0,
103 Error_Location
=> No_Location
,
105 end Add_Preprocessing_Dependency
;
107 ------------------------------
108 -- Ensure_System_Dependency --
109 ------------------------------
111 procedure Ensure_System_Dependency
is
112 System_Uname
: Unit_Name_Type
;
113 -- Unit name for system spec if needed for dummy entry
115 System_Fname
: File_Name_Type
;
116 -- File name for system spec if needed for dummy entry
119 -- Nothing to do if we already compiled System
121 for Unum
in Units
.First
.. Last_Unit
loop
122 if Units
.Table
(Unum
).Source_Index
= System_Source_File_Index
then
127 -- If no entry for system.ads in the units table, then add a entry
128 -- to the units table for system.ads, which will be referenced when
129 -- the ali file is generated. We need this because every unit depends
130 -- on system as a result of Targparm scanning the system.ads file to
131 -- determine the target dependent parameters for the compilation.
134 Name_Buffer
(1 .. 6) := "system";
135 System_Uname
:= Name_To_Unit_Name
(Name_Enter
);
136 System_Fname
:= File_Name
(System_Source_File_Index
);
138 Units
.Increment_Last
;
139 Units
.Table
(Units
.Last
) :=
140 (Unit_File_Name
=> System_Fname
,
141 Unit_Name
=> System_Uname
,
142 Expected_Unit
=> System_Uname
,
143 Source_Index
=> System_Source_File_Index
,
145 Cunit_Entity
=> Empty
,
147 Dynamic_Elab
=> False,
149 Generate_Code
=> False,
152 Ident_String
=> Empty
,
153 Is_Predefined_Renaming
=> False,
154 Is_Internal_Unit
=> True,
155 Is_Predefined_Unit
=> True,
161 No_Elab_Code_All
=> False,
162 Primary_Stack_Count
=> 0,
163 Sec_Stack_Count
=> 0,
166 Error_Location
=> No_Location
,
169 -- Parse system.ads so that the checksum is set right. Style checks are
170 -- not applied. The Ekind is set to ensure that this reference is always
171 -- present in the ali file.
174 Save_Mindex
: constant Nat
:= Multiple_Unit_Index
;
175 Save_Style
: constant Boolean := Style_Check
;
177 Multiple_Unit_Index
:= 0;
178 Style_Check
:= False;
179 Initialize_Scanner
(Units
.Last
, System_Source_File_Index
);
180 Discard_List
(Par
(Configuration_Pragmas
=> False));
181 Set_Ekind
(Cunit_Entity
(Units
.Last
), E_Package
);
182 Set_Scope
(Cunit_Entity
(Units
.Last
), Standard_Standard
);
183 Style_Check
:= Save_Style
;
184 Multiple_Unit_Index
:= Save_Mindex
;
186 end Ensure_System_Dependency
;
192 procedure Write_ALI
(Object
: Boolean) is
198 Last_Unit
: constant Unit_Number_Type
:= Units
.Last
;
199 -- Record unit number of last unit. We capture this in case we
200 -- have to add a dummy entry to the unit table for package System.
202 With_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
203 -- Array of flags to show which units are with'ed
205 Elab_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
206 -- Array of flags to show which units have pragma Elaborate set
208 Elab_All_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
209 -- Array of flags to show which units have pragma Elaborate All set
211 Elab_Des_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
212 -- Array of flags to show which units have Elaborate_Desirable set
214 Elab_All_Des_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
215 -- Array of flags to show which units have Elaborate_All_Desirable set
217 type Yes_No
is (Unknown
, Yes
, No
);
218 Has_Implicit_With
: array (Units
.First
.. Last_Unit
) of Yes_No
;
219 -- Indicates if an implicit with has been given for the unit. Yes if
220 -- certainly present, No if certainly absent, Unknown if not known.
222 Sdep_Table
: Unit_Ref_Table
(1 .. Pos
(Last_Unit
- Units
.First
+ 2));
223 -- Sorted table of source dependencies. One extra entry in case we
224 -- have to add a dummy entry for System.
227 -- Number of active entries in Sdep_Table
229 -----------------------
230 -- Local Subprograms --
231 -----------------------
233 procedure Collect_Withs
(Cunit
: Node_Id
);
234 -- Collect with lines for entries in the context clause of the given
235 -- compilation unit, Cunit.
237 procedure Update_Tables_From_ALI_File
;
238 -- Given an up to date ALI file (see Up_To_Date_ALI_file_Exists
239 -- function), update tables from the ALI information, including
240 -- specifically the Compilation_Switches table.
242 function Up_To_Date_ALI_File_Exists
return Boolean;
243 -- If there exists an ALI file that is up to date, then this function
244 -- initializes the tables in the ALI spec to contain information on
245 -- this file (using Scan_ALI) and returns True. If no file exists,
246 -- or the file is not up to date, then False is returned.
248 procedure Write_Unit_Information
(Unit_Num
: Unit_Number_Type
);
249 -- Write out the library information for one unit for which code is
250 -- generated (includes unit line and with lines).
252 procedure Write_With_Lines
;
253 -- Write out with lines collected by calls to Collect_Withs
259 procedure Collect_Withs
(Cunit
: Node_Id
) is
260 function Is_Implicit_With_Clause
(Clause
: Node_Id
) return Boolean;
261 pragma Inline
(Is_Implicit_With_Clause
);
262 -- Determine whether a with clause denoted by Clause is implicit
264 -----------------------------
265 -- Is_Implicit_With_Clause --
266 -----------------------------
268 function Is_Implicit_With_Clause
(Clause
: Node_Id
) return Boolean is
270 -- With clauses created for ancestor units are marked as internal,
271 -- however, they emulate the semantics in Ada RM 10.1.2 (6/2),
276 -- is almost equivalent to
281 -- For ALI encoding purposes, they are considered to be explicit.
282 -- Note that the clauses cannot be marked as explicit because they
283 -- will be subjected to various checks related to with clauses and
284 -- possibly cause false positives.
286 if Parent_With
(Clause
) then
290 return Implicit_With
(Clause
);
292 end Is_Implicit_With_Clause
;
297 Unum
: Unit_Number_Type
;
299 -- Start of processing for Collect_Withs
302 Item
:= First
(Context_Items
(Cunit
));
303 while Present
(Item
) loop
305 -- Process with clause
307 -- Ada 2005 (AI-50217): limited with_clauses do not create
308 -- dependencies, but must be recorded as components of the
309 -- partition, in case there is no regular with_clause for
310 -- the unit anywhere else.
312 if Nkind
(Item
) = N_With_Clause
then
313 Unum
:= Get_Cunit_Unit_Number
(Library_Unit
(Item
));
314 With_Flags
(Unum
) := True;
316 if not Limited_Present
(Item
) then
317 if Elaborate_Present
(Item
) then
318 Elab_Flags
(Unum
) := True;
321 if Elaborate_All_Present
(Item
) then
322 Elab_All_Flags
(Unum
) := True;
325 if Elaborate_All_Desirable
(Item
) then
326 Elab_All_Des_Flags
(Unum
) := True;
329 if Elaborate_Desirable
(Item
) then
330 Elab_Des_Flags
(Unum
) := True;
334 Set_From_Limited_With
(Cunit_Entity
(Unum
));
337 if Is_Implicit_With_Clause
(Item
) then
339 -- A previous explicit with clause withs the unit. Retain
340 -- this classification, as it reflects the source relations
343 if Has_Implicit_With
(Unum
) = No
then
346 -- Otherwise this is either the first time any clause withs
347 -- the unit, or the unit is already implicitly withed.
350 Has_Implicit_With
(Unum
) := Yes
;
353 -- Otherwise the current with clause is explicit. Such clauses
354 -- take precedence over existing implicit clauses because they
355 -- reflect the source relations between unit.
358 Has_Implicit_With
(Unum
) := No
;
366 --------------------------------
367 -- Up_To_Date_ALI_File_Exists --
368 --------------------------------
370 function Up_To_Date_ALI_File_Exists
return Boolean is
371 Name
: File_Name_Type
;
372 Text
: Text_Buffer_Ptr
;
374 Sind
: Source_File_Index
;
377 Opt
.Check_Object_Consistency
:= True;
378 Read_Library_Info
(Name
, Text
);
380 -- Return if we could not find an ALI file
386 -- Return if ALI file has bad format
390 if Scan_ALI
(Name
, Text
, False, Err
=> True) = No_ALI_Id
then
394 -- If we have an OK ALI file, check if it is up to date
395 -- Note that we assume that the ALI read has all the entries
396 -- we have in our table, plus some additional ones (that can
397 -- come from expansion).
399 Id
:= First_Sdep_Entry
;
400 for J
in 1 .. Num_Sdep
loop
401 Sind
:= Units
.Table
(Sdep_Table
(J
)).Source_Index
;
403 while Sdep
.Table
(Id
).Sfile
/= File_Name
(Sind
) loop
404 if Id
= Sdep
.Last
then
411 if Sdep
.Table
(Id
).Stamp
/= Time_Stamp
(Sind
) then
417 end Up_To_Date_ALI_File_Exists
;
419 ---------------------------------
420 -- Update_Tables_From_ALI_File --
421 ---------------------------------
423 procedure Update_Tables_From_ALI_File
is
425 -- Build Compilation_Switches table
427 Compilation_Switches
.Init
;
429 for J
in First_Arg_Entry
.. Args
.Last
loop
430 Compilation_Switches
.Increment_Last
;
431 Compilation_Switches
.Table
(Compilation_Switches
.Last
) :=
434 end Update_Tables_From_ALI_File
;
436 ----------------------------
437 -- Write_Unit_Information --
438 ----------------------------
440 procedure Write_Unit_Information
(Unit_Num
: Unit_Number_Type
) is
441 Unode
: constant Node_Id
:= Cunit
(Unit_Num
);
442 Ukind
: constant Node_Kind
:= Nkind
(Unit
(Unode
));
443 Uent
: constant Entity_Id
:= Cunit_Entity
(Unit_Num
);
447 Write_Info_Initiate
('U');
448 Write_Info_Char
(' ');
449 Write_Info_Name
(Unit_Name
(Unit_Num
));
451 Write_Info_Name
(Unit_File_Name
(Unit_Num
));
454 Write_Info_Str
(Version_Get
(Unit_Num
));
456 -- Add BD parameter if Elaborate_Body pragma desirable
458 if Ekind
(Uent
) = E_Package
459 and then Elaborate_Body_Desirable
(Uent
)
461 Write_Info_Str
(" BD");
464 -- Add BN parameter if body needed for SAL
466 if (Is_Subprogram
(Uent
)
467 or else Ekind
(Uent
) = E_Package
468 or else Is_Generic_Unit
(Uent
))
469 and then Body_Needed_For_SAL
(Uent
)
471 Write_Info_Str
(" BN");
474 if Dynamic_Elab
(Unit_Num
) then
475 Write_Info_Str
(" DE");
478 -- Set the Elaborate_Body indication if either an explicit pragma
479 -- was present, or if this is an instantiation.
481 if Has_Pragma_Elaborate_Body
(Uent
)
482 or else (Ukind
= N_Package_Declaration
483 and then Is_Generic_Instance
(Uent
)
484 and then Present
(Corresponding_Body
(Unit
(Unode
))))
486 Write_Info_Str
(" EB");
489 -- Now see if we should tell the binder that an elaboration entity
490 -- is present, which must be set to true during elaboration.
491 -- We generate the indication if the following condition is met:
493 -- If this is a spec ...
495 if (Is_Subprogram
(Uent
)
496 or else Ekind
(Uent
) = E_Package
497 or else Is_Generic_Unit
(Uent
))
499 -- and an elaboration entity was declared ...
501 and then Present
(Elaboration_Entity
(Uent
))
503 -- and either the elaboration flag is required ...
505 and then (Elaboration_Entity_Required
(Uent
)
507 -- or this unit has elaboration code ...
509 or else not Has_No_Elaboration_Code
(Unode
)
511 -- or this unit has a separate body and this
512 -- body has elaboration code.
515 (Ekind
(Uent
) = E_Package
516 and then Present
(Body_Entity
(Uent
))
518 not Has_No_Elaboration_Code
519 (Parent
(Declaration_Node
(Body_Entity
(Uent
))))))
521 Write_Info_Str
(" EE");
524 if Has_No_Elaboration_Code
(Unode
) then
525 Write_Info_Str
(" NE");
528 Write_Info_Str
(" O");
529 Write_Info_Char
(OA_Setting
(Unit_Num
));
531 if Ekind_In
(Uent
, E_Package
, E_Package_Body
)
532 and then Present
(Finalizer
(Uent
))
534 Write_Info_Str
(" PF");
537 if Is_Preelaborated
(Uent
) then
538 Write_Info_Str
(" PR");
541 if Is_Pure
(Uent
) then
542 Write_Info_Str
(" PU");
545 if Has_RACW
(Unit_Num
) then
546 Write_Info_Str
(" RA");
549 if Is_Remote_Call_Interface
(Uent
) then
550 Write_Info_Str
(" RC");
553 if Is_Remote_Types
(Uent
) then
554 Write_Info_Str
(" RT");
557 if Serious_Errors_Detected
/= 0 then
558 Write_Info_Str
(" SE");
561 if Is_Shared_Passive
(Uent
) then
562 Write_Info_Str
(" SP");
565 if Ukind
= N_Subprogram_Declaration
566 or else Ukind
= N_Subprogram_Body
568 Write_Info_Str
(" SU");
570 elsif Ukind
= N_Package_Declaration
572 Ukind
= N_Package_Body
574 -- If this is a wrapper package for a subprogram instantiation,
575 -- the user view is the subprogram. Note that in this case the
576 -- ali file contains both the spec and body of the instance.
578 if Is_Wrapper_Package
(Uent
) then
579 Write_Info_Str
(" SU");
581 Write_Info_Str
(" PK");
584 elsif Ukind
= N_Generic_Package_Declaration
then
585 Write_Info_Str
(" PK");
589 if Ukind
in N_Generic_Declaration
591 (Present
(Library_Unit
(Unode
))
593 Nkind
(Unit
(Library_Unit
(Unode
))) in N_Generic_Declaration
)
595 Write_Info_Str
(" GE");
598 if not Is_Internal_Unit
(Unit_Num
) then
599 case Identifier_Casing
(Source_Index
(Unit_Num
)) is
600 when All_Lower_Case
=> Write_Info_Str
(" IL");
601 when All_Upper_Case
=> Write_Info_Str
(" IU");
605 case Keyword_Casing
(Source_Index
(Unit_Num
)) is
606 when Mixed_Case
=> Write_Info_Str
(" KM");
607 when All_Upper_Case
=> Write_Info_Str
(" KU");
612 if Initialize_Scalars
or else Invalid_Value_Used
then
613 Write_Info_Str
(" IS");
618 -- Generate with lines, first those that are directly with'ed
620 for J
in With_Flags
'Range loop
621 With_Flags
(J
) := False;
622 Elab_Flags
(J
) := False;
623 Elab_All_Flags
(J
) := False;
624 Elab_Des_Flags
(J
) := False;
625 Elab_All_Des_Flags
(J
) := False;
626 Has_Implicit_With
(J
) := Unknown
;
629 Collect_Withs
(Unode
);
631 -- For a body, we must also check for any subunits which belong to
632 -- it and which have context clauses of their own, since these
633 -- with'ed units are part of its own elaboration dependencies.
635 if Nkind
(Unit
(Unode
)) in N_Unit_Body
then
636 for S
in Units
.First
.. Last_Unit
loop
638 -- We are only interested in subunits. For preproc. data and
639 -- def. files, Cunit is Empty, so we need to test that first.
641 if Cunit
(S
) /= Empty
642 and then Nkind
(Unit
(Cunit
(S
))) = N_Subunit
644 Pnode
:= Library_Unit
(Cunit
(S
));
646 -- In gnatc mode, the errors in the subunits will not have
647 -- been recorded, but the analysis of the subunit may have
648 -- failed. There is no information to add to ALI file in
655 -- Find ultimate parent of the subunit
657 while Nkind
(Unit
(Pnode
)) = N_Subunit
loop
658 Pnode
:= Library_Unit
(Pnode
);
661 -- See if it belongs to current unit, and if so, include
664 if Pnode
= Unode
then
665 Collect_Withs
(Cunit
(S
));
673 -- Generate task stack lines
675 if Primary_Stack_Count
(Unit_Num
) > 0
676 or else Sec_Stack_Count
(Unit_Num
) > 0
678 Write_Info_Initiate
('T');
679 Write_Info_Char
(' ');
680 Write_Info_Int
(Primary_Stack_Count
(Unit_Num
));
681 Write_Info_Char
(' ');
682 Write_Info_Int
(Sec_Stack_Count
(Unit_Num
));
686 -- Generate the linker option lines
688 for J
in 1 .. Linker_Option_Lines
.Last
loop
690 -- Pragma Linker_Options is not allowed in predefined generic
691 -- units. This is because they won't be read, due to the fact that
692 -- with lines for generic units lack the file name and lib name
693 -- parameters (see Lib_Writ spec for an explanation).
695 if Is_Generic_Unit
(Cunit_Entity
(Main_Unit
))
696 and then Is_Predefined_Unit
(Current_Sem_Unit
)
697 and then Linker_Option_Lines
.Table
(J
).Unit
= Unit_Num
701 ("linker options not allowed in predefined generic unit");
702 raise Unrecoverable_Error
;
705 -- Output one linker option line
708 S
: Linker_Option_Entry
renames Linker_Option_Lines
.Table
(J
);
710 if S
.Unit
= Unit_Num
then
711 Write_Info_Initiate
('L');
712 Write_Info_Char
(' ');
713 Write_Info_Slit
(S
.Option
);
721 for J
in 1 .. Notes
.Last
loop
723 N
: constant Node_Id
:= Notes
.Table
(J
);
724 L
: constant Source_Ptr
:= Sloc
(N
);
725 U
: constant Unit_Number_Type
:=
726 Unit
(Get_Source_File_Index
(L
));
729 Note_Unit
: Unit_Number_Type
;
730 -- The unit in whose U section this note must be emitted:
731 -- notes for subunits are emitted along with the main unit;
732 -- all other notes are emitted as part of the enclosing
736 if U
/= No_Unit
and then Nkind
(Unit
(Cunit
(U
))) = N_Subunit
738 Note_Unit
:= Main_Unit
;
743 -- No action needed for pragmas removed by the expander (for
744 -- example, pragmas of ignored ghost entities).
746 if Nkind
(N
) = N_Null_Statement
then
747 pragma Assert
(Nkind
(Original_Node
(N
)) = N_Pragma
);
750 elsif Note_Unit
= Unit_Num
then
751 Write_Info_Initiate
('N');
752 Write_Info_Char
(' ');
754 case Pragma_Name
(N
) is
755 when Name_Annotate
=>
763 when Name_Subtitle
=>
770 Write_Info_Int
(Int
(Get_Logical_Line_Number
(L
)));
771 Write_Info_Char
(':');
772 Write_Info_Int
(Int
(Get_Column_Number
(L
)));
774 -- Indicate source file of annotation if different from
775 -- compilation unit source file (case of annotation coming
778 if Get_Source_File_Index
(L
) /= Source_Index
(Unit_Num
) then
779 Write_Info_Char
(':');
780 Write_Info_Name
(File_Name
(Get_Source_File_Index
(L
)));
787 A
:= First
(Pragma_Argument_Associations
(N
));
788 while Present
(A
) loop
789 Write_Info_Char
(' ');
791 if Chars
(A
) /= No_Name
then
792 Write_Info_Name
(Chars
(A
));
793 Write_Info_Char
(':');
797 Expr
: constant Node_Id
:= Expression
(A
);
800 if Nkind
(Expr
) = N_Identifier
then
801 Write_Info_Name
(Chars
(Expr
));
803 elsif Nkind
(Expr
) = N_Integer_Literal
804 and then Is_OK_Static_Expression
(Expr
)
806 Write_Info_Uint
(Intval
(Expr
));
808 elsif Nkind
(Expr
) = N_String_Literal
809 and then Is_OK_Static_Expression
(Expr
)
811 Write_Info_Slit
(Strval
(Expr
));
814 Write_Info_Str
("<expr>");
826 end Write_Unit_Information
;
828 ----------------------
829 -- Write_With_Lines --
830 ----------------------
832 procedure Write_With_Lines
is
833 Pname
: constant Unit_Name_Type
:=
834 Get_Parent_Spec_Name
(Unit_Name
(Main_Unit
));
835 Body_Fname
: File_Name_Type
;
838 Fname
: File_Name_Type
;
839 Num_Withs
: Int
:= 0;
840 Unum
: Unit_Number_Type
;
841 Uname
: Unit_Name_Type
;
842 With_Table
: Unit_Ref_Table
(1 .. Pos
(Last_Unit
- Units
.First
+ 1));
844 procedure Write_With_File_Names
845 (Nam
: in out File_Name_Type
;
847 -- Write source file name Nam and ALI file name for unit index Idx.
848 -- Possibly change Nam to lowercase (generating a new file name).
850 ---------------------------
851 -- Write_With_File_Names --
852 ---------------------------
854 procedure Write_With_File_Names
855 (Nam
: in out File_Name_Type
;
859 if not File_Names_Case_Sensitive
then
860 Get_Name_String
(Nam
);
861 To_Lower
(Name_Buffer
(1 .. Name_Len
));
865 Write_Info_Name
(Nam
);
867 Write_Info_Name
(Lib_File_Name
(Nam
, Idx
));
868 end Write_With_File_Names
;
870 -- Start of processing for Write_With_Lines
873 -- Loop to build the with table. A with on the main unit itself
874 -- is ignored (AARM 10.2(14a)). Such a with-clause can occur if
875 -- the main unit is a subprogram with no spec, and a subunit of
876 -- it unnecessarily withs the parent.
878 for J
in Units
.First
+ 1 .. Last_Unit
loop
880 -- Add element to with table if it is with'ed or if it is the
881 -- parent spec of the main unit (case of main unit is a child
882 -- unit). The latter with is not needed for semantic purposes,
883 -- but is required by the binder for elaboration purposes. For
884 -- preprocessing data and definition files, there is no Unit_Name,
885 -- check for that first.
887 if Unit_Name
(J
) /= No_Unit_Name
888 and then (With_Flags
(J
) or else Unit_Name
(J
) = Pname
)
890 Num_Withs
:= Num_Withs
+ 1;
891 With_Table
(Num_Withs
) := J
;
895 -- Sort and output the table
897 Sort
(With_Table
(1 .. Num_Withs
));
899 for J
in 1 .. Num_Withs
loop
900 Unum
:= With_Table
(J
);
902 -- Do not generate a with line for an ignored Ghost unit because
903 -- the unit does not have an ALI file.
905 if Is_Ignored_Ghost_Entity
(Cunit_Entity
(Unum
)) then
909 Cunit
:= Units
.Table
(Unum
).Cunit
;
910 Uname
:= Units
.Table
(Unum
).Unit_Name
;
911 Fname
:= Units
.Table
(Unum
).Unit_File_Name
;
913 -- Limited with clauses must be processed first because they are
914 -- the most specific among the three kinds.
916 if Ekind
(Cunit_Entity
(Unum
)) = E_Package
917 and then From_Limited_With
(Cunit_Entity
(Unum
))
919 Write_Info_Initiate
('Y');
921 elsif Has_Implicit_With
(Unum
) = Yes
then
922 Write_Info_Initiate
('Z');
925 Write_Info_Initiate
('W');
928 Write_Info_Char
(' ');
929 Write_Info_Name
(Uname
);
931 -- Now we need to figure out the names of the files that contain
932 -- the with'ed unit. These will usually be the files for the body,
933 -- except in the case of a package that has no body. Note that we
934 -- have a specific exemption here for predefined library generics
935 -- (see comments for Generic_May_Lack_ALI). We do not generate
936 -- dependency upon the ALI file for such units. Older compilers
937 -- used to not support generating code (and ALI) for generics, and
938 -- we want to avoid having different processing (namely, different
939 -- lists of files to be compiled) for different stages of the
942 if not ((Nkind
(Unit
(Cunit
)) in N_Generic_Declaration
944 Nkind
(Unit
(Cunit
)) in N_Generic_Renaming_Declaration
)
945 and then Generic_May_Lack_ALI
(Unum
))
947 -- In SPARK mode, always generate the dependencies on ALI
948 -- files, which are required to compute frame conditions
951 or else GNATprove_Mode
955 if Is_Spec_Name
(Uname
) then
957 -- In GNATprove mode we must write the spec of a unit which
958 -- requires a body if that body is not found. This will
959 -- allow partial analysis on incomplete sources. Also, in
960 -- the case of a unit that is a remote call interface, the
961 -- bodies of packages may not exist but still may form a
962 -- valid program - so we handle that here as well.
965 or else Is_Remote_Call_Interface
(Cunit_Entity
(Unum
))
969 (Uname
=> Get_Body_Name
(Uname
),
973 Body_Index
:= Get_Unit_Index
(Get_Body_Name
(Uname
));
975 if Body_Fname
= No_File
then
976 Body_Fname
:= Get_File_Name
(Uname
, Subunit
=> False);
977 Body_Index
:= Get_Unit_Index
(Uname
);
980 -- In the normal path we don't allow failure in fetching the
981 -- name of the desired body unit so that it may be properly
982 -- referenced in the output ali - even if it is missing.
987 (Uname
=> Get_Body_Name
(Uname
),
991 Body_Index
:= Get_Unit_Index
(Get_Body_Name
(Uname
));
994 Body_Fname
:= Get_File_Name
(Uname
, Subunit
=> False);
995 Body_Index
:= Get_Unit_Index
(Uname
);
998 -- A package is considered to have a body if it requires
999 -- a body or if a body is present in Ada 83 mode.
1001 if Body_Required
(Cunit
)
1002 or else (Ada_Version
= Ada_83
1003 and then Full_Source_Name
(Body_Fname
) /= No_File
)
1005 Write_With_File_Names
(Body_Fname
, Body_Index
);
1007 Write_With_File_Names
(Fname
, Munit_Index
(Unum
));
1010 if Ekind
(Cunit_Entity
(Unum
)) = E_Package
1011 and then From_Limited_With
(Cunit_Entity
(Unum
))
1015 if Elab_Flags
(Unum
) then
1016 Write_Info_Str
(" E");
1019 if Elab_All_Flags
(Unum
) then
1020 Write_Info_Str
(" EA");
1023 if Elab_Des_Flags
(Unum
) then
1024 Write_Info_Str
(" ED");
1027 if Elab_All_Des_Flags
(Unum
) then
1028 Write_Info_Str
(" AD");
1039 -- Finally generate the special lines for cases of Restriction_Set
1040 -- with No_Dependence and no restriction present.
1043 Unam
: Unit_Name_Type
;
1046 for J
in Restriction_Set_Dependences
.First
..
1047 Restriction_Set_Dependences
.Last
1049 Unam
:= Restriction_Set_Dependences
.Table
(J
);
1051 -- Don't need an entry if already in the unit table
1053 for U
in 0 .. Last_Unit
loop
1054 if Unit_Name
(U
) = Unam
then
1055 goto Next_Restriction_Set
;
1059 -- Otherwise generate the entry
1061 Write_Info_Initiate
('W');
1062 Write_Info_Char
(' ');
1063 Write_Info_Name
(Unam
);
1066 <<Next_Restriction_Set
>>
1070 end Write_With_Lines
;
1072 -- Start of processing for Write_ALI
1075 -- We never write an ALI file if the original operating mode was
1076 -- syntax-only (-gnats switch used in compiler invocation line)
1078 if Original_Operating_Mode
= Check_Syntax
then
1082 -- Generation of ALI files may be disabled, e.g. for formal verification
1085 if Disable_ALI_File
then
1089 -- Build sorted source dependency table. We do this right away, because
1090 -- it is referenced by Up_To_Date_ALI_File_Exists.
1092 for Unum
in Units
.First
.. Last_Unit
loop
1093 if Cunit_Entity
(Unum
) = Empty
1094 or else not From_Limited_With
(Cunit_Entity
(Unum
))
1096 -- Units that are not analyzed need not appear in the dependency
1097 -- list. These units are either units appearing in limited_with
1098 -- clauses of other units, or units loaded for inlining that end
1099 -- up not inlined by a later decision of the inlining code, to
1100 -- prevent circularities. We want to exclude these files from the
1101 -- list of dependencies, so that the dependency number of other
1102 -- is correctly set, as that number is used by cross-reference
1103 -- tools to relate entity information to the unit in which they
1106 if Present
(Cunit_Entity
(Unum
))
1107 and then Ekind
(Cunit_Entity
(Unum
)) = E_Void
1108 and then Nkind
(Unit
(Cunit
(Unum
))) /= N_Subunit
1109 and then Serious_Errors_Detected
= 0
1114 Num_Sdep
:= Num_Sdep
+ 1;
1115 Sdep_Table
(Num_Sdep
) := Unum
;
1120 -- Sort the table so that the D lines are in order
1122 Lib
.Sort
(Sdep_Table
(1 .. Num_Sdep
));
1124 -- If we are not generating code, and there is an up to date ALI file
1125 -- file accessible, read it, and acquire the compilation arguments from
1126 -- this file. In GNATprove mode, always generate the ALI file, which
1127 -- contains a special section for formal verification.
1129 if Operating_Mode
/= Generate_Code
and then not GNATprove_Mode
then
1130 if Up_To_Date_ALI_File_Exists
then
1131 Update_Tables_From_ALI_File
;
1136 -- Otherwise acquire compilation arguments and prepare to write out a
1139 Create_Output_Library_Info
;
1141 -- Output version line
1143 Write_Info_Initiate
('V');
1144 Write_Info_Str
(" """);
1145 Write_Info_Str
(Verbose_Library_Version
);
1146 Write_Info_Char
('"');
1150 -- Output main program line if this is acceptable main program
1152 Output_Main_Program_Line
: declare
1153 U
: Node_Id
:= Unit
(Units
.Table
(Main_Unit
).Cunit
);
1156 procedure M_Parameters
;
1157 -- Output parameters for main program line
1163 procedure M_Parameters
is
1165 if Main_Priority
(Main_Unit
) /= Default_Main_Priority
then
1166 Write_Info_Char
(' ');
1167 Write_Info_Nat
(Main_Priority
(Main_Unit
));
1170 if Opt
.Time_Slice_Set
then
1171 Write_Info_Str
(" T=");
1172 Write_Info_Nat
(Opt
.Time_Slice_Value
);
1175 if Main_CPU
(Main_Unit
) /= Default_Main_CPU
then
1176 Write_Info_Str
(" C=");
1177 Write_Info_Nat
(Main_CPU
(Main_Unit
));
1180 Write_Info_Str
(" W=");
1182 (WC_Encoding_Letters
(Wide_Character_Encoding_Method
));
1187 -- Start of processing for Output_Main_Program_Line
1190 if Nkind
(U
) = N_Subprogram_Body
1192 (Nkind
(U
) = N_Package_Body
1194 Nkind
(Original_Node
(U
)) in N_Subprogram_Instantiation
)
1196 -- If the unit is a subprogram instance, the entity for the
1197 -- subprogram is the alias of the visible entity, which is the
1198 -- related instance of the wrapper package. We retrieve the
1199 -- subprogram declaration of the desired entity.
1201 if Nkind
(U
) = N_Package_Body
then
1202 U
:= Parent
(Parent
(
1203 Alias
(Related_Instance
(Defining_Unit_Name
1204 (Specification
(Unit
(Library_Unit
(Parent
(U
)))))))));
1207 S
:= Specification
(U
);
1209 -- A generic subprogram is never a main program
1211 if Nkind
(U
) = N_Subprogram_Body
1212 and then Present
(Corresponding_Spec
(U
))
1214 Ekind_In
(Corresponding_Spec
(U
), E_Generic_Procedure
,
1219 elsif No
(Parameter_Specifications
(S
)) then
1220 if Nkind
(S
) = N_Procedure_Specification
then
1221 Write_Info_Initiate
('M');
1222 Write_Info_Str
(" P");
1227 Nam
: Node_Id
:= Defining_Unit_Name
(S
);
1230 -- If it is a child unit, get its simple name
1232 if Nkind
(Nam
) = N_Defining_Program_Unit_Name
then
1233 Nam
:= Defining_Identifier
(Nam
);
1236 if Is_Integer_Type
(Etype
(Nam
)) then
1237 Write_Info_Initiate
('M');
1238 Write_Info_Str
(" F");
1245 end Output_Main_Program_Line
;
1247 -- Write command argument ('A') lines
1249 for A
in 1 .. Compilation_Switches
.Last
loop
1250 Write_Info_Initiate
('A');
1251 Write_Info_Char
(' ');
1252 Write_Info_Str
(Compilation_Switches
.Table
(A
).all);
1253 Write_Info_Terminate
;
1256 -- Output parameters ('P') line
1258 Write_Info_Initiate
('P');
1260 if Compilation_Errors
then
1261 Write_Info_Str
(" CE");
1264 if Opt
.Detect_Blocking
then
1265 Write_Info_Str
(" DB");
1268 if Tasking_Used
and then not Is_Predefined_Unit
(Main_Unit
) then
1269 if Locking_Policy
/= ' ' then
1270 Write_Info_Str
(" L");
1271 Write_Info_Char
(Locking_Policy
);
1274 if Queuing_Policy
/= ' ' then
1275 Write_Info_Str
(" Q");
1276 Write_Info_Char
(Queuing_Policy
);
1279 if Task_Dispatching_Policy
/= ' ' then
1280 Write_Info_Str
(" T");
1281 Write_Info_Char
(Task_Dispatching_Policy
);
1282 Write_Info_Char
(' ');
1286 if GNATprove_Mode
then
1287 Write_Info_Str
(" GP");
1290 if Partition_Elaboration_Policy
/= ' ' then
1291 Write_Info_Str
(" E");
1292 Write_Info_Char
(Partition_Elaboration_Policy
);
1295 if No_Component_Reordering_Config
then
1296 Write_Info_Str
(" NC");
1300 Write_Info_Str
(" NO");
1303 if No_Run_Time_Mode
then
1304 Write_Info_Str
(" NR");
1307 if Normalize_Scalars
then
1308 Write_Info_Str
(" NS");
1311 if Default_SSO_Config
/= ' ' then
1312 Write_Info_Str
(" O");
1313 Write_Info_Char
(Default_SSO_Config
);
1316 if Sec_Stack_Used
then
1317 Write_Info_Str
(" SS");
1320 if Unreserve_All_Interrupts
then
1321 Write_Info_Str
(" UA");
1324 if Front_End_Exceptions
then
1325 Write_Info_Str
(" FX");
1328 if ZCX_Exceptions
then
1329 Write_Info_Str
(" ZX");
1334 -- Before outputting the restrictions line, update the setting of
1335 -- the No_Elaboration_Code flag. Violations of this restriction
1336 -- cannot be detected until after the backend has been called since
1337 -- it is the backend that sets this flag. We have to check all units
1338 -- for which we have generated code
1340 for Unit
in Units
.First
.. Last_Unit
loop
1341 if Units
.Table
(Unit
).Generate_Code
or else Unit
= Main_Unit
then
1342 if not Has_No_Elaboration_Code
(Cunit
(Unit
)) then
1343 Main_Restrictions
.Violated
(No_Elaboration_Code
) := True;
1348 -- Positional case (only if debug flag -gnatd.R is set)
1350 if Debug_Flag_Dot_RR
then
1352 -- Output first restrictions line
1354 Write_Info_Initiate
('R');
1355 Write_Info_Char
(' ');
1357 -- First the information for the boolean restrictions
1359 for R
in All_Boolean_Restrictions
loop
1360 if Main_Restrictions
.Set
(R
)
1361 and then not Restriction_Warnings
(R
)
1363 Write_Info_Char
('r');
1364 elsif Main_Restrictions
.Violated
(R
) then
1365 Write_Info_Char
('v');
1367 Write_Info_Char
('n');
1371 -- And now the information for the parameter restrictions
1373 for RP
in All_Parameter_Restrictions
loop
1374 if Main_Restrictions
.Set
(RP
)
1375 and then not Restriction_Warnings
(RP
)
1377 Write_Info_Char
('r');
1378 Write_Info_Nat
(Nat
(Main_Restrictions
.Value
(RP
)));
1380 Write_Info_Char
('n');
1383 if not Main_Restrictions
.Violated
(RP
)
1384 or else RP
not in Checked_Parameter_Restrictions
1386 Write_Info_Char
('n');
1388 Write_Info_Char
('v');
1389 Write_Info_Nat
(Nat
(Main_Restrictions
.Count
(RP
)));
1391 if Main_Restrictions
.Unknown
(RP
) then
1392 Write_Info_Char
('+');
1399 -- Named case (if debug flag -gnatd.R is not set)
1406 -- Write RN header line with preceding blank line
1409 Write_Info_Initiate
('R');
1410 Write_Info_Char
('N');
1413 -- First the lines for the boolean restrictions
1415 for R
in All_Boolean_Restrictions
loop
1416 if Main_Restrictions
.Set
(R
)
1417 and then not Restriction_Warnings
(R
)
1420 elsif Main_Restrictions
.Violated
(R
) then
1426 Write_Info_Initiate
('R');
1427 Write_Info_Char
(C
);
1428 Write_Info_Char
(' ');
1429 Write_Info_Str
(All_Boolean_Restrictions
'Image (R
));
1437 -- And now the lines for the parameter restrictions
1439 for RP
in All_Parameter_Restrictions
loop
1440 if Main_Restrictions
.Set
(RP
)
1441 and then not Restriction_Warnings
(RP
)
1443 Write_Info_Initiate
('R');
1444 Write_Info_Str
("R ");
1445 Write_Info_Str
(All_Parameter_Restrictions
'Image (RP
));
1446 Write_Info_Char
('=');
1447 Write_Info_Nat
(Nat
(Main_Restrictions
.Value
(RP
)));
1451 if not Main_Restrictions
.Violated
(RP
)
1452 or else RP
not in Checked_Parameter_Restrictions
1456 Write_Info_Initiate
('R');
1457 Write_Info_Str
("V ");
1458 Write_Info_Str
(All_Parameter_Restrictions
'Image (RP
));
1459 Write_Info_Char
('=');
1460 Write_Info_Nat
(Nat
(Main_Restrictions
.Count
(RP
)));
1462 if Main_Restrictions
.Unknown
(RP
) then
1463 Write_Info_Char
('+');
1471 -- Output R lines for No_Dependence entries
1473 for J
in No_Dependences
.First
.. No_Dependences
.Last
loop
1474 if In_Extended_Main_Source_Unit
(No_Dependences
.Table
(J
).Unit
)
1475 and then not No_Dependences
.Table
(J
).Warn
1477 Write_Info_Initiate
('R');
1478 Write_Info_Char
(' ');
1479 Write_Unit_Name
(No_Dependences
.Table
(J
).Unit
);
1484 -- Output interrupt state lines
1486 for J
in Interrupt_States
.First
.. Interrupt_States
.Last
loop
1487 Write_Info_Initiate
('I');
1488 Write_Info_Char
(' ');
1489 Write_Info_Nat
(Interrupt_States
.Table
(J
).Interrupt_Number
);
1490 Write_Info_Char
(' ');
1491 Write_Info_Char
(Interrupt_States
.Table
(J
).Interrupt_State
);
1492 Write_Info_Char
(' ');
1494 (Nat
(Get_Logical_Line_Number
1495 (Interrupt_States
.Table
(J
).Pragma_Loc
)));
1499 -- Output priority specific dispatching lines
1501 for J
in Specific_Dispatching
.First
.. Specific_Dispatching
.Last
loop
1502 Write_Info_Initiate
('S');
1503 Write_Info_Char
(' ');
1504 Write_Info_Char
(Specific_Dispatching
.Table
(J
).Dispatching_Policy
);
1505 Write_Info_Char
(' ');
1506 Write_Info_Nat
(Specific_Dispatching
.Table
(J
).First_Priority
);
1507 Write_Info_Char
(' ');
1508 Write_Info_Nat
(Specific_Dispatching
.Table
(J
).Last_Priority
);
1509 Write_Info_Char
(' ');
1511 (Nat
(Get_Logical_Line_Number
1512 (Specific_Dispatching
.Table
(J
).Pragma_Loc
)));
1516 -- Loop through file table to output information for all units for which
1517 -- we have generated code, as marked by the Generate_Code flag.
1519 for Unit
in Units
.First
.. Last_Unit
loop
1520 if Units
.Table
(Unit
).Generate_Code
1521 or else Unit
= Main_Unit
1523 Write_Info_EOL
; -- blank line
1524 Write_Unit_Information
(Unit
);
1528 Write_Info_EOL
; -- blank line
1530 -- Output external version reference lines
1532 for J
in 1 .. Version_Ref
.Last
loop
1533 Write_Info_Initiate
('E');
1534 Write_Info_Char
(' ');
1536 for K
in 1 .. String_Length
(Version_Ref
.Table
(J
)) loop
1537 Write_Info_Char_Code
(Get_String_Char
(Version_Ref
.Table
(J
), K
));
1543 -- Prepare to output the source dependency lines
1546 Unum
: Unit_Number_Type
;
1547 -- Number of unit being output
1549 Sind
: Source_File_Index
;
1550 -- Index of corresponding source file
1552 Fname
: File_Name_Type
;
1555 for J
in 1 .. Num_Sdep
loop
1556 Unum
:= Sdep_Table
(J
);
1557 Units
.Table
(Unum
).Dependency_Num
:= J
;
1558 Sind
:= Units
.Table
(Unum
).Source_Index
;
1560 Write_Info_Initiate
('D');
1561 Write_Info_Char
(' ');
1563 -- Normal case of a unit entry with a source index
1565 if Sind
> No_Source_File
then
1566 -- We never want directory information in ALI files
1567 -- ???But back out this change temporarily until
1568 -- gprbuild is fixed.
1571 Fname
:= Strip_Directory
(File_Name
(Sind
));
1573 Fname
:= File_Name
(Sind
);
1576 -- Ensure that on platforms where the file names are not
1577 -- case sensitive, the recorded file name is in lower case.
1579 if not File_Names_Case_Sensitive
then
1580 Get_Name_String
(Fname
);
1581 To_Lower
(Name_Buffer
(1 .. Name_Len
));
1585 Write_Info_Name_May_Be_Quoted
(Fname
);
1586 Write_Info_Tab
(25);
1587 Write_Info_Str
(String (Time_Stamp
(Sind
)));
1588 Write_Info_Char
(' ');
1589 Write_Info_Str
(Get_Hex_String
(Source_Checksum
(Sind
)));
1591 -- If the dependency comes from a limited_with clause, record
1592 -- limited_checksum. This is disabled until full checksum
1593 -- changes are checked.
1595 -- if Present (Cunit_Entity (Unum))
1596 -- and then From_Limited_With (Cunit_Entity (Unum))
1598 -- Write_Info_Char (' ');
1599 -- Write_Info_Char ('Y');
1600 -- Write_Info_Str (Get_Hex_String (Limited_Chk_Sum (Sind)));
1603 -- If subunit, add unit name, omitting the %b at the end
1605 if Present
(Cunit
(Unum
)) then
1606 Get_Decoded_Name_String
(Unit_Name
(Unum
));
1607 Write_Info_Char
(' ');
1609 if Nkind
(Unit
(Cunit
(Unum
))) = N_Subunit
then
1610 Write_Info_Str
(Name_Buffer
(1 .. Name_Len
- 2));
1612 Write_Info_Str
(Name_Buffer
(1 .. Name_Len
));
1616 -- If Source_Reference pragma used, output information
1618 if Num_SRef_Pragmas
(Sind
) > 0 then
1619 Write_Info_Char
(' ');
1621 if Num_SRef_Pragmas
(Sind
) = 1 then
1622 Write_Info_Nat
(Int
(First_Mapped_Line
(Sind
)));
1627 Write_Info_Char
(':');
1628 Write_Info_Name
(Reference_Name
(Sind
));
1631 -- Case where there is no source index (happens for missing
1632 -- files). In this case we write a dummy time stamp.
1635 Write_Info_Name
(Unit_File_Name
(Unum
));
1636 Write_Info_Tab
(25);
1637 Write_Info_Str
(String (Dummy_Time_Stamp
));
1638 Write_Info_Char
(' ');
1639 Write_Info_Str
(Get_Hex_String
(0));
1646 -- Output cross-references
1648 if Opt
.Xref_Active
then
1652 -- Output SCO information if present
1654 if Generate_SCO
then
1655 SCO_Record_Filtered
;
1659 -- Output final blank line and we are done. This final blank line is
1660 -- probably junk, but we don't feel like making an incompatible change.
1662 Write_Info_Terminate
;
1663 Close_Output_Library_Info
;
1666 ---------------------
1667 -- Write_Unit_Name --
1668 ---------------------
1670 procedure Write_Unit_Name
(N
: Node_Id
) is
1672 if Nkind
(N
) = N_Identifier
then
1673 Write_Info_Name
(Chars
(N
));
1676 pragma Assert
(Nkind
(N
) = N_Selected_Component
);
1677 Write_Unit_Name
(Prefix
(N
));
1678 Write_Info_Char
('.');
1679 Write_Unit_Name
(Selector_Name
(N
));
1681 end Write_Unit_Name
;