1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2008, 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 Atree
; use Atree
;
27 with Casing
; use Casing
;
28 with Csets
; use Csets
;
29 with Debug
; use Debug
;
30 with Einfo
; use Einfo
;
31 with Elists
; use Elists
;
32 with Errout
; use Errout
;
33 with Exp_Dist
; use Exp_Dist
;
34 with Fname
; use Fname
;
35 with Fname
.UF
; use Fname
.UF
;
37 with Lib
.Load
; use Lib
.Load
;
38 with Namet
; use Namet
;
39 with Nlists
; use Nlists
;
40 with Nmake
; use Nmake
;
41 with Output
; use Output
;
43 with Restrict
; use Restrict
;
45 with Sem_Ch7
; use Sem_Ch7
;
46 with Sem_Dist
; use Sem_Dist
;
47 with Sem_Util
; use Sem_Util
;
48 with Sinfo
; use Sinfo
;
49 with Stand
; use Stand
;
50 with Snames
; use Snames
;
51 with Tbuild
; use Tbuild
;
52 with Uname
; use Uname
;
54 package body Rtsfind
is
56 RTE_Available_Call
: Boolean := False;
57 -- Set True during call to RTE from RTE_Available (or from call to
58 -- RTE_Record_Component from RTE_Record_Component_Available). Tells
59 -- the called subprogram to set RTE_Is_Available to False rather than
60 -- generating an error message.
62 RTE_Is_Available
: Boolean;
63 -- Set True by RTE_Available on entry. When RTE_Available_Call is set
64 -- True, set False if RTE would otherwise generate an error message.
70 -- The unit table has one entry for each unit included in the definition
71 -- of the type RTU_Id in the spec. The table entries are initialized in
72 -- Initialize to set the Entity field to Empty, indicating that the
73 -- corresponding unit has not yet been loaded. The fields are set when
74 -- a unit is loaded to contain the defining entity for the unit, the
75 -- unit name, and the unit number.
77 -- Note that a unit can be loaded either by a call to find an entity
78 -- within the unit (e.g. RTE), or by an explicit with of the unit. In
79 -- the latter case it is critical to make a call to Set_RTU_Loaded to
80 -- ensure that the entry in this table reflects the load.
82 type RT_Unit_Table_Record
is record
84 Uname
: Unit_Name_Type
;
85 Unum
: Unit_Number_Type
;
89 RT_Unit_Table
: array (RTU_Id
) of RT_Unit_Table_Record
;
91 --------------------------
92 -- Runtime Entity Table --
93 --------------------------
95 -- There is one entry in the runtime entity table for each entity that is
96 -- included in the definition of the RE_Id type in the spec. The entries
97 -- are set by Initialize_Rtsfind to contain Empty, indicating that the
98 -- entity has not yet been located. Once the entity is located for the
99 -- first time, its ID is stored in this array, so that subsequent calls
100 -- for the same entity can be satisfied immediately.
102 -- NOTE: In order to avoid conflicts between record components and subprgs
103 -- that have the same name (i.e. subprogram External_Tag and
104 -- component External_Tag of package Ada.Tags) this table is not used
105 -- with Record_Components.
107 RE_Table
: array (RE_Id
) of Entity_Id
;
109 --------------------------
110 -- Generation of WITH's --
111 --------------------------
113 -- When a unit is implicitly loaded as a result of a call to RTE, it is
114 -- necessary to create an implicit WITH to ensure that the object is
115 -- correctly loaded by the binder. Such WITH statements are only required
116 -- when the request is from the extended main unit (if a client needs a
117 -- WITH, that will be taken care of when the client is compiled).
119 -- We always attach the WITH to the main unit. This is not perfectly
120 -- accurate in terms of elaboration requirements, but it is close enough,
121 -- since the units that are accessed using rtsfind do not have delicate
122 -- elaboration requirements.
124 -- The flag Withed in the unit table record is initially set to False. It
125 -- is set True if a WITH has been generated for the main unit for the
126 -- corresponding unit.
128 -----------------------
129 -- Local Subprograms --
130 -----------------------
132 function Check_CRT
(E
: RE_Id
; Eid
: Entity_Id
) return Entity_Id
;
133 -- Check entity Eid to ensure that configurable run-time restrictions are
134 -- met. May generate an error message (if RTE_Available_Call is false) and
135 -- raise RE_Not_Available if entity E does not exist (e.g. Eid is Empty).
136 -- Above documentation not clear ???
138 procedure Entity_Not_Defined
(Id
: RE_Id
);
139 -- Outputs error messages for an entity that is not defined in the run-time
140 -- library (the form of the error message is tailored for no run time or
141 -- configurable run time mode as required).
143 function Get_Unit_Name
(U_Id
: RTU_Id
) return Unit_Name_Type
;
144 -- Retrieves the Unit Name given a unit id represented by its enumeration
147 procedure Load_Fail
(S
: String; U_Id
: RTU_Id
; Id
: RE_Id
);
148 -- Internal procedure called if we can't successfully locate or process a
149 -- run-time unit. The parameters give information about the error message
150 -- to be given. S is a reason for failing to compile the file and U_Id is
151 -- the unit id. RE_Id is the RE_Id originally passed to RTE. The message in
152 -- S is one of the following:
155 -- "had parser errors"
156 -- "had semantic errors"
158 -- The "not found" case is treated specially in that it is considered
159 -- a normal situation in configurable run-time mode (and the message in
160 -- this case is suppressed unless we are operating in All_Errors_Mode).
164 Id
: RE_Id
:= RE_Null
;
165 Use_Setting
: Boolean := False);
166 -- Load the unit whose Id is given if not already loaded. The unit is
167 -- loaded, analyzed, and added to the WITH list, and the entry in
168 -- RT_Unit_Table is updated to reflect the load. Use_Setting is used to
169 -- indicate the initial setting for the Is_Potentially_Use_Visible flag of
170 -- the entity for the loaded unit (if it is indeed loaded). A value of
171 -- False means nothing special need be done. A value of True indicates that
172 -- this flag must be set to True. It is needed only in the Text_IO_Kludge
173 -- procedure, which may materialize an entity of Text_IO (or
174 -- [Wide_]Wide_Text_IO) that was previously unknown. Id is the RE_Id value
175 -- of the entity which was originally requested. Id is used only for error
176 -- message detail, and if it is RE_Null, then the attempt to output the
177 -- entity name is ignored.
179 function Make_Unit_Name
(E
: RE_Id
; N
: Node_Id
) return Node_Id
;
180 -- If the unit is a child unit, build fully qualified name for use in
183 procedure Output_Entity_Name
(Id
: RE_Id
; Msg
: String);
184 -- Output continuation error message giving qualified name of entity
185 -- corresponding to Id, appending the string given by Msg. This call
186 -- is only effective in All_Errors mode.
188 function RE_Chars
(E
: RE_Id
) return Name_Id
;
189 -- Given a RE_Id value returns the Chars of the corresponding entity
191 procedure RTE_Error_Msg
(Msg
: String);
192 -- Generates a message by calling Error_Msg_N specifying Current_Error_Node
193 -- as the node location using the given Msg text. Special processing in the
194 -- case where RTE_Available_Call is set. In this case, no message is output
195 -- and instead RTE_Is_Available is set to False. Note that this can only be
196 -- used if you are sure that the message comes directly or indirectly from
197 -- a call to the RTE function.
203 function Check_CRT
(E
: RE_Id
; Eid
: Entity_Id
) return Entity_Id
is
204 U_Id
: constant RTU_Id
:= RE_Unit_Table
(E
);
208 if RTE_Available_Call
then
209 RTE_Is_Available
:= False;
211 Entity_Not_Defined
(E
);
214 raise RE_Not_Available
;
216 -- Entity is available
219 -- If in No_Run_Time mode and entity is not in one of the
220 -- specially permitted units, raise the exception.
223 and then not OK_No_Run_Time_Unit
(U_Id
)
225 Entity_Not_Defined
(E
);
226 raise RE_Not_Available
;
229 -- Otherwise entity is accessible
235 ------------------------
236 -- Entity_Not_Defined --
237 ------------------------
239 procedure Entity_Not_Defined
(Id
: RE_Id
) is
241 if No_Run_Time_Mode
then
243 -- If the error occurs when compiling the body of a predefined
244 -- unit for inlining purposes, the body must be illegal in this
245 -- mode, and there is no point in continuing.
247 if Is_Predefined_File_Name
248 (Unit_File_Name
(Get_Source_Unit
(Sloc
(Current_Error_Node
))))
251 ("construct not allowed in no run time mode!",
253 raise Unrecoverable_Error
;
256 RTE_Error_Msg
("|construct not allowed in no run time mode");
259 elsif Configurable_Run_Time_Mode
then
260 RTE_Error_Msg
("|construct not allowed in this configuration>");
262 RTE_Error_Msg
("run-time configuration error");
265 Output_Entity_Name
(Id
, "not defined");
266 end Entity_Not_Defined
;
272 function Get_Unit_Name
(U_Id
: RTU_Id
) return Unit_Name_Type
is
273 Uname_Chars
: constant String := RTU_Id
'Image (U_Id
);
276 Name_Len
:= Uname_Chars
'Length;
277 Name_Buffer
(1 .. Name_Len
) := Uname_Chars
;
278 Set_Casing
(All_Lower_Case
);
280 if U_Id
in Ada_Child
then
281 Name_Buffer
(4) := '.';
283 if U_Id
in Ada_Calendar_Child
then
284 Name_Buffer
(13) := '.';
286 elsif U_Id
in Ada_Dispatching_Child
then
287 Name_Buffer
(16) := '.';
289 elsif U_Id
in Ada_Finalization_Child
then
290 Name_Buffer
(17) := '.';
292 elsif U_Id
in Ada_Interrupts_Child
then
293 Name_Buffer
(15) := '.';
295 elsif U_Id
in Ada_Real_Time_Child
then
296 Name_Buffer
(14) := '.';
298 elsif U_Id
in Ada_Streams_Child
then
299 Name_Buffer
(12) := '.';
301 elsif U_Id
in Ada_Text_IO_Child
then
302 Name_Buffer
(12) := '.';
304 elsif U_Id
in Ada_Wide_Text_IO_Child
then
305 Name_Buffer
(17) := '.';
307 elsif U_Id
in Ada_Wide_Wide_Text_IO_Child
then
308 Name_Buffer
(22) := '.';
311 elsif U_Id
in Interfaces_Child
then
312 Name_Buffer
(11) := '.';
314 elsif U_Id
in System_Child
then
315 Name_Buffer
(7) := '.';
317 if U_Id
in System_Strings_Child
then
318 Name_Buffer
(15) := '.';
321 if U_Id
in System_Tasking_Child
then
322 Name_Buffer
(15) := '.';
325 if U_Id
in System_Tasking_Restricted_Child
then
326 Name_Buffer
(26) := '.';
329 if U_Id
in System_Tasking_Protected_Objects_Child
then
330 Name_Buffer
(33) := '.';
333 if U_Id
in System_Tasking_Async_Delays_Child
then
334 Name_Buffer
(28) := '.';
338 -- Add %s at end for spec
340 Name_Buffer
(Name_Len
+ 1) := '%';
341 Name_Buffer
(Name_Len
+ 2) := 's';
342 Name_Len
:= Name_Len
+ 2;
351 procedure Initialize
is
353 -- Initialize the unit table
356 RT_Unit_Table
(J
).Entity
:= Empty
;
360 RE_Table
(J
) := Empty
;
363 RTE_Is_Available
:= False;
370 function Is_RTE
(Ent
: Entity_Id
; E
: RE_Id
) return Boolean is
371 E_Unit_Name
: Unit_Name_Type
;
372 Ent_Unit_Name
: Unit_Name_Type
;
382 -- If E has already a corresponding entity, check it directly,
383 -- going to full views if they exist to deal with the incomplete
384 -- and private type cases properly.
386 elsif Present
(RE_Table
(E
)) then
389 if Is_Type
(E1
) and then Present
(Full_View
(E1
)) then
390 E1
:= Full_View
(E1
);
395 if Is_Type
(E2
) and then Present
(Full_View
(E2
)) then
396 E2
:= Full_View
(E2
);
402 -- If the unit containing E is not loaded, we already know that
403 -- the entity we have cannot have come from this unit.
405 E_Unit_Name
:= Get_Unit_Name
(RE_Unit_Table
(E
));
407 if not Is_Loaded
(E_Unit_Name
) then
411 -- Here the unit containing the entity is loaded. We have not made
412 -- an explicit call to RTE to get the entity in question, but we may
413 -- have obtained a reference to it indirectly from some other entity
414 -- in the same unit, or some other unit that references it.
416 -- Get the defining unit of the entity
420 if Ekind
(S
) /= E_Package
then
424 Ent_Unit_Name
:= Get_Unit_Name
(Unit_Declaration_Node
(S
));
426 -- If the defining unit of the entity we are testing is not the
427 -- unit containing E, then they cannot possibly match.
429 if Ent_Unit_Name
/= E_Unit_Name
then
433 -- If the units match, then compare the names (remember that no
434 -- overloading is permitted in entities fetched using Rtsfind).
436 if RE_Chars
(E
) = Chars
(Ent
) then
439 -- If front-end inlining is enabled, we may be within a body that
440 -- contains inlined functions, which has not been retrieved through
441 -- rtsfind, and therefore is not yet recorded in the RT_Unit_Table.
442 -- Add the unit information now, it must be fully available.
445 U
: RT_Unit_Table_Record
446 renames RT_Unit_Table
(RE_Unit_Table
(E
));
448 if No
(U
.Entity
) then
450 U
.Uname
:= E_Unit_Name
;
451 U
.Unum
:= Get_Source_Unit
(S
);
465 function Is_RTU
(Ent
: Entity_Id
; U
: RTU_Id
) return Boolean is
466 E
: constant Entity_Id
:= RT_Unit_Table
(U
).Entity
;
468 return Present
(E
) and then E
= Ent
;
471 ----------------------------
472 -- Is_Text_IO_Kludge_Unit --
473 ----------------------------
475 function Is_Text_IO_Kludge_Unit
(Nam
: Node_Id
) return Boolean is
480 if Nkind
(Nam
) /= N_Expanded_Name
then
485 Sel
:= Selector_Name
(Nam
);
487 if Nkind
(Sel
) /= N_Expanded_Name
488 or else Nkind
(Prf
) /= N_Identifier
489 or else Chars
(Prf
) /= Name_Ada
495 Sel
:= Selector_Name
(Sel
);
498 Nkind
(Prf
) = N_Identifier
500 (Chars
(Prf
) = Name_Text_IO
502 Chars
(Prf
) = Name_Wide_Text_IO
504 Chars
(Prf
) = Name_Wide_Wide_Text_IO
)
506 Nkind
(Sel
) = N_Identifier
508 Chars
(Sel
) in Text_IO_Package_Name
;
509 end Is_Text_IO_Kludge_Unit
;
515 procedure Load_Fail
(S
: String; U_Id
: RTU_Id
; Id
: RE_Id
) is
516 M
: String (1 .. 100);
520 -- Output header message
522 if Configurable_Run_Time_Mode
then
523 RTE_Error_Msg
("construct not allowed in configurable run-time mode");
525 RTE_Error_Msg
("run-time library configuration error");
528 -- Output file name and reason string
531 or else not Configurable_Run_Time_Mode
532 or else All_Errors_Mode
534 M
(1 .. 6) := "\file ";
538 (Get_File_Name
(RT_Unit_Table
(U_Id
).Uname
, Subunit
=> False));
539 M
(P
+ 1 .. P
+ Name_Len
) := Name_Buffer
(1 .. Name_Len
);
545 M
(P
+ 1 .. P
+ S
'Length) := S
;
548 RTE_Error_Msg
(M
(1 .. P
));
550 -- Output entity name
552 Output_Entity_Name
(Id
, "not available");
555 -- In configurable run time mode, we raise RE_Not_Available, and the
556 -- caller is expected to deal gracefully with this. In the case of a
557 -- call to RTE_Available, this exception will be caught in Rtsfind,
558 -- and result in a returned value of False for the call.
560 if Configurable_Run_Time_Mode
then
561 raise RE_Not_Available
;
563 -- Here we have a load failure in normal full run time mode. See if we
564 -- are in the context of an RTE_Available call. If so, we just raise
565 -- RE_Not_Available. This can happen if a unit is unavailable, which
566 -- happens for example in the VM case, where the run-time is not
567 -- complete, but we do not regard it as a configurable run-time.
568 -- If the caller has done an explicit call to RTE_Available, then
569 -- clearly the caller is prepared to deal with a result of False.
571 elsif RTE_Available_Call
then
572 RTE_Is_Available
:= False;
573 raise RE_Not_Available
;
575 -- If we are not in the context of an RTE_Available call, we are really
576 -- trying to load an entity that is not there, and that should never
577 -- happen, so in this case we signal a fatal error.
580 raise Unrecoverable_Error
;
590 Id
: RE_Id
:= RE_Null
;
591 Use_Setting
: Boolean := False)
593 U
: RT_Unit_Table_Record
renames RT_Unit_Table
(U_Id
);
594 Priv_Par
: constant Elist_Id
:= New_Elmt_List
;
597 procedure Save_Private_Visibility
;
598 -- If the current unit is the body of child unit or the spec of a
599 -- private child unit, the private declarations of the parent (s)
600 -- are visible. If the unit to be loaded is another public sibling,
601 -- its compilation will affect the visibility of the common ancestors.
602 -- Indicate those that must be restored.
604 procedure Restore_Private_Visibility
;
605 -- Restore the visibility of ancestors after compiling RTU
607 --------------------------------
608 -- Restore_Private_Visibility --
609 --------------------------------
611 procedure Restore_Private_Visibility
is
615 E_Par
:= First_Elmt
(Priv_Par
);
616 while Present
(E_Par
) loop
617 if not In_Private_Part
(Node
(E_Par
)) then
618 Install_Private_Declarations
(Node
(E_Par
));
623 end Restore_Private_Visibility
;
625 -----------------------------
626 -- Save_Private_Visibility --
627 -----------------------------
629 procedure Save_Private_Visibility
is
633 Par
:= Scope
(Current_Scope
);
635 and then Par
/= Standard_Standard
637 if Ekind
(Par
) = E_Package
638 and then Is_Compilation_Unit
(Par
)
639 and then In_Private_Part
(Par
)
641 Append_Elmt
(Par
, Priv_Par
);
646 end Save_Private_Visibility
;
648 -- Start of processing for Load_RTU
651 -- Nothing to do if unit is already loaded
653 if Present
(U
.Entity
) then
657 -- Note if secondary stack is used
659 if U_Id
= System_Secondary_Stack
then
660 Opt
.Sec_Stack_Used
:= True;
663 -- Otherwise we need to load the unit, First build unit name
664 -- from the enumeration literal name in type RTU_Id.
666 U
.Uname
:= Get_Unit_Name
(U_Id
);
671 pragma Warnings
(Off
, Loaded
);
673 Loaded
:= Is_Loaded
(U
.Uname
);
676 -- Now do the load call, note that setting Error_Node to Empty is
677 -- a signal to Load_Unit that we will regard a failure to find the
678 -- file as a fatal error, and that it should not output any kind
679 -- of diagnostics, since we will take care of it here.
681 -- We save style checking switches and turn off style checking for
682 -- loading the unit, since we don't want any style checking!
685 Save_Style_Check
: constant Boolean := Style_Check
;
687 Style_Check
:= False;
690 (Load_Name
=> U
.Uname
,
693 Error_Node
=> Empty
);
694 Style_Check
:= Save_Style_Check
;
697 -- Check for bad unit load
699 if U
.Unum
= No_Unit
then
700 Load_Fail
("not found", U_Id
, Id
);
701 elsif Fatal_Error
(U
.Unum
) then
702 Load_Fail
("had parser errors", U_Id
, Id
);
705 -- Make sure that the unit is analyzed
708 Was_Analyzed
: constant Boolean :=
709 Analyzed
(Cunit
(Current_Sem_Unit
));
712 -- Pretend that the current unit is analyzed, in case it is System
713 -- or some such. This allows us to put some declarations, such as
714 -- exceptions and packed arrays of Boolean, into System even though
715 -- expanding them requires System...
717 -- This is a bit odd but works fine. If the RTS unit does not depend
718 -- in any way on the current unit, then it never gets back into the
719 -- current unit's tree, and the change we make to the current unit
720 -- tree is never noticed by anyone (it is undone in a moment). That
721 -- is the normal situation.
723 -- If the RTS Unit *does* depend on the current unit, for instance,
724 -- when you are compiling System, then you had better have finished
725 -- analyzing the part of System that is depended on before you try
726 -- to load the RTS Unit. This means having the System ordered in an
727 -- appropriate manner.
729 Set_Analyzed
(Cunit
(Current_Sem_Unit
), True);
731 if not Analyzed
(Cunit
(U
.Unum
)) then
733 -- If the unit is already loaded through a limited_with clauses,
734 -- the relevant entities must already be available. We do not
735 -- want to load and analyze the unit because this would create
736 -- a real semantic dependence when the purpose of the limited_with
737 -- is precisely to avoid such.
739 if From_With_Type
(Cunit_Entity
(U
.Unum
)) then
743 Save_Private_Visibility
;
744 Semantics
(Cunit
(U
.Unum
));
745 Restore_Private_Visibility
;
747 if Fatal_Error
(U
.Unum
) then
748 Load_Fail
("had semantic errors", U_Id
, Id
);
755 Set_Analyzed
(Cunit
(Current_Sem_Unit
), Was_Analyzed
);
758 Lib_Unit
:= Unit
(Cunit
(U
.Unum
));
759 U
.Entity
:= Defining_Entity
(Lib_Unit
);
762 Set_Is_Potentially_Use_Visible
(U
.Entity
, True);
770 function Make_Unit_Name
(E
: RE_Id
; N
: Node_Id
) return Node_Id
is
771 U_Id
: constant RTU_Id
:= RE_Unit_Table
(E
);
772 U
: RT_Unit_Table_Record
renames RT_Unit_Table
(U_Id
);
777 Nam
:= New_Reference_To
(U
.Entity
, Standard_Location
);
778 Scop
:= Scope
(U
.Entity
);
780 if Nkind
(N
) = N_Defining_Program_Unit_Name
then
781 while Scop
/= Standard_Standard
loop
783 Make_Expanded_Name
(Standard_Location
,
784 Chars
=> Chars
(U
.Entity
),
785 Prefix
=> New_Reference_To
(Scop
, Standard_Location
),
786 Selector_Name
=> Nam
);
787 Set_Entity
(Nam
, U
.Entity
);
789 Scop
:= Scope
(Scop
);
796 -----------------------
797 -- Output_Entity_Name --
798 ------------------------
800 procedure Output_Entity_Name
(Id
: RE_Id
; Msg
: String) is
801 M
: String (1 .. 2048);
803 -- M (1 .. P) is current message to be output
805 RE_Image
: constant String := RE_Id
'Image (Id
);
808 if Id
= RE_Null
or else not All_Errors_Mode
then
812 M
(1 .. 9) := "\entity """;
815 -- Add unit name to message, excluding %s or %b at end
817 Get_Name_String
(Get_Unit_Name
(RE_Unit_Table
(Id
)));
818 Name_Len
:= Name_Len
- 2;
819 Set_Casing
(Mixed_Case
);
820 M
(P
+ 1 .. P
+ Name_Len
) := Name_Buffer
(1 .. Name_Len
);
823 -- Add a qualifying period
828 -- Add entity name and closing quote to message
830 Name_Len
:= RE_Image
'Length - 3;
831 Name_Buffer
(1 .. Name_Len
) := RE_Image
(4 .. RE_Image
'Length);
832 Set_Casing
(Mixed_Case
);
833 M
(P
+ 1 .. P
+ Name_Len
) := Name_Buffer
(1 .. Name_Len
);
842 M
(P
+ 1 .. P
+ Msg
'Length) := Msg
;
845 -- Output message at current error node location
847 RTE_Error_Msg
(M
(1 .. P
));
848 end Output_Entity_Name
;
854 function RE_Chars
(E
: RE_Id
) return Name_Id
is
855 RE_Name_Chars
: constant String := RE_Id
'Image (E
);
858 -- Copy name skipping initial RE_ or RO_XX characters
860 if RE_Name_Chars
(1 .. 2) = "RE" then
861 for J
in 4 .. RE_Name_Chars
'Last loop
862 Name_Buffer
(J
- 3) := Fold_Lower
(RE_Name_Chars
(J
));
865 Name_Len
:= RE_Name_Chars
'Length - 3;
868 for J
in 7 .. RE_Name_Chars
'Last loop
869 Name_Buffer
(J
- 6) := Fold_Lower
(RE_Name_Chars
(J
));
872 Name_Len
:= RE_Name_Chars
'Length - 6;
882 function RTE
(E
: RE_Id
) return Entity_Id
is
883 U_Id
: constant RTU_Id
:= RE_Unit_Table
(E
);
884 U
: RT_Unit_Table_Record
renames RT_Unit_Table
(U_Id
);
890 -- The following flag is used to disable front-end inlining when RTE
891 -- is invoked. This prevents the analysis of other runtime bodies when
892 -- a particular spec is loaded through Rtsfind. This is both efficient,
893 -- and it prevents spurious visibility conflicts between use-visible
894 -- user entities, and entities in run-time packages.
896 -- In configurable run-time mode, subprograms marked Inline_Always must
897 -- be inlined, so in the case we retain the Front_End_Inlining mode.
899 Save_Front_End_Inlining
: Boolean;
902 -- Reject programs that make use of distribution features not supported
903 -- on the current target. Also check that the PCS is compatible with
904 -- the code generator version. On such targets (VMS, Vxworks, others?)
905 -- we provide a minimal body for System.Rpc that only supplies an
906 -- implementation of Partition_Id.
908 function Find_Local_Entity
(E
: RE_Id
) return Entity_Id
;
909 -- This function is used when entity E is in this compilation's main
910 -- unit. It gets the value from the already compiled declaration.
916 procedure Check_RPC
is
918 procedure Check_RPC_Failure
(Msg
: String);
919 pragma No_Return
(Check_RPC_Failure
);
920 -- Display Msg on standard error and raise Unrecoverable_Error
922 -----------------------
923 -- Check_RPC_Failure --
924 -----------------------
926 procedure Check_RPC_Failure
(Msg
: String) is
931 raise Unrecoverable_Error
;
932 end Check_RPC_Failure
;
934 -- Start of processing for Check_RPC
937 -- Bypass this check if debug flag -gnatdR set
939 if Debug_Flag_RR
then
943 -- Otherwise we need the check if we are going after one of
944 -- the critical entities in System.RPC in stubs mode.
946 -- ??? Should we do this for other s-parint entities too?
948 if (Distribution_Stub_Mode
= Generate_Receiver_Stub_Body
950 Distribution_Stub_Mode
= Generate_Caller_Stub_Body
)
951 and then (E
= RE_Do_Rpc
955 E
= RE_Params_Stream_Type
957 E
= RE_Request_Access
)
959 if Get_PCS_Name
= Name_No_DSA
then
960 Check_RPC_Failure
("distribution feature not supported");
962 elsif Get_PCS_Version
/=
963 Exp_Dist
.PCS_Version_Number
(Get_PCS_Name
)
965 Check_RPC_Failure
("PCS version mismatch");
971 -----------------------
972 -- Find_Local_Entity --
973 -----------------------
975 function Find_Local_Entity
(E
: RE_Id
) return Entity_Id
is
976 RE_Str
: constant String := RE_Id
'Image (E
);
980 Save_Nam
: constant String := Name_Buffer
(1 .. Name_Len
);
981 -- Save name buffer and length over call
984 Name_Len
:= Natural'Max (0, RE_Str
'Length - 3);
985 Name_Buffer
(1 .. Name_Len
) :=
986 RE_Str
(RE_Str
'First + 3 .. RE_Str
'Last);
989 Ent
:= Entity_Id
(Get_Name_Table_Info
(Nam
));
991 Name_Len
:= Save_Nam
'Length;
992 Name_Buffer
(1 .. Name_Len
) := Save_Nam
;
995 end Find_Local_Entity
;
997 -- Start of processing for RTE
1000 -- Doing a rtsfind in system.ads is special, as we cannot do this
1001 -- when compiling System itself. So if we are compiling system then
1002 -- we should already have acquired and processed the declaration
1003 -- of the entity. The test is to see if this compilation's main unit
1004 -- is System. If so, return the value from the already compiled
1005 -- declaration and otherwise do a regular find.
1007 -- Not pleasant, but these kinds of annoying recursion when
1008 -- writing an Ada compiler in Ada have to be broken somewhere!
1010 if Present
(Main_Unit_Entity
)
1011 and then Chars
(Main_Unit_Entity
) = Name_System
1012 and then Analyzed
(Main_Unit_Entity
)
1013 and then not Is_Child_Unit
(Main_Unit_Entity
)
1015 return Check_CRT
(E
, Find_Local_Entity
(E
));
1018 Save_Front_End_Inlining
:= Front_End_Inlining
;
1019 Front_End_Inlining
:= Configurable_Run_Time_Mode
;
1021 -- Load unit if unit not previously loaded
1023 if No
(RE_Table
(E
)) then
1024 Load_RTU
(U_Id
, Id
=> E
);
1025 Lib_Unit
:= Unit
(Cunit
(U
.Unum
));
1027 -- In the subprogram case, we are all done, the entity we want
1028 -- is the entity for the subprogram itself. Note that we do not
1029 -- bother to check that it is the entity that was requested.
1030 -- the only way that could fail to be the case is if runtime is
1031 -- hopelessly misconfigured, and it isn't worth testing for this.
1033 if Nkind
(Lib_Unit
) = N_Subprogram_Declaration
then
1034 RE_Table
(E
) := U
.Entity
;
1036 -- Otherwise we must have the package case. First check package
1037 -- entity itself (e.g. RTE_Name for System.Interrupts.Name)
1040 pragma Assert
(Nkind
(Lib_Unit
) = N_Package_Declaration
);
1041 Ename
:= RE_Chars
(E
);
1043 -- First we search the package entity chain. If the package
1044 -- only has a limited view, scan the corresponding list of
1045 -- incomplete types.
1047 if From_With_Type
(U
.Entity
) then
1048 Pkg_Ent
:= First_Entity
(Limited_View
(U
.Entity
));
1050 Pkg_Ent
:= First_Entity
(U
.Entity
);
1053 while Present
(Pkg_Ent
) loop
1054 if Ename
= Chars
(Pkg_Ent
) then
1055 RE_Table
(E
) := Pkg_Ent
;
1060 Next_Entity
(Pkg_Ent
);
1063 -- If we did not find the entity in the package entity chain,
1064 -- then check if the package entity itself matches. Note that
1065 -- we do this check after searching the entity chain, since
1066 -- the rule is that in case of ambiguity, we prefer the entity
1067 -- defined within the package, rather than the package itself.
1069 if Ename
= Chars
(U
.Entity
) then
1070 RE_Table
(E
) := U
.Entity
;
1073 -- If we didn't find the entity we want, something is wrong.
1074 -- We just leave RE_Table (E) set to Empty and the appropriate
1075 -- action will be taken by Check_CRT when we exit.
1080 -- See if we have to generate a WITH for this entity. We generate
1081 -- a WITH if the current unit is part of the extended main code
1082 -- unit, and if we have not already added the with. The WITH is
1083 -- added to the appropriate unit (the current one). We do not need
1084 -- to generate a WITH for a call issued from RTE_Available.
1089 In_Extended_Main_Code_Unit
(Cunit_Entity
(Current_Sem_Unit
))
1090 and then not RTE_Available_Call
1099 Lib_Unit
:= Unit
(Cunit
(U
.Unum
));
1101 Make_With_Clause
(Standard_Location
,
1104 (E
, Defining_Unit_Name
(Specification
(Lib_Unit
))));
1105 Set_Library_Unit
(Withn
, Cunit
(U
.Unum
));
1106 Set_Corresponding_Spec
(Withn
, U
.Entity
);
1107 Set_First_Name
(Withn
, True);
1108 Set_Implicit_With
(Withn
, True);
1110 Mark_Rewrite_Insertion
(Withn
);
1111 Append
(Withn
, Context_Items
(Cunit
(Current_Sem_Unit
)));
1112 Check_Restriction_No_Dependence
(Name
(Withn
), Current_Error_Node
);
1116 Front_End_Inlining
:= Save_Front_End_Inlining
;
1117 return Check_CRT
(E
, RE_Table
(E
));
1124 function RTE_Available
(E
: RE_Id
) return Boolean is
1126 pragma Warnings
(Off
, Dummy
);
1130 Save_RTE_Available_Call
: constant Boolean := RTE_Available_Call
;
1131 Save_RTE_Is_Available
: constant Boolean := RTE_Is_Available
;
1132 -- These are saved recursively because the call to load a unit
1133 -- caused by an upper level call may perform a recursive call
1134 -- to this routine during analysis of the corresponding unit.
1137 RTE_Available_Call
:= True;
1138 RTE_Is_Available
:= True;
1140 Result
:= RTE_Is_Available
;
1141 RTE_Available_Call
:= Save_RTE_Available_Call
;
1142 RTE_Is_Available
:= Save_RTE_Is_Available
;
1146 when RE_Not_Available
=>
1147 RTE_Available_Call
:= Save_RTE_Available_Call
;
1148 RTE_Is_Available
:= Save_RTE_Is_Available
;
1152 --------------------------
1153 -- RTE_Record_Component --
1154 --------------------------
1156 function RTE_Record_Component
(E
: RE_Id
) return Entity_Id
is
1157 U_Id
: constant RTU_Id
:= RE_Unit_Table
(E
);
1158 U
: RT_Unit_Table_Record
renames RT_Unit_Table
(U_Id
);
1161 Found_E
: Entity_Id
;
1163 Pkg_Ent
: Entity_Id
;
1165 -- The following flag is used to disable front-end inlining when
1166 -- RTE_Record_Component is invoked. This prevents the analysis of other
1167 -- runtime bodies when a particular spec is loaded through Rtsfind. This
1168 -- is both efficient, and it prevents spurious visibility conflicts
1169 -- between use-visible user entities, and entities in run-time packages.
1171 -- In configurable run-time mode, subprograms marked Inline_Always must
1172 -- be inlined, so in the case we retain the Front_End_Inlining mode.
1174 Save_Front_End_Inlining
: Boolean;
1177 -- Note: Contrary to subprogram RTE, there is no need to do any special
1178 -- management with package system.ads because it has no record type
1181 Save_Front_End_Inlining
:= Front_End_Inlining
;
1182 Front_End_Inlining
:= Configurable_Run_Time_Mode
;
1184 -- Load unit if unit not previously loaded
1186 if not Present
(U
.Entity
) then
1187 Load_RTU
(U_Id
, Id
=> E
);
1190 Lib_Unit
:= Unit
(Cunit
(U
.Unum
));
1192 pragma Assert
(Nkind
(Lib_Unit
) = N_Package_Declaration
);
1193 Ename
:= RE_Chars
(E
);
1195 -- Search the entity in the components of record type declarations
1196 -- found in the package entity chain.
1199 Pkg_Ent
:= First_Entity
(U
.Entity
);
1200 Search
: while Present
(Pkg_Ent
) loop
1201 if Is_Record_Type
(Pkg_Ent
) then
1202 E1
:= First_Entity
(Pkg_Ent
);
1203 while Present
(E1
) loop
1204 if Ename
= Chars
(E1
) then
1205 pragma Assert
(not Present
(Found_E
));
1213 Next_Entity
(Pkg_Ent
);
1216 -- If we didn't find the entity we want, something is wrong. The
1217 -- appropriate action will be taken by Check_CRT when we exit.
1219 -- Generate a with-clause if the current unit is part of the extended
1220 -- main code unit, and if we have not already added the with. The clause
1221 -- is added to the appropriate unit (the current one). We do not need to
1222 -- generate it for a call issued from RTE_Component_Available.
1226 In_Extended_Main_Code_Unit
(Cunit_Entity
(Current_Sem_Unit
))
1227 and then not RTE_Available_Call
1236 Lib_Unit
:= Unit
(Cunit
(U
.Unum
));
1238 Make_With_Clause
(Standard_Location
,
1241 (E
, Defining_Unit_Name
(Specification
(Lib_Unit
))));
1242 Set_Library_Unit
(Withn
, Cunit
(U
.Unum
));
1243 Set_Corresponding_Spec
(Withn
, U
.Entity
);
1244 Set_First_Name
(Withn
, True);
1245 Set_Implicit_With
(Withn
, True);
1247 Mark_Rewrite_Insertion
(Withn
);
1248 Append
(Withn
, Context_Items
(Cunit
(Current_Sem_Unit
)));
1249 Check_Restriction_No_Dependence
(Name
(Withn
), Current_Error_Node
);
1253 Front_End_Inlining
:= Save_Front_End_Inlining
;
1254 return Check_CRT
(E
, Found_E
);
1255 end RTE_Record_Component
;
1257 ------------------------------------
1258 -- RTE_Record_Component_Available --
1259 ------------------------------------
1261 function RTE_Record_Component_Available
(E
: RE_Id
) return Boolean is
1263 pragma Warnings
(Off
, Dummy
);
1267 Save_RTE_Available_Call
: constant Boolean := RTE_Available_Call
;
1268 Save_RTE_Is_Available
: constant Boolean := RTE_Is_Available
;
1269 -- These are saved recursively because the call to load a unit
1270 -- caused by an upper level call may perform a recursive call
1271 -- to this routine during analysis of the corresponding unit.
1274 RTE_Available_Call
:= True;
1275 RTE_Is_Available
:= True;
1276 Dummy
:= RTE_Record_Component
(E
);
1277 Result
:= RTE_Is_Available
;
1278 RTE_Available_Call
:= Save_RTE_Available_Call
;
1279 RTE_Is_Available
:= Save_RTE_Is_Available
;
1283 when RE_Not_Available
=>
1284 RTE_Available_Call
:= Save_RTE_Available_Call
;
1285 RTE_Is_Available
:= Save_RTE_Is_Available
;
1287 end RTE_Record_Component_Available
;
1293 procedure RTE_Error_Msg
(Msg
: String) is
1295 if RTE_Available_Call
then
1296 RTE_Is_Available
:= False;
1298 Error_Msg_N
(Msg
, Current_Error_Node
);
1300 -- Bump count of violations if we are in configurable run-time
1301 -- mode and this is not a continuation message.
1303 if Configurable_Run_Time_Mode
and then Msg
(Msg
'First) /= '\' then
1304 Configurable_Run_Time_Violations
:=
1305 Configurable_Run_Time_Violations
+ 1;
1314 function RTU_Entity
(U
: RTU_Id
) return Entity_Id
is
1316 return RT_Unit_Table
(U
).Entity
;
1323 function RTU_Loaded
(U
: RTU_Id
) return Boolean is
1325 return Present
(RT_Unit_Table
(U
).Entity
);
1328 --------------------
1329 -- Set_RTU_Loaded --
1330 --------------------
1332 procedure Set_RTU_Loaded
(N
: Node_Id
) is
1333 Loc
: constant Source_Ptr
:= Sloc
(N
);
1334 Unum
: constant Unit_Number_Type
:= Get_Source_Unit
(Loc
);
1335 Uname
: constant Unit_Name_Type
:= Unit_Name
(Unum
);
1336 E
: constant Entity_Id
:=
1337 Defining_Entity
(Unit
(Cunit
(Unum
)));
1339 pragma Assert
(Is_Predefined_File_Name
(Unit_File_Name
(Unum
)));
1341 -- Loop through entries in RTU table looking for matching entry
1343 for U_Id
in RTU_Id
'Range loop
1345 -- Here we have a match
1347 if Get_Unit_Name
(U_Id
) = Uname
then
1349 U
: RT_Unit_Table_Record
renames RT_Unit_Table
(U_Id
);
1350 -- The RT_Unit_Table entry that may need updating
1353 -- If entry is not set, set it now
1355 if No
(U
.Entity
) then
1357 U
.Uname
:= Get_Unit_Name
(U_Id
);
1368 --------------------
1369 -- Text_IO_Kludge --
1370 --------------------
1372 procedure Text_IO_Kludge
(Nam
: Node_Id
) is
1375 type Name_Map_Type
is array (Text_IO_Package_Name
) of RTU_Id
;
1377 Name_Map
: constant Name_Map_Type
:= Name_Map_Type
'(
1378 Name_Decimal_IO => Ada_Text_IO_Decimal_IO,
1379 Name_Enumeration_IO => Ada_Text_IO_Enumeration_IO,
1380 Name_Fixed_IO => Ada_Text_IO_Fixed_IO,
1381 Name_Float_IO => Ada_Text_IO_Float_IO,
1382 Name_Integer_IO => Ada_Text_IO_Integer_IO,
1383 Name_Modular_IO => Ada_Text_IO_Modular_IO);
1385 Wide_Name_Map : constant Name_Map_Type := Name_Map_Type'(
1386 Name_Decimal_IO
=> Ada_Wide_Text_IO_Decimal_IO
,
1387 Name_Enumeration_IO
=> Ada_Wide_Text_IO_Enumeration_IO
,
1388 Name_Fixed_IO
=> Ada_Wide_Text_IO_Fixed_IO
,
1389 Name_Float_IO
=> Ada_Wide_Text_IO_Float_IO
,
1390 Name_Integer_IO
=> Ada_Wide_Text_IO_Integer_IO
,
1391 Name_Modular_IO
=> Ada_Wide_Text_IO_Modular_IO
);
1393 Wide_Wide_Name_Map
: constant Name_Map_Type
:= Name_Map_Type
'(
1394 Name_Decimal_IO => Ada_Wide_Wide_Text_IO_Decimal_IO,
1395 Name_Enumeration_IO => Ada_Wide_Wide_Text_IO_Enumeration_IO,
1396 Name_Fixed_IO => Ada_Wide_Wide_Text_IO_Fixed_IO,
1397 Name_Float_IO => Ada_Wide_Wide_Text_IO_Float_IO,
1398 Name_Integer_IO => Ada_Wide_Wide_Text_IO_Integer_IO,
1399 Name_Modular_IO => Ada_Wide_Wide_Text_IO_Modular_IO);
1402 -- Nothing to do if name is not identifier or a selected component
1403 -- whose selector_name is not an identifier.
1405 if Nkind (Nam) = N_Identifier then
1406 Chrs := Chars (Nam);
1408 elsif Nkind (Nam) = N_Selected_Component
1409 and then Nkind (Selector_Name (Nam)) = N_Identifier
1411 Chrs := Chars (Selector_Name (Nam));
1417 -- Nothing to do if name is not one of the Text_IO subpackages
1418 -- Otherwise look through loaded units, and if we find Text_IO
1419 -- or [Wide_]Wide_Text_IO already loaded, then load the proper child.
1421 if Chrs in Text_IO_Package_Name then
1422 for U in Main_Unit .. Last_Unit loop
1423 Get_Name_String (Unit_File_Name (U));
1425 if Name_Len = 12 then
1427 -- Here is where we do the loads if we find one of the units
1428 -- Ada.Text_IO or Ada.[Wide_]Wide_Text_IO. An interesting
1429 -- detail is that these units may already be used (i.e. their
1430 -- In_Use flags may be set). Normally when the In_Use flag is
1431 -- set, the Is_Potentially_Use_Visible flag of all entities in
1432 -- the package is set, but the new entity we are mysteriously
1433 -- adding was not there to have its flag set at the time. So
1434 -- that's why we pass the extra parameter to RTU_Find, to make
1435 -- sure the flag does get set now. Given that those generic
1436 -- packages are in fact child units, we must indicate that
1437 -- they are visible.
1439 if Name_Buffer (1 .. 12) = "a-textio.ads" then
1442 Use_Setting => In_Use (Cunit_Entity (U)));
1443 Set_Is_Visible_Child_Unit
1444 (RT_Unit_Table (Name_Map (Chrs)).Entity);
1446 elsif Name_Buffer (1 .. 12) = "a-witeio.ads" then
1448 (Wide_Name_Map (Chrs),
1449 Use_Setting => In_Use (Cunit_Entity (U)));
1450 Set_Is_Visible_Child_Unit
1451 (RT_Unit_Table (Wide_Name_Map (Chrs)).Entity);
1453 elsif Name_Buffer (1 .. 12) = "a-ztexio.ads" then
1455 (Wide_Wide_Name_Map (Chrs),
1456 Use_Setting => In_Use (Cunit_Entity (U)));
1457 Set_Is_Visible_Child_Unit
1458 (RT_Unit_Table (Wide_Wide_Name_Map (Chrs)).Entity);
1465 -- Generate error message if run-time unit not available
1467 when RE_Not_Available =>
1468 Error_Msg_N ("& not available", Nam);