1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2015, 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
;
47 with Sem_Eval
; use Sem_Eval
;
48 with Sinfo
; use Sinfo
;
49 with Sinput
; use Sinput
;
50 with Snames
; use Snames
;
51 with Stringt
; use Stringt
;
52 with Tbuild
; use Tbuild
;
53 with Uname
; use Uname
;
55 with System
.Case_Util
; use System
.Case_Util
;
56 with System
.WCh_Con
; use System
.WCh_Con
;
58 package body Lib
.Writ
is
60 -----------------------
61 -- Local Subprograms --
62 -----------------------
64 procedure Write_Unit_Name
(N
: Node_Id
);
65 -- Used to write out the unit name for R (pragma Restriction) lines
66 -- for uses of Restriction (No_Dependence => unit-name).
68 ----------------------------------
69 -- Add_Preprocessing_Dependency --
70 ----------------------------------
72 procedure Add_Preprocessing_Dependency
(S
: Source_File_Index
) is
75 Units
.Table
(Units
.Last
) :=
76 (Unit_File_Name
=> File_Name
(S
),
77 Unit_Name
=> No_Unit_Name
,
78 Expected_Unit
=> No_Unit_Name
,
81 Cunit_Entity
=> Empty
,
83 Dynamic_Elab
=> False,
85 Generate_Code
=> False,
88 Ident_String
=> Empty
,
93 No_Elab_Code_All
=> False,
96 Error_Location
=> No_Location
,
98 SPARK_Mode_Pragma
=> Empty
);
99 end Add_Preprocessing_Dependency
;
101 ------------------------------
102 -- Ensure_System_Dependency --
103 ------------------------------
105 procedure Ensure_System_Dependency
is
106 System_Uname
: Unit_Name_Type
;
107 -- Unit name for system spec if needed for dummy entry
109 System_Fname
: File_Name_Type
;
110 -- File name for system spec if needed for dummy entry
113 -- Nothing to do if we already compiled System
115 for Unum
in Units
.First
.. Last_Unit
loop
116 if Units
.Table
(Unum
).Source_Index
= System_Source_File_Index
then
121 -- If no entry for system.ads in the units table, then add a entry
122 -- to the units table for system.ads, which will be referenced when
123 -- the ali file is generated. We need this because every unit depends
124 -- on system as a result of Targparm scanning the system.ads file to
125 -- determine the target dependent parameters for the compilation.
128 Name_Buffer
(1 .. 6) := "system";
129 System_Uname
:= Name_To_Unit_Name
(Name_Enter
);
130 System_Fname
:= File_Name
(System_Source_File_Index
);
132 Units
.Increment_Last
;
133 Units
.Table
(Units
.Last
) := (
134 Unit_File_Name
=> System_Fname
,
135 Unit_Name
=> System_Uname
,
136 Expected_Unit
=> System_Uname
,
137 Source_Index
=> System_Source_File_Index
,
139 Cunit_Entity
=> Empty
,
141 Dynamic_Elab
=> False,
143 Generate_Code
=> False,
146 Ident_String
=> Empty
,
151 No_Elab_Code_All
=> False,
154 Error_Location
=> No_Location
,
156 SPARK_Mode_Pragma
=> Empty
);
158 -- Parse system.ads so that the checksum is set right
159 -- Style checks are not applied.
162 Save_Mindex
: constant Nat
:= Multiple_Unit_Index
;
163 Save_Style
: constant Boolean := Style_Check
;
165 Multiple_Unit_Index
:= 0;
166 Style_Check
:= False;
167 Initialize_Scanner
(Units
.Last
, System_Source_File_Index
);
168 Discard_List
(Par
(Configuration_Pragmas
=> False));
169 Style_Check
:= Save_Style
;
170 Multiple_Unit_Index
:= Save_Mindex
;
172 end Ensure_System_Dependency
;
178 procedure Write_ALI
(Object
: Boolean) is
184 Last_Unit
: constant Unit_Number_Type
:= Units
.Last
;
185 -- Record unit number of last unit. We capture this in case we
186 -- have to add a dummy entry to the unit table for package System.
188 With_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
189 -- Array of flags to show which units are with'ed
191 Elab_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
192 -- Array of flags to show which units have pragma Elaborate set
194 Elab_All_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
195 -- Array of flags to show which units have pragma Elaborate All set
197 Elab_Des_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
198 -- Array of flags to show which units have Elaborate_Desirable set
200 Elab_All_Des_Flags
: array (Units
.First
.. Last_Unit
) of Boolean;
201 -- Array of flags to show which units have Elaborate_All_Desirable set
203 type Yes_No
is (Unknown
, Yes
, No
);
204 Implicit_With
: array (Units
.First
.. Last_Unit
) of Yes_No
;
205 -- Indicates if an implicit with has been given for the unit. Yes if
206 -- certainly present, no if certainly absent, unkonwn if not known.
208 Sdep_Table
: Unit_Ref_Table
(1 .. Pos
(Last_Unit
- Units
.First
+ 2));
209 -- Sorted table of source dependencies. One extra entry in case we
210 -- have to add a dummy entry for System.
213 -- Number of active entries in Sdep_Table
215 flag_compare_debug
: Int
;
216 pragma Import
(C
, flag_compare_debug
);
217 -- Import from toplev.c
219 -----------------------
220 -- Local Subprograms --
221 -----------------------
223 procedure Collect_Withs
(Cunit
: Node_Id
);
224 -- Collect with lines for entries in the context clause of the
225 -- given compilation unit, Cunit.
227 procedure Update_Tables_From_ALI_File
;
228 -- Given an up to date ALI file (see Up_To_Date_ALI_file_Exists
229 -- function), update tables from the ALI information, including
230 -- specifically the Compilation_Switches table.
232 function Up_To_Date_ALI_File_Exists
return Boolean;
233 -- If there exists an ALI file that is up to date, then this function
234 -- initializes the tables in the ALI spec to contain information on
235 -- this file (using Scan_ALI) and returns True. If no file exists,
236 -- or the file is not up to date, then False is returned.
238 procedure Write_Unit_Information
(Unit_Num
: Unit_Number_Type
);
239 -- Write out the library information for one unit for which code is
240 -- generated (includes unit line and with lines).
242 procedure Write_With_Lines
;
243 -- Write out with lines collected by calls to Collect_Withs
249 procedure Collect_Withs
(Cunit
: Node_Id
) is
251 Unum
: Unit_Number_Type
;
254 Item
:= First
(Context_Items
(Cunit
));
255 while Present
(Item
) loop
257 -- Process with clause
259 -- Ada 2005 (AI-50217): limited with_clauses do not create
260 -- dependencies, but must be recorded as components of the
261 -- partition, in case there is no regular with_clause for
262 -- the unit anywhere else.
264 if Nkind
(Item
) = N_With_Clause
then
265 Unum
:= Get_Cunit_Unit_Number
(Library_Unit
(Item
));
266 With_Flags
(Unum
) := True;
268 if not Limited_Present
(Item
) then
269 if Elaborate_Present
(Item
) then
270 Elab_Flags
(Unum
) := True;
273 if Elaborate_All_Present
(Item
) then
274 Elab_All_Flags
(Unum
) := True;
277 if Elaborate_All_Desirable
(Item
) then
278 Elab_All_Des_Flags
(Unum
) := True;
281 if Elaborate_Desirable
(Item
) then
282 Elab_Des_Flags
(Unum
) := True;
286 Set_From_Limited_With
(Cunit_Entity
(Unum
));
289 if Implicit_With
(Unum
) /= Yes
then
290 if Implicit_With_From_Instantiation
(Item
) then
291 Implicit_With
(Unum
) := Yes
;
293 Implicit_With
(Unum
) := No
;
302 --------------------------------
303 -- Up_To_Date_ALI_File_Exists --
304 --------------------------------
306 function Up_To_Date_ALI_File_Exists
return Boolean is
307 Name
: File_Name_Type
;
308 Text
: Text_Buffer_Ptr
;
310 Sind
: Source_File_Index
;
313 Opt
.Check_Object_Consistency
:= True;
314 Read_Library_Info
(Name
, Text
);
316 -- Return if we could not find an ALI file
322 -- Return if ALI file has bad format
326 if Scan_ALI
(Name
, Text
, False, Err
=> True) = No_ALI_Id
then
330 -- If we have an OK ALI file, check if it is up to date
331 -- Note that we assume that the ALI read has all the entries
332 -- we have in our table, plus some additional ones (that can
333 -- come from expansion).
335 Id
:= First_Sdep_Entry
;
336 for J
in 1 .. Num_Sdep
loop
337 Sind
:= Units
.Table
(Sdep_Table
(J
)).Source_Index
;
339 while Sdep
.Table
(Id
).Sfile
/= File_Name
(Sind
) loop
340 if Id
= Sdep
.Last
then
347 if Sdep
.Table
(Id
).Stamp
/= Time_Stamp
(Sind
) then
353 end Up_To_Date_ALI_File_Exists
;
355 ---------------------------------
356 -- Update_Tables_From_ALI_File --
357 ---------------------------------
359 procedure Update_Tables_From_ALI_File
is
361 -- Build Compilation_Switches table
363 Compilation_Switches
.Init
;
365 for J
in First_Arg_Entry
.. Args
.Last
loop
366 Compilation_Switches
.Increment_Last
;
367 Compilation_Switches
.Table
(Compilation_Switches
.Last
) :=
370 end Update_Tables_From_ALI_File
;
372 ----------------------------
373 -- Write_Unit_Information --
374 ----------------------------
376 procedure Write_Unit_Information
(Unit_Num
: Unit_Number_Type
) is
377 Unode
: constant Node_Id
:= Cunit
(Unit_Num
);
378 Ukind
: constant Node_Kind
:= Nkind
(Unit
(Unode
));
379 Uent
: constant Entity_Id
:= Cunit_Entity
(Unit_Num
);
383 Write_Info_Initiate
('U');
384 Write_Info_Char
(' ');
385 Write_Info_Name
(Unit_Name
(Unit_Num
));
387 Write_Info_Name
(Unit_File_Name
(Unit_Num
));
390 Write_Info_Str
(Version_Get
(Unit_Num
));
392 -- Add BD parameter if Elaborate_Body pragma desirable
394 if Ekind
(Uent
) = E_Package
395 and then Elaborate_Body_Desirable
(Uent
)
397 Write_Info_Str
(" BD");
400 -- Add BN parameter if body needed for SAL
402 if (Is_Subprogram
(Uent
)
403 or else Ekind
(Uent
) = E_Package
404 or else Is_Generic_Unit
(Uent
))
405 and then Body_Needed_For_SAL
(Uent
)
407 Write_Info_Str
(" BN");
410 if Dynamic_Elab
(Unit_Num
) then
411 Write_Info_Str
(" DE");
414 -- Set the Elaborate_Body indication if either an explicit pragma
415 -- was present, or if this is an instantiation.
417 if Has_Pragma_Elaborate_Body
(Uent
)
418 or else (Ukind
= N_Package_Declaration
419 and then Is_Generic_Instance
(Uent
)
420 and then Present
(Corresponding_Body
(Unit
(Unode
))))
422 Write_Info_Str
(" EB");
425 -- Now see if we should tell the binder that an elaboration entity
426 -- is present, which must be set to true during elaboration.
427 -- We generate the indication if the following condition is met:
429 -- If this is a spec ...
431 if (Is_Subprogram
(Uent
)
432 or else Ekind
(Uent
) = E_Package
433 or else Is_Generic_Unit
(Uent
))
435 -- and an elaboration entity was declared ...
437 and then Present
(Elaboration_Entity
(Uent
))
439 -- and either the elaboration flag is required ...
441 and then (Elaboration_Entity_Required
(Uent
)
443 -- or this unit has elaboration code ...
445 or else not Has_No_Elaboration_Code
(Unode
)
447 -- or this unit has a separate body and this
448 -- body has elaboration code.
451 (Ekind
(Uent
) = E_Package
452 and then Present
(Body_Entity
(Uent
))
454 not Has_No_Elaboration_Code
455 (Parent
(Declaration_Node
(Body_Entity
(Uent
))))))
457 Write_Info_Str
(" EE");
460 if Has_No_Elaboration_Code
(Unode
) then
461 Write_Info_Str
(" NE");
464 Write_Info_Str
(" O");
465 Write_Info_Char
(OA_Setting
(Unit_Num
));
467 if Ekind_In
(Uent
, E_Package
, E_Package_Body
)
468 and then Present
(Finalizer
(Uent
))
470 Write_Info_Str
(" PF");
473 if Is_Preelaborated
(Uent
) then
474 Write_Info_Str
(" PR");
477 if Is_Pure
(Uent
) then
478 Write_Info_Str
(" PU");
481 if Has_RACW
(Unit_Num
) then
482 Write_Info_Str
(" RA");
485 if Is_Remote_Call_Interface
(Uent
) then
486 Write_Info_Str
(" RC");
489 if Is_Remote_Types
(Uent
) then
490 Write_Info_Str
(" RT");
493 if Serious_Errors_Detected
/= 0 then
494 Write_Info_Str
(" SE");
497 if Is_Shared_Passive
(Uent
) then
498 Write_Info_Str
(" SP");
501 if Ukind
= N_Subprogram_Declaration
502 or else Ukind
= N_Subprogram_Body
504 Write_Info_Str
(" SU");
506 elsif Ukind
= N_Package_Declaration
508 Ukind
= N_Package_Body
510 -- If this is a wrapper package for a subprogram instantiation,
511 -- the user view is the subprogram. Note that in this case the
512 -- ali file contains both the spec and body of the instance.
514 if Is_Wrapper_Package
(Uent
) then
515 Write_Info_Str
(" SU");
517 Write_Info_Str
(" PK");
520 elsif Ukind
= N_Generic_Package_Declaration
then
521 Write_Info_Str
(" PK");
525 if Ukind
in N_Generic_Declaration
527 (Present
(Library_Unit
(Unode
))
529 Nkind
(Unit
(Library_Unit
(Unode
))) in N_Generic_Declaration
)
531 Write_Info_Str
(" GE");
534 if not Is_Internal_File_Name
(Unit_File_Name
(Unit_Num
), True) then
535 case Identifier_Casing
(Source_Index
(Unit_Num
)) is
536 when All_Lower_Case
=> Write_Info_Str
(" IL");
537 when All_Upper_Case
=> Write_Info_Str
(" IU");
541 case Keyword_Casing
(Source_Index
(Unit_Num
)) is
542 when Mixed_Case
=> Write_Info_Str
(" KM");
543 when All_Upper_Case
=> Write_Info_Str
(" KU");
548 if Initialize_Scalars
or else Invalid_Value_Used
then
549 Write_Info_Str
(" IS");
554 -- Generate with lines, first those that are directly with'ed
556 for J
in With_Flags
'Range loop
557 With_Flags
(J
) := False;
558 Elab_Flags
(J
) := False;
559 Elab_All_Flags
(J
) := False;
560 Elab_Des_Flags
(J
) := False;
561 Elab_All_Des_Flags
(J
) := False;
562 Implicit_With
(J
) := Unknown
;
565 Collect_Withs
(Unode
);
567 -- For a body, we must also check for any subunits which belong to
568 -- it and which have context clauses of their own, since these
569 -- with'ed units are part of its own elaboration dependencies.
571 if Nkind
(Unit
(Unode
)) in N_Unit_Body
then
572 for S
in Units
.First
.. Last_Unit
loop
574 -- We are only interested in subunits. For preproc. data and
575 -- def. files, Cunit is Empty, so we need to test that first.
577 if Cunit
(S
) /= Empty
578 and then Nkind
(Unit
(Cunit
(S
))) = N_Subunit
580 Pnode
:= Library_Unit
(Cunit
(S
));
582 -- In gnatc mode, the errors in the subunits will not have
583 -- been recorded, but the analysis of the subunit may have
584 -- failed. There is no information to add to ALI file in
591 -- Find ultimate parent of the subunit
593 while Nkind
(Unit
(Pnode
)) = N_Subunit
loop
594 Pnode
:= Library_Unit
(Pnode
);
597 -- See if it belongs to current unit, and if so, include
600 if Pnode
= Unode
then
601 Collect_Withs
(Cunit
(S
));
609 -- Generate the linker option lines
611 for J
in 1 .. Linker_Option_Lines
.Last
loop
613 -- Pragma Linker_Options is not allowed in predefined generic
614 -- units. This is because they won't be read, due to the fact that
615 -- with lines for generic units lack the file name and lib name
616 -- parameters (see Lib_Writ spec for an explanation).
618 if Is_Generic_Unit
(Cunit_Entity
(Main_Unit
))
620 Is_Predefined_File_Name
(Unit_File_Name
(Current_Sem_Unit
))
621 and then Linker_Option_Lines
.Table
(J
).Unit
= Unit_Num
625 ("linker options not allowed in predefined generic unit");
626 raise Unrecoverable_Error
;
629 -- Output one linker option line
632 S
: Linker_Option_Entry
renames Linker_Option_Lines
.Table
(J
);
634 if S
.Unit
= Unit_Num
then
635 Write_Info_Initiate
('L');
636 Write_Info_Char
(' ');
637 Write_Info_Slit
(S
.Option
);
645 for J
in 1 .. Notes
.Last
loop
647 N
: constant Node_Id
:= Notes
.Table
(J
);
648 L
: constant Source_Ptr
:= Sloc
(N
);
649 U
: constant Unit_Number_Type
:=
650 Unit
(Get_Source_File_Index
(L
));
653 Note_Unit
: Unit_Number_Type
;
654 -- The unit in whose U section this note must be emitted:
655 -- notes for subunits are emitted along with the main unit;
656 -- all other notes are emitted as part of the enclosing
660 if U
/= No_Unit
and then Nkind
(Unit
(Cunit
(U
))) = N_Subunit
662 Note_Unit
:= Main_Unit
;
667 if Note_Unit
= Unit_Num
then
668 Write_Info_Initiate
('N');
669 Write_Info_Char
(' ');
671 case Chars
(Pragma_Identifier
(N
)) is
672 when Name_Annotate
=>
680 when Name_Subtitle
=>
687 Write_Info_Int
(Int
(Get_Logical_Line_Number
(L
)));
688 Write_Info_Char
(':');
689 Write_Info_Int
(Int
(Get_Column_Number
(L
)));
691 -- Indicate source file of annotation if different from
692 -- compilation unit source file (case of annotation coming
695 if Get_Source_File_Index
(L
) /= Source_Index
(Unit_Num
) then
696 Write_Info_Char
(':');
697 Write_Info_Name
(File_Name
(Get_Source_File_Index
(L
)));
704 A
:= First
(Pragma_Argument_Associations
(N
));
705 while Present
(A
) loop
706 Write_Info_Char
(' ');
708 if Chars
(A
) /= No_Name
then
709 Write_Info_Name
(Chars
(A
));
710 Write_Info_Char
(':');
714 Expr
: constant Node_Id
:= Expression
(A
);
717 if Nkind
(Expr
) = N_Identifier
then
718 Write_Info_Name
(Chars
(Expr
));
720 elsif Nkind
(Expr
) = N_Integer_Literal
721 and then Is_OK_Static_Expression
(Expr
)
723 Write_Info_Uint
(Intval
(Expr
));
725 elsif Nkind
(Expr
) = N_String_Literal
726 and then Is_OK_Static_Expression
(Expr
)
728 Write_Info_Slit
(Strval
(Expr
));
731 Write_Info_Str
("<expr>");
743 end Write_Unit_Information
;
745 ----------------------
746 -- Write_With_Lines --
747 ----------------------
749 procedure Write_With_Lines
is
750 With_Table
: Unit_Ref_Table
(1 .. Pos
(Last_Unit
- Units
.First
+ 1));
751 Num_Withs
: Int
:= 0;
752 Unum
: Unit_Number_Type
;
754 Uname
: Unit_Name_Type
;
755 Fname
: File_Name_Type
;
756 Pname
: constant Unit_Name_Type
:=
757 Get_Parent_Spec_Name
(Unit_Name
(Main_Unit
));
758 Body_Fname
: File_Name_Type
;
761 procedure Write_With_File_Names
762 (Nam
: in out File_Name_Type
;
764 -- Write source file name Nam and ALI file name for unit index Idx.
765 -- Possibly change Nam to lowercase (generating a new file name).
767 --------------------------
768 -- Write_With_File_Name --
769 --------------------------
771 procedure Write_With_File_Names
772 (Nam
: in out File_Name_Type
;
776 if not File_Names_Case_Sensitive
then
777 Get_Name_String
(Nam
);
778 To_Lower
(Name_Buffer
(1 .. Name_Len
));
782 Write_Info_Name
(Nam
);
784 Write_Info_Name
(Lib_File_Name
(Nam
, Idx
));
785 end Write_With_File_Names
;
787 -- Start of processing for Write_With_Lines
790 -- Loop to build the with table. A with on the main unit itself
791 -- is ignored (AARM 10.2(14a)). Such a with-clause can occur if
792 -- the main unit is a subprogram with no spec, and a subunit of
793 -- it unnecessarily withs the parent.
795 for J
in Units
.First
+ 1 .. Last_Unit
loop
797 -- Add element to with table if it is with'ed or if it is the
798 -- parent spec of the main unit (case of main unit is a child
799 -- unit). The latter with is not needed for semantic purposes,
800 -- but is required by the binder for elaboration purposes. For
801 -- preprocessing data and definition files, there is no Unit_Name,
802 -- check for that first.
804 if Unit_Name
(J
) /= No_Unit_Name
805 and then (With_Flags
(J
) or else Unit_Name
(J
) = Pname
)
807 Num_Withs
:= Num_Withs
+ 1;
808 With_Table
(Num_Withs
) := J
;
812 -- Sort and output the table
814 Sort
(With_Table
(1 .. Num_Withs
));
816 for J
in 1 .. Num_Withs
loop
817 Unum
:= With_Table
(J
);
818 Cunit
:= Units
.Table
(Unum
).Cunit
;
819 Uname
:= Units
.Table
(Unum
).Unit_Name
;
820 Fname
:= Units
.Table
(Unum
).Unit_File_Name
;
822 if Implicit_With
(Unum
) = Yes
then
823 Write_Info_Initiate
('Z');
825 elsif Ekind
(Cunit_Entity
(Unum
)) = E_Package
826 and then From_Limited_With
(Cunit_Entity
(Unum
))
828 Write_Info_Initiate
('Y');
831 Write_Info_Initiate
('W');
834 Write_Info_Char
(' ');
835 Write_Info_Name
(Uname
);
837 -- Now we need to figure out the names of the files that contain
838 -- the with'ed unit. These will usually be the files for the body,
839 -- except in the case of a package that has no body. Note that we
840 -- have a specific exemption here for predefined library generics
841 -- (see comments for Generic_May_Lack_ALI). We do not generate
842 -- dependency upon the ALI file for such units. Older compilers
843 -- used to not support generating code (and ALI) for generics, and
844 -- we want to avoid having different processing (namely, different
845 -- lists of files to be compiled) for different stages of the
848 if not ((Nkind
(Unit
(Cunit
)) in N_Generic_Declaration
850 Nkind
(Unit
(Cunit
)) in N_Generic_Renaming_Declaration
)
851 and then Generic_May_Lack_ALI
(Fname
))
853 -- In SPARK mode, always generate the dependencies on ALI
854 -- files, which are required to compute frame conditions
857 or else GNATprove_Mode
861 if Is_Spec_Name
(Uname
) then
864 (Get_Body_Name
(Uname
),
865 Subunit
=> False, May_Fail
=> True);
869 (Get_Body_Name
(Uname
));
871 if Body_Fname
= No_File
then
872 Body_Fname
:= Get_File_Name
(Uname
, Subunit
=> False);
873 Body_Index
:= Get_Unit_Index
(Uname
);
877 Body_Fname
:= Get_File_Name
(Uname
, Subunit
=> False);
878 Body_Index
:= Get_Unit_Index
(Uname
);
881 -- A package is considered to have a body if it requires
882 -- a body or if a body is present in Ada 83 mode.
884 if Body_Required
(Cunit
)
885 or else (Ada_Version
= Ada_83
886 and then Full_Source_Name
(Body_Fname
) /= No_File
)
888 Write_With_File_Names
(Body_Fname
, Body_Index
);
890 Write_With_File_Names
(Fname
, Munit_Index
(Unum
));
893 if Ekind
(Cunit_Entity
(Unum
)) = E_Package
894 and then From_Limited_With
(Cunit_Entity
(Unum
))
898 if Elab_Flags
(Unum
) then
899 Write_Info_Str
(" E");
902 if Elab_All_Flags
(Unum
) then
903 Write_Info_Str
(" EA");
906 if Elab_Des_Flags
(Unum
) then
907 Write_Info_Str
(" ED");
910 if Elab_All_Des_Flags
(Unum
) then
911 Write_Info_Str
(" AD");
919 -- Finally generate the special lines for cases of Restriction_Set
920 -- with No_Dependence and no restriction present.
923 Unam
: Unit_Name_Type
;
926 for J
in Restriction_Set_Dependences
.First
..
927 Restriction_Set_Dependences
.Last
929 Unam
:= Restriction_Set_Dependences
.Table
(J
);
931 -- Don't need an entry if already in the unit table
933 for U
in 0 .. Last_Unit
loop
934 if Unit_Name
(U
) = Unam
then
939 -- Otherwise generate the entry
941 Write_Info_Initiate
('W');
942 Write_Info_Char
(' ');
943 Write_Info_Name
(Unam
);
950 end Write_With_Lines
;
952 -- Start of processing for Write_ALI
955 -- We never write an ALI file if the original operating mode was
956 -- syntax-only (-gnats switch used in compiler invocation line)
958 if Original_Operating_Mode
= Check_Syntax
959 or flag_compare_debug
/= 0
964 -- Generation of ALI files may be disabled, e.g. for formal verification
967 if Disable_ALI_File
then
971 -- Build sorted source dependency table. We do this right away, because
972 -- it is referenced by Up_To_Date_ALI_File_Exists.
974 for Unum
in Units
.First
.. Last_Unit
loop
975 if Cunit_Entity
(Unum
) = Empty
976 or else not From_Limited_With
(Cunit_Entity
(Unum
))
978 Num_Sdep
:= Num_Sdep
+ 1;
979 Sdep_Table
(Num_Sdep
) := Unum
;
983 -- Sort the table so that the D lines are in order
985 Lib
.Sort
(Sdep_Table
(1 .. Num_Sdep
));
987 -- If we are not generating code, and there is an up to date ALI file
988 -- file accessible, read it, and acquire the compilation arguments from
989 -- this file. In GNATprove mode, always generate the ALI file, which
990 -- contains a special section for formal verification.
992 if Operating_Mode
/= Generate_Code
and then not GNATprove_Mode
then
993 if Up_To_Date_ALI_File_Exists
then
994 Update_Tables_From_ALI_File
;
999 -- Otherwise acquire compilation arguments and prepare to write
1000 -- out a new ali file.
1002 Create_Output_Library_Info
;
1004 -- Output version line
1006 Write_Info_Initiate
('V');
1007 Write_Info_Str
(" """);
1008 Write_Info_Str
(Verbose_Library_Version
);
1009 Write_Info_Char
('"');
1013 -- Output main program line if this is acceptable main program
1015 Output_Main_Program_Line
: declare
1016 U
: Node_Id
:= Unit
(Units
.Table
(Main_Unit
).Cunit
);
1019 procedure M_Parameters
;
1020 -- Output parameters for main program line
1026 procedure M_Parameters
is
1028 if Main_Priority
(Main_Unit
) /= Default_Main_Priority
then
1029 Write_Info_Char
(' ');
1030 Write_Info_Nat
(Main_Priority
(Main_Unit
));
1033 if Opt
.Time_Slice_Set
then
1034 Write_Info_Str
(" T=");
1035 Write_Info_Nat
(Opt
.Time_Slice_Value
);
1038 if Main_CPU
(Main_Unit
) /= Default_Main_CPU
then
1039 Write_Info_Str
(" C=");
1040 Write_Info_Nat
(Main_CPU
(Main_Unit
));
1043 Write_Info_Str
(" W=");
1045 (WC_Encoding_Letters
(Wide_Character_Encoding_Method
));
1050 -- Start of processing for Output_Main_Program_Line
1053 if Nkind
(U
) = N_Subprogram_Body
1055 (Nkind
(U
) = N_Package_Body
1057 Nkind
(Original_Node
(U
)) in N_Subprogram_Instantiation
)
1059 -- If the unit is a subprogram instance, the entity for the
1060 -- subprogram is the alias of the visible entity, which is the
1061 -- related instance of the wrapper package. We retrieve the
1062 -- subprogram declaration of the desired entity.
1064 if Nkind
(U
) = N_Package_Body
then
1065 U
:= Parent
(Parent
(
1066 Alias
(Related_Instance
(Defining_Unit_Name
1067 (Specification
(Unit
(Library_Unit
(Parent
(U
)))))))));
1070 S
:= Specification
(U
);
1072 -- A generic subprogram is never a main program
1074 if Nkind
(U
) = N_Subprogram_Body
1075 and then Present
(Corresponding_Spec
(U
))
1077 Ekind_In
(Corresponding_Spec
(U
), E_Generic_Procedure
,
1082 elsif No
(Parameter_Specifications
(S
)) then
1083 if Nkind
(S
) = N_Procedure_Specification
then
1084 Write_Info_Initiate
('M');
1085 Write_Info_Str
(" P");
1090 Nam
: Node_Id
:= Defining_Unit_Name
(S
);
1093 -- If it is a child unit, get its simple name
1095 if Nkind
(Nam
) = N_Defining_Program_Unit_Name
then
1096 Nam
:= Defining_Identifier
(Nam
);
1099 if Is_Integer_Type
(Etype
(Nam
)) then
1100 Write_Info_Initiate
('M');
1101 Write_Info_Str
(" F");
1108 end Output_Main_Program_Line
;
1110 -- Write command argument ('A') lines
1112 for A
in 1 .. Compilation_Switches
.Last
loop
1113 Write_Info_Initiate
('A');
1114 Write_Info_Char
(' ');
1115 Write_Info_Str
(Compilation_Switches
.Table
(A
).all);
1116 Write_Info_Terminate
;
1119 -- Output parameters ('P') line
1121 Write_Info_Initiate
('P');
1123 if Compilation_Errors
then
1124 Write_Info_Str
(" CE");
1127 if Opt
.Detect_Blocking
then
1128 Write_Info_Str
(" DB");
1132 and then not Is_Predefined_File_Name
(Unit_File_Name
(Main_Unit
))
1134 if Locking_Policy
/= ' ' then
1135 Write_Info_Str
(" L");
1136 Write_Info_Char
(Locking_Policy
);
1139 if Queuing_Policy
/= ' ' then
1140 Write_Info_Str
(" Q");
1141 Write_Info_Char
(Queuing_Policy
);
1144 if Task_Dispatching_Policy
/= ' ' then
1145 Write_Info_Str
(" T");
1146 Write_Info_Char
(Task_Dispatching_Policy
);
1147 Write_Info_Char
(' ');
1151 if GNATprove_Mode
then
1152 Write_Info_Str
(" GP");
1155 if Partition_Elaboration_Policy
/= ' ' then
1156 Write_Info_Str
(" E");
1157 Write_Info_Char
(Partition_Elaboration_Policy
);
1161 Write_Info_Str
(" NO");
1164 if No_Run_Time_Mode
then
1165 Write_Info_Str
(" NR");
1168 if Normalize_Scalars
then
1169 Write_Info_Str
(" NS");
1172 if Default_SSO_Config
/= ' ' then
1173 Write_Info_Str
(" O");
1174 Write_Info_Char
(Default_SSO_Config
);
1177 if Sec_Stack_Used
then
1178 Write_Info_Str
(" SS");
1181 if Unreserve_All_Interrupts
then
1182 Write_Info_Str
(" UA");
1185 if Exception_Mechanism
= Back_End_Exceptions
then
1186 Write_Info_Str
(" ZX");
1191 -- Before outputting the restrictions line, update the setting of
1192 -- the No_Elaboration_Code flag. Violations of this restriction
1193 -- cannot be detected until after the backend has been called since
1194 -- it is the backend that sets this flag. We have to check all units
1195 -- for which we have generated code
1197 for Unit
in Units
.First
.. Last_Unit
loop
1198 if Units
.Table
(Unit
).Generate_Code
or else Unit
= Main_Unit
then
1199 if not Has_No_Elaboration_Code
(Cunit
(Unit
)) then
1200 Main_Restrictions
.Violated
(No_Elaboration_Code
) := True;
1205 -- Positional case (only if debug flag -gnatd.R is set)
1207 if Debug_Flag_Dot_RR
then
1209 -- Output first restrictions line
1211 Write_Info_Initiate
('R');
1212 Write_Info_Char
(' ');
1214 -- First the information for the boolean restrictions
1216 for R
in All_Boolean_Restrictions
loop
1217 if Main_Restrictions
.Set
(R
)
1218 and then not Restriction_Warnings
(R
)
1220 Write_Info_Char
('r');
1221 elsif Main_Restrictions
.Violated
(R
) then
1222 Write_Info_Char
('v');
1224 Write_Info_Char
('n');
1228 -- And now the information for the parameter restrictions
1230 for RP
in All_Parameter_Restrictions
loop
1231 if Main_Restrictions
.Set
(RP
)
1232 and then not Restriction_Warnings
(RP
)
1234 Write_Info_Char
('r');
1235 Write_Info_Nat
(Nat
(Main_Restrictions
.Value
(RP
)));
1237 Write_Info_Char
('n');
1240 if not Main_Restrictions
.Violated
(RP
)
1241 or else RP
not in Checked_Parameter_Restrictions
1243 Write_Info_Char
('n');
1245 Write_Info_Char
('v');
1246 Write_Info_Nat
(Nat
(Main_Restrictions
.Count
(RP
)));
1248 if Main_Restrictions
.Unknown
(RP
) then
1249 Write_Info_Char
('+');
1256 -- Named case (if debug flag -gnatd.R is not set)
1263 -- Write RN header line with preceding blank line
1266 Write_Info_Initiate
('R');
1267 Write_Info_Char
('N');
1270 -- First the lines for the boolean restrictions
1272 for R
in All_Boolean_Restrictions
loop
1273 if Main_Restrictions
.Set
(R
)
1274 and then not Restriction_Warnings
(R
)
1277 elsif Main_Restrictions
.Violated
(R
) then
1283 Write_Info_Initiate
('R');
1284 Write_Info_Char
(C
);
1285 Write_Info_Char
(' ');
1286 Write_Info_Str
(All_Boolean_Restrictions
'Image (R
));
1294 -- And now the lines for the parameter restrictions
1296 for RP
in All_Parameter_Restrictions
loop
1297 if Main_Restrictions
.Set
(RP
)
1298 and then not Restriction_Warnings
(RP
)
1300 Write_Info_Initiate
('R');
1301 Write_Info_Str
("R ");
1302 Write_Info_Str
(All_Parameter_Restrictions
'Image (RP
));
1303 Write_Info_Char
('=');
1304 Write_Info_Nat
(Nat
(Main_Restrictions
.Value
(RP
)));
1308 if not Main_Restrictions
.Violated
(RP
)
1309 or else RP
not in Checked_Parameter_Restrictions
1313 Write_Info_Initiate
('R');
1314 Write_Info_Str
("V ");
1315 Write_Info_Str
(All_Parameter_Restrictions
'Image (RP
));
1316 Write_Info_Char
('=');
1317 Write_Info_Nat
(Nat
(Main_Restrictions
.Count
(RP
)));
1319 if Main_Restrictions
.Unknown
(RP
) then
1320 Write_Info_Char
('+');
1328 -- Output R lines for No_Dependence entries
1330 for J
in No_Dependences
.First
.. No_Dependences
.Last
loop
1331 if In_Extended_Main_Source_Unit
(No_Dependences
.Table
(J
).Unit
)
1332 and then not No_Dependences
.Table
(J
).Warn
1334 Write_Info_Initiate
('R');
1335 Write_Info_Char
(' ');
1336 Write_Unit_Name
(No_Dependences
.Table
(J
).Unit
);
1341 -- Output interrupt state lines
1343 for J
in Interrupt_States
.First
.. Interrupt_States
.Last
loop
1344 Write_Info_Initiate
('I');
1345 Write_Info_Char
(' ');
1346 Write_Info_Nat
(Interrupt_States
.Table
(J
).Interrupt_Number
);
1347 Write_Info_Char
(' ');
1348 Write_Info_Char
(Interrupt_States
.Table
(J
).Interrupt_State
);
1349 Write_Info_Char
(' ');
1351 (Nat
(Get_Logical_Line_Number
1352 (Interrupt_States
.Table
(J
).Pragma_Loc
)));
1356 -- Output priority specific dispatching lines
1358 for J
in Specific_Dispatching
.First
.. Specific_Dispatching
.Last
loop
1359 Write_Info_Initiate
('S');
1360 Write_Info_Char
(' ');
1361 Write_Info_Char
(Specific_Dispatching
.Table
(J
).Dispatching_Policy
);
1362 Write_Info_Char
(' ');
1363 Write_Info_Nat
(Specific_Dispatching
.Table
(J
).First_Priority
);
1364 Write_Info_Char
(' ');
1365 Write_Info_Nat
(Specific_Dispatching
.Table
(J
).Last_Priority
);
1366 Write_Info_Char
(' ');
1368 (Nat
(Get_Logical_Line_Number
1369 (Specific_Dispatching
.Table
(J
).Pragma_Loc
)));
1373 -- Loop through file table to output information for all units for which
1374 -- we have generated code, as marked by the Generate_Code flag.
1376 for Unit
in Units
.First
.. Last_Unit
loop
1377 if Units
.Table
(Unit
).Generate_Code
1378 or else Unit
= Main_Unit
1380 Write_Info_EOL
; -- blank line
1381 Write_Unit_Information
(Unit
);
1385 Write_Info_EOL
; -- blank line
1387 -- Output external version reference lines
1389 for J
in 1 .. Version_Ref
.Last
loop
1390 Write_Info_Initiate
('E');
1391 Write_Info_Char
(' ');
1393 for K
in 1 .. String_Length
(Version_Ref
.Table
(J
)) loop
1394 Write_Info_Char_Code
(Get_String_Char
(Version_Ref
.Table
(J
), K
));
1400 -- Prepare to output the source dependency lines
1403 Unum
: Unit_Number_Type
;
1404 -- Number of unit being output
1406 Sind
: Source_File_Index
;
1407 -- Index of corresponding source file
1409 Fname
: File_Name_Type
;
1412 for J
in 1 .. Num_Sdep
loop
1413 Unum
:= Sdep_Table
(J
);
1414 Units
.Table
(Unum
).Dependency_Num
:= J
;
1415 Sind
:= Units
.Table
(Unum
).Source_Index
;
1417 Write_Info_Initiate
('D');
1418 Write_Info_Char
(' ');
1420 -- Normal case of a unit entry with a source index
1422 if Sind
/= No_Source_File
then
1423 Fname
:= File_Name
(Sind
);
1425 -- Ensure that on platforms where the file names are not case
1426 -- sensitive, the recorded file name is in lower case.
1428 if not File_Names_Case_Sensitive
then
1429 Get_Name_String
(Fname
);
1430 To_Lower
(Name_Buffer
(1 .. Name_Len
));
1434 Write_Info_Name_May_Be_Quoted
(Fname
);
1435 Write_Info_Tab
(25);
1436 Write_Info_Str
(String (Time_Stamp
(Sind
)));
1437 Write_Info_Char
(' ');
1438 Write_Info_Str
(Get_Hex_String
(Source_Checksum
(Sind
)));
1440 -- If subunit, add unit name, omitting the %b at the end
1442 if Present
(Cunit
(Unum
)) then
1443 Get_Decoded_Name_String
(Unit_Name
(Unum
));
1444 Write_Info_Char
(' ');
1446 if Nkind
(Unit
(Cunit
(Unum
))) = N_Subunit
then
1447 Write_Info_Str
(Name_Buffer
(1 .. Name_Len
- 2));
1449 Write_Info_Str
(Name_Buffer
(1 .. Name_Len
));
1453 -- If Source_Reference pragma used, output information
1455 if Num_SRef_Pragmas
(Sind
) > 0 then
1456 Write_Info_Char
(' ');
1458 if Num_SRef_Pragmas
(Sind
) = 1 then
1459 Write_Info_Nat
(Int
(First_Mapped_Line
(Sind
)));
1464 Write_Info_Char
(':');
1465 Write_Info_Name
(Reference_Name
(Sind
));
1468 -- Case where there is no source index (happens for missing
1469 -- files). In this case we write a dummy time stamp.
1472 Write_Info_Name
(Unit_File_Name
(Unum
));
1473 Write_Info_Tab
(25);
1474 Write_Info_Str
(String (Dummy_Time_Stamp
));
1475 Write_Info_Char
(' ');
1476 Write_Info_Str
(Get_Hex_String
(0));
1483 -- Output cross-references
1485 if Opt
.Xref_Active
then
1489 -- Output SCO information if present
1491 if Generate_SCO
then
1492 SCO_Record_Filtered
;
1496 -- Output SPARK cross-reference information if needed
1498 if Opt
.Xref_Active
and then GNATprove_Mode
then
1499 SPARK_Specific
.Collect_SPARK_Xrefs
(Sdep_Table
=> Sdep_Table
,
1500 Num_Sdep
=> Num_Sdep
);
1501 SPARK_Specific
.Output_SPARK_Xrefs
;
1504 -- Output final blank line and we are done. This final blank line is
1505 -- probably junk, but we don't feel like making an incompatible change.
1507 Write_Info_Terminate
;
1508 Close_Output_Library_Info
;
1511 ---------------------
1512 -- Write_Unit_Name --
1513 ---------------------
1515 procedure Write_Unit_Name
(N
: Node_Id
) is
1517 if Nkind
(N
) = N_Identifier
then
1518 Write_Info_Name
(Chars
(N
));
1521 pragma Assert
(Nkind
(N
) = N_Selected_Component
);
1522 Write_Unit_Name
(Prefix
(N
));
1523 Write_Info_Char
('.');
1524 Write_Unit_Name
(Selector_Name
(N
));
1526 end Write_Unit_Name
;