1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2023, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 with Atree
; use Atree
;
27 with Debug
; use Debug
;
28 with Einfo
; use Einfo
;
29 with Einfo
.Entities
; use Einfo
.Entities
;
30 with Einfo
.Utils
; use Einfo
.Utils
;
31 with Elists
; use Elists
;
32 with Errout
; use Errout
;
34 with Namet
; use Namet
;
35 with Nlists
; use Nlists
;
38 with Sem_Attr
; use Sem_Attr
;
39 with Sem_Aux
; use Sem_Aux
;
40 with Sem_Dist
; use Sem_Dist
;
41 with Sem_Eval
; use Sem_Eval
;
42 with Sem_Util
; use Sem_Util
;
43 with Sinfo
; use Sinfo
;
44 with Sinfo
.Nodes
; use Sinfo
.Nodes
;
45 with Sinfo
.Utils
; use Sinfo
.Utils
;
46 with Snames
; use Snames
;
47 with Stand
; use Stand
;
49 package body Sem_Cat
is
51 -----------------------
52 -- Local Subprograms --
53 -----------------------
55 procedure Check_Categorization_Dependencies
56 (Unit_Entity
: Entity_Id
;
57 Depended_Entity
: Entity_Id
;
59 Is_Subunit
: Boolean);
60 -- This procedure checks that the categorization of a lib unit and that
61 -- of the depended unit satisfy dependency restrictions.
62 -- The depended_entity can be the entity in a with_clause item, in which
63 -- case Info_Node denotes that item. The depended_entity can also be the
64 -- parent unit of a child unit, in which case Info_Node is the declaration
65 -- of the child unit. The error message is posted on Info_Node, and is
66 -- specialized if Is_Subunit is true.
68 procedure Check_Non_Static_Default_Expr
71 -- Iterate through the component list of a record definition, check
72 -- that no component is declared with a nonstatic default value.
73 -- If a nonstatic default exists, report an error on Obj_Decl.
75 function Has_Read_Write_Attributes
(E
: Entity_Id
) return Boolean;
76 -- Return True if entity has attribute definition clauses for Read and
77 -- Write attributes that are visible at some place.
79 function Is_Non_Remote_Access_Type
(E
: Entity_Id
) return Boolean;
80 -- Returns true if the entity is a type whose full view is a non-remote
81 -- access type, for the purpose of enforcing E.2.2(8) rules.
83 function Has_Non_Remote_Access
(Typ
: Entity_Id
) return Boolean;
84 -- Return true if Typ or the type of any of its subcomponents is a non
85 -- remote access type and doesn't have user-defined stream attributes.
87 function No_External_Streaming
(E
: Entity_Id
) return Boolean;
88 -- Return True if the entity or one of its subcomponents does not support
89 -- external streaming.
91 function In_RCI_Declaration
return Boolean;
92 function In_RT_Declaration
return Boolean;
93 -- Determine if current scope is within the declaration of a Remote Call
94 -- Interface or Remote Types unit, for semantic checking purposes.
96 function In_Package_Declaration
return Boolean;
97 -- Shared supporting routine for In_RCI_Declaration and In_RT_Declaration
99 function In_Shared_Passive_Unit
return Boolean;
100 -- Determines if current scope is within a Shared Passive compilation unit
102 function Static_Discriminant_Expr
(L
: List_Id
) return Boolean;
103 -- Iterate through the list of discriminants to check if any of them
104 -- contains non-static default expression, which is a violation in
105 -- a preelaborated library unit.
107 procedure Validate_Remote_Access_Object_Type_Declaration
(T
: Entity_Id
);
108 -- Check validity of declaration if RCI or RT unit. It should not contain
109 -- the declaration of an access-to-object type unless it is a general
110 -- access type that designates a class-wide limited private type. There are
111 -- also constraints about the primitive subprograms of the class-wide type.
112 -- RM E.2 (9, 13, 14)
114 procedure Validate_RACW_Primitive
117 -- Check legality of the declaration of primitive Subp of the designated
118 -- type of the given RACW type.
120 ---------------------------------------
121 -- Check_Categorization_Dependencies --
122 ---------------------------------------
124 procedure Check_Categorization_Dependencies
125 (Unit_Entity
: Entity_Id
;
126 Depended_Entity
: Entity_Id
;
128 Is_Subunit
: Boolean)
130 N
: constant Node_Id
:= Info_Node
;
133 -- Here we define an enumeration type to represent categorization types,
134 -- ordered so that a unit with a given categorization can only WITH
135 -- units with lower or equal categorization type.
137 type Categorization
is
141 Remote_Call_Interface
,
144 function Get_Categorization
(E
: Entity_Id
) return Categorization
;
145 -- Check categorization flags from entity, and return in the form
146 -- of the lowest value of the Categorization type that applies to E.
148 ------------------------
149 -- Get_Categorization --
150 ------------------------
152 function Get_Categorization
(E
: Entity_Id
) return Categorization
is
154 -- Get the lowest categorization that corresponds to E. Note that
155 -- nothing prevents several (different) categorization pragmas
156 -- to apply to the same library unit, in which case the unit has
157 -- all associated categories, so we need to be careful here to
158 -- check pragmas in proper Categorization order in order to
159 -- return the lowest applicable value.
161 -- Ignore Pure specification if set by pragma Pure_Function
165 (Has_Pragma_Pure_Function
(E
) and not Has_Pragma_Pure
(E
))
169 elsif Is_Shared_Passive
(E
) then
170 return Shared_Passive
;
172 elsif Is_Remote_Types
(E
) then
175 elsif Is_Remote_Call_Interface
(E
) then
176 return Remote_Call_Interface
;
181 end Get_Categorization
;
183 Unit_Category
: Categorization
;
184 With_Category
: Categorization
;
186 -- Start of processing for Check_Categorization_Dependencies
189 -- Intrinsic subprograms are preelaborated, so do not impose any
190 -- categorization dependencies. Also, ignore categorization
191 -- dependencies when compilation switch -gnatdu is used.
193 if Is_Intrinsic_Subprogram
(Depended_Entity
) or else Debug_Flag_U
then
197 -- First check 10.2.1 (11/1) rules on preelaborate packages
199 if Is_Preelaborated
(Unit_Entity
)
200 and then not Is_Preelaborated
(Depended_Entity
)
201 and then not Is_Pure
(Depended_Entity
)
208 -- Check categorization rules of RM E.2(5)
210 Unit_Category
:= Get_Categorization
(Unit_Entity
);
211 With_Category
:= Get_Categorization
(Depended_Entity
);
213 if With_Category
> Unit_Category
then
215 -- Special case: Remote_Types and Remote_Call_Interface are allowed
216 -- to WITH anything in the package body, per (RM E.2(5)).
218 if (Unit_Category
= Remote_Types
219 or else Unit_Category
= Remote_Call_Interface
)
220 and then In_Package_Body
(Unit_Entity
)
224 -- Special case: Remote_Types and Remote_Call_Interface declarations
225 -- can depend on a preelaborated unit via a private with_clause, per
228 elsif (Unit_Category
= Remote_Types
230 Unit_Category
= Remote_Call_Interface
)
231 and then Nkind
(N
) = N_With_Clause
232 and then Private_Present
(N
)
233 and then Is_Preelaborated
(Depended_Entity
)
237 -- All other cases, we do have an error
244 -- Here if we have an error
248 -- These messages are warnings in GNAT mode or if the -gnateP switch
249 -- was set. Otherwise these are real errors for real illegalities.
251 -- The reason we suppress these errors in GNAT mode is that the run-
252 -- time has several instances of violations of the categorization
253 -- errors (e.g. Pure units withing Preelaborate units. All these
254 -- violations are harmless in the cases where we intend them, and
255 -- we suppress the warnings with Warnings (Off). In cases where we
256 -- do not intend the violation, warnings are errors in GNAT mode
257 -- anyway, so we will still get an error.
260 Treat_Categorization_Errors_As_Warnings
or GNAT_Mode
;
262 -- Don't give error if main unit is not an internal unit, and the
263 -- unit generating the message is an internal unit. This is the
264 -- situation in which such messages would be ignored in any case,
265 -- so it is convenient not to generate them (since it causes
266 -- annoying interference with debugging).
268 if Is_Internal_Unit
(Current_Sem_Unit
)
269 and then not Is_Internal_Unit
(Main_Unit
)
273 -- Dependence of Remote_Types or Remote_Call_Interface declaration
274 -- on a preelaborated unit with a normal with_clause.
276 elsif (Unit_Category
= Remote_Types
278 Unit_Category
= Remote_Call_Interface
)
279 and then Is_Preelaborated
(Depended_Entity
)
282 ("<<must use private with clause for preelaborated unit&",
287 elsif Is_Subunit
then
289 ("<subunit cannot depend on& " &
290 "(parent has wrong categorization)", N
, Depended_Entity
);
292 -- Normal unit, not subunit
296 ("<<cannot depend on& " &
297 "(wrong categorization)", N
, Depended_Entity
);
300 -- Add further explanation for Pure/Preelaborate common cases
302 if Unit_Category
= Pure
then
304 ("\<<pure unit cannot depend on non-pure unit", N
);
306 elsif Is_Preelaborated
(Unit_Entity
)
307 and then not Is_Preelaborated
(Depended_Entity
)
308 and then not Is_Pure
(Depended_Entity
)
311 ("\<<preelaborated unit cannot depend on "
312 & "non-preelaborated unit", N
);
315 end Check_Categorization_Dependencies
;
317 -----------------------------------
318 -- Check_Non_Static_Default_Expr --
319 -----------------------------------
321 procedure Check_Non_Static_Default_Expr
326 Component_Decl
: Node_Id
;
329 if Nkind
(Type_Def
) = N_Derived_Type_Definition
then
330 Recdef
:= Record_Extension_Part
(Type_Def
);
340 -- Check that component declarations do not involve:
342 -- a. a non-static default expression, where the object is
343 -- declared to be default initialized.
345 -- b. a dynamic Itype (discriminants and constraints)
347 if Null_Present
(Recdef
) then
350 Component_Decl
:= First
(Component_Items
(Component_List
(Recdef
)));
353 while Present
(Component_Decl
)
354 and then Nkind
(Component_Decl
) = N_Component_Declaration
356 if Present
(Expression
(Component_Decl
))
357 and then Nkind
(Expression
(Component_Decl
)) /= N_Null
358 and then not Is_OK_Static_Expression
(Expression
(Component_Decl
))
360 -- If we're in a predefined unit, we can put whatever we like in a
361 -- preelaborated package, and in fact in some cases it's necessary
362 -- to bend the rules. Ada.Containers.Bounded_Hashed_Maps contains
363 -- some code that would not be considered preelaborable in user
364 -- code, for example.
366 and then not In_Predefined_Unit
(Component_Decl
)
368 Error_Msg_Sloc
:= Sloc
(Component_Decl
);
370 ("object in preelaborated unit has non-static default#",
373 -- Fix this later ???
375 -- elsif Has_Dynamic_Itype (Component_Decl) then
377 -- ("dynamic type discriminant," &
378 -- " constraint in preelaborated unit",
382 Next
(Component_Decl
);
384 end Check_Non_Static_Default_Expr
;
386 ---------------------------
387 -- Has_Non_Remote_Access --
388 ---------------------------
390 function Has_Non_Remote_Access
(Typ
: Entity_Id
) return Boolean is
391 Component
: Entity_Id
;
392 Comp_Type
: Entity_Id
;
393 U_Typ
: constant Entity_Id
:= Underlying_Type
(Typ
);
399 elsif Has_Read_Write_Attributes
(Typ
)
400 or else Has_Read_Write_Attributes
(U_Typ
)
404 elsif Is_Non_Remote_Access_Type
(U_Typ
) then
408 if Is_Record_Type
(U_Typ
) then
409 Component
:= First_Entity
(U_Typ
);
410 while Present
(Component
) loop
411 if not Is_Tag
(Component
) then
412 Comp_Type
:= Etype
(Component
);
414 if Has_Non_Remote_Access
(Comp_Type
) then
419 Next_Entity
(Component
);
422 elsif Is_Array_Type
(U_Typ
) then
423 return Has_Non_Remote_Access
(Component_Type
(U_Typ
));
428 end Has_Non_Remote_Access
;
430 -------------------------------
431 -- Has_Read_Write_Attributes --
432 -------------------------------
434 function Has_Read_Write_Attributes
(E
: Entity_Id
) return Boolean is
438 and then Has_Stream_Attribute_Definition
439 (E
, TSS_Stream_Read
, Real_Rep
, At_Any_Place
=> True)
440 and then Has_Stream_Attribute_Definition
441 (E
, TSS_Stream_Write
, Real_Rep
, At_Any_Place
=> True);
442 end Has_Read_Write_Attributes
;
444 -------------------------------------
445 -- Has_Stream_Attribute_Definition --
446 -------------------------------------
448 function Has_Stream_Attribute_Definition
451 Real_Rep
: out Node_Id
;
452 At_Any_Place
: Boolean := False) return Boolean
457 -- We start from the declaration node and then loop until the end of
458 -- the list until we find the requested attribute definition clause.
459 -- In Ada 2005 mode, clauses are ignored if they are not currently
460 -- visible (this is tested using the corresponding Entity, which is
461 -- inserted by the expander at the point where the clause occurs),
462 -- unless At_Any_Place is true.
466 Rep_Item
:= First_Rep_Item
(Typ
);
467 while Present
(Rep_Item
) loop
468 Real_Rep
:= Rep_Item
;
470 -- If the representation item is an aspect specification, retrieve
471 -- the corresponding pragma or attribute definition.
473 if Nkind
(Rep_Item
) = N_Aspect_Specification
then
474 Real_Rep
:= Aspect_Rep_Item
(Rep_Item
);
477 if Nkind
(Real_Rep
) = N_Attribute_Definition_Clause
then
478 case Chars
(Real_Rep
) is
480 exit when Nam
= TSS_Stream_Read
;
483 exit when Nam
= TSS_Stream_Write
;
486 exit when Nam
= TSS_Stream_Input
;
489 exit when Nam
= TSS_Stream_Output
;
496 Next_Rep_Item
(Rep_Item
);
499 -- If not found, and the type is derived from a private view, check
500 -- for a stream attribute inherited from parent. Any specified stream
501 -- attributes will be attached to the derived type's underlying type
502 -- rather the derived type entity itself (which is itself private).
505 and then Is_Private_Type
(Typ
)
506 and then Is_Derived_Type
(Typ
)
507 and then Present
(Full_View
(Typ
))
509 return Has_Stream_Attribute_Definition
510 (Underlying_Type
(Typ
), Nam
, Real_Rep
, At_Any_Place
);
512 -- Otherwise, if At_Any_Place is true, return True if the attribute is
513 -- available at any place; if it is false, return True only if the
514 -- attribute is currently visible.
517 return Present
(Rep_Item
)
518 and then (Ada_Version
< Ada_2005
520 or else not Is_Hidden
(Entity
(Rep_Item
)));
522 end Has_Stream_Attribute_Definition
;
524 ----------------------------
525 -- In_Package_Declaration --
526 ----------------------------
528 function In_Package_Declaration
return Boolean is
529 Unit_Kind
: constant Node_Kind
:=
530 Nkind
(Unit
(Cunit
(Current_Sem_Unit
)));
533 -- There are no restrictions on the body of an RCI or RT unit
535 return Is_Package_Or_Generic_Package
(Current_Scope
)
536 and then Unit_Kind
/= N_Package_Body
537 and then not In_Package_Body
(Current_Scope
)
538 and then not In_Instance
;
539 end In_Package_Declaration
;
541 ---------------------------
542 -- In_Preelaborated_Unit --
543 ---------------------------
545 function In_Preelaborated_Unit
return Boolean is
546 Unit_Entity
: Entity_Id
:= Current_Scope
;
547 Unit_Kind
: constant Node_Kind
:=
548 Nkind
(Unit
(Cunit
(Current_Sem_Unit
)));
551 -- If evaluating actuals for a child unit instantiation, then ignore
552 -- the preelaboration status of the parent; use the child instead.
554 if Is_Compilation_Unit
(Unit_Entity
)
555 and then Unit_Kind
in N_Generic_Instantiation
556 and then not In_Same_Source_Unit
(Unit_Entity
,
557 Cunit
(Current_Sem_Unit
))
559 Unit_Entity
:= Cunit_Entity
(Current_Sem_Unit
);
562 -- There are no constraints on the body of Remote_Call_Interface or
563 -- Remote_Types packages.
565 return (Unit_Entity
/= Standard_Standard
)
566 and then (Is_Preelaborated
(Unit_Entity
)
567 or else Is_Pure
(Unit_Entity
)
568 or else Is_Shared_Passive
(Unit_Entity
)
570 ((Is_Remote_Types
(Unit_Entity
)
571 or else Is_Remote_Call_Interface
(Unit_Entity
))
572 and then Ekind
(Unit_Entity
) = E_Package
573 and then Unit_Kind
/= N_Package_Body
574 and then not In_Package_Body
(Unit_Entity
)
575 and then not In_Instance
));
576 end In_Preelaborated_Unit
;
582 function In_Pure_Unit
return Boolean is
584 return Is_Pure
(Current_Scope
);
587 ------------------------
588 -- In_RCI_Declaration --
589 ------------------------
591 function In_RCI_Declaration
return Boolean is
593 return Is_Remote_Call_Interface
(Current_Scope
)
594 and then In_Package_Declaration
;
595 end In_RCI_Declaration
;
597 -----------------------
598 -- In_RT_Declaration --
599 -----------------------
601 function In_RT_Declaration
return Boolean is
603 return Is_Remote_Types
(Current_Scope
) and then In_Package_Declaration
;
604 end In_RT_Declaration
;
606 ----------------------------
607 -- In_Shared_Passive_Unit --
608 ----------------------------
610 function In_Shared_Passive_Unit
return Boolean is
611 Unit_Entity
: constant Entity_Id
:= Current_Scope
;
614 return Is_Shared_Passive
(Unit_Entity
);
615 end In_Shared_Passive_Unit
;
617 ---------------------------------------
618 -- In_Subprogram_Task_Protected_Unit --
619 ---------------------------------------
621 function In_Subprogram_Task_Protected_Unit
return Boolean is
625 -- The following is to verify that a declaration is inside
626 -- subprogram, generic subprogram, task unit, protected unit.
627 -- Used to validate if a lib. unit is Pure. RM 10.2.1(16).
629 -- Use scope chain to check successively outer scopes
633 if Is_Subprogram_Or_Generic_Subprogram
(E
)
635 Is_Concurrent_Type
(E
)
639 elsif E
= Standard_Standard
then
645 end In_Subprogram_Task_Protected_Unit
;
647 -------------------------------
648 -- Is_Non_Remote_Access_Type --
649 -------------------------------
651 function Is_Non_Remote_Access_Type
(E
: Entity_Id
) return Boolean is
652 U_E
: constant Entity_Id
:= Underlying_Type
(Base_Type
(E
));
653 -- Use full view of base type to handle subtypes properly.
658 -- This case arises for the case of a generic formal type, in which
659 -- case E.2.2(8) rules will be enforced at instantiation time.
664 return Is_Access_Type
(U_E
)
665 and then not Is_Remote_Access_To_Class_Wide_Type
(U_E
)
666 and then not Is_Remote_Access_To_Subprogram_Type
(U_E
);
667 end Is_Non_Remote_Access_Type
;
669 ---------------------------
670 -- No_External_Streaming --
671 ---------------------------
673 function No_External_Streaming
(E
: Entity_Id
) return Boolean is
674 U_E
: constant Entity_Id
:= Underlying_Type
(E
);
680 elsif Has_Read_Write_Attributes
(E
) then
682 -- Note: availability of stream attributes is tested on E, not U_E.
683 -- There may be stream attributes defined on U_E that are not visible
684 -- at the place where support of external streaming is tested.
688 elsif Has_Non_Remote_Access
(U_E
) then
692 return Is_Limited_Type
(E
);
693 end No_External_Streaming
;
695 -------------------------------------
696 -- Set_Categorization_From_Pragmas --
697 -------------------------------------
699 procedure Set_Categorization_From_Pragmas
(N
: Node_Id
) is
700 P
: constant Node_Id
:= Parent
(N
);
702 procedure Make_Parents_Visible_And_Process_Pragmas
(Par
: Entity_Id
);
703 -- Parents might not be immediately visible during analysis. Make
704 -- them momentarily visible so that the argument of the pragma can
705 -- be resolved properly, process pragmas and restore the previous
708 procedure Process_Categorization_Pragmas
;
709 -- Process categorization pragmas, if any
711 ------------------------------------
712 -- Process_Categorization_Pragmas --
713 ------------------------------------
715 procedure Process_Categorization_Pragmas
is
719 PN
:= First
(Pragmas_After
(Aux_Decls_Node
(P
)));
720 while Present
(PN
) loop
722 -- Skip implicit types that may have been introduced by
723 -- previous analysis.
725 if Nkind
(PN
) = N_Pragma
then
726 case Get_Pragma_Id
(PN
) is
727 when Pragma_All_Calls_Remote
728 | Pragma_Preelaborate
730 | Pragma_Remote_Call_Interface
731 | Pragma_Remote_Types
732 | Pragma_Shared_Passive
743 end Process_Categorization_Pragmas
;
745 ----------------------------------------------
746 -- Make_Parents_Visible_And_Process_Pragmas --
747 ----------------------------------------------
749 procedure Make_Parents_Visible_And_Process_Pragmas
(Par
: Entity_Id
) is
751 -- When we reached the Standard scope, then just process pragmas
753 if Par
= Standard_Standard
then
754 Process_Categorization_Pragmas
;
756 -- Otherwise make the current scope momentarily visible, recurse
757 -- into its enclosing scope, and restore the visibility. This is
758 -- required for child units that are instances of generic parents.
762 Save_Is_Immediately_Visible
: constant Boolean :=
763 Is_Immediately_Visible
(Par
);
765 Set_Is_Immediately_Visible
(Par
);
766 Make_Parents_Visible_And_Process_Pragmas
(Scope
(Par
));
767 Set_Is_Immediately_Visible
(Par
, Save_Is_Immediately_Visible
);
770 end Make_Parents_Visible_And_Process_Pragmas
;
772 -- Start of processing for Set_Categorization_From_Pragmas
775 -- Deal with categorization pragmas in Pragmas of Compilation_Unit.
776 -- The purpose is to set categorization flags before analyzing the
777 -- unit itself, so as to diagnose violations of categorization as
778 -- we process each declaration, even though the pragma appears after
781 if Nkind
(P
) /= N_Compilation_Unit
then
785 Make_Parents_Visible_And_Process_Pragmas
(Scope
(Current_Scope
));
786 end Set_Categorization_From_Pragmas
;
788 -----------------------------------
789 -- Set_Categorization_From_Scope --
790 -----------------------------------
792 procedure Set_Categorization_From_Scope
(E
: Entity_Id
; Scop
: Entity_Id
) is
793 Declaration
: Node_Id
:= Empty
;
794 Specification
: Node_Id
:= Empty
;
797 -- Do not modify the purity of an internally generated entity if it has
798 -- been explicitly marked as pure for optimization purposes.
800 if not Has_Pragma_Pure_Function
(E
) then
802 (E
, Is_Pure
(Scop
) and then Is_Library_Level_Entity
(E
));
805 if not Is_Remote_Call_Interface
(E
) then
806 if Is_Subprogram
(E
) then
807 Declaration
:= Unit_Declaration_Node
(E
);
809 if Nkind
(Declaration
) in
810 N_Subprogram_Body | N_Subprogram_Renaming_Declaration
812 Specification
:= Corresponding_Spec
(Declaration
);
816 -- A subprogram body or renaming-as-body is a remote call interface
817 -- if it serves as the completion of a subprogram declaration that
818 -- is a remote call interface.
820 if Nkind
(Specification
) in N_Entity
then
821 Set_Is_Remote_Call_Interface
822 (E
, Is_Remote_Call_Interface
(Specification
));
824 -- A subprogram declaration is a remote call interface when it is
825 -- declared within the visible part of, or declared by, a library
826 -- unit declaration that is a remote call interface.
829 Set_Is_Remote_Call_Interface
830 (E
, Is_Remote_Call_Interface
(Scop
)
831 and then not (In_Private_Part
(Scop
)
832 or else In_Package_Body
(Scop
)));
837 (E
, Is_Remote_Types
(Scop
)
838 and then not (In_Private_Part
(Scop
)
839 or else In_Package_Body
(Scop
)));
840 end Set_Categorization_From_Scope
;
842 ------------------------------
843 -- Static_Discriminant_Expr --
844 ------------------------------
846 -- We need to accommodate a Why_Not_Static call somehow here ???
848 function Static_Discriminant_Expr
(L
: List_Id
) return Boolean is
849 Discriminant_Spec
: Node_Id
;
852 Discriminant_Spec
:= First
(L
);
853 while Present
(Discriminant_Spec
) loop
854 if Present
(Expression
(Discriminant_Spec
))
856 not Is_OK_Static_Expression
(Expression
(Discriminant_Spec
))
861 Next
(Discriminant_Spec
);
865 end Static_Discriminant_Expr
;
867 --------------------------------------
868 -- Validate_Access_Type_Declaration --
869 --------------------------------------
871 procedure Validate_Access_Type_Declaration
(T
: Entity_Id
; N
: Node_Id
) is
872 Def
: constant Node_Id
:= Type_Definition
(N
);
877 -- Access to subprogram case
879 when N_Access_To_Subprogram_Definition
=>
881 -- A pure library_item must not contain the declaration of a
882 -- named access type, except within a subprogram, generic
883 -- subprogram, task unit, or protected unit (RM 10.2.1(16)).
885 -- This test is skipped in Ada 2005 (see AI-366)
887 if Ada_Version
< Ada_2005
888 and then Comes_From_Source
(T
)
889 and then In_Pure_Unit
890 and then not In_Subprogram_Task_Protected_Unit
892 Error_Msg_N
("named access type not allowed in pure unit", T
);
895 -- Access to object case
897 when N_Access_To_Object_Definition
=>
898 if Comes_From_Source
(T
)
899 and then In_Pure_Unit
900 and then not In_Subprogram_Task_Protected_Unit
902 -- We can't give the message yet, since the type is not frozen
903 -- and in Ada 2005 mode, access types are allowed in pure units
904 -- if the type has no storage pool (see AI-366). So we set a
905 -- flag which will be checked at freeze time.
907 Set_Is_Pure_Unit_Access_Type
(T
);
910 -- Check for RCI or RT unit type declaration: declaration of an
911 -- access-to-object type is illegal unless it is a general access
912 -- type that designates a class-wide limited private type.
913 -- Note that constraints on the primitive subprograms of the
914 -- designated tagged type are not enforced here but in
915 -- Validate_RACW_Primitives, which is done separately because the
916 -- designated type might not be frozen (and therefore its
917 -- primitive operations might not be completely known) at the
918 -- point of the RACW declaration.
920 Validate_Remote_Access_Object_Type_Declaration
(T
);
922 -- Check for shared passive unit type declaration. It should
923 -- not contain the declaration of access to class wide type,
924 -- access to task type and access to protected type with entry.
926 Validate_SP_Access_Object_Type_Decl
(T
);
932 -- Set categorization flag from package on entity as well, to allow
933 -- easy checks later on for required validations of RCI or RT units.
934 -- This is only done for entities that are in the original source.
936 if Comes_From_Source
(T
)
937 and then not (In_Package_Body
(Scope
(T
))
938 or else In_Private_Part
(Scope
(T
)))
940 Set_Is_Remote_Call_Interface
941 (T
, Is_Remote_Call_Interface
(Scope
(T
)));
943 (T
, Is_Remote_Types
(Scope
(T
)));
945 end Validate_Access_Type_Declaration
;
947 ----------------------------
948 -- Validate_Ancestor_Part --
949 ----------------------------
951 procedure Validate_Ancestor_Part
(N
: Node_Id
) is
952 A
: constant Node_Id
:= Ancestor_Part
(N
);
953 T
: constant Entity_Id
:= Entity
(A
);
956 if In_Preelaborated_Unit
957 and then not In_Subprogram_Or_Concurrent_Unit
958 and then (not Inside_A_Generic
959 or else Present
(Enclosing_Generic_Body
(N
)))
961 -- If the type is private, it must have the Ada 2005 pragma
962 -- Has_Preelaborable_Initialization.
964 -- The check is omitted within predefined units. This is probably
965 -- obsolete code to fix the Ada 95 weakness in this area ???
967 if Is_Private_Type
(T
)
968 and then not Has_Pragma_Preelab_Init
(T
)
969 and then not In_Internal_Unit
(N
)
972 ("private ancestor type not allowed in preelaborated unit", A
);
974 elsif Is_Record_Type
(T
) then
975 if Nkind
(Parent
(T
)) = N_Full_Type_Declaration
then
976 Check_Non_Static_Default_Expr
977 (Type_Definition
(Parent
(T
)), A
);
981 end Validate_Ancestor_Part
;
983 ----------------------------------------
984 -- Validate_Categorization_Dependency --
985 ----------------------------------------
987 procedure Validate_Categorization_Dependency
991 K
: constant Node_Kind
:= Nkind
(N
);
992 P
: Node_Id
:= Parent
(N
);
994 Is_Subunit
: constant Boolean := Nkind
(P
) = N_Subunit
;
997 -- Only validate library units and subunits. For subunits, checks
998 -- concerning withed units apply to the parent compilation unit.
1005 and then not Is_Compilation_Unit
(U
)
1006 and then not Is_Child_Unit
(U
)
1012 if Nkind
(P
) /= N_Compilation_Unit
then
1016 -- Body of RCI unit does not need validation
1018 if Is_Remote_Call_Interface
(E
)
1019 and then Nkind
(N
) in N_Package_Body | N_Subprogram_Body
1024 -- Ada 2005 (AI-50217): Process explicit non-limited with_clauses
1028 Entity_Of_Withed
: Entity_Id
;
1031 Item
:= First
(Context_Items
(P
));
1032 while Present
(Item
) loop
1033 if Nkind
(Item
) = N_With_Clause
1035 not (Implicit_With
(Item
)
1036 or else Limited_Present
(Item
)
1038 -- Skip if error already posted on the WITH clause (in
1039 -- which case the Name attribute may be invalid). In
1040 -- particular, this fixes the problem of hanging in the
1041 -- presence of a WITH clause on a child that is an
1042 -- illegal generic instantiation.
1044 or else Error_Posted
(Item
))
1048 -- Skip processing malformed trees
1050 and then Nkind
(Name
(Item
)) not in N_Has_Entity
)
1052 Entity_Of_Withed
:= Entity
(Name
(Item
));
1053 Check_Categorization_Dependencies
1054 (U
, Entity_Of_Withed
, Item
, Is_Subunit
);
1061 -- Child depends on parent; therefore parent should also be categorized
1062 -- and satisfy the dependency hierarchy.
1064 -- Check if N is a child spec
1066 if (K
in N_Generic_Declaration
or else
1067 K
in N_Generic_Instantiation
or else
1068 K
in N_Generic_Renaming_Declaration
or else
1069 K
= N_Package_Declaration
or else
1070 K
= N_Package_Renaming_Declaration
or else
1071 K
= N_Subprogram_Declaration
or else
1072 K
= N_Subprogram_Renaming_Declaration
)
1073 and then Present
(Parent_Spec
(N
))
1075 Check_Categorization_Dependencies
(E
, Scope
(E
), N
, False);
1077 -- Verify that public child of an RCI library unit must also be an
1078 -- RCI library unit (RM E.2.3(15)).
1080 if Is_Remote_Call_Interface
(Scope
(E
))
1081 and then not Private_Present
(P
)
1082 and then not Is_Remote_Call_Interface
(E
)
1085 ("public child of 'R'C'I unit must also be 'R'C'I unit", N
);
1088 end Validate_Categorization_Dependency
;
1090 --------------------------------
1091 -- Validate_Controlled_Object --
1092 --------------------------------
1094 procedure Validate_Controlled_Object
(E
: Entity_Id
) is
1096 -- Don't need this check in Ada 2005 mode, where this is all taken
1097 -- care of by the mechanism for Preelaborable Initialization.
1099 if Ada_Version
>= Ada_2005
then
1103 -- For now, never apply this check for internal GNAT units, since we
1104 -- have a number of cases in the library where we are stuck with objects
1105 -- of this type, and the RM requires Preelaborate.
1107 -- For similar reasons, we only do this check for source entities, since
1108 -- we generate entities of this type in some situations.
1110 -- Note that the 10.2.1(9) restrictions are not relevant to us anyway.
1111 -- We have to enforce them for RM compatibility, but we have no trouble
1112 -- accepting these objects and doing the right thing. Note that there is
1113 -- no requirement that Preelaborate not actually generate any code.
1115 if In_Preelaborated_Unit
1116 and then not Debug_Flag_PP
1117 and then Comes_From_Source
(E
)
1118 and then not In_Internal_Unit
(E
)
1119 and then (not Inside_A_Generic
1120 or else Present
(Enclosing_Generic_Body
(E
)))
1121 and then not Is_Protected_Type
(Etype
(E
))
1124 ("library level controlled object not allowed in " &
1125 "preelaborated unit", E
);
1127 end Validate_Controlled_Object
;
1129 --------------------------------------
1130 -- Validate_Null_Statement_Sequence --
1131 --------------------------------------
1133 procedure Validate_Null_Statement_Sequence
(N
: Node_Id
) is
1137 if In_Preelaborated_Unit
then
1138 Item
:= First
(Statements
(Handled_Statement_Sequence
(N
)));
1139 while Present
(Item
) loop
1140 if Nkind
(Item
) /= N_Label
1141 and then Nkind
(Item
) /= N_Null_Statement
1143 -- In GNAT mode, this is a warning, allowing the run-time
1144 -- to judiciously bypass this error condition.
1146 Error_Msg_Warn
:= GNAT_Mode
;
1148 ("<<statements not allowed in preelaborated unit", Item
);
1156 end Validate_Null_Statement_Sequence
;
1158 ---------------------------------
1159 -- Validate_Object_Declaration --
1160 ---------------------------------
1162 procedure Validate_Object_Declaration
(N
: Node_Id
) is
1163 Id
: constant Entity_Id
:= Defining_Identifier
(N
);
1164 E
: constant Node_Id
:= Expression
(N
);
1165 Odf
: constant Node_Id
:= Object_Definition
(N
);
1166 T
: constant Entity_Id
:= Etype
(Id
);
1169 -- Verify that any access to subprogram object does not have in its
1170 -- subprogram profile access type parameters or limited parameters
1171 -- without Read and Write attributes (E.2.3(13)).
1173 Validate_RCI_Subprogram_Declaration
(N
);
1175 -- Check that if we are in preelaborated elaboration code, then we
1176 -- do not have an instance of a default initialized private, task or
1177 -- protected object declaration which would violate (RM 10.2.1(9)).
1178 -- Note that constants are never default initialized (and the test
1179 -- below also filters out deferred constants). A variable is default
1180 -- initialized if it does *not* have an initialization expression.
1182 -- Filter out cases that are not declaration of a variable from source
1184 if Nkind
(N
) /= N_Object_Declaration
1185 or else Constant_Present
(N
)
1186 or else not Comes_From_Source
(Id
)
1191 -- Exclude generic specs from the checks (this will get rechecked
1192 -- on instantiations).
1194 if Inside_A_Generic
and then No
(Enclosing_Generic_Body
(Id
)) then
1198 -- Required checks for declaration that is in a preelaborated package
1199 -- and is not within some subprogram.
1201 if In_Preelaborated_Unit
1202 and then not In_Subprogram_Or_Concurrent_Unit
1204 -- Check for default initialized variable case. Note that in
1205 -- accordance with (RM B.1(24)) imported objects are not subject to
1206 -- default initialization.
1207 -- If the initialization does not come from source and is an
1208 -- aggregate, it is a static initialization that replaces an
1209 -- implicit call, and must be treated as such.
1212 and then (Comes_From_Source
(E
) or else Nkind
(E
) /= N_Aggregate
)
1216 elsif Is_Imported
(Id
) then
1221 Ent
: Entity_Id
:= T
;
1224 -- An array whose component type is a record with nonstatic
1225 -- default expressions is a violation, so we get the array's
1228 if Is_Array_Type
(Ent
) then
1230 Comp_Type
: Entity_Id
;
1233 Comp_Type
:= Component_Type
(Ent
);
1234 while Is_Array_Type
(Comp_Type
) loop
1235 Comp_Type
:= Component_Type
(Comp_Type
);
1242 -- Object decl. that is of record type and has no default expr.
1243 -- should check if there is any non-static default expression
1244 -- in component decl. of the record type decl.
1246 if Is_Record_Type
(Ent
) then
1247 if Nkind
(Parent
(Ent
)) = N_Full_Type_Declaration
then
1248 Check_Non_Static_Default_Expr
1249 (Type_Definition
(Parent
(Ent
)), N
);
1251 elsif Nkind
(Odf
) = N_Subtype_Indication
1252 and then not Is_Array_Type
(T
)
1253 and then not Is_Private_Type
(T
)
1255 Check_Non_Static_Default_Expr
(Type_Definition
1256 (Parent
(Entity
(Subtype_Mark
(Odf
)))), N
);
1260 -- Check for invalid use of private object. Note that Ada 2005
1261 -- AI-161 modifies the rules for Ada 2005, including the use of
1262 -- the new pragma Preelaborable_Initialization.
1264 if Is_Private_Type
(Ent
)
1265 or else Depends_On_Private
(Ent
)
1267 -- Case where type has preelaborable initialization which
1268 -- means that a pragma Preelaborable_Initialization was
1269 -- given for the private type.
1271 if Relaxed_RM_Semantics
then
1273 -- In relaxed mode, do not issue these messages, this
1274 -- is basically similar to the GNAT_Mode test below.
1278 elsif Has_Preelaborable_Initialization
(Ent
) then
1280 -- But for the predefined units, we will ignore this
1281 -- status unless we are in Ada 2005 mode since we want
1282 -- Ada 95 compatible behavior, in which the entities
1283 -- marked with this pragma in the predefined library are
1284 -- not treated specially.
1286 if Ada_Version
< Ada_2005
then
1288 ("private object not allowed in preelaborated unit",
1290 Error_Msg_N
("\(would be legal in Ada 2005 mode)", N
);
1293 -- Type does not have preelaborable initialization
1296 -- We allow this when compiling in GNAT mode to make life
1297 -- easier for some cases where it would otherwise be hard
1298 -- to be exactly valid Ada.
1300 if not GNAT_Mode
then
1302 ("private object not allowed in preelaborated unit",
1305 -- Add a message if it would help to provide a pragma
1306 -- Preelaborable_Initialization on the type of the
1307 -- object (which would make it legal in Ada 2005).
1309 -- If the type has no full view (generic type, or
1310 -- previous error), the warning does not apply.
1312 if Is_Private_Type
(Ent
)
1313 and then Present
(Full_View
(Ent
))
1315 Has_Preelaborable_Initialization
(Full_View
(Ent
))
1317 Error_Msg_Sloc
:= Sloc
(Ent
);
1319 if Ada_Version
>= Ada_2005
then
1321 ("\would be legal if pragma Preelaborable_" &
1322 "Initialization given for & #", N
, Ent
);
1325 ("\would be legal in Ada 2005 if pragma " &
1326 "Preelaborable_Initialization given for & #",
1333 -- Access to Task or Protected type
1335 elsif Is_Entity_Name
(Odf
)
1336 and then Present
(Etype
(Odf
))
1337 and then Is_Access_Type
(Etype
(Odf
))
1339 Ent
:= Designated_Type
(Etype
(Odf
));
1341 elsif Is_Entity_Name
(Odf
) then
1342 Ent
:= Entity
(Odf
);
1344 elsif Nkind
(Odf
) = N_Subtype_Indication
then
1345 Ent
:= Etype
(Subtype_Mark
(Odf
));
1347 elsif Nkind
(Odf
) = N_Constrained_Array_Definition
then
1348 Ent
:= Component_Type
(T
);
1351 if Is_Task_Type
(Ent
)
1352 or else (Is_Protected_Type
(Ent
) and then Has_Entries
(Ent
))
1355 ("concurrent object not allowed in preelaborated unit",
1362 -- Non-static discriminants not allowed in preelaborated unit.
1363 -- Objects of a controlled type with a user-defined Initialize
1364 -- are forbidden as well.
1366 if Is_Record_Type
(Etype
(Id
)) then
1368 ET
: constant Entity_Id
:= Etype
(Id
);
1369 EE
: constant Entity_Id
:= Etype
(Etype
(Id
));
1373 if Has_Discriminants
(ET
) and then Present
(EE
) then
1376 if Nkind
(PEE
) = N_Full_Type_Declaration
1377 and then not Static_Discriminant_Expr
1378 (Discriminant_Specifications
(PEE
))
1381 ("non-static discriminant in preelaborated unit",
1386 -- For controlled type or type with controlled component, check
1387 -- preelaboration flag, as there may be a non-null Initialize
1388 -- primitive. For language versions earlier than Ada 2005,
1389 -- there is no notion of preelaborable initialization, and
1390 -- Validate_Controlled_Object is used to enforce rules for
1391 -- controlled objects.
1393 if (Is_Controlled
(ET
) or else Has_Controlled_Component
(ET
))
1394 and then Ada_Version
>= Ada_2005
1395 and then not Has_Preelaborable_Initialization
(ET
)
1398 ("controlled type& does not have"
1399 & " preelaborable initialization", N
, ET
);
1406 -- A pure library_item must not contain the declaration of any variable
1407 -- except within a subprogram, generic subprogram, task unit, or
1408 -- protected unit (RM 10.2.1(16)).
1410 if In_Pure_Unit
and then not In_Subprogram_Task_Protected_Unit
then
1411 Error_Msg_N
("declaration of variable not allowed in pure unit", N
);
1413 elsif not In_Private_Part
(Id
) then
1415 -- The visible part of an RCI library unit must not contain the
1416 -- declaration of a variable (RM E.1.3(9)).
1418 if In_RCI_Declaration
then
1419 Error_Msg_N
("visible variable not allowed in 'R'C'I unit", N
);
1421 -- The visible part of a Shared Passive library unit must not contain
1422 -- the declaration of a variable (RM E.2.2(7)).
1424 elsif In_RT_Declaration
then
1426 ("visible variable not allowed in remote types unit", N
);
1429 end Validate_Object_Declaration
;
1431 -----------------------------
1432 -- Validate_RACW_Primitive --
1433 -----------------------------
1435 procedure Validate_RACW_Primitive
1439 procedure Illegal_Remote_Subp
(Msg
: String; N
: Node_Id
);
1440 -- Diagnose illegality on N. If RACW is present, report the error on it
1441 -- rather than on N.
1443 -------------------------
1444 -- Illegal_Remote_Subp --
1445 -------------------------
1447 procedure Illegal_Remote_Subp
(Msg
: String; N
: Node_Id
) is
1449 if Present
(RACW
) then
1450 if not Error_Posted
(RACW
) then
1452 ("illegal remote access to class-wide type&", RACW
);
1455 Error_Msg_Sloc
:= Sloc
(N
);
1456 Error_Msg_NE
("\\" & Msg
& " in primitive& #", RACW
, Subp
);
1459 Error_Msg_NE
(Msg
& " in remote subprogram&", N
, Subp
);
1461 end Illegal_Remote_Subp
;
1465 Param_Spec
: Node_Id
;
1466 Param_Type
: Entity_Id
;
1468 -- Start of processing for Validate_RACW_Primitive
1471 -- Check return type
1473 if Ekind
(Subp
) = E_Function
then
1474 Rtyp
:= Etype
(Subp
);
1476 -- AI05-0101 (Binding Interpretation): The result type of a remote
1477 -- function must either support external streaming or be a
1478 -- controlling access result type.
1480 if Has_Controlling_Result
(Subp
) then
1483 elsif Ekind
(Rtyp
) = E_Anonymous_Access_Type
then
1484 Illegal_Remote_Subp
("anonymous access result", Rtyp
);
1486 elsif Is_Limited_Type
(Rtyp
) then
1487 if No
(TSS
(Rtyp
, TSS_Stream_Read
))
1489 No
(TSS
(Rtyp
, TSS_Stream_Write
))
1492 ("limited return type must have Read and Write attributes",
1494 Explain_Limited_Type
(Rtyp
, Parent
(Subp
));
1497 -- Check that the return type supports external streaming
1499 elsif No_External_Streaming
(Rtyp
)
1500 and then not Error_Posted
(Rtyp
)
1502 Illegal_Remote_Subp
("return type containing non-remote access "
1503 & "must have Read and Write attributes",
1508 Param
:= First_Formal
(Subp
);
1509 while Present
(Param
) loop
1511 -- Now find out if this parameter is a controlling parameter
1513 Param_Spec
:= Parent
(Param
);
1514 Param_Type
:= Etype
(Param
);
1516 if Is_Controlling_Formal
(Param
) then
1518 -- It is a controlling parameter, so specific checks below do not
1523 elsif Ekind
(Param_Type
) in E_Anonymous_Access_Type
1524 | E_Anonymous_Access_Subprogram_Type
1526 -- From RM E.2.2(14), no anonymous access parameter other than
1527 -- controlling ones may be used (because an anonymous access
1528 -- type never supports external streaming).
1531 ("non-controlling access parameter", Param_Spec
);
1533 elsif No_External_Streaming
(Param_Type
)
1534 and then not Error_Posted
(Param_Type
)
1536 Illegal_Remote_Subp
("formal parameter in remote subprogram must "
1537 & "support external streaming", Param_Spec
);
1540 -- Check next parameter in this subprogram
1542 Next_Formal
(Param
);
1544 end Validate_RACW_Primitive
;
1546 ------------------------------
1547 -- Validate_RACW_Primitives --
1548 ------------------------------
1550 procedure Validate_RACW_Primitives
(T
: Entity_Id
) is
1551 Desig_Type
: Entity_Id
;
1552 Primitive_Subprograms
: Elist_Id
;
1553 Subprogram_Elmt
: Elmt_Id
;
1554 Subprogram
: Entity_Id
;
1557 Desig_Type
:= Etype
(Designated_Type
(T
));
1559 -- No action needed for concurrent types
1561 if Is_Concurrent_Type
(Desig_Type
) then
1565 Primitive_Subprograms
:= Primitive_Operations
(Desig_Type
);
1567 Subprogram_Elmt
:= First_Elmt
(Primitive_Subprograms
);
1568 while Subprogram_Elmt
/= No_Elmt
loop
1569 Subprogram
:= Node
(Subprogram_Elmt
);
1571 if Is_Predefined_Dispatching_Operation
(Subprogram
)
1572 or else Is_Hidden
(Subprogram
)
1574 goto Next_Subprogram
;
1577 Validate_RACW_Primitive
(Subp
=> Subprogram
, RACW
=> T
);
1580 Next_Elmt
(Subprogram_Elmt
);
1582 end Validate_RACW_Primitives
;
1584 -------------------------------
1585 -- Validate_RCI_Declarations --
1586 -------------------------------
1588 procedure Validate_RCI_Declarations
(P
: Entity_Id
) is
1592 E
:= First_Entity
(P
);
1593 while Present
(E
) loop
1594 if Comes_From_Source
(E
) then
1595 if Is_Limited_Type
(E
) then
1597 ("limited type not allowed in 'R'C'I unit", Parent
(E
));
1598 Explain_Limited_Type
(E
, Parent
(E
));
1600 elsif Ekind
(E
) in E_Generic_Function
1602 | E_Generic_Procedure
1604 Error_Msg_N
("generic declaration not allowed in 'R'C'I unit",
1607 elsif (Ekind
(E
) = E_Function
or else Ekind
(E
) = E_Procedure
)
1608 and then Has_Pragma_Inline
(E
)
1611 ("inlined subprogram not allowed in 'R'C'I unit", Parent
(E
));
1613 -- Inner packages that are renamings need not be checked. Generic
1614 -- RCI packages are subject to the checks, but entities that come
1615 -- from formal packages are not part of the visible declarations
1616 -- of the package and are not checked.
1618 elsif Ekind
(E
) = E_Package
then
1619 if Present
(Renamed_Entity
(E
)) then
1622 elsif Ekind
(P
) /= E_Generic_Package
1623 or else List_Containing
(Unit_Declaration_Node
(E
)) /=
1624 Generic_Formal_Declarations
1625 (Unit_Declaration_Node
(P
))
1627 Validate_RCI_Declarations
(E
);
1634 end Validate_RCI_Declarations
;
1636 -----------------------------------------
1637 -- Validate_RCI_Subprogram_Declaration --
1638 -----------------------------------------
1640 procedure Validate_RCI_Subprogram_Declaration
(N
: Node_Id
) is
1641 K
: constant Node_Kind
:= Nkind
(N
);
1643 Id
: constant Entity_Id
:= Defining_Entity
(N
);
1644 Param_Spec
: Node_Id
;
1645 Param_Type
: Entity_Id
;
1646 Error_Node
: Node_Id
:= N
;
1649 -- This procedure enforces rules on subprogram and access to subprogram
1650 -- declarations in RCI units. These rules do not apply to expander
1651 -- generated routines, which are not remote subprograms. It is called:
1653 -- 1. from Analyze_Subprogram_Declaration.
1654 -- 2. from Validate_Object_Declaration (access to subprogram).
1656 if not (Comes_From_Source
(N
)
1657 and then In_RCI_Declaration
1658 and then not In_Private_Part
(Scope
(Id
)))
1663 if K
= N_Subprogram_Declaration
then
1664 Profile
:= Parameter_Specifications
(Specification
(N
));
1667 pragma Assert
(K
= N_Object_Declaration
);
1669 -- The above assertion is dubious, the visible declarations of an
1670 -- RCI unit never contain an object declaration, this should be an
1671 -- ACCESS-to-object declaration???
1673 if Nkind
(Id
) = N_Defining_Identifier
1674 and then Nkind
(Parent
(Etype
(Id
))) = N_Full_Type_Declaration
1675 and then Ekind
(Etype
(Id
)) = E_Access_Subprogram_Type
1678 Parameter_Specifications
(Type_Definition
(Parent
(Etype
(Id
))));
1684 -- Iterate through the parameter specification list, checking that
1685 -- no access parameter and no limited type parameter in the list.
1688 if Present
(Profile
) then
1689 Param_Spec
:= First
(Profile
);
1690 while Present
(Param_Spec
) loop
1691 Param_Type
:= Etype
(Defining_Identifier
(Param_Spec
));
1693 if Ekind
(Param_Type
) = E_Anonymous_Access_Type
then
1694 if K
= N_Subprogram_Declaration
then
1695 Error_Node
:= Param_Spec
;
1698 -- Report error only if declaration is in source program
1700 if Comes_From_Source
(Id
) then
1702 ("subprogram in 'R'C'I unit cannot have access parameter",
1706 -- For a limited private type parameter, we check only the private
1707 -- declaration and ignore full type declaration, unless this is
1708 -- the only declaration for the type, e.g., as a limited record.
1710 elsif No_External_Streaming
(Param_Type
) then
1711 if K
= N_Subprogram_Declaration
then
1712 Error_Node
:= Param_Spec
;
1716 ("formal of remote subprogram& "
1717 & "must support external streaming",
1719 if Is_Limited_Type
(Param_Type
) then
1720 Explain_Limited_Type
(Param_Type
, Error_Node
);
1728 if Ekind
(Id
) = E_Function
1729 and then Ekind
(Etype
(Id
)) = E_Anonymous_Access_Type
1730 and then Comes_From_Source
(Id
)
1733 ("function in 'R'C'I unit cannot have access result",
1736 end Validate_RCI_Subprogram_Declaration
;
1738 ----------------------------------------------------
1739 -- Validate_Remote_Access_Object_Type_Declaration --
1740 ----------------------------------------------------
1742 procedure Validate_Remote_Access_Object_Type_Declaration
(T
: Entity_Id
) is
1743 Direct_Designated_Type
: Entity_Id
;
1744 Desig_Type
: Entity_Id
;
1747 -- We are called from Analyze_Full_Type_Declaration, and the Nkind of
1748 -- the given node is N_Access_To_Object_Definition.
1750 if not Comes_From_Source
(T
)
1751 or else (not In_RCI_Declaration
and then not In_RT_Declaration
)
1756 -- An access definition in the private part of a package is not a
1757 -- remote access type. Restrictions related to external streaming
1758 -- support for non-remote access types are enforced elsewhere. Note
1759 -- that In_Private_Part is never set on type entities: check flag
1760 -- on enclosing scope.
1762 if In_Private_Part
(Scope
(T
)) then
1766 -- Check RCI or RT unit type declaration. It may not contain the
1767 -- declaration of an access-to-object type unless it is a general access
1768 -- type that designates a class-wide limited private type or subtype.
1769 -- There are also constraints on the primitive subprograms of the
1770 -- class-wide type (RM E.2.2(14), see Validate_RACW_Primitives).
1772 if Ekind
(T
) /= E_General_Access_Type
1773 or else not Is_Class_Wide_Type
(Designated_Type
(T
))
1775 if In_RCI_Declaration
then
1777 ("error in access type in Remote_Call_Interface unit", T
);
1780 ("error in access type in Remote_Types unit", T
);
1783 Error_Msg_N
("\must be general access to class-wide type", T
);
1787 Direct_Designated_Type
:= Designated_Type
(T
);
1788 Desig_Type
:= Etype
(Direct_Designated_Type
);
1790 -- Why is this check not in Validate_Remote_Access_To_Class_Wide_Type???
1792 if not Is_Valid_Remote_Object_Type
(Desig_Type
) then
1794 ("error in designated type of remote access to class-wide type", T
);
1796 ("\must be tagged limited private or private extension", T
);
1799 end Validate_Remote_Access_Object_Type_Declaration
;
1801 -----------------------------------------------
1802 -- Validate_Remote_Access_To_Class_Wide_Type --
1803 -----------------------------------------------
1805 procedure Validate_Remote_Access_To_Class_Wide_Type
(N
: Node_Id
) is
1806 K
: constant Node_Kind
:= Nkind
(N
);
1807 PK
: constant Node_Kind
:= Nkind
(Parent
(N
));
1811 -- This subprogram enforces the checks in (RM E.2.2(8)) for certain uses
1812 -- of class-wide limited private types.
1814 -- Storage_Pool and Storage_Size are not defined for such types
1816 -- The expected type of allocator must not be such a type.
1818 -- The actual parameter of generic instantiation must not be such a
1819 -- type if the formal parameter is of an access type.
1821 -- On entry, there are several cases:
1823 -- 1. called from sem_attr Analyze_Attribute where attribute name is
1824 -- either Storage_Pool or Storage_Size.
1826 -- 2. called from exp_ch4 Expand_N_Allocator
1828 -- 3. called from sem_ch4 Analyze_Explicit_Dereference
1830 -- 4. called from sem_res Resolve_Actuals
1832 if K
= N_Attribute_Definition_Clause
then
1833 E
:= Etype
(Entity
(N
));
1835 if Is_Remote_Access_To_Class_Wide_Type
(E
) then
1836 Error_Msg_Name_1
:= Chars
(N
);
1838 ("cannot specify% aspect for a remote operand", N
);
1842 elsif K
= N_Attribute_Reference
then
1843 E
:= Etype
(Prefix
(N
));
1845 if Is_Remote_Access_To_Class_Wide_Type
(E
) then
1846 Error_Msg_N
("incorrect attribute of remote operand", N
);
1850 elsif K
= N_Allocator
then
1853 if Is_Remote_Access_To_Class_Wide_Type
(E
) then
1854 Error_Msg_N
("incorrect expected remote type of allocator", N
);
1858 -- This subprogram also enforces the checks in E.2.2(13). A value of
1859 -- such type must not be dereferenced unless as controlling operand of
1860 -- a dispatching call. Explicit dereferences not coming from source are
1861 -- exempted from this checking because the expander produces them in
1862 -- some cases (such as for tag checks on dispatching calls with multiple
1863 -- controlling operands). However we do check in the case of an implicit
1864 -- dereference that is expanded to an explicit dereference (hence the
1865 -- test of whether Original_Node (N) comes from source).
1867 elsif K
= N_Explicit_Dereference
1868 and then Comes_From_Source
(Original_Node
(N
))
1870 E
:= Etype
(Prefix
(N
));
1872 -- If the class-wide type is not a remote one, the restrictions
1875 if not Is_Remote_Access_To_Class_Wide_Type
(E
) then
1879 -- If we have a true dereference that comes from source and that
1880 -- is a controlling argument for a dispatching call, accept it.
1882 if Is_Actual_Parameter
(N
) and then Is_Controlling_Actual
(N
) then
1886 -- If we are just within a procedure or function call and the
1887 -- dereference has not been analyzed, return because this procedure
1888 -- will be called again from sem_res Resolve_Actuals. The same can
1889 -- apply in the case of dereference that is the prefix of a selected
1890 -- component, which can be a call given in prefixed form.
1892 if (Is_Actual_Parameter
(N
) or else PK
= N_Selected_Component
)
1893 and then not Analyzed
(N
)
1898 -- We must allow expanded code to generate a reference to the tag of
1899 -- the designated object (may be either the actual tag, or the stub
1900 -- tag in the case of a remote object).
1902 if PK
= N_Selected_Component
1903 and then Is_Tag
(Entity
(Selector_Name
(Parent
(N
))))
1909 ("invalid dereference of a remote access-to-class-wide value", N
);
1911 end Validate_Remote_Access_To_Class_Wide_Type
;
1913 ------------------------------------------
1914 -- Validate_Remote_Type_Type_Conversion --
1915 ------------------------------------------
1917 procedure Validate_Remote_Type_Type_Conversion
(N
: Node_Id
) is
1918 S
: constant Entity_Id
:= Etype
(N
);
1919 E
: constant Entity_Id
:= Etype
(Expression
(N
));
1922 -- This test is required in the case where a conversion appears inside a
1923 -- normal package, it does not necessarily have to be inside an RCI,
1924 -- Remote_Types unit (RM E.2.2(9,12)).
1926 if Is_Remote_Access_To_Subprogram_Type
(E
)
1927 and then not Is_Remote_Access_To_Subprogram_Type
(S
)
1930 ("incorrect conversion of remote operand to local type", N
);
1933 elsif not Is_Remote_Access_To_Subprogram_Type
(E
)
1934 and then Is_Remote_Access_To_Subprogram_Type
(S
)
1937 ("incorrect conversion of local operand to remote type", N
);
1940 elsif Is_Remote_Access_To_Class_Wide_Type
(E
)
1941 and then not Is_Remote_Access_To_Class_Wide_Type
(S
)
1944 ("incorrect conversion of remote operand to local type", N
);
1948 -- If a local access type is converted into a RACW type, then the
1949 -- current unit has a pointer that may now be exported to another
1952 if Is_Remote_Access_To_Class_Wide_Type
(S
)
1953 and then not Is_Remote_Access_To_Class_Wide_Type
(E
)
1955 Set_Has_RACW
(Current_Sem_Unit
);
1957 end Validate_Remote_Type_Type_Conversion
;
1959 -------------------------------
1960 -- Validate_RT_RAT_Component --
1961 -------------------------------
1963 procedure Validate_RT_RAT_Component
(N
: Node_Id
) is
1964 Spec
: constant Node_Id
:= Specification
(N
);
1965 Name_U
: constant Entity_Id
:= Defining_Entity
(Spec
);
1968 First_Priv_Ent
: constant Entity_Id
:= First_Private_Entity
(Name_U
);
1970 function Stream_Attributes_Available
(Typ
: Entity_Id
) return Boolean;
1971 -- True if any stream attribute is available for Typ
1973 ---------------------------------
1974 -- Stream_Attributes_Available --
1975 ---------------------------------
1977 function Stream_Attributes_Available
(Typ
: Entity_Id
) return Boolean
1980 return Stream_Attribute_Available
(Typ
, TSS_Stream_Read
)
1982 Stream_Attribute_Available
(Typ
, TSS_Stream_Write
)
1984 Stream_Attribute_Available
(Typ
, TSS_Stream_Input
)
1986 Stream_Attribute_Available
(Typ
, TSS_Stream_Output
);
1987 end Stream_Attributes_Available
;
1989 -- Start of processing for Validate_RT_RAT_Component
1992 if not Is_Remote_Types
(Name_U
) then
1996 Typ
:= First_Entity
(Name_U
);
1997 while Present
(Typ
) and then Typ
/= First_Priv_Ent
loop
1998 U_Typ
:= Underlying_Type
(Base_Type
(Typ
));
2004 if Comes_From_Source
(Typ
) and then Is_Type
(Typ
)
2005 and then Ekind
(Typ
) /= E_Incomplete_Type
2007 -- Check that the type can be meaningfully transmitted to another
2008 -- partition (E.2.2(8)).
2010 if (Ada_Version
< Ada_2005
and then Has_Non_Remote_Access
(U_Typ
))
2011 or else (Stream_Attributes_Available
(Typ
)
2012 and then No_External_Streaming
(U_Typ
))
2014 if Is_Non_Remote_Access_Type
(Typ
) then
2015 Error_Msg_N
("error in non-remote access type", U_Typ
);
2018 ("error in record type containing a component of a " &
2019 "non-remote access type", U_Typ
);
2022 if Ada_Version
>= Ada_2005
then
2024 ("\must have visible Read and Write attribute " &
2025 "definition clauses (RM E.2.2(8))", U_Typ
);
2028 ("\must have Read and Write attribute " &
2029 "definition clauses (RM E.2.2(8))", U_Typ
);
2036 end Validate_RT_RAT_Component
;
2038 -----------------------------------------
2039 -- Validate_SP_Access_Object_Type_Decl --
2040 -----------------------------------------
2042 procedure Validate_SP_Access_Object_Type_Decl
(T
: Entity_Id
) is
2043 Direct_Designated_Type
: Entity_Id
;
2045 function Has_Entry_Declarations
(E
: Entity_Id
) return Boolean;
2046 -- Return true if the protected type designated by T has entry
2049 ----------------------------
2050 -- Has_Entry_Declarations --
2051 ----------------------------
2053 function Has_Entry_Declarations
(E
: Entity_Id
) return Boolean is
2057 if Nkind
(Parent
(E
)) = N_Protected_Type_Declaration
then
2058 Ety
:= First_Entity
(E
);
2059 while Present
(Ety
) loop
2060 if Ekind
(Ety
) = E_Entry
then
2069 end Has_Entry_Declarations
;
2071 -- Start of processing for Validate_SP_Access_Object_Type_Decl
2074 -- We are called from Sem_Ch3.Analyze_Full_Type_Declaration, and the
2075 -- Nkind of the given entity is N_Access_To_Object_Definition.
2077 if not Comes_From_Source
(T
)
2078 or else not In_Shared_Passive_Unit
2079 or else In_Subprogram_Task_Protected_Unit
2084 -- Check Shared Passive unit. It should not contain the declaration
2085 -- of an access-to-object type whose designated type is a class-wide
2086 -- type, task type or protected type with entry (RM E.2.1(7)).
2088 Direct_Designated_Type
:= Designated_Type
(T
);
2090 if Ekind
(Direct_Designated_Type
) = E_Class_Wide_Type
then
2092 ("invalid access-to-class-wide type in shared passive unit", T
);
2095 elsif Ekind
(Direct_Designated_Type
) in Task_Kind
then
2097 ("invalid access-to-task type in shared passive unit", T
);
2100 elsif Ekind
(Direct_Designated_Type
) in Protected_Kind
2101 and then Has_Entry_Declarations
(Direct_Designated_Type
)
2104 ("invalid access-to-protected type in shared passive unit", T
);
2107 end Validate_SP_Access_Object_Type_Decl
;
2109 ---------------------------------
2110 -- Validate_Static_Object_Name --
2111 ---------------------------------
2113 procedure Validate_Static_Object_Name
(N
: Node_Id
) is
2117 function Is_Primary
(N
: Node_Id
) return Boolean;
2118 -- Determine whether node is syntactically a primary in an expression
2119 -- This function should probably be somewhere else ???
2121 -- Also it does not do what it says, e.g if N is a binary operator
2122 -- whose parent is a binary operator, Is_Primary returns True ???
2128 function Is_Primary
(N
: Node_Id
) return Boolean is
2129 K
: constant Node_Kind
:= Nkind
(Parent
(N
));
2134 | N_Component_Association
2135 | N_Index_Or_Discriminant_Constraint
2142 when N_Attribute_Reference
=>
2144 Attr
: constant Name_Id
:= Attribute_Name
(Parent
(N
));
2147 return Attr
/= Name_Address
2148 and then Attr
/= Name_Access
2149 and then Attr
/= Name_Unchecked_Access
2150 and then Attr
/= Name_Unrestricted_Access
;
2153 when N_Indexed_Component
=>
2154 return N
/= Prefix
(Parent
(N
)) or else Is_Primary
(Parent
(N
));
2156 when N_Qualified_Expression
2159 return Is_Primary
(Parent
(N
));
2161 when N_Assignment_Statement
2162 | N_Object_Declaration
2164 return N
= Expression
(Parent
(N
));
2166 when N_Selected_Component
=>
2167 return Is_Primary
(Parent
(N
));
2174 -- Start of processing for Validate_Static_Object_Name
2177 if not In_Preelaborated_Unit
2178 or else not Comes_From_Source
(N
)
2179 or else In_Subprogram_Or_Concurrent_Unit
2180 or else Ekind
(Current_Scope
) = E_Block
2184 -- Filter out cases where primary is default in a component declaration,
2185 -- discriminant specification, or actual in a record type initialization
2188 -- Initialization call of internal types
2190 elsif Nkind
(Parent
(N
)) = N_Procedure_Call_Statement
then
2192 if Present
(Parent
(Parent
(N
)))
2193 and then Nkind
(Parent
(Parent
(N
))) = N_Freeze_Entity
2198 if Nkind
(Name
(Parent
(N
))) = N_Identifier
2199 and then not Comes_From_Source
(Entity
(Name
(Parent
(N
))))
2205 -- Error if the name is a primary in an expression. The parent must not
2206 -- be an operator, or a selected component or an indexed component that
2207 -- is itself a primary. Entities that are actuals do not need to be
2208 -- checked, because the call itself will be diagnosed. Entities in a
2209 -- generic unit or within a preanalyzed expression are not checked:
2210 -- only their use in executable code matters.
2213 and then (not Inside_A_Generic
2214 or else Present
(Enclosing_Generic_Body
(N
)))
2215 and then not In_Spec_Expression
2217 if Ekind
(Entity
(N
)) = E_Variable
2218 or else Ekind
(Entity
(N
)) in Formal_Object_Kind
2220 Flag_Non_Static_Expr
2221 ("non-static object name in preelaborated unit", N
);
2223 -- Give an error for a reference to a nonstatic constant, unless the
2224 -- constant is in another GNAT library unit that is preelaborable.
2226 elsif Ekind
(Entity
(N
)) = E_Constant
2227 and then not Is_Static_Expression
(N
)
2230 Val
:= Constant_Value
(E
);
2232 if In_Internal_Unit
(N
)
2234 Enclosing_Comp_Unit_Node
(N
) /= Enclosing_Comp_Unit_Node
(E
)
2235 and then (Is_Preelaborated
(Scope
(E
))
2236 or else Is_Pure
(Scope
(E
))
2237 or else (Present
(Renamed_Object
(E
))
2238 and then Is_Entity_Name
(Renamed_Object
(E
))
2241 (Scope
(Renamed_Object
(E
)))
2244 (Scope
(Renamed_Object
(E
))))))
2248 -- If the value of the constant is a local variable that renames
2249 -- an aggregate, this is in itself legal. The aggregate may be
2250 -- expanded into a loop, but this does not affect preelaborability
2251 -- in itself. If some aggregate components are non-static, that is
2252 -- to say if they involve non static primaries, they will be
2253 -- flagged when analyzed.
2256 and then Is_Entity_Name
(Val
)
2257 and then Is_Array_Type
(Etype
(Val
))
2258 and then not Comes_From_Source
(Val
)
2259 and then Nkind
(Original_Node
(Val
)) = N_Aggregate
2263 -- This is the error case
2266 -- In GNAT mode or Relaxed RM Semantic mode, this is just a
2267 -- warning, to allow it to be judiciously turned off.
2268 -- Otherwise it is a real error.
2270 if GNAT_Mode
or Relaxed_RM_Semantics
then
2272 ("??non-static constant in preelaborated unit", N
);
2274 Flag_Non_Static_Expr
2275 ("non-static constant in preelaborated unit", N
);
2280 end Validate_Static_Object_Name
;