OSDN Git Service

2004-02-23 Ed Schonberg <schonberg@gnat.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / freeze.adb
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT COMPILER COMPONENTS                         --
4 --                                                                          --
5 --                               F R E E Z E                                --
6 --                                                                          --
7 --                                 B o d y                                  --
8 --                                                                          --
9 --          Copyright (C) 1992-2004, Free Software Foundation, Inc.         --
10 --                                                                          --
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,  59 Temple Place - Suite 330,  Boston, --
20 -- MA 02111-1307, USA.                                                      --
21 --                                                                          --
22 -- GNAT was originally developed  by the GNAT team at  New York University. --
23 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
24 --                                                                          --
25 ------------------------------------------------------------------------------
26
27 with Atree;    use Atree;
28 with Debug;    use Debug;
29 with Einfo;    use Einfo;
30 with Elists;   use Elists;
31 with Errout;   use Errout;
32 with Exp_Ch7;  use Exp_Ch7;
33 with Exp_Ch11; use Exp_Ch11;
34 with Exp_Pakd; use Exp_Pakd;
35 with Exp_Util; use Exp_Util;
36 with Exp_Tss;  use Exp_Tss;
37 with Layout;   use Layout;
38 with Lib.Xref; use Lib.Xref;
39 with Nlists;   use Nlists;
40 with Nmake;    use Nmake;
41 with Opt;      use Opt;
42 with Restrict; use Restrict;
43 with Rident;   use Rident;
44 with Sem;      use Sem;
45 with Sem_Cat;  use Sem_Cat;
46 with Sem_Ch6;  use Sem_Ch6;
47 with Sem_Ch7;  use Sem_Ch7;
48 with Sem_Ch8;  use Sem_Ch8;
49 with Sem_Ch13; use Sem_Ch13;
50 with Sem_Eval; use Sem_Eval;
51 with Sem_Mech; use Sem_Mech;
52 with Sem_Prag; use Sem_Prag;
53 with Sem_Res;  use Sem_Res;
54 with Sem_Util; use Sem_Util;
55 with Sinfo;    use Sinfo;
56 with Snames;   use Snames;
57 with Stand;    use Stand;
58 with Targparm; use Targparm;
59 with Tbuild;   use Tbuild;
60 with Ttypes;   use Ttypes;
61 with Uintp;    use Uintp;
62 with Urealp;   use Urealp;
63
64 package body Freeze is
65
66    -----------------------
67    -- Local Subprograms --
68    -----------------------
69
70    procedure Adjust_Esize_For_Alignment (Typ : Entity_Id);
71    --  Typ is a type that is being frozen. If no size clause is given,
72    --  but a default Esize has been computed, then this default Esize is
73    --  adjusted up if necessary to be consistent with a given alignment,
74    --  but never to a value greater than Long_Long_Integer'Size. This
75    --  is used for all discrete types and for fixed-point types.
76
77    procedure Build_And_Analyze_Renamed_Body
78      (Decl  : Node_Id;
79       New_S : Entity_Id;
80       After : in out Node_Id);
81    --  Build body for a renaming declaration, insert in tree and analyze.
82
83    procedure Check_Address_Clause (E : Entity_Id);
84    --  Apply legality checks to address clauses for object declarations,
85    --  at the point the object is frozen.
86
87    procedure Check_Strict_Alignment (E : Entity_Id);
88    --  E is a base type. If E is tagged or has a component that is aliased
89    --  or tagged or contains something this is aliased or tagged, set
90    --  Strict_Alignment.
91
92    procedure Check_Unsigned_Type (E : Entity_Id);
93    pragma Inline (Check_Unsigned_Type);
94    --  If E is a fixed-point or discrete type, then all the necessary work
95    --  to freeze it is completed except for possible setting of the flag
96    --  Is_Unsigned_Type, which is done by this procedure. The call has no
97    --  effect if the entity E is not a discrete or fixed-point type.
98
99    procedure Freeze_And_Append
100      (Ent    : Entity_Id;
101       Loc    : Source_Ptr;
102       Result : in out List_Id);
103    --  Freezes Ent using Freeze_Entity, and appends the resulting list of
104    --  nodes to Result, modifying Result from No_List if necessary.
105
106    procedure Freeze_Enumeration_Type (Typ : Entity_Id);
107    --  Freeze enumeration type. The Esize field is set as processing
108    --  proceeds (i.e. set by default when the type is declared and then
109    --  adjusted by rep clauses. What this procedure does is to make sure
110    --  that if a foreign convention is specified, and no specific size
111    --  is given, then the size must be at least Integer'Size.
112
113    procedure Freeze_Static_Object (E : Entity_Id);
114    --  If an object is frozen which has Is_Statically_Allocated set, then
115    --  all referenced types must also be marked with this flag. This routine
116    --  is in charge of meeting this requirement for the object entity E.
117
118    procedure Freeze_Subprogram (E : Entity_Id);
119    --  Perform freezing actions for a subprogram (create extra formals,
120    --  and set proper default mechanism values). Note that this routine
121    --  is not called for internal subprograms, for which neither of these
122    --  actions is needed (or desirable, we do not want for example to have
123    --  these extra formals present in initialization procedures, where they
124    --  would serve no purpose). In this call E is either a subprogram or
125    --  a subprogram type (i.e. an access to a subprogram).
126
127    function Is_Fully_Defined (T : Entity_Id) return Boolean;
128    --  True if T is not private and has no private components, or has a full
129    --  view. Used to determine whether the designated type of an access type
130    --  should be frozen when the access type is frozen. This is done when an
131    --  allocator is frozen, or an expression that may involve attributes of
132    --  the designated type. Otherwise freezing the access type does not freeze
133    --  the designated type.
134
135    procedure Process_Default_Expressions
136      (E     : Entity_Id;
137       After : in out Node_Id);
138    --  This procedure is called for each subprogram to complete processing
139    --  of default expressions at the point where all types are known to be
140    --  frozen. The expressions must be analyzed in full, to make sure that
141    --  all error processing is done (they have only been pre-analyzed). If
142    --  the expression is not an entity or literal, its analysis may generate
143    --  code which must not be executed. In that case we build a function
144    --  body to hold that code. This wrapper function serves no other purpose
145    --  (it used to be called to evaluate the default, but now the default is
146    --  inlined at each point of call).
147
148    procedure Set_Component_Alignment_If_Not_Set (Typ : Entity_Id);
149    --  Typ is a record or array type that is being frozen. This routine
150    --  sets the default component alignment from the scope stack values
151    --  if the alignment is otherwise not specified.
152
153    procedure Check_Debug_Info_Needed (T : Entity_Id);
154    --  As each entity is frozen, this routine is called to deal with the
155    --  setting of Debug_Info_Needed for the entity. This flag is set if
156    --  the entity comes from source, or if we are in Debug_Generated_Code
157    --  mode or if the -gnatdV debug flag is set. However, it never sets
158    --  the flag if Debug_Info_Off is set.
159
160    procedure Set_Debug_Info_Needed (T : Entity_Id);
161    --  Sets the Debug_Info_Needed flag on entity T if not already set, and
162    --  also on any entities that are needed by T (for an object, the type
163    --  of the object is needed, and for a type, the subsidiary types are
164    --  needed -- see body for details). Never has any effect on T if the
165    --  Debug_Info_Off flag is set.
166
167    procedure Warn_Overlay
168      (Expr : Node_Id;
169       Typ  : Entity_Id;
170       Nam  : Node_Id);
171    --  Expr is the expression for an address clause for entity Nam whose type
172    --  is Typ. If Typ has a default initialization, and there is no explicit
173    --  initialization in the source declaration, check whether the address
174    --  clause might cause overlaying of an entity, and emit a warning on the
175    --  side effect that the initialization will cause.
176
177    -------------------------------
178    -- Adjust_Esize_For_Alignment --
179    -------------------------------
180
181    procedure Adjust_Esize_For_Alignment (Typ : Entity_Id) is
182       Align : Uint;
183
184    begin
185       if Known_Esize (Typ) and then Known_Alignment (Typ) then
186          Align := Alignment_In_Bits (Typ);
187
188          if Align > Esize (Typ)
189            and then Align <= Standard_Long_Long_Integer_Size
190          then
191             Set_Esize (Typ, Align);
192          end if;
193       end if;
194    end Adjust_Esize_For_Alignment;
195
196    ------------------------------------
197    -- Build_And_Analyze_Renamed_Body --
198    ------------------------------------
199
200    procedure Build_And_Analyze_Renamed_Body
201      (Decl  : Node_Id;
202       New_S : Entity_Id;
203       After : in out Node_Id)
204    is
205       Body_Node : constant Node_Id := Build_Renamed_Body (Decl, New_S);
206
207    begin
208       Insert_After (After, Body_Node);
209       Mark_Rewrite_Insertion (Body_Node);
210       Analyze (Body_Node);
211       After := Body_Node;
212    end Build_And_Analyze_Renamed_Body;
213
214    ------------------------
215    -- Build_Renamed_Body --
216    ------------------------
217
218    function Build_Renamed_Body
219      (Decl  : Node_Id;
220       New_S : Entity_Id) return Node_Id
221    is
222       Loc : constant Source_Ptr := Sloc (New_S);
223       --  We use for the source location of the renamed body, the location
224       --  of the spec entity. It might seem more natural to use the location
225       --  of the renaming declaration itself, but that would be wrong, since
226       --  then the body we create would look as though it was created far
227       --  too late, and this could cause problems with elaboration order
228       --  analysis, particularly in connection with instantiations.
229
230       N          : constant Node_Id := Unit_Declaration_Node (New_S);
231       Nam        : constant Node_Id := Name (N);
232       Old_S      : Entity_Id;
233       Spec       : constant Node_Id := New_Copy_Tree (Specification (Decl));
234       Actuals    : List_Id := No_List;
235       Call_Node  : Node_Id;
236       Call_Name  : Node_Id;
237       Body_Node  : Node_Id;
238       Formal     : Entity_Id;
239       O_Formal   : Entity_Id;
240       Param_Spec : Node_Id;
241
242    begin
243       --  Determine the entity being renamed, which is the target of the
244       --  call statement. If the name is an explicit dereference, this is
245       --  a renaming of a subprogram type rather than a subprogram. The
246       --  name itself is fully analyzed.
247
248       if Nkind (Nam) = N_Selected_Component then
249          Old_S := Entity (Selector_Name (Nam));
250
251       elsif Nkind (Nam) = N_Explicit_Dereference then
252          Old_S := Etype (Nam);
253
254       elsif Nkind (Nam) = N_Indexed_Component then
255          if Is_Entity_Name (Prefix (Nam)) then
256             Old_S := Entity (Prefix (Nam));
257          else
258             Old_S := Entity (Selector_Name (Prefix (Nam)));
259          end if;
260
261       elsif Nkind (Nam) = N_Character_Literal then
262          Old_S := Etype (New_S);
263
264       else
265          Old_S := Entity (Nam);
266       end if;
267
268       if Is_Entity_Name (Nam) then
269
270          --  If the renamed entity is a predefined operator, retain full
271          --  name to ensure its visibility.
272
273          if Ekind (Old_S) = E_Operator
274            and then Nkind (Nam) = N_Expanded_Name
275          then
276             Call_Name := New_Copy (Name (N));
277          else
278             Call_Name := New_Reference_To (Old_S, Loc);
279          end if;
280
281       else
282          Call_Name := New_Copy (Name (N));
283
284          --  The original name may have been overloaded, but
285          --  is fully resolved now.
286
287          Set_Is_Overloaded (Call_Name, False);
288       end if;
289
290       --  For simple renamings, subsequent calls can be expanded directly
291       --  as called to the renamed entity. The body must be generated in
292       --  any case for calls they may appear elsewhere.
293
294       if (Ekind (Old_S) = E_Function
295            or else Ekind (Old_S) = E_Procedure)
296         and then Nkind (Decl) = N_Subprogram_Declaration
297       then
298          Set_Body_To_Inline (Decl, Old_S);
299       end if;
300
301       --  The body generated for this renaming is an internal artifact, and
302       --  does not  constitute a freeze point for the called entity.
303
304       Set_Must_Not_Freeze (Call_Name);
305
306       Formal := First_Formal (Defining_Entity (Decl));
307
308       if Present (Formal) then
309          Actuals := New_List;
310
311          while Present (Formal) loop
312             Append (New_Reference_To (Formal, Loc), Actuals);
313             Next_Formal (Formal);
314          end loop;
315       end if;
316
317       --  If the renamed entity is an entry, inherit its profile. For
318       --  other renamings as bodies, both profiles must be subtype
319       --  conformant, so it is not necessary to replace the profile given
320       --  in the declaration. However, default values that are aggregates
321       --  are rewritten when partially analyzed, so we recover the original
322       --  aggregate to insure that subsequent conformity checking works.
323       --  Similarly, if the default expression was constant-folded, recover
324       --  the original expression.
325
326       Formal := First_Formal (Defining_Entity (Decl));
327
328       if Present (Formal) then
329          O_Formal := First_Formal (Old_S);
330          Param_Spec := First (Parameter_Specifications (Spec));
331
332          while Present (Formal) loop
333             if Is_Entry (Old_S) then
334
335                if Nkind (Parameter_Type (Param_Spec)) /=
336                                                     N_Access_Definition
337                then
338                   Set_Etype (Formal, Etype (O_Formal));
339                   Set_Entity (Parameter_Type (Param_Spec), Etype (O_Formal));
340                end if;
341
342             elsif Nkind (Default_Value (O_Formal)) = N_Aggregate
343               or else Nkind (Original_Node (Default_Value (O_Formal))) /=
344                                            Nkind (Default_Value (O_Formal))
345             then
346                Set_Expression (Param_Spec,
347                  New_Copy_Tree (Original_Node (Default_Value (O_Formal))));
348             end if;
349
350             Next_Formal (Formal);
351             Next_Formal (O_Formal);
352             Next (Param_Spec);
353          end loop;
354       end if;
355
356       --  If the renamed entity is a function, the generated body contains a
357       --  return statement. Otherwise, build a procedure call. If the entity is
358       --  an entry, subsequent analysis of the call will transform it into the
359       --  proper entry or protected operation call. If the renamed entity is
360       --  a character literal, return it directly.
361
362       if Ekind (Old_S) = E_Function
363         or else Ekind (Old_S) = E_Operator
364         or else (Ekind (Old_S) = E_Subprogram_Type
365                   and then Etype (Old_S) /= Standard_Void_Type)
366       then
367          Call_Node :=
368            Make_Return_Statement (Loc,
369               Expression =>
370                 Make_Function_Call (Loc,
371                   Name => Call_Name,
372                   Parameter_Associations => Actuals));
373
374       elsif Ekind (Old_S) = E_Enumeration_Literal then
375          Call_Node :=
376            Make_Return_Statement (Loc,
377               Expression => New_Occurrence_Of (Old_S, Loc));
378
379       elsif Nkind (Nam) = N_Character_Literal then
380          Call_Node :=
381            Make_Return_Statement (Loc,
382              Expression => Call_Name);
383
384       else
385          Call_Node :=
386            Make_Procedure_Call_Statement (Loc,
387              Name => Call_Name,
388              Parameter_Associations => Actuals);
389       end if;
390
391       --  Create entities for subprogram body and formals.
392
393       Set_Defining_Unit_Name (Spec,
394         Make_Defining_Identifier (Loc, Chars => Chars (New_S)));
395
396       Param_Spec := First (Parameter_Specifications (Spec));
397
398       while Present (Param_Spec) loop
399          Set_Defining_Identifier (Param_Spec,
400            Make_Defining_Identifier (Loc,
401              Chars => Chars (Defining_Identifier (Param_Spec))));
402          Next (Param_Spec);
403       end loop;
404
405       Body_Node :=
406         Make_Subprogram_Body (Loc,
407           Specification => Spec,
408           Declarations => New_List,
409           Handled_Statement_Sequence =>
410             Make_Handled_Sequence_Of_Statements (Loc,
411               Statements => New_List (Call_Node)));
412
413       if Nkind (Decl) /= N_Subprogram_Declaration then
414          Rewrite (N,
415            Make_Subprogram_Declaration (Loc,
416              Specification => Specification (N)));
417       end if;
418
419       --  Link the body to the entity whose declaration it completes. If
420       --  the body is analyzed when the renamed entity is frozen, it may be
421       --  necessary to restore the proper scope (see package Exp_Ch13).
422
423       if Nkind (N) =  N_Subprogram_Renaming_Declaration
424         and then Present (Corresponding_Spec (N))
425       then
426          Set_Corresponding_Spec (Body_Node, Corresponding_Spec (N));
427       else
428          Set_Corresponding_Spec (Body_Node, New_S);
429       end if;
430
431       return Body_Node;
432    end Build_Renamed_Body;
433
434    --------------------------
435    -- Check_Address_Clause --
436    --------------------------
437
438    procedure Check_Address_Clause (E : Entity_Id) is
439       Addr : constant Node_Id   := Address_Clause (E);
440       Expr : Node_Id;
441       Decl : constant Node_Id   := Declaration_Node (E);
442       Typ  : constant Entity_Id := Etype (E);
443
444    begin
445       if Present (Addr) then
446          Expr := Expression (Addr);
447
448          --  If we have no initialization of any kind, then we don't
449          --  need to place any restrictions on the address clause, because
450          --  the object will be elaborated after the address clause is
451          --  evaluated. This happens if the declaration has no initial
452          --  expression, or the type has no implicit initialization, or
453          --  the object is imported.
454
455          --  The same holds for all initialized scalar types and all
456          --  access types. Packed bit arrays of size up to 64 are
457          --  represented using a modular type with an initialization
458          --  (to zero) and can be processed like other initialized
459          --  scalar types.
460
461          --  If the type is controlled, code to attach the object to a
462          --  finalization chain is generated at the point of declaration,
463          --  and therefore the elaboration of the object cannot be delayed:
464          --  the address expression must be a constant.
465
466          if (No (Expression (Decl))
467               and then not Controlled_Type (Typ)
468               and then
469                 (not Has_Non_Null_Base_Init_Proc (Typ)
470                   or else Is_Imported (E)))
471
472            or else
473              (Present (Expression (Decl))
474                and then Is_Scalar_Type (Typ))
475
476            or else
477              Is_Access_Type (Typ)
478
479            or else
480              (Is_Bit_Packed_Array (Typ)
481                and then
482                  Is_Modular_Integer_Type (Packed_Array_Type (Typ)))
483          then
484             null;
485
486          --  Otherwise, we require the address clause to be constant
487          --  because the call to the initialization procedure (or the
488          --  attach code) has to happen at the point of the declaration.
489
490          else
491             Check_Constant_Address_Clause (Expr, E);
492             Set_Has_Delayed_Freeze (E, False);
493          end if;
494
495          if not Error_Posted (Expr)
496            and then not Controlled_Type (Typ)
497          then
498             Warn_Overlay (Expr, Typ, Name (Addr));
499          end if;
500       end if;
501    end Check_Address_Clause;
502
503    -----------------------------
504    -- Check_Compile_Time_Size --
505    -----------------------------
506
507    procedure Check_Compile_Time_Size (T : Entity_Id) is
508
509       procedure Set_Small_Size (S : Uint);
510       --  Sets the compile time known size (32 bits or less) in the Esize
511       --  field, checking for a size clause that was given which attempts
512       --  to give a smaller size.
513
514       function Size_Known (T : Entity_Id) return Boolean;
515       --  Recursive function that does all the work
516
517       function Static_Discriminated_Components (T : Entity_Id) return Boolean;
518       --  If T is a constrained subtype, its size is not known if any of its
519       --  discriminant constraints is not static and it is not a null record.
520       --  The test is conservative and doesn't check that the components are
521       --  in fact constrained by non-static discriminant values. Could be made
522       --  more precise ???
523
524       --------------------
525       -- Set_Small_Size --
526       --------------------
527
528       procedure Set_Small_Size (S : Uint) is
529       begin
530          if S > 32 then
531             return;
532
533          elsif Has_Size_Clause (T) then
534             if RM_Size (T) < S then
535                Error_Msg_Uint_1 := S;
536                Error_Msg_NE
537                  ("size for & is too small, minimum is ^",
538                   Size_Clause (T), T);
539
540             elsif Unknown_Esize (T) then
541                Set_Esize (T, S);
542             end if;
543
544          --  Set sizes if not set already
545
546          else
547             if Unknown_Esize (T) then
548                Set_Esize (T, S);
549             end if;
550
551             if Unknown_RM_Size (T) then
552                Set_RM_Size (T, S);
553             end if;
554          end if;
555       end Set_Small_Size;
556
557       ----------------
558       -- Size_Known --
559       ----------------
560
561       function Size_Known (T : Entity_Id) return Boolean is
562          Index : Entity_Id;
563          Comp  : Entity_Id;
564          Ctyp  : Entity_Id;
565          Low   : Node_Id;
566          High  : Node_Id;
567
568       begin
569          if Size_Known_At_Compile_Time (T) then
570             return True;
571
572          elsif Is_Scalar_Type (T)
573            or else Is_Task_Type (T)
574          then
575             return not Is_Generic_Type (T);
576
577          elsif Is_Array_Type (T) then
578             if Ekind (T) = E_String_Literal_Subtype then
579                Set_Small_Size (Component_Size (T) * String_Literal_Length (T));
580                return True;
581
582             elsif not Is_Constrained (T) then
583                return False;
584
585             --  Don't do any recursion on type with error posted, since
586             --  we may have a malformed type that leads us into a loop
587
588             elsif Error_Posted (T) then
589                return False;
590
591             elsif not Size_Known (Component_Type (T)) then
592                return False;
593             end if;
594
595             --  Check for all indexes static, and also compute possible
596             --  size (in case it is less than 32 and may be packable).
597
598             declare
599                Esiz : Uint := Component_Size (T);
600                Dim  : Uint;
601
602             begin
603                Index := First_Index (T);
604
605                while Present (Index) loop
606                   if Nkind (Index) = N_Range then
607                      Get_Index_Bounds (Index, Low, High);
608
609                   elsif Error_Posted (Scalar_Range (Etype (Index))) then
610                      return False;
611
612                   else
613                      Low  := Type_Low_Bound (Etype (Index));
614                      High := Type_High_Bound (Etype (Index));
615                   end if;
616
617                   if not Compile_Time_Known_Value (Low)
618                     or else not Compile_Time_Known_Value (High)
619                     or else Etype (Index) = Any_Type
620                   then
621                      return False;
622
623                   else
624                      Dim := Expr_Value (High) - Expr_Value (Low) + 1;
625
626                      if Dim >= 0 then
627                         Esiz := Esiz * Dim;
628                      else
629                         Esiz := Uint_0;
630                      end if;
631                   end if;
632
633                   Next_Index (Index);
634                end loop;
635
636                Set_Small_Size (Esiz);
637                return True;
638             end;
639
640          elsif Is_Access_Type (T) then
641             return True;
642
643          elsif Is_Private_Type (T)
644            and then not Is_Generic_Type (T)
645            and then Present (Underlying_Type (T))
646          then
647             --  Don't do any recursion on type with error posted, since
648             --  we may have a malformed type that leads us into a loop
649
650             if Error_Posted (T) then
651                return False;
652             else
653                return Size_Known (Underlying_Type (T));
654             end if;
655
656          elsif Is_Record_Type (T) then
657
658             --  A class-wide type is never considered to have a known size
659
660             if Is_Class_Wide_Type (T) then
661                return False;
662
663             --  A subtype of a variant record must not have non-static
664             --  discriminanted components.
665
666             elsif T /= Base_Type (T)
667               and then not Static_Discriminated_Components (T)
668             then
669                return False;
670
671             --  Don't do any recursion on type with error posted, since
672             --  we may have a malformed type that leads us into a loop
673
674             elsif Error_Posted (T) then
675                return False;
676             end if;
677
678             --  Now look at the components of the record
679
680             declare
681                --  The following two variables are used to keep track of
682                --  the size of packed records if we can tell the size of
683                --  the packed record in the front end. Packed_Size_Known
684                --  is True if so far we can figure out the size. It is
685                --  initialized to True for a packed record, unless the
686                --  record has discriminants. The reason we eliminate the
687                --  discriminated case is that we don't know the way the
688                --  back end lays out discriminated packed records. If
689                --  Packed_Size_Known is True, then Packed_Size is the
690                --  size in bits so far.
691
692                Packed_Size_Known : Boolean :=
693                                      Is_Packed (T)
694                                        and then not Has_Discriminants (T);
695
696                Packed_Size : Uint := Uint_0;
697
698             begin
699                --  Test for variant part present
700
701                if Has_Discriminants (T)
702                  and then Present (Parent (T))
703                  and then Nkind (Parent (T)) = N_Full_Type_Declaration
704                  and then Nkind (Type_Definition (Parent (T))) =
705                             N_Record_Definition
706                  and then not Null_Present (Type_Definition (Parent (T)))
707                  and then Present (Variant_Part
708                             (Component_List (Type_Definition (Parent (T)))))
709                then
710                   --  If variant part is present, and type is unconstrained,
711                   --  then we must have defaulted discriminants, or a size
712                   --  clause must be present for the type, or else the size
713                   --  is definitely not known at compile time.
714
715                   if not Is_Constrained (T)
716                     and then
717                       No (Discriminant_Default_Value
718                            (First_Discriminant (T)))
719                     and then Unknown_Esize (T)
720                   then
721                      return False;
722                   end if;
723                end if;
724
725                --  Loop through components
726
727                Comp := First_Entity (T);
728                while Present (Comp) loop
729                   if Ekind (Comp) = E_Component
730                        or else
731                      Ekind (Comp) = E_Discriminant
732                   then
733                      Ctyp := Etype (Comp);
734
735                      --  We do not know the packed size if there is a
736                      --  component clause present (we possibly could,
737                      --  but this would only help in the case of a record
738                      --  with partial rep clauses. That's because in the
739                      --  case of full rep clauses, the size gets figured
740                      --  out anyway by a different circuit).
741
742                      if Present (Component_Clause (Comp)) then
743                         Packed_Size_Known := False;
744                      end if;
745
746                      --  We need to identify a component that is an array
747                      --  where the index type is an enumeration type with
748                      --  non-standard representation, and some bound of the
749                      --  type depends on a discriminant.
750
751                      --  This is because gigi computes the size by doing a
752                      --  substituation of the appropriate discriminant value
753                      --  in the size expression for the base type, and gigi
754                      --  is not clever enough to evaluate the resulting
755                      --  expression (which involves a call to rep_to_pos)
756                      --  at compile time.
757
758                      --  It would be nice if gigi would either recognize that
759                      --  this expression can be computed at compile time, or
760                      --  alternatively figured out the size from the subtype
761                      --  directly, where all the information is at hand ???
762
763                      if Is_Array_Type (Etype (Comp))
764                        and then Present (Packed_Array_Type (Etype (Comp)))
765                      then
766                         declare
767                            Ocomp  : constant Entity_Id :=
768                                       Original_Record_Component (Comp);
769                            OCtyp  : constant Entity_Id := Etype (Ocomp);
770                            Ind    : Node_Id;
771                            Indtyp : Entity_Id;
772                            Lo, Hi : Node_Id;
773
774                         begin
775                            Ind := First_Index (OCtyp);
776                            while Present (Ind) loop
777                               Indtyp := Etype (Ind);
778
779                               if Is_Enumeration_Type (Indtyp)
780                                 and then Has_Non_Standard_Rep (Indtyp)
781                               then
782                                  Lo := Type_Low_Bound  (Indtyp);
783                                  Hi := Type_High_Bound (Indtyp);
784
785                                  if Is_Entity_Name (Lo)
786                                    and then
787                                      Ekind (Entity (Lo)) = E_Discriminant
788                                  then
789                                     return False;
790
791                                  elsif Is_Entity_Name (Hi)
792                                    and then
793                                      Ekind (Entity (Hi)) = E_Discriminant
794                                  then
795                                     return False;
796                                  end if;
797                               end if;
798
799                               Next_Index (Ind);
800                            end loop;
801                         end;
802                      end if;
803
804                      --  Clearly size of record is not known if the size of
805                      --  one of the components is not known.
806
807                      if not Size_Known (Ctyp) then
808                         return False;
809                      end if;
810
811                      --  Accumulate packed size if possible
812
813                      if Packed_Size_Known then
814
815                         --  We can only deal with elementary types, since for
816                         --  non-elementary components, alignment enters into
817                         --  the picture, and we don't know enough to handle
818                         --  proper alignment in this context. Packed arrays
819                         --  count as elementary if the representation is a
820                         --  modular type.
821
822                         if Is_Elementary_Type (Ctyp)
823                           or else (Is_Array_Type (Ctyp)
824                                      and then
825                                        Present (Packed_Array_Type (Ctyp))
826                                      and then
827                                        Is_Modular_Integer_Type
828                                          (Packed_Array_Type (Ctyp)))
829                         then
830                            --  If RM_Size is known and static, then we can
831                            --  keep accumulating the packed size.
832
833                            if Known_Static_RM_Size (Ctyp) then
834
835                               --  A little glitch, to be removed sometime ???
836                               --  gigi does not understand zero sizes yet.
837
838                               if RM_Size (Ctyp) = Uint_0 then
839                                  Packed_Size_Known := False;
840
841                               --  Normal case where we can keep accumulating
842                               --  the packed array size.
843
844                               else
845                                  Packed_Size := Packed_Size + RM_Size (Ctyp);
846                               end if;
847
848                            --  If we have a field whose RM_Size is not known
849                            --  then we can't figure out the packed size here.
850
851                            else
852                               Packed_Size_Known := False;
853                            end if;
854
855                         --  If we have a non-elementary type we can't figure
856                         --  out the packed array size (alignment issues).
857
858                         else
859                            Packed_Size_Known := False;
860                         end if;
861                      end if;
862                   end if;
863
864                   Next_Entity (Comp);
865                end loop;
866
867                if Packed_Size_Known then
868                   Set_Small_Size (Packed_Size);
869                end if;
870
871                return True;
872             end;
873
874          else
875             return False;
876          end if;
877       end Size_Known;
878
879       -------------------------------------
880       -- Static_Discriminated_Components --
881       -------------------------------------
882
883       function Static_Discriminated_Components
884         (T    : Entity_Id)
885          return Boolean
886       is
887          Constraint : Elmt_Id;
888
889       begin
890          if Has_Discriminants (T)
891            and then Present (Discriminant_Constraint (T))
892            and then Present (First_Component (T))
893          then
894             Constraint := First_Elmt (Discriminant_Constraint (T));
895             while Present (Constraint) loop
896                if not Compile_Time_Known_Value (Node (Constraint)) then
897                   return False;
898                end if;
899
900                Next_Elmt (Constraint);
901             end loop;
902          end if;
903
904          return True;
905       end Static_Discriminated_Components;
906
907    --  Start of processing for Check_Compile_Time_Size
908
909    begin
910       Set_Size_Known_At_Compile_Time (T, Size_Known (T));
911    end Check_Compile_Time_Size;
912
913    -----------------------------
914    -- Check_Debug_Info_Needed --
915    -----------------------------
916
917    procedure Check_Debug_Info_Needed (T : Entity_Id) is
918    begin
919       if Needs_Debug_Info (T) or else Debug_Info_Off (T) then
920          return;
921
922       elsif Comes_From_Source (T)
923         or else Debug_Generated_Code
924         or else Debug_Flag_VV
925       then
926          Set_Debug_Info_Needed (T);
927       end if;
928    end Check_Debug_Info_Needed;
929
930    ----------------------------
931    -- Check_Strict_Alignment --
932    ----------------------------
933
934    procedure Check_Strict_Alignment (E : Entity_Id) is
935       Comp  : Entity_Id;
936
937    begin
938       if Is_Tagged_Type (E) or else Is_Concurrent_Type (E) then
939          Set_Strict_Alignment (E);
940
941       elsif Is_Array_Type (E) then
942          Set_Strict_Alignment (E, Strict_Alignment (Component_Type (E)));
943
944       elsif Is_Record_Type (E) then
945          if Is_Limited_Record (E) then
946             Set_Strict_Alignment (E);
947             return;
948          end if;
949
950          Comp := First_Component (E);
951
952          while Present (Comp) loop
953             if not Is_Type (Comp)
954               and then (Strict_Alignment (Etype (Comp))
955                          or else Is_Aliased (Comp))
956             then
957                Set_Strict_Alignment (E);
958                return;
959             end if;
960
961             Next_Component (Comp);
962          end loop;
963       end if;
964    end Check_Strict_Alignment;
965
966    -------------------------
967    -- Check_Unsigned_Type --
968    -------------------------
969
970    procedure Check_Unsigned_Type (E : Entity_Id) is
971       Ancestor : Entity_Id;
972       Lo_Bound : Node_Id;
973       Btyp     : Entity_Id;
974
975    begin
976       if not Is_Discrete_Or_Fixed_Point_Type (E) then
977          return;
978       end if;
979
980       --  Do not attempt to analyze case where range was in error
981
982       if Error_Posted (Scalar_Range (E)) then
983          return;
984       end if;
985
986       --  The situation that is non trivial is something like
987
988       --     subtype x1 is integer range -10 .. +10;
989       --     subtype x2 is x1 range 0 .. V1;
990       --     subtype x3 is x2 range V2 .. V3;
991       --     subtype x4 is x3 range V4 .. V5;
992
993       --  where Vn are variables. Here the base type is signed, but we still
994       --  know that x4 is unsigned because of the lower bound of x2.
995
996       --  The only way to deal with this is to look up the ancestor chain
997
998       Ancestor := E;
999       loop
1000          if Ancestor = Any_Type or else Etype (Ancestor) = Any_Type then
1001             return;
1002          end if;
1003
1004          Lo_Bound := Type_Low_Bound (Ancestor);
1005
1006          if Compile_Time_Known_Value (Lo_Bound) then
1007
1008             if Expr_Rep_Value (Lo_Bound) >= 0 then
1009                Set_Is_Unsigned_Type (E, True);
1010             end if;
1011
1012             return;
1013
1014          else
1015             Ancestor := Ancestor_Subtype (Ancestor);
1016
1017             --  If no ancestor had a static lower bound, go to base type
1018
1019             if No (Ancestor) then
1020
1021                --  Note: the reason we still check for a compile time known
1022                --  value for the base type is that at least in the case of
1023                --  generic formals, we can have bounds that fail this test,
1024                --  and there may be other cases in error situations.
1025
1026                Btyp := Base_Type (E);
1027
1028                if Btyp = Any_Type or else Etype (Btyp) = Any_Type then
1029                   return;
1030                end if;
1031
1032                Lo_Bound := Type_Low_Bound (Base_Type (E));
1033
1034                if Compile_Time_Known_Value (Lo_Bound)
1035                  and then Expr_Rep_Value (Lo_Bound) >= 0
1036                then
1037                   Set_Is_Unsigned_Type (E, True);
1038                end if;
1039
1040                return;
1041             end if;
1042          end if;
1043       end loop;
1044    end Check_Unsigned_Type;
1045
1046    -----------------------------
1047    -- Expand_Atomic_Aggregate --
1048    -----------------------------
1049
1050    procedure Expand_Atomic_Aggregate (E : Entity_Id; Typ : Entity_Id) is
1051       Loc   : constant Source_Ptr := Sloc (E);
1052       New_N : Node_Id;
1053       Temp  : Entity_Id;
1054
1055    begin
1056       if (Nkind (Parent (E)) = N_Object_Declaration
1057             or else Nkind (Parent (E)) = N_Assignment_Statement)
1058         and then Comes_From_Source (Parent (E))
1059         and then Nkind (E) = N_Aggregate
1060       then
1061          Temp :=
1062            Make_Defining_Identifier (Loc,
1063              New_Internal_Name ('T'));
1064
1065          New_N :=
1066            Make_Object_Declaration (Loc,
1067              Defining_Identifier => Temp,
1068              Object_definition => New_Occurrence_Of (Typ, Loc),
1069              Expression => Relocate_Node (E));
1070          Insert_Before (Parent (E), New_N);
1071          Analyze (New_N);
1072
1073          Set_Expression (Parent (E), New_Occurrence_Of (Temp, Loc));
1074
1075          --  To prevent the temporary from being constant-folded (which
1076          --  would lead to the same piecemeal assignment on the original
1077          --  target) indicate to the back-end that the temporary  is a
1078          --  variable with real storage. See description of this flag
1079          --  in Einfo, and the notes on N_Assignment_Statement and
1080          --  N_Object_Declaration in Sinfo.
1081
1082          Set_Is_True_Constant (Temp, False);
1083       end if;
1084    end Expand_Atomic_Aggregate;
1085
1086    ----------------
1087    -- Freeze_All --
1088    ----------------
1089
1090    --  Note: the easy coding for this procedure would be to just build a
1091    --  single list of freeze nodes and then insert them and analyze them
1092    --  all at once. This won't work, because the analysis of earlier freeze
1093    --  nodes may recursively freeze types which would otherwise appear later
1094    --  on in the freeze list. So we must analyze and expand the freeze nodes
1095    --  as they are generated.
1096
1097    procedure Freeze_All (From : Entity_Id; After : in out Node_Id) is
1098       Loc   : constant Source_Ptr := Sloc (After);
1099       E     : Entity_Id;
1100       Decl  : Node_Id;
1101
1102       procedure Freeze_All_Ent (From : Entity_Id; After : in out Node_Id);
1103       --  This is the internal recursive routine that does freezing of
1104       --  entities (but NOT the analysis of default expressions, which
1105       --  should not be recursive, we don't want to analyze those till
1106       --  we are sure that ALL the types are frozen).
1107
1108       --------------------
1109       -- Freeze_All_Ent --
1110       --------------------
1111
1112       procedure Freeze_All_Ent
1113         (From  : Entity_Id;
1114          After : in out Node_Id)
1115       is
1116          E     : Entity_Id;
1117          Flist : List_Id;
1118          Lastn : Node_Id;
1119
1120          procedure Process_Flist;
1121          --  If freeze nodes are present, insert and analyze, and reset
1122          --  cursor for next insertion.
1123
1124          -------------------
1125          -- Process_Flist --
1126          -------------------
1127
1128          procedure Process_Flist is
1129          begin
1130             if Is_Non_Empty_List (Flist) then
1131                Lastn := Next (After);
1132                Insert_List_After_And_Analyze (After, Flist);
1133
1134                if Present (Lastn) then
1135                   After := Prev (Lastn);
1136                else
1137                   After := Last (List_Containing (After));
1138                end if;
1139             end if;
1140          end Process_Flist;
1141
1142       --  Start or processing for Freeze_All_Ent
1143
1144       begin
1145          E := From;
1146          while Present (E) loop
1147
1148             --  If the entity is an inner package which is not a package
1149             --  renaming, then its entities must be frozen at this point.
1150             --  Note that such entities do NOT get frozen at the end of
1151             --  the nested package itself (only library packages freeze).
1152
1153             --  Same is true for task declarations, where anonymous records
1154             --  created for entry parameters must be frozen.
1155
1156             if Ekind (E) = E_Package
1157               and then No (Renamed_Object (E))
1158               and then not Is_Child_Unit (E)
1159               and then not Is_Frozen (E)
1160             then
1161                New_Scope (E);
1162                Install_Visible_Declarations (E);
1163                Install_Private_Declarations (E);
1164
1165                Freeze_All (First_Entity (E), After);
1166
1167                End_Package_Scope (E);
1168
1169             elsif Ekind (E) in Task_Kind
1170               and then
1171                 (Nkind (Parent (E)) = N_Task_Type_Declaration
1172                    or else
1173                  Nkind (Parent (E)) = N_Single_Task_Declaration)
1174             then
1175                New_Scope (E);
1176                Freeze_All (First_Entity (E), After);
1177                End_Scope;
1178
1179             --  For a derived tagged type, we must ensure that all the
1180             --  primitive operations of the parent have been frozen, so
1181             --  that their addresses will be in the parent's dispatch table
1182             --  at the point it is inherited.
1183
1184             elsif Ekind (E) = E_Record_Type
1185               and then Is_Tagged_Type (E)
1186               and then Is_Tagged_Type (Etype (E))
1187               and then Is_Derived_Type (E)
1188             then
1189                declare
1190                   Prim_List : constant Elist_Id :=
1191                                Primitive_Operations (Etype (E));
1192
1193                   Prim : Elmt_Id;
1194                   Subp : Entity_Id;
1195
1196                begin
1197                   Prim  := First_Elmt (Prim_List);
1198
1199                   while Present (Prim) loop
1200                      Subp := Node (Prim);
1201
1202                      if Comes_From_Source (Subp)
1203                        and then not Is_Frozen (Subp)
1204                      then
1205                         Flist := Freeze_Entity (Subp, Loc);
1206                         Process_Flist;
1207                      end if;
1208
1209                      Next_Elmt (Prim);
1210                   end loop;
1211                end;
1212             end if;
1213
1214             if not Is_Frozen (E) then
1215                Flist := Freeze_Entity (E, Loc);
1216                Process_Flist;
1217             end if;
1218
1219             --  If an incomplete type is still not frozen, this may be
1220             --  a premature freezing because of a body declaration that
1221             --  follows. Indicate where the freezing took place.
1222
1223             --  If the freezing is caused by the end of the current
1224             --  declarative part, it is a Taft Amendment type, and there
1225             --  is no error.
1226
1227             if not Is_Frozen (E)
1228               and then Ekind (E) = E_Incomplete_Type
1229             then
1230                declare
1231                   Bod : constant Node_Id := Next (After);
1232
1233                begin
1234                   if (Nkind (Bod) = N_Subprogram_Body
1235                         or else Nkind (Bod) = N_Entry_Body
1236                         or else Nkind (Bod) = N_Package_Body
1237                         or else Nkind (Bod) = N_Protected_Body
1238                         or else Nkind (Bod) = N_Task_Body
1239                         or else Nkind (Bod) in N_Body_Stub)
1240                      and then
1241                        List_Containing (After) = List_Containing (Parent (E))
1242                   then
1243                      Error_Msg_Sloc := Sloc (Next (After));
1244                      Error_Msg_NE
1245                        ("type& is frozen# before its full declaration",
1246                          Parent (E), E);
1247                   end if;
1248                end;
1249             end if;
1250
1251             Next_Entity (E);
1252          end loop;
1253       end Freeze_All_Ent;
1254
1255    --  Start of processing for Freeze_All
1256
1257    begin
1258       Freeze_All_Ent (From, After);
1259
1260       --  Now that all types are frozen, we can deal with default expressions
1261       --  that require us to build a default expression functions. This is the
1262       --  point at which such functions are constructed (after all types that
1263       --  might be used in such expressions have been frozen).
1264
1265       --  We also add finalization chains to access types whose designated
1266       --  types are controlled. This is normally done when freezing the type,
1267       --  but this misses recursive type definitions where the later members
1268       --  of the recursion introduce controlled components (e.g. 5624-001).
1269
1270       --  Loop through entities
1271
1272       E := From;
1273       while Present (E) loop
1274          if Is_Subprogram (E) then
1275
1276             if not Default_Expressions_Processed (E) then
1277                Process_Default_Expressions (E, After);
1278             end if;
1279
1280             if not Has_Completion (E) then
1281                Decl := Unit_Declaration_Node (E);
1282
1283                if Nkind (Decl) = N_Subprogram_Renaming_Declaration then
1284                   Build_And_Analyze_Renamed_Body (Decl, E, After);
1285
1286                elsif Nkind (Decl) = N_Subprogram_Declaration
1287                  and then Present (Corresponding_Body (Decl))
1288                  and then
1289                    Nkind (Unit_Declaration_Node (Corresponding_Body (Decl)))
1290                                           = N_Subprogram_Renaming_Declaration
1291                then
1292                   Build_And_Analyze_Renamed_Body
1293                     (Decl, Corresponding_Body (Decl), After);
1294                end if;
1295             end if;
1296
1297          elsif Ekind (E) in Task_Kind
1298            and then
1299              (Nkind (Parent (E)) = N_Task_Type_Declaration
1300                 or else
1301               Nkind (Parent (E)) = N_Single_Task_Declaration)
1302          then
1303             declare
1304                Ent : Entity_Id;
1305             begin
1306                Ent := First_Entity (E);
1307
1308                while Present (Ent) loop
1309
1310                   if Is_Entry (Ent)
1311                     and then not Default_Expressions_Processed (Ent)
1312                   then
1313                      Process_Default_Expressions (Ent, After);
1314                   end if;
1315
1316                   Next_Entity (Ent);
1317                end loop;
1318             end;
1319
1320          elsif Is_Access_Type (E)
1321            and then Comes_From_Source (E)
1322            and then Ekind (Directly_Designated_Type (E)) = E_Incomplete_Type
1323            and then Controlled_Type (Designated_Type (E))
1324            and then No (Associated_Final_Chain (E))
1325          then
1326             Build_Final_List (Parent (E), E);
1327          end if;
1328
1329          Next_Entity (E);
1330       end loop;
1331    end Freeze_All;
1332
1333    -----------------------
1334    -- Freeze_And_Append --
1335    -----------------------
1336
1337    procedure Freeze_And_Append
1338      (Ent    : Entity_Id;
1339       Loc    : Source_Ptr;
1340       Result : in out List_Id)
1341    is
1342       L : constant List_Id := Freeze_Entity (Ent, Loc);
1343
1344    begin
1345       if Is_Non_Empty_List (L) then
1346          if Result = No_List then
1347             Result := L;
1348          else
1349             Append_List (L, Result);
1350          end if;
1351       end if;
1352    end Freeze_And_Append;
1353
1354    -------------------
1355    -- Freeze_Before --
1356    -------------------
1357
1358    procedure Freeze_Before (N : Node_Id; T : Entity_Id) is
1359       Freeze_Nodes : constant List_Id := Freeze_Entity (T, Sloc (N));
1360
1361    begin
1362       if Is_Non_Empty_List (Freeze_Nodes) then
1363          Insert_Actions (N, Freeze_Nodes);
1364       end if;
1365    end Freeze_Before;
1366
1367    -------------------
1368    -- Freeze_Entity --
1369    -------------------
1370
1371    function Freeze_Entity (E : Entity_Id; Loc : Source_Ptr) return List_Id is
1372       Comp   : Entity_Id;
1373       F_Node : Node_Id;
1374       Result : List_Id;
1375       Indx   : Node_Id;
1376       Formal : Entity_Id;
1377       Atype  : Entity_Id;
1378
1379       procedure Check_Current_Instance (Comp_Decl : Node_Id);
1380       --  Check that an Access or Unchecked_Access attribute with
1381       --  a prefix which is the current instance type can only be
1382       --  applied when the type is limited.
1383
1384       function After_Last_Declaration return Boolean;
1385       --  If Loc is a freeze_entity that appears after the last declaration
1386       --  in the scope, inhibit error messages on late completion.
1387
1388       procedure Freeze_Record_Type (Rec : Entity_Id);
1389       --  Freeze each component, handle some representation clauses, and
1390       --  freeze primitive operations if this is a tagged type.
1391
1392       ----------------------------
1393       -- After_Last_Declaration --
1394       ----------------------------
1395
1396       function After_Last_Declaration return Boolean is
1397          Spec  : constant Node_Id := Parent (Current_Scope);
1398
1399       begin
1400          if Nkind (Spec) = N_Package_Specification then
1401             if Present (Private_Declarations (Spec)) then
1402                return Loc >= Sloc (Last (Private_Declarations (Spec)));
1403
1404             elsif Present (Visible_Declarations (Spec)) then
1405                return Loc >= Sloc (Last (Visible_Declarations (Spec)));
1406             else
1407                return False;
1408             end if;
1409
1410          else
1411             return False;
1412          end if;
1413       end After_Last_Declaration;
1414
1415       ----------------------------
1416       -- Check_Current_Instance --
1417       ----------------------------
1418
1419       procedure Check_Current_Instance (Comp_Decl : Node_Id) is
1420
1421          function Process (N : Node_Id) return Traverse_Result;
1422          --  Process routine to apply check to given node.
1423
1424          -------------
1425          -- Process --
1426          -------------
1427
1428          function Process (N : Node_Id) return Traverse_Result is
1429          begin
1430             case Nkind (N) is
1431                when N_Attribute_Reference =>
1432                   if  (Attribute_Name (N) = Name_Access
1433                         or else
1434                       Attribute_Name (N) = Name_Unchecked_Access)
1435                     and then Is_Entity_Name (Prefix (N))
1436                     and then Is_Type (Entity (Prefix (N)))
1437                     and then Entity (Prefix (N)) = E
1438                   then
1439                      Error_Msg_N
1440                        ("current instance must be a limited type", Prefix (N));
1441                      return Abandon;
1442                   else
1443                      return OK;
1444                   end if;
1445
1446                when others => return OK;
1447             end case;
1448          end Process;
1449
1450          procedure Traverse is new Traverse_Proc (Process);
1451
1452       --  Start of processing for Check_Current_Instance
1453
1454       begin
1455          Traverse (Comp_Decl);
1456       end Check_Current_Instance;
1457
1458       ------------------------
1459       -- Freeze_Record_Type --
1460       ------------------------
1461
1462       procedure Freeze_Record_Type (Rec : Entity_Id) is
1463          Comp : Entity_Id;
1464          IR   : Node_Id;
1465          Junk : Boolean;
1466          ADC  : Node_Id;
1467
1468          Unplaced_Component : Boolean := False;
1469          --  Set True if we find at least one component with no component
1470          --  clause (used to warn about useless Pack pragmas).
1471
1472          Placed_Component : Boolean := False;
1473          --  Set True if we find at least one component with a component
1474          --  clause (used to warn about useless Bit_Order pragmas).
1475
1476          procedure Check_Itype (Desig : Entity_Id);
1477          --  If the component subtype is an access to a constrained subtype
1478          --  of an already frozen type, make the subtype frozen as well. It
1479          --  might otherwise be frozen in the wrong scope, and a freeze node
1480          --  on subtype has no effect.
1481
1482          -----------------
1483          -- Check_Itype --
1484          -----------------
1485
1486          procedure Check_Itype (Desig : Entity_Id) is
1487          begin
1488             if not Is_Frozen (Desig)
1489               and then Is_Frozen (Base_Type (Desig))
1490             then
1491                Set_Is_Frozen (Desig);
1492
1493                --  In addition, add an Itype_Reference to ensure that the
1494                --  access subtype is elaborated early enough. This cannot
1495                --  be done if the subtype may depend on discriminants.
1496
1497                if Ekind (Comp) = E_Component
1498                  and then Is_Itype (Etype (Comp))
1499                  and then not Has_Discriminants (Rec)
1500                then
1501                   IR := Make_Itype_Reference (Sloc (Comp));
1502                   Set_Itype (IR, Desig);
1503
1504                   if No (Result) then
1505                      Result := New_List (IR);
1506                   else
1507                      Append (IR, Result);
1508                   end if;
1509                end if;
1510             end if;
1511          end Check_Itype;
1512
1513       --  Start of processing for Freeze_Record_Type
1514
1515       begin
1516          --  If this is a subtype of a controlled type, declared without
1517          --  a constraint, the _controller may not appear in the component
1518          --  list if the parent was not frozen at the point of subtype
1519          --  declaration. Inherit the _controller component now.
1520
1521          if Rec /= Base_Type (Rec)
1522            and then Has_Controlled_Component (Rec)
1523          then
1524             if Nkind (Parent (Rec)) = N_Subtype_Declaration
1525               and then Is_Entity_Name (Subtype_Indication (Parent (Rec)))
1526             then
1527                Set_First_Entity (Rec, First_Entity (Base_Type (Rec)));
1528
1529             --  If this is an internal type without a declaration, as for a
1530             --  record component, the base type may not yet be frozen, and its
1531             --  controller has not been created. Add an explicit freeze node
1532             --  for the itype, so it will be frozen after the base type.
1533
1534             elsif Is_Itype (Rec)
1535               and then Has_Delayed_Freeze (Base_Type (Rec))
1536               and then
1537                 Nkind (Associated_Node_For_Itype (Rec)) =
1538                   N_Component_Declaration
1539             then
1540                Ensure_Freeze_Node (Rec);
1541             end if;
1542          end if;
1543
1544          --  Freeze components and embedded subtypes
1545
1546          Comp := First_Entity (Rec);
1547          while Present (Comp) loop
1548             if not Is_Type (Comp) then
1549                Freeze_And_Append (Etype (Comp), Loc, Result);
1550             end if;
1551
1552             --  If the component is an access type with an allocator
1553             --  as default value, the designated type will be frozen
1554             --  by the corresponding expression in init_proc. In  order
1555             --  to place the freeze node for the designated type before
1556             --  that for the current record type, freeze it now.
1557
1558             --  Same process if the component is an array of access types,
1559             --  initialized with an aggregate. If the designated type is
1560             --  private, it cannot contain allocators, and it is premature
1561             --  to freeze the type, so we check for this as well.
1562
1563             if Is_Access_Type (Etype (Comp))
1564               and then Present (Parent (Comp))
1565               and then Present (Expression (Parent (Comp)))
1566               and then Nkind (Expression (Parent (Comp))) = N_Allocator
1567             then
1568                declare
1569                   Alloc : constant Node_Id := Expression (Parent (Comp));
1570
1571                begin
1572                   --  If component is pointer to a classwide type, freeze
1573                   --  the specific type in the expression being allocated.
1574                   --  The expression may be a subtype indication, in which
1575                   --  case freeze the subtype mark.
1576
1577                   if Is_Class_Wide_Type (Designated_Type (Etype (Comp))) then
1578                      if Is_Entity_Name (Expression (Alloc)) then
1579                         Freeze_And_Append
1580                           (Entity (Expression (Alloc)), Loc, Result);
1581                      elsif
1582                        Nkind (Expression (Alloc)) = N_Subtype_Indication
1583                      then
1584                         Freeze_And_Append
1585                          (Entity (Subtype_Mark (Expression (Alloc))),
1586                            Loc, Result);
1587                      end if;
1588
1589                   elsif Is_Itype (Designated_Type (Etype (Comp))) then
1590                      Check_Itype (Designated_Type (Etype (Comp)));
1591
1592                   else
1593                      Freeze_And_Append
1594                        (Designated_Type (Etype (Comp)), Loc, Result);
1595                   end if;
1596                end;
1597
1598             elsif Is_Access_Type (Etype (Comp))
1599               and then Is_Itype (Designated_Type (Etype (Comp)))
1600             then
1601                Check_Itype (Designated_Type (Etype (Comp)));
1602
1603             elsif Is_Array_Type (Etype (Comp))
1604               and then Is_Access_Type (Component_Type (Etype (Comp)))
1605               and then Present (Parent (Comp))
1606               and then Nkind (Parent (Comp)) = N_Component_Declaration
1607               and then Present (Expression (Parent (Comp)))
1608               and then Nkind (Expression (Parent (Comp))) = N_Aggregate
1609               and then Is_Fully_Defined
1610                  (Designated_Type (Component_Type (Etype (Comp))))
1611             then
1612                Freeze_And_Append
1613                  (Designated_Type
1614                    (Component_Type (Etype (Comp))), Loc, Result);
1615             end if;
1616
1617             --  Processing for real components (exclude anonymous subtypes)
1618
1619             if Ekind (Comp) = E_Component
1620               or else Ekind (Comp) = E_Discriminant
1621             then
1622                --  Check for error of component clause given for variable
1623                --  sized type. We have to delay this test till this point,
1624                --  since the component type has to be frozen for us to know
1625                --  if it is variable length. We omit this test in a generic
1626                --  context, it will be applied at instantiation time.
1627
1628                declare
1629                   CC : constant Node_Id := Component_Clause (Comp);
1630
1631                begin
1632                   if Present (CC) then
1633                      Placed_Component := True;
1634
1635                      if Inside_A_Generic then
1636                         null;
1637
1638                      elsif not Size_Known_At_Compile_Time
1639                               (Underlying_Type (Etype (Comp)))
1640                      then
1641                         Error_Msg_N
1642                           ("component clause not allowed for variable " &
1643                            "length component", CC);
1644                      end if;
1645
1646                   else
1647                      Unplaced_Component := True;
1648                   end if;
1649                end;
1650
1651                --  If component clause is present, then deal with the
1652                --  non-default bit order case. We cannot do this before
1653                --  the freeze point, because there is no required order
1654                --  for the component clause and the bit_order clause.
1655
1656                --  We only do this processing for the base type, and in
1657                --  fact that's important, since otherwise if there are
1658                --  record subtypes, we could reverse the bits once for
1659                --  each subtype, which would be incorrect.
1660
1661                if Present (Component_Clause (Comp))
1662                  and then Reverse_Bit_Order (Rec)
1663                  and then Ekind (E) = E_Record_Type
1664                then
1665                   declare
1666                      CFB : constant Uint    := Component_Bit_Offset (Comp);
1667                      CSZ : constant Uint    := Esize (Comp);
1668                      CLC : constant Node_Id := Component_Clause (Comp);
1669                      Pos : constant Node_Id := Position (CLC);
1670                      FB  : constant Node_Id := First_Bit (CLC);
1671
1672                      Storage_Unit_Offset : constant Uint :=
1673                                              CFB / System_Storage_Unit;
1674
1675                      Start_Bit : constant Uint :=
1676                                    CFB mod System_Storage_Unit;
1677
1678                   begin
1679                      --  Cases where field goes over storage unit boundary
1680
1681                      if Start_Bit + CSZ > System_Storage_Unit then
1682
1683                         --  Allow multi-byte field but generate warning
1684
1685                         if Start_Bit mod System_Storage_Unit = 0
1686                           and then CSZ mod System_Storage_Unit = 0
1687                         then
1688                            Error_Msg_N
1689                              ("multi-byte field specified with non-standard"
1690                                 & " Bit_Order?", CLC);
1691
1692                            if Bytes_Big_Endian then
1693                               Error_Msg_N
1694                                 ("bytes are not reversed "
1695                                    & "(component is big-endian)?", CLC);
1696                            else
1697                               Error_Msg_N
1698                                 ("bytes are not reversed "
1699                                    & "(component is little-endian)?", CLC);
1700                            end if;
1701
1702                         --  Do not allow non-contiguous field
1703
1704                         else
1705                            Error_Msg_N
1706                              ("attempt to specify non-contiguous field"
1707                                 & " not permitted", CLC);
1708                            Error_Msg_N
1709                              ("\(caused by non-standard Bit_Order "
1710                                 & "specified)", CLC);
1711                         end if;
1712
1713                      --  Case where field fits in one storage unit
1714
1715                      else
1716                         --  Give warning if suspicious component clause
1717
1718                         if Intval (FB) >= System_Storage_Unit then
1719                            Error_Msg_N
1720                              ("?Bit_Order clause does not affect " &
1721                               "byte ordering", Pos);
1722                            Error_Msg_Uint_1 :=
1723                              Intval (Pos) + Intval (FB) / System_Storage_Unit;
1724                            Error_Msg_N
1725                              ("?position normalized to ^ before bit " &
1726                               "order interpreted", Pos);
1727                         end if;
1728
1729                         --  Here is where we fix up the Component_Bit_Offset
1730                         --  value to account for the reverse bit order.
1731                         --  Some examples of what needs to be done are:
1732
1733                         --    First_Bit .. Last_Bit     Component_Bit_Offset
1734                         --      old          new          old       new
1735
1736                         --     0 .. 0       7 .. 7         0         7
1737                         --     0 .. 1       6 .. 7         0         6
1738                         --     0 .. 2       5 .. 7         0         5
1739                         --     0 .. 7       0 .. 7         0         4
1740
1741                         --     1 .. 1       6 .. 6         1         6
1742                         --     1 .. 4       3 .. 6         1         3
1743                         --     4 .. 7       0 .. 3         4         0
1744
1745                         --  The general rule is that the first bit is
1746                         --  is obtained by subtracting the old ending bit
1747                         --  from storage_unit - 1.
1748
1749                         Set_Component_Bit_Offset (Comp,
1750                           (Storage_Unit_Offset * System_Storage_Unit)
1751                           + (System_Storage_Unit - 1)
1752                           - (Start_Bit + CSZ - 1));
1753
1754                         Set_Normalized_First_Bit (Comp,
1755                           Component_Bit_Offset (Comp) mod System_Storage_Unit);
1756                      end if;
1757                   end;
1758                end if;
1759             end if;
1760
1761             Next_Entity (Comp);
1762          end loop;
1763
1764          --  Check for useless pragma Bit_Order
1765
1766          if not Placed_Component and then Reverse_Bit_Order (Rec) then
1767             ADC := Get_Attribute_Definition_Clause (Rec, Attribute_Bit_Order);
1768             Error_Msg_N ("?Bit_Order specification has no effect", ADC);
1769             Error_Msg_N ("\?since no component clauses were specified", ADC);
1770          end if;
1771
1772          --  Check for useless pragma Pack when all components placed
1773
1774          if Is_Packed (Rec)
1775            and then not Unplaced_Component
1776            and then Warn_On_Redundant_Constructs
1777          then
1778             Error_Msg_N
1779               ("?pragma Pack has no effect, no unplaced components",
1780                Get_Rep_Pragma (Rec, Name_Pack));
1781             Set_Is_Packed (Rec, False);
1782          end if;
1783
1784          --  If this is the record corresponding to a remote type,
1785          --  freeze the remote type here since that is what we are
1786          --  semantically freezing. This prevents having the freeze
1787          --  node for that type in an inner scope.
1788
1789          --  Also, Check for controlled components and unchecked unions.
1790          --  Finally, enforce the restriction that access attributes with
1791          --  a current instance prefix can only apply to limited types.
1792
1793          if  Ekind (Rec) = E_Record_Type then
1794             if Present (Corresponding_Remote_Type (Rec)) then
1795                Freeze_And_Append
1796                  (Corresponding_Remote_Type (Rec), Loc, Result);
1797             end if;
1798
1799             Comp := First_Component (Rec);
1800             while Present (Comp) loop
1801                if Has_Controlled_Component (Etype (Comp))
1802                  or else (Chars (Comp) /= Name_uParent
1803                            and then Is_Controlled (Etype (Comp)))
1804                  or else (Is_Protected_Type (Etype (Comp))
1805                            and then Present
1806                              (Corresponding_Record_Type (Etype (Comp)))
1807                            and then Has_Controlled_Component
1808                              (Corresponding_Record_Type (Etype (Comp))))
1809                then
1810                   Set_Has_Controlled_Component (Rec);
1811                   exit;
1812                end if;
1813
1814                if Has_Unchecked_Union (Etype (Comp)) then
1815                   Set_Has_Unchecked_Union (Rec);
1816                end if;
1817
1818                if Has_Per_Object_Constraint (Comp)
1819                  and then not Is_Limited_Type (Rec)
1820                then
1821                   --  Scan component declaration for likely misuses of
1822                   --  current instance, either in a constraint or in a
1823                   --  default expression.
1824
1825                   Check_Current_Instance (Parent (Comp));
1826                end if;
1827
1828                Next_Component (Comp);
1829             end loop;
1830          end if;
1831
1832          Set_Component_Alignment_If_Not_Set (Rec);
1833
1834          --  For first subtypes, check if there are any fixed-point
1835          --  fields with component clauses, where we must check the size.
1836          --  This is not done till the freeze point, since for fixed-point
1837          --  types, we do not know the size until the type is frozen.
1838          --  Similar processing applies to bit packed arrays.
1839
1840          if Is_First_Subtype (Rec) then
1841             Comp := First_Component (Rec);
1842
1843             while Present (Comp) loop
1844                if Present (Component_Clause (Comp))
1845                  and then (Is_Fixed_Point_Type (Etype (Comp))
1846                              or else
1847                            Is_Bit_Packed_Array (Etype (Comp)))
1848                then
1849                   Check_Size
1850                     (Component_Name (Component_Clause (Comp)),
1851                      Etype (Comp),
1852                      Esize (Comp),
1853                      Junk);
1854                end if;
1855
1856                Next_Component (Comp);
1857             end loop;
1858          end if;
1859       end Freeze_Record_Type;
1860
1861    --  Start of processing for Freeze_Entity
1862
1863    begin
1864       --  Do not freeze if already frozen since we only need one freeze node
1865
1866       if Is_Frozen (E) then
1867          return No_List;
1868
1869       --  It is improper to freeze an external entity within a generic
1870       --  because its freeze node will appear in a non-valid context.
1871       --  ??? We should probably freeze the entity at that point and insert
1872       --  the freeze node in a proper place but this proper place is not
1873       --  easy to find, and the proper scope is not easy to restore. For
1874       --  now, just wait to get out of the generic to freeze ???
1875
1876       elsif Inside_A_Generic and then External_Ref_In_Generic (E) then
1877          return No_List;
1878
1879       --  Do not freeze a global entity within an inner scope created during
1880       --  expansion. A call to subprogram E within some internal procedure
1881       --  (a stream attribute for example) might require freezing E, but the
1882       --  freeze node must appear in the same declarative part as E itself.
1883       --  The two-pass elaboration mechanism in gigi guarantees that E will
1884       --  be frozen before the inner call is elaborated. We exclude constants
1885       --  from this test, because deferred constants may be frozen early, and
1886       --  must be diagnosed (see e.g. 1522-005). If the enclosing subprogram
1887       --  comes from source, or is a generic instance, then the freeze point
1888       --  is the one mandated by the language. and we freze the entity.
1889
1890       elsif In_Open_Scopes (Scope (E))
1891         and then Scope (E) /= Current_Scope
1892         and then Ekind (E) /= E_Constant
1893       then
1894          declare
1895             S : Entity_Id := Current_Scope;
1896
1897          begin
1898             while Present (S) loop
1899                if Is_Overloadable (S) then
1900                   if Comes_From_Source (S)
1901                     or else Is_Generic_Instance (S)
1902                   then
1903                      exit;
1904                   else
1905                      return No_List;
1906                   end if;
1907                end if;
1908
1909                S := Scope (S);
1910             end loop;
1911          end;
1912       end if;
1913
1914       --  Here to freeze the entity
1915
1916       Result := No_List;
1917       Set_Is_Frozen (E);
1918
1919       --  Case of entity being frozen is other than a type
1920
1921       if not Is_Type (E) then
1922
1923          --  If entity is exported or imported and does not have an external
1924          --  name, now is the time to provide the appropriate default name.
1925          --  Skip this if the entity is stubbed, since we don't need a name
1926          --  for any stubbed routine.
1927
1928          if (Is_Imported (E) or else Is_Exported (E))
1929            and then No (Interface_Name (E))
1930            and then Convention (E) /= Convention_Stubbed
1931          then
1932             Set_Encoded_Interface_Name
1933               (E, Get_Default_External_Name (E));
1934
1935          --  Special processing for atomic objects appearing in object decls
1936
1937          elsif Is_Atomic (E)
1938            and then Nkind (Parent (E)) = N_Object_Declaration
1939            and then Present (Expression (Parent (E)))
1940          then
1941             declare
1942                Expr : constant Node_Id := Expression (Parent (E));
1943
1944             begin
1945                --  If expression is an aggregate, assign to a temporary to
1946                --  ensure that the actual assignment is done atomically rather
1947                --  than component-wise (the assignment to the temp may be done
1948                --  component-wise, but that is harmless.
1949
1950                if Nkind (Expr) = N_Aggregate then
1951                   Expand_Atomic_Aggregate (Expr, Etype (E));
1952
1953                --  If the expression is a reference to a record or array
1954                --  object entity, then reset Is_True_Constant to False so
1955                --  that the compiler will not optimize away the intermediate
1956                --  object, which we need in this case for the same reason
1957                --  (to ensure that the actual assignment is atomic, rather
1958                --  than component-wise).
1959
1960                elsif Is_Entity_Name (Expr)
1961                  and then (Is_Record_Type (Etype (Expr))
1962                              or else
1963                            Is_Array_Type (Etype (Expr)))
1964                then
1965                   Set_Is_True_Constant (Entity (Expr), False);
1966                end if;
1967             end;
1968          end if;
1969
1970          --  For a subprogram, freeze all parameter types and also the return
1971          --  type (RM 13.14(14)). However skip this for internal subprograms.
1972          --  This is also the point where any extra formal parameters are
1973          --  created since we now know whether the subprogram will use
1974          --  a foreign convention.
1975
1976          if Is_Subprogram (E) then
1977             if not Is_Internal (E) then
1978                declare
1979                   F_Type : Entity_Id;
1980
1981                   function Is_Fat_C_Ptr_Type (T : Entity_Id) return Boolean;
1982                   --  Determines if given type entity is a fat pointer type
1983                   --  used as an argument type or return type to a subprogram
1984                   --  with C or C++ convention set.
1985
1986                   --------------------------
1987                   -- Is_Fat_C_Access_Type --
1988                   --------------------------
1989
1990                   function Is_Fat_C_Ptr_Type (T : Entity_Id) return Boolean is
1991                   begin
1992                      return (Convention (E) = Convention_C
1993                                or else
1994                              Convention (E) = Convention_CPP)
1995                        and then Is_Access_Type (T)
1996                        and then Esize (T) > Ttypes.System_Address_Size;
1997                   end Is_Fat_C_Ptr_Type;
1998
1999                begin
2000                   --  Loop through formals
2001
2002                   Formal := First_Formal (E);
2003                   while Present (Formal) loop
2004                      F_Type := Etype (Formal);
2005                      Freeze_And_Append (F_Type, Loc, Result);
2006
2007                      if Is_Private_Type (F_Type)
2008                        and then Is_Private_Type (Base_Type (F_Type))
2009                        and then No (Full_View (Base_Type (F_Type)))
2010                        and then not Is_Generic_Type (F_Type)
2011                        and then not Is_Derived_Type (F_Type)
2012                      then
2013                         --  If the type of a formal is incomplete, subprogram
2014                         --  is being frozen prematurely. Within an instance
2015                         --  (but not within a wrapper package) this is an
2016                         --  an artifact of our need to regard the end of an
2017                         --  instantiation as a freeze point. Otherwise it is
2018                         --  a definite error.
2019
2020                         --  and then not Is_Wrapper_Package (Current_Scope) ???
2021
2022                         if In_Instance then
2023                            Set_Is_Frozen (E, False);
2024                            return No_List;
2025
2026                         elsif not After_Last_Declaration then
2027                            Error_Msg_Node_1 := F_Type;
2028                            Error_Msg
2029                              ("type& must be fully defined before this point",
2030                                Loc);
2031                         end if;
2032                      end if;
2033
2034                      --  Check bad use of fat C pointer
2035
2036                      if Warn_On_Export_Import and then
2037                        Is_Fat_C_Ptr_Type (F_Type)
2038                      then
2039                         Error_Msg_Qual_Level := 1;
2040                         Error_Msg_N
2041                            ("?type of & does not correspond to C pointer",
2042                             Formal);
2043                         Error_Msg_Qual_Level := 0;
2044                      end if;
2045
2046                      --  Check for unconstrained array in exported foreign
2047                      --  convention case.
2048
2049                      if Convention (E) in Foreign_Convention
2050                        and then not Is_Imported (E)
2051                        and then Is_Array_Type (F_Type)
2052                        and then not Is_Constrained (F_Type)
2053                        and then Warn_On_Export_Import
2054                      then
2055                         Error_Msg_Qual_Level := 1;
2056                         Error_Msg_N
2057                           ("?type of argument& is unconstrained array",
2058                            Formal);
2059                         Error_Msg_N
2060                           ("?foreign caller must pass bounds explicitly",
2061                            Formal);
2062                         Error_Msg_Qual_Level := 0;
2063                      end if;
2064
2065                      Next_Formal (Formal);
2066                   end loop;
2067
2068                   --  Check return type
2069
2070                   if Ekind (E) = E_Function then
2071                      Freeze_And_Append (Etype (E), Loc, Result);
2072
2073                      if Warn_On_Export_Import
2074                        and then Is_Fat_C_Ptr_Type (Etype (E))
2075                      then
2076                         Error_Msg_N
2077                           ("?return type of& does not correspond to C pointer",
2078                            E);
2079
2080                      elsif Is_Array_Type (Etype (E))
2081                        and then not Is_Constrained (Etype (E))
2082                        and then not Is_Imported (E)
2083                        and then Convention (E) in Foreign_Convention
2084                        and then Warn_On_Export_Import
2085                      then
2086                         Error_Msg_N
2087                           ("?foreign convention function& should not " &
2088                            "return unconstrained array", E);
2089                      end if;
2090                   end if;
2091                end;
2092             end if;
2093
2094             --  Must freeze its parent first if it is a derived subprogram
2095
2096             if Present (Alias (E)) then
2097                Freeze_And_Append (Alias (E), Loc, Result);
2098             end if;
2099
2100             --  If the return type requires a transient scope, and we are on
2101             --  a target allowing functions to return with a depressed stack
2102             --  pointer, then we mark the function as requiring this treatment.
2103
2104             if Ekind (E) = E_Function
2105               and then Functions_Return_By_DSP_On_Target
2106               and then Requires_Transient_Scope (Etype (E))
2107             then
2108                Set_Function_Returns_With_DSP (E);
2109             end if;
2110
2111             if not Is_Internal (E) then
2112                Freeze_Subprogram (E);
2113             end if;
2114
2115          --  Here for other than a subprogram or type
2116
2117          else
2118             --  If entity has a type, and it is not a generic unit, then
2119             --  freeze it first (RM 13.14(10))
2120
2121             if Present (Etype (E))
2122               and then Ekind (E) /= E_Generic_Function
2123             then
2124                Freeze_And_Append (Etype (E), Loc, Result);
2125             end if;
2126
2127             --  For object created by object declaration, perform required
2128             --  categorization (preelaborate and pure) checks. Defer these
2129             --  checks to freeze time since pragma Import inhibits default
2130             --  initialization and thus pragma Import affects these checks.
2131
2132             if Nkind (Declaration_Node (E)) = N_Object_Declaration then
2133                Validate_Object_Declaration (Declaration_Node (E));
2134                Check_Address_Clause (E);
2135             end if;
2136
2137             --  Check that a constant which has a pragma Volatile[_Components]
2138             --  or Atomic[_Components] also has a pragma Import (RM C.6(13))
2139
2140             --  Note: Atomic[_Components] also sets Volatile[_Components]
2141
2142             if Ekind (E) = E_Constant
2143               and then (Has_Volatile_Components (E) or else Is_Volatile (E))
2144               and then not Is_Imported (E)
2145             then
2146                --  Make sure we actually have a pragma, and have not merely
2147                --  inherited the indication from elsewhere (e.g. an address
2148                --  clause, which is not good enough in RM terms!)
2149
2150                if Present (Get_Rep_Pragma (E, Name_Atomic))
2151                     or else
2152                   Present (Get_Rep_Pragma (E, Name_Atomic_Components))
2153                then
2154                   Error_Msg_N
2155                     ("stand alone atomic constant must be " &
2156                      "imported ('R'M 'C.6(13))", E);
2157
2158                elsif Present (Get_Rep_Pragma (E, Name_Volatile))
2159                        or else
2160                      Present (Get_Rep_Pragma (E, Name_Volatile_Components))
2161                then
2162                   Error_Msg_N
2163                     ("stand alone volatile constant must be " &
2164                      "imported ('R'M 'C.6(13))", E);
2165                end if;
2166             end if;
2167
2168             --  Static objects require special handling
2169
2170             if (Ekind (E) = E_Constant or else Ekind (E) = E_Variable)
2171               and then Is_Statically_Allocated (E)
2172             then
2173                Freeze_Static_Object (E);
2174             end if;
2175
2176             --  Remaining step is to layout objects
2177
2178             if Ekind (E) = E_Variable
2179                  or else
2180                Ekind (E) = E_Constant
2181                  or else
2182                Ekind (E) = E_Loop_Parameter
2183                  or else
2184                Is_Formal (E)
2185             then
2186                Layout_Object (E);
2187             end if;
2188          end if;
2189
2190       --  Case of a type or subtype being frozen
2191
2192       else
2193          --  The type may be defined in a generic unit. This can occur when
2194          --  freezing a generic function that returns the type (which is
2195          --  defined in a parent unit). It is clearly meaningless to freeze
2196          --  this type. However, if it is a subtype, its size may be determi-
2197          --  nable and used in subsequent checks, so might as well try to
2198          --  compute it.
2199
2200          if Present (Scope (E))
2201            and then Is_Generic_Unit (Scope (E))
2202          then
2203             Check_Compile_Time_Size (E);
2204             return No_List;
2205          end if;
2206
2207          --  Deal with special cases of freezing for subtype
2208
2209          if E /= Base_Type (E) then
2210
2211             --  If ancestor subtype present, freeze that first.
2212             --  Note that this will also get the base type frozen.
2213
2214             Atype := Ancestor_Subtype (E);
2215
2216             if Present (Atype) then
2217                Freeze_And_Append (Atype, Loc, Result);
2218
2219             --  Otherwise freeze the base type of the entity before
2220             --  freezing the entity itself, (RM 13.14(15)).
2221
2222             elsif E /= Base_Type (E) then
2223                Freeze_And_Append (Base_Type (E), Loc, Result);
2224             end if;
2225
2226          --  For a derived type, freeze its parent type first (RM 13.14(15))
2227
2228          elsif Is_Derived_Type (E) then
2229             Freeze_And_Append (Etype (E), Loc, Result);
2230             Freeze_And_Append (First_Subtype (Etype (E)), Loc, Result);
2231          end if;
2232
2233          --  For array type, freeze index types and component type first
2234          --  before freezing the array (RM 13.14(15)).
2235
2236          if Is_Array_Type (E) then
2237             declare
2238                Ctyp : constant Entity_Id := Component_Type (E);
2239                Pnod : Node_Id;
2240
2241                Non_Standard_Enum : Boolean := False;
2242                --  Set true if any of the index types is an enumeration
2243                --  type with a non-standard representation.
2244
2245             begin
2246                Freeze_And_Append (Ctyp, Loc, Result);
2247
2248                Indx := First_Index (E);
2249                while Present (Indx) loop
2250                   Freeze_And_Append (Etype (Indx), Loc, Result);
2251
2252                   if Is_Enumeration_Type (Etype (Indx))
2253                     and then Has_Non_Standard_Rep (Etype (Indx))
2254                   then
2255                      Non_Standard_Enum := True;
2256                   end if;
2257
2258                   Next_Index (Indx);
2259                end loop;
2260
2261                --  Processing that is done only for base types
2262
2263                if Ekind (E) = E_Array_Type then
2264
2265                   --  Propagate flags for component type
2266
2267                   if Is_Controlled (Component_Type (E))
2268                     or else Has_Controlled_Component (Ctyp)
2269                   then
2270                      Set_Has_Controlled_Component (E);
2271                   end if;
2272
2273                   if Has_Unchecked_Union (Component_Type (E)) then
2274                      Set_Has_Unchecked_Union (E);
2275                   end if;
2276
2277                   --  If packing was requested or if the component size was set
2278                   --  explicitly, then see if bit packing is required. This
2279                   --  processing is only done for base types, since all the
2280                   --  representation aspects involved are type-related. This
2281                   --  is not just an optimization, if we start processing the
2282                   --  subtypes, they intefere with the settings on the base
2283                   --  type (this is because Is_Packed has a slightly different
2284                   --  meaning before and after freezing).
2285
2286                   declare
2287                      Csiz : Uint;
2288                      Esiz : Uint;
2289
2290                   begin
2291                      if (Is_Packed (E) or else Has_Pragma_Pack (E))
2292                        and then not Has_Atomic_Components (E)
2293                        and then Known_Static_RM_Size (Ctyp)
2294                      then
2295                         Csiz := UI_Max (RM_Size (Ctyp), 1);
2296
2297                      elsif Known_Component_Size (E) then
2298                         Csiz := Component_Size (E);
2299
2300                      elsif not Known_Static_Esize (Ctyp) then
2301                         Csiz := Uint_0;
2302
2303                      else
2304                         Esiz := Esize (Ctyp);
2305
2306                         --  We can set the component size if it is less than
2307                         --  16, rounding it up to the next storage unit size.
2308
2309                         if Esiz <= 8 then
2310                            Csiz := Uint_8;
2311                         elsif Esiz <= 16 then
2312                            Csiz := Uint_16;
2313                         else
2314                            Csiz := Uint_0;
2315                         end if;
2316
2317                         --  Set component size up to match alignment if
2318                         --  it would otherwise be less than the alignment.
2319                         --  This deals with cases of types whose alignment
2320                         --  exceeds their sizes (padded types).
2321
2322                         if Csiz /= 0 then
2323                            declare
2324                               A : constant Uint := Alignment_In_Bits (Ctyp);
2325
2326                            begin
2327                               if Csiz < A then
2328                                  Csiz := A;
2329                               end if;
2330                            end;
2331                         end if;
2332
2333                      end if;
2334
2335                      if 1 <= Csiz and then Csiz <= 64 then
2336
2337                         --  We set the component size for all cases 1-64
2338
2339                         Set_Component_Size (Base_Type (E), Csiz);
2340
2341                         --  Check for base type of 8,16,32 bits, where the
2342                         --  subtype has a length one less than the base type
2343                         --  and is unsigned (e.g. Natural subtype of Integer)
2344
2345                         --  In such cases, if a component size was not set
2346                         --  explicitly, then generate a warning.
2347
2348                         if Has_Pragma_Pack (E)
2349                           and then not Has_Component_Size_Clause (E)
2350                           and then
2351                             (Csiz = 7 or else Csiz = 15 or else Csiz = 31)
2352                           and then Esize (Base_Type (Ctyp)) = Csiz + 1
2353                         then
2354                            Error_Msg_Uint_1 := Csiz;
2355                            Pnod :=
2356                              Get_Rep_Pragma (First_Subtype (E), Name_Pack);
2357
2358                            if Present (Pnod) then
2359                               Error_Msg_N
2360                                 ("pragma Pack causes component size to be ^?",
2361                                  Pnod);
2362                               Error_Msg_N
2363                                 ("\use Component_Size to set desired value",
2364                                  Pnod);
2365                            end if;
2366                         end if;
2367
2368                         --  Actual packing is not needed for 8,16,32,64
2369                         --  Also not needed for 24 if alignment is 1
2370
2371                         if        Csiz = 8
2372                           or else Csiz = 16
2373                           or else Csiz = 32
2374                           or else Csiz = 64
2375                           or else (Csiz = 24 and then Alignment (Ctyp) = 1)
2376                         then
2377                            --  Here the array was requested to be packed, but
2378                            --  the packing request had no effect, so Is_Packed
2379                            --  is reset.
2380
2381                            --  Note: semantically this means that we lose
2382                            --  track of the fact that a derived type inherited
2383                            --  a pack pragma that was non-effective, but that
2384                            --  seems fine.
2385
2386                            --  We regard a Pack pragma as a request to set a
2387                            --  representation characteristic, and this request
2388                            --  may be ignored.
2389
2390                            Set_Is_Packed (Base_Type (E), False);
2391
2392                         --  In all other cases, packing is indeed needed
2393
2394                         else
2395                            Set_Has_Non_Standard_Rep (Base_Type (E));
2396                            Set_Is_Bit_Packed_Array  (Base_Type (E));
2397                            Set_Is_Packed            (Base_Type (E));
2398                         end if;
2399                      end if;
2400                   end;
2401
2402                --  Processing that is done only for subtypes
2403
2404                else
2405                   --  Acquire alignment from base type
2406
2407                   if Unknown_Alignment (E) then
2408                      Set_Alignment (E, Alignment (Base_Type (E)));
2409                   end if;
2410                end if;
2411
2412                --  For bit-packed arrays, check the size
2413
2414                if Is_Bit_Packed_Array (E)
2415                  and then Known_Esize (E)
2416                then
2417                   declare
2418                      Discard : Boolean;
2419                      SizC    : constant Node_Id := Size_Clause (E);
2420
2421                   begin
2422                      --  It is not clear if it is possible to have no size
2423                      --  clause at this stage, but this is not worth worrying
2424                      --  about. Post the error on the entity name in the size
2425                      --  clause if present, else on the type entity itself.
2426
2427                      if Present (SizC) then
2428                         Check_Size (Name (SizC), E, Esize (E), Discard);
2429                      else
2430                         Check_Size (E, E, Esize (E), Discard);
2431                      end if;
2432                   end;
2433                end if;
2434
2435                --  Check one common case of a size given where the array
2436                --  needs to be packed, but was not so the size cannot be
2437                --  honored. This would of course be caught by the backend,
2438                --  and indeed we don't catch all cases. The point is that
2439                --  we can give a better error message in those cases that
2440                --  we do catch with the circuitry here.
2441
2442                declare
2443                   Lo, Hi : Node_Id;
2444                   Ctyp   : constant Entity_Id := Component_Type (E);
2445
2446                begin
2447                   if Present (Size_Clause (E))
2448                     and then Known_Static_Esize (E)
2449                     and then not Is_Bit_Packed_Array (E)
2450                     and then not Has_Pragma_Pack (E)
2451                     and then Number_Dimensions (E) = 1
2452                     and then not Has_Component_Size_Clause (E)
2453                     and then Known_Static_Esize (Ctyp)
2454                   then
2455                      Get_Index_Bounds (First_Index (E), Lo, Hi);
2456
2457                      if Compile_Time_Known_Value (Lo)
2458                        and then Compile_Time_Known_Value (Hi)
2459                        and then Known_Static_RM_Size (Ctyp)
2460                        and then RM_Size (Ctyp) < 64
2461                      then
2462                         declare
2463                            Lov  : constant Uint := Expr_Value (Lo);
2464                            Hiv  : constant Uint := Expr_Value (Hi);
2465                            Len  : constant Uint :=
2466                                     UI_Max (Uint_0, Hiv - Lov + 1);
2467                            Rsiz : constant Uint := RM_Size (Ctyp);
2468
2469                         --  What we are looking for here is the situation
2470                         --  where the Esize given would be exactly right
2471                         --  if there was a pragma Pack (resulting in the
2472                         --  component size being the same as the RM_Size).
2473                         --  Furthermore, the component type size must be
2474                         --  an odd size (not a multiple of storage unit)
2475
2476                         begin
2477                            if Esize (E) = Len * Rsiz
2478                              and then Rsiz mod System_Storage_Unit /= 0
2479                            then
2480                               Error_Msg_NE
2481                                 ("size given for& too small",
2482                                    Size_Clause (E), E);
2483                               Error_Msg_N
2484                                 ("\explicit pragma Pack is required",
2485                                    Size_Clause (E));
2486                            end if;
2487                         end;
2488                      end if;
2489                   end if;
2490                end;
2491
2492                --  If any of the index types was an enumeration type with
2493                --  a non-standard rep clause, then we indicate that the
2494                --  array type is always packed (even if it is not bit packed).
2495
2496                if Non_Standard_Enum then
2497                   Set_Has_Non_Standard_Rep (Base_Type (E));
2498                   Set_Is_Packed            (Base_Type (E));
2499                end if;
2500             end;
2501
2502             Set_Component_Alignment_If_Not_Set (E);
2503
2504             --  If the array is packed, we must create the packed array
2505             --  type to be used to actually implement the type. This is
2506             --  only needed for real array types (not for string literal
2507             --  types, since they are present only for the front end).
2508
2509             if Is_Packed (E)
2510               and then Ekind (E) /= E_String_Literal_Subtype
2511             then
2512                Create_Packed_Array_Type (E);
2513                Freeze_And_Append (Packed_Array_Type (E), Loc, Result);
2514
2515                --  Size information of packed array type is copied to the
2516                --  array type, since this is really the representation.
2517
2518                Set_Size_Info (E, Packed_Array_Type (E));
2519                Set_RM_Size   (E, RM_Size (Packed_Array_Type (E)));
2520             end if;
2521
2522          --  For a class-wide type, the corresponding specific type is
2523          --  frozen as well (RM 13.14(15))
2524
2525          elsif Is_Class_Wide_Type (E) then
2526             Freeze_And_Append (Root_Type (E), Loc, Result);
2527
2528             --  If the Class_Wide_Type is an Itype (when type is the anonymous
2529             --  parent of a derived type) and it is a library-level entity,
2530             --  generate an itype reference for it. Otherwise, its first
2531             --  explicit reference may be in an inner scope, which will be
2532             --  rejected by the back-end.
2533
2534             if Is_Itype (E)
2535               and then Is_Compilation_Unit (Scope (E))
2536             then
2537                declare
2538                   Ref : constant Node_Id := Make_Itype_Reference (Loc);
2539
2540                begin
2541                   Set_Itype (Ref, E);
2542                   if No (Result) then
2543                      Result := New_List (Ref);
2544                   else
2545                      Append (Ref, Result);
2546                   end if;
2547                end;
2548             end if;
2549
2550             --  The equivalent type associated with a class-wide subtype
2551             --  needs to be frozen to ensure that its layout is done.
2552             --  Class-wide subtypes are currently only frozen on targets
2553             --  requiring front-end layout (see New_Class_Wide_Subtype
2554             --  and Make_CW_Equivalent_Type in exp_util.adb).
2555
2556             if Ekind (E) = E_Class_Wide_Subtype
2557               and then Present (Equivalent_Type (E))
2558             then
2559                Freeze_And_Append (Equivalent_Type (E), Loc, Result);
2560             end if;
2561
2562          --  For a record (sub)type, freeze all the component types (RM
2563          --  13.14(15). We test for E_Record_(sub)Type here, rather than
2564          --  using Is_Record_Type, because we don't want to attempt the
2565          --  freeze for the case of a private type with record extension
2566          --  (we will do that later when the full type is frozen).
2567
2568          elsif Ekind (E) = E_Record_Type
2569            or else  Ekind (E) = E_Record_Subtype
2570          then
2571             Freeze_Record_Type (E);
2572
2573          --  For a concurrent type, freeze corresponding record type. This
2574          --  does not correpond to any specific rule in the RM, but the
2575          --  record type is essentially part of the concurrent type.
2576          --  Freeze as well all local entities. This includes record types
2577          --  created for entry parameter blocks, and whatever local entities
2578          --  may appear in the private part.
2579
2580          elsif Is_Concurrent_Type (E) then
2581             if Present (Corresponding_Record_Type (E)) then
2582                Freeze_And_Append
2583                  (Corresponding_Record_Type (E), Loc, Result);
2584             end if;
2585
2586             Comp := First_Entity (E);
2587
2588             while Present (Comp) loop
2589                if Is_Type (Comp) then
2590                   Freeze_And_Append (Comp, Loc, Result);
2591
2592                elsif (Ekind (Comp)) /= E_Function then
2593                   Freeze_And_Append (Etype (Comp), Loc, Result);
2594                end if;
2595
2596                Next_Entity (Comp);
2597             end loop;
2598
2599          --  Private types are required to point to the same freeze node
2600          --  as their corresponding full views. The freeze node itself
2601          --  has to point to the partial view of the entity (because
2602          --  from the partial view, we can retrieve the full view, but
2603          --  not the reverse). However, in order to freeze correctly,
2604          --  we need to freeze the full view. If we are freezing at the
2605          --  end of a scope (or within the scope of the private type),
2606          --  the partial and full views will have been swapped, the
2607          --  full view appears first in the entity chain and the swapping
2608          --  mechanism ensures that the pointers are properly set (on
2609          --  scope exit).
2610
2611          --  If we encounter the partial view before the full view
2612          --  (e.g. when freezing from another scope), we freeze the
2613          --  full view, and then set the pointers appropriately since
2614          --  we cannot rely on swapping to fix things up (subtypes in an
2615          --  outer scope might not get swapped).
2616
2617          elsif Is_Incomplete_Or_Private_Type (E)
2618            and then not Is_Generic_Type (E)
2619          then
2620             --  Case of full view present
2621
2622             if Present (Full_View (E)) then
2623
2624                --  If full view has already been frozen, then no
2625                --  further processing is required
2626
2627                if Is_Frozen (Full_View (E)) then
2628
2629                   Set_Has_Delayed_Freeze (E, False);
2630                   Set_Freeze_Node (E, Empty);
2631                   Check_Debug_Info_Needed (E);
2632
2633                --  Otherwise freeze full view and patch the pointers
2634                --  so that the freeze node will elaborate both views
2635                --  in the back-end.
2636
2637                else
2638                   declare
2639                      Full : constant Entity_Id := Full_View (E);
2640
2641                   begin
2642                      if Is_Private_Type (Full)
2643                        and then Present (Underlying_Full_View (Full))
2644                      then
2645                         Freeze_And_Append
2646                           (Underlying_Full_View (Full), Loc, Result);
2647                      end if;
2648
2649                      Freeze_And_Append (Full, Loc, Result);
2650
2651                      if Has_Delayed_Freeze (E) then
2652                         F_Node := Freeze_Node (Full);
2653
2654                         if Present (F_Node) then
2655                            Set_Freeze_Node (E, F_Node);
2656                            Set_Entity (F_Node, E);
2657
2658                         else
2659                            --  {Incomplete,Private}_Subtypes
2660                            --  with Full_Views constrained by discriminants
2661
2662                            Set_Has_Delayed_Freeze (E, False);
2663                            Set_Freeze_Node (E, Empty);
2664                         end if;
2665                      end if;
2666                   end;
2667
2668                   Check_Debug_Info_Needed (E);
2669                end if;
2670
2671                --  AI-117 requires that the convention of a partial view
2672                --  be the same as the convention of the full view. Note
2673                --  that this is a recognized breach of privacy, but it's
2674                --  essential for logical consistency of representation,
2675                --  and the lack of a rule in RM95 was an oversight.
2676
2677                Set_Convention (E, Convention (Full_View (E)));
2678
2679                Set_Size_Known_At_Compile_Time (E,
2680                  Size_Known_At_Compile_Time (Full_View (E)));
2681
2682                --  Size information is copied from the full view to the
2683                --  incomplete or private view for consistency
2684
2685                --  We skip this is the full view is not a type. This is
2686                --  very strange of course, and can only happen as a result
2687                --  of certain illegalities, such as a premature attempt to
2688                --  derive from an incomplete type.
2689
2690                if Is_Type (Full_View (E)) then
2691                   Set_Size_Info (E, Full_View (E));
2692                   Set_RM_Size   (E, RM_Size (Full_View (E)));
2693                end if;
2694
2695                return Result;
2696
2697             --  Case of no full view present. If entity is derived or subtype,
2698             --  it is safe to freeze, correctness depends on the frozen status
2699             --  of parent. Otherwise it is either premature usage, or a Taft
2700             --  amendment type, so diagnosis is at the point of use and the
2701             --  type might be frozen later.
2702
2703             elsif E /= Base_Type (E)
2704               or else Is_Derived_Type (E)
2705             then
2706                null;
2707
2708             else
2709                Set_Is_Frozen (E, False);
2710                return No_List;
2711             end if;
2712
2713          --  For access subprogram, freeze types of all formals, the return
2714          --  type was already frozen, since it is the Etype of the function.
2715
2716          elsif Ekind (E) = E_Subprogram_Type then
2717             Formal := First_Formal (E);
2718             while Present (Formal) loop
2719                Freeze_And_Append (Etype (Formal), Loc, Result);
2720                Next_Formal (Formal);
2721             end loop;
2722
2723             --  If the return type requires a transient scope, and we are on
2724             --  a target allowing functions to return with a depressed stack
2725             --  pointer, then we mark the function as requiring this treatment.
2726
2727             if Functions_Return_By_DSP_On_Target
2728               and then Requires_Transient_Scope (Etype (E))
2729             then
2730                Set_Function_Returns_With_DSP (E);
2731             end if;
2732
2733             Freeze_Subprogram (E);
2734
2735          --  For access to a protected subprogram, freeze the equivalent
2736          --  type (however this is not set if we are not generating code)
2737          --  or if this is an anonymous type used just for resolution).
2738
2739          elsif Ekind (E) = E_Access_Protected_Subprogram_Type
2740            and then Operating_Mode = Generate_Code
2741            and then Present (Equivalent_Type (E))
2742          then
2743             Freeze_And_Append (Equivalent_Type (E), Loc, Result);
2744          end if;
2745
2746          --  Generic types are never seen by the back-end, and are also not
2747          --  processed by the expander (since the expander is turned off for
2748          --  generic processing), so we never need freeze nodes for them.
2749
2750          if Is_Generic_Type (E) then
2751             return Result;
2752          end if;
2753
2754          --  Some special processing for non-generic types to complete
2755          --  representation details not known till the freeze point.
2756
2757          if Is_Fixed_Point_Type (E) then
2758             Freeze_Fixed_Point_Type (E);
2759
2760             --  Some error checks required for ordinary fixed-point type.
2761             --  Defer these till the freeze-point since we need the small
2762             --  and range values. We only do these checks for base types
2763
2764             if Is_Ordinary_Fixed_Point_Type (E)
2765               and then E = Base_Type (E)
2766             then
2767                if Small_Value (E) < Ureal_2_M_80 then
2768                   Error_Msg_Name_1 := Name_Small;
2769                   Error_Msg_N
2770                     ("`&''%` is too small, minimum is 2.0'*'*(-80)", E);
2771
2772                elsif Small_Value (E) > Ureal_2_80 then
2773                   Error_Msg_Name_1 := Name_Small;
2774                   Error_Msg_N
2775                     ("`&''%` is too large, maximum is 2.0'*'*80", E);
2776                end if;
2777
2778                if Expr_Value_R (Type_Low_Bound (E)) < Ureal_M_10_36 then
2779                   Error_Msg_Name_1 := Name_First;
2780                   Error_Msg_N
2781                     ("`&''%` is too small, minimum is -10.0'*'*36", E);
2782                end if;
2783
2784                if Expr_Value_R (Type_High_Bound (E)) > Ureal_10_36 then
2785                   Error_Msg_Name_1 := Name_Last;
2786                   Error_Msg_N
2787                     ("`&''%` is too large, maximum is 10.0'*'*36", E);
2788                end if;
2789             end if;
2790
2791          elsif Is_Enumeration_Type (E) then
2792             Freeze_Enumeration_Type (E);
2793
2794          elsif Is_Integer_Type (E) then
2795             Adjust_Esize_For_Alignment (E);
2796
2797          elsif Is_Access_Type (E)
2798            and then No (Associated_Storage_Pool (E))
2799          then
2800             Check_Restriction (No_Standard_Storage_Pools, E);
2801          end if;
2802
2803          --  If the current entity is an array or record subtype and has
2804          --  discriminants used to constrain it, it must not freeze, because
2805          --  Freeze_Entity nodes force Gigi to process the frozen type.
2806
2807          if Is_Composite_Type (E) then
2808
2809             if Is_Array_Type (E) then
2810                declare
2811                   Index : Node_Id := First_Index (E);
2812                   Expr1 : Node_Id;
2813                   Expr2 : Node_Id;
2814
2815                begin
2816                   while Present (Index) loop
2817                      if Etype (Index) /= Any_Type then
2818                         Get_Index_Bounds (Index, Expr1, Expr2);
2819
2820                         for J in 1 .. 2 loop
2821                            if Nkind (Expr1) = N_Identifier
2822                              and then Ekind (Entity (Expr1)) = E_Discriminant
2823                            then
2824                               Set_Has_Delayed_Freeze (E, False);
2825                               Set_Freeze_Node (E, Empty);
2826                               Check_Debug_Info_Needed (E);
2827                               return Result;
2828                            end if;
2829
2830                            Expr1 := Expr2;
2831                         end loop;
2832                      end if;
2833
2834                      Next_Index (Index);
2835                   end loop;
2836                end;
2837
2838             elsif Has_Discriminants (E)
2839               and Is_Constrained (E)
2840             then
2841                declare
2842                   Constraint : Elmt_Id;
2843                   Expr       : Node_Id;
2844
2845                begin
2846                   Constraint := First_Elmt (Discriminant_Constraint (E));
2847                   while Present (Constraint) loop
2848                      Expr := Node (Constraint);
2849                      if Nkind (Expr) = N_Identifier
2850                        and then Ekind (Entity (Expr)) = E_Discriminant
2851                      then
2852                         Set_Has_Delayed_Freeze (E, False);
2853                         Set_Freeze_Node (E, Empty);
2854                         Check_Debug_Info_Needed (E);
2855                         return Result;
2856                      end if;
2857
2858                      Next_Elmt (Constraint);
2859                   end loop;
2860                end;
2861             end if;
2862
2863             --  AI-117 requires that all new primitives of a tagged type
2864             --  must inherit the convention of the full view of the type.
2865             --  Inherited and overriding operations are defined to inherit
2866             --  the convention of their parent or overridden subprogram
2867             --  (also specified in AI-117), and that will have occurred
2868             --  earlier (in Derive_Subprogram and New_Overloaded_Entity).
2869             --  Here we set the convention of primitives that are still
2870             --  convention Ada, which will ensure that any new primitives
2871             --  inherit the type's convention. Class-wide types can have
2872             --  a foreign convention inherited from their specific type,
2873             --  but are excluded from this since they don't have any
2874             --  associated primitives.
2875
2876             if Is_Tagged_Type (E)
2877               and then not Is_Class_Wide_Type (E)
2878               and then Convention (E) /= Convention_Ada
2879             then
2880                declare
2881                   Prim_List : constant Elist_Id := Primitive_Operations (E);
2882                   Prim      : Elmt_Id;
2883                begin
2884                   Prim := First_Elmt (Prim_List);
2885                   while Present (Prim) loop
2886                      if Convention (Node (Prim)) = Convention_Ada then
2887                         Set_Convention (Node (Prim), Convention (E));
2888                      end if;
2889
2890                      Next_Elmt (Prim);
2891                   end loop;
2892                end;
2893             end if;
2894          end if;
2895
2896          --  Generate primitive operation references for a tagged type
2897
2898          if Is_Tagged_Type (E)
2899            and then not Is_Class_Wide_Type (E)
2900          then
2901             declare
2902                Prim_List : constant Elist_Id := Primitive_Operations (E);
2903                Prim      : Elmt_Id;
2904                Ent       : Entity_Id;
2905
2906             begin
2907                Prim := First_Elmt (Prim_List);
2908                while Present (Prim) loop
2909                   Ent := Node (Prim);
2910
2911                   --  If the operation is derived, get the original for
2912                   --  cross-reference purposes (it is the original for
2913                   --  which we want the xref, and for which the comes
2914                   --  from source test needs to be performed).
2915
2916                   while Present (Alias (Ent)) loop
2917                      Ent := Alias (Ent);
2918                   end loop;
2919
2920                   Generate_Reference (E, Ent, 'p', Set_Ref => False);
2921                   Next_Elmt (Prim);
2922                end loop;
2923
2924             --  If we get an exception, then something peculiar has happened
2925             --  probably as a result of a previous error. Since this is only
2926             --  for non-critical cross-references, ignore the error.
2927
2928             exception
2929                when others => null;
2930             end;
2931          end if;
2932
2933          --  Now that all types from which E may depend are frozen, see
2934          --  if the size is known at compile time, if it must be unsigned,
2935          --  or if strict alignent is required
2936
2937          Check_Compile_Time_Size (E);
2938          Check_Unsigned_Type (E);
2939
2940          if Base_Type (E) = E then
2941             Check_Strict_Alignment (E);
2942          end if;
2943
2944          --  Do not allow a size clause for a type which does not have a size
2945          --  that is known at compile time
2946
2947          if Has_Size_Clause (E)
2948            and then not Size_Known_At_Compile_Time (E)
2949          then
2950             --  Supress this message if errors posted on E, even if we are
2951             --  in all errors mode, since this is often a junk message
2952
2953             if not Error_Posted (E) then
2954                Error_Msg_N
2955                  ("size clause not allowed for variable length type",
2956                   Size_Clause (E));
2957             end if;
2958          end if;
2959
2960          --  Remaining process is to set/verify the representation information,
2961          --  in particular the size and alignment values. This processing is
2962          --  not required for generic types, since generic types do not play
2963          --  any part in code generation, and so the size and alignment values
2964          --  for suhc types are irrelevant.
2965
2966          if Is_Generic_Type (E) then
2967             return Result;
2968
2969          --  Otherwise we call the layout procedure
2970
2971          else
2972             Layout_Type (E);
2973          end if;
2974
2975          --  End of freeze processing for type entities
2976       end if;
2977
2978       --  Here is where we logically freeze the current entity. If it has a
2979       --  freeze node, then this is the point at which the freeze node is
2980       --  linked into the result list.
2981
2982       if Has_Delayed_Freeze (E) then
2983
2984          --  If a freeze node is already allocated, use it, otherwise allocate
2985          --  a new one. The preallocation happens in the case of anonymous base
2986          --  types, where we preallocate so that we can set First_Subtype_Link.
2987          --  Note that we reset the Sloc to the current freeze location.
2988
2989          if Present (Freeze_Node (E)) then
2990             F_Node := Freeze_Node (E);
2991             Set_Sloc (F_Node, Loc);
2992
2993          else
2994             F_Node := New_Node (N_Freeze_Entity, Loc);
2995             Set_Freeze_Node (E, F_Node);
2996             Set_Access_Types_To_Process (F_Node, No_Elist);
2997             Set_TSS_Elist (F_Node, No_Elist);
2998             Set_Actions (F_Node, No_List);
2999          end if;
3000
3001          Set_Entity (F_Node, E);
3002
3003          if Result = No_List then
3004             Result := New_List (F_Node);
3005          else
3006             Append (F_Node, Result);
3007          end if;
3008       end if;
3009
3010       --  When a type is frozen, the first subtype of the type is frozen as
3011       --  well (RM 13.14(15)). This has to be done after freezing the type,
3012       --  since obviously the first subtype depends on its own base type.
3013
3014       if Is_Type (E) then
3015          Freeze_And_Append (First_Subtype (E), Loc, Result);
3016
3017          --  If we just froze a tagged non-class wide record, then freeze the
3018          --  corresponding class-wide type. This must be done after the tagged
3019          --  type itself is frozen, because the class-wide type refers to the
3020          --  tagged type which generates the class.
3021
3022          if Is_Tagged_Type (E)
3023            and then not Is_Class_Wide_Type (E)
3024            and then Present (Class_Wide_Type (E))
3025          then
3026             Freeze_And_Append (Class_Wide_Type (E), Loc, Result);
3027          end if;
3028       end if;
3029
3030       Check_Debug_Info_Needed (E);
3031
3032       --  Special handling for subprograms
3033
3034       if Is_Subprogram (E) then
3035
3036          --  If subprogram has address clause then reset Is_Public flag, since
3037          --  we do not want the backend to generate external references.
3038
3039          if Present (Address_Clause (E))
3040            and then not Is_Library_Level_Entity (E)
3041          then
3042             Set_Is_Public (E, False);
3043
3044          --  If no address clause and not intrinsic, then for imported
3045          --  subprogram in main unit, generate descriptor if we are in
3046          --  Propagate_Exceptions mode.
3047
3048          elsif Propagate_Exceptions
3049            and then Is_Imported (E)
3050            and then not Is_Intrinsic_Subprogram (E)
3051            and then Convention (E) /= Convention_Stubbed
3052          then
3053             if Result = No_List then
3054                Result := Empty_List;
3055             end if;
3056
3057             Generate_Subprogram_Descriptor_For_Imported_Subprogram
3058               (E, Result);
3059          end if;
3060       end if;
3061
3062       return Result;
3063    end Freeze_Entity;
3064
3065    -----------------------------
3066    -- Freeze_Enumeration_Type --
3067    -----------------------------
3068
3069    procedure Freeze_Enumeration_Type (Typ : Entity_Id) is
3070    begin
3071       if Has_Foreign_Convention (Typ)
3072         and then not Has_Size_Clause (Typ)
3073         and then Esize (Typ) < Standard_Integer_Size
3074       then
3075          Init_Esize (Typ, Standard_Integer_Size);
3076       else
3077          Adjust_Esize_For_Alignment (Typ);
3078       end if;
3079    end Freeze_Enumeration_Type;
3080
3081    -----------------------
3082    -- Freeze_Expression --
3083    -----------------------
3084
3085    procedure Freeze_Expression (N : Node_Id) is
3086       In_Def_Exp : constant Boolean := In_Default_Expression;
3087       Typ        : Entity_Id;
3088       Nam        : Entity_Id;
3089       Desig_Typ  : Entity_Id;
3090       P          : Node_Id;
3091       Parent_P   : Node_Id;
3092
3093       Freeze_Outside : Boolean := False;
3094       --  This flag is set true if the entity must be frozen outside the
3095       --  current subprogram. This happens in the case of expander generated
3096       --  subprograms (_Init_Proc, _Input, _Output, _Read, _Write) which do
3097       --  not freeze all entities like other bodies, but which nevertheless
3098       --  may reference entities that have to be frozen before the body and
3099       --  obviously cannot be frozen inside the body.
3100
3101       function In_Exp_Body (N : Node_Id) return Boolean;
3102       --  Given an N_Handled_Sequence_Of_Statements node N, determines whether
3103       --  it is the handled statement sequence of an expander generated
3104       --  subprogram (init proc, or stream subprogram). If so, it returns
3105       --  True, otherwise False.
3106
3107       -----------------
3108       -- In_Exp_Body --
3109       -----------------
3110
3111       function In_Exp_Body (N : Node_Id) return Boolean is
3112          P : Node_Id;
3113
3114       begin
3115          if Nkind (N) = N_Subprogram_Body then
3116             P := N;
3117          else
3118             P := Parent (N);
3119          end if;
3120
3121          if Nkind (P) /= N_Subprogram_Body then
3122             return False;
3123
3124          else
3125             P := Defining_Unit_Name (Specification (P));
3126
3127             if Nkind (P) = N_Defining_Identifier
3128               and then (Is_Init_Proc (P)              or else
3129                         Is_TSS (P, TSS_Stream_Input)  or else
3130                         Is_TSS (P, TSS_Stream_Output) or else
3131                         Is_TSS (P, TSS_Stream_Read)   or else
3132                         Is_TSS (P, TSS_Stream_Write))
3133             then
3134                return True;
3135             else
3136                return False;
3137             end if;
3138          end if;
3139       end In_Exp_Body;
3140
3141    --  Start of processing for Freeze_Expression
3142
3143    begin
3144       --  Immediate return if freezing is inhibited. This flag is set by
3145       --  the analyzer to stop freezing on generated expressions that would
3146       --  cause freezing if they were in the source program, but which are
3147       --  not supposed to freeze, since they are created.
3148
3149       if Must_Not_Freeze (N) then
3150          return;
3151       end if;
3152
3153       --  If expression is non-static, then it does not freeze in a default
3154       --  expression, see section "Handling of Default Expressions" in the
3155       --  spec of package Sem for further details. Note that we have to
3156       --  make sure that we actually have a real expression (if we have
3157       --  a subtype indication, we can't test Is_Static_Expression!)
3158
3159       if In_Def_Exp
3160         and then Nkind (N) in N_Subexpr
3161         and then not Is_Static_Expression (N)
3162       then
3163          return;
3164       end if;
3165
3166       --  Freeze type of expression if not frozen already
3167
3168       Typ := Empty;
3169
3170       if Nkind (N) in N_Has_Etype then
3171          if not Is_Frozen (Etype (N)) then
3172             Typ := Etype (N);
3173
3174          --  Base type may be an derived numeric type that is frozen at
3175          --  the point of declaration, but first_subtype is still unfrozen.
3176
3177          elsif not Is_Frozen (First_Subtype (Etype (N))) then
3178             Typ := First_Subtype (Etype (N));
3179          end if;
3180       end if;
3181
3182       --  For entity name, freeze entity if not frozen already. A special
3183       --  exception occurs for an identifier that did not come from source.
3184       --  We don't let such identifiers freeze a non-internal entity, i.e.
3185       --  an entity that did come from source, since such an identifier was
3186       --  generated by the expander, and cannot have any semantic effect on
3187       --  the freezing semantics. For example, this stops the parameter of
3188       --  an initialization procedure from freezing the variable.
3189
3190       if Is_Entity_Name (N)
3191         and then not Is_Frozen (Entity (N))
3192         and then (Nkind (N) /= N_Identifier
3193                    or else Comes_From_Source (N)
3194                    or else not Comes_From_Source (Entity (N)))
3195       then
3196          Nam := Entity (N);
3197       else
3198          Nam := Empty;
3199       end if;
3200
3201       --  For an allocator freeze designated type if not frozen already.
3202
3203       --  For an aggregate whose component type is an access type, freeze
3204       --  the designated type now, so that its freeze  does not appear within
3205       --  the loop that might be created in the expansion of the aggregate.
3206       --  If the designated type is a private type without full view, the
3207       --  expression cannot contain an allocator, so the type is not frozen.
3208
3209       Desig_Typ := Empty;
3210
3211       case Nkind (N) is
3212          when N_Allocator =>
3213             Desig_Typ := Designated_Type (Etype (N));
3214
3215          when N_Aggregate =>
3216             if Is_Array_Type (Etype (N))
3217               and then Is_Access_Type (Component_Type (Etype (N)))
3218             then
3219                Desig_Typ := Designated_Type (Component_Type (Etype (N)));
3220             end if;
3221
3222          when N_Selected_Component |
3223             N_Indexed_Component    |
3224             N_Slice                =>
3225
3226             if Is_Access_Type (Etype (Prefix (N))) then
3227                Desig_Typ := Designated_Type (Etype (Prefix (N)));
3228             end if;
3229
3230          when others =>
3231             null;
3232       end case;
3233
3234       if Desig_Typ /= Empty
3235         and then (Is_Frozen (Desig_Typ)
3236                    or else (not Is_Fully_Defined (Desig_Typ)))
3237       then
3238          Desig_Typ := Empty;
3239       end if;
3240
3241       --  All done if nothing needs freezing
3242
3243       if No (Typ)
3244         and then No (Nam)
3245         and then No (Desig_Typ)
3246       then
3247          return;
3248       end if;
3249
3250       --  Loop for looking at the right place to insert the freeze nodes
3251       --  exiting from the loop when it is appropriate to insert the freeze
3252       --  node before the current node P.
3253
3254       --  Also checks some special exceptions to the freezing rules. These
3255       --  cases result in a direct return, bypassing the freeze action.
3256
3257       P := N;
3258       loop
3259          Parent_P := Parent (P);
3260
3261          --  If we don't have a parent, then we are not in a well-formed
3262          --  tree. This is an unusual case, but there are some legitimate
3263          --  situations in which this occurs, notably when the expressions
3264          --  in the range of a type declaration are resolved. We simply
3265          --  ignore the freeze request in this case. Is this right ???
3266
3267          if No (Parent_P) then
3268             return;
3269          end if;
3270
3271          --  See if we have got to an appropriate point in the tree
3272
3273          case Nkind (Parent_P) is
3274
3275             --  A special test for the exception of (RM 13.14(8)) for the
3276             --  case of per-object expressions (RM 3.8(18)) occurring in a
3277             --  component definition or a discrete subtype definition. Note
3278             --  that we test for a component declaration which includes both
3279             --  cases we are interested in, and furthermore the tree does not
3280             --  have explicit nodes for either of these two constructs.
3281
3282             when N_Component_Declaration =>
3283
3284                --  The case we want to test for here is an identifier that is
3285                --  a per-object expression, this is either a discriminant that
3286                --  appears in a context other than the component declaration
3287                --  or it is a reference to the type of the enclosing construct.
3288
3289                --  For either of these cases, we skip the freezing
3290
3291                if not In_Default_Expression
3292                  and then Nkind (N) = N_Identifier
3293                  and then (Present (Entity (N)))
3294                then
3295                   --  We recognize the discriminant case by just looking for
3296                   --  a reference to a discriminant. It can only be one for
3297                   --  the enclosing construct. Skip freezing in this case.
3298
3299                   if Ekind (Entity (N)) = E_Discriminant then
3300                      return;
3301
3302                   --  For the case of a reference to the enclosing record,
3303                   --  (or task or protected type), we look for a type that
3304                   --  matches the current scope.
3305
3306                   elsif Entity (N) = Current_Scope then
3307                      return;
3308                   end if;
3309                end if;
3310
3311             --  If we have an enumeration literal that appears as the
3312             --  choice in the aggregate of an enumeration representation
3313             --  clause, then freezing does not occur (RM 13.14(10)).
3314
3315             when N_Enumeration_Representation_Clause =>
3316
3317                --  The case we are looking for is an enumeration literal
3318
3319                if (Nkind (N) = N_Identifier or Nkind (N) = N_Character_Literal)
3320                  and then Is_Enumeration_Type (Etype (N))
3321                then
3322                   --  If enumeration literal appears directly as the choice,
3323                   --  do not freeze (this is the normal non-overloade case)
3324
3325                   if Nkind (Parent (N)) = N_Component_Association
3326                     and then First (Choices (Parent (N))) = N
3327                   then
3328                      return;
3329
3330                   --  If enumeration literal appears as the name of a
3331                   --  function which is the choice, then also do not freeze.
3332                   --  This happens in the overloaded literal case, where the
3333                   --  enumeration literal is temporarily changed to a function
3334                   --  call for overloading analysis purposes.
3335
3336                   elsif Nkind (Parent (N)) = N_Function_Call
3337                      and then
3338                        Nkind (Parent (Parent (N))) = N_Component_Association
3339                      and then
3340                        First (Choices (Parent (Parent (N)))) = Parent (N)
3341                   then
3342                      return;
3343                   end if;
3344                end if;
3345
3346             --  Normally if the parent is a handled sequence of statements,
3347             --  then the current node must be a statement, and that is an
3348             --  appropriate place to insert a freeze node.
3349
3350             when N_Handled_Sequence_Of_Statements =>
3351
3352                --  An exception occurs when the sequence of statements is
3353                --  for an expander generated body that did not do the usual
3354                --  freeze all operation. In this case we usually want to
3355                --  freeze outside this body, not inside it, and we skip
3356                --  past the subprogram body that we are inside.
3357
3358                if In_Exp_Body (Parent_P) then
3359
3360                   --  However, we *do* want to freeze at this point if we have
3361                   --  an entity to freeze, and that entity is declared *inside*
3362                   --  the body of the expander generated procedure. This case
3363                   --  is recognized by the scope of the type, which is either
3364                   --  the spec for some enclosing body, or (in the case of
3365                   --  init_procs, for which there are no separate specs) the
3366                   --  current scope.
3367
3368                   declare
3369                      Subp : constant Node_Id := Parent (Parent_P);
3370                      Cspc : Entity_Id;
3371
3372                   begin
3373                      if Nkind (Subp) = N_Subprogram_Body then
3374                         Cspc := Corresponding_Spec (Subp);
3375
3376                         if (Present (Typ) and then Scope (Typ) = Cspc)
3377                              or else
3378                            (Present (Nam) and then Scope (Nam) = Cspc)
3379                         then
3380                            exit;
3381
3382                         elsif Present (Typ)
3383                           and then Scope (Typ) = Current_Scope
3384                           and then Current_Scope = Defining_Entity (Subp)
3385                         then
3386                            exit;
3387                         end if;
3388                      end if;
3389                   end;
3390
3391                   --  If not that exception to the exception, then this is
3392                   --  where we delay the freeze till outside the body.
3393
3394                   Parent_P := Parent (Parent_P);
3395                   Freeze_Outside := True;
3396
3397                --  Here if normal case where we are in handled statement
3398                --  sequence and want to do the insertion right there.
3399
3400                else
3401                   exit;
3402                end if;
3403
3404             --  If parent is a body or a spec or a block, then the current
3405             --  node is a statement or declaration and we can insert the
3406             --  freeze node before it.
3407
3408             when N_Package_Specification |
3409                  N_Package_Body          |
3410                  N_Subprogram_Body       |
3411                  N_Task_Body             |
3412                  N_Protected_Body        |
3413                  N_Entry_Body            |
3414                  N_Block_Statement       => exit;
3415
3416             --  The expander is allowed to define types in any statements list,
3417             --  so any of the following parent nodes also mark a freezing point
3418             --  if the actual node is in a list of statements or declarations.
3419
3420             when N_Exception_Handler          |
3421                  N_If_Statement               |
3422                  N_Elsif_Part                 |
3423                  N_Case_Statement_Alternative |
3424                  N_Compilation_Unit_Aux       |
3425                  N_Selective_Accept           |
3426                  N_Accept_Alternative         |
3427                  N_Delay_Alternative          |
3428                  N_Conditional_Entry_Call     |
3429                  N_Entry_Call_Alternative     |
3430                  N_Triggering_Alternative     |
3431                  N_Abortable_Part             |
3432                  N_Freeze_Entity              =>
3433
3434                exit when Is_List_Member (P);
3435
3436             --  Note: The N_Loop_Statement is a special case. A type that
3437             --  appears in the source can never be frozen in a loop (this
3438             --  occurs only because of a loop expanded by the expander),
3439             --  so we keep on going. Otherwise we terminate the search.
3440             --  Same is true of any entity which comes from source. (if they
3441             --  have a predefined type, that type does not appear to come
3442             --  from source, but the entity should not be frozen here).
3443
3444             when N_Loop_Statement =>
3445                exit when not Comes_From_Source (Etype (N))
3446                  and then (No (Nam) or else not Comes_From_Source (Nam));
3447
3448             --  For all other cases, keep looking at parents
3449
3450             when others =>
3451                null;
3452          end case;
3453
3454          --  We fall through the case if we did not yet find the proper
3455          --  place in the free for inserting the freeze node, so climb!
3456
3457          P := Parent_P;
3458       end loop;
3459
3460       --  If the expression appears in a record or an initialization
3461       --  procedure, the freeze nodes are collected and attached to
3462       --  the current scope, to be inserted and analyzed on exit from
3463       --  the scope, to insure that generated entities appear in the
3464       --  correct scope. If the expression is a default for a discriminant
3465       --  specification, the scope is still void. The expression can also
3466       --  appear in the discriminant part of a private or concurrent type.
3467
3468       --  The other case requiring this special handling is if we are in
3469       --  a default expression, since in that case we are about to freeze
3470       --  a static type, and the freeze scope needs to be the outer scope,
3471       --  not the scope of the subprogram with the default parameter.
3472
3473       --  For default expressions in generic units, the Move_Freeze_Nodes
3474       --  mechanism (see sem_ch12.adb) takes care of placing them at the
3475       --  proper place, after the generic unit.
3476
3477       if (In_Def_Exp and not Inside_A_Generic)
3478         or else Freeze_Outside
3479         or else (Is_Type (Current_Scope)
3480                   and then (not Is_Concurrent_Type (Current_Scope)
3481                              or else not Has_Completion (Current_Scope)))
3482         or else Ekind (Current_Scope) = E_Void
3483       then
3484          declare
3485             Loc          : constant Source_Ptr := Sloc (Current_Scope);
3486             Freeze_Nodes : List_Id := No_List;
3487
3488          begin
3489             if Present (Desig_Typ) then
3490                Freeze_And_Append (Desig_Typ, Loc, Freeze_Nodes);
3491             end if;
3492
3493             if Present (Typ) then
3494                Freeze_And_Append (Typ, Loc, Freeze_Nodes);
3495             end if;
3496
3497             if Present (Nam) then
3498                Freeze_And_Append (Nam, Loc, Freeze_Nodes);
3499             end if;
3500
3501             if Is_Non_Empty_List (Freeze_Nodes) then
3502                if No (Scope_Stack.Table
3503                  (Scope_Stack.Last).Pending_Freeze_Actions)
3504                then
3505                   Scope_Stack.Table
3506                     (Scope_Stack.Last).Pending_Freeze_Actions :=
3507                       Freeze_Nodes;
3508                else
3509                   Append_List (Freeze_Nodes, Scope_Stack.Table
3510                                    (Scope_Stack.Last).Pending_Freeze_Actions);
3511                end if;
3512             end if;
3513          end;
3514
3515          return;
3516       end if;
3517
3518       --  Now we have the right place to do the freezing. First, a special
3519       --  adjustment, if we are in default expression analysis mode, these
3520       --  freeze actions must not be thrown away (normally all inserted
3521       --  actions are thrown away in this mode. However, the freeze actions
3522       --  are from static expressions and one of the important reasons we
3523       --  are doing this special analysis is to get these freeze actions.
3524       --  Therefore we turn off the In_Default_Expression mode to propagate
3525       --  these freeze actions. This also means they get properly analyzed
3526       --  and expanded.
3527
3528       In_Default_Expression := False;
3529
3530       --  Freeze the designated type of an allocator (RM 13.14(13))
3531
3532       if Present (Desig_Typ) then
3533          Freeze_Before (P, Desig_Typ);
3534       end if;
3535
3536       --  Freeze type of expression (RM 13.14(10)). Note that we took care of
3537       --  the enumeration representation clause exception in the loop above.
3538
3539       if Present (Typ) then
3540          Freeze_Before (P, Typ);
3541       end if;
3542
3543       --  Freeze name if one is present (RM 13.14(11))
3544
3545       if Present (Nam) then
3546          Freeze_Before (P, Nam);
3547       end if;
3548
3549       In_Default_Expression := In_Def_Exp;
3550    end Freeze_Expression;
3551
3552    -----------------------------
3553    -- Freeze_Fixed_Point_Type --
3554    -----------------------------
3555
3556    --  Certain fixed-point types and subtypes, including implicit base
3557    --  types and declared first subtypes, have not yet set up a range.
3558    --  This is because the range cannot be set until the Small and Size
3559    --  values are known, and these are not known till the type is frozen.
3560
3561    --  To signal this case, Scalar_Range contains an unanalyzed syntactic
3562    --  range whose bounds are unanalyzed real literals. This routine will
3563    --  recognize this case, and transform this range node into a properly
3564    --  typed range with properly analyzed and resolved values.
3565
3566    procedure Freeze_Fixed_Point_Type (Typ : Entity_Id) is
3567       Rng   : constant Node_Id    := Scalar_Range (Typ);
3568       Lo    : constant Node_Id    := Low_Bound (Rng);
3569       Hi    : constant Node_Id    := High_Bound (Rng);
3570       Btyp  : constant Entity_Id  := Base_Type (Typ);
3571       Brng  : constant Node_Id    := Scalar_Range (Btyp);
3572       BLo   : constant Node_Id    := Low_Bound (Brng);
3573       BHi   : constant Node_Id    := High_Bound (Brng);
3574       Small : constant Ureal      := Small_Value (Typ);
3575       Loval : Ureal;
3576       Hival : Ureal;
3577       Atype : Entity_Id;
3578
3579       Actual_Size : Nat;
3580
3581       function Fsize (Lov, Hiv : Ureal) return Nat;
3582       --  Returns size of type with given bounds. Also leaves these
3583       --  bounds set as the current bounds of the Typ.
3584
3585       function Fsize (Lov, Hiv : Ureal) return Nat is
3586       begin
3587          Set_Realval (Lo, Lov);
3588          Set_Realval (Hi, Hiv);
3589          return Minimum_Size (Typ);
3590       end Fsize;
3591
3592    --  Start of processing for Freeze_Fixed_Point_Type;
3593
3594    begin
3595       --  If Esize of a subtype has not previously been set, set it now
3596
3597       if Unknown_Esize (Typ) then
3598          Atype := Ancestor_Subtype (Typ);
3599
3600          if Present (Atype) then
3601             Set_Esize (Typ, Esize (Atype));
3602          else
3603             Set_Esize (Typ, Esize (Base_Type (Typ)));
3604          end if;
3605       end if;
3606
3607       --  Immediate return if the range is already analyzed. This means
3608       --  that the range is already set, and does not need to be computed
3609       --  by this routine.
3610
3611       if Analyzed (Rng) then
3612          return;
3613       end if;
3614
3615       --  Immediate return if either of the bounds raises Constraint_Error
3616
3617       if Raises_Constraint_Error (Lo)
3618         or else Raises_Constraint_Error (Hi)
3619       then
3620          return;
3621       end if;
3622
3623       Loval := Realval (Lo);
3624       Hival := Realval (Hi);
3625
3626       --  Ordinary fixed-point case
3627
3628       if Is_Ordinary_Fixed_Point_Type (Typ) then
3629
3630          --  For the ordinary fixed-point case, we are allowed to fudge the
3631          --  end-points up or down by small. Generally we prefer to fudge
3632          --  up, i.e. widen the bounds for non-model numbers so that the
3633          --  end points are included. However there are cases in which this
3634          --  cannot be done, and indeed cases in which we may need to narrow
3635          --  the bounds. The following circuit makes the decision.
3636
3637          --  Note: our terminology here is that Incl_EP means that the
3638          --  bounds are widened by Small if necessary to include the end
3639          --  points, and Excl_EP means that the bounds are narrowed by
3640          --  Small to exclude the end-points if this reduces the size.
3641
3642          --  Note that in the Incl case, all we care about is including the
3643          --  end-points. In the Excl case, we want to narrow the bounds as
3644          --  much as permitted by the RM, to give the smallest possible size.
3645
3646          Fudge : declare
3647             Loval_Incl_EP : Ureal;
3648             Hival_Incl_EP : Ureal;
3649
3650             Loval_Excl_EP : Ureal;
3651             Hival_Excl_EP : Ureal;
3652
3653             Size_Incl_EP  : Nat;
3654             Size_Excl_EP  : Nat;
3655
3656             Model_Num     : Ureal;
3657             First_Subt    : Entity_Id;
3658             Actual_Lo     : Ureal;
3659             Actual_Hi     : Ureal;
3660
3661          begin
3662             --  First step. Base types are required to be symmetrical. Right
3663             --  now, the base type range is a copy of the first subtype range.
3664             --  This will be corrected before we are done, but right away we
3665             --  need to deal with the case where both bounds are non-negative.
3666             --  In this case, we set the low bound to the negative of the high
3667             --  bound, to make sure that the size is computed to include the
3668             --  required sign. Note that we do not need to worry about the
3669             --  case of both bounds negative, because the sign will be dealt
3670             --  with anyway. Furthermore we can't just go making such a bound
3671             --  symmetrical, since in a twos-complement system, there is an
3672             --  extra negative value which could not be accomodated on the
3673             --  positive side.
3674
3675             if Typ = Btyp
3676               and then not UR_Is_Negative (Loval)
3677               and then Hival > Loval
3678             then
3679                Loval := -Hival;
3680                Set_Realval (Lo, Loval);
3681             end if;
3682
3683             --  Compute the fudged bounds. If the number is a model number,
3684             --  then we do nothing to include it, but we are allowed to
3685             --  backoff to the next adjacent model number when we exclude
3686             --  it. If it is not a model number then we straddle the two
3687             --  values with the model numbers on either side.
3688
3689             Model_Num := UR_Trunc (Loval / Small) * Small;
3690
3691             if Loval = Model_Num then
3692                Loval_Incl_EP := Model_Num;
3693             else
3694                Loval_Incl_EP := Model_Num - Small;
3695             end if;
3696
3697             --  The low value excluding the end point is Small greater, but
3698             --  we do not do this exclusion if the low value is positive,
3699             --  since it can't help the size and could actually hurt by
3700             --  crossing the high bound.
3701
3702             if UR_Is_Negative (Loval_Incl_EP) then
3703                Loval_Excl_EP := Loval_Incl_EP + Small;
3704             else
3705                Loval_Excl_EP := Loval_Incl_EP;
3706             end if;
3707
3708             --  Similar processing for upper bound and high value
3709
3710             Model_Num := UR_Trunc (Hival / Small) * Small;
3711
3712             if Hival = Model_Num then
3713                Hival_Incl_EP := Model_Num;
3714             else
3715                Hival_Incl_EP := Model_Num + Small;
3716             end if;
3717
3718             if UR_Is_Positive (Hival_Incl_EP) then
3719                Hival_Excl_EP := Hival_Incl_EP - Small;
3720             else
3721                Hival_Excl_EP := Hival_Incl_EP;
3722             end if;
3723
3724             --  One further adjustment is needed. In the case of subtypes,
3725             --  we cannot go outside the range of the base type, or we get
3726             --  peculiarities, and the base type range is already set. This
3727             --  only applies to the Incl values, since clearly the Excl
3728             --  values are already as restricted as they are allowed to be.
3729
3730             if Typ /= Btyp then
3731                Loval_Incl_EP := UR_Max (Loval_Incl_EP, Realval (BLo));
3732                Hival_Incl_EP := UR_Min (Hival_Incl_EP, Realval (BHi));
3733             end if;
3734
3735             --  Get size including and excluding end points
3736
3737             Size_Incl_EP := Fsize (Loval_Incl_EP, Hival_Incl_EP);
3738             Size_Excl_EP := Fsize (Loval_Excl_EP, Hival_Excl_EP);
3739
3740             --  No need to exclude end-points if it does not reduce size
3741
3742             if Fsize (Loval_Incl_EP, Hival_Excl_EP) = Size_Excl_EP then
3743                Loval_Excl_EP := Loval_Incl_EP;
3744             end if;
3745
3746             if Fsize (Loval_Excl_EP, Hival_Incl_EP) = Size_Excl_EP then
3747                Hival_Excl_EP := Hival_Incl_EP;
3748             end if;
3749
3750             --  Now we set the actual size to be used. We want to use the
3751             --  bounds fudged up to include the end-points but only if this
3752             --  can be done without violating a specifically given size
3753             --  size clause or causing an unacceptable increase in size.
3754
3755             --  Case of size clause given
3756
3757             if Has_Size_Clause (Typ) then
3758
3759                --  Use the inclusive size only if it is consistent with
3760                --  the explicitly specified size.
3761
3762                if Size_Incl_EP <= RM_Size (Typ) then
3763                   Actual_Lo   := Loval_Incl_EP;
3764                   Actual_Hi   := Hival_Incl_EP;
3765                   Actual_Size := Size_Incl_EP;
3766
3767                --  If the inclusive size is too large, we try excluding
3768                --  the end-points (will be caught later if does not work).
3769
3770                else
3771                   Actual_Lo   := Loval_Excl_EP;
3772                   Actual_Hi   := Hival_Excl_EP;
3773                   Actual_Size := Size_Excl_EP;
3774                end if;
3775
3776             --  Case of size clause not given
3777
3778             else
3779                --  If we have a base type whose corresponding first subtype
3780                --  has an explicit size that is large enough to include our
3781                --  end-points, then do so. There is no point in working hard
3782                --  to get a base type whose size is smaller than the specified
3783                --  size of the first subtype.
3784
3785                First_Subt := First_Subtype (Typ);
3786
3787                if Has_Size_Clause (First_Subt)
3788                  and then Size_Incl_EP <= Esize (First_Subt)
3789                then
3790                   Actual_Size := Size_Incl_EP;
3791                   Actual_Lo   := Loval_Incl_EP;
3792                   Actual_Hi   := Hival_Incl_EP;
3793
3794                --  If excluding the end-points makes the size smaller and
3795                --  results in a size of 8,16,32,64, then we take the smaller
3796                --  size. For the 64 case, this is compulsory. For the other
3797                --  cases, it seems reasonable. We like to include end points
3798                --  if we can, but not at the expense of moving to the next
3799                --  natural boundary of size.
3800
3801                elsif Size_Incl_EP /= Size_Excl_EP
3802                  and then
3803                     (Size_Excl_EP = 8  or else
3804                      Size_Excl_EP = 16 or else
3805                      Size_Excl_EP = 32 or else
3806                      Size_Excl_EP = 64)
3807                then
3808                   Actual_Size := Size_Excl_EP;
3809                   Actual_Lo   := Loval_Excl_EP;
3810                   Actual_Hi   := Hival_Excl_EP;
3811
3812                --  Otherwise we can definitely include the end points
3813
3814                else
3815                   Actual_Size := Size_Incl_EP;
3816                   Actual_Lo   := Loval_Incl_EP;
3817                   Actual_Hi   := Hival_Incl_EP;
3818                end if;
3819
3820                --  One pathological case: normally we never fudge a low
3821                --  bound down, since it would seem to increase the size
3822                --  (if it has any effect), but for ranges containing a
3823                --  single value, or no values, the high bound can be
3824                --  small too large. Consider:
3825
3826                --    type t is delta 2.0**(-14)
3827                --      range 131072.0 .. 0;
3828
3829                --  That lower bound is *just* outside the range of 32
3830                --  bits, and does need fudging down in this case. Note
3831                --  that the bounds will always have crossed here, since
3832                --  the high bound will be fudged down if necessary, as
3833                --  in the case of:
3834
3835                --    type t is delta 2.0**(-14)
3836                --      range 131072.0 .. 131072.0;
3837
3838                --  So we can detect the situation by looking for crossed
3839                --  bounds, and if the bounds are crossed, and the low
3840                --  bound is greater than zero, we will always back it
3841                --  off by small, since this is completely harmless.
3842
3843                if Actual_Lo > Actual_Hi then
3844                   if UR_Is_Positive (Actual_Lo) then
3845                      Actual_Lo   := Loval_Incl_EP - Small;
3846                      Actual_Size := Fsize (Actual_Lo, Actual_Hi);
3847
3848                   --  And of course, we need to do exactly the same parallel
3849                   --  fudge for flat ranges in the negative region.
3850
3851                   elsif UR_Is_Negative (Actual_Hi) then
3852                      Actual_Hi := Hival_Incl_EP + Small;
3853                      Actual_Size := Fsize (Actual_Lo, Actual_Hi);
3854                   end if;
3855                end if;
3856             end if;
3857
3858             Set_Realval (Lo, Actual_Lo);
3859             Set_Realval (Hi, Actual_Hi);
3860          end Fudge;
3861
3862       --  For the decimal case, none of this fudging is required, since there
3863       --  are no end-point problems in the decimal case (the end-points are
3864       --  always included).
3865
3866       else
3867          Actual_Size := Fsize (Loval, Hival);
3868       end if;
3869
3870       --  At this stage, the actual size has been calculated and the proper
3871       --  required bounds are stored in the low and high bounds.
3872
3873       if Actual_Size > 64 then
3874          Error_Msg_Uint_1 := UI_From_Int (Actual_Size);
3875          Error_Msg_N
3876            ("size required (^) for type& too large, maximum is 64", Typ);
3877          Actual_Size := 64;
3878       end if;
3879
3880       --  Check size against explicit given size
3881
3882       if Has_Size_Clause (Typ) then
3883          if Actual_Size > RM_Size (Typ) then
3884             Error_Msg_Uint_1 := RM_Size (Typ);
3885             Error_Msg_Uint_2 := UI_From_Int (Actual_Size);
3886             Error_Msg_NE
3887               ("size given (^) for type& too small, minimum is ^",
3888                Size_Clause (Typ), Typ);
3889
3890          else
3891             Actual_Size := UI_To_Int (Esize (Typ));
3892          end if;
3893
3894       --  Increase size to next natural boundary if no size clause given
3895
3896       else
3897          if Actual_Size <= 8 then
3898             Actual_Size := 8;
3899          elsif Actual_Size <= 16 then
3900             Actual_Size := 16;
3901          elsif Actual_Size <= 32 then
3902             Actual_Size := 32;
3903          else
3904             Actual_Size := 64;
3905          end if;
3906
3907          Init_Esize (Typ, Actual_Size);
3908          Adjust_Esize_For_Alignment (Typ);
3909       end if;
3910
3911       --  If we have a base type, then expand the bounds so that they
3912       --  extend to the full width of the allocated size in bits, to
3913       --  avoid junk range checks on intermediate computations.
3914
3915       if Base_Type (Typ) = Typ then
3916          Set_Realval (Lo, -(Small * (Uint_2 ** (Actual_Size - 1))));
3917          Set_Realval (Hi,  (Small * (Uint_2 ** (Actual_Size - 1) - 1)));
3918       end if;
3919
3920       --  Final step is to reanalyze the bounds using the proper type
3921       --  and set the Corresponding_Integer_Value fields of the literals.
3922
3923       Set_Etype (Lo, Empty);
3924       Set_Analyzed (Lo, False);
3925       Analyze (Lo);
3926
3927       --  Resolve with universal fixed if the base type, and the base
3928       --  type if it is a subtype. Note we can't resolve the base type
3929       --  with itself, that would be a reference before definition.
3930
3931       if Typ = Btyp then
3932          Resolve (Lo, Universal_Fixed);
3933       else
3934          Resolve (Lo, Btyp);
3935       end if;
3936
3937       --  Set corresponding integer value for bound
3938
3939       Set_Corresponding_Integer_Value
3940         (Lo, UR_To_Uint (Realval (Lo) / Small));
3941
3942       --  Similar processing for high bound
3943
3944       Set_Etype (Hi, Empty);
3945       Set_Analyzed (Hi, False);
3946       Analyze (Hi);
3947
3948       if Typ = Btyp then
3949          Resolve (Hi, Universal_Fixed);
3950       else
3951          Resolve (Hi, Btyp);
3952       end if;
3953
3954       Set_Corresponding_Integer_Value
3955         (Hi, UR_To_Uint (Realval (Hi) / Small));
3956
3957       --  Set type of range to correspond to bounds
3958
3959       Set_Etype (Rng, Etype (Lo));
3960
3961       --  Set Esize to calculated size if not set already
3962
3963       if Unknown_Esize (Typ) then
3964          Init_Esize (Typ, Actual_Size);
3965       end if;
3966
3967       --  Set RM_Size if not already set. If already set, check value
3968
3969       declare
3970          Minsiz : constant Uint := UI_From_Int (Minimum_Size (Typ));
3971
3972       begin
3973          if RM_Size (Typ) /= Uint_0 then
3974             if RM_Size (Typ) < Minsiz then
3975                Error_Msg_Uint_1 := RM_Size (Typ);
3976                Error_Msg_Uint_2 := Minsiz;
3977                Error_Msg_NE
3978                  ("size given (^) for type& too small, minimum is ^",
3979                   Size_Clause (Typ), Typ);
3980             end if;
3981
3982          else
3983             Set_RM_Size (Typ, Minsiz);
3984          end if;
3985       end;
3986    end Freeze_Fixed_Point_Type;
3987
3988    ------------------
3989    -- Freeze_Itype --
3990    ------------------
3991
3992    procedure Freeze_Itype (T : Entity_Id; N : Node_Id) is
3993       L : List_Id;
3994
3995    begin
3996       Set_Has_Delayed_Freeze (T);
3997       L := Freeze_Entity (T, Sloc (N));
3998
3999       if Is_Non_Empty_List (L) then
4000          Insert_Actions (N, L);
4001       end if;
4002    end Freeze_Itype;
4003
4004    --------------------------
4005    -- Freeze_Static_Object --
4006    --------------------------
4007
4008    procedure Freeze_Static_Object (E : Entity_Id) is
4009
4010       Cannot_Be_Static : exception;
4011       --  Exception raised if the type of a static object cannot be made
4012       --  static. This happens if the type depends on non-global objects.
4013
4014       procedure Ensure_Expression_Is_SA (N : Node_Id);
4015       --  Called to ensure that an expression used as part of a type
4016       --  definition is statically allocatable, which means that the type
4017       --  of the expression is statically allocatable, and the expression
4018       --  is either static, or a reference to a library level constant.
4019
4020       procedure Ensure_Type_Is_SA (Typ : Entity_Id);
4021       --  Called to mark a type as static, checking that it is possible
4022       --  to set the type as static. If it is not possible, then the
4023       --  exception Cannot_Be_Static is raised.
4024
4025       -----------------------------
4026       -- Ensure_Expression_Is_SA --
4027       -----------------------------
4028
4029       procedure Ensure_Expression_Is_SA (N : Node_Id) is
4030          Ent : Entity_Id;
4031
4032       begin
4033          Ensure_Type_Is_SA (Etype (N));
4034
4035          if Is_Static_Expression (N) then
4036             return;
4037
4038          elsif Nkind (N) = N_Identifier then
4039             Ent := Entity (N);
4040
4041             if Present (Ent)
4042               and then Ekind (Ent) = E_Constant
4043               and then Is_Library_Level_Entity (Ent)
4044             then
4045                return;
4046             end if;
4047          end if;
4048
4049          raise Cannot_Be_Static;
4050       end Ensure_Expression_Is_SA;
4051
4052       -----------------------
4053       -- Ensure_Type_Is_SA --
4054       -----------------------
4055
4056       procedure Ensure_Type_Is_SA (Typ : Entity_Id) is
4057          N : Node_Id;
4058          C : Entity_Id;
4059
4060       begin
4061          --  If type is library level, we are all set
4062
4063          if Is_Library_Level_Entity (Typ) then
4064             return;
4065          end if;
4066
4067          --  We are also OK if the type is already marked as statically
4068          --  allocated, which means we processed it before.
4069
4070          if Is_Statically_Allocated (Typ) then
4071             return;
4072          end if;
4073
4074          --  Mark type as statically allocated
4075
4076          Set_Is_Statically_Allocated (Typ);
4077
4078          --  Check that it is safe to statically allocate this type
4079
4080          if Is_Scalar_Type (Typ) or else Is_Real_Type (Typ) then
4081             Ensure_Expression_Is_SA (Type_Low_Bound (Typ));
4082             Ensure_Expression_Is_SA (Type_High_Bound (Typ));
4083
4084          elsif Is_Array_Type (Typ) then
4085             N := First_Index (Typ);
4086             while Present (N) loop
4087                Ensure_Type_Is_SA (Etype (N));
4088                Next_Index (N);
4089             end loop;
4090
4091             Ensure_Type_Is_SA (Component_Type (Typ));
4092
4093          elsif Is_Access_Type (Typ) then
4094             if Ekind (Designated_Type (Typ)) = E_Subprogram_Type then
4095
4096                declare
4097                   F : Entity_Id;
4098                   T : constant Entity_Id := Etype (Designated_Type (Typ));
4099
4100                begin
4101                   if T /= Standard_Void_Type then
4102                      Ensure_Type_Is_SA (T);
4103                   end if;
4104
4105                   F := First_Formal (Designated_Type (Typ));
4106
4107                   while Present (F) loop
4108                      Ensure_Type_Is_SA (Etype (F));
4109                      Next_Formal (F);
4110                   end loop;
4111                end;
4112
4113             else
4114                Ensure_Type_Is_SA (Designated_Type (Typ));
4115             end if;
4116
4117          elsif Is_Record_Type (Typ) then
4118             C := First_Entity (Typ);
4119
4120             while Present (C) loop
4121                if Ekind (C) = E_Discriminant
4122                  or else Ekind (C) = E_Component
4123                then
4124                   Ensure_Type_Is_SA (Etype (C));
4125
4126                elsif Is_Type (C) then
4127                   Ensure_Type_Is_SA (C);
4128                end if;
4129
4130                Next_Entity (C);
4131             end loop;
4132
4133          elsif Ekind (Typ) = E_Subprogram_Type then
4134             Ensure_Type_Is_SA (Etype (Typ));
4135
4136             C := First_Formal (Typ);
4137             while Present (C) loop
4138                Ensure_Type_Is_SA (Etype (C));
4139                Next_Formal (C);
4140             end loop;
4141
4142          else
4143             raise Cannot_Be_Static;
4144          end if;
4145       end Ensure_Type_Is_SA;
4146
4147    --  Start of processing for Freeze_Static_Object
4148
4149    begin
4150       Ensure_Type_Is_SA (Etype (E));
4151
4152       --  Reset True_Constant flag, since something strange is going on
4153       --  with the scoping here, and our simple value traceing may not
4154       --  be sufficient for this indication to be reliable. We kill the
4155       --  Constant_Value indication for the same reason.
4156
4157       Set_Is_True_Constant (E, False);
4158       Set_Current_Value    (E, Empty);
4159
4160    exception
4161       when Cannot_Be_Static =>
4162
4163          --  If the object that cannot be static is imported or exported,
4164          --  then we give an error message saying that this object cannot
4165          --  be imported or exported.
4166
4167          if Is_Imported (E) then
4168             Error_Msg_N
4169               ("& cannot be imported (local type is not constant)", E);
4170
4171          --  Otherwise must be exported, something is wrong if compiler
4172          --  is marking something as statically allocated which cannot be).
4173
4174          else pragma Assert (Is_Exported (E));
4175             Error_Msg_N
4176               ("& cannot be exported (local type is not constant)", E);
4177          end if;
4178    end Freeze_Static_Object;
4179
4180    -----------------------
4181    -- Freeze_Subprogram --
4182    -----------------------
4183
4184    procedure Freeze_Subprogram (E : Entity_Id) is
4185       Retype : Entity_Id;
4186       F      : Entity_Id;
4187
4188    begin
4189       --  Subprogram may not have an address clause unless it is imported
4190
4191       if Present (Address_Clause (E)) then
4192          if not Is_Imported (E) then
4193             Error_Msg_N
4194               ("address clause can only be given " &
4195                "for imported subprogram",
4196                Name (Address_Clause (E)));
4197          end if;
4198       end if;
4199
4200       --  Reset the Pure indication on an imported subprogram unless an
4201       --  explicit Pure_Function pragma was present. We do this because
4202       --  otherwise it is an insidious error to call a non-pure function
4203       --  from a pure unit and have calls mysteriously optimized away.
4204       --  What happens here is that the Import can bypass the normal
4205       --  check to ensure that pure units call only pure subprograms.
4206
4207       if Is_Imported (E)
4208         and then Is_Pure (E)
4209         and then not Has_Pragma_Pure_Function (E)
4210       then
4211          Set_Is_Pure (E, False);
4212       end if;
4213
4214       --  For non-foreign convention subprograms, this is where we create
4215       --  the extra formals (for accessibility level and constrained bit
4216       --  information). We delay this till the freeze point precisely so
4217       --  that we know the convention!
4218
4219       if not Has_Foreign_Convention (E) then
4220          Create_Extra_Formals (E);
4221          Set_Mechanisms (E);
4222
4223          --  If this is convention Ada and a Valued_Procedure, that's odd
4224
4225          if Ekind (E) = E_Procedure
4226            and then Is_Valued_Procedure (E)
4227            and then Convention (E) = Convention_Ada
4228            and then Warn_On_Export_Import
4229          then
4230             Error_Msg_N
4231               ("?Valued_Procedure has no effect for convention Ada", E);
4232             Set_Is_Valued_Procedure (E, False);
4233          end if;
4234
4235       --  Case of foreign convention
4236
4237       else
4238          Set_Mechanisms (E);
4239
4240          --  For foreign conventions, warn about return of an
4241          --  unconstrained array.
4242
4243          --  Note: we *do* allow a return by descriptor for the VMS case,
4244          --  though here there is probably more to be done ???
4245
4246          if Ekind (E) = E_Function then
4247             Retype := Underlying_Type (Etype (E));
4248
4249             --  If no return type, probably some other error, e.g. a
4250             --  missing full declaration, so ignore.
4251
4252             if No (Retype) then
4253                null;
4254
4255             --  If the return type is generic, we have emitted a warning
4256             --  earlier on, and there is nothing else to check here.
4257             --  Specific instantiations may lead to erroneous behavior.
4258
4259             elsif Is_Generic_Type (Etype (E)) then
4260                null;
4261
4262             elsif Is_Array_Type (Retype)
4263               and then not Is_Constrained (Retype)
4264               and then Mechanism (E) not in Descriptor_Codes
4265               and then Warn_On_Export_Import
4266             then
4267                Error_Msg_N
4268                 ("?foreign convention function& should not return " &
4269                   "unconstrained array", E);
4270                return;
4271             end if;
4272          end if;
4273
4274          --  If any of the formals for an exported foreign convention
4275          --  subprogram have defaults, then emit an appropriate warning
4276          --  since this is odd (default cannot be used from non-Ada code)
4277
4278          if Is_Exported (E) then
4279             F := First_Formal (E);
4280             while Present (F) loop
4281                if Warn_On_Export_Import
4282                  and then Present (Default_Value (F))
4283                then
4284                   Error_Msg_N
4285                     ("?parameter cannot be defaulted in non-Ada call",
4286                      Default_Value (F));
4287                end if;
4288
4289                Next_Formal (F);
4290             end loop;
4291          end if;
4292       end if;
4293
4294       --  For VMS, descriptor mechanisms for parameters are allowed only
4295       --  for imported subprograms.
4296
4297       if OpenVMS_On_Target then
4298          if not Is_Imported (E) then
4299             F := First_Formal (E);
4300             while Present (F) loop
4301                if Mechanism (F) in Descriptor_Codes then
4302                   Error_Msg_N
4303                     ("descriptor mechanism for parameter not permitted", F);
4304                   Error_Msg_N
4305                     ("\can only be used for imported subprogram", F);
4306                end if;
4307
4308                Next_Formal (F);
4309             end loop;
4310          end if;
4311       end if;
4312    end Freeze_Subprogram;
4313
4314    -----------------------
4315    --  Is_Fully_Defined --
4316    -----------------------
4317
4318    function Is_Fully_Defined (T : Entity_Id) return Boolean is
4319    begin
4320       if Ekind (T) = E_Class_Wide_Type then
4321          return Is_Fully_Defined (Etype (T));
4322
4323       elsif Is_Array_Type (T) then
4324          return Is_Fully_Defined (Component_Type (T));
4325
4326       elsif Is_Record_Type (T)
4327         and not Is_Private_Type (T)
4328       then
4329          --  Verify that the record type has no components with
4330          --  private types without completion.
4331
4332          declare
4333             Comp : Entity_Id;
4334
4335          begin
4336             Comp := First_Component (T);
4337
4338             while Present (Comp) loop
4339                if not Is_Fully_Defined (Etype (Comp)) then
4340                   return False;
4341                end if;
4342
4343                Next_Component (Comp);
4344             end loop;
4345             return True;
4346          end;
4347
4348       else return not Is_Private_Type (T)
4349         or else Present (Full_View (Base_Type (T)));
4350       end if;
4351    end Is_Fully_Defined;
4352
4353    ---------------------------------
4354    -- Process_Default_Expressions --
4355    ---------------------------------
4356
4357    procedure Process_Default_Expressions
4358      (E     : Entity_Id;
4359       After : in out Node_Id)
4360    is
4361       Loc    : constant Source_Ptr := Sloc (E);
4362       Dbody  : Node_Id;
4363       Formal : Node_Id;
4364       Dcopy  : Node_Id;
4365       Dnam   : Entity_Id;
4366
4367    begin
4368       Set_Default_Expressions_Processed (E);
4369
4370       --  A subprogram instance and its associated anonymous subprogram
4371       --  share their signature. The default expression functions are defined
4372       --  in the wrapper packages for the anonymous subprogram, and should
4373       --  not be generated again for the instance.
4374
4375       if Is_Generic_Instance (E)
4376         and then Present (Alias (E))
4377         and then Default_Expressions_Processed (Alias (E))
4378       then
4379          return;
4380       end if;
4381
4382       Formal := First_Formal (E);
4383
4384       while Present (Formal) loop
4385          if Present (Default_Value (Formal)) then
4386
4387             --  We work with a copy of the default expression because we
4388             --  do not want to disturb the original, since this would mess
4389             --  up the conformance checking.
4390
4391             Dcopy := New_Copy_Tree (Default_Value (Formal));
4392
4393             --  The analysis of the expression may generate insert actions,
4394             --  which of course must not be executed. We wrap those actions
4395             --  in a procedure that is not called, and later on eliminated.
4396             --  The following cases have no side-effects, and are analyzed
4397             --  directly.
4398
4399             if Nkind (Dcopy) = N_Identifier
4400               or else Nkind (Dcopy) = N_Expanded_Name
4401               or else Nkind (Dcopy) = N_Integer_Literal
4402               or else (Nkind (Dcopy) = N_Real_Literal
4403                         and then not Vax_Float (Etype (Dcopy)))
4404               or else Nkind (Dcopy) = N_Character_Literal
4405               or else Nkind (Dcopy) = N_String_Literal
4406               or else Nkind (Dcopy) = N_Null
4407               or else (Nkind (Dcopy) = N_Attribute_Reference
4408                         and then
4409                        Attribute_Name (Dcopy) = Name_Null_Parameter)
4410             then
4411
4412                --  If there is no default function, we must still do a full
4413                --  analyze call on the default value, to ensure that all
4414                --  error checks are performed, e.g. those associated with
4415                --  static evaluation. Note that this branch will always be
4416                --  taken if the analyzer is turned off (but we still need the
4417                --  error checks).
4418
4419                --  Note: the setting of parent here is to meet the requirement
4420                --  that we can only analyze the expression while attached to
4421                --  the tree. Really the requirement is that the parent chain
4422                --  be set, we don't actually need to be in the tree.
4423
4424                Set_Parent (Dcopy, Declaration_Node (Formal));
4425                Analyze (Dcopy);
4426
4427                --  Default expressions are resolved with their own type if the
4428                --  context is generic, to avoid anomalies with private types.
4429
4430                if Ekind (Scope (E)) = E_Generic_Package then
4431                   Resolve (Dcopy);
4432                else
4433                   Resolve (Dcopy, Etype (Formal));
4434                end if;
4435
4436                --  If that resolved expression will raise constraint error,
4437                --  then flag the default value as raising constraint error.
4438                --  This allows a proper error message on the calls.
4439
4440                if Raises_Constraint_Error (Dcopy) then
4441                   Set_Raises_Constraint_Error (Default_Value (Formal));
4442                end if;
4443
4444             --  If the default is a parameterless call, we use the name of
4445             --  the called function directly, and there is no body to build.
4446
4447             elsif Nkind (Dcopy) = N_Function_Call
4448               and then No (Parameter_Associations (Dcopy))
4449             then
4450                null;
4451
4452             --  Else construct and analyze the body of a wrapper procedure
4453             --  that contains an object declaration to hold the expression.
4454             --  Given that this is done only to complete the analysis, it
4455             --  simpler to build a procedure than a function which might
4456             --  involve secondary stack expansion.
4457
4458             else
4459                Dnam :=
4460                  Make_Defining_Identifier (Loc, New_Internal_Name ('D'));
4461
4462                Dbody :=
4463                  Make_Subprogram_Body (Loc,
4464                    Specification =>
4465                      Make_Procedure_Specification (Loc,
4466                        Defining_Unit_Name => Dnam),
4467
4468                    Declarations => New_List (
4469                      Make_Object_Declaration (Loc,
4470                        Defining_Identifier =>
4471                          Make_Defining_Identifier (Loc,
4472                            New_Internal_Name ('T')),
4473                          Object_Definition =>
4474                            New_Occurrence_Of (Etype (Formal), Loc),
4475                          Expression => New_Copy_Tree (Dcopy))),
4476
4477                    Handled_Statement_Sequence =>
4478                      Make_Handled_Sequence_Of_Statements (Loc,
4479                        Statements => New_List));
4480
4481                Set_Scope (Dnam, Scope (E));
4482                Set_Assignment_OK (First (Declarations (Dbody)));
4483                Set_Is_Eliminated (Dnam);
4484                Insert_After (After, Dbody);
4485                Analyze (Dbody);
4486                After := Dbody;
4487             end if;
4488          end if;
4489
4490          Next_Formal (Formal);
4491       end loop;
4492
4493    end Process_Default_Expressions;
4494
4495    ----------------------------------------
4496    -- Set_Component_Alignment_If_Not_Set --
4497    ----------------------------------------
4498
4499    procedure Set_Component_Alignment_If_Not_Set (Typ : Entity_Id) is
4500    begin
4501       --  Ignore if not base type, subtypes don't need anything
4502
4503       if Typ /= Base_Type (Typ) then
4504          return;
4505       end if;
4506
4507       --  Do not override existing representation
4508
4509       if Is_Packed (Typ) then
4510          return;
4511
4512       elsif Has_Specified_Layout (Typ) then
4513          return;
4514
4515       elsif Component_Alignment (Typ) /= Calign_Default then
4516          return;
4517
4518       else
4519          Set_Component_Alignment
4520            (Typ, Scope_Stack.Table
4521                   (Scope_Stack.Last).Component_Alignment_Default);
4522       end if;
4523    end Set_Component_Alignment_If_Not_Set;
4524
4525    ---------------------------
4526    -- Set_Debug_Info_Needed --
4527    ---------------------------
4528
4529    procedure Set_Debug_Info_Needed (T : Entity_Id) is
4530    begin
4531       if No (T)
4532         or else Needs_Debug_Info (T)
4533         or else Debug_Info_Off (T)
4534       then
4535          return;
4536       else
4537          Set_Needs_Debug_Info (T);
4538       end if;
4539
4540       if Is_Object (T) then
4541          Set_Debug_Info_Needed (Etype (T));
4542
4543       elsif Is_Type (T) then
4544          Set_Debug_Info_Needed (Etype (T));
4545
4546          if Is_Record_Type (T) then
4547             declare
4548                Ent : Entity_Id := First_Entity (T);
4549             begin
4550                while Present (Ent) loop
4551                   Set_Debug_Info_Needed (Ent);
4552                   Next_Entity (Ent);
4553                end loop;
4554             end;
4555
4556          elsif Is_Array_Type (T) then
4557             Set_Debug_Info_Needed (Component_Type (T));
4558
4559             declare
4560                Indx : Node_Id := First_Index (T);
4561             begin
4562                while Present (Indx) loop
4563                   Set_Debug_Info_Needed (Etype (Indx));
4564                   Indx := Next_Index (Indx);
4565                end loop;
4566             end;
4567
4568             if Is_Packed (T) then
4569                Set_Debug_Info_Needed (Packed_Array_Type (T));
4570             end if;
4571
4572          elsif Is_Access_Type (T) then
4573             Set_Debug_Info_Needed (Directly_Designated_Type (T));
4574
4575          elsif Is_Private_Type (T) then
4576             Set_Debug_Info_Needed (Full_View (T));
4577
4578          elsif Is_Protected_Type (T) then
4579             Set_Debug_Info_Needed (Corresponding_Record_Type (T));
4580          end if;
4581       end if;
4582    end Set_Debug_Info_Needed;
4583
4584    ------------------
4585    -- Warn_Overlay --
4586    ------------------
4587
4588    procedure Warn_Overlay
4589      (Expr : Node_Id;
4590       Typ  : Entity_Id;
4591       Nam  : Entity_Id)
4592    is
4593       Ent : constant Entity_Id := Entity (Nam);
4594       --  The object to which the address clause applies.
4595
4596       Init : Node_Id;
4597       Old  : Entity_Id := Empty;
4598       Decl : Node_Id;
4599
4600    begin
4601       --  No warning if address clause overlay warnings are off
4602
4603       if not Address_Clause_Overlay_Warnings then
4604          return;
4605       end if;
4606
4607       --  No warning if there is an explicit initialization
4608
4609       Init := Original_Node (Expression (Declaration_Node (Ent)));
4610
4611       if Present (Init) and then Comes_From_Source (Init) then
4612          return;
4613       end if;
4614
4615       --  We only give the warning for non-imported entities of a type
4616       --  for which a non-null base init proc is defined (or for access
4617       --  types which have implicit null initialization).
4618
4619       if Present (Expr)
4620         and then (Has_Non_Null_Base_Init_Proc (Typ)
4621                     or else Is_Access_Type (Typ))
4622         and then not Is_Imported (Ent)
4623       then
4624          if Nkind (Expr) = N_Attribute_Reference
4625            and then Is_Entity_Name (Prefix (Expr))
4626          then
4627             Old := Entity (Prefix (Expr));
4628
4629          elsif Is_Entity_Name (Expr)
4630            and then Ekind (Entity (Expr)) = E_Constant
4631          then
4632             Decl := Declaration_Node (Entity (Expr));
4633
4634             if Nkind (Decl) = N_Object_Declaration
4635               and then Present (Expression (Decl))
4636               and then Nkind (Expression (Decl)) = N_Attribute_Reference
4637               and then Is_Entity_Name (Prefix (Expression (Decl)))
4638             then
4639                Old := Entity (Prefix (Expression (Decl)));
4640
4641             elsif Nkind (Expr) = N_Function_Call then
4642                return;
4643             end if;
4644
4645          --  A function call (most likely to To_Address) is probably not
4646          --  an overlay, so skip warning. Ditto if the function call was
4647          --  inlined and transformed into an entity.
4648
4649          elsif Nkind (Original_Node (Expr)) = N_Function_Call then
4650             return;
4651          end if;
4652
4653          Decl := Next (Parent (Expr));
4654
4655          --  If a pragma Import follows, we assume that it is for the current
4656          --  target of the address clause, and skip the warning.
4657
4658          if Present (Decl)
4659            and then Nkind (Decl) = N_Pragma
4660            and then Chars (Decl) = Name_Import
4661          then
4662             return;
4663          end if;
4664
4665          if Present (Old) then
4666             Error_Msg_Node_2 := Old;
4667             Error_Msg_N
4668               ("default initialization of & may modify &?",
4669                Nam);
4670          else
4671             Error_Msg_N
4672               ("default initialization of & may modify overlaid storage?",
4673                Nam);
4674          end if;
4675
4676          --  Add friendly warning if initialization comes from a packed array
4677          --  component.
4678
4679          if Is_Record_Type (Typ)  then
4680             declare
4681                Comp : Entity_Id;
4682
4683             begin
4684                Comp := First_Component (Typ);
4685
4686                while Present (Comp) loop
4687                   if Nkind (Parent (Comp)) = N_Component_Declaration
4688                     and then Present (Expression (Parent (Comp)))
4689                   then
4690                      exit;
4691                   elsif Is_Array_Type (Etype (Comp))
4692                      and then Present (Packed_Array_Type (Etype (Comp)))
4693                   then
4694                      Error_Msg_NE
4695                        ("packed array component& will be initialized to zero?",
4696                           Nam, Comp);
4697                      exit;
4698                   else
4699                      Next_Component (Comp);
4700                   end if;
4701                end loop;
4702             end;
4703          end if;
4704
4705          Error_Msg_N
4706            ("use pragma Import for & to " &
4707               "suppress initialization ('R'M B.1(24))?",
4708              Nam);
4709       end if;
4710    end Warn_Overlay;
4711
4712 end Freeze;