1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2007, 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 2, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING. If not, write --
19 -- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
20 -- Boston, MA 02110-1301, USA. --
22 -- GNAT was originally developed by the GNAT team at New York University. --
23 -- Extensive contributions were provided by Ada Core Technologies Inc. --
25 ------------------------------------------------------------------------------
27 with Atree; use Atree;
28 with Casing; use Casing;
29 with Csets; use Csets;
30 with Debug; use Debug;
31 with Einfo; use Einfo;
32 with Elists; use Elists;
33 with Errout; use Errout;
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 (ie. subprogram External_Tag and component
104 -- External_Tag of package Ada.Tags) this table is not used with
105 -- 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
114 -- is necessary to create an implicit WITH to ensure that the object
115 -- is correctly loaded by the binder. Such WITH statements are only
116 -- required when the request is from the extended main unit (if a
117 -- client needs a WITH, that will be taken care of when the client
120 -- We always attach the WITH to the main unit. This is not perfectly
121 -- accurate in terms of elaboration requirements, but it is close
122 -- enough, since the units that are accessed using rtsfind do not
123 -- have delicate elaboration requirements.
125 -- The flag Withed in the unit table record is initially set to False.
126 -- It is set True if a WITH has been generated for the main unit for
127 -- the corresponding unit.
129 -----------------------
130 -- Local Subprograms --
131 -----------------------
133 function Check_CRT (E : RE_Id; Eid : Entity_Id) return Entity_Id;
134 -- Check entity Eid to ensure that configurable run-time restrictions
135 -- are met. May generate an error message and raise RE_Not_Available
136 -- if the entity E does not exist (i.e. Eid is Empty)
138 procedure Entity_Not_Defined (Id : RE_Id);
139 -- Outputs error messages for an entity that is not defined in the
140 -- run-time library (the form of the error message is tailored for
141 -- no run time/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
145 -- enumeration value in RTU_Id.
147 procedure Load_Fail (S : String; U_Id : RTU_Id; Id : RE_Id);
148 -- Internal procedure called if we can't sucessfully locate or
149 -- process a run-time unit. The parameters give information about
150 -- the error message to be given. S is a reason for failing to
151 -- compile the file and U_Id is the unit id. RE_Id is the RE_Id
152 -- originally passed to RTE. The message in S is one of the
156 -- "had parser errors"
157 -- "had semantic errors"
159 -- The "not found" case is treated specially in that it is considered
160 -- a normal situation in configurable run-time mode (and the message in
161 -- this case is suppressed unless we are operating in All_Errors_Mode).
165 Id : RE_Id := RE_Null;
166 Use_Setting : Boolean := False);
167 -- Load the unit whose Id is given if not already loaded. The unit is
168 -- loaded, analyzed, and added to the WITH list, and the entry in
169 -- RT_Unit_Table is updated to reflect the load. Use_Setting is used
170 -- to indicate the initial setting for the Is_Potentially_Use_Visible
171 -- flag of the entity for the loaded unit (if it is indeed loaded).
172 -- A value of False means nothing special need be done. A value of
173 -- True indicates that this flag must be set to True. It is needed
174 -- only in the Text_IO_Kludge procedure, which may materialize an
175 -- entity of Text_IO (or [Wide_]Wide_Text_IO) that was previously unknown.
176 -- Id is the RE_Id value of the entity which was originally requested.
177 -- Id is used only for error message detail, and if it is RE_Null, then
178 -- the attempt to output the entity name is ignored.
180 function Make_Unit_Name (E : RE_Id; N : Node_Id) return Node_Id;
181 -- If the unit is a child unit, build fully qualified name for use in
184 procedure Output_Entity_Name (Id : RE_Id; Msg : String);
185 -- Output continuation error message giving qualified name of entity
186 -- corresponding to Id, appending the string given by Msg. This call
187 -- is only effective in All_Errors mode.
189 function RE_Chars (E : RE_Id) return Name_Id;
190 -- Given a RE_Id value returns the Chars of the corresponding entity
192 procedure RTE_Error_Msg (Msg : String);
193 -- Generates a message by calling Error_Msg_N specifying Current_Error_Node
194 -- as the node location using the given Msg text. Special processing in the
195 -- case where RTE_Available_Call is set. In this case, no message is output
196 -- and instead RTE_Is_Available is set to False. Note that this can only be
197 -- used if you are sure that the message comes directly or indirectly from
198 -- a call to the RTE function.
204 function Check_CRT (E : RE_Id; Eid : Entity_Id) return Entity_Id is
205 U_Id : constant RTU_Id := RE_Unit_Table (E);
209 Entity_Not_Defined (E);
210 raise RE_Not_Available;
212 -- Entity is available
215 -- If in No_Run_Time mode and entity is not in one of the
216 -- specially permitted units, raise the exception.
219 and then not OK_No_Run_Time_Unit (U_Id)
221 Entity_Not_Defined (E);
222 raise RE_Not_Available;
225 -- Otherwise entity is accessible
231 ------------------------
232 -- Entity_Not_Defined --
233 ------------------------
235 procedure Entity_Not_Defined (Id : RE_Id) is
237 if No_Run_Time_Mode then
239 -- If the error occurs when compiling the body of a predefined
240 -- unit for inlining purposes, the body must be illegal in this
241 -- mode, and there is no point in continuing.
243 if Is_Predefined_File_Name
244 (Unit_File_Name (Get_Source_Unit (Sloc (Current_Error_Node))))
247 ("construct not allowed in no run time mode!",
249 raise Unrecoverable_Error;
252 RTE_Error_Msg ("|construct not allowed in no run time mode");
255 elsif Configurable_Run_Time_Mode then
256 RTE_Error_Msg ("|construct not allowed in this configuration>");
258 RTE_Error_Msg ("run-time configuration error");
261 Output_Entity_Name (Id, "not defined");
262 end Entity_Not_Defined;
268 function Get_Unit_Name (U_Id : RTU_Id) return Unit_Name_Type is
269 Uname_Chars : constant String := RTU_Id'Image (U_Id);
272 Name_Len := Uname_Chars'Length;
273 Name_Buffer (1 .. Name_Len) := Uname_Chars;
274 Set_Casing (All_Lower_Case);
276 if U_Id in Ada_Child then
277 Name_Buffer (4) := '.';
279 if U_Id in Ada_Calendar_Child then
280 Name_Buffer (13) := '.';
282 elsif U_Id in Ada_Finalization_Child then
283 Name_Buffer (17) := '.';
285 elsif U_Id in Ada_Interrupts_Child then
286 Name_Buffer (15) := '.';
288 elsif U_Id in Ada_Real_Time_Child then
289 Name_Buffer (14) := '.';
291 elsif U_Id in Ada_Streams_Child then
292 Name_Buffer (12) := '.';
294 elsif U_Id in Ada_Text_IO_Child then
295 Name_Buffer (12) := '.';
297 elsif U_Id in Ada_Wide_Text_IO_Child then
298 Name_Buffer (17) := '.';
300 elsif U_Id in Ada_Wide_Wide_Text_IO_Child then
301 Name_Buffer (22) := '.';
304 elsif U_Id in Interfaces_Child then
305 Name_Buffer (11) := '.';
307 elsif U_Id in System_Child then
308 Name_Buffer (7) := '.';
310 if U_Id in System_Tasking_Child then
311 Name_Buffer (15) := '.';
314 if U_Id in System_Tasking_Restricted_Child then
315 Name_Buffer (26) := '.';
318 if U_Id in System_Tasking_Protected_Objects_Child then
319 Name_Buffer (33) := '.';
322 if U_Id in System_Tasking_Async_Delays_Child then
323 Name_Buffer (28) := '.';
327 -- Add %s at end for spec
329 Name_Buffer (Name_Len + 1) := '%';
330 Name_Buffer (Name_Len + 2) := 's';
331 Name_Len := Name_Len + 2;
340 procedure Initialize is
342 -- Initialize the unit table
345 RT_Unit_Table (J).Entity := Empty;
349 RE_Table (J) := Empty;
352 RTE_Is_Available := False;
359 function Is_RTE (Ent : Entity_Id; E : RE_Id) return Boolean is
360 E_Unit_Name : Unit_Name_Type;
361 Ent_Unit_Name : Unit_Name_Type;
371 -- If E has already a corresponding entity, check it directly,
372 -- going to full views if they exist to deal with the incomplete
373 -- and private type cases properly.
375 elsif Present (RE_Table (E)) then
378 if Is_Type (E1) and then Present (Full_View (E1)) then
379 E1 := Full_View (E1);
384 if Is_Type (E2) and then Present (Full_View (E2)) then
385 E2 := Full_View (E2);
391 -- If the unit containing E is not loaded, we already know that
392 -- the entity we have cannot have come from this unit.
394 E_Unit_Name := Get_Unit_Name (RE_Unit_Table (E));
396 if not Is_Loaded (E_Unit_Name) then
400 -- Here the unit containing the entity is loaded. We have not made
401 -- an explicit call to RTE to get the entity in question, but we may
402 -- have obtained a reference to it indirectly from some other entity
403 -- in the same unit, or some other unit that references it.
405 -- Get the defining unit of the entity
409 if Ekind (S) /= E_Package then
413 Ent_Unit_Name := Get_Unit_Name (Unit_Declaration_Node (S));
415 -- If the defining unit of the entity we are testing is not the
416 -- unit containing E, then they cannot possibly match.
418 if Ent_Unit_Name /= E_Unit_Name then
422 -- If the units match, then compare the names (remember that no
423 -- overloading is permitted in entities fetched using Rtsfind).
425 if RE_Chars (E) = Chars (Ent) then
428 -- If front-end inlining is enabled, we may be within a body that
429 -- contains inlined functions, which has not been retrieved through
430 -- rtsfind, and therefore is not yet recorded in the RT_Unit_Table.
431 -- Add the unit information now, it must be fully available.
434 U : RT_Unit_Table_Record
435 renames RT_Unit_Table (RE_Unit_Table (E));
437 if No (U.Entity) then
439 U.Uname := E_Unit_Name;
440 U.Unum := Get_Source_Unit (S);
454 function Is_RTU (Ent : Entity_Id; U : RTU_Id) return Boolean is
455 E : constant Entity_Id := RT_Unit_Table (U).Entity;
457 return Present (E) and then E = Ent;
460 ----------------------------
461 -- Is_Text_IO_Kludge_Unit --
462 ----------------------------
464 function Is_Text_IO_Kludge_Unit (Nam : Node_Id) return Boolean is
469 if Nkind (Nam) /= N_Expanded_Name then
474 Sel := Selector_Name (Nam);
476 if Nkind (Sel) /= N_Expanded_Name
477 or else Nkind (Prf) /= N_Identifier
478 or else Chars (Prf) /= Name_Ada
484 Sel := Selector_Name (Sel);
487 Nkind (Prf) = N_Identifier
489 (Chars (Prf) = Name_Text_IO
491 Chars (Prf) = Name_Wide_Text_IO
493 Chars (Prf) = Name_Wide_Wide_Text_IO)
495 Nkind (Sel) = N_Identifier
497 Chars (Sel) in Text_IO_Package_Name;
498 end Is_Text_IO_Kludge_Unit;
504 procedure Load_Fail (S : String; U_Id : RTU_Id; Id : RE_Id) is
505 M : String (1 .. 100);
509 -- Output header message
511 if Configurable_Run_Time_Mode then
512 RTE_Error_Msg ("construct not allowed in configurable run-time mode");
514 RTE_Error_Msg ("run-time library configuration error");
517 -- Output file name and reason string
520 or else not Configurable_Run_Time_Mode
521 or else All_Errors_Mode
523 M (1 .. 6) := "\file ";
527 (Get_File_Name (RT_Unit_Table (U_Id).Uname, Subunit => False));
528 M (P + 1 .. P + Name_Len) := Name_Buffer (1 .. Name_Len);
534 M (P + 1 .. P + S'Length) := S;
537 RTE_Error_Msg (M (1 .. P));
539 -- Output entity name
541 Output_Entity_Name (Id, "not available");
544 -- In configurable run time mode, we raise RE_Not_Available, and we hope
545 -- the caller deals gracefully with this. If we are in normal full run
546 -- time mode, a load failure is considered fatal and unrecoverable.
548 if Configurable_Run_Time_Mode then
549 raise RE_Not_Available;
551 raise Unrecoverable_Error;
561 Id : RE_Id := RE_Null;
562 Use_Setting : Boolean := False)
564 U : RT_Unit_Table_Record renames RT_Unit_Table (U_Id);
565 Priv_Par : constant Elist_Id := New_Elmt_List;
568 procedure Save_Private_Visibility;
569 -- If the current unit is the body of child unit or the spec of a
570 -- private child unit, the private declarations of the parent (s)
571 -- are visible. If the unit to be loaded is another public sibling,
572 -- its compilation will affect the visibility of the common ancestors.
573 -- Indicate those that must be restored.
575 procedure Restore_Private_Visibility;
576 -- Restore the visibility of ancestors after compiling RTU
578 --------------------------------
579 -- Restore_Private_Visibility --
580 --------------------------------
582 procedure Restore_Private_Visibility is
586 E_Par := First_Elmt (Priv_Par);
588 while Present (E_Par) loop
589 if not In_Private_Part (Node (E_Par)) then
590 Install_Private_Declarations (Node (E_Par));
595 end Restore_Private_Visibility;
597 -----------------------------
598 -- Save_Private_Visibility --
599 -----------------------------
601 procedure Save_Private_Visibility is
605 Par := Scope (Current_Scope);
608 and then Par /= Standard_Standard
610 if Ekind (Par) = E_Package
611 and then Is_Compilation_Unit (Par)
612 and then In_Private_Part (Par)
614 Append_Elmt (Par, Priv_Par);
619 end Save_Private_Visibility;
621 -- Start of processing for Load_RTU
624 -- Nothing to do if unit is already loaded
626 if Present (U.Entity) then
630 -- Note if secondary stack is used
632 if U_Id = System_Secondary_Stack then
633 Opt.Sec_Stack_Used := True;
636 -- Otherwise we need to load the unit, First build unit name
637 -- from the enumeration literal name in type RTU_Id.
639 U.Uname := Get_Unit_Name (U_Id);
644 pragma Warnings (Off, Loaded);
646 Loaded := Is_Loaded (U.Uname);
649 -- Now do the load call, note that setting Error_Node to Empty is
650 -- a signal to Load_Unit that we will regard a failure to find the
651 -- file as a fatal error, and that it should not output any kind
652 -- of diagnostics, since we will take care of it here.
656 (Load_Name => U.Uname,
659 Error_Node => Empty);
661 if U.Unum = No_Unit then
662 Load_Fail ("not found", U_Id, Id);
663 elsif Fatal_Error (U.Unum) then
664 Load_Fail ("had parser errors", U_Id, Id);
667 -- Make sure that the unit is analyzed
670 Was_Analyzed : constant Boolean :=
671 Analyzed (Cunit (Current_Sem_Unit));
674 -- Pretend that the current unit is analyzed, in case it is System
675 -- or some such. This allows us to put some declarations, such as
676 -- exceptions and packed arrays of Boolean, into System even though
677 -- expanding them requires System...
679 -- This is a bit odd but works fine. If the RTS unit does not depend
680 -- in any way on the current unit, then it never gets back into the
681 -- current unit's tree, and the change we make to the current unit
682 -- tree is never noticed by anyone (it is undone in a moment). That
683 -- is the normal situation.
685 -- If the RTS Unit *does* depend on the current unit, for instance,
686 -- when you are compiling System, then you had better have finished
687 -- analyzing the part of System that is depended on before you try
688 -- to load the RTS Unit. This means having the System ordered in an
689 -- appropriate manner.
691 Set_Analyzed (Cunit (Current_Sem_Unit), True);
693 if not Analyzed (Cunit (U.Unum)) then
695 -- If the unit is already loaded through a limited_with clauses,
696 -- the relevant entities must already be available. We do not
697 -- want to load and analyze the unit because this would create
698 -- a real semantic dependence when the purpose of the limited_with
699 -- is precisely to avoid such.
701 if From_With_Type (Cunit_Entity (U.Unum)) then
705 Save_Private_Visibility;
706 Semantics (Cunit (U.Unum));
707 Restore_Private_Visibility;
709 if Fatal_Error (U.Unum) then
710 Load_Fail ("had semantic errors", U_Id, Id);
717 Set_Analyzed (Cunit (Current_Sem_Unit), Was_Analyzed);
720 Lib_Unit := Unit (Cunit (U.Unum));
721 U.Entity := Defining_Entity (Lib_Unit);
724 Set_Is_Potentially_Use_Visible (U.Entity, True);
732 function Make_Unit_Name (E : RE_Id; N : Node_Id) return Node_Id is
733 U_Id : constant RTU_Id := RE_Unit_Table (E);
734 U : RT_Unit_Table_Record renames RT_Unit_Table (U_Id);
739 Nam := New_Reference_To (U.Entity, Standard_Location);
740 Scop := Scope (U.Entity);
742 if Nkind (N) = N_Defining_Program_Unit_Name then
743 while Scop /= Standard_Standard loop
745 Make_Expanded_Name (Standard_Location,
746 Chars => Chars (U.Entity),
747 Prefix => New_Reference_To (Scop, Standard_Location),
748 Selector_Name => Nam);
749 Set_Entity (Nam, U.Entity);
751 Scop := Scope (Scop);
758 -----------------------
759 -- Output_Entity_Name --
760 ------------------------
762 procedure Output_Entity_Name (Id : RE_Id; Msg : String) is
763 M : String (1 .. 2048);
765 -- M (1 .. P) is current message to be output
767 RE_Image : constant String := RE_Id'Image (Id);
770 if Id = RE_Null or else not All_Errors_Mode then
774 M (1 .. 9) := "\entity """;
777 -- Add unit name to message, excluding %s or %b at end
779 Get_Name_String (Get_Unit_Name (RE_Unit_Table (Id)));
780 Name_Len := Name_Len - 2;
781 Set_Casing (Mixed_Case);
782 M (P + 1 .. P + Name_Len) := Name_Buffer (1 .. Name_Len);
785 -- Add a qualifying period
790 -- Add entity name and closing quote to message
792 Name_Len := RE_Image'Length - 3;
793 Name_Buffer (1 .. Name_Len) := RE_Image (4 .. RE_Image'Length);
794 Set_Casing (Mixed_Case);
795 M (P + 1 .. P + Name_Len) := Name_Buffer (1 .. Name_Len);
804 M (P + 1 .. P + Msg'Length) := Msg;
807 -- Output message at current error node location
809 RTE_Error_Msg (M (1 .. P));
810 end Output_Entity_Name;
816 function RE_Chars (E : RE_Id) return Name_Id is
817 RE_Name_Chars : constant String := RE_Id'Image (E);
820 -- Copy name skipping initial RE_ or RO_XX characters
822 if RE_Name_Chars (1 .. 2) = "RE" then
823 for J in 4 .. RE_Name_Chars'Last loop
824 Name_Buffer (J - 3) := Fold_Lower (RE_Name_Chars (J));
827 Name_Len := RE_Name_Chars'Length - 3;
830 for J in 7 .. RE_Name_Chars'Last loop
831 Name_Buffer (J - 6) := Fold_Lower (RE_Name_Chars (J));
834 Name_Len := RE_Name_Chars'Length - 6;
844 function RTE (E : RE_Id) return Entity_Id is
845 U_Id : constant RTU_Id := RE_Unit_Table (E);
846 U : RT_Unit_Table_Record renames RT_Unit_Table (U_Id);
852 -- The following flag is used to disable front-end inlining when RTE
853 -- is invoked. This prevents the analysis of other runtime bodies when
854 -- a particular spec is loaded through Rtsfind. This is both efficient,
855 -- and it prevents spurious visibility conflicts between use-visible
856 -- user entities, and entities in run-time packages.
858 -- In configurable run-time mode, subprograms marked Inlined_Always must
859 -- be inlined, so in the case we retain the Front_End_Inlining mode.
861 Save_Front_End_Inlining : Boolean;
864 -- Reject programs that make use of distribution features not supported
865 -- on the current target. On such targets (VMS, Vxworks, others?) we
866 -- only provide a minimal body for System.Rpc that only supplies an
867 -- implementation of partition_id.
869 function Find_Local_Entity (E : RE_Id) return Entity_Id;
870 -- This function is used when entity E is in this compilation's main
871 -- unit. It gets the value from the already compiled declaration.
877 procedure Check_RPC is
879 -- Bypass this check if debug flag -gnatdR set
881 if Debug_Flag_RR then
885 -- Otherwise we need the check if we are going after one of
886 -- the critical entities in System.RPC in stubs mode.
888 -- ??? Should we do this for other s-parint entities too?
890 if (Distribution_Stub_Mode = Generate_Receiver_Stub_Body
892 Distribution_Stub_Mode = Generate_Caller_Stub_Body)
893 and then (E = RE_Do_Rpc
897 E = RE_Params_Stream_Type
899 E = RE_Request_Access)
900 and then Get_PCS_Name = Name_No_DSA
903 Write_Str ("distribution feature not supported");
905 raise Unrecoverable_Error;
909 -----------------------
910 -- Find_Local_Entity --
911 -----------------------
913 function Find_Local_Entity (E : RE_Id) return Entity_Id is
914 RE_Str : constant String := RE_Id'Image (E);
918 Save_Nam : constant String := Name_Buffer (1 .. Name_Len);
919 -- Save name buffer and length over call
922 Name_Len := Natural'Max (0, RE_Str'Length - 3);
923 Name_Buffer (1 .. Name_Len) :=
924 RE_Str (RE_Str'First + 3 .. RE_Str'Last);
927 Ent := Entity_Id (Get_Name_Table_Info (Nam));
929 Name_Len := Save_Nam'Length;
930 Name_Buffer (1 .. Name_Len) := Save_Nam;
933 end Find_Local_Entity;
935 -- Start of processing for RTE
938 -- Doing a rtsfind in system.ads is special, as we cannot do this
939 -- when compiling System itself. So if we are compiling system then
940 -- we should already have acquired and processed the declaration
941 -- of the entity. The test is to see if this compilation's main unit
942 -- is System. If so, return the value from the already compiled
943 -- declaration and otherwise do a regular find.
945 -- Not pleasant, but these kinds of annoying recursion when
946 -- writing an Ada compiler in Ada have to be broken somewhere!
948 if Present (Main_Unit_Entity)
949 and then Chars (Main_Unit_Entity) = Name_System
950 and then Analyzed (Main_Unit_Entity)
951 and then not Is_Child_Unit (Main_Unit_Entity)
953 return Check_CRT (E, Find_Local_Entity (E));
956 Save_Front_End_Inlining := Front_End_Inlining;
957 Front_End_Inlining := Configurable_Run_Time_Mode;
959 -- Load unit if unit not previously loaded
961 if No (RE_Table (E)) then
962 Load_RTU (U_Id, Id => E);
963 Lib_Unit := Unit (Cunit (U.Unum));
965 -- In the subprogram case, we are all done, the entity we want
966 -- is the entity for the subprogram itself. Note that we do not
967 -- bother to check that it is the entity that was requested.
968 -- the only way that could fail to be the case is if runtime is
969 -- hopelessly misconfigured, and it isn't worth testing for this.
971 if Nkind (Lib_Unit) = N_Subprogram_Declaration then
972 RE_Table (E) := U.Entity;
974 -- Otherwise we must have the package case. First check package
975 -- entity itself (e.g. RTE_Name for System.Interrupts.Name)
978 pragma Assert (Nkind (Lib_Unit) = N_Package_Declaration);
979 Ename := RE_Chars (E);
981 -- First we search the package entity chain. If the package
982 -- only has a limited view, scan the corresponding list of
985 if From_With_Type (U.Entity) then
986 Pkg_Ent := First_Entity (Limited_View (U.Entity));
988 Pkg_Ent := First_Entity (U.Entity);
991 while Present (Pkg_Ent) loop
992 if Ename = Chars (Pkg_Ent) then
993 RE_Table (E) := Pkg_Ent;
998 Next_Entity (Pkg_Ent);
1001 -- If we did not find the entity in the package entity chain,
1002 -- then check if the package entity itself matches. Note that
1003 -- we do this check after searching the entity chain, since
1004 -- the rule is that in case of ambiguity, we prefer the entity
1005 -- defined within the package, rather than the package itself.
1007 if Ename = Chars (U.Entity) then
1008 RE_Table (E) := U.Entity;
1011 -- If we didn't find the entity we want, something is wrong.
1012 -- We just leave RE_Table (E) set to Empty and the appropriate
1013 -- action will be taken by Check_CRT when we exit.
1018 -- See if we have to generate a WITH for this entity. We generate
1019 -- a WITH if the current unit is part of the extended main code
1020 -- unit, and if we have not already added the with. The WITH is
1021 -- added to the appropriate unit (the current one). We do not need
1022 -- to generate a WITH for a call issued from RTE_Available.
1027 In_Extended_Main_Code_Unit (Cunit_Entity (Current_Sem_Unit))
1028 and then not RTE_Available_Call
1037 Lib_Unit := Unit (Cunit (U.Unum));
1039 Make_With_Clause (Standard_Location,
1042 (E, Defining_Unit_Name (Specification (Lib_Unit))));
1043 Set_Library_Unit (Withn, Cunit (U.Unum));
1044 Set_Corresponding_Spec (Withn, U.Entity);
1045 Set_First_Name (Withn, True);
1046 Set_Implicit_With (Withn, True);
1048 Mark_Rewrite_Insertion (Withn);
1049 Append (Withn, Context_Items (Cunit (Current_Sem_Unit)));
1050 Check_Restriction_No_Dependence (Name (Withn), Current_Error_Node);
1054 Front_End_Inlining := Save_Front_End_Inlining;
1055 return Check_CRT (E, RE_Table (E));
1062 function RTE_Available (E : RE_Id) return Boolean is
1064 pragma Warnings (Off, Dummy);
1068 Save_RTE_Available_Call : constant Boolean := RTE_Available_Call;
1069 Save_RTE_Is_Available : constant Boolean := RTE_Is_Available;
1070 -- These are saved recursively because the call to load a unit
1071 -- caused by an upper level call may perform a recursive call
1072 -- to this routine during analysis of the corresponding unit.
1075 RTE_Available_Call := True;
1076 RTE_Is_Available := True;
1078 Result := RTE_Is_Available;
1079 RTE_Available_Call := Save_RTE_Available_Call;
1080 RTE_Is_Available := Save_RTE_Is_Available;
1084 when RE_Not_Available =>
1085 RTE_Available_Call := Save_RTE_Available_Call;
1086 RTE_Is_Available := Save_RTE_Is_Available;
1090 --------------------------
1091 -- RTE_Record_Component --
1092 --------------------------
1094 function RTE_Record_Component (E : RE_Id) return Entity_Id is
1095 U_Id : constant RTU_Id := RE_Unit_Table (E);
1096 U : RT_Unit_Table_Record renames RT_Unit_Table (U_Id);
1099 Found_E : Entity_Id;
1101 Pkg_Ent : Entity_Id;
1103 -- The following flag is used to disable front-end inlining when
1104 -- RTE_Record_Component is invoked. This prevents the analysis of other
1105 -- runtime bodies when a particular spec is loaded through Rtsfind. This
1106 -- is both efficient, and it prevents spurious visibility conflicts
1107 -- between use-visible user entities, and entities in run-time packages.
1109 -- In configurable run-time mode, subprograms marked Inlined_Always must
1110 -- be inlined, so in the case we retain the Front_End_Inlining mode.
1112 Save_Front_End_Inlining : Boolean;
1115 -- Note: Contrary to subprogram RTE, there is no need to do any special
1116 -- management with package system.ads because it has no record type
1119 Save_Front_End_Inlining := Front_End_Inlining;
1120 Front_End_Inlining := Configurable_Run_Time_Mode;
1122 -- Load unit if unit not previously loaded
1124 if not Present (U.Entity) then
1125 Load_RTU (U_Id, Id => E);
1128 Lib_Unit := Unit (Cunit (U.Unum));
1130 pragma Assert (Nkind (Lib_Unit) = N_Package_Declaration);
1131 Ename := RE_Chars (E);
1133 -- Search the entity in the components of record type declarations
1134 -- found in the package entity chain.
1137 Pkg_Ent := First_Entity (U.Entity);
1138 Search : while Present (Pkg_Ent) loop
1139 if Is_Record_Type (Pkg_Ent) then
1140 E1 := First_Entity (Pkg_Ent);
1141 while Present (E1) loop
1142 if Ename = Chars (E1) then
1143 pragma Assert (not Present (Found_E));
1151 Next_Entity (Pkg_Ent);
1154 -- If we didn't find the entity we want, something is wrong. The
1155 -- appropriate action will be taken by Check_CRT when we exit.
1157 -- Cenerate a with-clause if the current unit is part of the extended
1158 -- main code unit, and if we have not already added the with. The clause
1159 -- is added to the appropriate unit (the current one). We do not need to
1160 -- generate it for a call issued from RTE_Component_Available.
1164 In_Extended_Main_Code_Unit (Cunit_Entity (Current_Sem_Unit))
1165 and then not RTE_Available_Call
1174 Lib_Unit := Unit (Cunit (U.Unum));
1176 Make_With_Clause (Standard_Location,
1179 (E, Defining_Unit_Name (Specification (Lib_Unit))));
1180 Set_Library_Unit (Withn, Cunit (U.Unum));
1181 Set_Corresponding_Spec (Withn, U.Entity);
1182 Set_First_Name (Withn, True);
1183 Set_Implicit_With (Withn, True);
1185 Mark_Rewrite_Insertion (Withn);
1186 Append (Withn, Context_Items (Cunit (Current_Sem_Unit)));
1187 Check_Restriction_No_Dependence (Name (Withn), Current_Error_Node);
1191 Front_End_Inlining := Save_Front_End_Inlining;
1192 return Check_CRT (E, Found_E);
1193 end RTE_Record_Component;
1195 ------------------------------------
1196 -- RTE_Record_Component_Available --
1197 ------------------------------------
1199 function RTE_Record_Component_Available (E : RE_Id) return Boolean is
1201 pragma Warnings (Off, Dummy);
1205 Save_RTE_Available_Call : constant Boolean := RTE_Available_Call;
1206 Save_RTE_Is_Available : constant Boolean := RTE_Is_Available;
1207 -- These are saved recursively because the call to load a unit
1208 -- caused by an upper level call may perform a recursive call
1209 -- to this routine during analysis of the corresponding unit.
1212 RTE_Available_Call := True;
1213 RTE_Is_Available := True;
1214 Dummy := RTE_Record_Component (E);
1215 Result := RTE_Is_Available;
1216 RTE_Available_Call := Save_RTE_Available_Call;
1217 RTE_Is_Available := Save_RTE_Is_Available;
1221 when RE_Not_Available =>
1222 RTE_Available_Call := Save_RTE_Available_Call;
1223 RTE_Is_Available := Save_RTE_Is_Available;
1225 end RTE_Record_Component_Available;
1231 procedure RTE_Error_Msg (Msg : String) is
1233 if RTE_Available_Call then
1234 RTE_Is_Available := False;
1236 Error_Msg_N (Msg, Current_Error_Node);
1238 -- Bump count of violations if we are in configurable run-time
1239 -- mode and this is not a continuation message.
1241 if Configurable_Run_Time_Mode and then Msg (Msg'First) /= '\' then
1242 Configurable_Run_Time_Violations :=
1243 Configurable_Run_Time_Violations + 1;
1252 function RTU_Entity (U : RTU_Id) return Entity_Id is
1254 return RT_Unit_Table (U).Entity;
1261 function RTU_Loaded (U : RTU_Id) return Boolean is
1263 return Present (RT_Unit_Table (U).Entity);
1266 --------------------
1267 -- Set_RTU_Loaded --
1268 --------------------
1270 procedure Set_RTU_Loaded (N : Node_Id) is
1271 Loc : constant Source_Ptr := Sloc (N);
1272 Unum : constant Unit_Number_Type := Get_Source_Unit (Loc);
1273 Uname : constant Unit_Name_Type := Unit_Name (Unum);
1274 E : constant Entity_Id :=
1275 Defining_Entity (Unit (Cunit (Unum)));
1277 pragma Assert (Is_Predefined_File_Name (Unit_File_Name (Unum)));
1279 -- Loop through entries in RTU table looking for matching entry
1281 for U_Id in RTU_Id'Range loop
1283 -- Here we have a match
1285 if Get_Unit_Name (U_Id) = Uname then
1287 U : RT_Unit_Table_Record renames RT_Unit_Table (U_Id);
1288 -- The RT_Unit_Table entry that may need updating
1291 -- If entry is not set, set it now
1293 if No (U.Entity) then
1295 U.Uname := Get_Unit_Name (U_Id);
1306 --------------------
1307 -- Text_IO_Kludge --
1308 --------------------
1310 procedure Text_IO_Kludge (Nam : Node_Id) is
1313 type Name_Map_Type is array (Text_IO_Package_Name) of RTU_Id;
1315 Name_Map : constant Name_Map_Type := Name_Map_Type'(
1316 Name_Decimal_IO => Ada_Text_IO_Decimal_IO,
1317 Name_Enumeration_IO => Ada_Text_IO_Enumeration_IO,
1318 Name_Fixed_IO => Ada_Text_IO_Fixed_IO,
1319 Name_Float_IO => Ada_Text_IO_Float_IO,
1320 Name_Integer_IO => Ada_Text_IO_Integer_IO,
1321 Name_Modular_IO => Ada_Text_IO_Modular_IO);
1323 Wide_Name_Map : constant Name_Map_Type := Name_Map_Type'(
1324 Name_Decimal_IO => Ada_Wide_Text_IO_Decimal_IO,
1325 Name_Enumeration_IO => Ada_Wide_Text_IO_Enumeration_IO,
1326 Name_Fixed_IO => Ada_Wide_Text_IO_Fixed_IO,
1327 Name_Float_IO => Ada_Wide_Text_IO_Float_IO,
1328 Name_Integer_IO => Ada_Wide_Text_IO_Integer_IO,
1329 Name_Modular_IO => Ada_Wide_Text_IO_Modular_IO);
1331 Wide_Wide_Name_Map : constant Name_Map_Type := Name_Map_Type'(
1332 Name_Decimal_IO => Ada_Wide_Wide_Text_IO_Decimal_IO,
1333 Name_Enumeration_IO => Ada_Wide_Wide_Text_IO_Enumeration_IO,
1334 Name_Fixed_IO => Ada_Wide_Wide_Text_IO_Fixed_IO,
1335 Name_Float_IO => Ada_Wide_Wide_Text_IO_Float_IO,
1336 Name_Integer_IO => Ada_Wide_Wide_Text_IO_Integer_IO,
1337 Name_Modular_IO => Ada_Wide_Wide_Text_IO_Modular_IO);
1340 -- Nothing to do if name is not identifier or a selected component
1341 -- whose selector_name is not an identifier.
1343 if Nkind (Nam) = N_Identifier then
1344 Chrs := Chars (Nam);
1346 elsif Nkind (Nam) = N_Selected_Component
1347 and then Nkind (Selector_Name (Nam)) = N_Identifier
1349 Chrs := Chars (Selector_Name (Nam));
1355 -- Nothing to do if name is not one of the Text_IO subpackages
1356 -- Otherwise look through loaded units, and if we find Text_IO
1357 -- or [Wide_]Wide_Text_IO already loaded, then load the proper child.
1359 if Chrs in Text_IO_Package_Name then
1360 for U in Main_Unit .. Last_Unit loop
1361 Get_Name_String (Unit_File_Name (U));
1363 if Name_Len = 12 then
1365 -- Here is where we do the loads if we find one of the units
1366 -- Ada.Text_IO or Ada.[Wide_]Wide_Text_IO. An interesting
1367 -- detail is that these units may already be used (i.e. their
1368 -- In_Use flags may be set). Normally when the In_Use flag is
1369 -- set, the Is_Potentially_Use_Visible flag of all entities in
1370 -- the package is set, but the new entity we are mysteriously
1371 -- adding was not there to have its flag set at the time. So
1372 -- that's why we pass the extra parameter to RTU_Find, to make
1373 -- sure the flag does get set now. Given that those generic
1374 -- packages are in fact child units, we must indicate that
1375 -- they are visible.
1377 if Name_Buffer (1 .. 12) = "a-textio.ads" then
1380 Use_Setting => In_Use (Cunit_Entity (U)));
1381 Set_Is_Visible_Child_Unit
1382 (RT_Unit_Table (Name_Map (Chrs)).Entity);
1384 elsif Name_Buffer (1 .. 12) = "a-witeio.ads" then
1386 (Wide_Name_Map (Chrs),
1387 Use_Setting => In_Use (Cunit_Entity (U)));
1388 Set_Is_Visible_Child_Unit
1389 (RT_Unit_Table (Wide_Name_Map (Chrs)).Entity);
1391 elsif Name_Buffer (1 .. 12) = "a-ztexio.ads" then
1393 (Wide_Wide_Name_Map (Chrs),
1394 Use_Setting => In_Use (Cunit_Entity (U)));
1395 Set_Is_Visible_Child_Unit
1396 (RT_Unit_Table (Wide_Wide_Name_Map (Chrs)).Entity);
1403 -- Generate error message if run-time unit not available
1405 when RE_Not_Available =>
1406 Error_Msg_N ("& not available", Nam);