1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2012, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 with Atree
; use Atree
;
27 with Casing
; use Casing
;
28 with Debug
; use Debug
;
29 with Einfo
; use Einfo
;
30 with Errout
; use Errout
;
31 with Exp_Ch11
; use Exp_Ch11
;
32 with Exp_Util
; use Exp_Util
;
33 with Expander
; use Expander
;
34 with Namet
; use Namet
;
35 with Nlists
; use Nlists
;
36 with Nmake
; use Nmake
;
38 with Restrict
; use Restrict
;
39 with Rident
; use Rident
;
40 with Rtsfind
; use Rtsfind
;
42 with Sem_Res
; use Sem_Res
;
43 with Sem_Util
; use Sem_Util
;
44 with Sinfo
; use Sinfo
;
45 with Sinput
; use Sinput
;
46 with Snames
; use Snames
;
47 with Stringt
; use Stringt
;
48 with Stand
; use Stand
;
49 with Targparm
; use Targparm
;
50 with Tbuild
; use Tbuild
;
51 with Uintp
; use Uintp
;
53 package body Exp_Prag
is
55 -----------------------
56 -- Local Subprograms --
57 -----------------------
59 function Arg1
(N
: Node_Id
) return Node_Id
;
60 function Arg2
(N
: Node_Id
) return Node_Id
;
61 function Arg3
(N
: Node_Id
) return Node_Id
;
62 -- Obtain specified pragma argument expression
64 procedure Expand_Pragma_Abort_Defer
(N
: Node_Id
);
65 procedure Expand_Pragma_Check
(N
: Node_Id
);
66 procedure Expand_Pragma_Common_Object
(N
: Node_Id
);
67 procedure Expand_Pragma_Import_Or_Interface
(N
: Node_Id
);
68 procedure Expand_Pragma_Import_Export_Exception
(N
: Node_Id
);
69 procedure Expand_Pragma_Inspection_Point
(N
: Node_Id
);
70 procedure Expand_Pragma_Interrupt_Priority
(N
: Node_Id
);
71 procedure Expand_Pragma_Psect_Object
(N
: Node_Id
);
72 procedure Expand_Pragma_Relative_Deadline
(N
: Node_Id
);
78 function Arg1
(N
: Node_Id
) return Node_Id
is
79 Arg
: constant Node_Id
:= First
(Pragma_Argument_Associations
(N
));
82 and then Nkind
(Arg
) = N_Pragma_Argument_Association
84 return Expression
(Arg
);
94 function Arg2
(N
: Node_Id
) return Node_Id
is
95 Arg1
: constant Node_Id
:= First
(Pragma_Argument_Associations
(N
));
103 Arg
: constant Node_Id
:= Next
(Arg1
);
106 and then Nkind
(Arg
) = N_Pragma_Argument_Association
108 return Expression
(Arg
);
120 function Arg3
(N
: Node_Id
) return Node_Id
is
121 Arg1
: constant Node_Id
:= First
(Pragma_Argument_Associations
(N
));
129 Arg
: Node_Id
:= Next
(Arg1
);
138 and then Nkind
(Arg
) = N_Pragma_Argument_Association
140 return Expression
(Arg
);
149 ---------------------
150 -- Expand_N_Pragma --
151 ---------------------
153 procedure Expand_N_Pragma
(N
: Node_Id
) is
154 Pname
: constant Name_Id
:= Pragma_Name
(N
);
157 -- Note: we may have a pragma whose Pragma_Identifier field is not a
158 -- recognized pragma, and we must ignore it at this stage.
160 if Is_Pragma_Name
(Pname
) then
161 case Get_Pragma_Id
(Pname
) is
163 -- Pragmas requiring special expander action
165 when Pragma_Abort_Defer
=>
166 Expand_Pragma_Abort_Defer
(N
);
169 Expand_Pragma_Check
(N
);
171 when Pragma_Common_Object
=>
172 Expand_Pragma_Common_Object
(N
);
174 when Pragma_Export_Exception
=>
175 Expand_Pragma_Import_Export_Exception
(N
);
177 when Pragma_Import
=>
178 Expand_Pragma_Import_Or_Interface
(N
);
180 when Pragma_Import_Exception
=>
181 Expand_Pragma_Import_Export_Exception
(N
);
183 when Pragma_Inspection_Point
=>
184 Expand_Pragma_Inspection_Point
(N
);
186 when Pragma_Interface
=>
187 Expand_Pragma_Import_Or_Interface
(N
);
189 when Pragma_Interrupt_Priority
=>
190 Expand_Pragma_Interrupt_Priority
(N
);
192 when Pragma_Psect_Object
=>
193 Expand_Pragma_Psect_Object
(N
);
195 when Pragma_Relative_Deadline
=>
196 Expand_Pragma_Relative_Deadline
(N
);
198 -- All other pragmas need no expander action
206 -------------------------------
207 -- Expand_Pragma_Abort_Defer --
208 -------------------------------
210 -- An Abort_Defer pragma appears as the first statement in a handled
211 -- statement sequence (right after the begin). It defers aborts for
212 -- the entire statement sequence, but not for any declarations or
213 -- handlers (if any) associated with this statement sequence.
215 -- The transformation is to transform
217 -- pragma Abort_Defer;
226 -- when all others =>
227 -- Abort_Undefer.all;
230 -- Abort_Undefer_Direct;
233 procedure Expand_Pragma_Abort_Defer
(N
: Node_Id
) is
234 Loc
: constant Source_Ptr
:= Sloc
(N
);
238 Blk
: constant Entity_Id
:=
239 New_Internal_Entity
(E_Block
, Current_Scope
, Sloc
(N
), 'B');
242 Stms
:= New_List
(Build_Runtime_Call
(Loc
, RE_Abort_Defer
));
245 Stm
:= Remove_Next
(N
);
251 Make_Handled_Sequence_Of_Statements
(Loc
,
254 New_Occurrence_Of
(RTE
(RE_Abort_Undefer_Direct
), Loc
));
257 Make_Block_Statement
(Loc
,
258 Handled_Statement_Sequence
=> HSS
));
260 Set_Scope
(Blk
, Current_Scope
);
261 Set_Etype
(Blk
, Standard_Void_Type
);
262 Set_Identifier
(N
, New_Occurrence_Of
(Blk
, Sloc
(N
)));
263 Expand_At_End_Handler
(HSS
, Blk
);
265 end Expand_Pragma_Abort_Defer
;
267 --------------------------
268 -- Expand_Pragma_Check --
269 --------------------------
271 procedure Expand_Pragma_Check
(N
: Node_Id
) is
272 Cond
: constant Node_Id
:= Arg2
(N
);
273 Nam
: constant Name_Id
:= Chars
(Arg1
(N
));
276 Loc
: constant Source_Ptr
:= Sloc
(First_Node
(Cond
));
277 -- Source location used in the case of a failed assertion. Note that
278 -- the source location of the expression is not usually the best choice
279 -- here. For example, it gets located on the last AND keyword in a
280 -- chain of boolean expressiond AND'ed together. It is best to put the
281 -- message on the first character of the assertion, which is the effect
282 -- of the First_Node call here.
285 -- We already know that this check is enabled, because otherwise the
286 -- semantic pass dealt with rewriting the assertion (see Sem_Prag)
288 -- Since this check is enabled, we rewrite the pragma into a
289 -- corresponding if statement, and then analyze the statement
291 -- The normal case expansion transforms:
293 -- pragma Check (name, condition [,message]);
297 -- if not condition then
298 -- System.Assertions.Raise_Assert_Failure (Str);
301 -- where Str is the message if one is present, or the default of
302 -- name failed at file:line if no message is given (the "name failed
303 -- at" is omitted for name = Assertion, since it is redundant, given
304 -- that the name of the exception is Assert_Failure.)
306 -- An alternative expansion is used when the No_Exception_Propagation
307 -- restriction is active and there is a local Assert_Failure handler.
308 -- This is not a common combination of circumstances, but it occurs in
309 -- the context of Aunit and the zero footprint profile. In this case we
312 -- if not condition then
313 -- raise Assert_Failure;
316 -- This will then be transformed into a goto, and the local handler will
317 -- be able to handle the assert error (which would not be the case if a
318 -- call is made to the Raise_Assert_Failure procedure).
320 -- We also generate the direct raise if the Suppress_Exception_Locations
321 -- is active, since we don't want to generate messages in this case.
323 -- Note that the reason we do not always generate a direct raise is that
324 -- the form in which the procedure is called allows for more efficient
325 -- breakpointing of assertion errors.
327 -- Generate the appropriate if statement. Note that we consider this to
328 -- be an explicit conditional in the source, not an implicit if, so we
329 -- do not call Make_Implicit_If_Statement.
331 -- Case where we generate a direct raise
333 if ((Debug_Flag_Dot_G
334 or else Restriction_Active
(No_Exception_Propagation
))
335 and then Present
(Find_Local_Handler
(RTE
(RE_Assert_Failure
), N
)))
336 or else (Opt
.Exception_Locations_Suppressed
and then No
(Arg3
(N
)))
339 Make_If_Statement
(Loc
,
343 Then_Statements
=> New_List
(
344 Make_Raise_Statement
(Loc
,
346 New_Reference_To
(RTE
(RE_Assert_Failure
), Loc
)))));
348 -- Case where we call the procedure
351 -- If we have a message given, use it
353 if Present
(Arg3
(N
)) then
354 Msg
:= Get_Pragma_Arg
(Arg3
(N
));
356 -- Here we have no string, so prepare one
360 Msg_Loc
: constant String := Build_Location_String
(Loc
);
365 -- For Assert, we just use the location
367 if Nam
= Name_Assertion
then
370 -- For predicate, we generate the string "predicate failed
371 -- at yyy". We prefer all lower case for predicate.
373 elsif Nam
= Name_Predicate
then
374 Add_Str_To_Name_Buffer
("predicate failed at ");
376 -- For special case of Precondition/Postcondition the string is
377 -- "failed xx from yy" where xx is precondition/postcondition
378 -- in all lower case. The reason for this different wording is
379 -- that the failure is not at the point of occurrence of the
380 -- pragma, unlike the other Check cases.
382 elsif Nam
= Name_Precondition
384 Nam
= Name_Postcondition
386 Get_Name_String
(Nam
);
387 Insert_Str_In_Name_Buffer
("failed ", 1);
388 Add_Str_To_Name_Buffer
(" from ");
390 -- For all other checks, the string is "xxx failed at yyy"
391 -- where xxx is the check name with current source file casing.
394 Get_Name_String
(Nam
);
395 Set_Casing
(Identifier_Casing
(Current_Source_File
));
396 Add_Str_To_Name_Buffer
(" failed at ");
399 -- In all cases, add location string
401 Add_Str_To_Name_Buffer
(Msg_Loc
);
405 Msg
:= Make_String_Literal
(Loc
, Name_Buffer
(1 .. Name_Len
));
409 -- Now rewrite as an if statement
412 Make_If_Statement
(Loc
,
416 Then_Statements
=> New_List
(
417 Make_Procedure_Call_Statement
(Loc
,
419 New_Reference_To
(RTE
(RE_Raise_Assert_Failure
), Loc
),
420 Parameter_Associations
=> New_List
(Relocate_Node
(Msg
))))));
425 -- If new condition is always false, give a warning
427 if Warn_On_Assertion_Failure
428 and then Nkind
(N
) = N_Procedure_Call_Statement
429 and then Is_RTE
(Entity
(Name
(N
)), RE_Raise_Assert_Failure
)
431 -- If original condition was a Standard.False, we assume that this is
432 -- indeed intended to raise assert error and no warning is required.
434 if Is_Entity_Name
(Original_Node
(Cond
))
435 and then Entity
(Original_Node
(Cond
)) = Standard_False
438 elsif Nam
= Name_Assertion
then
439 Error_Msg_N
("?assertion will fail at run time", N
);
441 Error_Msg_N
("?check will fail at run time", N
);
444 end Expand_Pragma_Check
;
446 ---------------------------------
447 -- Expand_Pragma_Common_Object --
448 ---------------------------------
450 -- Use a machine attribute to replicate semantic effect in DEC Ada
452 -- pragma Machine_Attribute (intern_name, "common_object", extern_name);
454 -- For now we do nothing with the size attribute ???
456 -- Note: Psect_Object shares this processing
458 procedure Expand_Pragma_Common_Object
(N
: Node_Id
) is
459 Loc
: constant Source_Ptr
:= Sloc
(N
);
461 Internal
: constant Node_Id
:= Arg1
(N
);
462 External
: constant Node_Id
:= Arg2
(N
);
465 -- Psect value upper cased as string literal
467 Iloc
: constant Source_Ptr
:= Sloc
(Internal
);
468 Eloc
: constant Source_Ptr
:= Sloc
(External
);
472 -- Acquire Psect value and fold to upper case
474 if Present
(External
) then
475 if Nkind
(External
) = N_String_Literal
then
476 String_To_Name_Buffer
(Strval
(External
));
478 Get_Name_String
(Chars
(External
));
484 Make_String_Literal
(Eloc
,
485 Strval
=> String_From_Name_Buffer
);
488 Get_Name_String
(Chars
(Internal
));
491 Make_String_Literal
(Iloc
,
492 Strval
=> String_From_Name_Buffer
);
495 Ploc
:= Sloc
(Psect
);
499 Insert_After_And_Analyze
(N
,
501 Chars
=> Name_Machine_Attribute
,
502 Pragma_Argument_Associations
=> New_List
(
503 Make_Pragma_Argument_Association
(Iloc
,
504 Expression
=> New_Copy_Tree
(Internal
)),
505 Make_Pragma_Argument_Association
(Eloc
,
507 Make_String_Literal
(Sloc
=> Ploc
,
508 Strval
=> "common_object")),
509 Make_Pragma_Argument_Association
(Ploc
,
510 Expression
=> New_Copy_Tree
(Psect
)))));
512 end Expand_Pragma_Common_Object
;
514 ---------------------------------------
515 -- Expand_Pragma_Import_Or_Interface --
516 ---------------------------------------
518 -- When applied to a variable, the default initialization must not be
519 -- done. As it is already done when the pragma is found, we just get rid
520 -- of the call the initialization procedure which followed the object
521 -- declaration. The call is inserted after the declaration, but validity
522 -- checks may also have been inserted and the initialization call does
523 -- not necessarily appear immediately after the object declaration.
525 -- We can't use the freezing mechanism for this purpose, since we
526 -- have to elaborate the initialization expression when it is first
527 -- seen (i.e. this elaboration cannot be deferred to the freeze point).
529 procedure Expand_Pragma_Import_Or_Interface
(N
: Node_Id
) is
534 Def_Id
:= Entity
(Arg2
(N
));
535 if Ekind
(Def_Id
) = E_Variable
then
537 -- Find generated initialization call for object, if any
539 Init_Call
:= Find_Init_Call
(Def_Id
, Rep_Clause
=> N
);
540 if Present
(Init_Call
) then
544 -- Any default initialization expression should be removed
545 -- (e.g., null defaults for access objects, zero initialization
546 -- of packed bit arrays). Imported objects aren't allowed to
547 -- have explicit initialization, so the expression must have
548 -- been generated by the compiler.
550 if No
(Init_Call
) and then Present
(Expression
(Parent
(Def_Id
))) then
551 Set_Expression
(Parent
(Def_Id
), Empty
);
554 end Expand_Pragma_Import_Or_Interface
;
556 -------------------------------------------
557 -- Expand_Pragma_Import_Export_Exception --
558 -------------------------------------------
560 -- For a VMS exception fix up the language field with "VMS"
561 -- instead of "Ada" (gigi needs this), create a constant that will be the
562 -- value of the VMS condition code and stuff the Interface_Name field
563 -- with the unexpanded name of the exception (if not already set).
564 -- For a Ada exception, just stuff the Interface_Name field
565 -- with the unexpanded name of the exception (if not already set).
567 procedure Expand_Pragma_Import_Export_Exception
(N
: Node_Id
) is
569 -- This pragma is only effective on OpenVMS systems, it was ignored
570 -- on non-VMS systems, and we need to ignore it here as well.
572 if not OpenVMS_On_Target
then
577 Id
: constant Entity_Id
:= Entity
(Arg1
(N
));
578 Call
: constant Node_Id
:= Register_Exception_Call
(Id
);
579 Loc
: constant Source_Ptr
:= Sloc
(N
);
582 if Present
(Call
) then
584 Excep_Internal
: constant Node_Id
:= Make_Temporary
(Loc
, 'V');
585 Export_Pragma
: Node_Id
;
586 Excep_Alias
: Node_Id
;
587 Excep_Object
: Node_Id
;
588 Excep_Image
: String_Id
;
594 if Present
(Interface_Name
(Id
)) then
595 Excep_Image
:= Strval
(Interface_Name
(Id
));
597 Get_Name_String
(Chars
(Id
));
599 Excep_Image
:= String_From_Name_Buffer
;
602 Exdata
:= Component_Associations
(Expression
(Parent
(Id
)));
604 if Is_VMS_Exception
(Id
) then
605 Lang_Char
:= Next
(First
(Exdata
));
607 -- Change the one-character language designator to 'V'
609 Rewrite
(Expression
(Lang_Char
),
610 Make_Character_Literal
(Loc
,
612 Char_Literal_Value
=>
613 UI_From_Int
(Character'Pos ('V'))));
614 Analyze
(Expression
(Lang_Char
));
616 if Exception_Code
(Id
) /= No_Uint
then
618 Make_Integer_Literal
(Loc
,
619 Intval
=> Exception_Code
(Id
));
622 Make_Object_Declaration
(Loc
,
623 Defining_Identifier
=> Excep_Internal
,
625 New_Reference_To
(RTE
(RE_Exception_Code
), Loc
));
627 Insert_Action
(N
, Excep_Object
);
628 Analyze
(Excep_Object
);
632 (UI_To_Int
(Exception_Code
(Id
)) / 8 * 8);
639 (Make_Pragma_Argument_Association
642 New_Reference_To
(Excep_Internal
, Loc
)),
644 Make_Pragma_Argument_Association
649 Strval
=> End_String
))));
651 Insert_Action
(N
, Excep_Alias
);
652 Analyze
(Excep_Alias
);
659 (Make_Pragma_Argument_Association
(Loc
,
660 Expression
=> Make_Identifier
(Loc
, Name_C
)),
662 Make_Pragma_Argument_Association
(Loc
,
664 New_Reference_To
(Excep_Internal
, Loc
)),
666 Make_Pragma_Argument_Association
(Loc
,
668 Make_String_Literal
(Loc
, Excep_Image
)),
670 Make_Pragma_Argument_Association
(Loc
,
672 Make_String_Literal
(Loc
, Excep_Image
))));
674 Insert_Action
(N
, Export_Pragma
);
675 Analyze
(Export_Pragma
);
679 Unchecked_Convert_To
(RTE
(RE_Exception_Code
),
680 Make_Function_Call
(Loc
,
682 New_Reference_To
(RTE
(RE_Import_Value
), Loc
),
683 Parameter_Associations
=> New_List
684 (Make_String_Literal
(Loc
,
685 Strval
=> Excep_Image
))));
689 Make_Procedure_Call_Statement
(Loc
,
690 Name
=> New_Reference_To
691 (RTE
(RE_Register_VMS_Exception
), Loc
),
692 Parameter_Associations
=> New_List
(
694 Unchecked_Convert_To
(RTE
(RE_Exception_Data_Ptr
),
695 Make_Attribute_Reference
(Loc
,
696 Prefix
=> New_Occurrence_Of
(Id
, Loc
),
697 Attribute_Name
=> Name_Unrestricted_Access
)))));
699 Analyze_And_Resolve
(Code
, RTE
(RE_Exception_Code
));
703 if No
(Interface_Name
(Id
)) then
704 Set_Interface_Name
(Id
,
707 Strval
=> Excep_Image
));
712 end Expand_Pragma_Import_Export_Exception
;
714 ------------------------------------
715 -- Expand_Pragma_Inspection_Point --
716 ------------------------------------
718 -- If no argument is given, then we supply a default argument list that
719 -- includes all objects declared at the source level in all subprograms
720 -- that enclose the inspection point pragma.
722 procedure Expand_Pragma_Inspection_Point
(N
: Node_Id
) is
723 Loc
: constant Source_Ptr
:= Sloc
(N
);
730 if No
(Pragma_Argument_Associations
(N
)) then
734 while S
/= Standard_Standard
loop
735 E
:= First_Entity
(S
);
736 while Present
(E
) loop
737 if Comes_From_Source
(E
)
738 and then Is_Object
(E
)
739 and then not Is_Entry_Formal
(E
)
740 and then Ekind
(E
) /= E_Component
741 and then Ekind
(E
) /= E_Discriminant
742 and then Ekind
(E
) /= E_Generic_In_Parameter
743 and then Ekind
(E
) /= E_Generic_In_Out_Parameter
746 Make_Pragma_Argument_Association
(Loc
,
747 Expression
=> New_Occurrence_Of
(E
, Loc
)));
756 Set_Pragma_Argument_Associations
(N
, A
);
759 -- Expand the arguments of the pragma. Expanding an entity reference
760 -- is a noop, except in a protected operation, where a reference may
761 -- have to be transformed into a reference to the corresponding prival.
762 -- Are there other pragmas that may require this ???
764 Assoc
:= First
(Pragma_Argument_Associations
(N
));
766 while Present
(Assoc
) loop
767 Expand
(Expression
(Assoc
));
770 end Expand_Pragma_Inspection_Point
;
772 --------------------------------------
773 -- Expand_Pragma_Interrupt_Priority --
774 --------------------------------------
776 -- Supply default argument if none exists (System.Interrupt_Priority'Last)
778 procedure Expand_Pragma_Interrupt_Priority
(N
: Node_Id
) is
779 Loc
: constant Source_Ptr
:= Sloc
(N
);
782 if No
(Pragma_Argument_Associations
(N
)) then
783 Set_Pragma_Argument_Associations
(N
, New_List
(
784 Make_Pragma_Argument_Association
(Loc
,
786 Make_Attribute_Reference
(Loc
,
788 New_Occurrence_Of
(RTE
(RE_Interrupt_Priority
), Loc
),
789 Attribute_Name
=> Name_Last
))));
791 end Expand_Pragma_Interrupt_Priority
;
793 --------------------------------
794 -- Expand_Pragma_Psect_Object --
795 --------------------------------
797 -- Convert to Common_Object, and expand the resulting pragma
799 procedure Expand_Pragma_Psect_Object
(N
: Node_Id
)
800 renames Expand_Pragma_Common_Object
;
802 -------------------------------------
803 -- Expand_Pragma_Relative_Deadline --
804 -------------------------------------
806 procedure Expand_Pragma_Relative_Deadline
(N
: Node_Id
) is
807 P
: constant Node_Id
:= Parent
(N
);
808 Loc
: constant Source_Ptr
:= Sloc
(N
);
811 -- Expand the pragma only in the case of the main subprogram. For tasks
812 -- the expansion is done in exp_ch9. Generate a call to Set_Deadline
813 -- at Clock plus the relative deadline specified in the pragma. Time
814 -- values are translated into Duration to allow for non-private
815 -- addition operation.
817 if Nkind
(P
) = N_Subprogram_Body
then
820 Make_Procedure_Call_Statement
(Loc
,
821 Name
=> New_Reference_To
(RTE
(RE_Set_Deadline
), Loc
),
822 Parameter_Associations
=> New_List
(
823 Unchecked_Convert_To
(RTE
(RO_RT_Time
),
826 Make_Function_Call
(Loc
,
827 New_Reference_To
(RTE
(RO_RT_To_Duration
), Loc
),
828 New_List
(Make_Function_Call
(Loc
,
829 New_Reference_To
(RTE
(RE_Clock
), Loc
)))),
831 Unchecked_Convert_To
(Standard_Duration
, Arg1
(N
)))))));
835 end Expand_Pragma_Relative_Deadline
;