1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1999-2018, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception, --
20 -- version 3.1, as published by the Free Software Foundation. --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
30 ------------------------------------------------------------------------------
33 with Atree
; use Atree
;
34 with Casing
; use Casing
;
35 with Debug
; use Debug
;
36 with Einfo
; use Einfo
;
38 with Namet
; use Namet
;
39 with Nlists
; use Nlists
;
41 with Output
; use Output
;
42 with Sem_Aux
; use Sem_Aux
;
43 with Sinfo
; use Sinfo
;
44 with Sinput
; use Sinput
;
45 with Snames
; use Snames
;
46 with Stand
; use Stand
;
47 with Stringt
; use Stringt
;
49 with Uname
; use Uname
;
50 with Urealp
; use Urealp
;
52 with Ada
.Unchecked_Conversion
;
54 package body Repinfo
is
57 -- Value for Storage_Unit, we do not want to get this from TTypes, since
58 -- this introduces problematic dependencies in ASIS, and in any case this
59 -- value is assumed to be 8 for the implementation of the DDA.
61 ---------------------------------------
62 -- Representation of GCC Expressions --
63 ---------------------------------------
65 -- A table internal to this unit is used to hold the values of back
66 -- annotated expressions. This table is written out by -gnatt and read
67 -- back in for ASIS processing.
69 -- Node values are stored as Uint values using the negative of the node
70 -- index in this table. Constants appear as non-negative Uint values.
72 type Exp_Node
is record
74 Op1
: Node_Ref_Or_Val
;
75 Op2
: Node_Ref_Or_Val
;
76 Op3
: Node_Ref_Or_Val
;
79 -- The following representation clause ensures that the above record
80 -- has no holes. We do this so that when instances of this record are
81 -- written by Tree_Gen, we do not write uninitialized values to the file.
83 for Exp_Node
use record
84 Expr
at 0 range 0 .. 31;
85 Op1
at 4 range 0 .. 31;
86 Op2
at 8 range 0 .. 31;
87 Op3
at 12 range 0 .. 31;
90 for Exp_Node
'Size use 16 * 8;
91 -- This ensures that we did not leave out any fields
93 package Rep_Table
is new Table
.Table
(
94 Table_Component_Type
=> Exp_Node
,
95 Table_Index_Type
=> Nat
,
97 Table_Initial
=> Alloc
.Rep_Table_Initial
,
98 Table_Increment
=> Alloc
.Rep_Table_Increment
,
99 Table_Name
=> "BE_Rep_Table");
101 --------------------------------------------------------------
102 -- Representation of Front-End Dynamic Size/Offset Entities --
103 --------------------------------------------------------------
105 package Dynamic_SO_Entity_Table
is new Table
.Table
(
106 Table_Component_Type
=> Entity_Id
,
107 Table_Index_Type
=> Nat
,
108 Table_Low_Bound
=> 1,
109 Table_Initial
=> Alloc
.Rep_Table_Initial
,
110 Table_Increment
=> Alloc
.Rep_Table_Increment
,
111 Table_Name
=> "FE_Rep_Table");
113 Unit_Casing
: Casing_Type
;
114 -- Identifier casing for current unit. This is set by List_Rep_Info for
115 -- each unit, before calling subprograms which may read it.
117 Need_Blank_Line
: Boolean;
118 -- Set True if a blank line is needed before outputting any information for
119 -- the current entity. Set True when a new entity is processed, and false
120 -- when the blank line is output.
122 -----------------------
123 -- Local Subprograms --
124 -----------------------
126 function Back_End_Layout
return Boolean;
127 -- Test for layout mode, True = back end, False = front end. This function
128 -- is used rather than checking the configuration parameter because we do
129 -- not want Repinfo to depend on Targparm (for ASIS)
131 procedure Blank_Line
;
132 -- Called before outputting anything for an entity. Ensures that
133 -- a blank line precedes the output for a particular entity.
135 procedure List_Entities
137 Bytes_Big_Endian
: Boolean;
138 In_Subprogram
: Boolean := False);
139 -- This procedure lists the entities associated with the entity E, starting
140 -- with the First_Entity and using the Next_Entity link. If a nested
141 -- package is found, entities within the package are recursively processed.
142 -- When recursing within a subprogram body, Is_Subprogram suppresses
143 -- duplicate information about signature.
145 procedure List_Name
(Ent
: Entity_Id
);
146 -- List name of entity Ent in appropriate case. The name is listed with
147 -- full qualification up to but not including the compilation unit name.
149 procedure List_Array_Info
(Ent
: Entity_Id
; Bytes_Big_Endian
: Boolean);
150 -- List representation info for array type Ent
152 procedure List_Linker_Section
(Ent
: Entity_Id
);
153 -- List linker section for Ent (caller has checked that Ent is an entity
154 -- for which the Linker_Section_Pragma field is defined).
156 procedure List_Mechanisms
(Ent
: Entity_Id
);
157 -- List mechanism information for parameters of Ent, which is subprogram,
158 -- subprogram type, or an entry or entry family.
160 procedure List_Object_Info
(Ent
: Entity_Id
);
161 -- List representation info for object Ent
163 procedure List_Record_Info
(Ent
: Entity_Id
; Bytes_Big_Endian
: Boolean);
164 -- List representation info for record type Ent
166 procedure List_Scalar_Storage_Order
168 Bytes_Big_Endian
: Boolean);
169 -- List scalar storage order information for record or array type Ent.
170 -- Also includes bit order information for record types, if necessary.
172 procedure List_Type_Info
(Ent
: Entity_Id
);
173 -- List type info for type Ent
175 function Rep_Not_Constant
(Val
: Node_Ref_Or_Val
) return Boolean;
176 -- Returns True if Val represents a variable value, and False if it
177 -- represents a value that is fixed at compile time.
179 procedure Spaces
(N
: Natural);
180 -- Output given number of spaces
182 procedure Write_Info_Line
(S
: String);
183 -- Routine to write a line to Repinfo output file. This routine is passed
184 -- as a special output procedure to Output.Set_Special_Output. Note that
185 -- Write_Info_Line is called with an EOL character at the end of each line,
186 -- as per the Output spec, but the internal call to the appropriate routine
187 -- in Osint requires that the end of line sequence be stripped off.
189 procedure Write_Mechanism
(M
: Mechanism_Type
);
190 -- Writes symbolic string for mechanism represented by M
192 procedure Write_Val
(Val
: Node_Ref_Or_Val
; Paren
: Boolean := False);
193 -- Given a representation value, write it out. No_Uint values or values
194 -- dependent on discriminants are written as two question marks. If the
195 -- flag Paren is set, then the output is surrounded in parentheses if it is
196 -- other than a simple value.
198 ---------------------
199 -- Back_End_Layout --
200 ---------------------
202 function Back_End_Layout
return Boolean is
204 -- We have back end layout if the back end has made any entries in the
205 -- table of GCC expressions, otherwise we have front end layout.
207 return Rep_Table
.Last
> 0;
214 procedure Blank_Line
is
216 if Need_Blank_Line
then
218 Need_Blank_Line
:= False;
222 ------------------------
223 -- Create_Discrim_Ref --
224 ------------------------
226 function Create_Discrim_Ref
(Discr
: Entity_Id
) return Node_Ref
is
229 (Expr
=> Discrim_Val
,
230 Op1
=> Discriminant_Number
(Discr
));
231 end Create_Discrim_Ref
;
233 ---------------------------
234 -- Create_Dynamic_SO_Ref --
235 ---------------------------
237 function Create_Dynamic_SO_Ref
(E
: Entity_Id
) return Dynamic_SO_Ref
is
239 Dynamic_SO_Entity_Table
.Append
(E
);
240 return UI_From_Int
(-Dynamic_SO_Entity_Table
.Last
);
241 end Create_Dynamic_SO_Ref
;
249 Op1
: Node_Ref_Or_Val
;
250 Op2
: Node_Ref_Or_Val
:= No_Uint
;
251 Op3
: Node_Ref_Or_Val
:= No_Uint
) return Node_Ref
259 return UI_From_Int
(-Rep_Table
.Last
);
262 ---------------------------
263 -- Get_Dynamic_SO_Entity --
264 ---------------------------
266 function Get_Dynamic_SO_Entity
(U
: Dynamic_SO_Ref
) return Entity_Id
is
268 return Dynamic_SO_Entity_Table
.Table
(-UI_To_Int
(U
));
269 end Get_Dynamic_SO_Entity
;
271 -----------------------
272 -- Is_Dynamic_SO_Ref --
273 -----------------------
275 function Is_Dynamic_SO_Ref
(U
: SO_Ref
) return Boolean is
278 end Is_Dynamic_SO_Ref
;
280 ----------------------
281 -- Is_Static_SO_Ref --
282 ----------------------
284 function Is_Static_SO_Ref
(U
: SO_Ref
) return Boolean is
287 end Is_Static_SO_Ref
;
293 procedure lgx
(U
: Node_Ref_Or_Val
) is
295 List_GCC_Expression
(U
);
299 ----------------------
300 -- List_Array_Info --
301 ----------------------
303 procedure List_Array_Info
(Ent
: Entity_Id
; Bytes_Big_Endian
: Boolean) is
305 List_Type_Info
(Ent
);
308 Write_Str
("'Component_Size use ");
309 Write_Val
(Component_Size
(Ent
));
312 List_Scalar_Storage_Order
(Ent
, Bytes_Big_Endian
);
319 procedure List_Entities
321 Bytes_Big_Endian
: Boolean;
322 In_Subprogram
: Boolean := False)
327 function Find_Declaration
(E
: Entity_Id
) return Node_Id
;
328 -- Utility to retrieve declaration node for entity in the
329 -- case of package bodies and subprograms.
331 ----------------------
332 -- Find_Declaration --
333 ----------------------
335 function Find_Declaration
(E
: Entity_Id
) return Node_Id
is
341 and then Nkind
(Decl
) /= N_Package_Body
342 and then Nkind
(Decl
) /= N_Subprogram_Declaration
343 and then Nkind
(Decl
) /= N_Subprogram_Body
345 Decl
:= Parent
(Decl
);
349 end Find_Declaration
;
351 -- Start of processing for List_Entities
354 -- List entity if we have one, and it is not a renaming declaration.
355 -- For renamings, we don't get proper information, and really it makes
356 -- sense to restrict the output to the renamed entity.
359 and then Nkind
(Declaration_Node
(Ent
)) not in N_Renaming_Declaration
361 -- If entity is a subprogram and we are listing mechanisms,
362 -- then we need to list mechanisms for this entity. We skip this
363 -- if it is a nested subprogram, as the information has already
364 -- been produced when listing the enclosing scope.
366 if List_Representation_Info_Mechanisms
367 and then (Is_Subprogram
(Ent
)
368 or else Ekind
(Ent
) = E_Entry
369 or else Ekind
(Ent
) = E_Entry_Family
)
370 and then not In_Subprogram
372 Need_Blank_Line
:= True;
373 List_Mechanisms
(Ent
);
376 E
:= First_Entity
(Ent
);
377 while Present
(E
) loop
378 Need_Blank_Line
:= True;
380 -- We list entities that come from source (excluding private or
381 -- incomplete types or deferred constants, where we will list the
382 -- info for the full view). If debug flag A is set, then all
383 -- entities are listed
385 if (Comes_From_Source
(E
)
386 and then not Is_Incomplete_Or_Private_Type
(E
)
387 and then not (Ekind
(E
) = E_Constant
388 and then Present
(Full_View
(E
))))
389 or else Debug_Flag_AA
391 if Is_Subprogram
(E
) then
392 List_Linker_Section
(E
);
394 if List_Representation_Info_Mechanisms
then
398 -- Recurse into entities local to subprogram
400 List_Entities
(E
, Bytes_Big_Endian
, True);
402 elsif Ekind
(E
) in Formal_Kind
and then In_Subprogram
then
405 elsif Ekind_In
(E
, E_Entry
,
409 if List_Representation_Info_Mechanisms
then
413 elsif Is_Record_Type
(E
) then
414 if List_Representation_Info
>= 1 then
415 List_Record_Info
(E
, Bytes_Big_Endian
);
418 List_Linker_Section
(E
);
420 elsif Is_Array_Type
(E
) then
421 if List_Representation_Info
>= 1 then
422 List_Array_Info
(E
, Bytes_Big_Endian
);
425 List_Linker_Section
(E
);
427 elsif Is_Type
(E
) then
428 if List_Representation_Info
>= 2 then
430 List_Linker_Section
(E
);
433 elsif Ekind_In
(E
, E_Variable
, E_Constant
) then
434 if List_Representation_Info
>= 2 then
435 List_Object_Info
(E
);
436 List_Linker_Section
(E
);
439 elsif Ekind
(E
) = E_Loop_Parameter
or else Is_Formal
(E
) then
440 if List_Representation_Info
>= 2 then
441 List_Object_Info
(E
);
445 -- Recurse into nested package, but not if they are package
446 -- renamings (in particular renamings of the enclosing package,
447 -- as for some Java bindings and for generic instances).
449 if Ekind
(E
) = E_Package
then
450 if No
(Renamed_Object
(E
)) then
451 List_Entities
(E
, Bytes_Big_Endian
);
454 -- Recurse into bodies
456 elsif Ekind_In
(E
, E_Protected_Type
,
463 List_Entities
(E
, Bytes_Big_Endian
);
465 -- Recurse into blocks
467 elsif Ekind
(E
) = E_Block
then
468 List_Entities
(E
, Bytes_Big_Endian
);
472 E
:= Next_Entity
(E
);
475 -- For a package body, the entities of the visible subprograms are
476 -- declared in the corresponding spec. Iterate over its entities in
477 -- order to handle properly the subprogram bodies. Skip bodies in
478 -- subunits, which are listed independently.
480 if Ekind
(Ent
) = E_Package_Body
481 and then Present
(Corresponding_Spec
(Find_Declaration
(Ent
)))
483 E
:= First_Entity
(Corresponding_Spec
(Find_Declaration
(Ent
)));
484 while Present
(E
) loop
487 Nkind
(Find_Declaration
(E
)) = N_Subprogram_Declaration
489 Body_E
:= Corresponding_Body
(Find_Declaration
(E
));
493 Nkind
(Parent
(Find_Declaration
(Body_E
))) /= N_Subunit
495 List_Entities
(Body_E
, Bytes_Big_Endian
);
505 -------------------------
506 -- List_GCC_Expression --
507 -------------------------
509 procedure List_GCC_Expression
(U
: Node_Ref_Or_Val
) is
511 procedure Print_Expr
(Val
: Node_Ref_Or_Val
);
512 -- Internal recursive procedure to print expression
518 procedure Print_Expr
(Val
: Node_Ref_Or_Val
) is
521 UI_Write
(Val
, Decimal
);
525 Node
: Exp_Node
renames Rep_Table
.Table
(-UI_To_Int
(Val
));
527 procedure Binop
(S
: String);
528 -- Output text for binary operator with S being operator name
534 procedure Binop
(S
: String) is
537 Print_Expr
(Node
.Op1
);
539 Print_Expr
(Node
.Op2
);
543 -- Start of processing for Print_Expr
549 Print_Expr
(Node
.Op1
);
550 Write_Str
(" then ");
551 Print_Expr
(Node
.Op2
);
552 Write_Str
(" else ");
553 Print_Expr
(Node
.Op3
);
565 when Trunc_Div_Expr
=>
568 when Ceil_Div_Expr
=>
571 when Floor_Div_Expr
=>
574 when Trunc_Mod_Expr
=>
577 when Floor_Mod_Expr
=>
580 when Ceil_Mod_Expr
=>
583 when Exact_Div_Expr
=>
588 Print_Expr
(Node
.Op1
);
598 Print_Expr
(Node
.Op1
);
600 when Truth_Andif_Expr
=>
603 when Truth_Orif_Expr
=>
606 when Truth_And_Expr
=>
609 when Truth_Or_Expr
=>
612 when Truth_Xor_Expr
=>
615 when Truth_Not_Expr
=>
617 Print_Expr
(Node
.Op1
);
652 -- Start of processing for List_GCC_Expression
660 end List_GCC_Expression
;
662 -------------------------
663 -- List_Linker_Section --
664 -------------------------
666 procedure List_Linker_Section
(Ent
: Entity_Id
) is
670 if Present
(Linker_Section_Pragma
(Ent
)) then
671 Write_Str
("pragma Linker_Section (");
676 Last
(Pragma_Argument_Associations
(Linker_Section_Pragma
(Ent
)));
678 if Nkind
(Arg
) = N_Pragma_Argument_Association
then
679 Arg
:= Expression
(Arg
);
682 pragma Assert
(Nkind
(Arg
) = N_String_Literal
);
683 String_To_Name_Buffer
(Strval
(Arg
));
684 Write_Str
(Name_Buffer
(1 .. Name_Len
));
688 end List_Linker_Section
;
690 ---------------------
691 -- List_Mechanisms --
692 ---------------------
694 procedure List_Mechanisms
(Ent
: Entity_Id
) is
703 Write_Str
("function ");
706 Write_Str
("operator ");
709 Write_Str
("procedure ");
711 when E_Subprogram_Type
=>
717 Write_Str
("entry ");
723 Get_Unqualified_Decoded_Name_String
(Chars
(Ent
));
724 Write_Str
(Name_Buffer
(1 .. Name_Len
));
725 Write_Str
(" declared at ");
726 Write_Location
(Sloc
(Ent
));
729 Write_Str
(" convention : ");
731 case Convention
(Ent
) is
732 when Convention_Ada
=>
735 when Convention_Ada_Pass_By_Copy
=>
736 Write_Line
("Ada_Pass_By_Copy");
738 when Convention_Ada_Pass_By_Reference
=>
739 Write_Line
("Ada_Pass_By_Reference");
741 when Convention_Intrinsic
=>
742 Write_Line
("Intrinsic");
744 when Convention_Entry
=>
745 Write_Line
("Entry");
747 when Convention_Protected
=>
748 Write_Line
("Protected");
750 when Convention_Assembler
=>
751 Write_Line
("Assembler");
756 when Convention_COBOL
=>
757 Write_Line
("COBOL");
759 when Convention_CPP
=>
762 when Convention_Fortran
=>
763 Write_Line
("Fortran");
765 when Convention_Stdcall
=>
766 Write_Line
("Stdcall");
768 when Convention_Stubbed
=>
769 Write_Line
("Stubbed");
772 -- Find max length of formal name
775 Form
:= First_Formal
(Ent
);
776 while Present
(Form
) loop
777 Get_Unqualified_Decoded_Name_String
(Chars
(Form
));
779 if Name_Len
> Plen
then
786 -- Output formals and mechanisms
788 Form
:= First_Formal
(Ent
);
789 while Present
(Form
) loop
790 Get_Unqualified_Decoded_Name_String
(Chars
(Form
));
791 while Name_Len
<= Plen
loop
792 Name_Len
:= Name_Len
+ 1;
793 Name_Buffer
(Name_Len
) := ' ';
797 Write_Str
(Name_Buffer
(1 .. Plen
+ 1));
798 Write_Str
(": passed by ");
800 Write_Mechanism
(Mechanism
(Form
));
805 if Etype
(Ent
) /= Standard_Void_Type
then
806 Write_Str
(" returns by ");
807 Write_Mechanism
(Mechanism
(Ent
));
816 procedure List_Name
(Ent
: Entity_Id
) is
818 if not Is_Compilation_Unit
(Scope
(Ent
)) then
819 List_Name
(Scope
(Ent
));
823 Get_Unqualified_Decoded_Name_String
(Chars
(Ent
));
824 Set_Casing
(Unit_Casing
);
825 Write_Str
(Name_Buffer
(1 .. Name_Len
));
828 ---------------------
829 -- List_Object_Info --
830 ---------------------
832 procedure List_Object_Info
(Ent
: Entity_Id
) is
838 Write_Str
("'Size use ");
839 Write_Val
(Esize
(Ent
));
844 Write_Str
("'Alignment use ");
845 Write_Val
(Alignment
(Ent
));
847 end List_Object_Info
;
849 ----------------------
850 -- List_Record_Info --
851 ----------------------
853 procedure List_Record_Info
(Ent
: Entity_Id
; Bytes_Big_Endian
: Boolean) is
854 procedure Compute_Max_Length
856 Starting_Position
: Uint
:= Uint_0
;
857 Starting_First_Bit
: Uint
:= Uint_0
;
858 Prefix_Length
: Natural := 0);
859 -- Internal recursive procedure to compute the max length
861 procedure List_Record_Layout
863 Starting_Position
: Uint
:= Uint_0
;
864 Starting_First_Bit
: Uint
:= Uint_0
;
865 Prefix
: String := "");
866 -- Internal recursive procedure to display the layout
868 Max_Name_Length
: Natural := 0;
869 Max_Spos_Length
: Natural := 0;
871 ------------------------
872 -- Compute_Max_Length --
873 ------------------------
875 procedure Compute_Max_Length
877 Starting_Position
: Uint
:= Uint_0
;
878 Starting_First_Bit
: Uint
:= Uint_0
;
879 Prefix_Length
: Natural := 0)
884 Comp
:= First_Component_Or_Discriminant
(Ent
);
885 while Present
(Comp
) loop
887 -- Skip discriminant in unchecked union (since it is not there!)
889 if Ekind
(Comp
) = E_Discriminant
890 and then Is_Unchecked_Union
(Ent
)
898 Ctyp
: constant Entity_Id
:= Underlying_Type
(Etype
(Comp
));
899 Bofs
: constant Uint
:= Component_Bit_Offset
(Comp
);
905 Name_Length
: Natural;
908 Get_Decoded_Name_String
(Chars
(Comp
));
909 Name_Length
:= Prefix_Length
+ Name_Len
;
911 if Rep_Not_Constant
(Bofs
) then
913 -- If the record is not packed, then we know that all fields
914 -- whose position is not specified have starting normalized
915 -- bit position of zero.
917 if Unknown_Normalized_First_Bit
(Comp
)
918 and then not Is_Packed
(Ent
)
920 Set_Normalized_First_Bit
(Comp
, Uint_0
);
923 UI_Image_Length
:= 2; -- For "??" marker
926 Fbit
:= Bofs
mod SSU
;
928 -- Complete annotation in case not done
930 if Unknown_Normalized_First_Bit
(Comp
) then
931 Set_Normalized_Position
(Comp
, Npos
);
932 Set_Normalized_First_Bit
(Comp
, Fbit
);
935 Spos
:= Starting_Position
+ Npos
;
936 Sbit
:= Starting_First_Bit
+ Fbit
;
943 -- If extended information is requested, recurse fully into
944 -- record components, i.e. skip the outer level.
946 if List_Representation_Info_Extended
947 and then Is_Record_Type
(Ctyp
)
949 Compute_Max_Length
(Ctyp
, Spos
, Sbit
, Name_Length
+ 1);
956 Max_Name_Length
:= Natural'Max (Max_Name_Length
, Name_Length
);
958 Natural'Max (Max_Spos_Length
, UI_Image_Length
);
962 Next_Component_Or_Discriminant
(Comp
);
964 end Compute_Max_Length
;
966 ------------------------
967 -- List_Record_Layout --
968 ------------------------
970 procedure List_Record_Layout
972 Starting_Position
: Uint
:= Uint_0
;
973 Starting_First_Bit
: Uint
:= Uint_0
;
974 Prefix
: String := "")
979 Comp
:= First_Component_Or_Discriminant
(Ent
);
980 while Present
(Comp
) loop
982 -- Skip discriminant in unchecked union (since it is not there!)
984 if Ekind
(Comp
) = E_Discriminant
985 and then Is_Unchecked_Union
(Ent
)
993 Ctyp
: constant Entity_Id
:= Underlying_Type
(Etype
(Comp
));
994 Esiz
: constant Uint
:= Esize
(Comp
);
995 Bofs
: constant Uint
:= Component_Bit_Offset
(Comp
);
996 Npos
: constant Uint
:= Normalized_Position
(Comp
);
997 Fbit
: constant Uint
:= Normalized_First_Bit
(Comp
);
1003 Get_Decoded_Name_String
(Chars
(Comp
));
1004 Set_Casing
(Unit_Casing
);
1006 -- If extended information is requested, recurse fully into
1007 -- record components, i.e. skip the outer level.
1009 if List_Representation_Info_Extended
1010 and then Is_Record_Type
(Ctyp
)
1011 and then Known_Static_Normalized_Position
(Comp
)
1012 and then Known_Static_Normalized_First_Bit
(Comp
)
1014 Spos
:= Starting_Position
+ Npos
;
1015 Sbit
:= Starting_First_Bit
+ Fbit
;
1022 List_Record_Layout
(Ctyp
,
1023 Spos
, Sbit
, Prefix
& Name_Buffer
(1 .. Name_Len
) & ".");
1030 Write_Str
(Name_Buffer
(1 .. Name_Len
));
1032 for J
in 1 .. Max_Name_Length
- Prefix
'Length - Name_Len
loop
1038 if Known_Static_Normalized_Position
(Comp
) then
1039 Spos
:= Starting_Position
+ Npos
;
1040 Sbit
:= Starting_First_Bit
+ Fbit
;
1047 Spaces
(Max_Spos_Length
- UI_Image_Length
);
1048 Write_Str
(UI_Image_Buffer
(1 .. UI_Image_Length
));
1050 elsif Known_Component_Bit_Offset
(Comp
)
1051 and then List_Representation_Info
= 3
1053 Spaces
(Max_Spos_Length
- 2);
1054 Write_Str
("bit offset ");
1056 if Starting_Position
/= Uint_0
1057 or else Starting_First_Bit
/= Uint_0
1059 UI_Write
(Starting_Position
* SSU
+ Starting_First_Bit
);
1063 Write_Val
(Bofs
, Paren
=> True);
1064 Write_Str
(" size in bits = ");
1065 Write_Val
(Esiz
, Paren
=> True);
1070 elsif Known_Normalized_Position
(Comp
)
1071 and then List_Representation_Info
= 3
1073 Spaces
(Max_Spos_Length
- 2);
1075 if Starting_Position
/= Uint_0
then
1077 UI_Write
(Starting_Position
);
1084 -- For the packed case, we don't know the bit positions if
1085 -- we don't know the starting position.
1087 if Is_Packed
(Ent
) then
1088 Write_Line
("?? range ? .. ??;");
1091 -- Otherwise we can continue
1098 Write_Str
(" range ");
1099 Sbit
:= Starting_First_Bit
+ Fbit
;
1108 -- Allowing Uint_0 here is an annoying special case. Really
1109 -- this should be a fine Esize value but currently it means
1110 -- unknown, except that we know after gigi has back annotated
1111 -- that a size of zero is real, since otherwise gigi back
1112 -- annotates using No_Uint as the value to indicate unknown).
1114 if (Esize
(Comp
) = Uint_0
or else Known_Static_Esize
(Comp
))
1115 and then Known_Static_Normalized_First_Bit
(Comp
)
1117 Lbit
:= Sbit
+ Esiz
- 1;
1125 -- The test for Esize (Comp) not Uint_0 here is an annoying
1126 -- special case. Officially a value of zero for Esize means
1127 -- unknown, but here we use the fact that we know that gigi
1128 -- annotates Esize with No_Uint, not Uint_0. Really everyone
1129 -- should use No_Uint???
1131 elsif List_Representation_Info
< 3
1132 or else (Esize
(Comp
) /= Uint_0
and then Unknown_Esize
(Comp
))
1136 -- List_Representation >= 3 and Known_Esize (Comp)
1139 Write_Val
(Esiz
, Paren
=> True);
1141 -- If in front end layout mode, then dynamic size is stored
1142 -- in storage units, so renormalize for output
1144 if not Back_End_Layout
then
1149 -- Add appropriate first bit offset
1159 Write_Int
(UI_To_Int
(Sbit
) - 1);
1167 Next_Component_Or_Discriminant
(Comp
);
1169 end List_Record_Layout
;
1171 -- Start of processing for List_Record_Info
1175 List_Type_Info
(Ent
);
1179 Write_Line
(" use record");
1181 -- First find out max line length and max starting position
1182 -- length, for the purpose of lining things up nicely.
1184 Compute_Max_Length
(Ent
);
1186 -- Then do actual output based on those values
1188 List_Record_Layout
(Ent
);
1190 Write_Line
("end record;");
1192 List_Scalar_Storage_Order
(Ent
, Bytes_Big_Endian
);
1193 end List_Record_Info
;
1199 procedure List_Rep_Info
(Bytes_Big_Endian
: Boolean) is
1203 if List_Representation_Info
/= 0
1204 or else List_Representation_Info_Mechanisms
1206 for U
in Main_Unit
.. Last_Unit
loop
1207 if In_Extended_Main_Source_Unit
(Cunit_Entity
(U
)) then
1208 Unit_Casing
:= Identifier_Casing
(Source_Index
(U
));
1210 -- Normal case, list to standard output
1212 if not List_Representation_Info_To_File
then
1214 Write_Str
("Representation information for unit ");
1215 Write_Unit_Name
(Unit_Name
(U
));
1219 for J
in 1 .. Col
- 1 loop
1224 List_Entities
(Cunit_Entity
(U
), Bytes_Big_Endian
);
1226 -- List representation information to file
1229 Create_Repinfo_File_Access
.all
1230 (Get_Name_String
(File_Name
(Source_Index
(U
))));
1231 Set_Special_Output
(Write_Info_Line
'Access);
1232 List_Entities
(Cunit_Entity
(U
), Bytes_Big_Endian
);
1233 Set_Special_Output
(null);
1234 Close_Repinfo_File_Access
.all;
1241 -------------------------------
1242 -- List_Scalar_Storage_Order --
1243 -------------------------------
1245 procedure List_Scalar_Storage_Order
1247 Bytes_Big_Endian
: Boolean)
1249 procedure List_Attr
(Attr_Name
: String; Is_Reversed
: Boolean);
1250 -- Show attribute definition clause for Attr_Name (an endianness
1251 -- attribute), depending on whether or not the endianness is reversed
1252 -- compared to native endianness.
1258 procedure List_Attr
(Attr_Name
: String; Is_Reversed
: Boolean) is
1262 Write_Str
("'" & Attr_Name
& " use System.");
1264 if Bytes_Big_Endian
xor Is_Reversed
then
1270 Write_Line
("_Order_First;");
1273 List_SSO
: constant Boolean :=
1274 Has_Rep_Item
(Ent
, Name_Scalar_Storage_Order
)
1275 or else SSO_Set_Low_By_Default
(Ent
)
1276 or else SSO_Set_High_By_Default
(Ent
);
1277 -- Scalar_Storage_Order is displayed if specified explicitly
1278 -- or set by Default_Scalar_Storage_Order.
1280 -- Start of processing for List_Scalar_Storage_Order
1283 -- For record types, list Bit_Order if not default, or if SSO is shown
1285 if Is_Record_Type
(Ent
)
1286 and then (List_SSO
or else Reverse_Bit_Order
(Ent
))
1288 List_Attr
("Bit_Order", Reverse_Bit_Order
(Ent
));
1291 -- List SSO if required. If not, then storage is supposed to be in
1295 List_Attr
("Scalar_Storage_Order", Reverse_Storage_Order
(Ent
));
1297 pragma Assert
(not Reverse_Storage_Order
(Ent
));
1300 end List_Scalar_Storage_Order
;
1302 --------------------
1303 -- List_Type_Info --
1304 --------------------
1306 procedure List_Type_Info
(Ent
: Entity_Id
) is
1310 -- Do not list size info for unconstrained arrays, not meaningful
1312 if Is_Array_Type
(Ent
) and then not Is_Constrained
(Ent
) then
1316 -- If Esize and RM_Size are the same and known, list as Size. This
1317 -- is a common case, which we may as well list in simple form.
1319 if Esize
(Ent
) = RM_Size
(Ent
) then
1322 Write_Str
("'Size use ");
1323 Write_Val
(Esize
(Ent
));
1326 -- For now, temporary case, to be removed when gigi properly back
1327 -- annotates RM_Size, if RM_Size is not set, then list Esize as Size.
1328 -- This avoids odd Object_Size output till we fix things???
1330 elsif Unknown_RM_Size
(Ent
) then
1333 Write_Str
("'Size use ");
1334 Write_Val
(Esize
(Ent
));
1337 -- Otherwise list size values separately if they are set
1342 Write_Str
("'Object_Size use ");
1343 Write_Val
(Esize
(Ent
));
1346 -- Note on following check: The RM_Size of a discrete type can
1347 -- legitimately be set to zero, so a special check is needed.
1351 Write_Str
("'Value_Size use ");
1352 Write_Val
(RM_Size
(Ent
));
1359 Write_Str
("'Alignment use ");
1360 Write_Val
(Alignment
(Ent
));
1363 -- Special stuff for fixed-point
1365 if Is_Fixed_Point_Type
(Ent
) then
1367 -- Write small (always a static constant)
1371 Write_Str
("'Small use ");
1372 UR_Write
(Small_Value
(Ent
));
1375 -- Write range if static
1378 R
: constant Node_Id
:= Scalar_Range
(Ent
);
1381 if Nkind
(Low_Bound
(R
)) = N_Real_Literal
1383 Nkind
(High_Bound
(R
)) = N_Real_Literal
1387 Write_Str
("'Range use ");
1388 UR_Write
(Realval
(Low_Bound
(R
)));
1390 UR_Write
(Realval
(High_Bound
(R
)));
1397 ----------------------
1398 -- Rep_Not_Constant --
1399 ----------------------
1401 function Rep_Not_Constant
(Val
: Node_Ref_Or_Val
) return Boolean is
1403 if Val
= No_Uint
or else Val
< 0 then
1408 end Rep_Not_Constant
;
1415 (Val
: Node_Ref_Or_Val
;
1416 D
: Discrim_List
) return Uint
1418 function B
(Val
: Boolean) return Uint
;
1419 -- Returns Uint_0 for False, Uint_1 for True
1421 function T
(Val
: Node_Ref_Or_Val
) return Boolean;
1422 -- Returns True for 0, False for any non-zero (i.e. True)
1424 function V
(Val
: Node_Ref_Or_Val
) return Uint
;
1425 -- Internal recursive routine to evaluate tree
1427 function W
(Val
: Uint
) return Word
;
1428 -- Convert Val to Word, assuming Val is always in the Int range. This
1429 -- is a helper function for the evaluation of bitwise expressions like
1430 -- Bit_And_Expr, for which there is no direct support in uintp. Uint
1431 -- values out of the Int range are expected to be seen in such
1432 -- expressions only with overflowing byte sizes around, introducing
1433 -- inherent unreliabilities in computations anyway.
1439 function B
(Val
: Boolean) return Uint
is
1452 function T
(Val
: Node_Ref_Or_Val
) return Boolean is
1465 function V
(Val
: Node_Ref_Or_Val
) return Uint
is
1474 Node
: Exp_Node
renames Rep_Table
.Table
(-UI_To_Int
(Val
));
1479 if T
(Node
.Op1
) then
1480 return V
(Node
.Op2
);
1482 return V
(Node
.Op3
);
1486 return V
(Node
.Op1
) + V
(Node
.Op2
);
1489 return V
(Node
.Op1
) - V
(Node
.Op2
);
1492 return V
(Node
.Op1
) * V
(Node
.Op2
);
1494 when Trunc_Div_Expr
=>
1495 return V
(Node
.Op1
) / V
(Node
.Op2
);
1497 when Ceil_Div_Expr
=>
1500 (V
(Node
.Op1
) / UR_From_Uint
(V
(Node
.Op2
)));
1502 when Floor_Div_Expr
=>
1505 (V
(Node
.Op1
) / UR_From_Uint
(V
(Node
.Op2
)));
1507 when Trunc_Mod_Expr
=>
1508 return V
(Node
.Op1
) rem V
(Node
.Op2
);
1510 when Floor_Mod_Expr
=>
1511 return V
(Node
.Op1
) mod V
(Node
.Op2
);
1513 when Ceil_Mod_Expr
=>
1516 Q
:= UR_Ceiling
(L
/ UR_From_Uint
(R
));
1519 when Exact_Div_Expr
=>
1520 return V
(Node
.Op1
) / V
(Node
.Op2
);
1523 return -V
(Node
.Op1
);
1526 return UI_Min
(V
(Node
.Op1
), V
(Node
.Op2
));
1529 return UI_Max
(V
(Node
.Op1
), V
(Node
.Op2
));
1532 return UI_Abs
(V
(Node
.Op1
));
1534 when Truth_Andif_Expr
=>
1535 return B
(T
(Node
.Op1
) and then T
(Node
.Op2
));
1537 when Truth_Orif_Expr
=>
1538 return B
(T
(Node
.Op1
) or else T
(Node
.Op2
));
1540 when Truth_And_Expr
=>
1541 return B
(T
(Node
.Op1
) and then T
(Node
.Op2
));
1543 when Truth_Or_Expr
=>
1544 return B
(T
(Node
.Op1
) or else T
(Node
.Op2
));
1546 when Truth_Xor_Expr
=>
1547 return B
(T
(Node
.Op1
) xor T
(Node
.Op2
));
1549 when Truth_Not_Expr
=>
1550 return B
(not T
(Node
.Op1
));
1552 when Bit_And_Expr
=>
1555 return UI_From_Int
(Int
(W
(L
) and W
(R
)));
1558 return B
(V
(Node
.Op1
) < V
(Node
.Op2
));
1561 return B
(V
(Node
.Op1
) <= V
(Node
.Op2
));
1564 return B
(V
(Node
.Op1
) > V
(Node
.Op2
));
1567 return B
(V
(Node
.Op1
) >= V
(Node
.Op2
));
1570 return B
(V
(Node
.Op1
) = V
(Node
.Op2
));
1573 return B
(V
(Node
.Op1
) /= V
(Node
.Op2
));
1577 Sub
: constant Int
:= UI_To_Int
(Node
.Op1
);
1579 pragma Assert
(Sub
in D
'Range);
1594 -- We use an unchecked conversion to map Int values to their Word
1595 -- bitwise equivalent, which we could not achieve with a normal type
1596 -- conversion for negative Ints. We want bitwise equivalents because W
1597 -- is used as a helper for bit operators like Bit_And_Expr, and can be
1598 -- called for negative Ints in the context of aligning expressions like
1599 -- X+Align & -Align.
1601 function W
(Val
: Uint
) return Word
is
1602 function To_Word
is new Ada
.Unchecked_Conversion
(Int
, Word
);
1604 return To_Word
(UI_To_Int
(Val
));
1607 -- Start of processing for Rep_Value
1610 if Val
= No_Uint
then
1622 procedure Spaces
(N
: Natural) is
1624 for J
in 1 .. N
loop
1633 procedure Tree_Read
is
1635 Rep_Table
.Tree_Read
;
1642 procedure Tree_Write
is
1644 Rep_Table
.Tree_Write
;
1647 ---------------------
1648 -- Write_Info_Line --
1649 ---------------------
1651 procedure Write_Info_Line
(S
: String) is
1653 Write_Repinfo_Line_Access
.all (S
(S
'First .. S
'Last - 1));
1654 end Write_Info_Line
;
1656 ---------------------
1657 -- Write_Mechanism --
1658 ---------------------
1660 procedure Write_Mechanism
(M
: Mechanism_Type
) is
1664 Write_Str
("default");
1670 Write_Str
("reference");
1673 raise Program_Error
;
1675 end Write_Mechanism
;
1681 procedure Write_Val
(Val
: Node_Ref_Or_Val
; Paren
: Boolean := False) is
1683 if Rep_Not_Constant
(Val
) then
1684 if List_Representation_Info
< 3 or else Val
= No_Uint
then
1692 if Back_End_Layout
then
1693 List_GCC_Expression
(Val
);
1695 Write_Name_Decoded
(Chars
(Get_Dynamic_SO_Entity
(Val
)));