1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2007, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 2, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING. If not, write --
19 -- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
20 -- Boston, MA 02110-1301, USA. --
22 -- GNAT was originally developed by the GNAT team at New York University. --
23 -- Extensive contributions were provided by Ada Core Technologies Inc. --
25 ------------------------------------------------------------------------------
27 -- This unit contains the semantic processing for all pragmas, both language
28 -- and implementation defined. For most pragmas, the parser only does the
29 -- most basic job of checking the syntax, so Sem_Prag also contains the code
30 -- to complete the syntax checks. Certain pragmas are handled partially or
31 -- completely by the parser (see Par.Prag for further details).
33 with Atree; use Atree;
34 with Casing; use Casing;
35 with Checks; use Checks;
36 with Csets; use Csets;
37 with Debug; use Debug;
38 with Einfo; use Einfo;
39 with Errout; use Errout;
40 with Exp_Dist; use Exp_Dist;
42 with Lib.Writ; use Lib.Writ;
43 with Lib.Xref; use Lib.Xref;
44 with Namet; use Namet;
45 with Nlists; use Nlists;
46 with Nmake; use Nmake;
48 with Output; use Output;
49 with Restrict; use Restrict;
50 with Rident; use Rident;
51 with Rtsfind; use Rtsfind;
53 with Sem_Ch3; use Sem_Ch3;
54 with Sem_Ch8; use Sem_Ch8;
55 with Sem_Ch13; use Sem_Ch13;
56 with Sem_Dist; use Sem_Dist;
57 with Sem_Elim; use Sem_Elim;
58 with Sem_Eval; use Sem_Eval;
59 with Sem_Intr; use Sem_Intr;
60 with Sem_Mech; use Sem_Mech;
61 with Sem_Res; use Sem_Res;
62 with Sem_Type; use Sem_Type;
63 with Sem_Util; use Sem_Util;
64 with Sem_VFpt; use Sem_VFpt;
65 with Sem_Warn; use Sem_Warn;
66 with Stand; use Stand;
67 with Sinfo; use Sinfo;
68 with Sinfo.CN; use Sinfo.CN;
69 with Sinput; use Sinput;
70 with Snames; use Snames;
71 with Stringt; use Stringt;
72 with Stylesw; use Stylesw;
74 with Targparm; use Targparm;
75 with Tbuild; use Tbuild;
77 with Uintp; use Uintp;
78 with Urealp; use Urealp;
79 with Validsw; use Validsw;
81 with GNAT.Spelling_Checker; use GNAT.Spelling_Checker;
83 package body Sem_Prag is
85 ----------------------------------------------
86 -- Common Handling of Import-Export Pragmas --
87 ----------------------------------------------
89 -- In the following section, a number of Import_xxx and Export_xxx
90 -- pragmas are defined by GNAT. These are compatible with the DEC
91 -- pragmas of the same name, and all have the following common
92 -- form and processing:
95 -- [Internal =>] LOCAL_NAME,
96 -- [, [External =>] EXTERNAL_SYMBOL]
97 -- [, other optional parameters ]);
100 -- [Internal =>] LOCAL_NAME,
101 -- [, [External =>] EXTERNAL_SYMBOL]
102 -- [, other optional parameters ]);
104 -- EXTERNAL_SYMBOL ::=
106 -- | static_string_EXPRESSION
108 -- The internal LOCAL_NAME designates the entity that is imported or
109 -- exported, and must refer to an entity in the current declarative
110 -- part (as required by the rules for LOCAL_NAME).
112 -- The external linker name is designated by the External parameter
113 -- if given, or the Internal parameter if not (if there is no External
114 -- parameter, the External parameter is a copy of the Internal name).
116 -- If the External parameter is given as a string, then this string
117 -- is treated as an external name (exactly as though it had been given
118 -- as an External_Name parameter for a normal Import pragma).
120 -- If the External parameter is given as an identifier (or there is no
121 -- External parameter, so that the Internal identifier is used), then
122 -- the external name is the characters of the identifier, translated
123 -- to all upper case letters for OpenVMS versions of GNAT, and to all
124 -- lower case letters for all other versions
126 -- Note: the external name specified or implied by any of these special
127 -- Import_xxx or Export_xxx pragmas override an external or link name
128 -- specified in a previous Import or Export pragma.
130 -- Note: these and all other DEC-compatible GNAT pragmas allow full
131 -- use of named notation, following the standard rules for subprogram
132 -- calls, i.e. parameters can be given in any order if named notation
133 -- is used, and positional and named notation can be mixed, subject to
134 -- the rule that all positional parameters must appear first.
136 -- Note: All these pragmas are implemented exactly following the DEC
137 -- design and implementation and are intended to be fully compatible
138 -- with the use of these pragmas in the DEC Ada compiler.
140 --------------------------------------------
141 -- Checking for Duplicated External Names --
142 --------------------------------------------
144 -- It is suspicious if two separate Export pragmas use the same external
145 -- name. The following table is used to diagnose this situation so that
146 -- an appropriate warning can be issued.
148 -- The Node_Id stored is for the N_String_Literal node created to
149 -- hold the value of the external name. The Sloc of this node is
150 -- used to cross-reference the location of the duplication.
152 package Externals is new Table.Table (
153 Table_Component_Type => Node_Id,
154 Table_Index_Type => Int,
155 Table_Low_Bound => 0,
156 Table_Initial => 100,
157 Table_Increment => 100,
158 Table_Name => "Name_Externals");
160 -------------------------------------
161 -- Local Subprograms and Variables --
162 -------------------------------------
164 function Adjust_External_Name_Case (N : Node_Id) return Node_Id;
165 -- This routine is used for possible casing adjustment of an explicit
166 -- external name supplied as a string literal (the node N), according
167 -- to the casing requirement of Opt.External_Name_Casing. If this is
168 -- set to As_Is, then the string literal is returned unchanged, but if
169 -- it is set to Uppercase or Lowercase, then a new string literal with
170 -- appropriate casing is constructed.
172 function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id;
173 -- If Def_Id refers to a renamed subprogram, then the base subprogram
174 -- (the original one, following the renaming chain) is returned.
175 -- Otherwise the entity is returned unchanged. Should be in Einfo???
178 -- This is a dummy function called by the processing for pragma Reviewable.
179 -- It is there for assisting front end debugging. By placing a Reviewable
180 -- pragma in the source program, a breakpoint on rv catches this place in
181 -- the source, allowing convenient stepping to the point of interest.
183 procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id);
184 -- Place semantic information on the argument of an Elaborate or
185 -- Elaborate_All pragma. Entity name for unit and its parents is
186 -- taken from item in previous with_clause that mentions the unit.
188 -------------------------------
189 -- Adjust_External_Name_Case --
190 -------------------------------
192 function Adjust_External_Name_Case (N : Node_Id) return Node_Id is
196 -- Adjust case of literal if required
198 if Opt.External_Name_Exp_Casing = As_Is then
202 -- Copy existing string
208 for J in 1 .. String_Length (Strval (N)) loop
209 CC := Get_String_Char (Strval (N), J);
211 if Opt.External_Name_Exp_Casing = Uppercase
212 and then CC >= Get_Char_Code ('a')
213 and then CC <= Get_Char_Code ('z')
215 Store_String_Char (CC - 32);
217 elsif Opt.External_Name_Exp_Casing = Lowercase
218 and then CC >= Get_Char_Code ('A')
219 and then CC <= Get_Char_Code ('Z')
221 Store_String_Char (CC + 32);
224 Store_String_Char (CC);
229 Make_String_Literal (Sloc (N),
230 Strval => End_String);
232 end Adjust_External_Name_Case;
238 procedure Analyze_Pragma (N : Node_Id) is
239 Loc : constant Source_Ptr := Sloc (N);
242 Pragma_Exit : exception;
243 -- This exception is used to exit pragma processing completely. It
244 -- is used when an error is detected, and no further processing is
245 -- required. It is also used if an earlier error has left the tree
246 -- in a state where the pragma should not be processed.
249 -- Number of pragma argument associations
255 -- First four pragma arguments (pragma argument association nodes,
256 -- or Empty if the corresponding argument does not exist).
258 type Name_List is array (Natural range <>) of Name_Id;
259 type Args_List is array (Natural range <>) of Node_Id;
260 -- Types used for arguments to Check_Arg_Order and Gather_Associations
262 procedure Ada_2005_Pragma;
263 -- Called for pragmas defined in Ada 2005, that are not in Ada 95. In
264 -- Ada 95 mode, these are implementation defined pragmas, so should be
265 -- caught by the No_Implementation_Pragmas restriction
267 procedure Check_Ada_83_Warning;
268 -- Issues a warning message for the current pragma if operating in Ada
269 -- 83 mode (used for language pragmas that are not a standard part of
270 -- Ada 83). This procedure does not raise Error_Pragma. Also notes use
273 procedure Check_Arg_Count (Required : Nat);
274 -- Check argument count for pragma is equal to given parameter.
275 -- If not, then issue an error message and raise Pragma_Exit.
277 -- Note: all routines whose name is Check_Arg_Is_xxx take an
278 -- argument Arg which can either be a pragma argument association,
279 -- in which case the check is applied to the expression of the
280 -- association or an expression directly.
282 procedure Check_Arg_Is_External_Name (Arg : Node_Id);
283 -- Check that an argument has the right form for an EXTERNAL_NAME
284 -- parameter of an extended import/export pragma. The rule is that
285 -- the name must be an identifier or string literal (in Ada 83 mode)
286 -- or a static string expression (in Ada 95 mode).
288 procedure Check_Arg_Is_Identifier (Arg : Node_Id);
289 -- Check the specified argument Arg to make sure that it is an
290 -- identifier. If not give error and raise Pragma_Exit.
292 procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id);
293 -- Check the specified argument Arg to make sure that it is an
294 -- integer literal. If not give error and raise Pragma_Exit.
296 procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id);
297 -- Check the specified argument Arg to make sure that it has the
298 -- proper syntactic form for a local name and meets the semantic
299 -- requirements for a local name. The local name is analyzed as
300 -- part of the processing for this call. In addition, the local
301 -- name is required to represent an entity at the library level.
303 procedure Check_Arg_Is_Local_Name (Arg : Node_Id);
304 -- Check the specified argument Arg to make sure that it has the
305 -- proper syntactic form for a local name and meets the semantic
306 -- requirements for a local name. The local name is analyzed as
307 -- part of the processing for this call.
309 procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id);
310 -- Check the specified argument Arg to make sure that it is a valid
311 -- locking policy name. If not give error and raise Pragma_Exit.
313 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id);
314 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2, N3 : Name_Id);
315 -- Check the specified argument Arg to make sure that it is an
316 -- identifier whose name matches either N1 or N2 (or N3 if present).
317 -- If not then give error and raise Pragma_Exit.
319 procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id);
320 -- Check the specified argument Arg to make sure that it is a valid
321 -- queuing policy name. If not give error and raise Pragma_Exit.
323 procedure Check_Arg_Is_Static_Expression
326 -- Check the specified argument Arg to make sure that it is a static
327 -- expression of the given type (i.e. it will be analyzed and resolved
328 -- using this type, which can be any valid argument to Resolve, e.g.
329 -- Any_Integer is OK). If not, given error and raise Pragma_Exit.
331 procedure Check_Arg_Is_String_Literal (Arg : Node_Id);
332 -- Check the specified argument Arg to make sure that it is a
333 -- string literal. If not give error and raise Pragma_Exit
335 procedure Check_Arg_Is_Task_Dispatching_Policy (Arg : Node_Id);
336 -- Check the specified argument Arg to make sure that it is a valid
337 -- valid task dispatching policy name. If not give error and raise
340 procedure Check_Arg_Order (Names : Name_List);
341 -- Checks for an instance of two arguments with identifiers for the
342 -- current pragma which are not in the sequence indicated by Names,
343 -- and if so, generates a fatal message about bad order of arguments.
345 procedure Check_At_Least_N_Arguments (N : Nat);
346 -- Check there are at least N arguments present
348 procedure Check_At_Most_N_Arguments (N : Nat);
349 -- Check there are no more than N arguments present
351 procedure Check_Component (Comp : Node_Id);
352 -- Examine Unchecked_Union component for correct use of per-object
353 -- constrained subtypes, and for restrictions on finalizable components.
355 procedure Check_Duplicated_Export_Name (Nam : Node_Id);
356 -- Nam is an N_String_Literal node containing the external name set
357 -- by an Import or Export pragma (or extended Import or Export pragma).
358 -- This procedure checks for possible duplications if this is the
359 -- export case, and if found, issues an appropriate error message.
361 procedure Check_First_Subtype (Arg : Node_Id);
362 -- Checks that Arg, whose expression is an entity name referencing
363 -- a subtype, does not reference a type that is not a first subtype.
365 procedure Check_In_Main_Program;
366 -- Common checks for pragmas that appear within a main program
367 -- (Priority, Main_Storage, Time_Slice).
369 procedure Check_Interrupt_Or_Attach_Handler;
370 -- Common processing for first argument of pragma Interrupt_Handler
371 -- or pragma Attach_Handler.
373 procedure Check_Is_In_Decl_Part_Or_Package_Spec;
374 -- Check that pragma appears in a declarative part, or in a package
375 -- specification, i.e. that it does not occur in a statement sequence
378 procedure Check_No_Identifier (Arg : Node_Id);
379 -- Checks that the given argument does not have an identifier. If
380 -- an identifier is present, then an error message is issued, and
381 -- Pragma_Exit is raised.
383 procedure Check_No_Identifiers;
384 -- Checks that none of the arguments to the pragma has an identifier.
385 -- If any argument has an identifier, then an error message is issued,
386 -- and Pragma_Exit is raised.
388 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id);
389 -- Checks if the given argument has an identifier, and if so, requires
390 -- it to match the given identifier name. If there is a non-matching
391 -- identifier, then an error message is given and Error_Pragmas raised.
393 procedure Check_Optional_Identifier (Arg : Node_Id; Id : String);
394 -- Checks if the given argument has an identifier, and if so, requires
395 -- it to match the given identifier name. If there is a non-matching
396 -- identifier, then an error message is given and Error_Pragmas raised.
397 -- In this version of the procedure, the identifier name is given as
398 -- a string with lower case letters.
400 procedure Check_Static_Constraint (Constr : Node_Id);
401 -- Constr is a constraint from an N_Subtype_Indication node from a
402 -- component constraint in an Unchecked_Union type. This routine checks
403 -- that the constraint is static as required by the restrictions for
406 procedure Check_Valid_Configuration_Pragma;
407 -- Legality checks for placement of a configuration pragma
409 procedure Check_Valid_Library_Unit_Pragma;
410 -- Legality checks for library unit pragmas. A special case arises for
411 -- pragmas in generic instances that come from copies of the original
412 -- library unit pragmas in the generic templates. In the case of other
413 -- than library level instantiations these can appear in contexts which
414 -- would normally be invalid (they only apply to the original template
415 -- and to library level instantiations), and they are simply ignored,
416 -- which is implemented by rewriting them as null statements.
418 procedure Check_Variant (Variant : Node_Id);
419 -- Check Unchecked_Union variant for lack of nested variants and
420 -- presence of at least one component.
422 procedure Error_Pragma (Msg : String);
423 pragma No_Return (Error_Pragma);
424 -- Outputs error message for current pragma. The message contains an %
425 -- that will be replaced with the pragma name, and the flag is placed
426 -- on the pragma itself. Pragma_Exit is then raised.
428 procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id);
429 pragma No_Return (Error_Pragma_Arg);
430 -- Outputs error message for current pragma. The message may contain
431 -- a % that will be replaced with the pragma name. The parameter Arg
432 -- may either be a pragma argument association, in which case the flag
433 -- is placed on the expression of this association, or an expression,
434 -- in which case the flag is placed directly on the expression. The
435 -- message is placed using Error_Msg_N, so the message may also contain
436 -- an & insertion character which will reference the given Arg value.
437 -- After placing the message, Pragma_Exit is raised.
439 procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id);
440 pragma No_Return (Error_Pragma_Arg);
441 -- Similar to above form of Error_Pragma_Arg except that two messages
442 -- are provided, the second is a continuation comment starting with \.
444 procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id);
445 pragma No_Return (Error_Pragma_Arg_Ident);
446 -- Outputs error message for current pragma. The message may contain
447 -- a % that will be replaced with the pragma name. The parameter Arg
448 -- must be a pragma argument association with a non-empty identifier
449 -- (i.e. its Chars field must be set), and the error message is placed
450 -- on the identifier. The message is placed using Error_Msg_N so
451 -- the message may also contain an & insertion character which will
452 -- reference the identifier. After placing the message, Pragma_Exit
455 function Find_Lib_Unit_Name return Entity_Id;
456 -- Used for a library unit pragma to find the entity to which the
457 -- library unit pragma applies, returns the entity found.
459 procedure Find_Program_Unit_Name (Id : Node_Id);
460 -- If the pragma is a compilation unit pragma, the id must denote the
461 -- compilation unit in the same compilation, and the pragma must appear
462 -- in the list of preceding or trailing pragmas. If it is a program
463 -- unit pragma that is not a compilation unit pragma, then the
464 -- identifier must be visible.
466 function Find_Unique_Parameterless_Procedure
468 Arg : Node_Id) return Entity_Id;
469 -- Used for a procedure pragma to find the unique parameterless
470 -- procedure identified by Name, returns it if it exists, otherwise
471 -- errors out and uses Arg as the pragma argument for the message.
473 procedure Gather_Associations
475 Args : out Args_List);
476 -- This procedure is used to gather the arguments for a pragma that
477 -- permits arbitrary ordering of parameters using the normal rules
478 -- for named and positional parameters. The Names argument is a list
479 -- of Name_Id values that corresponds to the allowed pragma argument
480 -- association identifiers in order. The result returned in Args is
481 -- a list of corresponding expressions that are the pragma arguments.
482 -- Note that this is a list of expressions, not of pragma argument
483 -- associations (Gather_Associations has completely checked all the
484 -- optional identifiers when it returns). An entry in Args is Empty
485 -- on return if the corresponding argument is not present.
487 function Get_Pragma_Arg (Arg : Node_Id) return Node_Id;
488 -- All the routines that check pragma arguments take either a pragma
489 -- argument association (in which case the expression of the argument
490 -- association is checked), or the expression directly. The function
491 -- Get_Pragma_Arg is a utility used to deal with these two cases. If
492 -- Arg is a pragma argument association node, then its expression is
493 -- returned, otherwise Arg is returned unchanged.
495 procedure GNAT_Pragma;
496 -- Called for all GNAT defined pragmas to check the relevant restriction
497 -- (No_Implementation_Pragmas).
499 function Is_Before_First_Decl
500 (Pragma_Node : Node_Id;
501 Decls : List_Id) return Boolean;
502 -- Return True if Pragma_Node is before the first declarative item in
503 -- Decls where Decls is the list of declarative items.
505 function Is_Configuration_Pragma return Boolean;
506 -- Deterermines if the placement of the current pragma is appropriate
507 -- for a configuration pragma (precedes the current compilation unit).
509 function Is_In_Context_Clause return Boolean;
510 -- Returns True if pragma appears within the context clause of a unit,
511 -- and False for any other placement (does not generate any messages).
513 function Is_Static_String_Expression (Arg : Node_Id) return Boolean;
514 -- Analyzes the argument, and determines if it is a static string
515 -- expression, returns True if so, False if non-static or not String.
517 procedure Pragma_Misplaced;
518 -- Issue fatal error message for misplaced pragma
520 procedure Process_Atomic_Shared_Volatile;
521 -- Common processing for pragmas Atomic, Shared, Volatile. Note that
522 -- Shared is an obsolete Ada 83 pragma, treated as being identical
523 -- in effect to pragma Atomic.
525 procedure Process_Compile_Time_Warning_Or_Error;
526 -- Common processing for Compile_Time_Error and Compile_Time_Warning
528 procedure Process_Convention (C : out Convention_Id; E : out Entity_Id);
529 -- Common procesing for Convention, Interface, Import and Export.
530 -- Checks first two arguments of pragma, and sets the appropriate
531 -- convention value in the specified entity or entities. On return
532 -- C is the convention, E is the referenced entity.
534 procedure Process_Extended_Import_Export_Exception_Pragma
535 (Arg_Internal : Node_Id;
536 Arg_External : Node_Id;
539 -- Common processing for the pragmas Import/Export_Exception.
540 -- The three arguments correspond to the three named parameters of
541 -- the pragma. An argument is empty if the corresponding parameter
542 -- is not present in the pragma.
544 procedure Process_Extended_Import_Export_Object_Pragma
545 (Arg_Internal : Node_Id;
546 Arg_External : Node_Id;
548 -- Common processing for the pragmass Import/Export_Object.
549 -- The three arguments correspond to the three named parameters
550 -- of the pragmas. An argument is empty if the corresponding
551 -- parameter is not present in the pragma.
553 procedure Process_Extended_Import_Export_Internal_Arg
554 (Arg_Internal : Node_Id := Empty);
555 -- Common processing for all extended Import and Export pragmas. The
556 -- argument is the pragma parameter for the Internal argument. If
557 -- Arg_Internal is empty or inappropriate, an error message is posted.
558 -- Otherwise, on normal return, the Entity_Field of Arg_Internal is
559 -- set to identify the referenced entity.
561 procedure Process_Extended_Import_Export_Subprogram_Pragma
562 (Arg_Internal : Node_Id;
563 Arg_External : Node_Id;
564 Arg_Parameter_Types : Node_Id;
565 Arg_Result_Type : Node_Id := Empty;
566 Arg_Mechanism : Node_Id;
567 Arg_Result_Mechanism : Node_Id := Empty;
568 Arg_First_Optional_Parameter : Node_Id := Empty);
569 -- Common processing for all extended Import and Export pragmas
570 -- applying to subprograms. The caller omits any arguments that do
571 -- bnot apply to the pragma in question (for example, Arg_Result_Type
572 -- can be non-Empty only in the Import_Function and Export_Function
573 -- cases). The argument names correspond to the allowed pragma
574 -- association identifiers.
576 procedure Process_Generic_List;
577 -- Common processing for Share_Generic and Inline_Generic
579 procedure Process_Import_Or_Interface;
580 -- Common processing for Import of Interface
582 procedure Process_Inline (Active : Boolean);
583 -- Common processing for Inline and Inline_Always. The parameter
584 -- indicates if the inline pragma is active, i.e. if it should
585 -- actually cause inlining to occur.
587 procedure Process_Interface_Name
588 (Subprogram_Def : Entity_Id;
591 -- Given the last two arguments of pragma Import, pragma Export, or
592 -- pragma Interface_Name, performs validity checks and sets the
593 -- Interface_Name field of the given subprogram entity to the
594 -- appropriate external or link name, depending on the arguments
595 -- given. Ext_Arg is always present, but Link_Arg may be missing.
596 -- Note that Ext_Arg may represent the Link_Name if Link_Arg is
597 -- missing, and appropriate named notation is used for Ext_Arg.
598 -- If neither Ext_Arg nor Link_Arg is present, the interface name
599 -- is set to the default from the subprogram name.
601 procedure Process_Interrupt_Or_Attach_Handler;
602 -- Common processing for Interrupt and Attach_Handler pragmas
604 procedure Process_Restrictions_Or_Restriction_Warnings (Warn : Boolean);
605 -- Common processing for Restrictions and Restriction_Warnings pragmas.
606 -- Warn is False for Restrictions, True for Restriction_Warnings.
608 procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean);
609 -- Common processing for Suppress and Unsuppress. The boolean parameter
610 -- Suppress_Case is True for the Suppress case, and False for the
613 procedure Set_Exported (E : Entity_Id; Arg : Node_Id);
614 -- This procedure sets the Is_Exported flag for the given entity,
615 -- checking that the entity was not previously imported. Arg is
616 -- the argument that specified the entity. A check is also made
617 -- for exporting inappropriate entities.
619 procedure Set_Extended_Import_Export_External_Name
620 (Internal_Ent : Entity_Id;
621 Arg_External : Node_Id);
622 -- Common processing for all extended import export pragmas. The first
623 -- argument, Internal_Ent, is the internal entity, which has already
624 -- been checked for validity by the caller. Arg_External is from the
625 -- Import or Export pragma, and may be null if no External parameter
626 -- was present. If Arg_External is present and is a non-null string
627 -- (a null string is treated as the default), then the Interface_Name
628 -- field of Internal_Ent is set appropriately.
630 procedure Set_Imported (E : Entity_Id);
631 -- This procedure sets the Is_Imported flag for the given entity,
632 -- checking that it is not previously exported or imported.
634 procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id);
635 -- Mech is a parameter passing mechanism (see Import_Function syntax
636 -- for MECHANISM_NAME). This routine checks that the mechanism argument
637 -- has the right form, and if not issues an error message. If the
638 -- argument has the right form then the Mechanism field of Ent is
639 -- set appropriately.
641 procedure Set_Ravenscar_Profile (N : Node_Id);
642 -- Activate the set of configuration pragmas and restrictions that
643 -- make up the Ravenscar Profile. N is the corresponding pragma
644 -- node, which is used for error messages on any constructs
645 -- that violate the profile.
647 ---------------------
648 -- Ada_2005_Pragma --
649 ---------------------
651 procedure Ada_2005_Pragma is
653 if Ada_Version <= Ada_95 then
654 Check_Restriction (No_Implementation_Pragmas, N);
658 --------------------------
659 -- Check_Ada_83_Warning --
660 --------------------------
662 procedure Check_Ada_83_Warning is
664 if Ada_Version = Ada_83 and then Comes_From_Source (N) then
665 Error_Msg_N ("(Ada 83) pragma& is non-standard?", N);
667 end Check_Ada_83_Warning;
669 ---------------------
670 -- Check_Arg_Count --
671 ---------------------
673 procedure Check_Arg_Count (Required : Nat) is
675 if Arg_Count /= Required then
676 Error_Pragma ("wrong number of arguments for pragma%");
680 --------------------------------
681 -- Check_Arg_Is_External_Name --
682 --------------------------------
684 procedure Check_Arg_Is_External_Name (Arg : Node_Id) is
685 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
688 if Nkind (Argx) = N_Identifier then
692 Analyze_And_Resolve (Argx, Standard_String);
694 if Is_OK_Static_Expression (Argx) then
697 elsif Etype (Argx) = Any_Type then
700 -- An interesting special case, if we have a string literal and
701 -- we are in Ada 83 mode, then we allow it even though it will
702 -- not be flagged as static. This allows expected Ada 83 mode
703 -- use of external names which are string literals, even though
704 -- technically these are not static in Ada 83.
706 elsif Ada_Version = Ada_83
707 and then Nkind (Argx) = N_String_Literal
711 -- Static expression that raises Constraint_Error. This has
712 -- already been flagged, so just exit from pragma processing.
714 elsif Is_Static_Expression (Argx) then
717 -- Here we have a real error (non-static expression)
720 Error_Msg_Name_1 := Chars (N);
722 ("argument for pragma% must be a identifier or " &
723 "static string expression!", Argx);
727 end Check_Arg_Is_External_Name;
729 -----------------------------
730 -- Check_Arg_Is_Identifier --
731 -----------------------------
733 procedure Check_Arg_Is_Identifier (Arg : Node_Id) is
734 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
736 if Nkind (Argx) /= N_Identifier then
738 ("argument for pragma% must be identifier", Argx);
740 end Check_Arg_Is_Identifier;
742 ----------------------------------
743 -- Check_Arg_Is_Integer_Literal --
744 ----------------------------------
746 procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id) is
747 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
749 if Nkind (Argx) /= N_Integer_Literal then
751 ("argument for pragma% must be integer literal", Argx);
753 end Check_Arg_Is_Integer_Literal;
755 -------------------------------------------
756 -- Check_Arg_Is_Library_Level_Local_Name --
757 -------------------------------------------
761 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
762 -- | library_unit_NAME
764 procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id) is
766 Check_Arg_Is_Local_Name (Arg);
768 if not Is_Library_Level_Entity (Entity (Expression (Arg)))
769 and then Comes_From_Source (N)
772 ("argument for pragma% must be library level entity", Arg);
774 end Check_Arg_Is_Library_Level_Local_Name;
776 -----------------------------
777 -- Check_Arg_Is_Local_Name --
778 -----------------------------
782 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
783 -- | library_unit_NAME
785 procedure Check_Arg_Is_Local_Name (Arg : Node_Id) is
786 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
791 if Nkind (Argx) not in N_Direct_Name
792 and then (Nkind (Argx) /= N_Attribute_Reference
793 or else Present (Expressions (Argx))
794 or else Nkind (Prefix (Argx)) /= N_Identifier)
795 and then (not Is_Entity_Name (Argx)
796 or else not Is_Compilation_Unit (Entity (Argx)))
798 Error_Pragma_Arg ("argument for pragma% must be local name", Argx);
801 if Is_Entity_Name (Argx)
802 and then Scope (Entity (Argx)) /= Current_Scope
805 ("pragma% argument must be in same declarative part", Arg);
807 end Check_Arg_Is_Local_Name;
809 ---------------------------------
810 -- Check_Arg_Is_Locking_Policy --
811 ---------------------------------
813 procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id) is
814 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
817 Check_Arg_Is_Identifier (Argx);
819 if not Is_Locking_Policy_Name (Chars (Argx)) then
821 ("& is not a valid locking policy name", Argx);
823 end Check_Arg_Is_Locking_Policy;
825 -------------------------
826 -- Check_Arg_Is_One_Of --
827 -------------------------
829 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id) is
830 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
833 Check_Arg_Is_Identifier (Argx);
835 if Chars (Argx) /= N1 and then Chars (Argx) /= N2 then
836 Error_Msg_Name_2 := N1;
837 Error_Msg_Name_3 := N2;
838 Error_Pragma_Arg ("argument for pragma% must be% or%", Argx);
840 end Check_Arg_Is_One_Of;
842 procedure Check_Arg_Is_One_Of
844 N1, N2, N3 : Name_Id)
846 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
849 Check_Arg_Is_Identifier (Argx);
851 if Chars (Argx) /= N1
852 and then Chars (Argx) /= N2
853 and then Chars (Argx) /= N3
855 Error_Pragma_Arg ("invalid argument for pragma%", Argx);
857 end Check_Arg_Is_One_Of;
859 ---------------------------------
860 -- Check_Arg_Is_Queuing_Policy --
861 ---------------------------------
863 procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id) is
864 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
867 Check_Arg_Is_Identifier (Argx);
869 if not Is_Queuing_Policy_Name (Chars (Argx)) then
871 ("& is not a valid queuing policy name", Argx);
873 end Check_Arg_Is_Queuing_Policy;
875 ------------------------------------
876 -- Check_Arg_Is_Static_Expression --
877 ------------------------------------
879 procedure Check_Arg_Is_Static_Expression
883 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
886 Analyze_And_Resolve (Argx, Typ);
888 if Is_OK_Static_Expression (Argx) then
891 elsif Etype (Argx) = Any_Type then
894 -- An interesting special case, if we have a string literal and
895 -- we are in Ada 83 mode, then we allow it even though it will
896 -- not be flagged as static. This allows the use of Ada 95
897 -- pragmas like Import in Ada 83 mode. They will of course be
898 -- flagged with warnings as usual, but will not cause errors.
900 elsif Ada_Version = Ada_83
901 and then Nkind (Argx) = N_String_Literal
905 -- Static expression that raises Constraint_Error. This has
906 -- already been flagged, so just exit from pragma processing.
908 elsif Is_Static_Expression (Argx) then
911 -- Finally, we have a real error
914 Error_Msg_Name_1 := Chars (N);
916 ("argument for pragma% must be a static expression!", Argx);
919 end Check_Arg_Is_Static_Expression;
921 ---------------------------------
922 -- Check_Arg_Is_String_Literal --
923 ---------------------------------
925 procedure Check_Arg_Is_String_Literal (Arg : Node_Id) is
926 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
928 if Nkind (Argx) /= N_String_Literal then
930 ("argument for pragma% must be string literal", Argx);
932 end Check_Arg_Is_String_Literal;
934 ------------------------------------------
935 -- Check_Arg_Is_Task_Dispatching_Policy --
936 ------------------------------------------
938 procedure Check_Arg_Is_Task_Dispatching_Policy (Arg : Node_Id) is
939 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
942 Check_Arg_Is_Identifier (Argx);
944 if not Is_Task_Dispatching_Policy_Name (Chars (Argx)) then
946 ("& is not a valid task dispatching policy name", Argx);
948 end Check_Arg_Is_Task_Dispatching_Policy;
950 ---------------------
951 -- Check_Arg_Order --
952 ---------------------
954 procedure Check_Arg_Order (Names : Name_List) is
957 Highest_So_Far : Natural := 0;
958 -- Highest index in Names seen do far
962 for J in 1 .. Arg_Count loop
963 if Chars (Arg) /= No_Name then
964 for K in Names'Range loop
965 if Chars (Arg) = Names (K) then
966 if K < Highest_So_Far then
967 Error_Msg_Name_1 := Chars (N);
969 ("parameters out of order for pragma%", Arg);
970 Error_Msg_Name_1 := Names (K);
971 Error_Msg_Name_2 := Names (Highest_So_Far);
972 Error_Msg_N ("\% must appear before %", Arg);
986 --------------------------------
987 -- Check_At_Least_N_Arguments --
988 --------------------------------
990 procedure Check_At_Least_N_Arguments (N : Nat) is
992 if Arg_Count < N then
993 Error_Pragma ("too few arguments for pragma%");
995 end Check_At_Least_N_Arguments;
997 -------------------------------
998 -- Check_At_Most_N_Arguments --
999 -------------------------------
1001 procedure Check_At_Most_N_Arguments (N : Nat) is
1004 if Arg_Count > N then
1006 for J in 1 .. N loop
1008 Error_Pragma_Arg ("too many arguments for pragma%", Arg);
1011 end Check_At_Most_N_Arguments;
1013 ---------------------
1014 -- Check_Component --
1015 ---------------------
1017 procedure Check_Component (Comp : Node_Id) is
1019 if Nkind (Comp) = N_Component_Declaration then
1021 Sindic : constant Node_Id :=
1022 Subtype_Indication (Component_Definition (Comp));
1023 Typ : constant Entity_Id :=
1024 Etype (Defining_Identifier (Comp));
1026 if Nkind (Sindic) = N_Subtype_Indication then
1028 -- Ada 2005 (AI-216): If a component subtype is subject to
1029 -- a per-object constraint, then the component type shall
1030 -- be an Unchecked_Union.
1032 if Has_Per_Object_Constraint (Defining_Identifier (Comp))
1034 not Is_Unchecked_Union (Etype (Subtype_Mark (Sindic)))
1036 Error_Msg_N ("component subtype subject to per-object" &
1037 " constraint must be an Unchecked_Union", Comp);
1041 if Is_Controlled (Typ) then
1043 ("component of unchecked union cannot be controlled", Comp);
1045 elsif Has_Task (Typ) then
1047 ("component of unchecked union cannot have tasks", Comp);
1051 end Check_Component;
1053 ----------------------------------
1054 -- Check_Duplicated_Export_Name --
1055 ----------------------------------
1057 procedure Check_Duplicated_Export_Name (Nam : Node_Id) is
1058 String_Val : constant String_Id := Strval (Nam);
1061 -- We are only interested in the export case, and in the case of
1062 -- generics, it is the instance, not the template, that is the
1063 -- problem (the template will generate a warning in any case).
1065 if not Inside_A_Generic
1066 and then (Prag_Id = Pragma_Export
1068 Prag_Id = Pragma_Export_Procedure
1070 Prag_Id = Pragma_Export_Valued_Procedure
1072 Prag_Id = Pragma_Export_Function)
1074 for J in Externals.First .. Externals.Last loop
1075 if String_Equal (String_Val, Strval (Externals.Table (J))) then
1076 Error_Msg_Sloc := Sloc (Externals.Table (J));
1077 Error_Msg_N ("external name duplicates name given#", Nam);
1082 Externals.Append (Nam);
1084 end Check_Duplicated_Export_Name;
1086 -------------------------
1087 -- Check_First_Subtype --
1088 -------------------------
1090 procedure Check_First_Subtype (Arg : Node_Id) is
1091 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
1093 if not Is_First_Subtype (Entity (Argx)) then
1095 ("pragma% cannot apply to subtype", Argx);
1097 end Check_First_Subtype;
1099 ---------------------------
1100 -- Check_In_Main_Program --
1101 ---------------------------
1103 procedure Check_In_Main_Program is
1104 P : constant Node_Id := Parent (N);
1107 -- Must be at in subprogram body
1109 if Nkind (P) /= N_Subprogram_Body then
1110 Error_Pragma ("% pragma allowed only in subprogram");
1112 -- Otherwise warn if obviously not main program
1114 elsif Present (Parameter_Specifications (Specification (P)))
1115 or else not Is_Compilation_Unit (Defining_Entity (P))
1117 Error_Msg_Name_1 := Chars (N);
1119 ("?pragma% is only effective in main program", N);
1121 end Check_In_Main_Program;
1123 ---------------------------------------
1124 -- Check_Interrupt_Or_Attach_Handler --
1125 ---------------------------------------
1127 procedure Check_Interrupt_Or_Attach_Handler is
1128 Arg1_X : constant Node_Id := Expression (Arg1);
1129 Handler_Proc, Proc_Scope : Entity_Id;
1134 if Prag_Id = Pragma_Interrupt_Handler then
1135 Check_Restriction (No_Dynamic_Attachment, N);
1138 Handler_Proc := Find_Unique_Parameterless_Procedure (Arg1_X, Arg1);
1139 Proc_Scope := Scope (Handler_Proc);
1141 -- On AAMP only, a pragma Interrupt_Handler is supported for
1142 -- nonprotected parameterless procedures.
1144 if not AAMP_On_Target
1145 or else Prag_Id = Pragma_Attach_Handler
1147 if Ekind (Proc_Scope) /= E_Protected_Type then
1149 ("argument of pragma% must be protected procedure", Arg1);
1152 if Parent (N) /= Protected_Definition (Parent (Proc_Scope)) then
1153 Error_Pragma ("pragma% must be in protected definition");
1157 if not Is_Library_Level_Entity (Proc_Scope)
1158 or else (AAMP_On_Target
1159 and then not Is_Library_Level_Entity (Handler_Proc))
1162 ("argument for pragma% must be library level entity", Arg1);
1164 end Check_Interrupt_Or_Attach_Handler;
1166 -------------------------------------------
1167 -- Check_Is_In_Decl_Part_Or_Package_Spec --
1168 -------------------------------------------
1170 procedure Check_Is_In_Decl_Part_Or_Package_Spec is
1179 elsif Nkind (P) = N_Handled_Sequence_Of_Statements then
1182 elsif Nkind (P) = N_Package_Specification then
1185 elsif Nkind (P) = N_Block_Statement then
1188 -- Note: the following tests seem a little peculiar, because
1189 -- they test for bodies, but if we were in the statement part
1190 -- of the body, we would already have hit the handled statement
1191 -- sequence, so the only way we get here is by being in the
1192 -- declarative part of the body.
1194 elsif Nkind (P) = N_Subprogram_Body
1195 or else Nkind (P) = N_Package_Body
1196 or else Nkind (P) = N_Task_Body
1197 or else Nkind (P) = N_Entry_Body
1205 Error_Pragma ("pragma% is not in declarative part or package spec");
1206 end Check_Is_In_Decl_Part_Or_Package_Spec;
1208 -------------------------
1209 -- Check_No_Identifier --
1210 -------------------------
1212 procedure Check_No_Identifier (Arg : Node_Id) is
1214 if Chars (Arg) /= No_Name then
1215 Error_Pragma_Arg_Ident
1216 ("pragma% does not permit identifier& here", Arg);
1218 end Check_No_Identifier;
1220 --------------------------
1221 -- Check_No_Identifiers --
1222 --------------------------
1224 procedure Check_No_Identifiers is
1227 if Arg_Count > 0 then
1229 while Present (Arg_Node) loop
1230 Check_No_Identifier (Arg_Node);
1234 end Check_No_Identifiers;
1236 -------------------------------
1237 -- Check_Optional_Identifier --
1238 -------------------------------
1240 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id) is
1242 if Present (Arg) and then Chars (Arg) /= No_Name then
1243 if Chars (Arg) /= Id then
1244 Error_Msg_Name_1 := Chars (N);
1245 Error_Msg_Name_2 := Id;
1246 Error_Msg_N ("pragma% argument expects identifier%", Arg);
1250 end Check_Optional_Identifier;
1252 procedure Check_Optional_Identifier (Arg : Node_Id; Id : String) is
1254 Name_Buffer (1 .. Id'Length) := Id;
1255 Name_Len := Id'Length;
1256 Check_Optional_Identifier (Arg, Name_Find);
1257 end Check_Optional_Identifier;
1259 -----------------------------
1260 -- Check_Static_Constraint --
1261 -----------------------------
1263 -- Note: for convenience in writing this procedure, in addition to
1264 -- the officially (i.e. by spec) allowed argument which is always
1265 -- a constraint, it also allows ranges and discriminant associations.
1266 -- Above is not clear ???
1268 procedure Check_Static_Constraint (Constr : Node_Id) is
1270 --------------------
1271 -- Require_Static --
1272 --------------------
1274 procedure Require_Static (E : Node_Id);
1275 -- Require given expression to be static expression
1277 procedure Require_Static (E : Node_Id) is
1279 if not Is_OK_Static_Expression (E) then
1280 Flag_Non_Static_Expr
1281 ("non-static constraint not allowed in Unchecked_Union!", E);
1286 -- Start of processing for Check_Static_Constraint
1289 case Nkind (Constr) is
1290 when N_Discriminant_Association =>
1291 Require_Static (Expression (Constr));
1294 Require_Static (Low_Bound (Constr));
1295 Require_Static (High_Bound (Constr));
1297 when N_Attribute_Reference =>
1298 Require_Static (Type_Low_Bound (Etype (Prefix (Constr))));
1299 Require_Static (Type_High_Bound (Etype (Prefix (Constr))));
1301 when N_Range_Constraint =>
1302 Check_Static_Constraint (Range_Expression (Constr));
1304 when N_Index_Or_Discriminant_Constraint =>
1308 IDC := First (Constraints (Constr));
1309 while Present (IDC) loop
1310 Check_Static_Constraint (IDC);
1318 end Check_Static_Constraint;
1320 --------------------------------------
1321 -- Check_Valid_Configuration_Pragma --
1322 --------------------------------------
1324 -- A configuration pragma must appear in the context clause of
1325 -- a compilation unit, at the start of the list (i.e. only other
1326 -- pragmas may precede it).
1328 procedure Check_Valid_Configuration_Pragma is
1330 if not Is_Configuration_Pragma then
1331 Error_Pragma ("incorrect placement for configuration pragma%");
1333 end Check_Valid_Configuration_Pragma;
1335 -------------------------------------
1336 -- Check_Valid_Library_Unit_Pragma --
1337 -------------------------------------
1339 procedure Check_Valid_Library_Unit_Pragma is
1341 Parent_Node : Node_Id;
1342 Unit_Name : Entity_Id;
1343 Unit_Kind : Node_Kind;
1344 Unit_Node : Node_Id;
1345 Sindex : Source_File_Index;
1348 if not Is_List_Member (N) then
1352 Plist := List_Containing (N);
1353 Parent_Node := Parent (Plist);
1355 if Parent_Node = Empty then
1358 -- Case of pragma appearing after a compilation unit. In this
1359 -- case it must have an argument with the corresponding name
1360 -- and must be part of the following pragmas of its parent.
1362 elsif Nkind (Parent_Node) = N_Compilation_Unit_Aux then
1363 if Plist /= Pragmas_After (Parent_Node) then
1366 elsif Arg_Count = 0 then
1368 ("argument required if outside compilation unit");
1371 Check_No_Identifiers;
1372 Check_Arg_Count (1);
1373 Unit_Node := Unit (Parent (Parent_Node));
1374 Unit_Kind := Nkind (Unit_Node);
1376 Analyze (Expression (Arg1));
1378 if Unit_Kind = N_Generic_Subprogram_Declaration
1379 or else Unit_Kind = N_Subprogram_Declaration
1381 Unit_Name := Defining_Entity (Unit_Node);
1383 elsif Unit_Kind in N_Generic_Instantiation then
1384 Unit_Name := Defining_Entity (Unit_Node);
1387 Unit_Name := Cunit_Entity (Current_Sem_Unit);
1390 if Chars (Unit_Name) /=
1391 Chars (Entity (Expression (Arg1)))
1394 ("pragma% argument is not current unit name", Arg1);
1397 if Ekind (Unit_Name) = E_Package
1398 and then Present (Renamed_Entity (Unit_Name))
1400 Error_Pragma ("pragma% not allowed for renamed package");
1404 -- Pragma appears other than after a compilation unit
1407 -- Here we check for the generic instantiation case and also
1408 -- for the case of processing a generic formal package. We
1409 -- detect these cases by noting that the Sloc on the node
1410 -- does not belong to the current compilation unit.
1412 Sindex := Source_Index (Current_Sem_Unit);
1414 if Loc not in Source_First (Sindex) .. Source_Last (Sindex) then
1415 Rewrite (N, Make_Null_Statement (Loc));
1418 -- If before first declaration, the pragma applies to the
1419 -- enclosing unit, and the name if present must be this name.
1421 elsif Is_Before_First_Decl (N, Plist) then
1422 Unit_Node := Unit_Declaration_Node (Current_Scope);
1423 Unit_Kind := Nkind (Unit_Node);
1425 if Nkind (Parent (Unit_Node)) /= N_Compilation_Unit then
1428 elsif Unit_Kind = N_Subprogram_Body
1429 and then not Acts_As_Spec (Unit_Node)
1433 elsif Nkind (Parent_Node) = N_Package_Body then
1436 elsif Nkind (Parent_Node) = N_Package_Specification
1437 and then Plist = Private_Declarations (Parent_Node)
1441 elsif (Nkind (Parent_Node) = N_Generic_Package_Declaration
1442 or else Nkind (Parent_Node) =
1443 N_Generic_Subprogram_Declaration)
1444 and then Plist = Generic_Formal_Declarations (Parent_Node)
1448 elsif Arg_Count > 0 then
1449 Analyze (Expression (Arg1));
1451 if Entity (Expression (Arg1)) /= Current_Scope then
1453 ("name in pragma% must be enclosing unit", Arg1);
1456 -- It is legal to have no argument in this context
1462 -- Error if not before first declaration. This is because a
1463 -- library unit pragma argument must be the name of a library
1464 -- unit (RM 10.1.5(7)), but the only names permitted in this
1465 -- context are (RM 10.1.5(6)) names of subprogram declarations,
1466 -- generic subprogram declarations or generic instantiations.
1470 ("pragma% misplaced, must be before first declaration");
1474 end Check_Valid_Library_Unit_Pragma;
1480 procedure Check_Variant (Variant : Node_Id) is
1481 Clist : constant Node_Id := Component_List (Variant);
1485 if not Is_Non_Empty_List (Component_Items (Clist)) then
1487 ("Unchecked_Union may not have empty component list",
1492 Comp := First (Component_Items (Clist));
1493 while Present (Comp) loop
1494 Check_Component (Comp);
1503 procedure Error_Pragma (Msg : String) is
1505 Error_Msg_Name_1 := Chars (N);
1506 Error_Msg_N (Msg, N);
1510 ----------------------
1511 -- Error_Pragma_Arg --
1512 ----------------------
1514 procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id) is
1516 Error_Msg_Name_1 := Chars (N);
1517 Error_Msg_N (Msg, Get_Pragma_Arg (Arg));
1519 end Error_Pragma_Arg;
1521 procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id) is
1523 Error_Msg_Name_1 := Chars (N);
1524 Error_Msg_N (Msg1, Get_Pragma_Arg (Arg));
1525 Error_Pragma_Arg (Msg2, Arg);
1526 end Error_Pragma_Arg;
1528 ----------------------------
1529 -- Error_Pragma_Arg_Ident --
1530 ----------------------------
1532 procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id) is
1534 Error_Msg_Name_1 := Chars (N);
1535 Error_Msg_N (Msg, Arg);
1537 end Error_Pragma_Arg_Ident;
1539 ------------------------
1540 -- Find_Lib_Unit_Name --
1541 ------------------------
1543 function Find_Lib_Unit_Name return Entity_Id is
1545 -- Return inner compilation unit entity, for case of nested
1546 -- categorization pragmas. This happens in generic unit.
1548 if Nkind (Parent (N)) = N_Package_Specification
1549 and then Defining_Entity (Parent (N)) /= Current_Scope
1551 return Defining_Entity (Parent (N));
1553 return Current_Scope;
1555 end Find_Lib_Unit_Name;
1557 ----------------------------
1558 -- Find_Program_Unit_Name --
1559 ----------------------------
1561 procedure Find_Program_Unit_Name (Id : Node_Id) is
1562 Unit_Name : Entity_Id;
1563 Unit_Kind : Node_Kind;
1564 P : constant Node_Id := Parent (N);
1567 if Nkind (P) = N_Compilation_Unit then
1568 Unit_Kind := Nkind (Unit (P));
1570 if Unit_Kind = N_Subprogram_Declaration
1571 or else Unit_Kind = N_Package_Declaration
1572 or else Unit_Kind in N_Generic_Declaration
1574 Unit_Name := Defining_Entity (Unit (P));
1576 if Chars (Id) = Chars (Unit_Name) then
1577 Set_Entity (Id, Unit_Name);
1578 Set_Etype (Id, Etype (Unit_Name));
1580 Set_Etype (Id, Any_Type);
1582 ("cannot find program unit referenced by pragma%");
1586 Set_Etype (Id, Any_Type);
1587 Error_Pragma ("pragma% inapplicable to this unit");
1593 end Find_Program_Unit_Name;
1595 -----------------------------------------
1596 -- Find_Unique_Parameterless_Procedure --
1597 -----------------------------------------
1599 function Find_Unique_Parameterless_Procedure
1601 Arg : Node_Id) return Entity_Id
1603 Proc : Entity_Id := Empty;
1606 -- The body of this procedure needs some comments ???
1608 if not Is_Entity_Name (Name) then
1610 ("argument of pragma% must be entity name", Arg);
1612 elsif not Is_Overloaded (Name) then
1613 Proc := Entity (Name);
1615 if Ekind (Proc) /= E_Procedure
1616 or else Present (First_Formal (Proc)) then
1618 ("argument of pragma% must be parameterless procedure", Arg);
1623 Found : Boolean := False;
1625 Index : Interp_Index;
1628 Get_First_Interp (Name, Index, It);
1629 while Present (It.Nam) loop
1632 if Ekind (Proc) = E_Procedure
1633 and then No (First_Formal (Proc))
1637 Set_Entity (Name, Proc);
1638 Set_Is_Overloaded (Name, False);
1641 ("ambiguous handler name for pragma% ", Arg);
1645 Get_Next_Interp (Index, It);
1650 ("argument of pragma% must be parameterless procedure",
1653 Proc := Entity (Name);
1659 end Find_Unique_Parameterless_Procedure;
1661 -------------------------
1662 -- Gather_Associations --
1663 -------------------------
1665 procedure Gather_Associations
1667 Args : out Args_List)
1672 -- Initialize all parameters to Empty
1674 for J in Args'Range loop
1678 -- That's all we have to do if there are no argument associations
1680 if No (Pragma_Argument_Associations (N)) then
1684 -- Otherwise first deal with any positional parameters present
1686 Arg := First (Pragma_Argument_Associations (N));
1687 for Index in Args'Range loop
1688 exit when No (Arg) or else Chars (Arg) /= No_Name;
1689 Args (Index) := Expression (Arg);
1693 -- Positional parameters all processed, if any left, then we
1694 -- have too many positional parameters.
1696 if Present (Arg) and then Chars (Arg) = No_Name then
1698 ("too many positional associations for pragma%", Arg);
1701 -- Process named parameters if any are present
1703 while Present (Arg) loop
1704 if Chars (Arg) = No_Name then
1706 ("positional association cannot follow named association",
1710 for Index in Names'Range loop
1711 if Names (Index) = Chars (Arg) then
1712 if Present (Args (Index)) then
1714 ("duplicate argument association for pragma%", Arg);
1716 Args (Index) := Expression (Arg);
1721 if Index = Names'Last then
1722 Error_Msg_Name_1 := Chars (N);
1723 Error_Msg_N ("pragma% does not allow & argument", Arg);
1725 -- Check for possible misspelling
1727 for Index1 in Names'Range loop
1728 if Is_Bad_Spelling_Of
1729 (Get_Name_String (Chars (Arg)),
1730 Get_Name_String (Names (Index1)))
1732 Error_Msg_Name_1 := Names (Index1);
1733 Error_Msg_N ("\possible misspelling of%", Arg);
1745 end Gather_Associations;
1747 --------------------
1748 -- Get_Pragma_Arg --
1749 --------------------
1751 function Get_Pragma_Arg (Arg : Node_Id) return Node_Id is
1753 if Nkind (Arg) = N_Pragma_Argument_Association then
1754 return Expression (Arg);
1764 procedure GNAT_Pragma is
1766 Check_Restriction (No_Implementation_Pragmas, N);
1769 --------------------------
1770 -- Is_Before_First_Decl --
1771 --------------------------
1773 function Is_Before_First_Decl
1774 (Pragma_Node : Node_Id;
1775 Decls : List_Id) return Boolean
1777 Item : Node_Id := First (Decls);
1780 -- Only other pragmas can come before this pragma
1783 if No (Item) or else Nkind (Item) /= N_Pragma then
1786 elsif Item = Pragma_Node then
1792 end Is_Before_First_Decl;
1794 -----------------------------
1795 -- Is_Configuration_Pragma --
1796 -----------------------------
1798 -- A configuration pragma must appear in the context clause of
1799 -- a compilation unit, at the start of the list (i.e. only other
1800 -- pragmas may precede it).
1802 function Is_Configuration_Pragma return Boolean is
1803 Lis : constant List_Id := List_Containing (N);
1804 Par : constant Node_Id := Parent (N);
1808 -- If no parent, then we are in the configuration pragma file,
1809 -- so the placement is definitely appropriate.
1814 -- Otherwise we must be in the context clause of a compilation unit
1815 -- and the only thing allowed before us in the context list is more
1816 -- configuration pragmas.
1818 elsif Nkind (Par) = N_Compilation_Unit
1819 and then Context_Items (Par) = Lis
1826 elsif Nkind (Prg) /= N_Pragma then
1836 end Is_Configuration_Pragma;
1838 --------------------------
1839 -- Is_In_Context_Clause --
1840 --------------------------
1842 function Is_In_Context_Clause return Boolean is
1844 Parent_Node : Node_Id;
1847 if not Is_List_Member (N) then
1851 Plist := List_Containing (N);
1852 Parent_Node := Parent (Plist);
1854 if Parent_Node = Empty
1855 or else Nkind (Parent_Node) /= N_Compilation_Unit
1856 or else Context_Items (Parent_Node) /= Plist
1863 end Is_In_Context_Clause;
1865 ---------------------------------
1866 -- Is_Static_String_Expression --
1867 ---------------------------------
1869 function Is_Static_String_Expression (Arg : Node_Id) return Boolean is
1870 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
1873 Analyze_And_Resolve (Argx);
1874 return Is_OK_Static_Expression (Argx)
1875 and then Nkind (Argx) = N_String_Literal;
1876 end Is_Static_String_Expression;
1878 ----------------------
1879 -- Pragma_Misplaced --
1880 ----------------------
1882 procedure Pragma_Misplaced is
1884 Error_Pragma ("incorrect placement of pragma%");
1885 end Pragma_Misplaced;
1887 ------------------------------------
1888 -- Process Atomic_Shared_Volatile --
1889 ------------------------------------
1891 procedure Process_Atomic_Shared_Volatile is
1898 procedure Set_Atomic (E : Entity_Id);
1899 -- Set given type as atomic, and if no explicit alignment was
1900 -- given, set alignment to unknown, since back end knows what
1901 -- the alignment requirements are for atomic arrays. Note that
1902 -- this step is necessary for derived types.
1908 procedure Set_Atomic (E : Entity_Id) is
1912 if not Has_Alignment_Clause (E) then
1913 Set_Alignment (E, Uint_0);
1917 -- Start of processing for Process_Atomic_Shared_Volatile
1920 Check_Ada_83_Warning;
1921 Check_No_Identifiers;
1922 Check_Arg_Count (1);
1923 Check_Arg_Is_Local_Name (Arg1);
1924 E_Id := Expression (Arg1);
1926 if Etype (E_Id) = Any_Type then
1931 D := Declaration_Node (E);
1935 if Rep_Item_Too_Early (E, N)
1937 Rep_Item_Too_Late (E, N)
1941 Check_First_Subtype (Arg1);
1944 if Prag_Id /= Pragma_Volatile then
1946 Set_Atomic (Underlying_Type (E));
1947 Set_Atomic (Base_Type (E));
1950 -- Attribute belongs on the base type. If the
1951 -- view of the type is currently private, it also
1952 -- belongs on the underlying type.
1954 Set_Is_Volatile (Base_Type (E));
1955 Set_Is_Volatile (Underlying_Type (E));
1957 Set_Treat_As_Volatile (E);
1958 Set_Treat_As_Volatile (Underlying_Type (E));
1960 elsif K = N_Object_Declaration
1961 or else (K = N_Component_Declaration
1962 and then Original_Record_Component (E) = E)
1964 if Rep_Item_Too_Late (E, N) then
1968 if Prag_Id /= Pragma_Volatile then
1971 -- If the object declaration has an explicit
1972 -- initialization, a temporary may have to be
1973 -- created to hold the expression, to insure
1974 -- that access to the object remain atomic.
1976 if Nkind (Parent (E)) = N_Object_Declaration
1977 and then Present (Expression (Parent (E)))
1979 Set_Has_Delayed_Freeze (E);
1982 -- An interesting improvement here. If an object of type X
1983 -- is declared atomic, and the type X is not atomic, that's
1984 -- a pity, since it may not have appropraite alignment etc.
1985 -- We can rescue this in the special case where the object
1986 -- and type are in the same unit by just setting the type
1987 -- as atomic, so that the back end will process it as atomic.
1989 Utyp := Underlying_Type (Etype (E));
1992 and then Sloc (E) > No_Location
1993 and then Sloc (Utyp) > No_Location
1995 Get_Source_File_Index (Sloc (E)) =
1996 Get_Source_File_Index (Sloc (Underlying_Type (Etype (E))))
1998 Set_Is_Atomic (Underlying_Type (Etype (E)));
2002 Set_Is_Volatile (E);
2003 Set_Treat_As_Volatile (E);
2007 ("inappropriate entity for pragma%", Arg1);
2009 end Process_Atomic_Shared_Volatile;
2011 -------------------------------------------
2012 -- Process_Compile_Time_Warning_Or_Error --
2013 -------------------------------------------
2015 procedure Process_Compile_Time_Warning_Or_Error is
2016 Arg1x : constant Node_Id := Get_Pragma_Arg (Arg1);
2020 Check_Arg_Count (2);
2021 Check_No_Identifiers;
2022 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
2023 Analyze_And_Resolve (Arg1x, Standard_Boolean);
2025 if Compile_Time_Known_Value (Arg1x) then
2026 if Is_True (Expr_Value (Get_Pragma_Arg (Arg1))) then
2028 Str : constant String_Id :=
2029 Strval (Get_Pragma_Arg (Arg2));
2030 Len : constant Int := String_Length (Str);
2040 -- Loop through segments of message separated by line
2041 -- feeds. We output these segments as separate messages
2042 -- with continuation marks for all but the first.
2045 Error_Msg_Strlen := 0;
2047 -- Loop to copy characters from argument to error
2048 -- message string buffer.
2051 exit when Ptr > Len;
2052 CC := Get_String_Char (Str, Ptr);
2055 -- Ignore wide chars ??? else store character
2057 if In_Character_Range (CC) then
2058 C := Get_Character (CC);
2059 exit when C = ASCII.LF;
2060 Error_Msg_Strlen := Error_Msg_Strlen + 1;
2061 Error_Msg_String (Error_Msg_Strlen) := C;
2065 -- Here with one line ready to go
2067 Error_Msg_Warn := Prag_Id = Pragma_Compile_Time_Warning;
2069 if Cont = False then
2070 Error_Msg_N ("<~", Arg1);
2073 Error_Msg_N ("\<~", Arg1);
2076 exit when Ptr > Len;
2081 end Process_Compile_Time_Warning_Or_Error;
2083 ------------------------
2084 -- Process_Convention --
2085 ------------------------
2087 procedure Process_Convention
2088 (C : out Convention_Id;
2094 Comp_Unit : Unit_Number_Type;
2096 procedure Set_Convention_From_Pragma (E : Entity_Id);
2097 -- Set convention in entity E, and also flag that the entity has a
2098 -- convention pragma. If entity is for a private or incomplete type,
2099 -- also set convention and flag on underlying type. This procedure
2100 -- also deals with the special case of C_Pass_By_Copy convention.
2102 --------------------------------
2103 -- Set_Convention_From_Pragma --
2104 --------------------------------
2106 procedure Set_Convention_From_Pragma (E : Entity_Id) is
2108 -- Ada 2005 (AI-430): Check invalid attempt to change convention
2109 -- for an overridden dispatching operation. Technically this is
2110 -- an amendment and should only be done in Ada 2005 mode. However,
2111 -- this is clearly a mistake, since the problem that is addressed
2112 -- by this AI is that there is a clear gap in the RM!
2114 if Is_Dispatching_Operation (E)
2115 and then Present (Overridden_Operation (E))
2116 and then C /= Convention (Overridden_Operation (E))
2119 ("cannot change convention for " &
2120 "overridden dispatching operation",
2124 -- Set the convention
2126 Set_Convention (E, C);
2127 Set_Has_Convention_Pragma (E);
2129 if Is_Incomplete_Or_Private_Type (E) then
2130 Set_Convention (Underlying_Type (E), C);
2131 Set_Has_Convention_Pragma (Underlying_Type (E), True);
2134 -- A class-wide type should inherit the convention of
2135 -- the specific root type (although this isn't specified
2136 -- clearly by the RM).
2138 if Is_Type (E) and then Present (Class_Wide_Type (E)) then
2139 Set_Convention (Class_Wide_Type (E), C);
2142 -- If the entity is a record type, then check for special case of
2143 -- C_Pass_By_Copy, which is treated the same as C except that the
2144 -- special record flag is set. This convention is only permitted
2145 -- on record types (see AI95-00131).
2147 if Cname = Name_C_Pass_By_Copy then
2148 if Is_Record_Type (E) then
2149 Set_C_Pass_By_Copy (Base_Type (E));
2150 elsif Is_Incomplete_Or_Private_Type (E)
2151 and then Is_Record_Type (Underlying_Type (E))
2153 Set_C_Pass_By_Copy (Base_Type (Underlying_Type (E)));
2156 ("C_Pass_By_Copy convention allowed only for record type",
2161 -- If the entity is a derived boolean type, check for the
2162 -- special case of convention C, C++, or Fortran, where we
2163 -- consider any nonzero value to represent true.
2165 if Is_Discrete_Type (E)
2166 and then Root_Type (Etype (E)) = Standard_Boolean
2172 C = Convention_Fortran)
2174 Set_Nonzero_Is_True (Base_Type (E));
2176 end Set_Convention_From_Pragma;
2178 -- Start of processing for Process_Convention
2181 Check_At_Least_N_Arguments (2);
2182 Check_Optional_Identifier (Arg1, Name_Convention);
2183 Check_Arg_Is_Identifier (Arg1);
2184 Cname := Chars (Expression (Arg1));
2186 -- C_Pass_By_Copy is treated as a synonym for convention C
2187 -- (this is tested again below to set the critical flag)
2189 if Cname = Name_C_Pass_By_Copy then
2192 -- Otherwise we must have something in the standard convention list
2194 elsif Is_Convention_Name (Cname) then
2195 C := Get_Convention_Id (Chars (Expression (Arg1)));
2197 -- In DEC VMS, it seems that there is an undocumented feature that
2198 -- any unrecognized convention is treated as the default, which for
2199 -- us is convention C. It does not seem so terrible to do this
2200 -- unconditionally, silently in the VMS case, and with a warning
2201 -- in the non-VMS case.
2204 if Warn_On_Export_Import and not OpenVMS_On_Target then
2206 ("?unrecognized convention name, C assumed",
2213 Check_Optional_Identifier (Arg2, Name_Entity);
2214 Check_Arg_Is_Local_Name (Arg2);
2216 Id := Expression (Arg2);
2219 if not Is_Entity_Name (Id) then
2220 Error_Pragma_Arg ("entity name required", Arg2);
2223 if Ekind (Entity (Id)) = E_Enumeration_Literal then
2224 Error_Pragma ("enumeration literal not allowed for pragma%");
2229 -- Go to renamed subprogram if present, since convention applies to
2230 -- the actual renamed entity, not to the renaming entity. If the
2231 -- subprogram is inherited, go to parent subprogram.
2233 if Is_Subprogram (E)
2234 and then Present (Alias (E))
2236 if Nkind (Parent (Declaration_Node (E))) =
2237 N_Subprogram_Renaming_Declaration
2241 elsif Nkind (Parent (E)) = N_Full_Type_Declaration
2242 and then Scope (E) = Scope (Alias (E))
2248 -- Check that we are not applying this to a specless body
2250 if Is_Subprogram (E)
2251 and then Nkind (Parent (Declaration_Node (E))) = N_Subprogram_Body
2254 ("pragma% requires separate spec and must come before body");
2257 -- Check that we are not applying this to a named constant
2259 if Ekind (E) = E_Named_Integer
2261 Ekind (E) = E_Named_Real
2263 Error_Msg_Name_1 := Chars (N);
2265 ("cannot apply pragma% to named constant!",
2266 Get_Pragma_Arg (Arg2));
2268 ("\supply appropriate type for&!", Arg2);
2271 if Etype (E) = Any_Type
2272 or else Rep_Item_Too_Early (E, N)
2276 E := Underlying_Type (E);
2279 if Rep_Item_Too_Late (E, N) then
2283 if Has_Convention_Pragma (E) then
2285 ("at most one Convention/Export/Import pragma is allowed", Arg2);
2287 elsif Convention (E) = Convention_Protected
2288 or else Ekind (Scope (E)) = E_Protected_Type
2291 ("a protected operation cannot be given a different convention",
2295 -- For Intrinsic, a subprogram is required
2297 if C = Convention_Intrinsic
2298 and then not Is_Subprogram (E)
2299 and then not Is_Generic_Subprogram (E)
2302 ("second argument of pragma% must be a subprogram", Arg2);
2305 -- For Stdcall, a subprogram, variable or subprogram type is required
2307 if C = Convention_Stdcall
2308 and then not Is_Subprogram (E)
2309 and then not Is_Generic_Subprogram (E)
2310 and then Ekind (E) /= E_Variable
2313 and then Ekind (Designated_Type (E)) = E_Subprogram_Type)
2316 ("second argument of pragma% must be subprogram (type)",
2320 if not Is_Subprogram (E)
2321 and then not Is_Generic_Subprogram (E)
2323 Set_Convention_From_Pragma (E);
2327 Check_First_Subtype (Arg2);
2328 Set_Convention_From_Pragma (Base_Type (E));
2330 -- For subprograms, we must set the convention on the
2331 -- internally generated directly designated type as well.
2333 if Ekind (E) = E_Access_Subprogram_Type then
2334 Set_Convention_From_Pragma (Directly_Designated_Type (E));
2338 -- For the subprogram case, set proper convention for all homonyms
2339 -- in same scope and the same declarative part, i.e. the same
2340 -- compilation unit.
2343 Comp_Unit := Get_Source_Unit (E);
2344 Set_Convention_From_Pragma (E);
2346 -- Treat a pragma Import as an implicit body, for GPS use
2348 if Prag_Id = Pragma_Import then
2349 Generate_Reference (E, Id, 'b');
2355 exit when No (E1) or else Scope (E1) /= Current_Scope;
2357 -- Note: below we are missing a check for Rep_Item_Too_Late.
2358 -- That is deliberate, we cannot chain the rep item on more
2359 -- than one Rep_Item chain, to be fixed later ???
2361 if Comes_From_Source (E1)
2362 and then Comp_Unit = Get_Source_Unit (E1)
2363 and then Nkind (Original_Node (Parent (E1))) /=
2364 N_Full_Type_Declaration
2366 Set_Convention_From_Pragma (E1);
2368 if Prag_Id = Pragma_Import then
2369 Generate_Reference (E, Id, 'b');
2374 end Process_Convention;
2376 -----------------------------------------------------
2377 -- Process_Extended_Import_Export_Exception_Pragma --
2378 -----------------------------------------------------
2380 procedure Process_Extended_Import_Export_Exception_Pragma
2381 (Arg_Internal : Node_Id;
2382 Arg_External : Node_Id;
2392 if not OpenVMS_On_Target then
2394 ("?pragma% ignored (applies only to Open'V'M'S)");
2397 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2398 Def_Id := Entity (Arg_Internal);
2400 if Ekind (Def_Id) /= E_Exception then
2402 ("pragma% must refer to declared exception", Arg_Internal);
2405 Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
2407 if Present (Arg_Form) then
2408 Check_Arg_Is_One_Of (Arg_Form, Name_Ada, Name_VMS);
2411 if Present (Arg_Form)
2412 and then Chars (Arg_Form) = Name_Ada
2416 Set_Is_VMS_Exception (Def_Id);
2417 Set_Exception_Code (Def_Id, No_Uint);
2420 if Present (Arg_Code) then
2421 if not Is_VMS_Exception (Def_Id) then
2423 ("Code option for pragma% not allowed for Ada case",
2427 Check_Arg_Is_Static_Expression (Arg_Code, Any_Integer);
2428 Code_Val := Expr_Value (Arg_Code);
2430 if not UI_Is_In_Int_Range (Code_Val) then
2432 ("Code option for pragma% must be in 32-bit range",
2436 Set_Exception_Code (Def_Id, Code_Val);
2439 end Process_Extended_Import_Export_Exception_Pragma;
2441 -------------------------------------------------
2442 -- Process_Extended_Import_Export_Internal_Arg --
2443 -------------------------------------------------
2445 procedure Process_Extended_Import_Export_Internal_Arg
2446 (Arg_Internal : Node_Id := Empty)
2451 if No (Arg_Internal) then
2452 Error_Pragma ("Internal parameter required for pragma%");
2455 if Nkind (Arg_Internal) = N_Identifier then
2458 elsif Nkind (Arg_Internal) = N_Operator_Symbol
2459 and then (Prag_Id = Pragma_Import_Function
2461 Prag_Id = Pragma_Export_Function)
2467 ("wrong form for Internal parameter for pragma%", Arg_Internal);
2470 Check_Arg_Is_Local_Name (Arg_Internal);
2471 end Process_Extended_Import_Export_Internal_Arg;
2473 --------------------------------------------------
2474 -- Process_Extended_Import_Export_Object_Pragma --
2475 --------------------------------------------------
2477 procedure Process_Extended_Import_Export_Object_Pragma
2478 (Arg_Internal : Node_Id;
2479 Arg_External : Node_Id;
2485 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2486 Def_Id := Entity (Arg_Internal);
2488 if Ekind (Def_Id) /= E_Constant
2489 and then Ekind (Def_Id) /= E_Variable
2492 ("pragma% must designate an object", Arg_Internal);
2495 if Has_Rep_Pragma (Def_Id, Name_Common_Object)
2497 Has_Rep_Pragma (Def_Id, Name_Psect_Object)
2500 ("previous Common/Psect_Object applies, pragma % not permitted",
2504 if Rep_Item_Too_Late (Def_Id, N) then
2508 Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
2510 if Present (Arg_Size) then
2511 Check_Arg_Is_External_Name (Arg_Size);
2514 -- Export_Object case
2516 if Prag_Id = Pragma_Export_Object then
2517 if not Is_Library_Level_Entity (Def_Id) then
2519 ("argument for pragma% must be library level entity",
2523 if Ekind (Current_Scope) = E_Generic_Package then
2524 Error_Pragma ("pragma& cannot appear in a generic unit");
2527 if not Size_Known_At_Compile_Time (Etype (Def_Id)) then
2529 ("exported object must have compile time known size",
2533 if Warn_On_Export_Import and then Is_Exported (Def_Id) then
2535 ("?duplicate Export_Object pragma", N);
2537 Set_Exported (Def_Id, Arg_Internal);
2540 -- Import_Object case
2543 if Is_Concurrent_Type (Etype (Def_Id)) then
2545 ("cannot use pragma% for task/protected object",
2549 if Ekind (Def_Id) = E_Constant then
2551 ("cannot import a constant", Arg_Internal);
2554 if Warn_On_Export_Import
2555 and then Has_Discriminants (Etype (Def_Id))
2558 ("imported value must be initialized?", Arg_Internal);
2561 if Warn_On_Export_Import
2562 and then Is_Access_Type (Etype (Def_Id))
2565 ("cannot import object of an access type?", Arg_Internal);
2568 if Warn_On_Export_Import
2569 and then Is_Imported (Def_Id)
2572 ("?duplicate Import_Object pragma", N);
2574 -- Check for explicit initialization present. Note that an
2575 -- initialization that generated by the code generator, e.g.
2576 -- for an access type, does not count here.
2578 elsif Present (Expression (Parent (Def_Id)))
2581 (Original_Node (Expression (Parent (Def_Id))))
2583 Error_Msg_Sloc := Sloc (Def_Id);
2585 ("imported entities cannot be initialized (RM B.1(24))",
2586 "\no initialization allowed for & declared#", Arg1);
2588 Set_Imported (Def_Id);
2589 Note_Possible_Modification (Arg_Internal);
2592 end Process_Extended_Import_Export_Object_Pragma;
2594 ------------------------------------------------------
2595 -- Process_Extended_Import_Export_Subprogram_Pragma --
2596 ------------------------------------------------------
2598 procedure Process_Extended_Import_Export_Subprogram_Pragma
2599 (Arg_Internal : Node_Id;
2600 Arg_External : Node_Id;
2601 Arg_Parameter_Types : Node_Id;
2602 Arg_Result_Type : Node_Id := Empty;
2603 Arg_Mechanism : Node_Id;
2604 Arg_Result_Mechanism : Node_Id := Empty;
2605 Arg_First_Optional_Parameter : Node_Id := Empty)
2611 Ambiguous : Boolean;
2615 function Same_Base_Type
2617 Formal : Entity_Id) return Boolean;
2618 -- Determines if Ptype references the type of Formal. Note that
2619 -- only the base types need to match according to the spec. Ptype
2620 -- here is the argument from the pragma, which is either a type
2621 -- name, or an access attribute.
2623 --------------------
2624 -- Same_Base_Type --
2625 --------------------
2627 function Same_Base_Type
2629 Formal : Entity_Id) return Boolean
2631 Ftyp : constant Entity_Id := Base_Type (Etype (Formal));
2635 -- Case where pragma argument is typ'Access
2637 if Nkind (Ptype) = N_Attribute_Reference
2638 and then Attribute_Name (Ptype) = Name_Access
2640 Pref := Prefix (Ptype);
2643 if not Is_Entity_Name (Pref)
2644 or else Entity (Pref) = Any_Type
2649 -- We have a match if the corresponding argument is of an
2650 -- anonymous access type, and its designicated type matches
2651 -- the type of the prefix of the access attribute
2653 return Ekind (Ftyp) = E_Anonymous_Access_Type
2654 and then Base_Type (Entity (Pref)) =
2655 Base_Type (Etype (Designated_Type (Ftyp)));
2657 -- Case where pragma argument is a type name
2662 if not Is_Entity_Name (Ptype)
2663 or else Entity (Ptype) = Any_Type
2668 -- We have a match if the corresponding argument is of
2669 -- the type given in the pragma (comparing base types)
2671 return Base_Type (Entity (Ptype)) = Ftyp;
2675 -- Start of processing for
2676 -- Process_Extended_Import_Export_Subprogram_Pragma
2679 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2683 -- Loop through homonyms (overloadings) of the entity
2685 Hom_Id := Entity (Arg_Internal);
2686 while Present (Hom_Id) loop
2687 Def_Id := Get_Base_Subprogram (Hom_Id);
2689 -- We need a subprogram in the current scope
2691 if not Is_Subprogram (Def_Id)
2692 or else Scope (Def_Id) /= Current_Scope
2699 -- Pragma cannot apply to subprogram body
2701 if Is_Subprogram (Def_Id)
2704 (Declaration_Node (Def_Id))) = N_Subprogram_Body
2707 ("pragma% requires separate spec"
2708 & " and must come before body");
2711 -- Test result type if given, note that the result type
2712 -- parameter can only be present for the function cases.
2714 if Present (Arg_Result_Type)
2715 and then not Same_Base_Type (Arg_Result_Type, Def_Id)
2719 elsif Etype (Def_Id) /= Standard_Void_Type
2721 (Chars (N) = Name_Export_Procedure
2722 or else Chars (N) = Name_Import_Procedure)
2726 -- Test parameter types if given. Note that this parameter
2727 -- has not been analyzed (and must not be, since it is
2728 -- semantic nonsense), so we get it as the parser left it.
2730 elsif Present (Arg_Parameter_Types) then
2731 Check_Matching_Types : declare
2736 Formal := First_Formal (Def_Id);
2738 if Nkind (Arg_Parameter_Types) = N_Null then
2739 if Present (Formal) then
2743 -- A list of one type, e.g. (List) is parsed as
2744 -- a parenthesized expression.
2746 elsif Nkind (Arg_Parameter_Types) /= N_Aggregate
2747 and then Paren_Count (Arg_Parameter_Types) = 1
2750 or else Present (Next_Formal (Formal))
2755 Same_Base_Type (Arg_Parameter_Types, Formal);
2758 -- A list of more than one type is parsed as a aggregate
2760 elsif Nkind (Arg_Parameter_Types) = N_Aggregate
2761 and then Paren_Count (Arg_Parameter_Types) = 0
2763 Ptype := First (Expressions (Arg_Parameter_Types));
2764 while Present (Ptype) or else Present (Formal) loop
2767 or else not Same_Base_Type (Ptype, Formal)
2772 Next_Formal (Formal);
2777 -- Anything else is of the wrong form
2781 ("wrong form for Parameter_Types parameter",
2782 Arg_Parameter_Types);
2784 end Check_Matching_Types;
2787 -- Match is now False if the entry we found did not match
2788 -- either a supplied Parameter_Types or Result_Types argument
2794 -- Ambiguous case, the flag Ambiguous shows if we already
2795 -- detected this and output the initial messages.
2798 if not Ambiguous then
2800 Error_Msg_Name_1 := Chars (N);
2802 ("pragma% does not uniquely identify subprogram!",
2804 Error_Msg_Sloc := Sloc (Ent);
2805 Error_Msg_N ("matching subprogram #!", N);
2809 Error_Msg_Sloc := Sloc (Def_Id);
2810 Error_Msg_N ("matching subprogram #!", N);
2815 Hom_Id := Homonym (Hom_Id);
2818 -- See if we found an entry
2821 if not Ambiguous then
2822 if Is_Generic_Subprogram (Entity (Arg_Internal)) then
2824 ("pragma% cannot be given for generic subprogram");
2828 ("pragma% does not identify local subprogram");
2835 -- Import pragmas must be be for imported entities
2837 if Prag_Id = Pragma_Import_Function
2839 Prag_Id = Pragma_Import_Procedure
2841 Prag_Id = Pragma_Import_Valued_Procedure
2843 if not Is_Imported (Ent) then
2845 ("pragma Import or Interface must precede pragma%");
2848 -- Here we have the Export case which can set the entity as exported
2850 -- But does not do so if the specified external name is null, since
2851 -- that is taken as a signal in DEC Ada 83 (with which we want to be
2852 -- compatible) to request no external name.
2854 elsif Nkind (Arg_External) = N_String_Literal
2855 and then String_Length (Strval (Arg_External)) = 0
2859 -- In all other cases, set entit as exported
2862 Set_Exported (Ent, Arg_Internal);
2865 -- Special processing for Valued_Procedure cases
2867 if Prag_Id = Pragma_Import_Valued_Procedure
2869 Prag_Id = Pragma_Export_Valued_Procedure
2871 Formal := First_Formal (Ent);
2875 ("at least one parameter required for pragma%");
2877 elsif Ekind (Formal) /= E_Out_Parameter then
2879 ("first parameter must have mode out for pragma%");
2882 Set_Is_Valued_Procedure (Ent);
2886 Set_Extended_Import_Export_External_Name (Ent, Arg_External);
2888 -- Process Result_Mechanism argument if present. We have already
2889 -- checked that this is only allowed for the function case.
2891 if Present (Arg_Result_Mechanism) then
2892 Set_Mechanism_Value (Ent, Arg_Result_Mechanism);
2895 -- Process Mechanism parameter if present. Note that this parameter
2896 -- is not analyzed, and must not be analyzed since it is semantic
2897 -- nonsense, so we get it in exactly as the parser left it.
2899 if Present (Arg_Mechanism) then
2907 -- A single mechanism association without a formal parameter
2908 -- name is parsed as a parenthesized expression. All other
2909 -- cases are parsed as aggregates, so we rewrite the single
2910 -- parameter case as an aggregate for consistency.
2912 if Nkind (Arg_Mechanism) /= N_Aggregate
2913 and then Paren_Count (Arg_Mechanism) = 1
2915 Rewrite (Arg_Mechanism,
2916 Make_Aggregate (Sloc (Arg_Mechanism),
2917 Expressions => New_List (
2918 Relocate_Node (Arg_Mechanism))));
2921 -- Case of only mechanism name given, applies to all formals
2923 if Nkind (Arg_Mechanism) /= N_Aggregate then
2924 Formal := First_Formal (Ent);
2925 while Present (Formal) loop
2926 Set_Mechanism_Value (Formal, Arg_Mechanism);
2927 Next_Formal (Formal);
2930 -- Case of list of mechanism associations given
2933 if Null_Record_Present (Arg_Mechanism) then
2935 ("inappropriate form for Mechanism parameter",
2939 -- Deal with positional ones first
2941 Formal := First_Formal (Ent);
2943 if Present (Expressions (Arg_Mechanism)) then
2944 Mname := First (Expressions (Arg_Mechanism));
2945 while Present (Mname) loop
2948 ("too many mechanism associations", Mname);
2951 Set_Mechanism_Value (Formal, Mname);
2952 Next_Formal (Formal);
2957 -- Deal with named entries
2959 if Present (Component_Associations (Arg_Mechanism)) then
2960 Massoc := First (Component_Associations (Arg_Mechanism));
2961 while Present (Massoc) loop
2962 Choice := First (Choices (Massoc));
2964 if Nkind (Choice) /= N_Identifier
2965 or else Present (Next (Choice))
2968 ("incorrect form for mechanism association",
2972 Formal := First_Formal (Ent);
2976 ("parameter name & not present", Choice);
2979 if Chars (Choice) = Chars (Formal) then
2981 (Formal, Expression (Massoc));
2985 Next_Formal (Formal);
2995 -- Process First_Optional_Parameter argument if present. We have
2996 -- already checked that this is only allowed for the Import case.
2998 if Present (Arg_First_Optional_Parameter) then
2999 if Nkind (Arg_First_Optional_Parameter) /= N_Identifier then
3001 ("first optional parameter must be formal parameter name",
3002 Arg_First_Optional_Parameter);
3005 Formal := First_Formal (Ent);
3009 ("specified formal parameter& not found",
3010 Arg_First_Optional_Parameter);
3013 exit when Chars (Formal) =
3014 Chars (Arg_First_Optional_Parameter);
3016 Next_Formal (Formal);
3019 Set_First_Optional_Parameter (Ent, Formal);
3021 -- Check specified and all remaining formals have right form
3023 while Present (Formal) loop
3024 if Ekind (Formal) /= E_In_Parameter then
3026 ("optional formal& is not of mode in!",
3027 Arg_First_Optional_Parameter, Formal);
3030 Dval := Default_Value (Formal);
3034 ("optional formal& does not have default value!",
3035 Arg_First_Optional_Parameter, Formal);
3037 elsif Compile_Time_Known_Value_Or_Aggr (Dval) then
3042 ("default value for optional formal& is non-static!",
3043 Arg_First_Optional_Parameter, Formal);
3047 Set_Is_Optional_Parameter (Formal);
3048 Next_Formal (Formal);
3051 end Process_Extended_Import_Export_Subprogram_Pragma;
3053 --------------------------
3054 -- Process_Generic_List --
3055 --------------------------
3057 procedure Process_Generic_List is
3063 Check_No_Identifiers;
3064 Check_At_Least_N_Arguments (1);
3067 while Present (Arg) loop
3068 Exp := Expression (Arg);
3071 if not Is_Entity_Name (Exp)
3073 (not Is_Generic_Instance (Entity (Exp))
3075 not Is_Generic_Unit (Entity (Exp)))
3078 ("pragma% argument must be name of generic unit/instance",
3084 end Process_Generic_List;
3086 ---------------------------------
3087 -- Process_Import_Or_Interface --
3088 ---------------------------------
3090 procedure Process_Import_Or_Interface is
3096 Process_Convention (C, Def_Id);
3097 Kill_Size_Check_Code (Def_Id);
3098 Note_Possible_Modification (Expression (Arg2));
3100 if Ekind (Def_Id) = E_Variable
3102 Ekind (Def_Id) = E_Constant
3104 -- We do not permit Import to apply to a renaming declaration
3106 if Present (Renamed_Object (Def_Id)) then
3108 ("pragma% not allowed for object renaming", Arg2);
3110 -- User initialization is not allowed for imported object, but
3111 -- the object declaration may contain a default initialization,
3112 -- that will be discarded. Note that an explicit initialization
3113 -- only counts if it comes from source, otherwise it is simply
3114 -- the code generator making an implicit initialization explicit.
3116 elsif Present (Expression (Parent (Def_Id)))
3117 and then Comes_From_Source (Expression (Parent (Def_Id)))
3119 Error_Msg_Sloc := Sloc (Def_Id);
3121 ("no initialization allowed for declaration of& #",
3122 "\imported entities cannot be initialized (RM B.1(24))",
3126 Set_Imported (Def_Id);
3127 Process_Interface_Name (Def_Id, Arg3, Arg4);
3129 -- Note that we do not set Is_Public here. That's because we
3130 -- only want to set if if there is no address clause, and we
3131 -- don't know that yet, so we delay that processing till
3134 -- pragma Import completes deferred constants
3136 if Ekind (Def_Id) = E_Constant then
3137 Set_Has_Completion (Def_Id);
3140 -- It is not possible to import a constant of an unconstrained
3141 -- array type (e.g. string) because there is no simple way to
3142 -- write a meaningful subtype for it.
3144 if Is_Array_Type (Etype (Def_Id))
3145 and then not Is_Constrained (Etype (Def_Id))
3148 ("imported constant& must have a constrained subtype",
3153 elsif Is_Subprogram (Def_Id)
3154 or else Is_Generic_Subprogram (Def_Id)
3156 -- If the name is overloaded, pragma applies to all of the
3157 -- denoted entities in the same declarative part.
3160 while Present (Hom_Id) loop
3161 Def_Id := Get_Base_Subprogram (Hom_Id);
3163 -- Ignore inherited subprograms because the pragma will
3164 -- apply to the parent operation, which is the one called.
3166 if Is_Overloadable (Def_Id)
3167 and then Present (Alias (Def_Id))
3171 -- If it is not a subprogram, it must be in an outer
3172 -- scope and pragma does not apply.
3174 elsif not Is_Subprogram (Def_Id)
3175 and then not Is_Generic_Subprogram (Def_Id)
3179 -- Verify that the homonym is in the same declarative
3180 -- part (not just the same scope).
3182 elsif Parent (Unit_Declaration_Node (Def_Id)) /= Parent (N)
3183 and then Nkind (Parent (N)) /= N_Compilation_Unit_Aux
3188 Set_Imported (Def_Id);
3190 -- Special processing for Convention_Intrinsic
3192 if C = Convention_Intrinsic then
3194 -- Link_Name argument not allowed for intrinsic
3197 and then Chars (Arg3) = Name_Link_Name
3202 if Present (Arg4) then
3204 ("Link_Name argument not allowed for " &
3209 Set_Is_Intrinsic_Subprogram (Def_Id);
3211 -- If no external name is present, then check that
3212 -- this is a valid intrinsic subprogram. If an external
3213 -- name is present, then this is handled by the back end.
3216 Check_Intrinsic_Subprogram (Def_Id, Expression (Arg2));
3220 -- All interfaced procedures need an external symbol
3221 -- created for them since they are always referenced
3222 -- from another object file.
3224 Set_Is_Public (Def_Id);
3226 -- Verify that the subprogram does not have a completion
3227 -- through a renaming declaration. For other completions
3228 -- the pragma appears as a too late representation.
3231 Decl : constant Node_Id := Unit_Declaration_Node (Def_Id);
3235 and then Nkind (Decl) = N_Subprogram_Declaration
3236 and then Present (Corresponding_Body (Decl))
3239 (Unit_Declaration_Node
3240 (Corresponding_Body (Decl))) =
3241 N_Subprogram_Renaming_Declaration
3243 Error_Msg_Sloc := Sloc (Def_Id);
3245 ("cannot import&, renaming already provided for " &
3246 "declaration #", N, Def_Id);
3250 Set_Has_Completion (Def_Id);
3251 Process_Interface_Name (Def_Id, Arg3, Arg4);
3254 if Is_Compilation_Unit (Hom_Id) then
3256 -- Its possible homonyms are not affected by the pragma.
3257 -- Such homonyms might be present in the context of other
3258 -- units being compiled.
3263 Hom_Id := Homonym (Hom_Id);
3267 -- When the convention is Java or CIL, we also allow Import to be
3268 -- given for packages, generic packages, exceptions, and record
3271 elsif (C = Convention_Java or else C = Convention_CIL)
3273 (Ekind (Def_Id) = E_Package
3274 or else Ekind (Def_Id) = E_Generic_Package
3275 or else Ekind (Def_Id) = E_Exception
3276 or else Nkind (Parent (Def_Id)) = N_Component_Declaration)
3278 Set_Imported (Def_Id);
3279 Set_Is_Public (Def_Id);
3280 Process_Interface_Name (Def_Id, Arg3, Arg4);
3282 -- Import a CPP class
3284 elsif Is_Record_Type (Def_Id)
3285 and then C = Convention_CPP
3287 if not Is_Tagged_Type (Def_Id) then
3288 Error_Msg_Sloc := Sloc (Def_Id);
3289 Error_Pragma_Arg ("imported 'C'P'P type must be tagged", Arg2);
3292 -- Types treated as CPP classes are treated as limited, but we
3293 -- don't require them to be declared this way. A warning is
3294 -- issued to encourage the user to declare them as limited.
3295 -- This is not an error, for compatibility reasons, because
3296 -- these types have been supported this way for some time.
3298 if not Is_Limited_Type (Def_Id) then
3300 ("imported 'C'P'P type should be " &
3301 "explicitly declared limited?",
3302 Get_Pragma_Arg (Arg2));
3304 ("\type will be considered limited",
3305 Get_Pragma_Arg (Arg2));
3308 Set_Is_CPP_Class (Def_Id);
3309 Set_Is_Limited_Record (Def_Id);
3314 ("second argument of pragma% must be object or subprogram",
3318 -- If this pragma applies to a compilation unit, then the unit,
3319 -- which is a subprogram, does not require (or allow) a body.
3320 -- We also do not need to elaborate imported procedures.
3322 if Nkind (Parent (N)) = N_Compilation_Unit_Aux then
3324 Cunit : constant Node_Id := Parent (Parent (N));
3326 Set_Body_Required (Cunit, False);
3329 end Process_Import_Or_Interface;
3331 --------------------
3332 -- Process_Inline --
3333 --------------------
3335 procedure Process_Inline (Active : Boolean) is
3341 Effective : Boolean := False;
3343 procedure Make_Inline (Subp : Entity_Id);
3344 -- Subp is the defining unit name of the subprogram
3345 -- declaration. Set the flag, as well as the flag in the
3346 -- corresponding body, if there is one present.
3348 procedure Set_Inline_Flags (Subp : Entity_Id);
3349 -- Sets Is_Inlined and Has_Pragma_Inline flags for Subp
3351 function Inlining_Not_Possible (Subp : Entity_Id) return Boolean;
3352 -- Returns True if it can be determined at this stage that inlining
3353 -- is not possible, for examle if the body is available and contains
3354 -- exception handlers, we prevent inlining, since otherwise we can
3355 -- get undefined symbols at link time. This function also emits a
3356 -- warning if front-end inlining is enabled and the pragma appears
3358 -- ??? is business with link symbols still valid, or does it relate
3359 -- to front end ZCX which is being phased out ???
3361 ---------------------------
3362 -- Inlining_Not_Possible --
3363 ---------------------------
3365 function Inlining_Not_Possible (Subp : Entity_Id) return Boolean is
3366 Decl : constant Node_Id := Unit_Declaration_Node (Subp);
3370 if Nkind (Decl) = N_Subprogram_Body then
3371 Stats := Handled_Statement_Sequence (Decl);
3372 return Present (Exception_Handlers (Stats))
3373 or else Present (At_End_Proc (Stats));
3375 elsif Nkind (Decl) = N_Subprogram_Declaration
3376 and then Present (Corresponding_Body (Decl))
3378 if Front_End_Inlining
3379 and then Analyzed (Corresponding_Body (Decl))
3381 Error_Msg_N ("pragma appears too late, ignored?", N);
3384 -- If the subprogram is a renaming as body, the body is
3385 -- just a call to the renamed subprogram, and inlining is
3386 -- trivially possible.
3389 Nkind (Unit_Declaration_Node (Corresponding_Body (Decl))) =
3390 N_Subprogram_Renaming_Declaration
3396 Handled_Statement_Sequence
3397 (Unit_Declaration_Node (Corresponding_Body (Decl)));
3400 Present (Exception_Handlers (Stats))
3401 or else Present (At_End_Proc (Stats));
3405 -- If body is not available, assume the best, the check is
3406 -- performed again when compiling enclosing package bodies.
3410 end Inlining_Not_Possible;
3416 procedure Make_Inline (Subp : Entity_Id) is
3417 Kind : constant Entity_Kind := Ekind (Subp);
3418 Inner_Subp : Entity_Id := Subp;
3421 if Etype (Subp) = Any_Type then
3424 -- If inlining is not possible, for now do not treat as an error
3426 elsif Inlining_Not_Possible (Subp) then
3430 -- Here we have a candidate for inlining, but we must exclude
3431 -- derived operations. Otherwise we will end up trying to
3432 -- inline a phantom declaration, and the result would be to
3433 -- drag in a body which has no direct inlining associated with
3434 -- it. That would not only be inefficient but would also result
3435 -- in the backend doing cross-unit inlining in cases where it
3436 -- was definitely inappropriate to do so.
3438 -- However, a simple Comes_From_Source test is insufficient,
3439 -- since we do want to allow inlining of generic instances,
3440 -- which also do not come from source. Predefined operators do
3441 -- not come from source but are not inlineable either.
3443 elsif not Comes_From_Source (Subp)
3444 and then not Is_Generic_Instance (Subp)
3445 and then Scope (Subp) /= Standard_Standard
3450 -- The referenced entity must either be the enclosing entity,
3451 -- or an entity declared within the current open scope.
3453 elsif Present (Scope (Subp))
3454 and then Scope (Subp) /= Current_Scope
3455 and then Subp /= Current_Scope
3458 ("argument of% must be entity in current scope", Assoc);
3462 -- Processing for procedure, operator or function.
3463 -- If subprogram is aliased (as for an instance) indicate
3464 -- that the renamed entity (if declared in the same unit)
3467 if Is_Subprogram (Subp) then
3468 while Present (Alias (Inner_Subp)) loop
3469 Inner_Subp := Alias (Inner_Subp);
3472 if In_Same_Source_Unit (Subp, Inner_Subp) then
3473 Set_Inline_Flags (Inner_Subp);
3475 Decl := Parent (Parent (Inner_Subp));
3477 if Nkind (Decl) = N_Subprogram_Declaration
3478 and then Present (Corresponding_Body (Decl))
3480 Set_Inline_Flags (Corresponding_Body (Decl));
3486 -- For a generic subprogram set flag as well, for use at
3487 -- the point of instantiation, to determine whether the
3488 -- body should be generated.
3490 elsif Is_Generic_Subprogram (Subp) then
3491 Set_Inline_Flags (Subp);
3494 -- Literals are by definition inlined
3496 elsif Kind = E_Enumeration_Literal then
3499 -- Anything else is an error
3503 ("expect subprogram name for pragma%", Assoc);
3507 ----------------------
3508 -- Set_Inline_Flags --
3509 ----------------------
3511 procedure Set_Inline_Flags (Subp : Entity_Id) is
3514 Set_Is_Inlined (Subp, True);
3517 if not Has_Pragma_Inline (Subp) then
3518 Set_Has_Pragma_Inline (Subp);
3519 Set_Next_Rep_Item (N, First_Rep_Item (Subp));
3520 Set_First_Rep_Item (Subp, N);
3523 end Set_Inline_Flags;
3525 -- Start of processing for Process_Inline
3528 Check_No_Identifiers;
3529 Check_At_Least_N_Arguments (1);
3532 Inline_Processing_Required := True;
3536 while Present (Assoc) loop
3537 Subp_Id := Expression (Assoc);
3541 if Is_Entity_Name (Subp_Id) then
3542 Subp := Entity (Subp_Id);
3544 if Subp = Any_Id then
3546 -- If previous error, avoid cascaded errors
3554 while Present (Homonym (Subp))
3555 and then Scope (Homonym (Subp)) = Current_Scope
3557 Make_Inline (Homonym (Subp));
3558 Subp := Homonym (Subp);
3565 ("inappropriate argument for pragma%", Assoc);
3568 and then Warn_On_Redundant_Constructs
3570 if Inlining_Not_Possible (Subp) then
3572 ("pragma Inline for& is ignored?", N, Entity (Subp_Id));
3575 ("pragma Inline for& is redundant?", N, Entity (Subp_Id));
3583 ----------------------------
3584 -- Process_Interface_Name --
3585 ----------------------------
3587 procedure Process_Interface_Name
3588 (Subprogram_Def : Entity_Id;
3594 String_Val : String_Id;
3596 procedure Check_Form_Of_Interface_Name (SN : Node_Id);
3597 -- SN is a string literal node for an interface name. This routine
3598 -- performs some minimal checks that the name is reasonable. In
3599 -- particular that no spaces or other obviously incorrect characters
3600 -- appear. This is only a warning, since any characters are allowed.
3602 ----------------------------------
3603 -- Check_Form_Of_Interface_Name --
3604 ----------------------------------
3606 procedure Check_Form_Of_Interface_Name (SN : Node_Id) is
3607 S : constant String_Id := Strval (Expr_Value_S (SN));
3608 SL : constant Nat := String_Length (S);
3613 Error_Msg_N ("interface name cannot be null string", SN);
3616 for J in 1 .. SL loop
3617 C := Get_String_Char (S, J);
3619 if Warn_On_Export_Import
3621 (not In_Character_Range (C)
3622 or else (Get_Character (C) = ' '
3623 and then VM_Target /= CLI_Target)
3624 or else Get_Character (C) = ',')
3627 ("?interface name contains illegal character", SN);
3630 end Check_Form_Of_Interface_Name;
3632 -- Start of processing for Process_Interface_Name
3635 if No (Link_Arg) then
3636 if No (Ext_Arg) then
3637 if VM_Target = CLI_Target
3638 and then Ekind (Subprogram_Def) = E_Package
3639 and then Nkind (Parent (Subprogram_Def)) =
3640 N_Package_Specification
3641 and then Present (Generic_Parent (Parent (Subprogram_Def)))
3646 (Generic_Parent (Parent (Subprogram_Def))));
3651 elsif Chars (Ext_Arg) = Name_Link_Name then
3653 Link_Nam := Expression (Ext_Arg);
3656 Check_Optional_Identifier (Ext_Arg, Name_External_Name);
3657 Ext_Nam := Expression (Ext_Arg);
3662 Check_Optional_Identifier (Ext_Arg, Name_External_Name);
3663 Check_Optional_Identifier (Link_Arg, Name_Link_Name);
3664 Ext_Nam := Expression (Ext_Arg);
3665 Link_Nam := Expression (Link_Arg);
3668 -- Check expressions for external name and link name are static
3670 if Present (Ext_Nam) then
3671 Check_Arg_Is_Static_Expression (Ext_Nam, Standard_String);
3672 Check_Form_Of_Interface_Name (Ext_Nam);
3674 -- Verify that the external name is not the name of a local
3675 -- entity, which would hide the imported one and lead to
3676 -- run-time surprises. The problem can only arise for entities
3677 -- declared in a package body (otherwise the external name is
3678 -- fully qualified and won't conflict).
3686 if Prag_Id = Pragma_Import then
3687 String_To_Name_Buffer (Strval (Expr_Value_S (Ext_Nam)));
3689 E := Entity_Id (Get_Name_Table_Info (Nam));
3691 if Nam /= Chars (Subprogram_Def)
3692 and then Present (E)
3693 and then not Is_Overloadable (E)
3694 and then Is_Immediately_Visible (E)
3695 and then not Is_Imported (E)
3696 and then Ekind (Scope (E)) = E_Package
3699 while Present (Par) loop
3700 if Nkind (Par) = N_Package_Body then
3701 Error_Msg_Sloc := Sloc (E);
3703 ("imported entity is hidden by & declared#",
3708 Par := Parent (Par);
3715 if Present (Link_Nam) then
3716 Check_Arg_Is_Static_Expression (Link_Nam, Standard_String);
3717 Check_Form_Of_Interface_Name (Link_Nam);
3720 -- If there is no link name, just set the external name
3722 if No (Link_Nam) then
3723 Link_Nam := Adjust_External_Name_Case (Expr_Value_S (Ext_Nam));
3725 -- For the Link_Name case, the given literal is preceded by an
3726 -- asterisk, which indicates to GCC that the given name should
3727 -- be taken literally, and in particular that no prepending of
3728 -- underlines should occur, even in systems where this is the
3734 if VM_Target = No_VM then
3735 Store_String_Char (Get_Char_Code ('*'));
3738 String_Val := Strval (Expr_Value_S (Link_Nam));
3740 for J in 1 .. String_Length (String_Val) loop
3741 Store_String_Char (Get_String_Char (String_Val, J));
3745 Make_String_Literal (Sloc (Link_Nam), End_String);
3748 Set_Encoded_Interface_Name
3749 (Get_Base_Subprogram (Subprogram_Def), Link_Nam);
3750 Check_Duplicated_Export_Name (Link_Nam);
3751 end Process_Interface_Name;
3753 -----------------------------------------
3754 -- Process_Interrupt_Or_Attach_Handler --
3755 -----------------------------------------
3757 procedure Process_Interrupt_Or_Attach_Handler is
3758 Arg1_X : constant Node_Id := Expression (Arg1);
3759 Handler_Proc : constant Entity_Id := Entity (Arg1_X);
3760 Proc_Scope : constant Entity_Id := Scope (Handler_Proc);
3763 Set_Is_Interrupt_Handler (Handler_Proc);
3765 -- If the pragma is not associated with a handler procedure
3766 -- within a protected type, then it must be for a nonprotected
3767 -- procedure for the AAMP target, in which case we don't
3768 -- associate a representation item with the procedure's scope.
3770 if Ekind (Proc_Scope) = E_Protected_Type then
3771 if Prag_Id = Pragma_Interrupt_Handler
3773 Prag_Id = Pragma_Attach_Handler
3775 Record_Rep_Item (Proc_Scope, N);
3778 end Process_Interrupt_Or_Attach_Handler;
3780 --------------------------------------------------
3781 -- Process_Restrictions_Or_Restriction_Warnings --
3782 --------------------------------------------------
3784 -- Note: some of the simple identifier cases were handled in par-prag,
3785 -- but it is harmless (and more straightforward) to simply handle all
3786 -- cases here, even if it means we repeat a bit of work in some cases.
3788 procedure Process_Restrictions_Or_Restriction_Warnings
3792 R_Id : Restriction_Id;
3797 procedure Check_Unit_Name (N : Node_Id);
3798 -- Checks unit name parameter for No_Dependence. Returns if it has
3799 -- an appropriate form, otherwise raises pragma argument error.
3801 ---------------------
3802 -- Check_Unit_Name --
3803 ---------------------
3805 procedure Check_Unit_Name (N : Node_Id) is
3807 if Nkind (N) = N_Selected_Component then
3808 Check_Unit_Name (Prefix (N));
3809 Check_Unit_Name (Selector_Name (N));
3811 elsif Nkind (N) = N_Identifier then
3816 ("wrong form for unit name for No_Dependence", N);
3818 end Check_Unit_Name;
3820 -- Start of processing for Process_Restrictions_Or_Restriction_Warnings
3823 Check_Ada_83_Warning;
3824 Check_At_Least_N_Arguments (1);
3825 Check_Valid_Configuration_Pragma;
3828 while Present (Arg) loop
3830 Expr := Expression (Arg);
3832 -- Case of no restriction identifier present
3834 if Id = No_Name then
3835 if Nkind (Expr) /= N_Identifier then
3837 ("invalid form for restriction", Arg);
3842 (Process_Restriction_Synonyms (Expr));
3844 if R_Id not in All_Boolean_Restrictions then
3846 ("invalid restriction identifier", Arg);
3849 if Implementation_Restriction (R_Id) then
3851 (No_Implementation_Restrictions, Arg);
3854 -- If this is a warning, then set the warning unless we already
3855 -- have a real restriction active (we never want a warning to
3856 -- override a real restriction).
3859 if not Restriction_Active (R_Id) then
3860 Set_Restriction (R_Id, N);
3861 Restriction_Warnings (R_Id) := True;
3864 -- If real restriction case, then set it and make sure that the
3865 -- restriction warning flag is off, since a real restriction
3866 -- always overrides a warning.
3869 Set_Restriction (R_Id, N);
3870 Restriction_Warnings (R_Id) := False;
3873 -- A very special case that must be processed here: pragma
3874 -- Restrictions (No_Exceptions) turns off all run-time
3875 -- checking. This is a bit dubious in terms of the formal
3876 -- language definition, but it is what is intended by RM
3877 -- H.4(12). Restriction_Warnings never affects generated code
3878 -- so this is done only in the real restriction case.
3880 if R_Id = No_Exceptions and then not Warn then
3881 Scope_Suppress := (others => True);
3884 -- Case of No_Dependence => unit-name. Note that the parser
3885 -- already made the necessary entry in the No_Dependence table.
3887 elsif Id = Name_No_Dependence then
3888 Check_Unit_Name (Expr);
3890 -- All other cases of restriction identifier present
3893 R_Id := Get_Restriction_Id (Process_Restriction_Synonyms (Arg));
3894 Analyze_And_Resolve (Expr, Any_Integer);
3896 if R_Id not in All_Parameter_Restrictions then
3898 ("invalid restriction parameter identifier", Arg);
3900 elsif not Is_OK_Static_Expression (Expr) then
3901 Flag_Non_Static_Expr
3902 ("value must be static expression!", Expr);
3905 elsif not Is_Integer_Type (Etype (Expr))
3906 or else Expr_Value (Expr) < 0
3909 ("value must be non-negative integer", Arg);
3912 -- Restriction pragma is active
3914 Val := Expr_Value (Expr);
3916 if not UI_Is_In_Int_Range (Val) then
3918 ("pragma ignored, value too large?", Arg);
3921 -- Warning case. If the real restriction is active, then we
3922 -- ignore the request, since warning never overrides a real
3923 -- restriction. Otherwise we set the proper warning. Note that
3924 -- this circuit sets the warning again if it is already set,
3925 -- which is what we want, since the constant may have changed.
3928 if not Restriction_Active (R_Id) then
3930 (R_Id, N, Integer (UI_To_Int (Val)));
3931 Restriction_Warnings (R_Id) := True;
3934 -- Real restriction case, set restriction and make sure warning
3935 -- flag is off since real restriction always overrides warning.
3938 Set_Restriction (R_Id, N, Integer (UI_To_Int (Val)));
3939 Restriction_Warnings (R_Id) := False;
3945 end Process_Restrictions_Or_Restriction_Warnings;
3947 ---------------------------------
3948 -- Process_Suppress_Unsuppress --
3949 ---------------------------------
3951 -- Note: this procedure makes entries in the check suppress data
3952 -- structures managed by Sem. See spec of package Sem for full
3953 -- details on how we handle recording of check suppression.
3955 procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean) is
3960 In_Package_Spec : constant Boolean :=
3961 (Ekind (Current_Scope) = E_Package
3963 Ekind (Current_Scope) = E_Generic_Package)
3964 and then not In_Package_Body (Current_Scope);
3966 procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id);
3967 -- Used to suppress a single check on the given entity
3969 --------------------------------
3970 -- Suppress_Unsuppress_Echeck --
3971 --------------------------------
3973 procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id) is
3975 Set_Checks_May_Be_Suppressed (E);
3977 if In_Package_Spec then
3978 Push_Global_Suppress_Stack_Entry
3981 Suppress => Suppress_Case);
3984 Push_Local_Suppress_Stack_Entry
3987 Suppress => Suppress_Case);
3990 -- If this is a first subtype, and the base type is distinct,
3991 -- then also set the suppress flags on the base type.
3993 if Is_First_Subtype (E)
3994 and then Etype (E) /= E
3996 Suppress_Unsuppress_Echeck (Etype (E), C);
3998 end Suppress_Unsuppress_Echeck;
4000 -- Start of processing for Process_Suppress_Unsuppress
4003 -- Suppress/Unsuppress can appear as a configuration pragma,
4004 -- or in a declarative part or a package spec (RM 11.5(5))
4006 if not Is_Configuration_Pragma then
4007 Check_Is_In_Decl_Part_Or_Package_Spec;
4010 Check_At_Least_N_Arguments (1);
4011 Check_At_Most_N_Arguments (2);
4012 Check_No_Identifier (Arg1);
4013 Check_Arg_Is_Identifier (Arg1);
4015 C := Get_Check_Id (Chars (Expression (Arg1)));
4017 if C = No_Check_Id then
4019 ("argument of pragma% is not valid check name", Arg1);
4022 if not Suppress_Case
4023 and then (C = All_Checks or else C = Overflow_Check)
4025 Opt.Overflow_Checks_Unsuppressed := True;
4028 if Arg_Count = 1 then
4030 -- Make an entry in the local scope suppress table. This is the
4031 -- table that directly shows the current value of the scope
4032 -- suppress check for any check id value.
4034 if C = All_Checks then
4036 -- For All_Checks, we set all specific predefined checks with
4037 -- the exception of Elaboration_Check, which is handled
4038 -- specially because of not wanting All_Checks to have the
4039 -- effect of deactivating static elaboration order processing.
4041 for J in Scope_Suppress'Range loop
4042 if J /= Elaboration_Check then
4043 Scope_Suppress (J) := Suppress_Case;
4047 -- If not All_Checks, and predefined check, then set appropriate
4048 -- scope entry. Note that we will set Elaboration_Check if this
4049 -- is explicitly specified.
4051 elsif C in Predefined_Check_Id then
4052 Scope_Suppress (C) := Suppress_Case;
4055 -- Also make an entry in the Local_Entity_Suppress table
4057 Push_Local_Suppress_Stack_Entry
4060 Suppress => Suppress_Case);
4062 -- Case of two arguments present, where the check is suppressed for
4063 -- a specified entity (given as the second argument of the pragma)
4066 Check_Optional_Identifier (Arg2, Name_On);
4067 E_Id := Expression (Arg2);
4070 if not Is_Entity_Name (E_Id) then
4072 ("second argument of pragma% must be entity name", Arg2);
4081 -- Enforce RM 11.5(7) which requires that for a pragma that
4082 -- appears within a package spec, the named entity must be
4083 -- within the package spec. We allow the package name itself
4084 -- to be mentioned since that makes sense, although it is not
4085 -- strictly allowed by 11.5(7).
4088 and then E /= Current_Scope
4089 and then Scope (E) /= Current_Scope
4092 ("entity in pragma% is not in package spec (RM 11.5(7))",
4096 -- Loop through homonyms. As noted below, in the case of a package
4097 -- spec, only homonyms within the package spec are considered.
4100 Suppress_Unsuppress_Echeck (E, C);
4102 if Is_Generic_Instance (E)
4103 and then Is_Subprogram (E)
4104 and then Present (Alias (E))
4106 Suppress_Unsuppress_Echeck (Alias (E), C);
4109 -- Move to next homonym
4114 -- If we are within a package specification, the
4115 -- pragma only applies to homonyms in the same scope.
4117 exit when In_Package_Spec
4118 and then Scope (E) /= Current_Scope;
4121 end Process_Suppress_Unsuppress;
4127 procedure Set_Exported (E : Entity_Id; Arg : Node_Id) is
4129 if Is_Imported (E) then
4131 ("cannot export entity& that was previously imported", Arg);
4133 elsif Present (Address_Clause (E)) then
4135 ("cannot export entity& that has an address clause", Arg);
4138 Set_Is_Exported (E);
4140 -- Generate a reference for entity explicitly, because the
4141 -- identifier may be overloaded and name resolution will not
4144 Generate_Reference (E, Arg);
4146 -- Deal with exporting non-library level entity
4148 if not Is_Library_Level_Entity (E) then
4150 -- Not allowed at all for subprograms
4152 if Is_Subprogram (E) then
4153 Error_Pragma_Arg ("local subprogram& cannot be exported", Arg);
4155 -- Otherwise set public and statically allocated
4159 Set_Is_Statically_Allocated (E);
4161 -- Warn if the corresponding W flag is set and the pragma
4162 -- comes from source. The latter may not be true e.g. on
4163 -- VMS where we expand export pragmas for exception codes
4164 -- associated with imported or exported exceptions. We do
4165 -- not want to generate a warning for something that the
4166 -- user did not write.
4168 if Warn_On_Export_Import
4169 and then Comes_From_Source (Arg)
4172 ("?& has been made static as a result of Export", Arg, E);
4174 ("\this usage is non-standard and non-portable", Arg);
4179 if Warn_On_Export_Import and then Is_Type (E) then
4181 ("exporting a type has no effect?", Arg, E);
4184 if Warn_On_Export_Import and Inside_A_Generic then
4186 ("all instances of& will have the same external name?", Arg, E);
4190 ----------------------------------------------
4191 -- Set_Extended_Import_Export_External_Name --
4192 ----------------------------------------------
4194 procedure Set_Extended_Import_Export_External_Name
4195 (Internal_Ent : Entity_Id;
4196 Arg_External : Node_Id)
4198 Old_Name : constant Node_Id := Interface_Name (Internal_Ent);
4202 if No (Arg_External) then
4206 Check_Arg_Is_External_Name (Arg_External);
4208 if Nkind (Arg_External) = N_String_Literal then
4209 if String_Length (Strval (Arg_External)) = 0 then
4212 New_Name := Adjust_External_Name_Case (Arg_External);
4215 elsif Nkind (Arg_External) = N_Identifier then
4216 New_Name := Get_Default_External_Name (Arg_External);
4218 -- Check_Arg_Is_External_Name should let through only
4219 -- identifiers and string literals or static string
4220 -- expressions (which are folded to string literals).
4223 raise Program_Error;
4226 -- If we already have an external name set (by a prior normal
4227 -- Import or Export pragma), then the external names must match
4229 if Present (Interface_Name (Internal_Ent)) then
4230 Check_Matching_Internal_Names : declare
4231 S1 : constant String_Id := Strval (Old_Name);
4232 S2 : constant String_Id := Strval (New_Name);
4235 -- Called if names do not match
4241 procedure Mismatch is
4243 Error_Msg_Sloc := Sloc (Old_Name);
4245 ("external name does not match that given #",
4249 -- Start of processing for Check_Matching_Internal_Names
4252 if String_Length (S1) /= String_Length (S2) then
4256 for J in 1 .. String_Length (S1) loop
4257 if Get_String_Char (S1, J) /= Get_String_Char (S2, J) then
4262 end Check_Matching_Internal_Names;
4264 -- Otherwise set the given name
4267 Set_Encoded_Interface_Name (Internal_Ent, New_Name);
4268 Check_Duplicated_Export_Name (New_Name);
4270 end Set_Extended_Import_Export_External_Name;
4276 procedure Set_Imported (E : Entity_Id) is
4278 -- Error message if already imported or exported
4280 if Is_Exported (E) or else Is_Imported (E) then
4281 if Is_Exported (E) then
4282 Error_Msg_NE ("entity& was previously exported", N, E);
4284 Error_Msg_NE ("entity& was previously imported", N, E);
4287 Error_Msg_Name_1 := Chars (N);
4289 ("\(pragma% applies to all previous entities)", N);
4291 Error_Msg_Sloc := Sloc (E);
4292 Error_Msg_NE ("\import not allowed for& declared#", N, E);
4294 -- Here if not previously imported or exported, OK to import
4297 Set_Is_Imported (E);
4299 -- If the entity is an object that is not at the library
4300 -- level, then it is statically allocated. We do not worry
4301 -- about objects with address clauses in this context since
4302 -- they are not really imported in the linker sense.
4305 and then not Is_Library_Level_Entity (E)
4306 and then No (Address_Clause (E))
4308 Set_Is_Statically_Allocated (E);
4313 -------------------------
4314 -- Set_Mechanism_Value --
4315 -------------------------
4317 -- Note: the mechanism name has not been analyzed (and cannot indeed
4318 -- be analyzed, since it is semantic nonsense), so we get it in the
4319 -- exact form created by the parser.
4321 procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id) is
4325 procedure Bad_Class;
4326 -- Signal bad descriptor class name
4328 procedure Bad_Mechanism;
4329 -- Signal bad mechanism name
4335 procedure Bad_Class is
4337 Error_Pragma_Arg ("unrecognized descriptor class name", Class);
4340 -------------------------
4341 -- Bad_Mechanism_Value --
4342 -------------------------
4344 procedure Bad_Mechanism is
4346 Error_Pragma_Arg ("unrecognized mechanism name", Mech_Name);
4349 -- Start of processing for Set_Mechanism_Value
4352 if Mechanism (Ent) /= Default_Mechanism then
4354 ("mechanism for & has already been set", Mech_Name, Ent);
4357 -- MECHANISM_NAME ::= value | reference | descriptor
4359 if Nkind (Mech_Name) = N_Identifier then
4360 if Chars (Mech_Name) = Name_Value then
4361 Set_Mechanism (Ent, By_Copy);
4364 elsif Chars (Mech_Name) = Name_Reference then
4365 Set_Mechanism (Ent, By_Reference);
4368 elsif Chars (Mech_Name) = Name_Descriptor then
4369 Check_VMS (Mech_Name);
4370 Set_Mechanism (Ent, By_Descriptor);
4373 elsif Chars (Mech_Name) = Name_Copy then
4375 ("bad mechanism name, Value assumed", Mech_Name);
4381 -- MECHANISM_NAME ::= descriptor (CLASS_NAME)
4382 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
4384 -- Note: this form is parsed as an indexed component
4386 elsif Nkind (Mech_Name) = N_Indexed_Component then
4387 Class := First (Expressions (Mech_Name));
4389 if Nkind (Prefix (Mech_Name)) /= N_Identifier
4390 or else Chars (Prefix (Mech_Name)) /= Name_Descriptor
4391 or else Present (Next (Class))
4396 -- MECHANISM_NAME ::= descriptor (Class => CLASS_NAME)
4397 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
4399 -- Note: this form is parsed as a function call
4401 elsif Nkind (Mech_Name) = N_Function_Call then
4403 Param := First (Parameter_Associations (Mech_Name));
4405 if Nkind (Name (Mech_Name)) /= N_Identifier
4406 or else Chars (Name (Mech_Name)) /= Name_Descriptor
4407 or else Present (Next (Param))
4408 or else No (Selector_Name (Param))
4409 or else Chars (Selector_Name (Param)) /= Name_Class
4413 Class := Explicit_Actual_Parameter (Param);
4420 -- Fall through here with Class set to descriptor class name
4422 Check_VMS (Mech_Name);
4424 if Nkind (Class) /= N_Identifier then
4427 elsif Chars (Class) = Name_UBS then
4428 Set_Mechanism (Ent, By_Descriptor_UBS);
4430 elsif Chars (Class) = Name_UBSB then
4431 Set_Mechanism (Ent, By_Descriptor_UBSB);
4433 elsif Chars (Class) = Name_UBA then
4434 Set_Mechanism (Ent, By_Descriptor_UBA);
4436 elsif Chars (Class) = Name_S then
4437 Set_Mechanism (Ent, By_Descriptor_S);
4439 elsif Chars (Class) = Name_SB then
4440 Set_Mechanism (Ent, By_Descriptor_SB);
4442 elsif Chars (Class) = Name_A then
4443 Set_Mechanism (Ent, By_Descriptor_A);
4445 elsif Chars (Class) = Name_NCA then
4446 Set_Mechanism (Ent, By_Descriptor_NCA);
4451 end Set_Mechanism_Value;
4453 ---------------------------
4454 -- Set_Ravenscar_Profile --
4455 ---------------------------
4457 -- The tasks to be done here are
4459 -- Set required policies
4461 -- pragma Task_Dispatching_Policy (FIFO_Within_Priorities)
4462 -- pragma Locking_Policy (Ceiling_Locking)
4464 -- Set Detect_Blocking mode
4466 -- Set required restrictions (see System.Rident for detailed list)
4468 procedure Set_Ravenscar_Profile (N : Node_Id) is
4470 -- pragma Task_Dispatching_Policy (FIFO_Within_Priorities)
4472 if Task_Dispatching_Policy /= ' '
4473 and then Task_Dispatching_Policy /= 'F'
4475 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
4476 Error_Pragma ("Profile (Ravenscar) incompatible with policy#");
4478 -- Set the FIFO_Within_Priorities policy, but always preserve
4479 -- System_Location since we like the error message with the run time
4483 Task_Dispatching_Policy := 'F';
4485 if Task_Dispatching_Policy_Sloc /= System_Location then
4486 Task_Dispatching_Policy_Sloc := Loc;
4490 -- pragma Locking_Policy (Ceiling_Locking)
4492 if Locking_Policy /= ' '
4493 and then Locking_Policy /= 'C'
4495 Error_Msg_Sloc := Locking_Policy_Sloc;
4496 Error_Pragma ("Profile (Ravenscar) incompatible with policy#");
4498 -- Set the Ceiling_Locking policy, but preserve System_Location since
4499 -- we like the error message with the run time name.
4502 Locking_Policy := 'C';
4504 if Locking_Policy_Sloc /= System_Location then
4505 Locking_Policy_Sloc := Loc;
4509 -- pragma Detect_Blocking
4511 Detect_Blocking := True;
4513 -- Set the corresponding restrictions
4515 Set_Profile_Restrictions (Ravenscar, N, Warn => False);
4516 end Set_Ravenscar_Profile;
4518 -- Start of processing for Analyze_Pragma
4521 -- Deal with unrecognized pragma
4523 if not Is_Pragma_Name (Chars (N)) then
4524 if Warn_On_Unrecognized_Pragma then
4525 Error_Msg_Name_1 := Chars (N);
4526 Error_Msg_N ("?unrecognized pragma%!", N);
4528 for PN in First_Pragma_Name .. Last_Pragma_Name loop
4529 if Is_Bad_Spelling_Of
4530 (Get_Name_String (Chars (N)),
4531 Get_Name_String (PN))
4533 Error_Msg_Name_1 := PN;
4534 Error_Msg_N ("\?possible misspelling of %!", N);
4543 -- Here to start processing for recognized pragma
4545 Prag_Id := Get_Pragma_Id (Chars (N));
4554 if Present (Pragma_Argument_Associations (N)) then
4555 Arg1 := First (Pragma_Argument_Associations (N));
4557 if Present (Arg1) then
4558 Arg2 := Next (Arg1);
4560 if Present (Arg2) then
4561 Arg3 := Next (Arg2);
4563 if Present (Arg3) then
4564 Arg4 := Next (Arg3);
4570 -- Count number of arguments
4577 while Present (Arg_Node) loop
4578 Arg_Count := Arg_Count + 1;
4583 -- An enumeration type defines the pragmas that are supported by the
4584 -- implementation. Get_Pragma_Id (in package Prag) transorms a name
4585 -- into the corresponding enumeration value for the following case.
4593 -- pragma Abort_Defer;
4595 when Pragma_Abort_Defer =>
4597 Check_Arg_Count (0);
4599 -- The only required semantic processing is to check the
4600 -- placement. This pragma must appear at the start of the
4601 -- statement sequence of a handled sequence of statements.
4603 if Nkind (Parent (N)) /= N_Handled_Sequence_Of_Statements
4604 or else N /= First (Statements (Parent (N)))
4615 -- Note: this pragma also has some specific processing in Par.Prag
4616 -- because we want to set the Ada version mode during parsing.
4618 when Pragma_Ada_83 =>
4620 Check_Arg_Count (0);
4622 -- We really should check unconditionally for proper configuration
4623 -- pragma placement, since we really don't want mixed Ada modes
4624 -- within a single unit, and the GNAT reference manual has always
4625 -- said this was a configuration pragma, but we did not check and
4626 -- are hesitant to add the check now.
4628 -- However, we really cannot tolerate mixing Ada 2005 with Ada 83
4629 -- or Ada 95, so we must check if we are in Ada 2005 mode.
4631 if Ada_Version >= Ada_05 then
4632 Check_Valid_Configuration_Pragma;
4635 -- Now set Ada 83 mode
4637 Ada_Version := Ada_83;
4638 Ada_Version_Explicit := Ada_Version;
4646 -- Note: this pragma also has some specific processing in Par.Prag
4647 -- because we want to set the Ada 83 version mode during parsing.
4649 when Pragma_Ada_95 =>
4651 Check_Arg_Count (0);
4653 -- We really should check unconditionally for proper configuration
4654 -- pragma placement, since we really don't want mixed Ada modes
4655 -- within a single unit, and the GNAT reference manual has always
4656 -- said this was a configuration pragma, but we did not check and
4657 -- are hesitant to add the check now.
4659 -- However, we really cannot tolerate mixing Ada 2005 with Ada 83
4660 -- or Ada 95, so we must check if we are in Ada 2005 mode.
4662 if Ada_Version >= Ada_05 then
4663 Check_Valid_Configuration_Pragma;
4666 -- Now set Ada 95 mode
4668 Ada_Version := Ada_95;
4669 Ada_Version_Explicit := Ada_Version;
4671 ---------------------
4672 -- Ada_05/Ada_2005 --
4673 ---------------------
4676 -- pragma Ada_05 (LOCAL_NAME);
4679 -- pragma Ada_2005 (LOCAL_NAME):
4681 -- Note: these pragma also have some specific processing in Par.Prag
4682 -- because we want to set the Ada 2005 version mode during parsing.
4684 when Pragma_Ada_05 | Pragma_Ada_2005 => declare
4690 if Arg_Count = 1 then
4691 Check_Arg_Is_Local_Name (Arg1);
4692 E_Id := Expression (Arg1);
4694 if Etype (E_Id) = Any_Type then
4698 Set_Is_Ada_2005_Only (Entity (E_Id));
4701 Check_Arg_Count (0);
4703 -- For Ada_2005 we unconditionally enforce the documented
4704 -- configuration pragma placement, since we do not want to
4705 -- tolerate mixed modes in a unit involving Ada 2005. That
4706 -- would cause real difficulties for those cases where there
4707 -- are incompatibilities between Ada 95 and Ada 2005.
4709 Check_Valid_Configuration_Pragma;
4711 -- Now set Ada 2005 mode
4713 Ada_Version := Ada_05;
4714 Ada_Version_Explicit := Ada_05;
4718 ----------------------
4719 -- All_Calls_Remote --
4720 ----------------------
4722 -- pragma All_Calls_Remote [(library_package_NAME)];
4724 when Pragma_All_Calls_Remote => All_Calls_Remote : declare
4725 Lib_Entity : Entity_Id;
4728 Check_Ada_83_Warning;
4729 Check_Valid_Library_Unit_Pragma;
4731 if Nkind (N) = N_Null_Statement then
4735 Lib_Entity := Find_Lib_Unit_Name;
4737 -- This pragma should only apply to a RCI unit (RM E.2.3(23))
4739 if Present (Lib_Entity)
4740 and then not Debug_Flag_U
4742 if not Is_Remote_Call_Interface (Lib_Entity) then
4743 Error_Pragma ("pragma% only apply to rci unit");
4745 -- Set flag for entity of the library unit
4748 Set_Has_All_Calls_Remote (Lib_Entity);
4752 end All_Calls_Remote;
4758 -- pragma Annotate (IDENTIFIER {, ARG});
4759 -- ARG ::= NAME | EXPRESSION
4761 when Pragma_Annotate => Annotate : begin
4763 Check_At_Least_N_Arguments (1);
4764 Check_Arg_Is_Identifier (Arg1);
4772 while Present (Arg) loop
4773 Exp := Expression (Arg);
4776 if Is_Entity_Name (Exp) then
4779 elsif Nkind (Exp) = N_String_Literal then
4780 Resolve (Exp, Standard_String);
4782 elsif Is_Overloaded (Exp) then
4783 Error_Pragma_Arg ("ambiguous argument for pragma%", Exp);
4798 -- pragma Assert ([Check =>] Boolean_EXPRESSION
4799 -- [, [Message =>] Static_String_EXPRESSION]);
4801 when Pragma_Assert => Assert : declare
4806 Check_At_Least_N_Arguments (1);
4807 Check_At_Most_N_Arguments (2);
4808 Check_Arg_Order ((Name_Check, Name_Message));
4809 Check_Optional_Identifier (Arg1, Name_Check);
4811 if Arg_Count > 1 then
4812 Check_Optional_Identifier (Arg2, Name_Message);
4813 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
4816 -- If expansion is active and assertions are inactive, then
4817 -- we rewrite the Assertion as:
4819 -- if False and then condition then
4823 -- The reason we do this rewriting during semantic analysis
4824 -- rather than as part of normal expansion is that we cannot
4825 -- analyze and expand the code for the boolean expression
4826 -- directly, or it may cause insertion of actions that would
4827 -- escape the attempt to suppress the assertion code.
4829 Expr := Expression (Arg1);
4831 if Expander_Active and not Assertions_Enabled then
4833 Make_If_Statement (Loc,
4836 Left_Opnd => New_Occurrence_Of (Standard_False, Loc),
4837 Right_Opnd => Expr),
4838 Then_Statements => New_List (
4839 Make_Null_Statement (Loc))));
4843 -- Otherwise (if assertions are enabled, or if we are not
4844 -- operating with expansion active), then we just analyze
4845 -- and resolve the expression.
4848 Analyze_And_Resolve (Expr, Any_Boolean);
4851 -- If assertion is of the form (X'First = literal), where X is
4852 -- formal parameter, then set Low_Bound_Known flag on this formal.
4854 if Nkind (Expr) = N_Op_Eq then
4856 Right : constant Node_Id := Right_Opnd (Expr);
4857 Left : constant Node_Id := Left_Opnd (Expr);
4859 if Nkind (Left) = N_Attribute_Reference
4860 and then Attribute_Name (Left) = Name_First
4861 and then Is_Entity_Name (Prefix (Left))
4862 and then Is_Formal (Entity (Prefix (Left)))
4863 and then Nkind (Right) = N_Integer_Literal
4865 Set_Low_Bound_Known (Entity (Prefix (Left)));
4871 ----------------------
4872 -- Assertion_Policy --
4873 ----------------------
4875 -- pragma Assertion_Policy (Check | Ignore)
4877 when Pragma_Assertion_Policy =>
4879 Check_Arg_Count (1);
4880 Check_Arg_Is_One_Of (Arg1, Name_Check, Name_Ignore);
4881 Assertions_Enabled := Chars (Expression (Arg1)) = Name_Check;
4887 -- pragma AST_Entry (entry_IDENTIFIER);
4889 when Pragma_AST_Entry => AST_Entry : declare
4895 Check_Arg_Count (1);
4896 Check_No_Identifiers;
4897 Check_Arg_Is_Local_Name (Arg1);
4898 Ent := Entity (Expression (Arg1));
4900 -- Note: the implementation of the AST_Entry pragma could handle
4901 -- the entry family case fine, but for now we are consistent with
4902 -- the DEC rules, and do not allow the pragma, which of course
4903 -- has the effect of also forbidding the attribute.
4905 if Ekind (Ent) /= E_Entry then
4907 ("pragma% argument must be simple entry name", Arg1);
4909 elsif Is_AST_Entry (Ent) then
4911 ("duplicate % pragma for entry", Arg1);
4913 elsif Has_Homonym (Ent) then
4915 ("pragma% argument cannot specify overloaded entry", Arg1);
4919 FF : constant Entity_Id := First_Formal (Ent);
4922 if Present (FF) then
4923 if Present (Next_Formal (FF)) then
4925 ("entry for pragma% can have only one argument",
4928 elsif Parameter_Mode (FF) /= E_In_Parameter then
4930 ("entry parameter for pragma% must have mode IN",
4936 Set_Is_AST_Entry (Ent);
4944 -- pragma Asynchronous (LOCAL_NAME);
4946 when Pragma_Asynchronous => Asynchronous : declare
4954 procedure Process_Async_Pragma;
4955 -- Common processing for procedure and access-to-procedure case
4957 --------------------------
4958 -- Process_Async_Pragma --
4959 --------------------------
4961 procedure Process_Async_Pragma is
4964 Set_Is_Asynchronous (Nm);
4968 -- The formals should be of mode IN (RM E.4.1(6))
4971 while Present (S) loop
4972 Formal := Defining_Identifier (S);
4974 if Nkind (Formal) = N_Defining_Identifier
4975 and then Ekind (Formal) /= E_In_Parameter
4978 ("pragma% procedure can only have IN parameter",
4985 Set_Is_Asynchronous (Nm);
4986 end Process_Async_Pragma;
4988 -- Start of processing for pragma Asynchronous
4991 Check_Ada_83_Warning;
4992 Check_No_Identifiers;
4993 Check_Arg_Count (1);
4994 Check_Arg_Is_Local_Name (Arg1);
4996 if Debug_Flag_U then
5000 C_Ent := Cunit_Entity (Current_Sem_Unit);
5001 Analyze (Expression (Arg1));
5002 Nm := Entity (Expression (Arg1));
5004 if not Is_Remote_Call_Interface (C_Ent)
5005 and then not Is_Remote_Types (C_Ent)
5007 -- This pragma should only appear in an RCI or Remote Types
5008 -- unit (RM E.4.1(4))
5011 ("pragma% not in Remote_Call_Interface or " &
5012 "Remote_Types unit");
5015 if Ekind (Nm) = E_Procedure
5016 and then Nkind (Parent (Nm)) = N_Procedure_Specification
5018 if not Is_Remote_Call_Interface (Nm) then
5020 ("pragma% cannot be applied on non-remote procedure",
5024 L := Parameter_Specifications (Parent (Nm));
5025 Process_Async_Pragma;
5028 elsif Ekind (Nm) = E_Function then
5030 ("pragma% cannot be applied to function", Arg1);
5032 elsif Is_Remote_Access_To_Subprogram_Type (Nm) then
5034 if Is_Record_Type (Nm) then
5035 -- A record type that is the Equivalent_Type for
5036 -- a remote access-to-subprogram type.
5038 N := Declaration_Node (Corresponding_Remote_Type (Nm));
5041 -- A non-expanded RAS type (case where distribution is
5044 N := Declaration_Node (Nm);
5047 if Nkind (N) = N_Full_Type_Declaration
5048 and then Nkind (Type_Definition (N)) =
5049 N_Access_Procedure_Definition
5051 L := Parameter_Specifications (Type_Definition (N));
5052 Process_Async_Pragma;
5054 if Is_Asynchronous (Nm)
5055 and then Expander_Active
5056 and then Get_PCS_Name /= Name_No_DSA
5058 RACW_Type_Is_Asynchronous (Underlying_RACW_Type (Nm));
5063 ("pragma% cannot reference access-to-function type",
5067 -- Only other possibility is Access-to-class-wide type
5069 elsif Is_Access_Type (Nm)
5070 and then Is_Class_Wide_Type (Designated_Type (Nm))
5072 Check_First_Subtype (Arg1);
5073 Set_Is_Asynchronous (Nm);
5074 if Expander_Active then
5075 RACW_Type_Is_Asynchronous (Nm);
5079 Error_Pragma_Arg ("inappropriate argument for pragma%", Arg1);
5087 -- pragma Atomic (LOCAL_NAME);
5089 when Pragma_Atomic =>
5090 Process_Atomic_Shared_Volatile;
5092 -----------------------
5093 -- Atomic_Components --
5094 -----------------------
5096 -- pragma Atomic_Components (array_LOCAL_NAME);
5098 -- This processing is shared by Volatile_Components
5100 when Pragma_Atomic_Components |
5101 Pragma_Volatile_Components =>
5103 Atomic_Components : declare
5110 Check_Ada_83_Warning;
5111 Check_No_Identifiers;
5112 Check_Arg_Count (1);
5113 Check_Arg_Is_Local_Name (Arg1);
5114 E_Id := Expression (Arg1);
5116 if Etype (E_Id) = Any_Type then
5122 if Rep_Item_Too_Early (E, N)
5124 Rep_Item_Too_Late (E, N)
5129 D := Declaration_Node (E);
5132 if (K = N_Full_Type_Declaration and then Is_Array_Type (E))
5134 ((Ekind (E) = E_Constant or else Ekind (E) = E_Variable)
5135 and then Nkind (D) = N_Object_Declaration
5136 and then Nkind (Object_Definition (D)) =
5137 N_Constrained_Array_Definition)
5139 -- The flag is set on the object, or on the base type
5141 if Nkind (D) /= N_Object_Declaration then
5145 Set_Has_Volatile_Components (E);
5147 if Prag_Id = Pragma_Atomic_Components then
5148 Set_Has_Atomic_Components (E);
5150 if Is_Packed (E) then
5151 Set_Is_Packed (E, False);
5154 ("?Pack canceled, cannot pack atomic components",
5160 Error_Pragma_Arg ("inappropriate entity for pragma%", Arg1);
5162 end Atomic_Components;
5164 --------------------
5165 -- Attach_Handler --
5166 --------------------
5168 -- pragma Attach_Handler (handler_NAME, EXPRESSION);
5170 when Pragma_Attach_Handler =>
5171 Check_Ada_83_Warning;
5172 Check_No_Identifiers;
5173 Check_Arg_Count (2);
5175 if No_Run_Time_Mode then
5176 Error_Msg_CRT ("Attach_Handler pragma", N);
5178 Check_Interrupt_Or_Attach_Handler;
5180 -- The expression that designates the attribute may
5181 -- depend on a discriminant, and is therefore a per-
5182 -- object expression, to be expanded in the init proc.
5183 -- If expansion is enabled, perform semantic checks
5186 if Expander_Active then
5188 Temp : constant Node_Id :=
5189 New_Copy_Tree (Expression (Arg2));
5191 Set_Parent (Temp, N);
5192 Pre_Analyze_And_Resolve (Temp, RTE (RE_Interrupt_ID));
5196 Analyze (Expression (Arg2));
5197 Resolve (Expression (Arg2), RTE (RE_Interrupt_ID));
5200 Process_Interrupt_Or_Attach_Handler;
5203 --------------------
5204 -- C_Pass_By_Copy --
5205 --------------------
5207 -- pragma C_Pass_By_Copy ([Max_Size =>] static_integer_EXPRESSION);
5209 when Pragma_C_Pass_By_Copy => C_Pass_By_Copy : declare
5215 Check_Valid_Configuration_Pragma;
5216 Check_Arg_Count (1);
5217 Check_Optional_Identifier (Arg1, "max_size");
5219 Arg := Expression (Arg1);
5220 Check_Arg_Is_Static_Expression (Arg, Any_Integer);
5222 Val := Expr_Value (Arg);
5226 ("maximum size for pragma% must be positive", Arg1);
5228 elsif UI_Is_In_Int_Range (Val) then
5229 Default_C_Record_Mechanism := UI_To_Int (Val);
5231 -- If a giant value is given, Int'Last will do well enough.
5232 -- If sometime someone complains that a record larger than
5233 -- two gigabytes is not copied, we will worry about it then!
5236 Default_C_Record_Mechanism := Mechanism_Type'Last;
5244 -- pragma Check_Name (check_IDENTIFIER);
5246 when Pragma_Check_Name =>
5247 Check_No_Identifiers;
5249 Check_Valid_Configuration_Pragma;
5250 Check_Arg_Count (1);
5251 Check_Arg_Is_Identifier (Arg1);
5254 Nam : constant Name_Id := Chars (Expression (Arg1));
5257 for J in Check_Names.First .. Check_Names.Last loop
5258 if Check_Names.Table (J) = Nam then
5263 Check_Names.Append (Nam);
5266 ---------------------
5267 -- CIL_Constructor --
5268 ---------------------
5270 -- pragma CIL_Constructor ([Entity =>] LOCAL_NAME);
5272 -- Processing for this pragma is shared with Java_Constructor
5278 -- pragma Comment (static_string_EXPRESSION)
5280 -- Processing for pragma Comment shares the circuitry for
5281 -- pragma Ident. The only differences are that Ident enforces
5282 -- a limit of 31 characters on its argument, and also enforces
5283 -- limitations on placement for DEC compatibility. Pragma
5284 -- Comment shares neither of these restrictions.
5290 -- pragma Common_Object (
5291 -- [Internal =>] LOCAL_NAME,
5292 -- [, [External =>] EXTERNAL_SYMBOL]
5293 -- [, [Size =>] EXTERNAL_SYMBOL]);
5295 -- Processing for this pragma is shared with Psect_Object
5297 ------------------------
5298 -- Compile_Time_Error --
5299 ------------------------
5301 -- pragma Compile_Time_Error
5302 -- (boolean_EXPRESSION, static_string_EXPRESSION);
5304 when Pragma_Compile_Time_Error =>
5305 Process_Compile_Time_Warning_Or_Error;
5307 --------------------------
5308 -- Compile_Time_Warning --
5309 --------------------------
5311 -- pragma Compile_Time_Warning
5312 -- (boolean_EXPRESSION, static_string_EXPRESSION);
5314 when Pragma_Compile_Time_Warning =>
5315 Process_Compile_Time_Warning_Or_Error;
5317 -----------------------------
5318 -- Complete_Representation --
5319 -----------------------------
5321 -- pragma Complete_Representation;
5323 when Pragma_Complete_Representation =>
5325 Check_Arg_Count (0);
5327 if Nkind (Parent (N)) /= N_Record_Representation_Clause then
5329 ("pragma & must appear within record representation clause");
5332 ----------------------------
5333 -- Complex_Representation --
5334 ----------------------------
5336 -- pragma Complex_Representation ([Entity =>] LOCAL_NAME);
5338 when Pragma_Complex_Representation => Complex_Representation : declare
5345 Check_Arg_Count (1);
5346 Check_Optional_Identifier (Arg1, Name_Entity);
5347 Check_Arg_Is_Local_Name (Arg1);
5348 E_Id := Expression (Arg1);
5350 if Etype (E_Id) = Any_Type then
5356 if not Is_Record_Type (E) then
5358 ("argument for pragma% must be record type", Arg1);
5361 Ent := First_Entity (E);
5364 or else No (Next_Entity (Ent))
5365 or else Present (Next_Entity (Next_Entity (Ent)))
5366 or else not Is_Floating_Point_Type (Etype (Ent))
5367 or else Etype (Ent) /= Etype (Next_Entity (Ent))
5370 ("record for pragma% must have two fields of same fpt type",
5374 Set_Has_Complex_Representation (Base_Type (E));
5376 -- We need to treat the type has having a non-standard
5377 -- representation, for back-end purposes, even though in
5378 -- general a complex will have the default representation
5379 -- of a record with two real components.
5381 Set_Has_Non_Standard_Rep (Base_Type (E));
5383 end Complex_Representation;
5385 -------------------------
5386 -- Component_Alignment --
5387 -------------------------
5389 -- pragma Component_Alignment (
5390 -- [Form =>] ALIGNMENT_CHOICE
5391 -- [, [Name =>] type_LOCAL_NAME]);
5393 -- ALIGNMENT_CHOICE ::=
5395 -- | Component_Size_4
5399 when Pragma_Component_Alignment => Component_AlignmentP : declare
5400 Args : Args_List (1 .. 2);
5401 Names : constant Name_List (1 .. 2) := (
5405 Form : Node_Id renames Args (1);
5406 Name : Node_Id renames Args (2);
5408 Atype : Component_Alignment_Kind;
5413 Gather_Associations (Names, Args);
5416 Error_Pragma ("missing Form argument for pragma%");
5419 Check_Arg_Is_Identifier (Form);
5421 -- Get proper alignment, note that Default = Component_Size
5422 -- on all machines we have so far, and we want to set this
5423 -- value rather than the default value to indicate that it
5424 -- has been explicitly set (and thus will not get overridden
5425 -- by the default component alignment for the current scope)
5427 if Chars (Form) = Name_Component_Size then
5428 Atype := Calign_Component_Size;
5430 elsif Chars (Form) = Name_Component_Size_4 then
5431 Atype := Calign_Component_Size_4;
5433 elsif Chars (Form) = Name_Default then
5434 Atype := Calign_Component_Size;
5436 elsif Chars (Form) = Name_Storage_Unit then
5437 Atype := Calign_Storage_Unit;
5441 ("invalid Form parameter for pragma%", Form);
5444 -- Case with no name, supplied, affects scope table entry
5448 (Scope_Stack.Last).Component_Alignment_Default := Atype;
5450 -- Case of name supplied
5453 Check_Arg_Is_Local_Name (Name);
5455 Typ := Entity (Name);
5458 or else Rep_Item_Too_Early (Typ, N)
5462 Typ := Underlying_Type (Typ);
5465 if not Is_Record_Type (Typ)
5466 and then not Is_Array_Type (Typ)
5469 ("Name parameter of pragma% must identify record or " &
5470 "array type", Name);
5473 -- An explicit Component_Alignment pragma overrides an
5474 -- implicit pragma Pack, but not an explicit one.
5476 if not Has_Pragma_Pack (Base_Type (Typ)) then
5477 Set_Is_Packed (Base_Type (Typ), False);
5478 Set_Component_Alignment (Base_Type (Typ), Atype);
5481 end Component_AlignmentP;
5487 -- pragma Controlled (first_subtype_LOCAL_NAME);
5489 when Pragma_Controlled => Controlled : declare
5493 Check_No_Identifiers;
5494 Check_Arg_Count (1);
5495 Check_Arg_Is_Local_Name (Arg1);
5496 Arg := Expression (Arg1);
5498 if not Is_Entity_Name (Arg)
5499 or else not Is_Access_Type (Entity (Arg))
5501 Error_Pragma_Arg ("pragma% requires access type", Arg1);
5503 Set_Has_Pragma_Controlled (Base_Type (Entity (Arg)));
5511 -- pragma Convention ([Convention =>] convention_IDENTIFIER,
5512 -- [Entity =>] LOCAL_NAME);
5514 when Pragma_Convention => Convention : declare
5518 Check_Arg_Order ((Name_Convention, Name_Entity));
5519 Check_Ada_83_Warning;
5520 Check_Arg_Count (2);
5521 Process_Convention (C, E);
5524 ---------------------------
5525 -- Convention_Identifier --
5526 ---------------------------
5528 -- pragma Convention_Identifier ([Name =>] IDENTIFIER,
5529 -- [Convention =>] convention_IDENTIFIER);
5531 when Pragma_Convention_Identifier => Convention_Identifier : declare
5537 Check_Arg_Order ((Name_Name, Name_Convention));
5538 Check_Arg_Count (2);
5539 Check_Optional_Identifier (Arg1, Name_Name);
5540 Check_Optional_Identifier (Arg2, Name_Convention);
5541 Check_Arg_Is_Identifier (Arg1);
5542 Check_Arg_Is_Identifier (Arg2);
5543 Idnam := Chars (Expression (Arg1));
5544 Cname := Chars (Expression (Arg2));
5546 if Is_Convention_Name (Cname) then
5547 Record_Convention_Identifier
5548 (Idnam, Get_Convention_Id (Cname));
5551 ("second arg for % pragma must be convention", Arg2);
5553 end Convention_Identifier;
5559 -- pragma CPP_Class ([Entity =>] local_NAME)
5561 when Pragma_CPP_Class => CPP_Class : declare
5566 if Warn_On_Obsolescent_Feature then
5568 ("'G'N'A'T pragma cpp'_class is now obsolete; replace it" &
5569 " by pragma import?", N);
5573 Check_Arg_Count (1);
5574 Check_Optional_Identifier (Arg1, Name_Entity);
5575 Check_Arg_Is_Local_Name (Arg1);
5577 Arg := Expression (Arg1);
5580 if Etype (Arg) = Any_Type then
5584 if not Is_Entity_Name (Arg)
5585 or else not Is_Type (Entity (Arg))
5587 Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
5590 Typ := Entity (Arg);
5592 if not Is_Tagged_Type (Typ) then
5593 Error_Pragma_Arg ("pragma% applicable to tagged types ", Arg1);
5596 -- Types treated as CPP classes are treated as limited, but we
5597 -- don't require them to be declared this way. A warning is issued
5598 -- to encourage the user to declare them as limited. This is not
5599 -- an error, for compatibility reasons, because these types have
5600 -- been supported this way for some time.
5602 if not Is_Limited_Type (Typ) then
5604 ("imported 'C'P'P type should be " &
5605 "explicitly declared limited?",
5606 Get_Pragma_Arg (Arg1));
5608 ("\type will be considered limited",
5609 Get_Pragma_Arg (Arg1));
5612 Set_Is_CPP_Class (Typ);
5613 Set_Is_Limited_Record (Typ);
5614 Set_Convention (Typ, Convention_CPP);
5617 ---------------------
5618 -- CPP_Constructor --
5619 ---------------------
5621 -- pragma CPP_Constructor ([Entity =>] LOCAL_NAME
5622 -- [, [External_Name =>] static_string_EXPRESSION ]
5623 -- [, [Link_Name =>] static_string_EXPRESSION ]);
5625 when Pragma_CPP_Constructor => CPP_Constructor : declare
5631 Check_At_Least_N_Arguments (1);
5632 Check_At_Most_N_Arguments (3);
5633 Check_Optional_Identifier (Arg1, Name_Entity);
5634 Check_Arg_Is_Local_Name (Arg1);
5636 Id := Expression (Arg1);
5637 Find_Program_Unit_Name (Id);
5639 -- If we did not find the name, we are done
5641 if Etype (Id) = Any_Type then
5645 Def_Id := Entity (Id);
5647 if Ekind (Def_Id) = E_Function
5648 and then Is_Class_Wide_Type (Etype (Def_Id))
5649 and then Is_CPP_Class (Etype (Etype (Def_Id)))
5651 if Arg_Count >= 2 then
5652 Set_Imported (Def_Id);
5653 Set_Is_Public (Def_Id);
5654 Process_Interface_Name (Def_Id, Arg2, Arg3);
5657 if No (Parameter_Specifications (Parent (Def_Id))) then
5658 Set_Has_Completion (Def_Id);
5659 Set_Is_Constructor (Def_Id);
5662 ("non-default constructors not implemented", Arg1);
5667 ("pragma% requires function returning a 'C'P'P_Class type",
5670 end CPP_Constructor;
5676 when Pragma_CPP_Virtual => CPP_Virtual : declare
5678 if Warn_On_Obsolescent_Feature then
5680 ("'G'N'A'T pragma cpp'_virtual is now obsolete and has " &
5689 when Pragma_CPP_Vtable => CPP_Vtable : declare
5691 if Warn_On_Obsolescent_Feature then
5693 ("'G'N'A'T pragma cpp'_vtable is now obsolete and has " &
5702 -- pragma Debug ([boolean_EXPRESSION,] PROCEDURE_CALL_STATEMENT);
5704 when Pragma_Debug => Debug : declare
5712 (Boolean_Literals (Debug_Pragmas_Enabled and Expander_Active),
5715 if Arg_Count = 2 then
5718 Left_Opnd => Relocate_Node (Cond),
5719 Right_Opnd => Expression (Arg1));
5722 -- Rewrite into a conditional with an appropriate condition. We
5723 -- wrap the procedure call in a block so that overhead from e.g.
5724 -- use of the secondary stack does not generate execution overhead
5725 -- for suppressed conditions.
5727 Rewrite (N, Make_Implicit_If_Statement (N,
5729 Then_Statements => New_List (
5730 Make_Block_Statement (Loc,
5731 Handled_Statement_Sequence =>
5732 Make_Handled_Sequence_Of_Statements (Loc,
5733 Statements => New_List (
5734 Relocate_Node (Debug_Statement (N))))))));
5742 -- pragma Debug_Policy (Check | Ignore)
5744 when Pragma_Debug_Policy =>
5746 Check_Arg_Count (1);
5747 Check_Arg_Is_One_Of (Arg1, Name_Check, Name_Ignore);
5748 Debug_Pragmas_Enabled := Chars (Expression (Arg1)) = Name_Check;
5750 ---------------------
5751 -- Detect_Blocking --
5752 ---------------------
5754 -- pragma Detect_Blocking;
5756 when Pragma_Detect_Blocking =>
5758 Check_Arg_Count (0);
5759 Check_Valid_Configuration_Pragma;
5760 Detect_Blocking := True;
5766 -- pragma Discard_Names [([On =>] LOCAL_NAME)];
5768 when Pragma_Discard_Names => Discard_Names : declare
5773 Check_Ada_83_Warning;
5775 -- Deal with configuration pragma case
5777 if Arg_Count = 0 and then Is_Configuration_Pragma then
5778 Global_Discard_Names := True;
5781 -- Otherwise, check correct appropriate context
5784 Check_Is_In_Decl_Part_Or_Package_Spec;
5786 if Arg_Count = 0 then
5788 -- If there is no parameter, then from now on this pragma
5789 -- applies to any enumeration, exception or tagged type
5790 -- defined in the current declarative part, and recursively
5791 -- to any nested scope.
5793 Set_Discard_Names (Current_Scope);
5797 Check_Arg_Count (1);
5798 Check_Optional_Identifier (Arg1, Name_On);
5799 Check_Arg_Is_Local_Name (Arg1);
5800 E_Id := Expression (Arg1);
5802 if Etype (E_Id) = Any_Type then
5808 if (Is_First_Subtype (E)
5809 and then (Is_Enumeration_Type (E)
5810 or else Is_Tagged_Type (E)))
5811 or else Ekind (E) = E_Exception
5813 Set_Discard_Names (E);
5816 ("inappropriate entity for pragma%", Arg1);
5826 -- pragma Elaborate (library_unit_NAME {, library_unit_NAME});
5828 when Pragma_Elaborate => Elaborate : declare
5833 -- Pragma must be in context items list of a compilation unit
5835 if not Is_In_Context_Clause then
5839 -- Must be at least one argument
5841 if Arg_Count = 0 then
5842 Error_Pragma ("pragma% requires at least one argument");
5845 -- In Ada 83 mode, there can be no items following it in the
5846 -- context list except other pragmas and implicit with clauses
5847 -- (e.g. those added by use of Rtsfind). In Ada 95 mode, this
5848 -- placement rule does not apply.
5850 if Ada_Version = Ada_83 and then Comes_From_Source (N) then
5852 while Present (Citem) loop
5853 if Nkind (Citem) = N_Pragma
5854 or else (Nkind (Citem) = N_With_Clause
5855 and then Implicit_With (Citem))
5860 ("(Ada 83) pragma% must be at end of context clause");
5867 -- Finally, the arguments must all be units mentioned in a with
5868 -- clause in the same context clause. Note we already checked (in
5869 -- Par.Prag) that the arguments are all identifiers or selected
5873 Outer : while Present (Arg) loop
5874 Citem := First (List_Containing (N));
5875 Inner : while Citem /= N loop
5876 if Nkind (Citem) = N_With_Clause
5877 and then Same_Name (Name (Citem), Expression (Arg))
5879 Set_Elaborate_Present (Citem, True);
5880 Set_Unit_Name (Expression (Arg), Name (Citem));
5882 -- With the pragma present, elaboration calls on
5883 -- subprograms from the named unit need no further
5884 -- checks, as long as the pragma appears in the current
5885 -- compilation unit. If the pragma appears in some unit
5886 -- in the context, there might still be a need for an
5887 -- Elaborate_All_Desirable from the current compilation
5888 -- to the the named unit, so we keep the check enabled.
5890 if In_Extended_Main_Source_Unit (N) then
5891 Set_Suppress_Elaboration_Warnings
5892 (Entity (Name (Citem)));
5903 ("argument of pragma% is not with'ed unit", Arg);
5909 -- Give a warning if operating in static mode with -gnatwl
5910 -- (elaboration warnings eanbled) switch set.
5912 if Elab_Warnings and not Dynamic_Elaboration_Checks then
5914 ("?use of pragma Elaborate may not be safe", N);
5916 ("?use pragma Elaborate_All instead if possible", N);
5924 -- pragma Elaborate_All (library_unit_NAME {, library_unit_NAME});
5926 when Pragma_Elaborate_All => Elaborate_All : declare
5931 Check_Ada_83_Warning;
5933 -- Pragma must be in context items list of a compilation unit
5935 if not Is_In_Context_Clause then
5939 -- Must be at least one argument
5941 if Arg_Count = 0 then
5942 Error_Pragma ("pragma% requires at least one argument");
5945 -- Note: unlike pragma Elaborate, pragma Elaborate_All does not
5946 -- have to appear at the end of the context clause, but may
5947 -- appear mixed in with other items, even in Ada 83 mode.
5949 -- Final check: the arguments must all be units mentioned in
5950 -- a with clause in the same context clause. Note that we
5951 -- already checked (in Par.Prag) that all the arguments are
5952 -- either identifiers or selected components.
5955 Outr : while Present (Arg) loop
5956 Citem := First (List_Containing (N));
5957 Innr : while Citem /= N loop
5958 if Nkind (Citem) = N_With_Clause
5959 and then Same_Name (Name (Citem), Expression (Arg))
5961 Set_Elaborate_All_Present (Citem, True);
5962 Set_Unit_Name (Expression (Arg), Name (Citem));
5964 -- Suppress warnings and elaboration checks on the named
5965 -- unit if the pragma is in the current compilation, as
5966 -- for pragma Elaborate.
5968 if In_Extended_Main_Source_Unit (N) then
5969 Set_Suppress_Elaboration_Warnings
5970 (Entity (Name (Citem)));
5979 Set_Error_Posted (N);
5981 ("argument of pragma% is not with'ed unit", Arg);
5988 --------------------
5989 -- Elaborate_Body --
5990 --------------------
5992 -- pragma Elaborate_Body [( library_unit_NAME )];
5994 when Pragma_Elaborate_Body => Elaborate_Body : declare
5995 Cunit_Node : Node_Id;
5996 Cunit_Ent : Entity_Id;
5999 Check_Ada_83_Warning;
6000 Check_Valid_Library_Unit_Pragma;
6002 if Nkind (N) = N_Null_Statement then
6006 Cunit_Node := Cunit (Current_Sem_Unit);
6007 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
6009 if Nkind (Unit (Cunit_Node)) = N_Package_Body
6011 Nkind (Unit (Cunit_Node)) = N_Subprogram_Body
6013 Error_Pragma ("pragma% must refer to a spec, not a body");
6015 Set_Body_Required (Cunit_Node, True);
6016 Set_Has_Pragma_Elaborate_Body (Cunit_Ent);
6018 -- If we are in dynamic elaboration mode, then we suppress
6019 -- elaboration warnings for the unit, since it is definitely
6020 -- fine NOT to do dynamic checks at the first level (and such
6021 -- checks will be suppressed because no elaboration boolean
6022 -- is created for Elaborate_Body packages).
6024 -- But in the static model of elaboration, Elaborate_Body is
6025 -- definitely NOT good enough to ensure elaboration safety on
6026 -- its own, since the body may WITH other units that are not
6027 -- safe from an elaboration point of view, so a client must
6028 -- still do an Elaborate_All on such units.
6030 -- Debug flag -gnatdD restores the old behavior of 3.13,
6031 -- where Elaborate_Body always suppressed elab warnings.
6033 if Dynamic_Elaboration_Checks or Debug_Flag_DD then
6034 Set_Suppress_Elaboration_Warnings (Cunit_Ent);
6039 ------------------------
6040 -- Elaboration_Checks --
6041 ------------------------
6043 -- pragma Elaboration_Checks (Static | Dynamic);
6045 when Pragma_Elaboration_Checks =>
6047 Check_Arg_Count (1);
6048 Check_Arg_Is_One_Of (Arg1, Name_Static, Name_Dynamic);
6049 Dynamic_Elaboration_Checks :=
6050 (Chars (Get_Pragma_Arg (Arg1)) = Name_Dynamic);
6056 -- pragma Eliminate (
6057 -- [Unit_Name =>] IDENTIFIER |
6058 -- SELECTED_COMPONENT
6059 -- [,[Entity =>] IDENTIFIER |
6060 -- SELECTED_COMPONENT |
6062 -- [,]OVERLOADING_RESOLUTION);
6064 -- OVERLOADING_RESOLUTION ::= PARAMETER_AND_RESULT_TYPE_PROFILE |
6067 -- PARAMETER_AND_RESULT_TYPE_PROFILE ::= PROCEDURE_PROFILE |
6070 -- PROCEDURE_PROFILE ::= Parameter_Types => PARAMETER_TYPES
6072 -- FUNCTION_PROFILE ::= [Parameter_Types => PARAMETER_TYPES,]
6073 -- Result_Type => result_SUBTYPE_NAME]
6075 -- PARAMETER_TYPES ::= (SUBTYPE_NAME {, SUBTYPE_NAME})
6076 -- SUBTYPE_NAME ::= STRING_LITERAL
6078 -- SOURCE_LOCATION ::= Source_Location => SOURCE_TRACE
6079 -- SOURCE_TRACE ::= STRING_LITERAL
6081 when Pragma_Eliminate => Eliminate : declare
6082 Args : Args_List (1 .. 5);
6083 Names : constant Name_List (1 .. 5) := (
6086 Name_Parameter_Types,
6088 Name_Source_Location);
6090 Unit_Name : Node_Id renames Args (1);
6091 Entity : Node_Id renames Args (2);
6092 Parameter_Types : Node_Id renames Args (3);
6093 Result_Type : Node_Id renames Args (4);
6094 Source_Location : Node_Id renames Args (5);
6098 Check_Valid_Configuration_Pragma;
6099 Gather_Associations (Names, Args);
6101 if No (Unit_Name) then
6102 Error_Pragma ("missing Unit_Name argument for pragma%");
6106 and then (Present (Parameter_Types)
6108 Present (Result_Type)
6110 Present (Source_Location))
6112 Error_Pragma ("missing Entity argument for pragma%");
6115 if (Present (Parameter_Types)
6117 Present (Result_Type))
6119 Present (Source_Location)
6122 ("parameter profile and source location cannot " &
6123 "be used together in pragma%");
6126 Process_Eliminate_Pragma
6140 -- [ Convention =>] convention_IDENTIFIER,
6141 -- [ Entity =>] local_NAME
6142 -- [, [External_Name =>] static_string_EXPRESSION ]
6143 -- [, [Link_Name =>] static_string_EXPRESSION ]);
6145 when Pragma_Export => Export : declare
6150 Check_Ada_83_Warning;
6156 Check_At_Least_N_Arguments (2);
6157 Check_At_Most_N_Arguments (4);
6158 Process_Convention (C, Def_Id);
6160 if Ekind (Def_Id) /= E_Constant then
6161 Note_Possible_Modification (Expression (Arg2));
6164 Process_Interface_Name (Def_Id, Arg3, Arg4);
6165 Set_Exported (Def_Id, Arg2);
6168 ----------------------
6169 -- Export_Exception --
6170 ----------------------
6172 -- pragma Export_Exception (
6173 -- [Internal =>] LOCAL_NAME,
6174 -- [, [External =>] EXTERNAL_SYMBOL,]
6175 -- [, [Form =>] Ada | VMS]
6176 -- [, [Code =>] static_integer_EXPRESSION]);
6178 when Pragma_Export_Exception => Export_Exception : declare
6179 Args : Args_List (1 .. 4);
6180 Names : constant Name_List (1 .. 4) := (
6186 Internal : Node_Id renames Args (1);
6187 External : Node_Id renames Args (2);
6188 Form : Node_Id renames Args (3);
6189 Code : Node_Id renames Args (4);
6192 if Inside_A_Generic then
6193 Error_Pragma ("pragma% cannot be used for generic entities");
6196 Gather_Associations (Names, Args);
6197 Process_Extended_Import_Export_Exception_Pragma (
6198 Arg_Internal => Internal,
6199 Arg_External => External,
6203 if not Is_VMS_Exception (Entity (Internal)) then
6204 Set_Exported (Entity (Internal), Internal);
6206 end Export_Exception;
6208 ---------------------
6209 -- Export_Function --
6210 ---------------------
6212 -- pragma Export_Function (
6213 -- [Internal =>] LOCAL_NAME,
6214 -- [, [External =>] EXTERNAL_SYMBOL,]
6215 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6216 -- [, [Result_Type =>] TYPE_DESIGNATOR]
6217 -- [, [Mechanism =>] MECHANISM]
6218 -- [, [Result_Mechanism =>] MECHANISM_NAME]);
6220 -- EXTERNAL_SYMBOL ::=
6222 -- | static_string_EXPRESSION
6224 -- PARAMETER_TYPES ::=
6226 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6228 -- TYPE_DESIGNATOR ::=
6230 -- | subtype_Name ' Access
6234 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6236 -- MECHANISM_ASSOCIATION ::=
6237 -- [formal_parameter_NAME =>] MECHANISM_NAME
6239 -- MECHANISM_NAME ::=
6242 -- | Descriptor [([Class =>] CLASS_NAME)]
6244 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6246 when Pragma_Export_Function => Export_Function : declare
6247 Args : Args_List (1 .. 6);
6248 Names : constant Name_List (1 .. 6) := (
6251 Name_Parameter_Types,
6254 Name_Result_Mechanism);
6256 Internal : Node_Id renames Args (1);
6257 External : Node_Id renames Args (2);
6258 Parameter_Types : Node_Id renames Args (3);
6259 Result_Type : Node_Id renames Args (4);
6260 Mechanism : Node_Id renames Args (5);
6261 Result_Mechanism : Node_Id renames Args (6);
6265 Gather_Associations (Names, Args);
6266 Process_Extended_Import_Export_Subprogram_Pragma (
6267 Arg_Internal => Internal,
6268 Arg_External => External,
6269 Arg_Parameter_Types => Parameter_Types,
6270 Arg_Result_Type => Result_Type,
6271 Arg_Mechanism => Mechanism,
6272 Arg_Result_Mechanism => Result_Mechanism);
6273 end Export_Function;
6279 -- pragma Export_Object (
6280 -- [Internal =>] LOCAL_NAME,
6281 -- [, [External =>] EXTERNAL_SYMBOL]
6282 -- [, [Size =>] EXTERNAL_SYMBOL]);
6284 -- EXTERNAL_SYMBOL ::=
6286 -- | static_string_EXPRESSION
6288 -- PARAMETER_TYPES ::=
6290 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6292 -- TYPE_DESIGNATOR ::=
6294 -- | subtype_Name ' Access
6298 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6300 -- MECHANISM_ASSOCIATION ::=
6301 -- [formal_parameter_NAME =>] MECHANISM_NAME
6303 -- MECHANISM_NAME ::=
6306 -- | Descriptor [([Class =>] CLASS_NAME)]
6308 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6310 when Pragma_Export_Object => Export_Object : declare
6311 Args : Args_List (1 .. 3);
6312 Names : constant Name_List (1 .. 3) := (
6317 Internal : Node_Id renames Args (1);
6318 External : Node_Id renames Args (2);
6319 Size : Node_Id renames Args (3);
6323 Gather_Associations (Names, Args);
6324 Process_Extended_Import_Export_Object_Pragma (
6325 Arg_Internal => Internal,
6326 Arg_External => External,
6330 ----------------------
6331 -- Export_Procedure --
6332 ----------------------
6334 -- pragma Export_Procedure (
6335 -- [Internal =>] LOCAL_NAME,
6336 -- [, [External =>] EXTERNAL_SYMBOL,]
6337 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6338 -- [, [Mechanism =>] MECHANISM]);
6340 -- EXTERNAL_SYMBOL ::=
6342 -- | static_string_EXPRESSION
6344 -- PARAMETER_TYPES ::=
6346 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6348 -- TYPE_DESIGNATOR ::=
6350 -- | subtype_Name ' Access
6354 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6356 -- MECHANISM_ASSOCIATION ::=
6357 -- [formal_parameter_NAME =>] MECHANISM_NAME
6359 -- MECHANISM_NAME ::=
6362 -- | Descriptor [([Class =>] CLASS_NAME)]
6364 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6366 when Pragma_Export_Procedure => Export_Procedure : declare
6367 Args : Args_List (1 .. 4);
6368 Names : constant Name_List (1 .. 4) := (
6371 Name_Parameter_Types,
6374 Internal : Node_Id renames Args (1);
6375 External : Node_Id renames Args (2);
6376 Parameter_Types : Node_Id renames Args (3);
6377 Mechanism : Node_Id renames Args (4);
6381 Gather_Associations (Names, Args);
6382 Process_Extended_Import_Export_Subprogram_Pragma (
6383 Arg_Internal => Internal,
6384 Arg_External => External,
6385 Arg_Parameter_Types => Parameter_Types,
6386 Arg_Mechanism => Mechanism);
6387 end Export_Procedure;
6393 -- pragma Export_Value (
6394 -- [Value =>] static_integer_EXPRESSION,
6395 -- [Link_Name =>] static_string_EXPRESSION);
6397 when Pragma_Export_Value =>
6399 Check_Arg_Order ((Name_Value, Name_Link_Name));
6400 Check_Arg_Count (2);
6402 Check_Optional_Identifier (Arg1, Name_Value);
6403 Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
6405 Check_Optional_Identifier (Arg2, Name_Link_Name);
6406 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
6408 -----------------------------
6409 -- Export_Valued_Procedure --
6410 -----------------------------
6412 -- pragma Export_Valued_Procedure (
6413 -- [Internal =>] LOCAL_NAME,
6414 -- [, [External =>] EXTERNAL_SYMBOL,]
6415 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6416 -- [, [Mechanism =>] MECHANISM]);
6418 -- EXTERNAL_SYMBOL ::=
6420 -- | static_string_EXPRESSION
6422 -- PARAMETER_TYPES ::=
6424 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6426 -- TYPE_DESIGNATOR ::=
6428 -- | subtype_Name ' Access
6432 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6434 -- MECHANISM_ASSOCIATION ::=
6435 -- [formal_parameter_NAME =>] MECHANISM_NAME
6437 -- MECHANISM_NAME ::=
6440 -- | Descriptor [([Class =>] CLASS_NAME)]
6442 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6444 when Pragma_Export_Valued_Procedure =>
6445 Export_Valued_Procedure : declare
6446 Args : Args_List (1 .. 4);
6447 Names : constant Name_List (1 .. 4) := (
6450 Name_Parameter_Types,
6453 Internal : Node_Id renames Args (1);
6454 External : Node_Id renames Args (2);
6455 Parameter_Types : Node_Id renames Args (3);
6456 Mechanism : Node_Id renames Args (4);
6460 Gather_Associations (Names, Args);
6461 Process_Extended_Import_Export_Subprogram_Pragma (
6462 Arg_Internal => Internal,
6463 Arg_External => External,
6464 Arg_Parameter_Types => Parameter_Types,
6465 Arg_Mechanism => Mechanism);
6466 end Export_Valued_Procedure;
6472 -- pragma Extend_System ([Name =>] Identifier);
6474 when Pragma_Extend_System => Extend_System : declare
6477 Check_Valid_Configuration_Pragma;
6478 Check_Arg_Count (1);
6479 Check_Optional_Identifier (Arg1, Name_Name);
6480 Check_Arg_Is_Identifier (Arg1);
6482 Get_Name_String (Chars (Expression (Arg1)));
6485 and then Name_Buffer (1 .. 4) = "aux_"
6487 if Present (System_Extend_Pragma_Arg) then
6488 if Chars (Expression (Arg1)) =
6489 Chars (Expression (System_Extend_Pragma_Arg))
6493 Error_Msg_Sloc := Sloc (System_Extend_Pragma_Arg);
6494 Error_Pragma ("pragma% conflicts with that #");
6498 System_Extend_Pragma_Arg := Arg1;
6500 if not GNAT_Mode then
6501 System_Extend_Unit := Arg1;
6505 Error_Pragma ("incorrect name for pragma%, must be Aux_xxx");
6509 ------------------------
6510 -- Extensions_Allowed --
6511 ------------------------
6513 -- pragma Extensions_Allowed (ON | OFF);
6515 when Pragma_Extensions_Allowed =>
6517 Check_Arg_Count (1);
6518 Check_No_Identifiers;
6519 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
6521 if Chars (Expression (Arg1)) = Name_On then
6522 Extensions_Allowed := True;
6524 Extensions_Allowed := False;
6531 -- pragma External (
6532 -- [ Convention =>] convention_IDENTIFIER,
6533 -- [ Entity =>] local_NAME
6534 -- [, [External_Name =>] static_string_EXPRESSION ]
6535 -- [, [Link_Name =>] static_string_EXPRESSION ]);
6537 when Pragma_External => External : declare
6547 Check_At_Least_N_Arguments (2);
6548 Check_At_Most_N_Arguments (4);
6549 Process_Convention (C, Def_Id);
6550 Note_Possible_Modification (Expression (Arg2));
6551 Process_Interface_Name (Def_Id, Arg3, Arg4);
6552 Set_Exported (Def_Id, Arg2);
6555 --------------------------
6556 -- External_Name_Casing --
6557 --------------------------
6559 -- pragma External_Name_Casing (
6560 -- UPPERCASE | LOWERCASE
6561 -- [, AS_IS | UPPERCASE | LOWERCASE]);
6563 when Pragma_External_Name_Casing => External_Name_Casing : declare
6566 Check_No_Identifiers;
6568 if Arg_Count = 2 then
6570 (Arg2, Name_As_Is, Name_Uppercase, Name_Lowercase);
6572 case Chars (Get_Pragma_Arg (Arg2)) is
6574 Opt.External_Name_Exp_Casing := As_Is;
6576 when Name_Uppercase =>
6577 Opt.External_Name_Exp_Casing := Uppercase;
6579 when Name_Lowercase =>
6580 Opt.External_Name_Exp_Casing := Lowercase;
6587 Check_Arg_Count (1);
6590 Check_Arg_Is_One_Of (Arg1, Name_Uppercase, Name_Lowercase);
6592 case Chars (Get_Pragma_Arg (Arg1)) is
6593 when Name_Uppercase =>
6594 Opt.External_Name_Imp_Casing := Uppercase;
6596 when Name_Lowercase =>
6597 Opt.External_Name_Imp_Casing := Lowercase;
6602 end External_Name_Casing;
6604 ---------------------------
6605 -- Finalize_Storage_Only --
6606 ---------------------------
6608 -- pragma Finalize_Storage_Only (first_subtype_LOCAL_NAME);
6610 when Pragma_Finalize_Storage_Only => Finalize_Storage : declare
6611 Assoc : constant Node_Id := Arg1;
6612 Type_Id : constant Node_Id := Expression (Assoc);
6616 Check_No_Identifiers;
6617 Check_Arg_Count (1);
6618 Check_Arg_Is_Local_Name (Arg1);
6620 Find_Type (Type_Id);
6621 Typ := Entity (Type_Id);
6624 or else Rep_Item_Too_Early (Typ, N)
6628 Typ := Underlying_Type (Typ);
6631 if not Is_Controlled (Typ) then
6632 Error_Pragma ("pragma% must specify controlled type");
6635 Check_First_Subtype (Arg1);
6637 if Finalize_Storage_Only (Typ) then
6638 Error_Pragma ("duplicate pragma%, only one allowed");
6640 elsif not Rep_Item_Too_Late (Typ, N) then
6641 Set_Finalize_Storage_Only (Base_Type (Typ), True);
6643 end Finalize_Storage;
6645 --------------------------
6646 -- Float_Representation --
6647 --------------------------
6649 -- pragma Float_Representation (FLOAT_REP[, float_type_LOCAL_NAME]);
6651 -- FLOAT_REP ::= VAX_Float | IEEE_Float
6653 when Pragma_Float_Representation => Float_Representation : declare
6661 if Arg_Count = 1 then
6662 Check_Valid_Configuration_Pragma;
6664 Check_Arg_Count (2);
6665 Check_Optional_Identifier (Arg2, Name_Entity);
6666 Check_Arg_Is_Local_Name (Arg2);
6669 Check_No_Identifier (Arg1);
6670 Check_Arg_Is_One_Of (Arg1, Name_VAX_Float, Name_IEEE_Float);
6672 if not OpenVMS_On_Target then
6673 if Chars (Expression (Arg1)) = Name_VAX_Float then
6675 ("?pragma% ignored (applies only to Open'V'M'S)");
6681 -- One argument case
6683 if Arg_Count = 1 then
6684 if Chars (Expression (Arg1)) = Name_VAX_Float then
6685 if Opt.Float_Format = 'I' then
6686 Error_Pragma ("'I'E'E'E format previously specified");
6689 Opt.Float_Format := 'V';
6692 if Opt.Float_Format = 'V' then
6693 Error_Pragma ("'V'A'X format previously specified");
6696 Opt.Float_Format := 'I';
6699 Set_Standard_Fpt_Formats;
6701 -- Two argument case
6704 Argx := Get_Pragma_Arg (Arg2);
6706 if not Is_Entity_Name (Argx)
6707 or else not Is_Floating_Point_Type (Entity (Argx))
6710 ("second argument of% pragma must be floating-point type",
6714 Ent := Entity (Argx);
6715 Digs := UI_To_Int (Digits_Value (Ent));
6717 -- Two arguments, VAX_Float case
6719 if Chars (Expression (Arg1)) = Name_VAX_Float then
6721 when 6 => Set_F_Float (Ent);
6722 when 9 => Set_D_Float (Ent);
6723 when 15 => Set_G_Float (Ent);
6727 ("wrong digits value, must be 6,9 or 15", Arg2);
6730 -- Two arguments, IEEE_Float case
6734 when 6 => Set_IEEE_Short (Ent);
6735 when 15 => Set_IEEE_Long (Ent);
6739 ("wrong digits value, must be 6 or 15", Arg2);
6743 end Float_Representation;
6749 -- pragma Ident (static_string_EXPRESSION)
6751 -- Note: pragma Comment shares this processing. Pragma Comment
6752 -- is identical to Ident, except that the restriction of the
6753 -- argument to 31 characters and the placement restrictions
6754 -- are not enforced for pragma Comment.
6756 when Pragma_Ident | Pragma_Comment => Ident : declare
6761 Check_Arg_Count (1);
6762 Check_No_Identifiers;
6763 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
6765 -- For pragma Ident, preserve DEC compatibility by requiring
6766 -- the pragma to appear in a declarative part or package spec.
6768 if Prag_Id = Pragma_Ident then
6769 Check_Is_In_Decl_Part_Or_Package_Spec;
6772 Str := Expr_Value_S (Expression (Arg1));
6779 GP := Parent (Parent (N));
6781 if Nkind (GP) = N_Package_Declaration
6783 Nkind (GP) = N_Generic_Package_Declaration
6788 -- If we have a compilation unit, then record the ident
6789 -- value, checking for improper duplication.
6791 if Nkind (GP) = N_Compilation_Unit then
6792 CS := Ident_String (Current_Sem_Unit);
6794 if Present (CS) then
6796 -- For Ident, we do not permit multiple instances
6798 if Prag_Id = Pragma_Ident then
6799 Error_Pragma ("duplicate% pragma not permitted");
6801 -- For Comment, we concatenate the string, unless we
6802 -- want to preserve the tree structure for ASIS.
6804 elsif not ASIS_Mode then
6805 Start_String (Strval (CS));
6806 Store_String_Char (' ');
6807 Store_String_Chars (Strval (Str));
6808 Set_Strval (CS, End_String);
6812 -- In VMS, the effect of IDENT is achieved by passing
6813 -- IDENTIFICATION=name as a --for-linker switch.
6815 if OpenVMS_On_Target then
6818 ("--for-linker=IDENTIFICATION=");
6819 String_To_Name_Buffer (Strval (Str));
6820 Store_String_Chars (Name_Buffer (1 .. Name_Len));
6822 -- Only the last processed IDENT is saved. The main
6823 -- purpose is so an IDENT associated with a main
6824 -- procedure will be used in preference to an IDENT
6825 -- associated with a with'd package.
6827 Replace_Linker_Option_String
6828 (End_String, "--for-linker=IDENTIFICATION=");
6831 Set_Ident_String (Current_Sem_Unit, Str);
6834 -- For subunits, we just ignore the Ident, since in GNAT
6835 -- these are not separate object files, and hence not
6836 -- separate units in the unit table.
6838 elsif Nkind (GP) = N_Subunit then
6841 -- Otherwise we have a misplaced pragma Ident, but we ignore
6842 -- this if we are in an instantiation, since it comes from
6843 -- a generic, and has no relevance to the instantiation.
6845 elsif Prag_Id = Pragma_Ident then
6846 if Instantiation_Location (Loc) = No_Location then
6847 Error_Pragma ("pragma% only allowed at outer level");
6853 -----------------------
6854 -- Implicit_Packing --
6855 -----------------------
6857 -- pragma Implicit_Packing;
6859 when Pragma_Implicit_Packing =>
6861 Check_Arg_Count (0);
6862 Implicit_Packing := True;
6869 -- [ Convention =>] convention_IDENTIFIER,
6870 -- [ Entity =>] local_NAME
6871 -- [, [External_Name =>] static_string_EXPRESSION ]
6872 -- [, [Link_Name =>] static_string_EXPRESSION ]);
6874 when Pragma_Import =>
6875 Check_Ada_83_Warning;
6881 Check_At_Least_N_Arguments (2);
6882 Check_At_Most_N_Arguments (4);
6883 Process_Import_Or_Interface;
6885 ----------------------
6886 -- Import_Exception --
6887 ----------------------
6889 -- pragma Import_Exception (
6890 -- [Internal =>] LOCAL_NAME,
6891 -- [, [External =>] EXTERNAL_SYMBOL,]
6892 -- [, [Form =>] Ada | VMS]
6893 -- [, [Code =>] static_integer_EXPRESSION]);
6895 when Pragma_Import_Exception => Import_Exception : declare
6896 Args : Args_List (1 .. 4);
6897 Names : constant Name_List (1 .. 4) := (
6903 Internal : Node_Id renames Args (1);
6904 External : Node_Id renames Args (2);
6905 Form : Node_Id renames Args (3);
6906 Code : Node_Id renames Args (4);
6909 Gather_Associations (Names, Args);
6911 if Present (External) and then Present (Code) then
6913 ("cannot give both External and Code options for pragma%");
6916 Process_Extended_Import_Export_Exception_Pragma (
6917 Arg_Internal => Internal,
6918 Arg_External => External,
6922 if not Is_VMS_Exception (Entity (Internal)) then
6923 Set_Imported (Entity (Internal));
6925 end Import_Exception;
6927 ---------------------
6928 -- Import_Function --
6929 ---------------------
6931 -- pragma Import_Function (
6932 -- [Internal =>] LOCAL_NAME,
6933 -- [, [External =>] EXTERNAL_SYMBOL]
6934 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6935 -- [, [Result_Type =>] SUBTYPE_MARK]
6936 -- [, [Mechanism =>] MECHANISM]
6937 -- [, [Result_Mechanism =>] MECHANISM_NAME]
6938 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
6940 -- EXTERNAL_SYMBOL ::=
6942 -- | static_string_EXPRESSION
6944 -- PARAMETER_TYPES ::=
6946 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6948 -- TYPE_DESIGNATOR ::=
6950 -- | subtype_Name ' Access
6954 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6956 -- MECHANISM_ASSOCIATION ::=
6957 -- [formal_parameter_NAME =>] MECHANISM_NAME
6959 -- MECHANISM_NAME ::=
6962 -- | Descriptor [([Class =>] CLASS_NAME)]
6964 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6966 when Pragma_Import_Function => Import_Function : declare
6967 Args : Args_List (1 .. 7);
6968 Names : constant Name_List (1 .. 7) := (
6971 Name_Parameter_Types,
6974 Name_Result_Mechanism,
6975 Name_First_Optional_Parameter);
6977 Internal : Node_Id renames Args (1);
6978 External : Node_Id renames Args (2);
6979 Parameter_Types : Node_Id renames Args (3);
6980 Result_Type : Node_Id renames Args (4);
6981 Mechanism : Node_Id renames Args (5);
6982 Result_Mechanism : Node_Id renames Args (6);
6983 First_Optional_Parameter : Node_Id renames Args (7);
6987 Gather_Associations (Names, Args);
6988 Process_Extended_Import_Export_Subprogram_Pragma (
6989 Arg_Internal => Internal,
6990 Arg_External => External,
6991 Arg_Parameter_Types => Parameter_Types,
6992 Arg_Result_Type => Result_Type,
6993 Arg_Mechanism => Mechanism,
6994 Arg_Result_Mechanism => Result_Mechanism,
6995 Arg_First_Optional_Parameter => First_Optional_Parameter);
6996 end Import_Function;
7002 -- pragma Import_Object (
7003 -- [Internal =>] LOCAL_NAME,
7004 -- [, [External =>] EXTERNAL_SYMBOL]
7005 -- [, [Size =>] EXTERNAL_SYMBOL]);
7007 -- EXTERNAL_SYMBOL ::=
7009 -- | static_string_EXPRESSION
7011 when Pragma_Import_Object => Import_Object : declare
7012 Args : Args_List (1 .. 3);
7013 Names : constant Name_List (1 .. 3) := (
7018 Internal : Node_Id renames Args (1);
7019 External : Node_Id renames Args (2);
7020 Size : Node_Id renames Args (3);
7024 Gather_Associations (Names, Args);
7025 Process_Extended_Import_Export_Object_Pragma (
7026 Arg_Internal => Internal,
7027 Arg_External => External,
7031 ----------------------
7032 -- Import_Procedure --
7033 ----------------------
7035 -- pragma Import_Procedure (
7036 -- [Internal =>] LOCAL_NAME,
7037 -- [, [External =>] EXTERNAL_SYMBOL]
7038 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
7039 -- [, [Mechanism =>] MECHANISM]
7040 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
7042 -- EXTERNAL_SYMBOL ::=
7044 -- | static_string_EXPRESSION
7046 -- PARAMETER_TYPES ::=
7048 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7050 -- TYPE_DESIGNATOR ::=
7052 -- | subtype_Name ' Access
7056 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7058 -- MECHANISM_ASSOCIATION ::=
7059 -- [formal_parameter_NAME =>] MECHANISM_NAME
7061 -- MECHANISM_NAME ::=
7064 -- | Descriptor [([Class =>] CLASS_NAME)]
7066 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7068 when Pragma_Import_Procedure => Import_Procedure : declare
7069 Args : Args_List (1 .. 5);
7070 Names : constant Name_List (1 .. 5) := (
7073 Name_Parameter_Types,
7075 Name_First_Optional_Parameter);
7077 Internal : Node_Id renames Args (1);
7078 External : Node_Id renames Args (2);
7079 Parameter_Types : Node_Id renames Args (3);
7080 Mechanism : Node_Id renames Args (4);
7081 First_Optional_Parameter : Node_Id renames Args (5);
7085 Gather_Associations (Names, Args);
7086 Process_Extended_Import_Export_Subprogram_Pragma (
7087 Arg_Internal => Internal,
7088 Arg_External => External,
7089 Arg_Parameter_Types => Parameter_Types,
7090 Arg_Mechanism => Mechanism,
7091 Arg_First_Optional_Parameter => First_Optional_Parameter);
7092 end Import_Procedure;
7094 -----------------------------
7095 -- Import_Valued_Procedure --
7096 -----------------------------
7098 -- pragma Import_Valued_Procedure (
7099 -- [Internal =>] LOCAL_NAME,
7100 -- [, [External =>] EXTERNAL_SYMBOL]
7101 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
7102 -- [, [Mechanism =>] MECHANISM]
7103 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
7105 -- EXTERNAL_SYMBOL ::=
7107 -- | static_string_EXPRESSION
7109 -- PARAMETER_TYPES ::=
7111 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7113 -- TYPE_DESIGNATOR ::=
7115 -- | subtype_Name ' Access
7119 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7121 -- MECHANISM_ASSOCIATION ::=
7122 -- [formal_parameter_NAME =>] MECHANISM_NAME
7124 -- MECHANISM_NAME ::=
7127 -- | Descriptor [([Class =>] CLASS_NAME)]
7129 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7131 when Pragma_Import_Valued_Procedure =>
7132 Import_Valued_Procedure : declare
7133 Args : Args_List (1 .. 5);
7134 Names : constant Name_List (1 .. 5) := (
7137 Name_Parameter_Types,
7139 Name_First_Optional_Parameter);
7141 Internal : Node_Id renames Args (1);
7142 External : Node_Id renames Args (2);
7143 Parameter_Types : Node_Id renames Args (3);
7144 Mechanism : Node_Id renames Args (4);
7145 First_Optional_Parameter : Node_Id renames Args (5);
7149 Gather_Associations (Names, Args);
7150 Process_Extended_Import_Export_Subprogram_Pragma (
7151 Arg_Internal => Internal,
7152 Arg_External => External,
7153 Arg_Parameter_Types => Parameter_Types,
7154 Arg_Mechanism => Mechanism,
7155 Arg_First_Optional_Parameter => First_Optional_Parameter);
7156 end Import_Valued_Procedure;
7158 ------------------------
7159 -- Initialize_Scalars --
7160 ------------------------
7162 -- pragma Initialize_Scalars;
7164 when Pragma_Initialize_Scalars =>
7166 Check_Arg_Count (0);
7167 Check_Valid_Configuration_Pragma;
7168 Check_Restriction (No_Initialize_Scalars, N);
7170 if not Restriction_Active (No_Initialize_Scalars) then
7171 Init_Or_Norm_Scalars := True;
7172 Initialize_Scalars := True;
7179 -- pragma Inline ( NAME {, NAME} );
7181 when Pragma_Inline =>
7183 -- Pragma is active if inlining option is active
7185 Process_Inline (Inline_Active);
7191 -- pragma Inline_Always ( NAME {, NAME} );
7193 when Pragma_Inline_Always =>
7194 Process_Inline (True);
7196 --------------------
7197 -- Inline_Generic --
7198 --------------------
7200 -- pragma Inline_Generic (NAME {, NAME});
7202 when Pragma_Inline_Generic =>
7203 Process_Generic_List;
7205 ----------------------
7206 -- Inspection_Point --
7207 ----------------------
7209 -- pragma Inspection_Point [(object_NAME {, object_NAME})];
7211 when Pragma_Inspection_Point => Inspection_Point : declare
7216 if Arg_Count > 0 then
7219 Exp := Expression (Arg);
7222 if not Is_Entity_Name (Exp)
7223 or else not Is_Object (Entity (Exp))
7225 Error_Pragma_Arg ("object name required", Arg);
7232 end Inspection_Point;
7238 -- pragma Interface (
7239 -- [ Convention =>] convention_IDENTIFIER,
7240 -- [ Entity =>] local_NAME
7241 -- [, [External_Name =>] static_string_EXPRESSION ]
7242 -- [, [Link_Name =>] static_string_EXPRESSION ]);
7244 when Pragma_Interface =>
7251 Check_At_Least_N_Arguments (2);
7252 Check_At_Most_N_Arguments (4);
7253 Process_Import_Or_Interface;
7255 --------------------
7256 -- Interface_Name --
7257 --------------------
7259 -- pragma Interface_Name (
7260 -- [ Entity =>] local_NAME
7261 -- [,[External_Name =>] static_string_EXPRESSION ]
7262 -- [,[Link_Name =>] static_string_EXPRESSION ]);
7264 when Pragma_Interface_Name => Interface_Name : declare
7273 ((Name_Entity, Name_External_Name, Name_Link_Name));
7274 Check_At_Least_N_Arguments (2);
7275 Check_At_Most_N_Arguments (3);
7276 Id := Expression (Arg1);
7279 if not Is_Entity_Name (Id) then
7281 ("first argument for pragma% must be entity name", Arg1);
7282 elsif Etype (Id) = Any_Type then
7285 Def_Id := Entity (Id);
7288 -- Special DEC-compatible processing for the object case,
7289 -- forces object to be imported.
7291 if Ekind (Def_Id) = E_Variable then
7292 Kill_Size_Check_Code (Def_Id);
7293 Note_Possible_Modification (Id);
7295 -- Initialization is not allowed for imported variable
7297 if Present (Expression (Parent (Def_Id)))
7298 and then Comes_From_Source (Expression (Parent (Def_Id)))
7300 Error_Msg_Sloc := Sloc (Def_Id);
7302 ("no initialization allowed for declaration of& #",
7306 -- For compatibility, support VADS usage of providing both
7307 -- pragmas Interface and Interface_Name to obtain the effect
7308 -- of a single Import pragma.
7310 if Is_Imported (Def_Id)
7311 and then Present (First_Rep_Item (Def_Id))
7312 and then Nkind (First_Rep_Item (Def_Id)) = N_Pragma
7313 and then Chars (First_Rep_Item (Def_Id)) = Name_Interface
7317 Set_Imported (Def_Id);
7320 Set_Is_Public (Def_Id);
7321 Process_Interface_Name (Def_Id, Arg2, Arg3);
7324 -- Otherwise must be subprogram
7326 elsif not Is_Subprogram (Def_Id) then
7328 ("argument of pragma% is not subprogram", Arg1);
7331 Check_At_Most_N_Arguments (3);
7335 -- Loop through homonyms
7338 Def_Id := Get_Base_Subprogram (Hom_Id);
7340 if Is_Imported (Def_Id) then
7341 Process_Interface_Name (Def_Id, Arg2, Arg3);
7345 Hom_Id := Homonym (Hom_Id);
7347 exit when No (Hom_Id)
7348 or else Scope (Hom_Id) /= Current_Scope;
7353 ("argument of pragma% is not imported subprogram",
7359 -----------------------
7360 -- Interrupt_Handler --
7361 -----------------------
7363 -- pragma Interrupt_Handler (handler_NAME);
7365 when Pragma_Interrupt_Handler =>
7366 Check_Ada_83_Warning;
7367 Check_Arg_Count (1);
7368 Check_No_Identifiers;
7370 if No_Run_Time_Mode then
7371 Error_Msg_CRT ("Interrupt_Handler pragma", N);
7373 Check_Interrupt_Or_Attach_Handler;
7374 Process_Interrupt_Or_Attach_Handler;
7377 ------------------------
7378 -- Interrupt_Priority --
7379 ------------------------
7381 -- pragma Interrupt_Priority [(EXPRESSION)];
7383 when Pragma_Interrupt_Priority => Interrupt_Priority : declare
7384 P : constant Node_Id := Parent (N);
7388 Check_Ada_83_Warning;
7390 if Arg_Count /= 0 then
7391 Arg := Expression (Arg1);
7392 Check_Arg_Count (1);
7393 Check_No_Identifiers;
7395 -- The expression must be analyzed in the special manner
7396 -- described in "Handling of Default and Per-Object
7397 -- Expressions" in sem.ads.
7399 Analyze_Per_Use_Expression (Arg, RTE (RE_Interrupt_Priority));
7402 if Nkind (P) /= N_Task_Definition
7403 and then Nkind (P) /= N_Protected_Definition
7408 elsif Has_Priority_Pragma (P) then
7409 Error_Pragma ("duplicate pragma% not allowed");
7412 Set_Has_Priority_Pragma (P, True);
7413 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
7415 end Interrupt_Priority;
7417 ---------------------
7418 -- Interrupt_State --
7419 ---------------------
7421 -- pragma Interrupt_State (
7422 -- [Name =>] INTERRUPT_ID,
7423 -- [State =>] INTERRUPT_STATE);
7425 -- INTERRUPT_ID => IDENTIFIER | static_integer_EXPRESSION
7426 -- INTERRUPT_STATE => System | Runtime | User
7428 -- Note: if the interrupt id is given as an identifier, then
7429 -- it must be one of the identifiers in Ada.Interrupts.Names.
7430 -- Otherwise it is given as a static integer expression which
7431 -- must be in the range of Ada.Interrupts.Interrupt_ID.
7433 when Pragma_Interrupt_State => Interrupt_State : declare
7435 Int_Id : constant Entity_Id := RTE (RE_Interrupt_ID);
7436 -- This is the entity Ada.Interrupts.Interrupt_ID;
7438 State_Type : Character;
7439 -- Set to 's'/'r'/'u' for System/Runtime/User
7442 -- Index to entry in Interrupt_States table
7445 -- Value of interrupt
7447 Arg1X : constant Node_Id := Get_Pragma_Arg (Arg1);
7448 -- The first argument to the pragma
7450 Int_Ent : Entity_Id;
7451 -- Interrupt entity in Ada.Interrupts.Names
7455 Check_Arg_Order ((Name_Name, Name_State));
7456 Check_Arg_Count (2);
7458 Check_Optional_Identifier (Arg1, Name_Name);
7459 Check_Optional_Identifier (Arg2, Name_State);
7460 Check_Arg_Is_Identifier (Arg2);
7462 -- First argument is identifier
7464 if Nkind (Arg1X) = N_Identifier then
7466 -- Search list of names in Ada.Interrupts.Names
7468 Int_Ent := First_Entity (RTE (RE_Names));
7470 if No (Int_Ent) then
7471 Error_Pragma_Arg ("invalid interrupt name", Arg1);
7473 elsif Chars (Int_Ent) = Chars (Arg1X) then
7474 Int_Val := Expr_Value (Constant_Value (Int_Ent));
7478 Next_Entity (Int_Ent);
7481 -- First argument is not an identifier, so it must be a
7482 -- static expression of type Ada.Interrupts.Interrupt_ID.
7485 Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
7486 Int_Val := Expr_Value (Arg1X);
7488 if Int_Val < Expr_Value (Type_Low_Bound (Int_Id))
7490 Int_Val > Expr_Value (Type_High_Bound (Int_Id))
7493 ("value not in range of type " &
7494 """Ada.Interrupts.Interrupt_'I'D""", Arg1);
7500 case Chars (Get_Pragma_Arg (Arg2)) is
7501 when Name_Runtime => State_Type := 'r';
7502 when Name_System => State_Type := 's';
7503 when Name_User => State_Type := 'u';
7506 Error_Pragma_Arg ("invalid interrupt state", Arg2);
7509 -- Check if entry is already stored
7511 IST_Num := Interrupt_States.First;
7513 -- If entry not found, add it
7515 if IST_Num > Interrupt_States.Last then
7516 Interrupt_States.Append
7517 ((Interrupt_Number => UI_To_Int (Int_Val),
7518 Interrupt_State => State_Type,
7519 Pragma_Loc => Loc));
7522 -- Case of entry for the same entry
7524 elsif Int_Val = Interrupt_States.Table (IST_Num).
7527 -- If state matches, done, no need to make redundant entry
7530 State_Type = Interrupt_States.Table (IST_Num).
7533 -- Otherwise if state does not match, error
7536 Interrupt_States.Table (IST_Num).Pragma_Loc;
7538 ("state conflicts with that given #", Arg2);
7542 IST_Num := IST_Num + 1;
7544 end Interrupt_State;
7546 ----------------------
7547 -- Java_Constructor --
7548 ----------------------
7550 -- pragma Java_Constructor ([Entity =>] LOCAL_NAME);
7552 -- Also handles pragma CIL_Constructor
7554 when Pragma_CIL_Constructor | Pragma_Java_Constructor =>
7555 Java_Constructor : declare
7559 Convention : Convention_Id;
7563 Check_Arg_Count (1);
7564 Check_Optional_Identifier (Arg1, Name_Entity);
7565 Check_Arg_Is_Local_Name (Arg1);
7567 Id := Expression (Arg1);
7568 Find_Program_Unit_Name (Id);
7570 -- If we did not find the name, we are done
7572 if Etype (Id) = Any_Type then
7577 when Pragma_CIL_Constructor => Convention := Convention_CIL;
7578 when Pragma_Java_Constructor => Convention := Convention_Java;
7579 when others => null;
7582 Hom_Id := Entity (Id);
7584 -- Loop through homonyms
7587 Def_Id := Get_Base_Subprogram (Hom_Id);
7589 -- The constructor is required to be a function returning an
7590 -- access type whose designated type has convention Java/CIL.
7592 if Ekind (Def_Id) = E_Function
7594 (Is_Value_Type (Etype (Def_Id))
7596 (Ekind (Etype (Def_Id)) in Access_Kind
7599 (Designated_Type (Etype (Def_Id))) = Convention
7602 (Root_Type (Designated_Type (Etype (Def_Id)))) =
7605 Set_Is_Constructor (Def_Id);
7606 Set_Convention (Def_Id, Convention);
7607 Set_Is_Imported (Def_Id);
7610 if Convention = Convention_Java then
7612 ("pragma% requires function returning a " &
7613 "'Java access type", Arg1);
7615 pragma Assert (Convention = Convention_CIL);
7617 ("pragma% requires function returning a " &
7618 "'CIL access type", Arg1);
7622 Hom_Id := Homonym (Hom_Id);
7624 exit when No (Hom_Id) or else Scope (Hom_Id) /= Current_Scope;
7626 end Java_Constructor;
7628 ----------------------
7629 -- Java_Interface --
7630 ----------------------
7632 -- pragma Java_Interface ([Entity =>] LOCAL_NAME);
7634 when Pragma_Java_Interface => Java_Interface : declare
7640 Check_Arg_Count (1);
7641 Check_Optional_Identifier (Arg1, Name_Entity);
7642 Check_Arg_Is_Local_Name (Arg1);
7644 Arg := Expression (Arg1);
7647 if Etype (Arg) = Any_Type then
7651 if not Is_Entity_Name (Arg)
7652 or else not Is_Type (Entity (Arg))
7654 Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
7657 Typ := Underlying_Type (Entity (Arg));
7659 -- For now we simply check some of the semantic constraints
7660 -- on the type. This currently leaves out some restrictions
7661 -- on interface types, namely that the parent type must be
7662 -- java.lang.Object.Typ and that all primitives of the type
7663 -- should be declared abstract. ???
7665 if not Is_Tagged_Type (Typ) or else not Is_Abstract_Type (Typ) then
7666 Error_Pragma_Arg ("pragma% requires an abstract "
7667 & "tagged type", Arg1);
7669 elsif not Has_Discriminants (Typ)
7670 or else Ekind (Etype (First_Discriminant (Typ)))
7671 /= E_Anonymous_Access_Type
7673 not Is_Class_Wide_Type
7674 (Designated_Type (Etype (First_Discriminant (Typ))))
7677 ("type must have a class-wide access discriminant", Arg1);
7685 -- pragma Keep_Names ([On => ] local_NAME);
7687 when Pragma_Keep_Names => Keep_Names : declare
7692 Check_Arg_Count (1);
7693 Check_Optional_Identifier (Arg1, Name_On);
7694 Check_Arg_Is_Local_Name (Arg1);
7696 Arg := Expression (Arg1);
7699 if Etype (Arg) = Any_Type then
7703 if not Is_Entity_Name (Arg)
7704 or else Ekind (Entity (Arg)) /= E_Enumeration_Type
7707 ("pragma% requires a local enumeration type", Arg1);
7710 Set_Discard_Names (Entity (Arg), False);
7717 -- pragma License (RESTRICTED | UNRESTRICTED | GPL | MODIFIED_GPL);
7719 when Pragma_License =>
7721 Check_Arg_Count (1);
7722 Check_No_Identifiers;
7723 Check_Valid_Configuration_Pragma;
7724 Check_Arg_Is_Identifier (Arg1);
7727 Sind : constant Source_File_Index :=
7728 Source_Index (Current_Sem_Unit);
7731 case Chars (Get_Pragma_Arg (Arg1)) is
7733 Set_License (Sind, GPL);
7735 when Name_Modified_GPL =>
7736 Set_License (Sind, Modified_GPL);
7738 when Name_Restricted =>
7739 Set_License (Sind, Restricted);
7741 when Name_Unrestricted =>
7742 Set_License (Sind, Unrestricted);
7745 Error_Pragma_Arg ("invalid license name", Arg1);
7753 -- pragma Link_With (string_EXPRESSION {, string_EXPRESSION});
7755 when Pragma_Link_With => Link_With : declare
7761 if Operating_Mode = Generate_Code
7762 and then In_Extended_Main_Source_Unit (N)
7764 Check_At_Least_N_Arguments (1);
7765 Check_No_Identifiers;
7766 Check_Is_In_Decl_Part_Or_Package_Spec;
7767 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
7771 while Present (Arg) loop
7772 Check_Arg_Is_Static_Expression (Arg, Standard_String);
7774 -- Store argument, converting sequences of spaces
7775 -- to a single null character (this is one of the
7776 -- differences in processing between Link_With
7777 -- and Linker_Options).
7780 C : constant Char_Code := Get_Char_Code (' ');
7781 S : constant String_Id :=
7782 Strval (Expr_Value_S (Expression (Arg)));
7783 L : constant Nat := String_Length (S);
7786 procedure Skip_Spaces;
7787 -- Advance F past any spaces
7793 procedure Skip_Spaces is
7795 while F <= L and then Get_String_Char (S, F) = C loop
7800 -- Start of processing for Arg_Store
7803 Skip_Spaces; -- skip leading spaces
7805 -- Loop through characters, changing any embedded
7806 -- sequence of spaces to a single null character
7807 -- (this is how Link_With/Linker_Options differ)
7810 if Get_String_Char (S, F) = C then
7813 Store_String_Char (ASCII.NUL);
7816 Store_String_Char (Get_String_Char (S, F));
7824 if Present (Arg) then
7825 Store_String_Char (ASCII.NUL);
7829 Store_Linker_Option_String (End_String);
7837 -- pragma Linker_Alias (
7838 -- [Entity =>] LOCAL_NAME
7839 -- [Target =>] static_string_EXPRESSION);
7841 when Pragma_Linker_Alias =>
7843 Check_Arg_Order ((Name_Entity, Name_Target));
7844 Check_Arg_Count (2);
7845 Check_Optional_Identifier (Arg1, Name_Entity);
7846 Check_Optional_Identifier (Arg2, Name_Target);
7847 Check_Arg_Is_Library_Level_Local_Name (Arg1);
7848 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
7850 -- The only processing required is to link this item on to the
7851 -- list of rep items for the given entity. This is accomplished
7852 -- by the call to Rep_Item_Too_Late (when no error is detected
7853 -- and False is returned).
7855 if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
7858 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
7861 ------------------------
7862 -- Linker_Constructor --
7863 ------------------------
7865 -- pragma Linker_Constructor (procedure_LOCAL_NAME);
7867 -- Code is shared with Linker_Destructor
7869 -----------------------
7870 -- Linker_Destructor --
7871 -----------------------
7873 -- pragma Linker_Destructor (procedure_LOCAL_NAME);
7875 when Pragma_Linker_Constructor |
7876 Pragma_Linker_Destructor =>
7877 Linker_Constructor : declare
7883 Check_Arg_Count (1);
7884 Check_No_Identifiers;
7885 Check_Arg_Is_Local_Name (Arg1);
7886 Arg1_X := Expression (Arg1);
7888 Proc := Find_Unique_Parameterless_Procedure (Arg1_X, Arg1);
7890 if not Is_Library_Level_Entity (Proc) then
7892 ("argument for pragma% must be library level entity", Arg1);
7895 -- The only processing required is to link this item on to the
7896 -- list of rep items for the given entity. This is accomplished
7897 -- by the call to Rep_Item_Too_Late (when no error is detected
7898 -- and False is returned).
7900 if Rep_Item_Too_Late (Proc, N) then
7903 Set_Has_Gigi_Rep_Item (Proc);
7905 end Linker_Constructor;
7907 --------------------
7908 -- Linker_Options --
7909 --------------------
7911 -- pragma Linker_Options (string_EXPRESSION {, string_EXPRESSION});
7913 when Pragma_Linker_Options => Linker_Options : declare
7917 Check_Ada_83_Warning;
7918 Check_No_Identifiers;
7919 Check_Arg_Count (1);
7920 Check_Is_In_Decl_Part_Or_Package_Spec;
7922 if Operating_Mode = Generate_Code
7923 and then In_Extended_Main_Source_Unit (N)
7925 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
7926 Start_String (Strval (Expr_Value_S (Expression (Arg1))));
7929 while Present (Arg) loop
7930 Check_Arg_Is_Static_Expression (Arg, Standard_String);
7931 Store_String_Char (ASCII.NUL);
7933 (Strval (Expr_Value_S (Expression (Arg))));
7937 Store_Linker_Option_String (End_String);
7941 --------------------
7942 -- Linker_Section --
7943 --------------------
7945 -- pragma Linker_Section (
7946 -- [Entity =>] LOCAL_NAME
7947 -- [Section =>] static_string_EXPRESSION);
7949 when Pragma_Linker_Section =>
7951 Check_Arg_Order ((Name_Entity, Name_Section));
7952 Check_Arg_Count (2);
7953 Check_Optional_Identifier (Arg1, Name_Entity);
7954 Check_Optional_Identifier (Arg2, Name_Section);
7955 Check_Arg_Is_Library_Level_Local_Name (Arg1);
7956 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
7958 -- The only processing required is to link this item on to the
7959 -- list of rep items for the given entity. This is accomplished
7960 -- by the call to Rep_Item_Too_Late (when no error is detected
7961 -- and False is returned).
7963 if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
7966 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
7973 -- pragma List (On | Off)
7975 -- There is nothing to do here, since we did all the processing
7976 -- for this pragma in Par.Prag (so that it works properly even in
7977 -- syntax only mode)
7982 --------------------
7983 -- Locking_Policy --
7984 --------------------
7986 -- pragma Locking_Policy (policy_IDENTIFIER);
7988 when Pragma_Locking_Policy => declare
7992 Check_Ada_83_Warning;
7993 Check_Arg_Count (1);
7994 Check_No_Identifiers;
7995 Check_Arg_Is_Locking_Policy (Arg1);
7996 Check_Valid_Configuration_Pragma;
7997 Get_Name_String (Chars (Expression (Arg1)));
7998 LP := Fold_Upper (Name_Buffer (1));
8000 if Locking_Policy /= ' '
8001 and then Locking_Policy /= LP
8003 Error_Msg_Sloc := Locking_Policy_Sloc;
8004 Error_Pragma ("locking policy incompatible with policy#");
8006 -- Set new policy, but always preserve System_Location since
8007 -- we like the error message with the run time name.
8010 Locking_Policy := LP;
8012 if Locking_Policy_Sloc /= System_Location then
8013 Locking_Policy_Sloc := Loc;
8022 -- pragma Long_Float (D_Float | G_Float);
8024 when Pragma_Long_Float =>
8026 Check_Valid_Configuration_Pragma;
8027 Check_Arg_Count (1);
8028 Check_No_Identifier (Arg1);
8029 Check_Arg_Is_One_Of (Arg1, Name_D_Float, Name_G_Float);
8031 if not OpenVMS_On_Target then
8032 Error_Pragma ("?pragma% ignored (applies only to Open'V'M'S)");
8037 if Chars (Expression (Arg1)) = Name_D_Float then
8038 if Opt.Float_Format_Long = 'G' then
8039 Error_Pragma ("G_Float previously specified");
8042 Opt.Float_Format_Long := 'D';
8044 -- G_Float case (this is the default, does not need overriding)
8047 if Opt.Float_Format_Long = 'D' then
8048 Error_Pragma ("D_Float previously specified");
8051 Opt.Float_Format_Long := 'G';
8054 Set_Standard_Fpt_Formats;
8056 -----------------------
8057 -- Machine_Attribute --
8058 -----------------------
8060 -- pragma Machine_Attribute (
8061 -- [Entity =>] LOCAL_NAME,
8062 -- [Attribute_Name =>] static_string_EXPRESSION
8063 -- [,[Info =>] static_string_EXPRESSION] );
8065 when Pragma_Machine_Attribute => Machine_Attribute : declare
8070 Check_Arg_Order ((Name_Entity, Name_Attribute_Name, Name_Info));
8072 if Arg_Count = 3 then
8073 Check_Optional_Identifier (Arg3, Name_Info);
8074 Check_Arg_Is_Static_Expression (Arg3, Standard_String);
8076 Check_Arg_Count (2);
8079 Check_Optional_Identifier (Arg1, Name_Entity);
8080 Check_Optional_Identifier (Arg2, Name_Attribute_Name);
8081 Check_Arg_Is_Local_Name (Arg1);
8082 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
8083 Def_Id := Entity (Expression (Arg1));
8085 if Is_Access_Type (Def_Id) then
8086 Def_Id := Designated_Type (Def_Id);
8089 if Rep_Item_Too_Early (Def_Id, N) then
8093 Def_Id := Underlying_Type (Def_Id);
8095 -- The only processing required is to link this item on to the
8096 -- list of rep items for the given entity. This is accomplished
8097 -- by the call to Rep_Item_Too_Late (when no error is detected
8098 -- and False is returned).
8100 if Rep_Item_Too_Late (Def_Id, N) then
8103 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
8105 end Machine_Attribute;
8112 -- (MAIN_OPTION [, MAIN_OPTION]);
8115 -- [STACK_SIZE =>] static_integer_EXPRESSION
8116 -- | [TASK_STACK_SIZE_DEFAULT =>] static_integer_EXPRESSION
8117 -- | [TIME_SLICING_ENABLED =>] static_boolean_EXPRESSION
8119 when Pragma_Main => Main : declare
8120 Args : Args_List (1 .. 3);
8121 Names : constant Name_List (1 .. 3) := (
8123 Name_Task_Stack_Size_Default,
8124 Name_Time_Slicing_Enabled);
8130 Gather_Associations (Names, Args);
8132 for J in 1 .. 2 loop
8133 if Present (Args (J)) then
8134 Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
8138 if Present (Args (3)) then
8139 Check_Arg_Is_Static_Expression (Args (3), Standard_Boolean);
8143 while Present (Nod) loop
8144 if Nkind (Nod) = N_Pragma
8145 and then Chars (Nod) = Name_Main
8147 Error_Msg_Name_1 := Chars (N);
8148 Error_Msg_N ("duplicate pragma% not permitted", Nod);
8159 -- pragma Main_Storage
8160 -- (MAIN_STORAGE_OPTION [, MAIN_STORAGE_OPTION]);
8162 -- MAIN_STORAGE_OPTION ::=
8163 -- [WORKING_STORAGE =>] static_SIMPLE_EXPRESSION
8164 -- | [TOP_GUARD =>] static_SIMPLE_EXPRESSION
8166 when Pragma_Main_Storage => Main_Storage : declare
8167 Args : Args_List (1 .. 2);
8168 Names : constant Name_List (1 .. 2) := (
8169 Name_Working_Storage,
8176 Gather_Associations (Names, Args);
8178 for J in 1 .. 2 loop
8179 if Present (Args (J)) then
8180 Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
8184 Check_In_Main_Program;
8187 while Present (Nod) loop
8188 if Nkind (Nod) = N_Pragma
8189 and then Chars (Nod) = Name_Main_Storage
8191 Error_Msg_Name_1 := Chars (N);
8192 Error_Msg_N ("duplicate pragma% not permitted", Nod);
8203 -- pragma Memory_Size (NUMERIC_LITERAL)
8205 when Pragma_Memory_Size =>
8208 -- Memory size is simply ignored
8210 Check_No_Identifiers;
8211 Check_Arg_Count (1);
8212 Check_Arg_Is_Integer_Literal (Arg1);
8220 -- The only correct use of this pragma is on its own in a file, in
8221 -- which case it is specially processed (see Gnat1drv.Check_Bad_Body
8222 -- and Frontend, which use Sinput.L.Source_File_Is_Pragma_No_Body to
8223 -- check for a file containing nothing but a No_Body pragma). If we
8224 -- attempt to process it during normal semantics processing, it means
8225 -- it was misplaced.
8227 when Pragma_No_Body =>
8228 Error_Pragma ("misplaced pragma %");
8234 -- pragma No_Return (procedure_LOCAL_NAME {, procedure_Local_Name});
8236 when Pragma_No_Return => No_Return : declare
8244 Check_At_Least_N_Arguments (1);
8246 -- Loop through arguments of pragma
8249 while Present (Arg) loop
8250 Check_Arg_Is_Local_Name (Arg);
8251 Id := Expression (Arg);
8254 if not Is_Entity_Name (Id) then
8255 Error_Pragma_Arg ("entity name required", Arg);
8258 if Etype (Id) = Any_Type then
8262 -- Loop to find matching procedures
8267 and then Scope (E) = Current_Scope
8269 if Ekind (E) = E_Procedure
8270 or else Ekind (E) = E_Generic_Procedure
8280 Error_Pragma_Arg ("no procedure & found for pragma%", Arg);
8287 ------------------------
8288 -- No_Strict_Aliasing --
8289 ------------------------
8291 -- pragma No_Strict_Aliasing [([Entity =>] type_LOCAL_NAME)];
8293 when Pragma_No_Strict_Aliasing => No_Strict_Alias : declare
8298 Check_At_Most_N_Arguments (1);
8300 if Arg_Count = 0 then
8301 Check_Valid_Configuration_Pragma;
8302 Opt.No_Strict_Aliasing := True;
8305 Check_Optional_Identifier (Arg2, Name_Entity);
8306 Check_Arg_Is_Local_Name (Arg1);
8307 E_Id := Entity (Expression (Arg1));
8309 if E_Id = Any_Type then
8311 elsif No (E_Id) or else not Is_Access_Type (E_Id) then
8312 Error_Pragma_Arg ("pragma% requires access type", Arg1);
8315 Set_No_Strict_Aliasing (Implementation_Base_Type (E_Id));
8317 end No_Strict_Alias;
8323 -- pragma Obsolescent [(
8324 -- [Entity => NAME,]
8325 -- [(static_string_EXPRESSION [, Ada_05])];
8327 when Pragma_Obsolescent => Obsolescent : declare
8331 procedure Set_Obsolescent (E : Entity_Id);
8332 -- Given an entity Ent, mark it as obsolescent if appropriate
8334 ---------------------
8335 -- Set_Obsolescent --
8336 ---------------------
8338 procedure Set_Obsolescent (E : Entity_Id) is
8347 -- Entity name was given
8349 if Present (Ename) then
8351 -- If entity name matches, we are fine
8353 if Chars (Ename) = Chars (Ent) then
8356 -- If entity name does not match, only possibility is an
8357 -- enumeration literal from an enumeration type declaration.
8359 elsif Ekind (Ent) /= E_Enumeration_Type then
8361 ("pragma % entity name does not match declaration");
8364 Ent := First_Literal (E);
8368 ("pragma % entity name does not match any " &
8369 "enumeration literal");
8371 elsif Chars (Ent) = Chars (Ename) then
8375 Ent := Next_Literal (Ent);
8381 -- Ent points to entity to be marked
8383 if Arg_Count >= 1 then
8385 -- Deal with static string argument
8387 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
8388 S := Strval (Expression (Arg1));
8390 for J in 1 .. String_Length (S) loop
8391 if not In_Character_Range (Get_String_Char (S, J)) then
8393 ("pragma% argument does not allow wide characters",
8398 Set_Obsolescent_Warning (Ent, Expression (Arg1));
8400 -- Check for Ada_05 parameter
8402 if Arg_Count /= 1 then
8403 Check_Arg_Count (2);
8406 Argx : constant Node_Id := Get_Pragma_Arg (Arg2);
8409 Check_Arg_Is_Identifier (Argx);
8411 if Chars (Argx) /= Name_Ada_05 then
8412 Error_Msg_Name_2 := Name_Ada_05;
8414 ("only allowed argument for pragma% is %", Argx);
8417 if Ada_Version_Explicit < Ada_05
8418 or else not Warn_On_Ada_2005_Compatibility
8426 -- Set flag if pragma active
8429 Set_Is_Obsolescent (Ent);
8433 end Set_Obsolescent;
8435 -- Start of processing for pragma Obsolescent
8440 Check_At_Most_N_Arguments (3);
8442 -- See if first argument specifies an entity name
8445 and then Chars (Arg1) = Name_Entity
8447 Ename := Get_Pragma_Arg (Arg1);
8449 if Nkind (Ename) /= N_Character_Literal
8451 Nkind (Ename) /= N_Identifier
8453 Nkind (Ename) /= N_Operator_Symbol
8455 Error_Pragma_Arg ("entity name expected for pragma%", Arg1);
8458 -- Eliminate first argument, so we can share processing
8462 Arg_Count := Arg_Count - 1;
8464 -- No Entity name argument given
8470 Check_No_Identifiers;
8472 -- Get immediately preceding declaration
8475 while Present (Decl) and then Nkind (Decl) = N_Pragma loop
8479 -- Cases where we do not follow anything other than another pragma
8483 -- First case: library level compilation unit declaration with
8484 -- the pragma immediately following the declaration.
8486 if Nkind (Parent (N)) = N_Compilation_Unit_Aux then
8488 (Defining_Entity (Unit (Parent (Parent (N)))));
8491 -- Case 2: library unit placement for package
8495 Ent : constant Entity_Id := Find_Lib_Unit_Name;
8497 if Ekind (Ent) = E_Package
8498 or else Ekind (Ent) = E_Generic_Package
8500 Set_Obsolescent (Ent);
8506 -- Cases where we must follow a declaration
8509 if Nkind (Decl) not in N_Declaration
8510 and then Nkind (Decl) not in N_Later_Decl_Item
8511 and then Nkind (Decl) not in N_Generic_Declaration
8514 ("pragma% misplaced, " &
8515 "must immediately follow a declaration");
8518 Set_Obsolescent (Defining_Entity (Decl));
8528 -- pragma No_Run_Time
8530 -- Note: this pragma is retained for backwards compatibiltiy.
8531 -- See body of Rtsfind for full details on its handling.
8533 when Pragma_No_Run_Time =>
8535 Check_Valid_Configuration_Pragma;
8536 Check_Arg_Count (0);
8538 No_Run_Time_Mode := True;
8539 Configurable_Run_Time_Mode := True;
8542 Word32 : constant Boolean := Ttypes.System_Word_Size = 32;
8545 Duration_32_Bits_On_Target := True;
8549 Set_Restriction (No_Finalization, N);
8550 Set_Restriction (No_Exception_Handlers, N);
8551 Set_Restriction (Max_Tasks, N, 0);
8552 Set_Restriction (No_Tasking, N);
8554 -----------------------
8555 -- Normalize_Scalars --
8556 -----------------------
8558 -- pragma Normalize_Scalars;
8560 when Pragma_Normalize_Scalars =>
8561 Check_Ada_83_Warning;
8562 Check_Arg_Count (0);
8563 Check_Valid_Configuration_Pragma;
8564 Normalize_Scalars := True;
8565 Init_Or_Norm_Scalars := True;
8571 -- pragma Optimize (Time | Space);
8573 -- The actual check for optimize is done in Gigi. Note that this
8574 -- pragma does not actually change the optimization setting, it
8575 -- simply checks that it is consistent with the pragma.
8577 when Pragma_Optimize =>
8578 Check_No_Identifiers;
8579 Check_Arg_Count (1);
8580 Check_Arg_Is_One_Of (Arg1, Name_Time, Name_Space, Name_Off);
8586 -- pragma Pack (first_subtype_LOCAL_NAME);
8588 when Pragma_Pack => Pack : declare
8589 Assoc : constant Node_Id := Arg1;
8594 Check_No_Identifiers;
8595 Check_Arg_Count (1);
8596 Check_Arg_Is_Local_Name (Arg1);
8598 Type_Id := Expression (Assoc);
8599 Find_Type (Type_Id);
8600 Typ := Entity (Type_Id);
8603 or else Rep_Item_Too_Early (Typ, N)
8607 Typ := Underlying_Type (Typ);
8610 if not Is_Array_Type (Typ) and then not Is_Record_Type (Typ) then
8611 Error_Pragma ("pragma% must specify array or record type");
8614 Check_First_Subtype (Arg1);
8616 if Has_Pragma_Pack (Typ) then
8617 Error_Pragma ("duplicate pragma%, only one allowed");
8621 elsif Is_Array_Type (Typ) then
8623 -- Pack not allowed for aliased or atomic components
8625 if Has_Aliased_Components (Base_Type (Typ)) then
8627 ("pragma% ignored, cannot pack aliased components?");
8629 elsif Has_Atomic_Components (Typ)
8630 or else Is_Atomic (Component_Type (Typ))
8633 ("?pragma% ignored, cannot pack atomic components");
8636 -- If we had an explicit component size given, then we do not
8637 -- let Pack override this given size. We also give a warning
8638 -- that Pack is being ignored unless we can tell for sure that
8639 -- the Pack would not have had any effect anyway.
8641 if Has_Component_Size_Clause (Typ) then
8642 if Known_Static_RM_Size (Component_Type (Typ))
8644 RM_Size (Component_Type (Typ)) = Component_Size (Typ)
8649 ("?pragma% ignored, explicit component size given");
8652 -- If no prior array component size given, Pack is effective
8655 if not Rep_Item_Too_Late (Typ, N) then
8656 if VM_Target = No_VM then
8657 Set_Is_Packed (Base_Type (Typ));
8658 elsif not GNAT_Mode then
8660 ("?pragma% ignored in this configuration");
8663 Set_Has_Pragma_Pack (Base_Type (Typ));
8664 Set_Has_Non_Standard_Rep (Base_Type (Typ));
8668 -- For record types, the pack is always effective
8670 else pragma Assert (Is_Record_Type (Typ));
8671 if not Rep_Item_Too_Late (Typ, N) then
8672 if VM_Target = No_VM then
8673 Set_Is_Packed (Base_Type (Typ));
8674 elsif not GNAT_Mode then
8675 Error_Pragma ("?pragma% ignored in this configuration");
8678 Set_Has_Pragma_Pack (Base_Type (Typ));
8679 Set_Has_Non_Standard_Rep (Base_Type (Typ));
8690 -- There is nothing to do here, since we did all the processing
8691 -- for this pragma in Par.Prag (so that it works properly even in
8692 -- syntax only mode)
8701 -- pragma Passive [(PASSIVE_FORM)];
8703 -- PASSIVE_FORM ::= Semaphore | No
8705 when Pragma_Passive =>
8708 if Nkind (Parent (N)) /= N_Task_Definition then
8709 Error_Pragma ("pragma% must be within task definition");
8712 if Arg_Count /= 0 then
8713 Check_Arg_Count (1);
8714 Check_Arg_Is_One_Of (Arg1, Name_Semaphore, Name_No);
8717 ----------------------------------
8718 -- Preelaborable_Initialization --
8719 ----------------------------------
8721 -- pragma Preelaborable_Initialization (DIRECT_NAME);
8723 when Pragma_Preelaborable_Initialization => Preelab_Init : declare
8728 Check_Arg_Count (1);
8729 Check_No_Identifiers;
8730 Check_Arg_Is_Identifier (Arg1);
8731 Check_Arg_Is_Local_Name (Arg1);
8732 Check_First_Subtype (Arg1);
8733 Ent := Entity (Expression (Arg1));
8735 if not Is_Private_Type (Ent) then
8737 ("pragma % can only be applied to private type", Arg1);
8740 Set_Known_To_Have_Preelab_Init (Ent);
8742 if Has_Pragma_Preelab_Init (Ent)
8743 and then Warn_On_Redundant_Constructs
8745 Error_Pragma ("?duplicate pragma%!");
8747 Set_Has_Pragma_Preelab_Init (Ent);
8755 -- pragma Polling (ON | OFF);
8757 when Pragma_Polling =>
8759 Check_Arg_Count (1);
8760 Check_No_Identifiers;
8761 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
8762 Polling_Required := (Chars (Expression (Arg1)) = Name_On);
8764 --------------------
8765 -- Persistent_BSS --
8766 --------------------
8768 when Pragma_Persistent_BSS => Persistent_BSS : declare
8775 Check_At_Most_N_Arguments (1);
8777 -- Case of application to specific object (one argument)
8779 if Arg_Count = 1 then
8780 Check_Arg_Is_Library_Level_Local_Name (Arg1);
8782 if not Is_Entity_Name (Expression (Arg1))
8784 (Ekind (Entity (Expression (Arg1))) /= E_Variable
8785 and then Ekind (Entity (Expression (Arg1))) /= E_Constant)
8787 Error_Pragma_Arg ("pragma% only applies to objects", Arg1);
8790 Ent := Entity (Expression (Arg1));
8791 Decl := Parent (Ent);
8793 if Rep_Item_Too_Late (Ent, N) then
8797 if Present (Expression (Decl)) then
8799 ("object for pragma% cannot have initialization", Arg1);
8802 if not Is_Potentially_Persistent_Type (Etype (Ent)) then
8804 ("object type for pragma% is not potentially persistent",
8809 Make_Linker_Section_Pragma
8810 (Ent, Sloc (N), ".persistent.bss");
8811 Insert_After (N, Prag);
8814 -- Case of use as configuration pragma with no arguments
8817 Check_Valid_Configuration_Pragma;
8818 Persistent_BSS_Mode := True;
8826 -- pragma Preelaborate [(library_unit_NAME)];
8828 -- Set the flag Is_Preelaborated of program unit name entity
8830 when Pragma_Preelaborate => Preelaborate : declare
8831 Pa : constant Node_Id := Parent (N);
8832 Pk : constant Node_Kind := Nkind (Pa);
8836 Check_Ada_83_Warning;
8837 Check_Valid_Library_Unit_Pragma;
8839 if Nkind (N) = N_Null_Statement then
8843 Ent := Find_Lib_Unit_Name;
8845 -- This filters out pragmas inside generic parent then
8846 -- show up inside instantiation
8849 and then not (Pk = N_Package_Specification
8850 and then Present (Generic_Parent (Pa)))
8852 if not Debug_Flag_U then
8853 Set_Is_Preelaborated (Ent);
8854 Set_Suppress_Elaboration_Warnings (Ent);
8859 ---------------------
8860 -- Preelaborate_05 --
8861 ---------------------
8863 -- pragma Preelaborate_05 [(library_unit_NAME)];
8865 -- This pragma is useable only in GNAT_Mode, where it is used like
8866 -- pragma Preelaborate but it is only effective in Ada 2005 mode
8867 -- (otherwise it is ignored). This is used to implement AI-362 which
8868 -- recategorizes some run-time packages in Ada 2005 mode.
8870 when Pragma_Preelaborate_05 => Preelaborate_05 : declare
8875 Check_Valid_Library_Unit_Pragma;
8877 if not GNAT_Mode then
8878 Error_Pragma ("pragma% only available in GNAT mode");
8881 if Nkind (N) = N_Null_Statement then
8885 -- This is one of the few cases where we need to test the value of
8886 -- Ada_Version_Explicit rather than Ada_Version (which is always
8887 -- set to Ada_05 in a predefined unit), we need to know the
8888 -- explicit version set to know if this pragma is active.
8890 if Ada_Version_Explicit >= Ada_05 then
8891 Ent := Find_Lib_Unit_Name;
8892 Set_Is_Preelaborated (Ent);
8893 Set_Suppress_Elaboration_Warnings (Ent);
8895 end Preelaborate_05;
8901 -- pragma Priority (EXPRESSION);
8903 when Pragma_Priority => Priority : declare
8904 P : constant Node_Id := Parent (N);
8908 Check_No_Identifiers;
8909 Check_Arg_Count (1);
8913 if Nkind (P) = N_Subprogram_Body then
8914 Check_In_Main_Program;
8916 Arg := Expression (Arg1);
8917 Analyze_And_Resolve (Arg, Standard_Integer);
8921 if not Is_Static_Expression (Arg) then
8922 Flag_Non_Static_Expr
8923 ("main subprogram priority is not static!", Arg);
8926 -- If constraint error, then we already signalled an error
8928 elsif Raises_Constraint_Error (Arg) then
8931 -- Otherwise check in range
8935 Val : constant Uint := Expr_Value (Arg);
8939 or else Val > Expr_Value (Expression
8940 (Parent (RTE (RE_Max_Priority))))
8943 ("main subprogram priority is out of range", Arg1);
8949 (Current_Sem_Unit, UI_To_Int (Expr_Value (Arg)));
8951 -- Load an arbitrary entity from System.Tasking to make sure
8952 -- this package is implicitly with'ed, since we need to have
8953 -- the tasking run-time active for the pragma Priority to have
8957 Discard : Entity_Id;
8958 pragma Warnings (Off, Discard);
8960 Discard := RTE (RE_Task_List);
8963 -- Task or Protected, must be of type Integer
8965 elsif Nkind (P) = N_Protected_Definition
8967 Nkind (P) = N_Task_Definition
8969 Arg := Expression (Arg1);
8971 -- The expression must be analyzed in the special manner
8972 -- described in "Handling of Default and Per-Object
8973 -- Expressions" in sem.ads.
8975 Analyze_Per_Use_Expression (Arg, Standard_Integer);
8977 if not Is_Static_Expression (Arg) then
8978 Check_Restriction (Static_Priorities, Arg);
8981 -- Anything else is incorrect
8987 if Has_Priority_Pragma (P) then
8988 Error_Pragma ("duplicate pragma% not allowed");
8990 Set_Has_Priority_Pragma (P, True);
8992 if Nkind (P) = N_Protected_Definition
8994 Nkind (P) = N_Task_Definition
8996 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
8997 -- exp_ch9 should use this ???
9002 -----------------------------------
9003 -- Priority_Specific_Dispatching --
9004 -----------------------------------
9006 -- pragma Priority_Specific_Dispatching (
9007 -- policy_IDENTIFIER,
9008 -- first_priority_EXPRESSION,
9009 -- last_priority_EXPRESSION);
9011 when Pragma_Priority_Specific_Dispatching =>
9012 Priority_Specific_Dispatching : declare
9013 Prio_Id : constant Entity_Id := RTE (RE_Any_Priority);
9014 -- This is the entity System.Any_Priority;
9017 Lower_Bound : Node_Id;
9018 Upper_Bound : Node_Id;
9024 Check_Arg_Count (3);
9025 Check_No_Identifiers;
9026 Check_Arg_Is_Task_Dispatching_Policy (Arg1);
9027 Check_Valid_Configuration_Pragma;
9028 Get_Name_String (Chars (Expression (Arg1)));
9029 DP := Fold_Upper (Name_Buffer (1));
9031 Lower_Bound := Expression (Arg2);
9032 Check_Arg_Is_Static_Expression (Lower_Bound, Standard_Integer);
9033 Lower_Val := Expr_Value (Lower_Bound);
9035 Upper_Bound := Expression (Arg3);
9036 Check_Arg_Is_Static_Expression (Upper_Bound, Standard_Integer);
9037 Upper_Val := Expr_Value (Upper_Bound);
9039 -- It is not allowed to use Task_Dispatching_Policy and
9040 -- Priority_Specific_Dispatching in the same partition.
9042 if Task_Dispatching_Policy /= ' ' then
9043 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
9045 ("pragma% incompatible with Task_Dispatching_Policy#");
9047 -- Check lower bound in range
9049 elsif Lower_Val < Expr_Value (Type_Low_Bound (Prio_Id))
9051 Lower_Val > Expr_Value (Type_High_Bound (Prio_Id))
9054 ("first_priority is out of range", Arg2);
9056 -- Check upper bound in range
9058 elsif Upper_Val < Expr_Value (Type_Low_Bound (Prio_Id))
9060 Upper_Val > Expr_Value (Type_High_Bound (Prio_Id))
9063 ("last_priority is out of range", Arg3);
9065 -- Check that the priority range is valid
9067 elsif Lower_Val > Upper_Val then
9069 ("last_priority_expression must be greater than" &
9070 " or equal to first_priority_expression");
9072 -- Store the new policy, but always preserve System_Location since
9073 -- we like the error message with the run-time name.
9076 -- Check overlapping in the priority ranges specified in other
9077 -- Priority_Specific_Dispatching pragmas within the same
9078 -- partition. We can only check those we know about!
9081 Specific_Dispatching.First .. Specific_Dispatching.Last
9083 if Specific_Dispatching.Table (J).First_Priority in
9084 UI_To_Int (Lower_Val) .. UI_To_Int (Upper_Val)
9085 or else Specific_Dispatching.Table (J).Last_Priority in
9086 UI_To_Int (Lower_Val) .. UI_To_Int (Upper_Val)
9089 Specific_Dispatching.Table (J).Pragma_Loc;
9091 ("priority range overlaps with "
9092 & "Priority_Specific_Dispatching#");
9096 -- The use of Priority_Specific_Dispatching is incompatible
9097 -- with Task_Dispatching_Policy.
9099 if Task_Dispatching_Policy /= ' ' then
9100 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
9102 ("Priority_Specific_Dispatching incompatible "
9103 & "with Task_Dispatching_Policy#");
9106 -- The use of Priority_Specific_Dispatching forces ceiling
9109 if Locking_Policy /= ' ' and then Locking_Policy /= 'C' then
9110 Error_Msg_Sloc := Locking_Policy_Sloc;
9112 ("Priority_Specific_Dispatching incompatible "
9113 & "with Locking_Policy#");
9115 -- Set the Ceiling_Locking policy, but preserve System_Location
9116 -- since we like the error message with the run time name.
9119 Locking_Policy := 'C';
9121 if Locking_Policy_Sloc /= System_Location then
9122 Locking_Policy_Sloc := Loc;
9126 -- Add entry in the table
9128 Specific_Dispatching.Append
9129 ((Dispatching_Policy => DP,
9130 First_Priority => UI_To_Int (Lower_Val),
9131 Last_Priority => UI_To_Int (Upper_Val),
9132 Pragma_Loc => Loc));
9134 end Priority_Specific_Dispatching;
9140 -- pragma Profile (profile_IDENTIFIER);
9142 -- profile_IDENTIFIER => Protected | Ravenscar
9144 when Pragma_Profile =>
9146 Check_Arg_Count (1);
9147 Check_Valid_Configuration_Pragma;
9148 Check_No_Identifiers;
9151 Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
9153 if Chars (Argx) = Name_Ravenscar then
9154 Set_Ravenscar_Profile (N);
9155 elsif Chars (Argx) = Name_Restricted then
9156 Set_Profile_Restrictions (Restricted, N, Warn => False);
9158 Error_Pragma_Arg ("& is not a valid profile", Argx);
9162 ----------------------
9163 -- Profile_Warnings --
9164 ----------------------
9166 -- pragma Profile_Warnings (profile_IDENTIFIER);
9168 -- profile_IDENTIFIER => Protected | Ravenscar
9170 when Pragma_Profile_Warnings =>
9172 Check_Arg_Count (1);
9173 Check_Valid_Configuration_Pragma;
9174 Check_No_Identifiers;
9177 Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
9179 if Chars (Argx) = Name_Ravenscar then
9180 Set_Profile_Restrictions (Ravenscar, N, Warn => True);
9181 elsif Chars (Argx) = Name_Restricted then
9182 Set_Profile_Restrictions (Restricted, N, Warn => True);
9184 Error_Pragma_Arg ("& is not a valid profile", Argx);
9188 --------------------------
9189 -- Propagate_Exceptions --
9190 --------------------------
9192 -- pragma Propagate_Exceptions;
9194 -- Note: this pragma is obsolete and has no effect
9196 when Pragma_Propagate_Exceptions =>
9198 Check_Arg_Count (0);
9200 if In_Extended_Main_Source_Unit (N) then
9201 Propagate_Exceptions := True;
9208 -- pragma Psect_Object (
9209 -- [Internal =>] LOCAL_NAME,
9210 -- [, [External =>] EXTERNAL_SYMBOL]
9211 -- [, [Size =>] EXTERNAL_SYMBOL]);
9213 when Pragma_Psect_Object | Pragma_Common_Object =>
9214 Psect_Object : declare
9215 Args : Args_List (1 .. 3);
9216 Names : constant Name_List (1 .. 3) := (
9221 Internal : Node_Id renames Args (1);
9222 External : Node_Id renames Args (2);
9223 Size : Node_Id renames Args (3);
9227 procedure Check_Too_Long (Arg : Node_Id);
9228 -- Posts message if the argument is an identifier with more
9229 -- than 31 characters, or a string literal with more than
9230 -- 31 characters, and we are operating under VMS
9232 --------------------
9233 -- Check_Too_Long --
9234 --------------------
9236 procedure Check_Too_Long (Arg : Node_Id) is
9237 X : constant Node_Id := Original_Node (Arg);
9240 if Nkind (X) /= N_String_Literal
9242 Nkind (X) /= N_Identifier
9245 ("inappropriate argument for pragma %", Arg);
9248 if OpenVMS_On_Target then
9249 if (Nkind (X) = N_String_Literal
9250 and then String_Length (Strval (X)) > 31)
9252 (Nkind (X) = N_Identifier
9253 and then Length_Of_Name (Chars (X)) > 31)
9256 ("argument for pragma % is longer than 31 characters",
9262 -- Start of processing for Common_Object/Psect_Object
9266 Gather_Associations (Names, Args);
9267 Process_Extended_Import_Export_Internal_Arg (Internal);
9269 Def_Id := Entity (Internal);
9271 if Ekind (Def_Id) /= E_Constant
9272 and then Ekind (Def_Id) /= E_Variable
9275 ("pragma% must designate an object", Internal);
9278 Check_Too_Long (Internal);
9280 if Is_Imported (Def_Id) or else Is_Exported (Def_Id) then
9282 ("cannot use pragma% for imported/exported object",
9286 if Is_Concurrent_Type (Etype (Internal)) then
9288 ("cannot specify pragma % for task/protected object",
9292 if Has_Rep_Pragma (Def_Id, Name_Common_Object)
9294 Has_Rep_Pragma (Def_Id, Name_Psect_Object)
9296 Error_Msg_N ("?duplicate Common/Psect_Object pragma", N);
9299 if Ekind (Def_Id) = E_Constant then
9301 ("cannot specify pragma % for a constant", Internal);
9304 if Is_Record_Type (Etype (Internal)) then
9310 Ent := First_Entity (Etype (Internal));
9311 while Present (Ent) loop
9312 Decl := Declaration_Node (Ent);
9314 if Ekind (Ent) = E_Component
9315 and then Nkind (Decl) = N_Component_Declaration
9316 and then Present (Expression (Decl))
9317 and then Warn_On_Export_Import
9320 ("?object for pragma % has defaults", Internal);
9330 if Present (Size) then
9331 Check_Too_Long (Size);
9334 if Present (External) then
9335 Check_Arg_Is_External_Name (External);
9336 Check_Too_Long (External);
9339 -- If all error tests pass, link pragma on to the rep item chain
9341 Record_Rep_Item (Def_Id, N);
9348 -- pragma Pure [(library_unit_NAME)];
9350 when Pragma_Pure => Pure : declare
9354 Check_Ada_83_Warning;
9355 Check_Valid_Library_Unit_Pragma;
9357 if Nkind (N) = N_Null_Statement then
9361 Ent := Find_Lib_Unit_Name;
9363 Set_Has_Pragma_Pure (Ent);
9364 Set_Suppress_Elaboration_Warnings (Ent);
9371 -- pragma Pure_05 [(library_unit_NAME)];
9373 -- This pragma is useable only in GNAT_Mode, where it is used like
9374 -- pragma Pure but it is only effective in Ada 2005 mode (otherwise
9375 -- it is ignored). It may be used after a pragma Preelaborate, in
9376 -- which case it overrides the effect of the pragma Preelaborate.
9377 -- This is used to implement AI-362 which recategorizes some run-time
9378 -- packages in Ada 2005 mode.
9380 when Pragma_Pure_05 => Pure_05 : declare
9385 Check_Valid_Library_Unit_Pragma;
9387 if not GNAT_Mode then
9388 Error_Pragma ("pragma% only available in GNAT mode");
9390 if Nkind (N) = N_Null_Statement then
9394 -- This is one of the few cases where we need to test the value of
9395 -- Ada_Version_Explicit rather than Ada_Version (which is always
9396 -- set to Ada_05 in a predefined unit), we need to know the
9397 -- explicit version set to know if this pragma is active.
9399 if Ada_Version_Explicit >= Ada_05 then
9400 Ent := Find_Lib_Unit_Name;
9401 Set_Is_Preelaborated (Ent, False);
9403 Set_Suppress_Elaboration_Warnings (Ent);
9411 -- pragma Pure_Function ([Entity =>] function_LOCAL_NAME);
9413 when Pragma_Pure_Function => Pure_Function : declare
9417 Effective : Boolean := False;
9421 Check_Arg_Count (1);
9422 Check_Optional_Identifier (Arg1, Name_Entity);
9423 Check_Arg_Is_Local_Name (Arg1);
9424 E_Id := Expression (Arg1);
9426 if Error_Posted (E_Id) then
9430 -- Loop through homonyms (overloadings) of referenced entity
9436 Def_Id := Get_Base_Subprogram (E);
9438 if Ekind (Def_Id) /= E_Function
9439 and then Ekind (Def_Id) /= E_Generic_Function
9440 and then Ekind (Def_Id) /= E_Operator
9443 ("pragma% requires a function name", Arg1);
9446 Set_Is_Pure (Def_Id);
9448 if not Has_Pragma_Pure_Function (Def_Id) then
9449 Set_Has_Pragma_Pure_Function (Def_Id);
9454 exit when No (E) or else Scope (E) /= Current_Scope;
9458 and then Warn_On_Redundant_Constructs
9460 Error_Msg_NE ("pragma Pure_Function on& is redundant?",
9466 --------------------
9467 -- Queuing_Policy --
9468 --------------------
9470 -- pragma Queuing_Policy (policy_IDENTIFIER);
9472 when Pragma_Queuing_Policy => declare
9476 Check_Ada_83_Warning;
9477 Check_Arg_Count (1);
9478 Check_No_Identifiers;
9479 Check_Arg_Is_Queuing_Policy (Arg1);
9480 Check_Valid_Configuration_Pragma;
9481 Get_Name_String (Chars (Expression (Arg1)));
9482 QP := Fold_Upper (Name_Buffer (1));
9484 if Queuing_Policy /= ' '
9485 and then Queuing_Policy /= QP
9487 Error_Msg_Sloc := Queuing_Policy_Sloc;
9488 Error_Pragma ("queuing policy incompatible with policy#");
9490 -- Set new policy, but always preserve System_Location since
9491 -- we like the error message with the run time name.
9494 Queuing_Policy := QP;
9496 if Queuing_Policy_Sloc /= System_Location then
9497 Queuing_Policy_Sloc := Loc;
9502 ---------------------------
9503 -- Remote_Call_Interface --
9504 ---------------------------
9506 -- pragma Remote_Call_Interface [(library_unit_NAME)];
9508 when Pragma_Remote_Call_Interface => Remote_Call_Interface : declare
9509 Cunit_Node : Node_Id;
9510 Cunit_Ent : Entity_Id;
9514 Check_Ada_83_Warning;
9515 Check_Valid_Library_Unit_Pragma;
9517 if Nkind (N) = N_Null_Statement then
9521 Cunit_Node := Cunit (Current_Sem_Unit);
9522 K := Nkind (Unit (Cunit_Node));
9523 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
9525 if K = N_Package_Declaration
9526 or else K = N_Generic_Package_Declaration
9527 or else K = N_Subprogram_Declaration
9528 or else K = N_Generic_Subprogram_Declaration
9529 or else (K = N_Subprogram_Body
9530 and then Acts_As_Spec (Unit (Cunit_Node)))
9535 "pragma% must apply to package or subprogram declaration");
9538 Set_Is_Remote_Call_Interface (Cunit_Ent);
9539 end Remote_Call_Interface;
9545 -- pragma Remote_Types [(library_unit_NAME)];
9547 when Pragma_Remote_Types => Remote_Types : declare
9548 Cunit_Node : Node_Id;
9549 Cunit_Ent : Entity_Id;
9552 Check_Ada_83_Warning;
9553 Check_Valid_Library_Unit_Pragma;
9555 if Nkind (N) = N_Null_Statement then
9559 Cunit_Node := Cunit (Current_Sem_Unit);
9560 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
9562 if Nkind (Unit (Cunit_Node)) /= N_Package_Declaration
9564 Nkind (Unit (Cunit_Node)) /= N_Generic_Package_Declaration
9567 "pragma% can only apply to a package declaration");
9570 Set_Is_Remote_Types (Cunit_Ent);
9577 -- pragma Ravenscar;
9579 when Pragma_Ravenscar =>
9581 Check_Arg_Count (0);
9582 Check_Valid_Configuration_Pragma;
9583 Set_Ravenscar_Profile (N);
9585 if Warn_On_Obsolescent_Feature then
9587 ("pragma Ravenscar is an obsolescent feature?", N);
9589 ("|use pragma Profile (Ravenscar) instead", N);
9592 -------------------------
9593 -- Restricted_Run_Time --
9594 -------------------------
9596 -- pragma Restricted_Run_Time;
9598 when Pragma_Restricted_Run_Time =>
9600 Check_Arg_Count (0);
9601 Check_Valid_Configuration_Pragma;
9602 Set_Profile_Restrictions (Restricted, N, Warn => False);
9604 if Warn_On_Obsolescent_Feature then
9606 ("pragma Restricted_Run_Time is an obsolescent feature?", N);
9608 ("|use pragma Profile (Restricted) instead", N);
9615 -- pragma Restrictions (RESTRICTION {, RESTRICTION});
9618 -- restriction_IDENTIFIER
9619 -- | restriction_parameter_IDENTIFIER => EXPRESSION
9621 when Pragma_Restrictions =>
9622 Process_Restrictions_Or_Restriction_Warnings (Warn => False);
9624 --------------------------
9625 -- Restriction_Warnings --
9626 --------------------------
9628 -- pragma Restriction_Warnings (RESTRICTION {, RESTRICTION});
9631 -- restriction_IDENTIFIER
9632 -- | restriction_parameter_IDENTIFIER => EXPRESSION
9634 when Pragma_Restriction_Warnings =>
9635 Process_Restrictions_Or_Restriction_Warnings (Warn => True);
9641 -- pragma Reviewable;
9643 when Pragma_Reviewable =>
9644 Check_Ada_83_Warning;
9645 Check_Arg_Count (0);
9652 -- pragma Share_Generic (NAME {, NAME});
9654 when Pragma_Share_Generic =>
9656 Process_Generic_List;
9662 -- pragma Shared (LOCAL_NAME);
9664 when Pragma_Shared =>
9666 Process_Atomic_Shared_Volatile;
9668 --------------------
9669 -- Shared_Passive --
9670 --------------------
9672 -- pragma Shared_Passive [(library_unit_NAME)];
9674 -- Set the flag Is_Shared_Passive of program unit name entity
9676 when Pragma_Shared_Passive => Shared_Passive : declare
9677 Cunit_Node : Node_Id;
9678 Cunit_Ent : Entity_Id;
9681 Check_Ada_83_Warning;
9682 Check_Valid_Library_Unit_Pragma;
9684 if Nkind (N) = N_Null_Statement then
9688 Cunit_Node := Cunit (Current_Sem_Unit);
9689 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
9691 if Nkind (Unit (Cunit_Node)) /= N_Package_Declaration
9693 Nkind (Unit (Cunit_Node)) /= N_Generic_Package_Declaration
9696 "pragma% can only apply to a package declaration");
9699 Set_Is_Shared_Passive (Cunit_Ent);
9702 ----------------------
9703 -- Source_File_Name --
9704 ----------------------
9706 -- There are five forms for this pragma:
9708 -- pragma Source_File_Name (
9709 -- [UNIT_NAME =>] unit_NAME,
9710 -- BODY_FILE_NAME => STRING_LITERAL
9711 -- [, [INDEX =>] INTEGER_LITERAL]);
9713 -- pragma Source_File_Name (
9714 -- [UNIT_NAME =>] unit_NAME,
9715 -- SPEC_FILE_NAME => STRING_LITERAL
9716 -- [, [INDEX =>] INTEGER_LITERAL]);
9718 -- pragma Source_File_Name (
9719 -- BODY_FILE_NAME => STRING_LITERAL
9720 -- [, DOT_REPLACEMENT => STRING_LITERAL]
9721 -- [, CASING => CASING_SPEC]);
9723 -- pragma Source_File_Name (
9724 -- SPEC_FILE_NAME => STRING_LITERAL
9725 -- [, DOT_REPLACEMENT => STRING_LITERAL]
9726 -- [, CASING => CASING_SPEC]);
9728 -- pragma Source_File_Name (
9729 -- SUBUNIT_FILE_NAME => STRING_LITERAL
9730 -- [, DOT_REPLACEMENT => STRING_LITERAL]
9731 -- [, CASING => CASING_SPEC]);
9733 -- CASING_SPEC ::= Uppercase | Lowercase | Mixedcase
9735 -- Pragma Source_File_Name_Project (SFNP) is equivalent to pragma
9736 -- Source_File_Name (SFN), however their usage is exclusive:
9737 -- SFN can only be used when no project file is used, while
9738 -- SFNP can only be used when a project file is used.
9740 -- No processing here. Processing was completed during parsing,
9741 -- since we need to have file names set as early as possible.
9742 -- Units are loaded well before semantic processing starts.
9744 -- The only processing we defer to this point is the check
9745 -- for correct placement.
9747 when Pragma_Source_File_Name =>
9749 Check_Valid_Configuration_Pragma;
9751 ------------------------------
9752 -- Source_File_Name_Project --
9753 ------------------------------
9755 -- See Source_File_Name for syntax
9757 -- No processing here. Processing was completed during parsing,
9758 -- since we need to have file names set as early as possible.
9759 -- Units are loaded well before semantic processing starts.
9761 -- The only processing we defer to this point is the check
9762 -- for correct placement.
9764 when Pragma_Source_File_Name_Project =>
9766 Check_Valid_Configuration_Pragma;
9768 -- Check that a pragma Source_File_Name_Project is used only
9769 -- in a configuration pragmas file.
9771 -- Pragmas Source_File_Name_Project should only be generated
9772 -- by the Project Manager in configuration pragmas files.
9774 -- This is really an ugly test. It seems to depend on some
9775 -- accidental and undocumented property. At the very least
9776 -- it needs to be documented, but it would be better to have
9777 -- a clean way of testing if we are in a configuration file???
9779 if Present (Parent (N)) then
9781 ("pragma% can only appear in a configuration pragmas file");
9784 ----------------------
9785 -- Source_Reference --
9786 ----------------------
9788 -- pragma Source_Reference (INTEGER_LITERAL [, STRING_LITERAL]);
9790 -- Nothing to do, all processing completed in Par.Prag, since we
9791 -- need the information for possible parser messages that are output
9793 when Pragma_Source_Reference =>
9796 --------------------------------
9797 -- Static_Elaboration_Desired --
9798 --------------------------------
9800 -- pragma Static_Elaboration_Desired (DIRECT_NAME);
9802 when Pragma_Static_Elaboration_Desired =>
9804 Check_At_Most_N_Arguments (1);
9806 if Is_Compilation_Unit (Current_Scope)
9807 and then Ekind (Current_Scope) = E_Package
9809 Set_Static_Elaboration_Desired (Current_Scope, True);
9811 Error_Pragma ("pragma% must apply to a library-level package");
9818 -- pragma Storage_Size (EXPRESSION);
9820 when Pragma_Storage_Size => Storage_Size : declare
9821 P : constant Node_Id := Parent (N);
9825 Check_No_Identifiers;
9826 Check_Arg_Count (1);
9828 -- The expression must be analyzed in the special manner
9829 -- described in "Handling of Default Expressions" in sem.ads.
9831 -- Set In_Default_Expression for per-object case ???
9833 Arg := Expression (Arg1);
9834 Analyze_Per_Use_Expression (Arg, Any_Integer);
9836 if not Is_Static_Expression (Arg) then
9837 Check_Restriction (Static_Storage_Size, Arg);
9840 if Nkind (P) /= N_Task_Definition then
9845 if Has_Storage_Size_Pragma (P) then
9846 Error_Pragma ("duplicate pragma% not allowed");
9848 Set_Has_Storage_Size_Pragma (P, True);
9851 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
9852 -- ??? exp_ch9 should use this!
9860 -- pragma Storage_Unit (NUMERIC_LITERAL);
9862 -- Only permitted argument is System'Storage_Unit value
9864 when Pragma_Storage_Unit =>
9865 Check_No_Identifiers;
9866 Check_Arg_Count (1);
9867 Check_Arg_Is_Integer_Literal (Arg1);
9869 if Intval (Expression (Arg1)) /=
9870 UI_From_Int (Ttypes.System_Storage_Unit)
9872 Error_Msg_Uint_1 := UI_From_Int (Ttypes.System_Storage_Unit);
9874 ("the only allowed argument for pragma% is ^", Arg1);
9877 --------------------
9878 -- Stream_Convert --
9879 --------------------
9881 -- pragma Stream_Convert (
9882 -- [Entity =>] type_LOCAL_NAME,
9883 -- [Read =>] function_NAME,
9884 -- [Write =>] function NAME);
9886 when Pragma_Stream_Convert => Stream_Convert : declare
9888 procedure Check_OK_Stream_Convert_Function (Arg : Node_Id);
9889 -- Check that the given argument is the name of a local
9890 -- function of one argument that is not overloaded earlier
9891 -- in the current local scope. A check is also made that the
9892 -- argument is a function with one parameter.
9894 --------------------------------------
9895 -- Check_OK_Stream_Convert_Function --
9896 --------------------------------------
9898 procedure Check_OK_Stream_Convert_Function (Arg : Node_Id) is
9902 Check_Arg_Is_Local_Name (Arg);
9903 Ent := Entity (Expression (Arg));
9905 if Has_Homonym (Ent) then
9907 ("argument for pragma% may not be overloaded", Arg);
9910 if Ekind (Ent) /= E_Function
9911 or else No (First_Formal (Ent))
9912 or else Present (Next_Formal (First_Formal (Ent)))
9915 ("argument for pragma% must be" &
9916 " function of one argument", Arg);
9918 end Check_OK_Stream_Convert_Function;
9920 -- Start of procecessing for Stream_Convert
9924 Check_Arg_Order ((Name_Entity, Name_Read, Name_Write));
9925 Check_Arg_Count (3);
9926 Check_Optional_Identifier (Arg1, Name_Entity);
9927 Check_Optional_Identifier (Arg2, Name_Read);
9928 Check_Optional_Identifier (Arg3, Name_Write);
9929 Check_Arg_Is_Local_Name (Arg1);
9930 Check_OK_Stream_Convert_Function (Arg2);
9931 Check_OK_Stream_Convert_Function (Arg3);
9934 Typ : constant Entity_Id :=
9935 Underlying_Type (Entity (Expression (Arg1)));
9936 Read : constant Entity_Id := Entity (Expression (Arg2));
9937 Write : constant Entity_Id := Entity (Expression (Arg3));
9940 if Etype (Typ) = Any_Type
9942 Etype (Read) = Any_Type
9944 Etype (Write) = Any_Type
9949 Check_First_Subtype (Arg1);
9951 if Rep_Item_Too_Early (Typ, N)
9953 Rep_Item_Too_Late (Typ, N)
9958 if Underlying_Type (Etype (Read)) /= Typ then
9960 ("incorrect return type for function&", Arg2);
9963 if Underlying_Type (Etype (First_Formal (Write))) /= Typ then
9965 ("incorrect parameter type for function&", Arg3);
9968 if Underlying_Type (Etype (First_Formal (Read))) /=
9969 Underlying_Type (Etype (Write))
9972 ("result type of & does not match Read parameter type",
9978 -------------------------
9979 -- Style_Checks (GNAT) --
9980 -------------------------
9982 -- pragma Style_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
9984 -- This is processed by the parser since some of the style
9985 -- checks take place during source scanning and parsing. This
9986 -- means that we don't need to issue error messages here.
9988 when Pragma_Style_Checks => Style_Checks : declare
9989 A : constant Node_Id := Expression (Arg1);
9995 Check_No_Identifiers;
9997 -- Two argument form
9999 if Arg_Count = 2 then
10000 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
10007 E_Id := Expression (Arg2);
10010 if not Is_Entity_Name (E_Id) then
10012 ("second argument of pragma% must be entity name",
10016 E := Entity (E_Id);
10022 Set_Suppress_Style_Checks (E,
10023 (Chars (Expression (Arg1)) = Name_Off));
10024 exit when No (Homonym (E));
10030 -- One argument form
10033 Check_Arg_Count (1);
10035 if Nkind (A) = N_String_Literal then
10039 Slen : constant Natural := Natural (String_Length (S));
10040 Options : String (1 .. Slen);
10046 C := Get_String_Char (S, Int (J));
10047 exit when not In_Character_Range (C);
10048 Options (J) := Get_Character (C);
10050 -- If at end of string, set options. As per discussion
10051 -- above, no need to check for errors, since we issued
10052 -- them in the parser.
10055 Set_Style_Check_Options (Options);
10063 elsif Nkind (A) = N_Identifier then
10064 if Chars (A) = Name_All_Checks then
10065 Set_Default_Style_Check_Options;
10067 elsif Chars (A) = Name_On then
10068 Style_Check := True;
10070 elsif Chars (A) = Name_Off then
10071 Style_Check := False;
10081 -- pragma Subtitle ([Subtitle =>] STRING_LITERAL);
10083 when Pragma_Subtitle =>
10085 Check_Arg_Count (1);
10086 Check_Optional_Identifier (Arg1, Name_Subtitle);
10087 Check_Arg_Is_String_Literal (Arg1);
10093 -- pragma Suppress (IDENTIFIER [, [On =>] NAME]);
10095 when Pragma_Suppress =>
10096 Process_Suppress_Unsuppress (True);
10102 -- pragma Suppress_All;
10104 -- The only check made here is that the pragma appears in the
10105 -- proper place, i.e. following a compilation unit. If indeed
10106 -- it appears in this context, then the parser has already
10107 -- inserted an equivalent pragma Suppress (All_Checks) to get
10108 -- the required effect.
10110 when Pragma_Suppress_All =>
10112 Check_Arg_Count (0);
10114 if Nkind (Parent (N)) /= N_Compilation_Unit_Aux
10115 or else not Is_List_Member (N)
10116 or else List_Containing (N) /= Pragmas_After (Parent (N))
10119 ("misplaced pragma%, must follow compilation unit");
10122 -------------------------
10123 -- Suppress_Debug_Info --
10124 -------------------------
10126 -- pragma Suppress_Debug_Info ([Entity =>] LOCAL_NAME);
10128 when Pragma_Suppress_Debug_Info =>
10130 Check_Arg_Count (1);
10131 Check_Optional_Identifier (Arg1, Name_Entity);
10132 Check_Arg_Is_Local_Name (Arg1);
10133 Set_Debug_Info_Off (Entity (Get_Pragma_Arg (Arg1)));
10135 ----------------------------------
10136 -- Suppress_Exception_Locations --
10137 ----------------------------------
10139 -- pragma Suppress_Exception_Locations;
10141 when Pragma_Suppress_Exception_Locations =>
10143 Check_Arg_Count (0);
10144 Check_Valid_Configuration_Pragma;
10145 Exception_Locations_Suppressed := True;
10147 -----------------------------
10148 -- Suppress_Initialization --
10149 -----------------------------
10151 -- pragma Suppress_Initialization ([Entity =>] type_Name);
10153 when Pragma_Suppress_Initialization => Suppress_Init : declare
10159 Check_Arg_Count (1);
10160 Check_Optional_Identifier (Arg1, Name_Entity);
10161 Check_Arg_Is_Local_Name (Arg1);
10163 E_Id := Expression (Arg1);
10165 if Etype (E_Id) = Any_Type then
10169 E := Entity (E_Id);
10171 if Is_Type (E) then
10172 if Is_Incomplete_Or_Private_Type (E) then
10173 if No (Full_View (Base_Type (E))) then
10175 ("argument of pragma% cannot be an incomplete type",
10178 Set_Suppress_Init_Proc (Full_View (Base_Type (E)));
10181 Set_Suppress_Init_Proc (Base_Type (E));
10186 ("pragma% requires argument that is a type name", Arg1);
10194 -- pragma System_Name (DIRECT_NAME);
10196 -- Syntax check: one argument, which must be the identifier GNAT
10197 -- or the identifier GCC, no other identifiers are acceptable.
10199 when Pragma_System_Name =>
10200 Check_No_Identifiers;
10201 Check_Arg_Count (1);
10202 Check_Arg_Is_One_Of (Arg1, Name_Gcc, Name_Gnat);
10204 -----------------------------
10205 -- Task_Dispatching_Policy --
10206 -----------------------------
10208 -- pragma Task_Dispatching_Policy (policy_IDENTIFIER);
10210 when Pragma_Task_Dispatching_Policy => declare
10214 Check_Ada_83_Warning;
10215 Check_Arg_Count (1);
10216 Check_No_Identifiers;
10217 Check_Arg_Is_Task_Dispatching_Policy (Arg1);
10218 Check_Valid_Configuration_Pragma;
10219 Get_Name_String (Chars (Expression (Arg1)));
10220 DP := Fold_Upper (Name_Buffer (1));
10222 if Task_Dispatching_Policy /= ' '
10223 and then Task_Dispatching_Policy /= DP
10225 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
10227 ("task dispatching policy incompatible with policy#");
10229 -- Set new policy, but always preserve System_Location since
10230 -- we like the error message with the run time name.
10233 Task_Dispatching_Policy := DP;
10235 if Task_Dispatching_Policy_Sloc /= System_Location then
10236 Task_Dispatching_Policy_Sloc := Loc;
10245 -- pragma Task_Info (EXPRESSION);
10247 when Pragma_Task_Info => Task_Info : declare
10248 P : constant Node_Id := Parent (N);
10253 if Nkind (P) /= N_Task_Definition then
10254 Error_Pragma ("pragma% must appear in task definition");
10257 Check_No_Identifiers;
10258 Check_Arg_Count (1);
10260 Analyze_And_Resolve (Expression (Arg1), RTE (RE_Task_Info_Type));
10262 if Etype (Expression (Arg1)) = Any_Type then
10266 if Has_Task_Info_Pragma (P) then
10267 Error_Pragma ("duplicate pragma% not allowed");
10269 Set_Has_Task_Info_Pragma (P, True);
10277 -- pragma Task_Name (string_EXPRESSION);
10279 when Pragma_Task_Name => Task_Name : declare
10280 -- pragma Priority (EXPRESSION);
10282 P : constant Node_Id := Parent (N);
10286 Check_No_Identifiers;
10287 Check_Arg_Count (1);
10289 Arg := Expression (Arg1);
10290 Analyze_And_Resolve (Arg, Standard_String);
10292 if Nkind (P) /= N_Task_Definition then
10296 if Has_Task_Name_Pragma (P) then
10297 Error_Pragma ("duplicate pragma% not allowed");
10299 Set_Has_Task_Name_Pragma (P, True);
10300 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
10308 -- pragma Task_Storage (
10309 -- [Task_Type =>] LOCAL_NAME,
10310 -- [Top_Guard =>] static_integer_EXPRESSION);
10312 when Pragma_Task_Storage => Task_Storage : declare
10313 Args : Args_List (1 .. 2);
10314 Names : constant Name_List (1 .. 2) := (
10318 Task_Type : Node_Id renames Args (1);
10319 Top_Guard : Node_Id renames Args (2);
10325 Gather_Associations (Names, Args);
10327 if No (Task_Type) then
10329 ("missing task_type argument for pragma%");
10332 Check_Arg_Is_Local_Name (Task_Type);
10334 Ent := Entity (Task_Type);
10336 if not Is_Task_Type (Ent) then
10338 ("argument for pragma% must be task type", Task_Type);
10341 if No (Top_Guard) then
10343 ("pragma% takes two arguments", Task_Type);
10345 Check_Arg_Is_Static_Expression (Top_Guard, Any_Integer);
10348 Check_First_Subtype (Task_Type);
10350 if Rep_Item_Too_Late (Ent, N) then
10359 -- pragma Time_Slice (static_duration_EXPRESSION);
10361 when Pragma_Time_Slice => Time_Slice : declare
10367 Check_Arg_Count (1);
10368 Check_No_Identifiers;
10369 Check_In_Main_Program;
10370 Check_Arg_Is_Static_Expression (Arg1, Standard_Duration);
10372 if not Error_Posted (Arg1) then
10374 while Present (Nod) loop
10375 if Nkind (Nod) = N_Pragma
10376 and then Chars (Nod) = Name_Time_Slice
10378 Error_Msg_Name_1 := Chars (N);
10379 Error_Msg_N ("duplicate pragma% not permitted", Nod);
10386 -- Process only if in main unit
10388 if Get_Source_Unit (Loc) = Main_Unit then
10389 Opt.Time_Slice_Set := True;
10390 Val := Expr_Value_R (Expression (Arg1));
10392 if Val <= Ureal_0 then
10393 Opt.Time_Slice_Value := 0;
10395 elsif Val > UR_From_Uint (UI_From_Int (1000)) then
10396 Opt.Time_Slice_Value := 1_000_000_000;
10399 Opt.Time_Slice_Value :=
10400 UI_To_Int (UR_To_Uint (Val * UI_From_Int (1_000_000)));
10409 -- pragma Title (TITLING_OPTION [, TITLING OPTION]);
10411 -- TITLING_OPTION ::=
10412 -- [Title =>] STRING_LITERAL
10413 -- | [Subtitle =>] STRING_LITERAL
10415 when Pragma_Title => Title : declare
10416 Args : Args_List (1 .. 2);
10417 Names : constant Name_List (1 .. 2) := (
10423 Gather_Associations (Names, Args);
10425 for J in 1 .. 2 loop
10426 if Present (Args (J)) then
10427 Check_Arg_Is_String_Literal (Args (J));
10432 ---------------------
10433 -- Unchecked_Union --
10434 ---------------------
10436 -- pragma Unchecked_Union (first_subtype_LOCAL_NAME)
10438 when Pragma_Unchecked_Union => Unchecked_Union : declare
10439 Assoc : constant Node_Id := Arg1;
10440 Type_Id : constant Node_Id := Expression (Assoc);
10451 Check_No_Identifiers;
10452 Check_Arg_Count (1);
10453 Check_Arg_Is_Local_Name (Arg1);
10455 Find_Type (Type_Id);
10456 Typ := Entity (Type_Id);
10459 or else Rep_Item_Too_Early (Typ, N)
10463 Typ := Underlying_Type (Typ);
10466 if Rep_Item_Too_Late (Typ, N) then
10470 Check_First_Subtype (Arg1);
10472 -- Note remaining cases are references to a type in the current
10473 -- declarative part. If we find an error, we post the error on
10474 -- the relevant type declaration at an appropriate point.
10476 if not Is_Record_Type (Typ) then
10477 Error_Msg_N ("Unchecked_Union must be record type", Typ);
10480 elsif Is_Tagged_Type (Typ) then
10481 Error_Msg_N ("Unchecked_Union must not be tagged", Typ);
10484 elsif Is_Limited_Type (Typ) then
10486 ("Unchecked_Union must not be limited record type", Typ);
10487 Explain_Limited_Type (Typ, Typ);
10491 if not Has_Discriminants (Typ) then
10493 ("Unchecked_Union must have one discriminant", Typ);
10497 Discr := First_Discriminant (Typ);
10498 while Present (Discr) loop
10499 if No (Discriminant_Default_Value (Discr)) then
10501 ("Unchecked_Union discriminant must have default value",
10504 Next_Discriminant (Discr);
10507 Tdef := Type_Definition (Declaration_Node (Typ));
10508 Clist := Component_List (Tdef);
10510 Comp := First (Component_Items (Clist));
10511 while Present (Comp) loop
10512 Check_Component (Comp);
10516 if No (Clist) or else No (Variant_Part (Clist)) then
10518 ("Unchecked_Union must have variant part",
10523 Vpart := Variant_Part (Clist);
10525 Variant := First (Variants (Vpart));
10526 while Present (Variant) loop
10527 Check_Variant (Variant);
10532 Set_Is_Unchecked_Union (Typ, True);
10533 Set_Convention (Typ, Convention_C);
10535 Set_Has_Unchecked_Union (Base_Type (Typ), True);
10536 Set_Is_Unchecked_Union (Base_Type (Typ), True);
10537 end Unchecked_Union;
10539 ------------------------
10540 -- Unimplemented_Unit --
10541 ------------------------
10543 -- pragma Unimplemented_Unit;
10545 -- Note: this only gives an error if we are generating code,
10546 -- or if we are in a generic library unit (where the pragma
10547 -- appears in the body, not in the spec).
10549 when Pragma_Unimplemented_Unit => Unimplemented_Unit : declare
10550 Cunitent : constant Entity_Id :=
10551 Cunit_Entity (Get_Source_Unit (Loc));
10552 Ent_Kind : constant Entity_Kind :=
10557 Check_Arg_Count (0);
10559 if Operating_Mode = Generate_Code
10560 or else Ent_Kind = E_Generic_Function
10561 or else Ent_Kind = E_Generic_Procedure
10562 or else Ent_Kind = E_Generic_Package
10564 Get_Name_String (Chars (Cunitent));
10565 Set_Casing (Mixed_Case);
10566 Write_Str (Name_Buffer (1 .. Name_Len));
10567 Write_Str (" is not supported in this configuration");
10569 raise Unrecoverable_Error;
10571 end Unimplemented_Unit;
10573 ------------------------
10574 -- Universal_Aliasing --
10575 ------------------------
10577 -- pragma Universal_Aliasing [([Entity =>] type_LOCAL_NAME)];
10579 when Pragma_Universal_Aliasing => Universal_Alias : declare
10584 Check_Arg_Count (1);
10585 Check_Optional_Identifier (Arg2, Name_Entity);
10586 Check_Arg_Is_Local_Name (Arg1);
10587 E_Id := Entity (Expression (Arg1));
10589 if E_Id = Any_Type then
10591 elsif No (E_Id) or else not Is_Type (E_Id) then
10592 Error_Pragma_Arg ("pragma% requires type", Arg1);
10595 Set_Universal_Aliasing (Implementation_Base_Type (E_Id));
10596 end Universal_Alias;
10598 --------------------
10599 -- Universal_Data --
10600 --------------------
10602 -- pragma Universal_Data [(library_unit_NAME)];
10604 when Pragma_Universal_Data =>
10607 -- If this is a configuration pragma, then set the universal
10608 -- addressing option, otherwise confirm that the pragma
10609 -- satisfies the requirements of library unit pragma placement
10610 -- and leave it to the GNAAMP back end to detect the pragma
10611 -- (avoids transitive setting of the option due to withed units).
10613 if Is_Configuration_Pragma then
10614 Universal_Addressing_On_AAMP := True;
10616 Check_Valid_Library_Unit_Pragma;
10619 if not AAMP_On_Target then
10620 Error_Pragma ("?pragma% ignored (applies only to AAMP)");
10627 -- pragma Unreferenced (local_Name {, local_Name});
10629 -- or when used in a context clause:
10631 -- pragma Unreferenced (library_unit_NAME {, library_unit_NAME}
10633 when Pragma_Unreferenced => Unreferenced : declare
10634 Arg_Node : Node_Id;
10635 Arg_Expr : Node_Id;
10636 Arg_Ent : Entity_Id;
10641 Check_At_Least_N_Arguments (1);
10643 -- Check case of appearing within context clause
10645 if Is_In_Context_Clause then
10647 -- The arguments must all be units mentioned in a with clause
10648 -- in the same context clause. Note we already checked (in
10649 -- Par.Prag) that the arguments are either identifiers or
10650 -- selected components.
10653 while Present (Arg_Node) loop
10654 Citem := First (List_Containing (N));
10655 while Citem /= N loop
10656 if Nkind (Citem) = N_With_Clause
10657 and then Same_Name (Name (Citem), Expression (Arg_Node))
10659 Set_Has_Pragma_Unreferenced
10662 (Library_Unit (Citem))));
10663 Set_Unit_Name (Expression (Arg_Node), Name (Citem));
10672 ("argument of pragma% is not with'ed unit", Arg_Node);
10678 -- Case of not in list of context items
10682 while Present (Arg_Node) loop
10683 Check_No_Identifier (Arg_Node);
10685 -- Note: the analyze call done by Check_Arg_Is_Local_Name
10686 -- will in fact generate reference, so that the entity will
10687 -- have a reference, which will inhibit any warnings about
10688 -- it not being referenced, and also properly show up in the
10689 -- ali file as a reference. But this reference is recorded
10690 -- before the Has_Pragma_Unreferenced flag is set, so that
10691 -- no warning is generated for this reference.
10693 Check_Arg_Is_Local_Name (Arg_Node);
10694 Arg_Expr := Get_Pragma_Arg (Arg_Node);
10696 if Is_Entity_Name (Arg_Expr) then
10697 Arg_Ent := Entity (Arg_Expr);
10699 -- If the entity is overloaded, the pragma applies to the
10700 -- most recent overloading, as documented. In this case,
10701 -- name resolution does not generate a reference, so it
10702 -- must be done here explicitly.
10704 if Is_Overloaded (Arg_Expr) then
10705 Generate_Reference (Arg_Ent, N);
10708 Set_Has_Pragma_Unreferenced (Arg_Ent);
10716 --------------------------
10717 -- Unreferenced_Objects --
10718 --------------------------
10720 -- pragma Unreferenced_Objects (local_Name {, local_Name});
10722 when Pragma_Unreferenced_Objects => Unreferenced_Objects : declare
10723 Arg_Node : Node_Id;
10724 Arg_Expr : Node_Id;
10728 Check_At_Least_N_Arguments (1);
10731 while Present (Arg_Node) loop
10732 Check_No_Identifier (Arg_Node);
10733 Check_Arg_Is_Local_Name (Arg_Node);
10734 Arg_Expr := Get_Pragma_Arg (Arg_Node);
10736 if not Is_Entity_Name (Arg_Expr)
10737 or else not Is_Type (Entity (Arg_Expr))
10740 ("argument for pragma% must be type or subtype", Arg_Node);
10743 Set_Has_Pragma_Unreferenced_Objects (Entity (Arg_Expr));
10746 end Unreferenced_Objects;
10748 ------------------------------
10749 -- Unreserve_All_Interrupts --
10750 ------------------------------
10752 -- pragma Unreserve_All_Interrupts;
10754 when Pragma_Unreserve_All_Interrupts =>
10756 Check_Arg_Count (0);
10758 if In_Extended_Main_Code_Unit (Main_Unit_Entity) then
10759 Unreserve_All_Interrupts := True;
10766 -- pragma Unsuppress (IDENTIFIER [, [On =>] NAME]);
10768 when Pragma_Unsuppress =>
10770 Process_Suppress_Unsuppress (False);
10772 -------------------
10773 -- Use_VADS_Size --
10774 -------------------
10776 -- pragma Use_VADS_Size;
10778 when Pragma_Use_VADS_Size =>
10780 Check_Arg_Count (0);
10781 Check_Valid_Configuration_Pragma;
10782 Use_VADS_Size := True;
10784 ---------------------
10785 -- Validity_Checks --
10786 ---------------------
10788 -- pragma Validity_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
10790 when Pragma_Validity_Checks => Validity_Checks : declare
10791 A : constant Node_Id := Expression (Arg1);
10797 Check_Arg_Count (1);
10798 Check_No_Identifiers;
10800 if Nkind (A) = N_String_Literal then
10804 Slen : constant Natural := Natural (String_Length (S));
10805 Options : String (1 .. Slen);
10811 C := Get_String_Char (S, Int (J));
10812 exit when not In_Character_Range (C);
10813 Options (J) := Get_Character (C);
10816 Set_Validity_Check_Options (Options);
10824 elsif Nkind (A) = N_Identifier then
10826 if Chars (A) = Name_All_Checks then
10827 Set_Validity_Check_Options ("a");
10829 elsif Chars (A) = Name_On then
10830 Validity_Checks_On := True;
10832 elsif Chars (A) = Name_Off then
10833 Validity_Checks_On := False;
10837 end Validity_Checks;
10843 -- pragma Volatile (LOCAL_NAME);
10845 when Pragma_Volatile =>
10846 Process_Atomic_Shared_Volatile;
10848 -------------------------
10849 -- Volatile_Components --
10850 -------------------------
10852 -- pragma Volatile_Components (array_LOCAL_NAME);
10854 -- Volatile is handled by the same circuit as Atomic_Components
10860 -- pragma Warnings (On | Off);
10861 -- pragma Warnings (On | Off, LOCAL_NAME);
10862 -- pragma Warnings (static_string_EXPRESSION);
10863 -- pragma Warnings (On | Off, STRING_LITERAL);
10865 when Pragma_Warnings => Warnings : begin
10867 Check_At_Least_N_Arguments (1);
10868 Check_No_Identifiers;
10871 Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
10874 -- One argument case
10876 if Arg_Count = 1 then
10878 -- On/Off one argument case was processed by parser
10880 if Nkind (Argx) = N_Identifier
10882 (Chars (Argx) = Name_On
10884 Chars (Argx) = Name_Off)
10888 -- One argument case must be ON/OFF or static string expr
10890 elsif not Is_Static_String_Expression (Arg1) then
10892 ("argument of pragma% must be On/Off or " &
10893 "static string expression", Arg2);
10895 -- One argument string expression case
10899 Lit : constant Node_Id := Expr_Value_S (Argx);
10900 Str : constant String_Id := Strval (Lit);
10901 Len : constant Nat := String_Length (Str);
10909 while J <= Len loop
10910 C := Get_String_Char (Str, J);
10911 OK := In_Character_Range (C);
10914 Chr := Get_Character (C);
10918 if J < Len and then Chr = '.' then
10920 C := Get_String_Char (Str, J);
10921 Chr := Get_Character (C);
10923 if not Set_Dot_Warning_Switch (Chr) then
10925 ("invalid warning switch character " &
10932 OK := Set_Warning_Switch (Chr);
10938 ("invalid warning switch character " & Chr,
10947 -- Two or more arguments (must be two)
10950 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
10951 Check_At_Most_N_Arguments (2);
10959 E_Id := Expression (Arg2);
10962 -- In the expansion of an inlined body, a reference to
10963 -- the formal may be wrapped in a conversion if the
10964 -- actual is a conversion. Retrieve the real entity name.
10966 if (In_Instance_Body
10967 or else In_Inlined_Body)
10968 and then Nkind (E_Id) = N_Unchecked_Type_Conversion
10970 E_Id := Expression (E_Id);
10973 -- Entity name case
10975 if Is_Entity_Name (E_Id) then
10976 E := Entity (E_Id);
10983 (E, (Chars (Expression (Arg1)) = Name_Off));
10985 if Is_Enumeration_Type (E) then
10989 Lit := First_Literal (E);
10990 while Present (Lit) loop
10991 Set_Warnings_Off (Lit);
10992 Next_Literal (Lit);
10997 exit when No (Homonym (E));
11002 -- Error if not entity or static string literal case
11004 elsif not Is_Static_String_Expression (Arg2) then
11006 ("second argument of pragma% must be entity " &
11007 "name or static string expression", Arg2);
11009 -- String literal case
11012 String_To_Name_Buffer
11013 (Strval (Expr_Value_S (Expression (Arg2))));
11015 -- Note on configuration pragma case: If this is a
11016 -- configuration pragma, then for an OFF pragma, we
11017 -- just set Config True in the call, which is all
11018 -- that needs to be done. For the case of ON, this
11019 -- is normally an error, unless it is canceling the
11020 -- effect of a previous OFF pragma in the same file.
11021 -- In any other case, an error will be signalled (ON
11022 -- with no matching OFF).
11024 if Chars (Argx) = Name_Off then
11025 Set_Specific_Warning_Off
11026 (Loc, Name_Buffer (1 .. Name_Len),
11027 Config => Is_Configuration_Pragma);
11029 elsif Chars (Argx) = Name_On then
11030 Set_Specific_Warning_On
11031 (Loc, Name_Buffer (1 .. Name_Len), Err);
11035 ("?pragma Warnings On with no " &
11036 "matching Warnings Off",
11046 -------------------
11047 -- Weak_External --
11048 -------------------
11050 -- pragma Weak_External ([Entity =>] LOCAL_NAME);
11052 when Pragma_Weak_External => Weak_External : declare
11057 Check_Arg_Count (1);
11058 Check_Optional_Identifier (Arg1, Name_Entity);
11059 Check_Arg_Is_Library_Level_Local_Name (Arg1);
11060 Ent := Entity (Expression (Arg1));
11062 if Rep_Item_Too_Early (Ent, N) then
11065 Ent := Underlying_Type (Ent);
11068 -- The only processing required is to link this item on to the
11069 -- list of rep items for the given entity. This is accomplished
11070 -- by the call to Rep_Item_Too_Late (when no error is detected
11071 -- and False is returned).
11073 if Rep_Item_Too_Late (Ent, N) then
11076 Set_Has_Gigi_Rep_Item (Ent);
11080 -----------------------------
11081 -- Wide_Character_Encoding --
11082 -----------------------------
11084 -- pragma Wide_Character_Encoding (IDENTIFIER);
11086 when Pragma_Wide_Character_Encoding =>
11088 -- Nothing to do, handled in parser. Note that we do not enforce
11089 -- configuration pragma placement, this pragma can appear at any
11090 -- place in the source, allowing mixed encodings within a single
11095 --------------------
11096 -- Unknown_Pragma --
11097 --------------------
11099 -- Should be impossible, since the case of an unknown pragma is
11100 -- separately processed before the case statement is entered.
11102 when Unknown_Pragma =>
11103 raise Program_Error;
11107 when Pragma_Exit => null;
11108 end Analyze_Pragma;
11110 ---------------------------------
11111 -- Delay_Config_Pragma_Analyze --
11112 ---------------------------------
11114 function Delay_Config_Pragma_Analyze (N : Node_Id) return Boolean is
11116 return Chars (N) = Name_Interrupt_State
11118 Chars (N) = Name_Priority_Specific_Dispatching;
11119 end Delay_Config_Pragma_Analyze;
11121 -------------------------
11122 -- Get_Base_Subprogram --
11123 -------------------------
11125 function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id is
11126 Result : Entity_Id;
11129 -- Follow subprogram renaming chain
11132 while Is_Subprogram (Result)
11134 (Is_Generic_Instance (Result)
11135 or else Nkind (Parent (Declaration_Node (Result))) =
11136 N_Subprogram_Renaming_Declaration)
11137 and then Present (Alias (Result))
11139 Result := Alias (Result);
11143 end Get_Base_Subprogram;
11145 -----------------------------
11146 -- Is_Config_Static_String --
11147 -----------------------------
11149 function Is_Config_Static_String (Arg : Node_Id) return Boolean is
11151 function Add_Config_Static_String (Arg : Node_Id) return Boolean;
11152 -- This is an internal recursive function that is just like the
11153 -- outer function except that it adds the string to the name buffer
11154 -- rather than placing the string in the name buffer.
11156 ------------------------------
11157 -- Add_Config_Static_String --
11158 ------------------------------
11160 function Add_Config_Static_String (Arg : Node_Id) return Boolean is
11167 if Nkind (N) = N_Op_Concat then
11168 if Add_Config_Static_String (Left_Opnd (N)) then
11169 N := Right_Opnd (N);
11175 if Nkind (N) /= N_String_Literal then
11176 Error_Msg_N ("string literal expected for pragma argument", N);
11180 for J in 1 .. String_Length (Strval (N)) loop
11181 C := Get_String_Char (Strval (N), J);
11183 if not In_Character_Range (C) then
11185 ("string literal contains invalid wide character",
11186 Sloc (N) + 1 + Source_Ptr (J));
11190 Add_Char_To_Name_Buffer (Get_Character (C));
11195 end Add_Config_Static_String;
11197 -- Start of prorcessing for Is_Config_Static_String
11202 return Add_Config_Static_String (Arg);
11203 end Is_Config_Static_String;
11205 -----------------------------------------
11206 -- Is_Non_Significant_Pragma_Reference --
11207 -----------------------------------------
11209 -- This function makes use of the following static table which indicates
11210 -- whether a given pragma is significant. A value of -1 in this table
11211 -- indicates that the reference is significant. A value of zero indicates
11212 -- than appearence as any argument is insignificant, a positive value
11213 -- indicates that appearence in that parameter position is significant.
11215 Sig_Flags : constant array (Pragma_Id) of Int :=
11217 (Pragma_AST_Entry => -1,
11218 Pragma_Abort_Defer => -1,
11219 Pragma_Ada_83 => -1,
11220 Pragma_Ada_95 => -1,
11221 Pragma_Ada_05 => -1,
11222 Pragma_Ada_2005 => -1,
11223 Pragma_All_Calls_Remote => -1,
11224 Pragma_Annotate => -1,
11225 Pragma_Assert => -1,
11226 Pragma_Assertion_Policy => 0,
11227 Pragma_Asynchronous => -1,
11228 Pragma_Atomic => 0,
11229 Pragma_Atomic_Components => 0,
11230 Pragma_Attach_Handler => -1,
11231 Pragma_Check_Name => 0,
11232 Pragma_CIL_Constructor => -1,
11233 Pragma_CPP_Class => 0,
11234 Pragma_CPP_Constructor => 0,
11235 Pragma_CPP_Virtual => 0,
11236 Pragma_CPP_Vtable => 0,
11237 Pragma_C_Pass_By_Copy => 0,
11238 Pragma_Comment => 0,
11239 Pragma_Common_Object => -1,
11240 Pragma_Compile_Time_Error => -1,
11241 Pragma_Compile_Time_Warning => -1,
11242 Pragma_Complete_Representation => 0,
11243 Pragma_Complex_Representation => 0,
11244 Pragma_Component_Alignment => -1,
11245 Pragma_Controlled => 0,
11246 Pragma_Convention => 0,
11247 Pragma_Convention_Identifier => 0,
11248 Pragma_Debug => -1,
11249 Pragma_Debug_Policy => 0,
11250 Pragma_Detect_Blocking => -1,
11251 Pragma_Discard_Names => 0,
11252 Pragma_Elaborate => -1,
11253 Pragma_Elaborate_All => -1,
11254 Pragma_Elaborate_Body => -1,
11255 Pragma_Elaboration_Checks => -1,
11256 Pragma_Eliminate => -1,
11257 Pragma_Export => -1,
11258 Pragma_Export_Exception => -1,
11259 Pragma_Export_Function => -1,
11260 Pragma_Export_Object => -1,
11261 Pragma_Export_Procedure => -1,
11262 Pragma_Export_Value => -1,
11263 Pragma_Export_Valued_Procedure => -1,
11264 Pragma_Extend_System => -1,
11265 Pragma_Extensions_Allowed => -1,
11266 Pragma_External => -1,
11267 Pragma_External_Name_Casing => -1,
11268 Pragma_Finalize_Storage_Only => 0,
11269 Pragma_Float_Representation => 0,
11270 Pragma_Ident => -1,
11271 Pragma_Implicit_Packing => 0,
11272 Pragma_Import => +2,
11273 Pragma_Import_Exception => 0,
11274 Pragma_Import_Function => 0,
11275 Pragma_Import_Object => 0,
11276 Pragma_Import_Procedure => 0,
11277 Pragma_Import_Valued_Procedure => 0,
11278 Pragma_Initialize_Scalars => -1,
11279 Pragma_Inline => 0,
11280 Pragma_Inline_Always => 0,
11281 Pragma_Inline_Generic => 0,
11282 Pragma_Inspection_Point => -1,
11283 Pragma_Interface => +2,
11284 Pragma_Interface_Name => +2,
11285 Pragma_Interrupt_Handler => -1,
11286 Pragma_Interrupt_Priority => -1,
11287 Pragma_Interrupt_State => -1,
11288 Pragma_Java_Constructor => -1,
11289 Pragma_Java_Interface => -1,
11290 Pragma_Keep_Names => 0,
11291 Pragma_License => -1,
11292 Pragma_Link_With => -1,
11293 Pragma_Linker_Alias => -1,
11294 Pragma_Linker_Constructor => -1,
11295 Pragma_Linker_Destructor => -1,
11296 Pragma_Linker_Options => -1,
11297 Pragma_Linker_Section => -1,
11299 Pragma_Locking_Policy => -1,
11300 Pragma_Long_Float => -1,
11301 Pragma_Machine_Attribute => -1,
11303 Pragma_Main_Storage => -1,
11304 Pragma_Memory_Size => -1,
11305 Pragma_No_Return => 0,
11306 Pragma_No_Body => 0,
11307 Pragma_No_Run_Time => -1,
11308 Pragma_No_Strict_Aliasing => -1,
11309 Pragma_Normalize_Scalars => -1,
11310 Pragma_Obsolescent => 0,
11311 Pragma_Optimize => -1,
11314 Pragma_Passive => -1,
11315 Pragma_Preelaborable_Initialization => -1,
11316 Pragma_Polling => -1,
11317 Pragma_Persistent_BSS => 0,
11318 Pragma_Preelaborate => -1,
11319 Pragma_Preelaborate_05 => -1,
11320 Pragma_Priority => -1,
11321 Pragma_Priority_Specific_Dispatching => -1,
11322 Pragma_Profile => 0,
11323 Pragma_Profile_Warnings => 0,
11324 Pragma_Propagate_Exceptions => -1,
11325 Pragma_Psect_Object => -1,
11327 Pragma_Pure_05 => -1,
11328 Pragma_Pure_Function => -1,
11329 Pragma_Queuing_Policy => -1,
11330 Pragma_Ravenscar => -1,
11331 Pragma_Remote_Call_Interface => -1,
11332 Pragma_Remote_Types => -1,
11333 Pragma_Restricted_Run_Time => -1,
11334 Pragma_Restriction_Warnings => -1,
11335 Pragma_Restrictions => -1,
11336 Pragma_Reviewable => -1,
11337 Pragma_Share_Generic => -1,
11338 Pragma_Shared => -1,
11339 Pragma_Shared_Passive => -1,
11340 Pragma_Source_File_Name => -1,
11341 Pragma_Source_File_Name_Project => -1,
11342 Pragma_Source_Reference => -1,
11343 Pragma_Storage_Size => -1,
11344 Pragma_Storage_Unit => -1,
11345 Pragma_Static_Elaboration_Desired => -1,
11346 Pragma_Stream_Convert => -1,
11347 Pragma_Style_Checks => -1,
11348 Pragma_Subtitle => -1,
11349 Pragma_Suppress => 0,
11350 Pragma_Suppress_Exception_Locations => 0,
11351 Pragma_Suppress_All => -1,
11352 Pragma_Suppress_Debug_Info => 0,
11353 Pragma_Suppress_Initialization => 0,
11354 Pragma_System_Name => -1,
11355 Pragma_Task_Dispatching_Policy => -1,
11356 Pragma_Task_Info => -1,
11357 Pragma_Task_Name => -1,
11358 Pragma_Task_Storage => 0,
11359 Pragma_Time_Slice => -1,
11360 Pragma_Title => -1,
11361 Pragma_Unchecked_Union => 0,
11362 Pragma_Unimplemented_Unit => -1,
11363 Pragma_Universal_Aliasing => -1,
11364 Pragma_Universal_Data => -1,
11365 Pragma_Unreferenced => -1,
11366 Pragma_Unreferenced_Objects => -1,
11367 Pragma_Unreserve_All_Interrupts => -1,
11368 Pragma_Unsuppress => 0,
11369 Pragma_Use_VADS_Size => -1,
11370 Pragma_Validity_Checks => -1,
11371 Pragma_Volatile => 0,
11372 Pragma_Volatile_Components => 0,
11373 Pragma_Warnings => -1,
11374 Pragma_Weak_External => -1,
11375 Pragma_Wide_Character_Encoding => 0,
11376 Unknown_Pragma => 0);
11378 function Is_Non_Significant_Pragma_Reference (N : Node_Id) return Boolean is
11386 if Nkind (P) /= N_Pragma_Argument_Association then
11390 C := Sig_Flags (Get_Pragma_Id (Chars (Parent (P))));
11400 A := First (Pragma_Argument_Associations (Parent (P)));
11401 for J in 1 .. C - 1 loop
11412 end Is_Non_Significant_Pragma_Reference;
11414 ------------------------------
11415 -- Is_Pragma_String_Literal --
11416 ------------------------------
11418 -- This function returns true if the corresponding pragma argument is
11419 -- a static string expression. These are the only cases in which string
11420 -- literals can appear as pragma arguments. We also allow a string
11421 -- literal as the first argument to pragma Assert (although it will
11422 -- of course always generate a type error).
11424 function Is_Pragma_String_Literal (Par : Node_Id) return Boolean is
11425 Pragn : constant Node_Id := Parent (Par);
11426 Assoc : constant List_Id := Pragma_Argument_Associations (Pragn);
11427 Pname : constant Name_Id := Chars (Pragn);
11433 N := First (Assoc);
11440 if Pname = Name_Assert then
11443 elsif Pname = Name_Export then
11446 elsif Pname = Name_Ident then
11449 elsif Pname = Name_Import then
11452 elsif Pname = Name_Interface_Name then
11455 elsif Pname = Name_Linker_Alias then
11458 elsif Pname = Name_Linker_Section then
11461 elsif Pname = Name_Machine_Attribute then
11464 elsif Pname = Name_Source_File_Name then
11467 elsif Pname = Name_Source_Reference then
11470 elsif Pname = Name_Title then
11473 elsif Pname = Name_Subtitle then
11479 end Is_Pragma_String_Literal;
11481 --------------------------------------
11482 -- Process_Compilation_Unit_Pragmas --
11483 --------------------------------------
11485 procedure Process_Compilation_Unit_Pragmas (N : Node_Id) is
11487 -- A special check for pragma Suppress_All. This is a strange DEC
11488 -- pragma, strange because it comes at the end of the unit. If we
11489 -- have a pragma Suppress_All in the Pragmas_After of the current
11490 -- unit, then we insert a pragma Suppress (All_Checks) at the start
11491 -- of the context clause to ensure the correct processing.
11494 PA : constant List_Id := Pragmas_After (Aux_Decls_Node (N));
11498 if Present (PA) then
11500 while Present (P) loop
11501 if Chars (P) = Name_Suppress_All then
11502 Prepend_To (Context_Items (N),
11503 Make_Pragma (Sloc (P),
11504 Chars => Name_Suppress,
11505 Pragma_Argument_Associations => New_List (
11506 Make_Pragma_Argument_Association (Sloc (P),
11508 Make_Identifier (Sloc (P),
11509 Chars => Name_All_Checks)))));
11517 end Process_Compilation_Unit_Pragmas;
11528 --------------------------------
11529 -- Set_Encoded_Interface_Name --
11530 --------------------------------
11532 procedure Set_Encoded_Interface_Name (E : Entity_Id; S : Node_Id) is
11533 Str : constant String_Id := Strval (S);
11534 Len : constant Int := String_Length (Str);
11539 Hex : constant array (0 .. 15) of Character := "0123456789abcdef";
11542 -- Stores encoded value of character code CC. The encoding we
11543 -- use an underscore followed by four lower case hex digits.
11549 procedure Encode is
11551 Store_String_Char (Get_Char_Code ('_'));
11553 (Get_Char_Code (Hex (Integer (CC / 2 ** 12))));
11555 (Get_Char_Code (Hex (Integer (CC / 2 ** 8 and 16#0F#))));
11557 (Get_Char_Code (Hex (Integer (CC / 2 ** 4 and 16#0F#))));
11559 (Get_Char_Code (Hex (Integer (CC and 16#0F#))));
11562 -- Start of processing for Set_Encoded_Interface_Name
11565 -- If first character is asterisk, this is a link name, and we
11566 -- leave it completely unmodified. We also ignore null strings
11567 -- (the latter case happens only in error cases) and no encoding
11568 -- should occur for Java or AAMP interface names.
11571 or else Get_String_Char (Str, 1) = Get_Char_Code ('*')
11572 or else VM_Target /= No_VM
11573 or else AAMP_On_Target
11575 Set_Interface_Name (E, S);
11580 CC := Get_String_Char (Str, J);
11582 exit when not In_Character_Range (CC);
11584 C := Get_Character (CC);
11586 exit when C /= '_' and then C /= '$'
11587 and then C not in '0' .. '9'
11588 and then C not in 'a' .. 'z'
11589 and then C not in 'A' .. 'Z';
11592 Set_Interface_Name (E, S);
11600 -- Here we need to encode. The encoding we use as follows:
11601 -- three underscores + four hex digits (lower case)
11605 for J in 1 .. String_Length (Str) loop
11606 CC := Get_String_Char (Str, J);
11608 if not In_Character_Range (CC) then
11611 C := Get_Character (CC);
11613 if C = '_' or else C = '$'
11614 or else C in '0' .. '9'
11615 or else C in 'a' .. 'z'
11616 or else C in 'A' .. 'Z'
11618 Store_String_Char (CC);
11625 Set_Interface_Name (E,
11626 Make_String_Literal (Sloc (S),
11627 Strval => End_String));
11629 end Set_Encoded_Interface_Name;
11631 -------------------
11632 -- Set_Unit_Name --
11633 -------------------
11635 procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id) is
11640 if Nkind (N) = N_Identifier
11641 and then Nkind (With_Item) = N_Identifier
11643 Set_Entity (N, Entity (With_Item));
11645 elsif Nkind (N) = N_Selected_Component then
11646 Change_Selected_Component_To_Expanded_Name (N);
11647 Set_Entity (N, Entity (With_Item));
11648 Set_Entity (Selector_Name (N), Entity (N));
11650 Pref := Prefix (N);
11651 Scop := Scope (Entity (N));
11652 while Nkind (Pref) = N_Selected_Component loop
11653 Change_Selected_Component_To_Expanded_Name (Pref);
11654 Set_Entity (Selector_Name (Pref), Scop);
11655 Set_Entity (Pref, Scop);
11656 Pref := Prefix (Pref);
11657 Scop := Scope (Scop);
11660 Set_Entity (Pref, Scop);