gcc/ada/sem_prag.adb

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT COMPILER COMPONENTS                         --
   4 --                                                                          --
   5 --                             S E M _ P R A G                              --
   6 --                                                                          --
   7 --                                 B o d y                                  --
   8 --                                                                          --
   9 --          Copyright (C) 1992-2010, Free Software Foundation, Inc.         --
  10 --                                                                          --
  11 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  12 -- terms of the  GNU General Public License as published  by the Free Soft- --
  13 -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
  14 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  15 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  16 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  17 -- for  more details.  You should have  received  a copy of the GNU General --
  18 -- Public License  distributed with GNAT; see file COPYING3.  If not, go to --
  19 -- http://www.gnu.org/licenses for a complete copy of the license.          --
  20 --                                                                          --
  21 -- GNAT was originally developed  by the GNAT team at  New York University. --
  22 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  23 --                                                                          --
  24 ------------------------------------------------------------------------------
  25
  26 --  This unit contains the semantic processing for all pragmas, both language
  27 --  and implementation defined. For most pragmas, the parser only does the
  28 --  most basic job of checking the syntax, so Sem_Prag also contains the code
  29 --  to complete the syntax checks. Certain pragmas are handled partially or
  30 --  completely by the parser (see Par.Prag for further details).
  31
  32 with Atree;    use Atree;
  33 with Casing;   use Casing;
  34 with Checks;   use Checks;
  35 with Csets;    use Csets;
  36 with Debug;    use Debug;
  37 with Einfo;    use Einfo;
  38 with Elists;   use Elists;
  39 with Errout;   use Errout;
  40 with Exp_Ch7;  use Exp_Ch7;
  41 with Exp_Dist; use Exp_Dist;
  42 with Lib;      use Lib;
  43 with Lib.Writ; use Lib.Writ;
  44 with Lib.Xref; use Lib.Xref;
  45 with Namet.Sp; use Namet.Sp;
  46 with Nlists;   use Nlists;
  47 with Nmake;    use Nmake;
  48 with Opt;      use Opt;
  49 with Output;   use Output;
  50 with Par_SCO;  use Par_SCO;
  51 with Restrict; use Restrict;
  52 with Rident;   use Rident;
  53 with Rtsfind;  use Rtsfind;
  54 with Sem;      use Sem;
  55 with Sem_Aux;  use Sem_Aux;
  56 with Sem_Ch3;  use Sem_Ch3;
  57 with Sem_Ch6;  use Sem_Ch6;
  58 with Sem_Ch8;  use Sem_Ch8;
  59 with Sem_Ch12; use Sem_Ch12;
  60 with Sem_Ch13; use Sem_Ch13;
  61 with Sem_Dist; use Sem_Dist;
  62 with Sem_Elim; use Sem_Elim;
  63 with Sem_Eval; use Sem_Eval;
  64 with Sem_Intr; use Sem_Intr;
  65 with Sem_Mech; use Sem_Mech;
  66 with Sem_Res;  use Sem_Res;
  67 with Sem_Type; use Sem_Type;
  68 with Sem_Util; use Sem_Util;
  69 with Sem_VFpt; use Sem_VFpt;
  70 with Sem_Warn; use Sem_Warn;
  71 with Stand;    use Stand;
  72 with Sinfo;    use Sinfo;
  73 with Sinfo.CN; use Sinfo.CN;
  74 with Sinput;   use Sinput;
  75 with Snames;   use Snames;
  76 with Stringt;  use Stringt;
  77 with Stylesw;  use Stylesw;
  78 with Table;
  79 with Targparm; use Targparm;
  80 with Tbuild;   use Tbuild;
  81 with Ttypes;
  82 with Uintp;    use Uintp;
  83 with Uname;    use Uname;
  84 with Urealp;   use Urealp;
  85 with Validsw;  use Validsw;
  86
  87 package body Sem_Prag is
  88
  89    ----------------------------------------------
  90    -- Common Handling of Import-Export Pragmas --
  91    ----------------------------------------------
  92
  93    --  In the following section, a number of Import_xxx and Export_xxx
  94    --  pragmas are defined by GNAT. These are compatible with the DEC
  95    --  pragmas of the same name, and all have the following common
  96    --  form and processing:
  97
  98    --  pragma Export_xxx
  99    --        [Internal                 =>] LOCAL_NAME
 100    --     [, [External                 =>] EXTERNAL_SYMBOL]
 101    --     [, other optional parameters   ]);
 102
 103    --  pragma Import_xxx
 104    --        [Internal                 =>] LOCAL_NAME
 105    --     [, [External                 =>] EXTERNAL_SYMBOL]
 106    --     [, other optional parameters   ]);
 107
 108    --   EXTERNAL_SYMBOL ::=
 109    --     IDENTIFIER
 110    --   | static_string_EXPRESSION
 111
 112    --  The internal LOCAL_NAME designates the entity that is imported or
 113    --  exported, and must refer to an entity in the current declarative
 114    --  part (as required by the rules for LOCAL_NAME).
 115
 116    --  The external linker name is designated by the External parameter if
 117    --  given, or the Internal parameter if not (if there is no External
 118    --  parameter, the External parameter is a copy of the Internal name).
 119
 120    --  If the External parameter is given as a string, then this string is
 121    --  treated as an external name (exactly as though it had been given as an
 122    --  External_Name parameter for a normal Import pragma).
 123
 124    --  If the External parameter is given as an identifier (or there is no
 125    --  External parameter, so that the Internal identifier is used), then
 126    --  the external name is the characters of the identifier, translated
 127    --  to all upper case letters for OpenVMS versions of GNAT, and to all
 128    --  lower case letters for all other versions
 129
 130    --  Note: the external name specified or implied by any of these special
 131    --  Import_xxx or Export_xxx pragmas override an external or link name
 132    --  specified in a previous Import or Export pragma.
 133
 134    --  Note: these and all other DEC-compatible GNAT pragmas allow full use of
 135    --  named notation, following the standard rules for subprogram calls, i.e.
 136    --  parameters can be given in any order if named notation is used, and
 137    --  positional and named notation can be mixed, subject to the rule that all
 138    --  positional parameters must appear first.
 139
 140    --  Note: All these pragmas are implemented exactly following the DEC design
 141    --  and implementation and are intended to be fully compatible with the use
 142    --  of these pragmas in the DEC Ada compiler.
 143
 144    --------------------------------------------
 145    -- Checking for Duplicated External Names --
 146    --------------------------------------------
 147
 148    --  It is suspicious if two separate Export pragmas use the same external
 149    --  name. The following table is used to diagnose this situation so that
 150    --  an appropriate warning can be issued.
 151
 152    --  The Node_Id stored is for the N_String_Literal node created to hold
 153    --  the value of the external name. The Sloc of this node is used to
 154    --  cross-reference the location of the duplication.
 155
 156    package Externals is new Table.Table (
 157      Table_Component_Type => Node_Id,
 158      Table_Index_Type     => Int,
 159      Table_Low_Bound      => 0,
 160      Table_Initial        => 100,
 161      Table_Increment      => 100,
 162      Table_Name           => "Name_Externals");
 163
 164    -------------------------------------
 165    -- Local Subprograms and Variables --
 166    -------------------------------------
 167
 168    function Adjust_External_Name_Case (N : Node_Id) return Node_Id;
 169    --  This routine is used for possible casing adjustment of an explicit
 170    --  external name supplied as a string literal (the node N), according to
 171    --  the casing requirement of Opt.External_Name_Casing. If this is set to
 172    --  As_Is, then the string literal is returned unchanged, but if it is set
 173    --  to Uppercase or Lowercase, then a new string literal with appropriate
 174    --  casing is constructed.
 175
 176    function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id;
 177    --  If Def_Id refers to a renamed subprogram, then the base subprogram (the
 178    --  original one, following the renaming chain) is returned. Otherwise the
 179    --  entity is returned unchanged. Should be in Einfo???
 180
 181    function Get_Pragma_Arg (Arg : Node_Id) return Node_Id;
 182    --  All the routines that check pragma arguments take either a pragma
 183    --  argument association (in which case the expression of the argument
 184    --  association is checked), or the expression directly. The function
 185    --  Get_Pragma_Arg is a utility used to deal with these two cases. If Arg
 186    --  is a pragma argument association node, then its expression is returned,
 187    --  otherwise Arg is returned unchanged.
 188
 189    procedure rv;
 190    --  This is a dummy function called by the processing for pragma Reviewable.
 191    --  It is there for assisting front end debugging. By placing a Reviewable
 192    --  pragma in the source program, a breakpoint on rv catches this place in
 193    --  the source, allowing convenient stepping to the point of interest.
 194
 195    procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id);
 196    --  Place semantic information on the argument of an Elaborate/Elaborate_All
 197    --  pragma. Entity name for unit and its parents is taken from item in
 198    --  previous with_clause that mentions the unit.
 199
 200    -------------------------------
 201    -- Adjust_External_Name_Case --
 202    -------------------------------
 203
 204    function Adjust_External_Name_Case (N : Node_Id) return Node_Id is
 205       CC : Char_Code;
 206
 207    begin
 208       --  Adjust case of literal if required
 209
 210       if Opt.External_Name_Exp_Casing = As_Is then
 211          return N;
 212
 213       else
 214          --  Copy existing string
 215
 216          Start_String;
 217
 218          --  Set proper casing
 219
 220          for J in 1 .. String_Length (Strval (N)) loop
 221             CC := Get_String_Char (Strval (N), J);
 222
 223             if Opt.External_Name_Exp_Casing = Uppercase
 224               and then CC >= Get_Char_Code ('a')
 225               and then CC <= Get_Char_Code ('z')
 226             then
 227                Store_String_Char (CC - 32);
 228
 229             elsif Opt.External_Name_Exp_Casing = Lowercase
 230               and then CC >= Get_Char_Code ('A')
 231               and then CC <= Get_Char_Code ('Z')
 232             then
 233                Store_String_Char (CC + 32);
 234
 235             else
 236                Store_String_Char (CC);
 237             end if;
 238          end loop;
 239
 240          return
 241            Make_String_Literal (Sloc (N),
 242              Strval => End_String);
 243       end if;
 244    end Adjust_External_Name_Case;
 245
 246    ------------------------------
 247    -- Analyze_PPC_In_Decl_Part --
 248    ------------------------------
 249
 250    procedure Analyze_PPC_In_Decl_Part (N : Node_Id; S : Entity_Id) is
 251       Arg1 : constant Node_Id :=
 252                First (Pragma_Argument_Associations (N));
 253       Arg2 : constant Node_Id := Next (Arg1);
 254
 255    begin
 256       --  Install formals and push subprogram spec onto scope stack so that we
 257       --  can see the formals from the pragma.
 258
 259       Install_Formals (S);
 260       Push_Scope (S);
 261
 262       --  Preanalyze the boolean expression, we treat this as a spec expression
 263       --  (i.e. similar to a default expression).
 264
 265       Preanalyze_Spec_Expression
 266         (Get_Pragma_Arg (Arg1), Standard_Boolean);
 267
 268       --  If there is a message argument, analyze it the same way
 269
 270       if Present (Arg2) then
 271          Preanalyze_Spec_Expression
 272            (Get_Pragma_Arg (Arg2), Standard_String);
 273       end if;
 274
 275       --  Remove the subprogram from the scope stack now that the pre-analysis
 276       --  of the precondition/postcondition is done.
 277
 278       End_Scope;
 279    end Analyze_PPC_In_Decl_Part;
 280
 281    --------------------
 282    -- Analyze_Pragma --
 283    --------------------
 284
 285    procedure Analyze_Pragma (N : Node_Id) is
 286       Loc     : constant Source_Ptr := Sloc (N);
 287       Pname   : constant Name_Id    := Pragma_Name (N);
 288       Prag_Id : Pragma_Id;
 289
 290       Pragma_Exit : exception;
 291       --  This exception is used to exit pragma processing completely. It is
 292       --  used when an error is detected, and no further processing is
 293       --  required. It is also used if an earlier error has left the tree in
 294       --  a state where the pragma should not be processed.
 295
 296       Arg_Count : Nat;
 297       --  Number of pragma argument associations
 298
 299       Arg1 : Node_Id;
 300       Arg2 : Node_Id;
 301       Arg3 : Node_Id;
 302       Arg4 : Node_Id;
 303       --  First four pragma arguments (pragma argument association nodes, or
 304       --  Empty if the corresponding argument does not exist).
 305
 306       type Name_List is array (Natural range <>) of Name_Id;
 307       type Args_List is array (Natural range <>) of Node_Id;
 308       --  Types used for arguments to Check_Arg_Order and Gather_Associations
 309
 310       procedure Ada_2005_Pragma;
 311       --  Called for pragmas defined in Ada 2005, that are not in Ada 95. In
 312       --  Ada 95 mode, these are implementation defined pragmas, so should be
 313       --  caught by the No_Implementation_Pragmas restriction
 314
 315       procedure Check_Ada_83_Warning;
 316       --  Issues a warning message for the current pragma if operating in Ada
 317       --  83 mode (used for language pragmas that are not a standard part of
 318       --  Ada 83). This procedure does not raise Error_Pragma. Also notes use
 319       --  of 95 pragma.
 320
 321       procedure Check_Arg_Count (Required : Nat);
 322       --  Check argument count for pragma is equal to given parameter. If not,
 323       --  then issue an error message and raise Pragma_Exit.
 324
 325       --  Note: all routines whose name is Check_Arg_Is_xxx take an argument
 326       --  Arg which can either be a pragma argument association, in which case
 327       --  the check is applied to the expression of the association or an
 328       --  expression directly.
 329
 330       procedure Check_Arg_Is_External_Name (Arg : Node_Id);
 331       --  Check that an argument has the right form for an EXTERNAL_NAME
 332       --  parameter of an extended import/export pragma. The rule is that the
 333       --  name must be an identifier or string literal (in Ada 83 mode) or a
 334       --  static string expression (in Ada 95 mode).
 335
 336       procedure Check_Arg_Is_Identifier (Arg : Node_Id);
 337       --  Check the specified argument Arg to make sure that it is an
 338       --  identifier. If not give error and raise Pragma_Exit.
 339
 340       procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id);
 341       --  Check the specified argument Arg to make sure that it is an integer
 342       --  literal. If not give error and raise Pragma_Exit.
 343
 344       procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id);
 345       --  Check the specified argument Arg to make sure that it has the proper
 346       --  syntactic form for a local name and meets the semantic requirements
 347       --  for a local name. The local name is analyzed as part of the
 348       --  processing for this call. In addition, the local name is required
 349       --  to represent an entity at the library level.
 350
 351       procedure Check_Arg_Is_Local_Name (Arg : Node_Id);
 352       --  Check the specified argument Arg to make sure that it has the proper
 353       --  syntactic form for a local name and meets the semantic requirements
 354       --  for a local name. The local name is analyzed as part of the
 355       --  processing for this call.
 356
 357       procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id);
 358       --  Check the specified argument Arg to make sure that it is a valid
 359       --  locking policy name. If not give error and raise Pragma_Exit.
 360
 361       procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id);
 362       procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2, N3 : Name_Id);
 363       procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2, N3, N4 : Name_Id);
 364       --  Check the specified argument Arg to make sure that it is an
 365       --  identifier whose name matches either N1 or N2 (or N3 if present).
 366       --  If not then give error and raise Pragma_Exit.
 367
 368       procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id);
 369       --  Check the specified argument Arg to make sure that it is a valid
 370       --  queuing policy name. If not give error and raise Pragma_Exit.
 371
 372       procedure Check_Arg_Is_Static_Expression
 373         (Arg : Node_Id;
 374          Typ : Entity_Id := Empty);
 375       --  Check the specified argument Arg to make sure that it is a static
 376       --  expression of the given type (i.e. it will be analyzed and resolved
 377       --  using this type, which can be any valid argument to Resolve, e.g.
 378       --  Any_Integer is OK). If not, given error and raise Pragma_Exit. If
 379       --  Typ is left Empty, then any static expression is allowed.
 380
 381       procedure Check_Arg_Is_Task_Dispatching_Policy (Arg : Node_Id);
 382       --  Check the specified argument Arg to make sure that it is a valid task
 383       --  dispatching policy name. If not give error and raise Pragma_Exit.
 384
 385       procedure Check_Arg_Order (Names : Name_List);
 386       --  Checks for an instance of two arguments with identifiers for the
 387       --  current pragma which are not in the sequence indicated by Names,
 388       --  and if so, generates a fatal message about bad order of arguments.
 389
 390       procedure Check_At_Least_N_Arguments (N : Nat);
 391       --  Check there are at least N arguments present
 392
 393       procedure Check_At_Most_N_Arguments (N : Nat);
 394       --  Check there are no more than N arguments present
 395
 396       procedure Check_Component
 397         (Comp            : Node_Id;
 398          UU_Typ          : Entity_Id;
 399          In_Variant_Part : Boolean := False);
 400       --  Examine an Unchecked_Union component for correct use of per-object
 401       --  constrained subtypes, and for restrictions on finalizable components.
 402       --  UU_Typ is the related Unchecked_Union type. Flag In_Variant_Part
 403       --  should be set when Comp comes from a record variant.
 404
 405       procedure Check_Duplicated_Export_Name (Nam : Node_Id);
 406       --  Nam is an N_String_Literal node containing the external name set by
 407       --  an Import or Export pragma (or extended Import or Export pragma).
 408       --  This procedure checks for possible duplications if this is the export
 409       --  case, and if found, issues an appropriate error message.
 410
 411       procedure Check_First_Subtype (Arg : Node_Id);
 412       --  Checks that Arg, whose expression is an entity name referencing a
 413       --  subtype, does not reference a type that is not a first subtype.
 414
 415       procedure Check_In_Main_Program;
 416       --  Common checks for pragmas that appear within a main program
 417       --  (Priority, Main_Storage, Time_Slice, Relative_Deadline).
 418
 419       procedure Check_Interrupt_Or_Attach_Handler;
 420       --  Common processing for first argument of pragma Interrupt_Handler or
 421       --  pragma Attach_Handler.
 422
 423       procedure Check_Is_In_Decl_Part_Or_Package_Spec;
 424       --  Check that pragma appears in a declarative part, or in a package
 425       --  specification, i.e. that it does not occur in a statement sequence
 426       --  in a body.
 427
 428       procedure Check_No_Identifier (Arg : Node_Id);
 429       --  Checks that the given argument does not have an identifier. If
 430       --  an identifier is present, then an error message is issued, and
 431       --  Pragma_Exit is raised.
 432
 433       procedure Check_No_Identifiers;
 434       --  Checks that none of the arguments to the pragma has an identifier.
 435       --  If any argument has an identifier, then an error message is issued,
 436       --  and Pragma_Exit is raised.
 437
 438       procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id);
 439       --  Checks if the given argument has an identifier, and if so, requires
 440       --  it to match the given identifier name. If there is a non-matching
 441       --  identifier, then an error message is given and Error_Pragmas raised.
 442
 443       procedure Check_Optional_Identifier (Arg : Node_Id; Id : String);
 444       --  Checks if the given argument has an identifier, and if so, requires
 445       --  it to match the given identifier name. If there is a non-matching
 446       --  identifier, then an error message is given and Error_Pragmas raised.
 447       --  In this version of the procedure, the identifier name is given as
 448       --  a string with lower case letters.
 449
 450       procedure Check_Precondition_Postcondition (In_Body : out Boolean);
 451       --  Called to process a precondition or postcondition pragma. There are
 452       --  three cases:
 453       --
 454       --    The pragma appears after a subprogram spec
 455       --
 456       --      If the corresponding check is not enabled, the pragma is analyzed
 457       --      but otherwise ignored and control returns with In_Body set False.
 458       --
 459       --      If the check is enabled, then the first step is to analyze the
 460       --      pragma, but this is skipped if the subprogram spec appears within
 461       --      a package specification (because this is the case where we delay
 462       --      analysis till the end of the spec). Then (whether or not it was
 463       --      analyzed), the pragma is chained to the subprogram in question
 464       --      (using Spec_PPC_List and Next_Pragma) and control returns to the
 465       --      caller with In_Body set False.
 466       --
 467       --    The pragma appears at the start of subprogram body declarations
 468       --
 469       --      In this case an immediate return to the caller is made with
 470       --      In_Body set True, and the pragma is NOT analyzed.
 471       --
 472       --    In all other cases, an error message for bad placement is given
 473
 474       procedure Check_Static_Constraint (Constr : Node_Id);
 475       --  Constr is a constraint from an N_Subtype_Indication node from a
 476       --  component constraint in an Unchecked_Union type. This routine checks
 477       --  that the constraint is static as required by the restrictions for
 478       --  Unchecked_Union.
 479
 480       procedure Check_Valid_Configuration_Pragma;
 481       --  Legality checks for placement of a configuration pragma
 482
 483       procedure Check_Valid_Library_Unit_Pragma;
 484       --  Legality checks for library unit pragmas. A special case arises for
 485       --  pragmas in generic instances that come from copies of the original
 486       --  library unit pragmas in the generic templates. In the case of other
 487       --  than library level instantiations these can appear in contexts which
 488       --  would normally be invalid (they only apply to the original template
 489       --  and to library level instantiations), and they are simply ignored,
 490       --  which is implemented by rewriting them as null statements.
 491
 492       procedure Check_Variant (Variant : Node_Id; UU_Typ : Entity_Id);
 493       --  Check an Unchecked_Union variant for lack of nested variants and
 494       --  presence of at least one component. UU_Typ is the related Unchecked_
 495       --  Union type.
 496
 497       procedure Error_Pragma (Msg : String);
 498       pragma No_Return (Error_Pragma);
 499       --  Outputs error message for current pragma. The message contains a %
 500       --  that will be replaced with the pragma name, and the flag is placed
 501       --  on the pragma itself. Pragma_Exit is then raised.
 502
 503       procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id);
 504       pragma No_Return (Error_Pragma_Arg);
 505       --  Outputs error message for current pragma. The message may contain
 506       --  a % that will be replaced with the pragma name. The parameter Arg
 507       --  may either be a pragma argument association, in which case the flag
 508       --  is placed on the expression of this association, or an expression,
 509       --  in which case the flag is placed directly on the expression. The
 510       --  message is placed using Error_Msg_N, so the message may also contain
 511       --  an & insertion character which will reference the given Arg value.
 512       --  After placing the message, Pragma_Exit is raised.
 513
 514       procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id);
 515       pragma No_Return (Error_Pragma_Arg);
 516       --  Similar to above form of Error_Pragma_Arg except that two messages
 517       --  are provided, the second is a continuation comment starting with \.
 518
 519       procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id);
 520       pragma No_Return (Error_Pragma_Arg_Ident);
 521       --  Outputs error message for current pragma. The message may contain
 522       --  a % that will be replaced with the pragma name. The parameter Arg
 523       --  must be a pragma argument association with a non-empty identifier
 524       --  (i.e. its Chars field must be set), and the error message is placed
 525       --  on the identifier. The message is placed using Error_Msg_N so
 526       --  the message may also contain an & insertion character which will
 527       --  reference the identifier. After placing the message, Pragma_Exit
 528       --  is raised.
 529
 530       procedure Error_Pragma_Ref (Msg : String; Ref : Entity_Id);
 531       pragma No_Return (Error_Pragma_Ref);
 532       --  Outputs error message for current pragma. The message may contain
 533       --  a % that will be replaced with the pragma name. The parameter Ref
 534       --  must be an entity whose name can be referenced by & and sloc by #.
 535       --  After placing the message, Pragma_Exit is raised.
 536
 537       function Find_Lib_Unit_Name return Entity_Id;
 538       --  Used for a library unit pragma to find the entity to which the
 539       --  library unit pragma applies, returns the entity found.
 540
 541       procedure Find_Program_Unit_Name (Id : Node_Id);
 542       --  If the pragma is a compilation unit pragma, the id must denote the
 543       --  compilation unit in the same compilation, and the pragma must appear
 544       --  in the list of preceding or trailing pragmas. If it is a program
 545       --  unit pragma that is not a compilation unit pragma, then the
 546       --  identifier must be visible.
 547
 548       function Find_Unique_Parameterless_Procedure
 549         (Name : Entity_Id;
 550          Arg  : Node_Id) return Entity_Id;
 551       --  Used for a procedure pragma to find the unique parameterless
 552       --  procedure identified by Name, returns it if it exists, otherwise
 553       --  errors out and uses Arg as the pragma argument for the message.
 554
 555       procedure Gather_Associations
 556         (Names : Name_List;
 557          Args  : out Args_List);
 558       --  This procedure is used to gather the arguments for a pragma that
 559       --  permits arbitrary ordering of parameters using the normal rules
 560       --  for named and positional parameters. The Names argument is a list
 561       --  of Name_Id values that corresponds to the allowed pragma argument
 562       --  association identifiers in order. The result returned in Args is
 563       --  a list of corresponding expressions that are the pragma arguments.
 564       --  Note that this is a list of expressions, not of pragma argument
 565       --  associations (Gather_Associations has completely checked all the
 566       --  optional identifiers when it returns). An entry in Args is Empty
 567       --  on return if the corresponding argument is not present.
 568
 569       procedure GNAT_Pragma;
 570       --  Called for all GNAT defined pragmas to check the relevant restriction
 571       --  (No_Implementation_Pragmas).
 572
 573       function Is_Before_First_Decl
 574         (Pragma_Node : Node_Id;
 575          Decls       : List_Id) return Boolean;
 576       --  Return True if Pragma_Node is before the first declarative item in
 577       --  Decls where Decls is the list of declarative items.
 578
 579       function Is_Configuration_Pragma return Boolean;
 580       --  Determines if the placement of the current pragma is appropriate
 581       --  for a configuration pragma.
 582
 583       function Is_In_Context_Clause return Boolean;
 584       --  Returns True if pragma appears within the context clause of a unit,
 585       --  and False for any other placement (does not generate any messages).
 586
 587       function Is_Static_String_Expression (Arg : Node_Id) return Boolean;
 588       --  Analyzes the argument, and determines if it is a static string
 589       --  expression, returns True if so, False if non-static or not String.
 590
 591       procedure Pragma_Misplaced;
 592       pragma No_Return (Pragma_Misplaced);
 593       --  Issue fatal error message for misplaced pragma
 594
 595       procedure Process_Atomic_Shared_Volatile;
 596       --  Common processing for pragmas Atomic, Shared, Volatile. Note that
 597       --  Shared is an obsolete Ada 83 pragma, treated as being identical
 598       --  in effect to pragma Atomic.
 599
 600       procedure Process_Compile_Time_Warning_Or_Error;
 601       --  Common processing for Compile_Time_Error and Compile_Time_Warning
 602
 603       procedure Process_Convention
 604         (C   : out Convention_Id;
 605          Ent : out Entity_Id);
 606       --  Common processing for Convention, Interface, Import and Export.
 607       --  Checks first two arguments of pragma, and sets the appropriate
 608       --  convention value in the specified entity or entities. On return
 609       --  C is the convention, Ent is the referenced entity.
 610
 611       procedure Process_Extended_Import_Export_Exception_Pragma
 612         (Arg_Internal : Node_Id;
 613          Arg_External : Node_Id;
 614          Arg_Form     : Node_Id;
 615          Arg_Code     : Node_Id);
 616       --  Common processing for the pragmas Import/Export_Exception. The three
 617       --  arguments correspond to the three named parameters of the pragma. An
 618       --  argument is empty if the corresponding parameter is not present in
 619       --  the pragma.
 620
 621       procedure Process_Extended_Import_Export_Object_Pragma
 622         (Arg_Internal : Node_Id;
 623          Arg_External : Node_Id;
 624          Arg_Size     : Node_Id);
 625       --  Common processing for the pragmas Import/Export_Object. The three
 626       --  arguments correspond to the three named parameters of the pragmas. An
 627       --  argument is empty if the corresponding parameter is not present in
 628       --  the pragma.
 629
 630       procedure Process_Extended_Import_Export_Internal_Arg
 631         (Arg_Internal : Node_Id := Empty);
 632       --  Common processing for all extended Import and Export pragmas. The
 633       --  argument is the pragma parameter for the Internal argument. If
 634       --  Arg_Internal is empty or inappropriate, an error message is posted.
 635       --  Otherwise, on normal return, the Entity_Field of Arg_Internal is
 636       --  set to identify the referenced entity.
 637
 638       procedure Process_Extended_Import_Export_Subprogram_Pragma
 639         (Arg_Internal                 : Node_Id;
 640          Arg_External                 : Node_Id;
 641          Arg_Parameter_Types          : Node_Id;
 642          Arg_Result_Type              : Node_Id := Empty;
 643          Arg_Mechanism                : Node_Id;
 644          Arg_Result_Mechanism         : Node_Id := Empty;
 645          Arg_First_Optional_Parameter : Node_Id := Empty);
 646       --  Common processing for all extended Import and Export pragmas applying
 647       --  to subprograms. The caller omits any arguments that do not apply to
 648       --  the pragma in question (for example, Arg_Result_Type can be non-Empty
 649       --  only in the Import_Function and Export_Function cases). The argument
 650       --  names correspond to the allowed pragma association identifiers.
 651
 652       procedure Process_Generic_List;
 653       --  Common processing for Share_Generic and Inline_Generic
 654
 655       procedure Process_Import_Or_Interface;
 656       --  Common processing for Import of Interface
 657
 658       procedure Process_Inline (Active : Boolean);
 659       --  Common processing for Inline and Inline_Always. The parameter
 660       --  indicates if the inline pragma is active, i.e. if it should actually
 661       --  cause inlining to occur.
 662
 663       procedure Process_Interface_Name
 664         (Subprogram_Def : Entity_Id;
 665          Ext_Arg        : Node_Id;
 666          Link_Arg       : Node_Id);
 667       --  Given the last two arguments of pragma Import, pragma Export, or
 668       --  pragma Interface_Name, performs validity checks and sets the
 669       --  Interface_Name field of the given subprogram entity to the
 670       --  appropriate external or link name, depending on the arguments given.
 671       --  Ext_Arg is always present, but Link_Arg may be missing. Note that
 672       --  Ext_Arg may represent the Link_Name if Link_Arg is missing, and
 673       --  appropriate named notation is used for Ext_Arg. If neither Ext_Arg
 674       --  nor Link_Arg is present, the interface name is set to the default
 675       --  from the subprogram name.
 676
 677       procedure Process_Interrupt_Or_Attach_Handler;
 678       --  Common processing for Interrupt and Attach_Handler pragmas
 679
 680       procedure Process_Restrictions_Or_Restriction_Warnings (Warn : Boolean);
 681       --  Common processing for Restrictions and Restriction_Warnings pragmas.
 682       --  Warn is True for Restriction_Warnings, or for Restrictions if the
 683       --  flag Treat_Restrictions_As_Warnings is set, and False if this flag
 684       --  is not set in the Restrictions case.
 685
 686       procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean);
 687       --  Common processing for Suppress and Unsuppress. The boolean parameter
 688       --  Suppress_Case is True for the Suppress case, and False for the
 689       --  Unsuppress case.
 690
 691       procedure Set_Exported (E : Entity_Id; Arg : Node_Id);
 692       --  This procedure sets the Is_Exported flag for the given entity,
 693       --  checking that the entity was not previously imported. Arg is
 694       --  the argument that specified the entity. A check is also made
 695       --  for exporting inappropriate entities.
 696
 697       procedure Set_Extended_Import_Export_External_Name
 698         (Internal_Ent : Entity_Id;
 699          Arg_External : Node_Id);
 700       --  Common processing for all extended import export pragmas. The first
 701       --  argument, Internal_Ent, is the internal entity, which has already
 702       --  been checked for validity by the caller. Arg_External is from the
 703       --  Import or Export pragma, and may be null if no External parameter
 704       --  was present. If Arg_External is present and is a non-null string
 705       --  (a null string is treated as the default), then the Interface_Name
 706       --  field of Internal_Ent is set appropriately.
 707
 708       procedure Set_Imported (E : Entity_Id);
 709       --  This procedure sets the Is_Imported flag for the given entity,
 710       --  checking that it is not previously exported or imported.
 711
 712       procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id);
 713       --  Mech is a parameter passing mechanism (see Import_Function syntax
 714       --  for MECHANISM_NAME). This routine checks that the mechanism argument
 715       --  has the right form, and if not issues an error message. If the
 716       --  argument has the right form then the Mechanism field of Ent is
 717       --  set appropriately.
 718
 719       procedure Set_Ravenscar_Profile (N : Node_Id);
 720       --  Activate the set of configuration pragmas and restrictions that make
 721       --  up the Ravenscar Profile. N is the corresponding pragma node, which
 722       --  is used for error messages on any constructs that violate the
 723       --  profile.
 724
 725       ---------------------
 726       -- Ada_2005_Pragma --
 727       ---------------------
 728
 729       procedure Ada_2005_Pragma is
 730       begin
 731          if Ada_Version <= Ada_95 then
 732             Check_Restriction (No_Implementation_Pragmas, N);
 733          end if;
 734       end Ada_2005_Pragma;
 735
 736       --------------------------
 737       -- Check_Ada_83_Warning --
 738       --------------------------
 739
 740       procedure Check_Ada_83_Warning is
 741       begin
 742          if Ada_Version = Ada_83 and then Comes_From_Source (N) then
 743             Error_Msg_N ("(Ada 83) pragma& is non-standard?", N);
 744          end if;
 745       end Check_Ada_83_Warning;
 746
 747       ---------------------
 748       -- Check_Arg_Count --
 749       ---------------------
 750
 751       procedure Check_Arg_Count (Required : Nat) is
 752       begin
 753          if Arg_Count /= Required then
 754             Error_Pragma ("wrong number of arguments for pragma%");
 755          end if;
 756       end Check_Arg_Count;
 757
 758       --------------------------------
 759       -- Check_Arg_Is_External_Name --
 760       --------------------------------
 761
 762       procedure Check_Arg_Is_External_Name (Arg : Node_Id) is
 763          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 764
 765       begin
 766          if Nkind (Argx) = N_Identifier then
 767             return;
 768
 769          else
 770             Analyze_And_Resolve (Argx, Standard_String);
 771
 772             if Is_OK_Static_Expression (Argx) then
 773                return;
 774
 775             elsif Etype (Argx) = Any_Type then
 776                raise Pragma_Exit;
 777
 778             --  An interesting special case, if we have a string literal and
 779             --  we are in Ada 83 mode, then we allow it even though it will
 780             --  not be flagged as static. This allows expected Ada 83 mode
 781             --  use of external names which are string literals, even though
 782             --  technically these are not static in Ada 83.
 783
 784             elsif Ada_Version = Ada_83
 785               and then Nkind (Argx) = N_String_Literal
 786             then
 787                return;
 788
 789             --  Static expression that raises Constraint_Error. This has
 790             --  already been flagged, so just exit from pragma processing.
 791
 792             elsif Is_Static_Expression (Argx) then
 793                raise Pragma_Exit;
 794
 795             --  Here we have a real error (non-static expression)
 796
 797             else
 798                Error_Msg_Name_1 := Pname;
 799                Flag_Non_Static_Expr
 800                  ("argument for pragma% must be a identifier or " &
 801                   "static string expression!", Argx);
 802                raise Pragma_Exit;
 803             end if;
 804          end if;
 805       end Check_Arg_Is_External_Name;
 806
 807       -----------------------------
 808       -- Check_Arg_Is_Identifier --
 809       -----------------------------
 810
 811       procedure Check_Arg_Is_Identifier (Arg : Node_Id) is
 812          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 813       begin
 814          if Nkind (Argx) /= N_Identifier then
 815             Error_Pragma_Arg
 816               ("argument for pragma% must be identifier", Argx);
 817          end if;
 818       end Check_Arg_Is_Identifier;
 819
 820       ----------------------------------
 821       -- Check_Arg_Is_Integer_Literal --
 822       ----------------------------------
 823
 824       procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id) is
 825          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 826       begin
 827          if Nkind (Argx) /= N_Integer_Literal then
 828             Error_Pragma_Arg
 829               ("argument for pragma% must be integer literal", Argx);
 830          end if;
 831       end Check_Arg_Is_Integer_Literal;
 832
 833       -------------------------------------------
 834       -- Check_Arg_Is_Library_Level_Local_Name --
 835       -------------------------------------------
 836
 837       --  LOCAL_NAME ::=
 838       --    DIRECT_NAME
 839       --  | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
 840       --  | library_unit_NAME
 841
 842       procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id) is
 843       begin
 844          Check_Arg_Is_Local_Name (Arg);
 845
 846          if not Is_Library_Level_Entity (Entity (Expression (Arg)))
 847            and then Comes_From_Source (N)
 848          then
 849             Error_Pragma_Arg
 850               ("argument for pragma% must be library level entity", Arg);
 851          end if;
 852       end Check_Arg_Is_Library_Level_Local_Name;
 853
 854       -----------------------------
 855       -- Check_Arg_Is_Local_Name --
 856       -----------------------------
 857
 858       --  LOCAL_NAME ::=
 859       --    DIRECT_NAME
 860       --  | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
 861       --  | library_unit_NAME
 862
 863       procedure Check_Arg_Is_Local_Name (Arg : Node_Id) is
 864          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 865
 866       begin
 867          Analyze (Argx);
 868
 869          if Nkind (Argx) not in N_Direct_Name
 870            and then (Nkind (Argx) /= N_Attribute_Reference
 871                       or else Present (Expressions (Argx))
 872                       or else Nkind (Prefix (Argx)) /= N_Identifier)
 873            and then (not Is_Entity_Name (Argx)
 874                       or else not Is_Compilation_Unit (Entity (Argx)))
 875          then
 876             Error_Pragma_Arg ("argument for pragma% must be local name", Argx);
 877          end if;
 878
 879          if Is_Entity_Name (Argx)
 880            and then Scope (Entity (Argx)) /= Current_Scope
 881          then
 882             Error_Pragma_Arg
 883               ("pragma% argument must be in same declarative part", Arg);
 884          end if;
 885       end Check_Arg_Is_Local_Name;
 886
 887       ---------------------------------
 888       -- Check_Arg_Is_Locking_Policy --
 889       ---------------------------------
 890
 891       procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id) is
 892          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 893
 894       begin
 895          Check_Arg_Is_Identifier (Argx);
 896
 897          if not Is_Locking_Policy_Name (Chars (Argx)) then
 898             Error_Pragma_Arg
 899               ("& is not a valid locking policy name", Argx);
 900          end if;
 901       end Check_Arg_Is_Locking_Policy;
 902
 903       -------------------------
 904       -- Check_Arg_Is_One_Of --
 905       -------------------------
 906
 907       procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id) is
 908          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 909
 910       begin
 911          Check_Arg_Is_Identifier (Argx);
 912
 913          if Chars (Argx) /= N1 and then Chars (Argx) /= N2 then
 914             Error_Msg_Name_2 := N1;
 915             Error_Msg_Name_3 := N2;
 916             Error_Pragma_Arg ("argument for pragma% must be% or%", Argx);
 917          end if;
 918       end Check_Arg_Is_One_Of;
 919
 920       procedure Check_Arg_Is_One_Of
 921         (Arg        : Node_Id;
 922          N1, N2, N3 : Name_Id)
 923       is
 924          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 925
 926       begin
 927          Check_Arg_Is_Identifier (Argx);
 928
 929          if Chars (Argx) /= N1
 930            and then Chars (Argx) /= N2
 931            and then Chars (Argx) /= N3
 932          then
 933             Error_Pragma_Arg ("invalid argument for pragma%", Argx);
 934          end if;
 935       end Check_Arg_Is_One_Of;
 936
 937       procedure Check_Arg_Is_One_Of
 938         (Arg            : Node_Id;
 939          N1, N2, N3, N4 : Name_Id)
 940       is
 941          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 942
 943       begin
 944          Check_Arg_Is_Identifier (Argx);
 945
 946          if Chars (Argx) /= N1
 947            and then Chars (Argx) /= N2
 948            and then Chars (Argx) /= N3
 949            and then Chars (Argx) /= N4
 950          then
 951             Error_Pragma_Arg ("invalid argument for pragma%", Argx);
 952          end if;
 953       end Check_Arg_Is_One_Of;
 954
 955       ---------------------------------
 956       -- Check_Arg_Is_Queuing_Policy --
 957       ---------------------------------
 958
 959       procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id) is
 960          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 961
 962       begin
 963          Check_Arg_Is_Identifier (Argx);
 964
 965          if not Is_Queuing_Policy_Name (Chars (Argx)) then
 966             Error_Pragma_Arg
 967               ("& is not a valid queuing policy name", Argx);
 968          end if;
 969       end Check_Arg_Is_Queuing_Policy;
 970
 971       ------------------------------------
 972       -- Check_Arg_Is_Static_Expression --
 973       ------------------------------------
 974
 975       procedure Check_Arg_Is_Static_Expression
 976         (Arg : Node_Id;
 977          Typ : Entity_Id := Empty)
 978       is
 979          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
 980
 981       begin
 982          if Present (Typ) then
 983             Analyze_And_Resolve (Argx, Typ);
 984          else
 985             Analyze_And_Resolve (Argx);
 986          end if;
 987
 988          if Is_OK_Static_Expression (Argx) then
 989             return;
 990
 991          elsif Etype (Argx) = Any_Type then
 992             raise Pragma_Exit;
 993
 994          --  An interesting special case, if we have a string literal and we
 995          --  are in Ada 83 mode, then we allow it even though it will not be
 996          --  flagged as static. This allows the use of Ada 95 pragmas like
 997          --  Import in Ada 83 mode. They will of course be flagged with
 998          --  warnings as usual, but will not cause errors.
 999
1000          elsif Ada_Version = Ada_83
1001            and then Nkind (Argx) = N_String_Literal
1002          then
1003             return;
1004
1005          --  Static expression that raises Constraint_Error. This has already
1006          --  been flagged, so just exit from pragma processing.
1007
1008          elsif Is_Static_Expression (Argx) then
1009             raise Pragma_Exit;
1010
1011          --  Finally, we have a real error
1012
1013          else
1014             Error_Msg_Name_1 := Pname;
1015             Flag_Non_Static_Expr
1016               ("argument for pragma% must be a static expression!", Argx);
1017             raise Pragma_Exit;
1018          end if;
1019       end Check_Arg_Is_Static_Expression;
1020
1021       ------------------------------------------
1022       -- Check_Arg_Is_Task_Dispatching_Policy --
1023       ------------------------------------------
1024
1025       procedure Check_Arg_Is_Task_Dispatching_Policy (Arg : Node_Id) is
1026          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
1027
1028       begin
1029          Check_Arg_Is_Identifier (Argx);
1030
1031          if not Is_Task_Dispatching_Policy_Name (Chars (Argx)) then
1032             Error_Pragma_Arg
1033               ("& is not a valid task dispatching policy name", Argx);
1034          end if;
1035       end Check_Arg_Is_Task_Dispatching_Policy;
1036
1037       ---------------------
1038       -- Check_Arg_Order --
1039       ---------------------
1040
1041       procedure Check_Arg_Order (Names : Name_List) is
1042          Arg : Node_Id;
1043
1044          Highest_So_Far : Natural := 0;
1045          --  Highest index in Names seen do far
1046
1047       begin
1048          Arg := Arg1;
1049          for J in 1 .. Arg_Count loop
1050             if Chars (Arg) /= No_Name then
1051                for K in Names'Range loop
1052                   if Chars (Arg) = Names (K) then
1053                      if K < Highest_So_Far then
1054                         Error_Msg_Name_1 := Pname;
1055                         Error_Msg_N
1056                           ("parameters out of order for pragma%", Arg);
1057                         Error_Msg_Name_1 := Names (K);
1058                         Error_Msg_Name_2 := Names (Highest_So_Far);
1059                         Error_Msg_N ("\% must appear before %", Arg);
1060                         raise Pragma_Exit;
1061
1062                      else
1063                         Highest_So_Far := K;
1064                      end if;
1065                   end if;
1066                end loop;
1067             end if;
1068
1069             Arg := Next (Arg);
1070          end loop;
1071       end Check_Arg_Order;
1072
1073       --------------------------------
1074       -- Check_At_Least_N_Arguments --
1075       --------------------------------
1076
1077       procedure Check_At_Least_N_Arguments (N : Nat) is
1078       begin
1079          if Arg_Count < N then
1080             Error_Pragma ("too few arguments for pragma%");
1081          end if;
1082       end Check_At_Least_N_Arguments;
1083
1084       -------------------------------
1085       -- Check_At_Most_N_Arguments --
1086       -------------------------------
1087
1088       procedure Check_At_Most_N_Arguments (N : Nat) is
1089          Arg : Node_Id;
1090       begin
1091          if Arg_Count > N then
1092             Arg := Arg1;
1093             for J in 1 .. N loop
1094                Next (Arg);
1095                Error_Pragma_Arg ("too many arguments for pragma%", Arg);
1096             end loop;
1097          end if;
1098       end Check_At_Most_N_Arguments;
1099
1100       ---------------------
1101       -- Check_Component --
1102       ---------------------
1103
1104       procedure Check_Component
1105         (Comp            : Node_Id;
1106          UU_Typ          : Entity_Id;
1107          In_Variant_Part : Boolean := False)
1108       is
1109          Comp_Id : constant Entity_Id := Defining_Identifier (Comp);
1110          Sindic  : constant Node_Id :=
1111                      Subtype_Indication (Component_Definition (Comp));
1112          Typ     : constant Entity_Id := Etype (Comp_Id);
1113
1114          function Inside_Generic_Body (Id : Entity_Id) return Boolean;
1115          --  Determine whether entity Id appears inside a generic body
1116
1117          -------------------------
1118          -- Inside_Generic_Body --
1119          -------------------------
1120
1121          function Inside_Generic_Body (Id : Entity_Id) return Boolean is
1122             S : Entity_Id := Id;
1123
1124          begin
1125             while Present (S)
1126               and then S /= Standard_Standard
1127             loop
1128                if Ekind (S) = E_Generic_Package
1129                  and then In_Package_Body (S)
1130                then
1131                   return True;
1132                end if;
1133
1134                S := Scope (S);
1135             end loop;
1136
1137             return False;
1138          end Inside_Generic_Body;
1139
1140       --  Start of processing for Check_Component
1141
1142       begin
1143          --  Ada 2005 (AI-216): If a component subtype is subject to a per-
1144          --  object constraint, then the component type shall be an Unchecked_
1145          --  Union.
1146
1147          if Nkind (Sindic) = N_Subtype_Indication
1148            and then Has_Per_Object_Constraint (Comp_Id)
1149            and then not Is_Unchecked_Union (Etype (Subtype_Mark (Sindic)))
1150          then
1151             Error_Msg_N
1152               ("component subtype subject to per-object constraint " &
1153                "must be an Unchecked_Union", Comp);
1154
1155          --  Ada 2012 (AI05-0026): For an unchecked union type declared within
1156          --  the body of a generic unit, or within the body of any of its
1157          --  descendant library units, no part of the type of a component
1158          --  declared in a variant_part of the unchecked union type shall be of
1159          --  a formal private type or formal private extension declared within
1160          --  the formal part of the generic unit.
1161
1162          elsif Ada_Version >= Ada_2012
1163            and then Inside_Generic_Body (UU_Typ)
1164            and then In_Variant_Part
1165            and then Is_Private_Type (Typ)
1166            and then Is_Generic_Type (Typ)
1167          then
1168             Error_Msg_N
1169               ("component of Unchecked_Union cannot be of generic type", Comp);
1170
1171          elsif Needs_Finalization (Typ) then
1172             Error_Msg_N
1173               ("component of Unchecked_Union cannot be controlled", Comp);
1174
1175          elsif Has_Task (Typ) then
1176             Error_Msg_N
1177               ("component of Unchecked_Union cannot have tasks", Comp);
1178          end if;
1179       end Check_Component;
1180
1181       ----------------------------------
1182       -- Check_Duplicated_Export_Name --
1183       ----------------------------------
1184
1185       procedure Check_Duplicated_Export_Name (Nam : Node_Id) is
1186          String_Val : constant String_Id := Strval (Nam);
1187
1188       begin
1189          --  We are only interested in the export case, and in the case of
1190          --  generics, it is the instance, not the template, that is the
1191          --  problem (the template will generate a warning in any case).
1192
1193          if not Inside_A_Generic
1194            and then (Prag_Id = Pragma_Export
1195                        or else
1196                      Prag_Id = Pragma_Export_Procedure
1197                        or else
1198                      Prag_Id = Pragma_Export_Valued_Procedure
1199                        or else
1200                      Prag_Id = Pragma_Export_Function)
1201          then
1202             for J in Externals.First .. Externals.Last loop
1203                if String_Equal (String_Val, Strval (Externals.Table (J))) then
1204                   Error_Msg_Sloc := Sloc (Externals.Table (J));
1205                   Error_Msg_N ("external name duplicates name given#", Nam);
1206                   exit;
1207                end if;
1208             end loop;
1209
1210             Externals.Append (Nam);
1211          end if;
1212       end Check_Duplicated_Export_Name;
1213
1214       -------------------------
1215       -- Check_First_Subtype --
1216       -------------------------
1217
1218       procedure Check_First_Subtype (Arg : Node_Id) is
1219          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
1220       begin
1221          if not Is_First_Subtype (Entity (Argx)) then
1222             Error_Pragma_Arg
1223               ("pragma% cannot apply to subtype", Argx);
1224          end if;
1225       end Check_First_Subtype;
1226
1227       ---------------------------
1228       -- Check_In_Main_Program --
1229       ---------------------------
1230
1231       procedure Check_In_Main_Program is
1232          P : constant Node_Id := Parent (N);
1233
1234       begin
1235          --  Must be at in subprogram body
1236
1237          if Nkind (P) /= N_Subprogram_Body then
1238             Error_Pragma ("% pragma allowed only in subprogram");
1239
1240          --  Otherwise warn if obviously not main program
1241
1242          elsif Present (Parameter_Specifications (Specification (P)))
1243            or else not Is_Compilation_Unit (Defining_Entity (P))
1244          then
1245             Error_Msg_Name_1 := Pname;
1246             Error_Msg_N
1247               ("?pragma% is only effective in main program", N);
1248          end if;
1249       end Check_In_Main_Program;
1250
1251       ---------------------------------------
1252       -- Check_Interrupt_Or_Attach_Handler --
1253       ---------------------------------------
1254
1255       procedure Check_Interrupt_Or_Attach_Handler is
1256          Arg1_X : constant Node_Id := Expression (Arg1);
1257          Handler_Proc, Proc_Scope : Entity_Id;
1258
1259       begin
1260          Analyze (Arg1_X);
1261
1262          if Prag_Id = Pragma_Interrupt_Handler then
1263             Check_Restriction (No_Dynamic_Attachment, N);
1264          end if;
1265
1266          Handler_Proc := Find_Unique_Parameterless_Procedure (Arg1_X, Arg1);
1267          Proc_Scope := Scope (Handler_Proc);
1268
1269          --  On AAMP only, a pragma Interrupt_Handler is supported for
1270          --  nonprotected parameterless procedures.
1271
1272          if not AAMP_On_Target
1273            or else Prag_Id = Pragma_Attach_Handler
1274          then
1275             if Ekind (Proc_Scope) /= E_Protected_Type then
1276                Error_Pragma_Arg
1277                  ("argument of pragma% must be protected procedure", Arg1);
1278             end if;
1279
1280             if Parent (N) /= Protected_Definition (Parent (Proc_Scope)) then
1281                Error_Pragma ("pragma% must be in protected definition");
1282             end if;
1283          end if;
1284
1285          if not Is_Library_Level_Entity (Proc_Scope)
1286            or else (AAMP_On_Target
1287                      and then not Is_Library_Level_Entity (Handler_Proc))
1288          then
1289             Error_Pragma_Arg
1290               ("argument for pragma% must be library level entity", Arg1);
1291          end if;
1292       end Check_Interrupt_Or_Attach_Handler;
1293
1294       -------------------------------------------
1295       -- Check_Is_In_Decl_Part_Or_Package_Spec --
1296       -------------------------------------------
1297
1298       procedure Check_Is_In_Decl_Part_Or_Package_Spec is
1299          P : Node_Id;
1300
1301       begin
1302          P := Parent (N);
1303          loop
1304             if No (P) then
1305                exit;
1306
1307             elsif Nkind (P) = N_Handled_Sequence_Of_Statements then
1308                exit;
1309
1310             elsif Nkind_In (P, N_Package_Specification,
1311                                N_Block_Statement)
1312             then
1313                return;
1314
1315             --  Note: the following tests seem a little peculiar, because
1316             --  they test for bodies, but if we were in the statement part
1317             --  of the body, we would already have hit the handled statement
1318             --  sequence, so the only way we get here is by being in the
1319             --  declarative part of the body.
1320
1321             elsif Nkind_In (P, N_Subprogram_Body,
1322                                N_Package_Body,
1323                                N_Task_Body,
1324                                N_Entry_Body)
1325             then
1326                return;
1327             end if;
1328
1329             P := Parent (P);
1330          end loop;
1331
1332          Error_Pragma ("pragma% is not in declarative part or package spec");
1333       end Check_Is_In_Decl_Part_Or_Package_Spec;
1334
1335       -------------------------
1336       -- Check_No_Identifier --
1337       -------------------------
1338
1339       procedure Check_No_Identifier (Arg : Node_Id) is
1340       begin
1341          if Chars (Arg) /= No_Name then
1342             Error_Pragma_Arg_Ident
1343               ("pragma% does not permit identifier& here", Arg);
1344          end if;
1345       end Check_No_Identifier;
1346
1347       --------------------------
1348       -- Check_No_Identifiers --
1349       --------------------------
1350
1351       procedure Check_No_Identifiers is
1352          Arg_Node : Node_Id;
1353       begin
1354          if Arg_Count > 0 then
1355             Arg_Node := Arg1;
1356             while Present (Arg_Node) loop
1357                Check_No_Identifier (Arg_Node);
1358                Next (Arg_Node);
1359             end loop;
1360          end if;
1361       end Check_No_Identifiers;
1362
1363       -------------------------------
1364       -- Check_Optional_Identifier --
1365       -------------------------------
1366
1367       procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id) is
1368       begin
1369          if Present (Arg) and then Chars (Arg) /= No_Name then
1370             if Chars (Arg) /= Id then
1371                Error_Msg_Name_1 := Pname;
1372                Error_Msg_Name_2 := Id;
1373                Error_Msg_N ("pragma% argument expects identifier%", Arg);
1374                raise Pragma_Exit;
1375             end if;
1376          end if;
1377       end Check_Optional_Identifier;
1378
1379       procedure Check_Optional_Identifier (Arg : Node_Id; Id : String) is
1380       begin
1381          Name_Buffer (1 .. Id'Length) := Id;
1382          Name_Len := Id'Length;
1383          Check_Optional_Identifier (Arg, Name_Find);
1384       end Check_Optional_Identifier;
1385
1386       --------------------------------------
1387       -- Check_Precondition_Postcondition --
1388       --------------------------------------
1389
1390       procedure Check_Precondition_Postcondition (In_Body : out Boolean) is
1391          P  : Node_Id;
1392          PO : Node_Id;
1393
1394          procedure Chain_PPC (PO : Node_Id);
1395          --  If PO is a subprogram declaration node (or a generic subprogram
1396          --  declaration node), then the precondition/postcondition applies
1397          --  to this subprogram and the processing for the pragma is completed.
1398          --  Otherwise the pragma is misplaced.
1399
1400          ---------------
1401          -- Chain_PPC --
1402          ---------------
1403
1404          procedure Chain_PPC (PO : Node_Id) is
1405             S : Node_Id;
1406
1407          begin
1408             if not Nkind_In (PO, N_Subprogram_Declaration,
1409                                  N_Generic_Subprogram_Declaration)
1410             then
1411                Pragma_Misplaced;
1412             end if;
1413
1414             --  Here if we have subprogram or generic subprogram declaration
1415
1416             S := Defining_Unit_Name (Specification (PO));
1417
1418             --  Analyze the pragma unless it appears within a package spec,
1419             --  which is the case where we delay the analysis of the PPC until
1420             --  the end of the package declarations (for details, see
1421             --  Analyze_Package_Specification.Analyze_PPCs).
1422
1423             if not Is_Package_Or_Generic_Package (Scope (S)) then
1424                Analyze_PPC_In_Decl_Part (N, S);
1425             end if;
1426
1427             --  Chain spec PPC pragma to list for subprogram
1428
1429             Set_Next_Pragma (N, Spec_PPC_List (S));
1430             Set_Spec_PPC_List (S, N);
1431
1432             --  Return indicating spec case
1433
1434             In_Body := False;
1435             return;
1436          end Chain_PPC;
1437
1438          --  Start of processing for Check_Precondition_Postcondition
1439
1440       begin
1441          if not Is_List_Member (N) then
1442             Pragma_Misplaced;
1443          end if;
1444
1445          --  Record if pragma is enabled
1446
1447          if Check_Enabled (Pname) then
1448             Set_Pragma_Enabled (N);
1449             Set_SCO_Pragma_Enabled (Loc);
1450          end if;
1451
1452          --  If we are within an inlined body, the legality of the pragma
1453          --  has been checked already.
1454
1455          if In_Inlined_Body then
1456             In_Body := True;
1457             return;
1458          end if;
1459
1460          --  Search prior declarations
1461
1462          P := N;
1463          while Present (Prev (P)) loop
1464             P := Prev (P);
1465
1466             --  If the previous node is a generic subprogram, do not go to to
1467             --  the original node, which is the unanalyzed tree: we need to
1468             --  attach the pre/postconditions to the analyzed version at this
1469             --  point. They get propagated to the original tree when analyzing
1470             --  the corresponding body.
1471
1472             if Nkind (P) not in N_Generic_Declaration then
1473                PO := Original_Node (P);
1474             else
1475                PO := P;
1476             end if;
1477
1478             --  Skip past prior pragma
1479
1480             if Nkind (PO) = N_Pragma then
1481                null;
1482
1483             --  Skip stuff not coming from source
1484
1485             elsif not Comes_From_Source (PO) then
1486                null;
1487
1488             --  Only remaining possibility is subprogram declaration
1489
1490             else
1491                Chain_PPC (PO);
1492                return;
1493             end if;
1494          end loop;
1495
1496          --  If we fall through loop, pragma is at start of list, so see if it
1497          --  is at the start of declarations of a subprogram body.
1498
1499          if Nkind (Parent (N)) = N_Subprogram_Body
1500            and then List_Containing (N) = Declarations (Parent (N))
1501          then
1502             if Operating_Mode /= Generate_Code
1503               or else Inside_A_Generic
1504             then
1505
1506                --  Analyze expression in pragma, for correctness
1507                --  and for ASIS use.
1508
1509                Preanalyze_Spec_Expression
1510                  (Get_Pragma_Arg (Arg1), Standard_Boolean);
1511             end if;
1512
1513             In_Body := True;
1514             return;
1515
1516          --  See if it is in the pragmas after a library level subprogram
1517
1518          elsif Nkind (Parent (N)) = N_Compilation_Unit_Aux then
1519             Chain_PPC (Unit (Parent (Parent (N))));
1520             return;
1521          end if;
1522
1523          --  If we fall through, pragma was misplaced
1524
1525          Pragma_Misplaced;
1526       end Check_Precondition_Postcondition;
1527
1528       -----------------------------
1529       -- Check_Static_Constraint --
1530       -----------------------------
1531
1532       --  Note: for convenience in writing this procedure, in addition to
1533       --  the officially (i.e. by spec) allowed argument which is always a
1534       --  constraint, it also allows ranges and discriminant associations.
1535       --  Above is not clear ???
1536
1537       procedure Check_Static_Constraint (Constr : Node_Id) is
1538
1539          procedure Require_Static (E : Node_Id);
1540          --  Require given expression to be static expression
1541
1542          --------------------
1543          -- Require_Static --
1544          --------------------
1545
1546          procedure Require_Static (E : Node_Id) is
1547          begin
1548             if not Is_OK_Static_Expression (E) then
1549                Flag_Non_Static_Expr
1550                  ("non-static constraint not allowed in Unchecked_Union!", E);
1551                raise Pragma_Exit;
1552             end if;
1553          end Require_Static;
1554
1555       --  Start of processing for Check_Static_Constraint
1556
1557       begin
1558          case Nkind (Constr) is
1559             when N_Discriminant_Association =>
1560                Require_Static (Expression (Constr));
1561
1562             when N_Range =>
1563                Require_Static (Low_Bound (Constr));
1564                Require_Static (High_Bound (Constr));
1565
1566             when N_Attribute_Reference =>
1567                Require_Static (Type_Low_Bound  (Etype (Prefix (Constr))));
1568                Require_Static (Type_High_Bound (Etype (Prefix (Constr))));
1569
1570             when N_Range_Constraint =>
1571                Check_Static_Constraint (Range_Expression (Constr));
1572
1573             when N_Index_Or_Discriminant_Constraint =>
1574                declare
1575                   IDC : Entity_Id;
1576                begin
1577                   IDC := First (Constraints (Constr));
1578                   while Present (IDC) loop
1579                      Check_Static_Constraint (IDC);
1580                      Next (IDC);
1581                   end loop;
1582                end;
1583
1584             when others =>
1585                null;
1586          end case;
1587       end Check_Static_Constraint;
1588
1589       --------------------------------------
1590       -- Check_Valid_Configuration_Pragma --
1591       --------------------------------------
1592
1593       --  A configuration pragma must appear in the context clause of a
1594       --  compilation unit, and only other pragmas may precede it. Note that
1595       --  the test also allows use in a configuration pragma file.
1596
1597       procedure Check_Valid_Configuration_Pragma is
1598       begin
1599          if not Is_Configuration_Pragma then
1600             Error_Pragma ("incorrect placement for configuration pragma%");
1601          end if;
1602       end Check_Valid_Configuration_Pragma;
1603
1604       -------------------------------------
1605       -- Check_Valid_Library_Unit_Pragma --
1606       -------------------------------------
1607
1608       procedure Check_Valid_Library_Unit_Pragma is
1609          Plist       : List_Id;
1610          Parent_Node : Node_Id;
1611          Unit_Name   : Entity_Id;
1612          Unit_Kind   : Node_Kind;
1613          Unit_Node   : Node_Id;
1614          Sindex      : Source_File_Index;
1615
1616       begin
1617          if not Is_List_Member (N) then
1618             Pragma_Misplaced;
1619
1620          else
1621             Plist := List_Containing (N);
1622             Parent_Node := Parent (Plist);
1623
1624             if Parent_Node = Empty then
1625                Pragma_Misplaced;
1626
1627             --  Case of pragma appearing after a compilation unit. In this case
1628             --  it must have an argument with the corresponding name and must
1629             --  be part of the following pragmas of its parent.
1630
1631             elsif Nkind (Parent_Node) = N_Compilation_Unit_Aux then
1632                if Plist /= Pragmas_After (Parent_Node) then
1633                   Pragma_Misplaced;
1634
1635                elsif Arg_Count = 0 then
1636                   Error_Pragma
1637                     ("argument required if outside compilation unit");
1638
1639                else
1640                   Check_No_Identifiers;
1641                   Check_Arg_Count (1);
1642                   Unit_Node := Unit (Parent (Parent_Node));
1643                   Unit_Kind := Nkind (Unit_Node);
1644
1645                   Analyze (Expression (Arg1));
1646
1647                   if Unit_Kind = N_Generic_Subprogram_Declaration
1648                     or else Unit_Kind = N_Subprogram_Declaration
1649                   then
1650                      Unit_Name := Defining_Entity (Unit_Node);
1651
1652                   elsif Unit_Kind in N_Generic_Instantiation then
1653                      Unit_Name := Defining_Entity (Unit_Node);
1654
1655                   else
1656                      Unit_Name := Cunit_Entity (Current_Sem_Unit);
1657                   end if;
1658
1659                   if Chars (Unit_Name) /=
1660                      Chars (Entity (Expression (Arg1)))
1661                   then
1662                      Error_Pragma_Arg
1663                        ("pragma% argument is not current unit name", Arg1);
1664                   end if;
1665
1666                   if Ekind (Unit_Name) = E_Package
1667                     and then Present (Renamed_Entity (Unit_Name))
1668                   then
1669                      Error_Pragma ("pragma% not allowed for renamed package");
1670                   end if;
1671                end if;
1672
1673             --  Pragma appears other than after a compilation unit
1674
1675             else
1676                --  Here we check for the generic instantiation case and also
1677                --  for the case of processing a generic formal package. We
1678                --  detect these cases by noting that the Sloc on the node
1679                --  does not belong to the current compilation unit.
1680
1681                Sindex := Source_Index (Current_Sem_Unit);
1682
1683                if Loc not in Source_First (Sindex) .. Source_Last (Sindex) then
1684                   Rewrite (N, Make_Null_Statement (Loc));
1685                   return;
1686
1687                --  If before first declaration, the pragma applies to the
1688                --  enclosing unit, and the name if present must be this name.
1689
1690                elsif Is_Before_First_Decl (N, Plist) then
1691                   Unit_Node := Unit_Declaration_Node (Current_Scope);
1692                   Unit_Kind := Nkind (Unit_Node);
1693
1694                   if Nkind (Parent (Unit_Node)) /= N_Compilation_Unit then
1695                      Pragma_Misplaced;
1696
1697                   elsif Unit_Kind = N_Subprogram_Body
1698                     and then not Acts_As_Spec (Unit_Node)
1699                   then
1700                      Pragma_Misplaced;
1701
1702                   elsif Nkind (Parent_Node) = N_Package_Body then
1703                      Pragma_Misplaced;
1704
1705                   elsif Nkind (Parent_Node) = N_Package_Specification
1706                     and then Plist = Private_Declarations (Parent_Node)
1707                   then
1708                      Pragma_Misplaced;
1709
1710                   elsif (Nkind (Parent_Node) = N_Generic_Package_Declaration
1711                            or else Nkind (Parent_Node) =
1712                                              N_Generic_Subprogram_Declaration)
1713                     and then Plist = Generic_Formal_Declarations (Parent_Node)
1714                   then
1715                      Pragma_Misplaced;
1716
1717                   elsif Arg_Count > 0 then
1718                      Analyze (Expression (Arg1));
1719
1720                      if Entity (Expression (Arg1)) /= Current_Scope then
1721                         Error_Pragma_Arg
1722                           ("name in pragma% must be enclosing unit", Arg1);
1723                      end if;
1724
1725                   --  It is legal to have no argument in this context
1726
1727                   else
1728                      return;
1729                   end if;
1730
1731                --  Error if not before first declaration. This is because a
1732                --  library unit pragma argument must be the name of a library
1733                --  unit (RM 10.1.5(7)), but the only names permitted in this
1734                --  context are (RM 10.1.5(6)) names of subprogram declarations,
1735                --  generic subprogram declarations or generic instantiations.
1736
1737                else
1738                   Error_Pragma
1739                     ("pragma% misplaced, must be before first declaration");
1740                end if;
1741             end if;
1742          end if;
1743       end Check_Valid_Library_Unit_Pragma;
1744
1745       -------------------
1746       -- Check_Variant --
1747       -------------------
1748
1749       procedure Check_Variant (Variant : Node_Id; UU_Typ : Entity_Id) is
1750          Clist : constant Node_Id := Component_List (Variant);
1751          Comp  : Node_Id;
1752
1753       begin
1754          if not Is_Non_Empty_List (Component_Items (Clist)) then
1755             Error_Msg_N
1756               ("Unchecked_Union may not have empty component list",
1757                Variant);
1758             return;
1759          end if;
1760
1761          Comp := First (Component_Items (Clist));
1762          while Present (Comp) loop
1763             Check_Component (Comp, UU_Typ, In_Variant_Part => True);
1764             Next (Comp);
1765          end loop;
1766       end Check_Variant;
1767
1768       ------------------
1769       -- Error_Pragma --
1770       ------------------
1771
1772       procedure Error_Pragma (Msg : String) is
1773       begin
1774          Error_Msg_Name_1 := Pname;
1775          Error_Msg_N (Msg, N);
1776          raise Pragma_Exit;
1777       end Error_Pragma;
1778
1779       ----------------------
1780       -- Error_Pragma_Arg --
1781       ----------------------
1782
1783       procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id) is
1784       begin
1785          Error_Msg_Name_1 := Pname;
1786          Error_Msg_N (Msg, Get_Pragma_Arg (Arg));
1787          raise Pragma_Exit;
1788       end Error_Pragma_Arg;
1789
1790       procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id) is
1791       begin
1792          Error_Msg_Name_1 := Pname;
1793          Error_Msg_N (Msg1, Get_Pragma_Arg (Arg));
1794          Error_Pragma_Arg (Msg2, Arg);
1795       end Error_Pragma_Arg;
1796
1797       ----------------------------
1798       -- Error_Pragma_Arg_Ident --
1799       ----------------------------
1800
1801       procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id) is
1802       begin
1803          Error_Msg_Name_1 := Pname;
1804          Error_Msg_N (Msg, Arg);
1805          raise Pragma_Exit;
1806       end Error_Pragma_Arg_Ident;
1807
1808       ----------------------
1809       -- Error_Pragma_Ref --
1810       ----------------------
1811
1812       procedure Error_Pragma_Ref (Msg : String; Ref : Entity_Id) is
1813       begin
1814          Error_Msg_Name_1 := Pname;
1815          Error_Msg_Sloc   := Sloc (Ref);
1816          Error_Msg_NE (Msg, N, Ref);
1817          raise Pragma_Exit;
1818       end Error_Pragma_Ref;
1819
1820       ------------------------
1821       -- Find_Lib_Unit_Name --
1822       ------------------------
1823
1824       function Find_Lib_Unit_Name return Entity_Id is
1825       begin
1826          --  Return inner compilation unit entity, for case of nested
1827          --  categorization pragmas. This happens in generic unit.
1828
1829          if Nkind (Parent (N)) = N_Package_Specification
1830            and then Defining_Entity (Parent (N)) /= Current_Scope
1831          then
1832             return Defining_Entity (Parent (N));
1833          else
1834             return Current_Scope;
1835          end if;
1836       end Find_Lib_Unit_Name;
1837
1838       ----------------------------
1839       -- Find_Program_Unit_Name --
1840       ----------------------------
1841
1842       procedure Find_Program_Unit_Name (Id : Node_Id) is
1843          Unit_Name : Entity_Id;
1844          Unit_Kind : Node_Kind;
1845          P         : constant Node_Id := Parent (N);
1846
1847       begin
1848          if Nkind (P) = N_Compilation_Unit then
1849             Unit_Kind := Nkind (Unit (P));
1850
1851             if Unit_Kind = N_Subprogram_Declaration
1852               or else Unit_Kind = N_Package_Declaration
1853               or else Unit_Kind in N_Generic_Declaration
1854             then
1855                Unit_Name := Defining_Entity (Unit (P));
1856
1857                if Chars (Id) = Chars (Unit_Name) then
1858                   Set_Entity (Id, Unit_Name);
1859                   Set_Etype (Id, Etype (Unit_Name));
1860                else
1861                   Set_Etype (Id, Any_Type);
1862                   Error_Pragma
1863                     ("cannot find program unit referenced by pragma%");
1864                end if;
1865
1866             else
1867                Set_Etype (Id, Any_Type);
1868                Error_Pragma ("pragma% inapplicable to this unit");
1869             end if;
1870
1871          else
1872             Analyze (Id);
1873          end if;
1874       end Find_Program_Unit_Name;
1875
1876       -----------------------------------------
1877       -- Find_Unique_Parameterless_Procedure --
1878       -----------------------------------------
1879
1880       function Find_Unique_Parameterless_Procedure
1881         (Name : Entity_Id;
1882          Arg  : Node_Id) return Entity_Id
1883       is
1884          Proc : Entity_Id := Empty;
1885
1886       begin
1887          --  The body of this procedure needs some comments ???
1888
1889          if not Is_Entity_Name (Name) then
1890             Error_Pragma_Arg
1891               ("argument of pragma% must be entity name", Arg);
1892
1893          elsif not Is_Overloaded (Name) then
1894             Proc := Entity (Name);
1895
1896             if Ekind (Proc) /= E_Procedure
1897               or else Present (First_Formal (Proc))
1898             then
1899                Error_Pragma_Arg
1900                  ("argument of pragma% must be parameterless procedure", Arg);
1901             end if;
1902
1903          else
1904             declare
1905                Found : Boolean := False;
1906                It    : Interp;
1907                Index : Interp_Index;
1908
1909             begin
1910                Get_First_Interp (Name, Index, It);
1911                while Present (It.Nam) loop
1912                   Proc := It.Nam;
1913
1914                   if Ekind (Proc) = E_Procedure
1915                     and then No (First_Formal (Proc))
1916                   then
1917                      if not Found then
1918                         Found := True;
1919                         Set_Entity (Name, Proc);
1920                         Set_Is_Overloaded (Name, False);
1921                      else
1922                         Error_Pragma_Arg
1923                           ("ambiguous handler name for pragma% ", Arg);
1924                      end if;
1925                   end if;
1926
1927                   Get_Next_Interp (Index, It);
1928                end loop;
1929
1930                if not Found then
1931                   Error_Pragma_Arg
1932                     ("argument of pragma% must be parameterless procedure",
1933                      Arg);
1934                else
1935                   Proc := Entity (Name);
1936                end if;
1937             end;
1938          end if;
1939
1940          return Proc;
1941       end Find_Unique_Parameterless_Procedure;
1942
1943       -------------------------
1944       -- Gather_Associations --
1945       -------------------------
1946
1947       procedure Gather_Associations
1948         (Names : Name_List;
1949          Args  : out Args_List)
1950       is
1951          Arg : Node_Id;
1952
1953       begin
1954          --  Initialize all parameters to Empty
1955
1956          for J in Args'Range loop
1957             Args (J) := Empty;
1958          end loop;
1959
1960          --  That's all we have to do if there are no argument associations
1961
1962          if No (Pragma_Argument_Associations (N)) then
1963             return;
1964          end if;
1965
1966          --  Otherwise first deal with any positional parameters present
1967
1968          Arg := First (Pragma_Argument_Associations (N));
1969          for Index in Args'Range loop
1970             exit when No (Arg) or else Chars (Arg) /= No_Name;
1971             Args (Index) := Expression (Arg);
1972             Next (Arg);
1973          end loop;
1974
1975          --  Positional parameters all processed, if any left, then we
1976          --  have too many positional parameters.
1977
1978          if Present (Arg) and then Chars (Arg) = No_Name then
1979             Error_Pragma_Arg
1980               ("too many positional associations for pragma%", Arg);
1981          end if;
1982
1983          --  Process named parameters if any are present
1984
1985          while Present (Arg) loop
1986             if Chars (Arg) = No_Name then
1987                Error_Pragma_Arg
1988                  ("positional association cannot follow named association",
1989                   Arg);
1990
1991             else
1992                for Index in Names'Range loop
1993                   if Names (Index) = Chars (Arg) then
1994                      if Present (Args (Index)) then
1995                         Error_Pragma_Arg
1996                           ("duplicate argument association for pragma%", Arg);
1997                      else
1998                         Args (Index) := Expression (Arg);
1999                         exit;
2000                      end if;
2001                   end if;
2002
2003                   if Index = Names'Last then
2004                      Error_Msg_Name_1 := Pname;
2005                      Error_Msg_N ("pragma% does not allow & argument", Arg);
2006
2007                      --  Check for possible misspelling
2008
2009                      for Index1 in Names'Range loop
2010                         if Is_Bad_Spelling_Of
2011                              (Chars (Arg), Names (Index1))
2012                         then
2013                            Error_Msg_Name_1 := Names (Index1);
2014                            Error_Msg_N -- CODEFIX
2015                              ("\possible misspelling of%", Arg);
2016                            exit;
2017                         end if;
2018                      end loop;
2019
2020                      raise Pragma_Exit;
2021                   end if;
2022                end loop;
2023             end if;
2024
2025             Next (Arg);
2026          end loop;
2027       end Gather_Associations;
2028
2029       -----------------
2030       -- GNAT_Pragma --
2031       -----------------
2032
2033       procedure GNAT_Pragma is
2034       begin
2035          Check_Restriction (No_Implementation_Pragmas, N);
2036       end GNAT_Pragma;
2037
2038       --------------------------
2039       -- Is_Before_First_Decl --
2040       --------------------------
2041
2042       function Is_Before_First_Decl
2043         (Pragma_Node : Node_Id;
2044          Decls       : List_Id) return Boolean
2045       is
2046          Item : Node_Id := First (Decls);
2047
2048       begin
2049          --  Only other pragmas can come before this pragma
2050
2051          loop
2052             if No (Item) or else Nkind (Item) /= N_Pragma then
2053                return False;
2054
2055             elsif Item = Pragma_Node then
2056                return True;
2057             end if;
2058
2059             Next (Item);
2060          end loop;
2061       end Is_Before_First_Decl;
2062
2063       -----------------------------
2064       -- Is_Configuration_Pragma --
2065       -----------------------------
2066
2067       --  A configuration pragma must appear in the context clause of a
2068       --  compilation unit, and only other pragmas may precede it. Note that
2069       --  the test below also permits use in a configuration pragma file.
2070
2071       function Is_Configuration_Pragma return Boolean is
2072          Lis : constant List_Id := List_Containing (N);
2073          Par : constant Node_Id := Parent (N);
2074          Prg : Node_Id;
2075
2076       begin
2077          --  If no parent, then we are in the configuration pragma file,
2078          --  so the placement is definitely appropriate.
2079
2080          if No (Par) then
2081             return True;
2082
2083          --  Otherwise we must be in the context clause of a compilation unit
2084          --  and the only thing allowed before us in the context list is more
2085          --  configuration pragmas.
2086
2087          elsif Nkind (Par) = N_Compilation_Unit
2088            and then Context_Items (Par) = Lis
2089          then
2090             Prg := First (Lis);
2091
2092             loop
2093                if Prg = N then
2094                   return True;
2095                elsif Nkind (Prg) /= N_Pragma then
2096                   return False;
2097                end if;
2098
2099                Next (Prg);
2100             end loop;
2101
2102          else
2103             return False;
2104          end if;
2105       end Is_Configuration_Pragma;
2106
2107       --------------------------
2108       -- Is_In_Context_Clause --
2109       --------------------------
2110
2111       function Is_In_Context_Clause return Boolean is
2112          Plist       : List_Id;
2113          Parent_Node : Node_Id;
2114
2115       begin
2116          if not Is_List_Member (N) then
2117             return False;
2118
2119          else
2120             Plist := List_Containing (N);
2121             Parent_Node := Parent (Plist);
2122
2123             if Parent_Node = Empty
2124               or else Nkind (Parent_Node) /= N_Compilation_Unit
2125               or else Context_Items (Parent_Node) /= Plist
2126             then
2127                return False;
2128             end if;
2129          end if;
2130
2131          return True;
2132       end Is_In_Context_Clause;
2133
2134       ---------------------------------
2135       -- Is_Static_String_Expression --
2136       ---------------------------------
2137
2138       function Is_Static_String_Expression (Arg : Node_Id) return Boolean is
2139          Argx : constant Node_Id := Get_Pragma_Arg (Arg);
2140
2141       begin
2142          Analyze_And_Resolve (Argx);
2143          return Is_OK_Static_Expression (Argx)
2144            and then Nkind (Argx) = N_String_Literal;
2145       end Is_Static_String_Expression;
2146
2147       ----------------------
2148       -- Pragma_Misplaced --
2149       ----------------------
2150
2151       procedure Pragma_Misplaced is
2152       begin
2153          Error_Pragma ("incorrect placement of pragma%");
2154       end Pragma_Misplaced;
2155
2156       ------------------------------------
2157       -- Process Atomic_Shared_Volatile --
2158       ------------------------------------
2159
2160       procedure Process_Atomic_Shared_Volatile is
2161          E_Id : Node_Id;
2162          E    : Entity_Id;
2163          D    : Node_Id;
2164          K    : Node_Kind;
2165          Utyp : Entity_Id;
2166
2167          procedure Set_Atomic (E : Entity_Id);
2168          --  Set given type as atomic, and if no explicit alignment was given,
2169          --  set alignment to unknown, since back end knows what the alignment
2170          --  requirements are for atomic arrays. Note: this step is necessary
2171          --  for derived types.
2172
2173          ----------------
2174          -- Set_Atomic --
2175          ----------------
2176
2177          procedure Set_Atomic (E : Entity_Id) is
2178          begin
2179             Set_Is_Atomic (E);
2180
2181             if not Has_Alignment_Clause (E) then
2182                Set_Alignment (E, Uint_0);
2183             end if;
2184          end Set_Atomic;
2185
2186       --  Start of processing for Process_Atomic_Shared_Volatile
2187
2188       begin
2189          Check_Ada_83_Warning;
2190          Check_No_Identifiers;
2191          Check_Arg_Count (1);
2192          Check_Arg_Is_Local_Name (Arg1);
2193          E_Id := Expression (Arg1);
2194
2195          if Etype (E_Id) = Any_Type then
2196             return;
2197          end if;
2198
2199          E := Entity (E_Id);
2200          D := Declaration_Node (E);
2201          K := Nkind (D);
2202
2203          if Is_Type (E) then
2204             if Rep_Item_Too_Early (E, N)
2205                  or else
2206                Rep_Item_Too_Late (E, N)
2207             then
2208                return;
2209             else
2210                Check_First_Subtype (Arg1);
2211             end if;
2212
2213             if Prag_Id /= Pragma_Volatile then
2214                Set_Atomic (E);
2215                Set_Atomic (Underlying_Type (E));
2216                Set_Atomic (Base_Type (E));
2217             end if;
2218
2219             --  Attribute belongs on the base type. If the view of the type is
2220             --  currently private, it also belongs on the underlying type.
2221
2222             Set_Is_Volatile (Base_Type (E));
2223             Set_Is_Volatile (Underlying_Type (E));
2224
2225             Set_Treat_As_Volatile (E);
2226             Set_Treat_As_Volatile (Underlying_Type (E));
2227
2228          elsif K = N_Object_Declaration
2229            or else (K = N_Component_Declaration
2230                      and then Original_Record_Component (E) = E)
2231          then
2232             if Rep_Item_Too_Late (E, N) then
2233                return;
2234             end if;
2235
2236             if Prag_Id /= Pragma_Volatile then
2237                Set_Is_Atomic (E);
2238
2239                --  If the object declaration has an explicit initialization, a
2240                --  temporary may have to be created to hold the expression, to
2241                --  ensure that access to the object remain atomic.
2242
2243                if Nkind (Parent (E)) = N_Object_Declaration
2244                  and then Present (Expression (Parent (E)))
2245                then
2246                   Set_Has_Delayed_Freeze (E);
2247                end if;
2248
2249                --  An interesting improvement here. If an object of type X is
2250                --  declared atomic, and the type X is not atomic, that's a
2251                --  pity, since it may not have appropriate alignment etc. We
2252                --  can rescue this in the special case where the object and
2253                --  type are in the same unit by just setting the type as
2254                --  atomic, so that the back end will process it as atomic.
2255
2256                Utyp := Underlying_Type (Etype (E));
2257
2258                if Present (Utyp)
2259                  and then Sloc (E) > No_Location
2260                  and then Sloc (Utyp) > No_Location
2261                  and then
2262                    Get_Source_File_Index (Sloc (E)) =
2263                    Get_Source_File_Index (Sloc (Underlying_Type (Etype (E))))
2264                then
2265                   Set_Is_Atomic (Underlying_Type (Etype (E)));
2266                end if;
2267             end if;
2268
2269             Set_Is_Volatile (E);
2270             Set_Treat_As_Volatile (E);
2271
2272          else
2273             Error_Pragma_Arg
2274               ("inappropriate entity for pragma%", Arg1);
2275          end if;
2276       end Process_Atomic_Shared_Volatile;
2277
2278       -------------------------------------------
2279       -- Process_Compile_Time_Warning_Or_Error --
2280       -------------------------------------------
2281
2282       procedure Process_Compile_Time_Warning_Or_Error is
2283          Arg1x : constant Node_Id := Get_Pragma_Arg (Arg1);
2284
2285       begin
2286          Check_Arg_Count (2);
2287          Check_No_Identifiers;
2288          Check_Arg_Is_Static_Expression (Arg2, Standard_String);
2289          Analyze_And_Resolve (Arg1x, Standard_Boolean);
2290
2291          if Compile_Time_Known_Value (Arg1x) then
2292             if Is_True (Expr_Value (Get_Pragma_Arg (Arg1))) then
2293                declare
2294                   Str   : constant String_Id :=
2295                             Strval (Get_Pragma_Arg (Arg2));
2296                   Len   : constant Int := String_Length (Str);
2297                   Cont  : Boolean;
2298                   Ptr   : Nat;
2299                   CC    : Char_Code;
2300                   C     : Character;
2301                   Cent  : constant Entity_Id :=
2302                             Cunit_Entity (Current_Sem_Unit);
2303
2304                   Force : constant Boolean :=
2305                             Prag_Id = Pragma_Compile_Time_Warning
2306                               and then
2307                                 Is_Spec_Name (Unit_Name (Current_Sem_Unit))
2308                               and then (Ekind (Cent) /= E_Package
2309                                           or else not In_Private_Part (Cent));
2310                   --  Set True if this is the warning case, and we are in the
2311                   --  visible part of a package spec, or in a subprogram spec,
2312                   --  in which case we want to force the client to see the
2313                   --  warning, even though it is not in the main unit.
2314
2315                begin
2316                   --  Loop through segments of message separated by line feeds.
2317                   --  We output these segments as separate messages with
2318                   --  continuation marks for all but the first.
2319
2320                   Cont := False;
2321                   Ptr := 1;
2322                   loop
2323                      Error_Msg_Strlen := 0;
2324
2325                      --  Loop to copy characters from argument to error message
2326                      --  string buffer.
2327
2328                      loop
2329                         exit when Ptr > Len;
2330                         CC := Get_String_Char (Str, Ptr);
2331                         Ptr := Ptr + 1;
2332
2333                         --  Ignore wide chars ??? else store character
2334
2335                         if In_Character_Range (CC) then
2336                            C := Get_Character (CC);
2337                            exit when C = ASCII.LF;
2338                            Error_Msg_Strlen := Error_Msg_Strlen + 1;
2339                            Error_Msg_String (Error_Msg_Strlen) := C;
2340                         end if;
2341                      end loop;
2342
2343                      --  Here with one line ready to go
2344
2345                      Error_Msg_Warn := Prag_Id = Pragma_Compile_Time_Warning;
2346
2347                      --  If this is a warning in a spec, then we want clients
2348                      --  to see the warning, so mark the message with the
2349                      --  special sequence !! to force the warning. In the case
2350                      --  of a package spec, we do not force this if we are in
2351                      --  the private part of the spec.
2352
2353                      if Force then
2354                         if Cont = False then
2355                            Error_Msg_N ("<~!!", Arg1);
2356                            Cont := True;
2357                         else
2358                            Error_Msg_N ("\<~!!", Arg1);
2359                         end if;
2360
2361                      --  Error, rather than warning, or in a body, so we do not
2362                      --  need to force visibility for client (error will be
2363                      --  output in any case, and this is the situation in which
2364                      --  we do not want a client to get a warning, since the
2365                      --  warning is in the body or the spec private part.
2366
2367                      else
2368                         if Cont = False then
2369                            Error_Msg_N ("<~", Arg1);
2370                            Cont := True;
2371                         else
2372                            Error_Msg_N ("\<~", Arg1);
2373                         end if;
2374                      end if;
2375
2376                      exit when Ptr > Len;
2377                   end loop;
2378                end;
2379             end if;
2380          end if;
2381       end Process_Compile_Time_Warning_Or_Error;
2382
2383       ------------------------
2384       -- Process_Convention --
2385       ------------------------
2386
2387       procedure Process_Convention
2388         (C   : out Convention_Id;
2389          Ent : out Entity_Id)
2390       is
2391          Id        : Node_Id;
2392          E         : Entity_Id;
2393          E1        : Entity_Id;
2394          Cname     : Name_Id;
2395          Comp_Unit : Unit_Number_Type;
2396
2397          procedure Diagnose_Multiple_Pragmas (S : Entity_Id);
2398          --  Called if we have more than one Export/Import/Convention pragma.
2399          --  This is generally illegal, but we have a special case of allowing
2400          --  Import and Interface to coexist if they specify the convention in
2401          --  a consistent manner. We are allowed to do this, since Interface is
2402          --  an implementation defined pragma, and we choose to do it since we
2403          --  know Rational allows this combination. S is the entity id of the
2404          --  subprogram in question. This procedure also sets the special flag
2405          --  Import_Interface_Present in both pragmas in the case where we do
2406          --  have matching Import and Interface pragmas.
2407
2408          procedure Set_Convention_From_Pragma (E : Entity_Id);
2409          --  Set convention in entity E, and also flag that the entity has a
2410          --  convention pragma. If entity is for a private or incomplete type,
2411          --  also set convention and flag on underlying type. This procedure
2412          --  also deals with the special case of C_Pass_By_Copy convention.
2413
2414          -------------------------------
2415          -- Diagnose_Multiple_Pragmas --
2416          -------------------------------
2417
2418          procedure Diagnose_Multiple_Pragmas (S : Entity_Id) is
2419             Pdec : constant Node_Id := Declaration_Node (S);
2420             Decl : Node_Id;
2421             Err  : Boolean;
2422
2423             function Same_Convention (Decl : Node_Id) return Boolean;
2424             --  Decl is a pragma node. This function returns True if this
2425             --  pragma has a first argument that is an identifier with a
2426             --  Chars field corresponding to the Convention_Id C.
2427
2428             function Same_Name (Decl : Node_Id) return Boolean;
2429             --  Decl is a pragma node. This function returns True if this
2430             --  pragma has a second argument that is an identifier with a
2431             --  Chars field that matches the Chars of the current subprogram.
2432
2433             ---------------------
2434             -- Same_Convention --
2435             ---------------------
2436
2437             function Same_Convention (Decl : Node_Id) return Boolean is
2438                Arg1 : constant Node_Id :=
2439                         First (Pragma_Argument_Associations (Decl));
2440
2441             begin
2442                if Present (Arg1) then
2443                   declare
2444                      Arg : constant Node_Id := Get_Pragma_Arg (Arg1);
2445                   begin
2446                      if Nkind (Arg) = N_Identifier
2447                        and then Is_Convention_Name (Chars (Arg))
2448                        and then Get_Convention_Id (Chars (Arg)) = C
2449                      then
2450                         return True;
2451                      end if;
2452                   end;
2453                end if;
2454
2455                return False;
2456             end Same_Convention;
2457
2458             ---------------
2459             -- Same_Name --
2460             ---------------
2461
2462             function Same_Name (Decl : Node_Id) return Boolean is
2463                Arg1 : constant Node_Id :=
2464                         First (Pragma_Argument_Associations (Decl));
2465                Arg2 : Node_Id;
2466
2467             begin
2468                if No (Arg1) then
2469                   return False;
2470                end if;
2471
2472                Arg2 := Next (Arg1);
2473
2474                if No (Arg2) then
2475                   return False;
2476                end if;
2477
2478                declare
2479                   Arg : constant Node_Id := Get_Pragma_Arg (Arg2);
2480                begin
2481                   if Nkind (Arg) = N_Identifier
2482                     and then Chars (Arg) = Chars (S)
2483                   then
2484                      return True;
2485                   end if;
2486                end;
2487
2488                return False;
2489             end Same_Name;
2490
2491          --  Start of processing for Diagnose_Multiple_Pragmas
2492
2493          begin
2494             Err := True;
2495
2496             --  Definitely give message if we have Convention/Export here
2497
2498             if Prag_Id = Pragma_Convention or else Prag_Id = Pragma_Export then
2499                null;
2500
2501                --  If we have an Import or Export, scan back from pragma to
2502                --  find any previous pragma applying to the same procedure.
2503                --  The scan will be terminated by the start of the list, or
2504                --  hitting the subprogram declaration. This won't allow one
2505                --  pragma to appear in the public part and one in the private
2506                --  part, but that seems very unlikely in practice.
2507
2508             else
2509                Decl := Prev (N);
2510                while Present (Decl) and then Decl /= Pdec loop
2511
2512                   --  Look for pragma with same name as us
2513
2514                   if Nkind (Decl) = N_Pragma
2515                     and then Same_Name (Decl)
2516                   then
2517                      --  Give error if same as our pragma or Export/Convention
2518
2519                      if Pragma_Name (Decl) = Name_Export
2520                           or else
2521                         Pragma_Name (Decl) = Name_Convention
2522                           or else
2523                         Pragma_Name (Decl) = Pragma_Name (N)
2524                      then
2525                         exit;
2526
2527                      --  Case of Import/Interface or the other way round
2528
2529                      elsif Pragma_Name (Decl) = Name_Interface
2530                              or else
2531                            Pragma_Name (Decl) = Name_Import
2532                      then
2533                         --  Here we know that we have Import and Interface. It
2534                         --  doesn't matter which way round they are. See if
2535                         --  they specify the same convention. If so, all OK,
2536                         --  and set special flags to stop other messages
2537
2538                         if Same_Convention (Decl) then
2539                            Set_Import_Interface_Present (N);
2540                            Set_Import_Interface_Present (Decl);
2541                            Err := False;
2542
2543                         --  If different conventions, special message
2544
2545                         else
2546                            Error_Msg_Sloc := Sloc (Decl);
2547                            Error_Pragma_Arg
2548                              ("convention differs from that given#", Arg1);
2549                            return;
2550                         end if;
2551                      end if;
2552                   end if;
2553
2554                   Next (Decl);
2555                end loop;
2556             end if;
2557
2558             --  Give message if needed if we fall through those tests
2559
2560             if Err then
2561                Error_Pragma_Arg
2562                  ("at most one Convention/Export/Import pragma is allowed",
2563                   Arg2);
2564             end if;
2565          end Diagnose_Multiple_Pragmas;
2566
2567          --------------------------------
2568          -- Set_Convention_From_Pragma --
2569          --------------------------------
2570
2571          procedure Set_Convention_From_Pragma (E : Entity_Id) is
2572          begin
2573             --  Ada 2005 (AI-430): Check invalid attempt to change convention
2574             --  for an overridden dispatching operation. Technically this is
2575             --  an amendment and should only be done in Ada 2005 mode. However,
2576             --  this is clearly a mistake, since the problem that is addressed
2577             --  by this AI is that there is a clear gap in the RM!
2578
2579             if Is_Dispatching_Operation (E)
2580               and then Present (Overridden_Operation (E))
2581               and then C /= Convention (Overridden_Operation (E))
2582             then
2583                Error_Pragma_Arg
2584                  ("cannot change convention for " &
2585                   "overridden dispatching operation",
2586                   Arg1);
2587             end if;
2588
2589             --  Set the convention
2590
2591             Set_Convention (E, C);
2592             Set_Has_Convention_Pragma (E);
2593
2594             if Is_Incomplete_Or_Private_Type (E) then
2595                Set_Convention            (Underlying_Type (E), C);
2596                Set_Has_Convention_Pragma (Underlying_Type (E), True);
2597             end if;
2598
2599             --  A class-wide type should inherit the convention of the specific
2600             --  root type (although this isn't specified clearly by the RM).
2601
2602             if Is_Type (E) and then Present (Class_Wide_Type (E)) then
2603                Set_Convention (Class_Wide_Type (E), C);
2604             end if;
2605
2606             --  If the entity is a record type, then check for special case of
2607             --  C_Pass_By_Copy, which is treated the same as C except that the
2608             --  special record flag is set. This convention is only permitted
2609             --  on record types (see AI95-00131).
2610
2611             if Cname = Name_C_Pass_By_Copy then
2612                if Is_Record_Type (E) then
2613                   Set_C_Pass_By_Copy (Base_Type (E));
2614                elsif Is_Incomplete_Or_Private_Type (E)
2615                  and then Is_Record_Type (Underlying_Type (E))
2616                then
2617                   Set_C_Pass_By_Copy (Base_Type (Underlying_Type (E)));
2618                else
2619                   Error_Pragma_Arg
2620                     ("C_Pass_By_Copy convention allowed only for record type",
2621                      Arg2);
2622                end if;
2623             end if;
2624
2625             --  If the entity is a derived boolean type, check for the special
2626             --  case of convention C, C++, or Fortran, where we consider any
2627             --  nonzero value to represent true.
2628
2629             if Is_Discrete_Type (E)
2630               and then Root_Type (Etype (E)) = Standard_Boolean
2631               and then
2632                 (C = Convention_C
2633                    or else
2634                  C = Convention_CPP
2635                    or else
2636                  C = Convention_Fortran)
2637             then
2638                Set_Nonzero_Is_True (Base_Type (E));
2639             end if;
2640          end Set_Convention_From_Pragma;
2641
2642       --  Start of processing for Process_Convention
2643
2644       begin
2645          Check_At_Least_N_Arguments (2);
2646          Check_Optional_Identifier (Arg1, Name_Convention);
2647          Check_Arg_Is_Identifier (Arg1);
2648          Cname := Chars (Expression (Arg1));
2649
2650          --  C_Pass_By_Copy is treated as a synonym for convention C (this is
2651          --  tested again below to set the critical flag).
2652          if Cname = Name_C_Pass_By_Copy then
2653             C := Convention_C;
2654
2655          --  Otherwise we must have something in the standard convention list
2656
2657          elsif Is_Convention_Name (Cname) then
2658             C := Get_Convention_Id (Chars (Expression (Arg1)));
2659
2660          --  In DEC VMS, it seems that there is an undocumented feature that
2661          --  any unrecognized convention is treated as the default, which for
2662          --  us is convention C. It does not seem so terrible to do this
2663          --  unconditionally, silently in the VMS case, and with a warning
2664          --  in the non-VMS case.
2665
2666          else
2667             if Warn_On_Export_Import and not OpenVMS_On_Target then
2668                Error_Msg_N
2669                  ("?unrecognized convention name, C assumed",
2670                   Expression (Arg1));
2671             end if;
2672
2673             C := Convention_C;
2674          end if;
2675
2676          Check_Optional_Identifier (Arg2, Name_Entity);
2677          Check_Arg_Is_Local_Name (Arg2);
2678
2679          Id := Expression (Arg2);
2680          Analyze (Id);
2681
2682          if not Is_Entity_Name (Id) then
2683             Error_Pragma_Arg ("entity name required", Arg2);
2684          end if;
2685
2686          E := Entity (Id);
2687
2688          --  Set entity to return
2689
2690          Ent := E;
2691
2692          --  Go to renamed subprogram if present, since convention applies to
2693          --  the actual renamed entity, not to the renaming entity. If the
2694          --  subprogram is inherited, go to parent subprogram.
2695
2696          if Is_Subprogram (E)
2697            and then Present (Alias (E))
2698          then
2699             if Nkind (Parent (Declaration_Node (E))) =
2700                                        N_Subprogram_Renaming_Declaration
2701             then
2702                if Scope (E) /= Scope (Alias (E)) then
2703                   Error_Pragma_Ref
2704                     ("cannot apply pragma% to non-local entity&#", E);
2705                end if;
2706
2707                E := Alias (E);
2708
2709             elsif Nkind_In (Parent (E), N_Full_Type_Declaration,
2710                                         N_Private_Extension_Declaration)
2711               and then Scope (E) = Scope (Alias (E))
2712             then
2713                E := Alias (E);
2714
2715                --  Return the parent subprogram the entity was inherited from
2716
2717                Ent := E;
2718             end if;
2719          end if;
2720
2721          --  Check that we are not applying this to a specless body
2722
2723          if Is_Subprogram (E)
2724            and then Nkind (Parent (Declaration_Node (E))) = N_Subprogram_Body
2725          then
2726             Error_Pragma
2727               ("pragma% requires separate spec and must come before body");
2728          end if;
2729
2730          --  Check that we are not applying this to a named constant
2731
2732          if Ekind_In (E, E_Named_Integer, E_Named_Real) then
2733             Error_Msg_Name_1 := Pname;
2734             Error_Msg_N
2735               ("cannot apply pragma% to named constant!",
2736                Get_Pragma_Arg (Arg2));
2737             Error_Pragma_Arg
2738               ("\supply appropriate type for&!", Arg2);
2739          end if;
2740
2741          if Ekind (E) = E_Enumeration_Literal then
2742             Error_Pragma ("enumeration literal not allowed for pragma%");
2743          end if;
2744
2745          --  Check for rep item appearing too early or too late
2746
2747          if Etype (E) = Any_Type
2748            or else Rep_Item_Too_Early (E, N)
2749          then
2750             raise Pragma_Exit;
2751          else
2752             E := Underlying_Type (E);
2753          end if;
2754
2755          if Rep_Item_Too_Late (E, N) then
2756             raise Pragma_Exit;
2757          end if;
2758
2759          if Has_Convention_Pragma (E) then
2760             Diagnose_Multiple_Pragmas (E);
2761
2762          elsif Convention (E) = Convention_Protected
2763            or else Ekind (Scope (E)) = E_Protected_Type
2764          then
2765             Error_Pragma_Arg
2766               ("a protected operation cannot be given a different convention",
2767                 Arg2);
2768          end if;
2769
2770          --  For Intrinsic, a subprogram is required
2771
2772          if C = Convention_Intrinsic
2773            and then not Is_Subprogram (E)
2774            and then not Is_Generic_Subprogram (E)
2775          then
2776             Error_Pragma_Arg
2777               ("second argument of pragma% must be a subprogram", Arg2);
2778          end if;
2779
2780          --  For Stdcall, a subprogram, variable or subprogram type is required
2781
2782          if C = Convention_Stdcall
2783            and then not Is_Subprogram (E)
2784            and then not Is_Generic_Subprogram (E)
2785            and then Ekind (E) /= E_Variable
2786            and then not
2787              (Is_Access_Type (E)
2788                and then Ekind (Designated_Type (E)) = E_Subprogram_Type)
2789          then
2790             Error_Pragma_Arg
2791               ("second argument of pragma% must be subprogram (type)",
2792                Arg2);
2793          end if;
2794
2795          if not Is_Subprogram (E)
2796            and then not Is_Generic_Subprogram (E)
2797          then
2798             Set_Convention_From_Pragma (E);
2799
2800             if Is_Type (E) then
2801                Check_First_Subtype (Arg2);
2802                Set_Convention_From_Pragma (Base_Type (E));
2803
2804                --  For subprograms, we must set the convention on the
2805                --  internally generated directly designated type as well.
2806
2807                if Ekind (E) = E_Access_Subprogram_Type then
2808                   Set_Convention_From_Pragma (Directly_Designated_Type (E));
2809                end if;
2810             end if;
2811
2812          --  For the subprogram case, set proper convention for all homonyms
2813          --  in same scope and the same declarative part, i.e. the same
2814          --  compilation unit.
2815
2816          else
2817             Comp_Unit := Get_Source_Unit (E);
2818             Set_Convention_From_Pragma (E);
2819
2820             --  Treat a pragma Import as an implicit body, for GPS use
2821
2822             if Prag_Id = Pragma_Import then
2823                Generate_Reference (E, Id, 'b');
2824             end if;
2825
2826             --  Loop through the homonyms of the pragma argument's entity
2827
2828             E1 := Ent;
2829             loop
2830                E1 := Homonym (E1);
2831                exit when No (E1) or else Scope (E1) /= Current_Scope;
2832
2833                --  Do not set the pragma on inherited operations or on formal
2834                --  subprograms.
2835
2836                if Comes_From_Source (E1)
2837                  and then Comp_Unit = Get_Source_Unit (E1)
2838                  and then not Is_Formal_Subprogram (E1)
2839                  and then Nkind (Original_Node (Parent (E1))) /=
2840                                                     N_Full_Type_Declaration
2841                then
2842                   if Present (Alias (E1))
2843                     and then Scope (E1) /= Scope (Alias (E1))
2844                   then
2845                      Error_Pragma_Ref
2846                        ("cannot apply pragma% to non-local entity& declared#",
2847                         E1);
2848                   end if;
2849
2850                   Set_Convention_From_Pragma (E1);
2851
2852                   if Prag_Id = Pragma_Import then
2853                      Generate_Reference (E1, Id, 'b');
2854                   end if;
2855                end if;
2856             end loop;
2857          end if;
2858       end Process_Convention;
2859
2860       -----------------------------------------------------
2861       -- Process_Extended_Import_Export_Exception_Pragma --
2862       -----------------------------------------------------
2863
2864       procedure Process_Extended_Import_Export_Exception_Pragma
2865         (Arg_Internal : Node_Id;
2866          Arg_External : Node_Id;
2867          Arg_Form     : Node_Id;
2868          Arg_Code     : Node_Id)
2869       is
2870          Def_Id   : Entity_Id;
2871          Code_Val : Uint;
2872
2873       begin
2874          if not OpenVMS_On_Target then
2875             Error_Pragma
2876               ("?pragma% ignored (applies only to Open'V'M'S)");
2877          end if;
2878
2879          Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2880          Def_Id := Entity (Arg_Internal);
2881
2882          if Ekind (Def_Id) /= E_Exception then
2883             Error_Pragma_Arg
2884               ("pragma% must refer to declared exception", Arg_Internal);
2885          end if;
2886
2887          Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
2888
2889          if Present (Arg_Form) then
2890             Check_Arg_Is_One_Of (Arg_Form, Name_Ada, Name_VMS);
2891          end if;
2892
2893          if Present (Arg_Form)
2894            and then Chars (Arg_Form) = Name_Ada
2895          then
2896             null;
2897          else
2898             Set_Is_VMS_Exception (Def_Id);
2899             Set_Exception_Code (Def_Id, No_Uint);
2900          end if;
2901
2902          if Present (Arg_Code) then
2903             if not Is_VMS_Exception (Def_Id) then
2904                Error_Pragma_Arg
2905                  ("Code option for pragma% not allowed for Ada case",
2906                   Arg_Code);
2907             end if;
2908
2909             Check_Arg_Is_Static_Expression (Arg_Code, Any_Integer);
2910             Code_Val := Expr_Value (Arg_Code);
2911
2912             if not UI_Is_In_Int_Range (Code_Val) then
2913                Error_Pragma_Arg
2914                  ("Code option for pragma% must be in 32-bit range",
2915                   Arg_Code);
2916
2917             else
2918                Set_Exception_Code (Def_Id, Code_Val);
2919             end if;
2920          end if;
2921       end Process_Extended_Import_Export_Exception_Pragma;
2922
2923       -------------------------------------------------
2924       -- Process_Extended_Import_Export_Internal_Arg --
2925       -------------------------------------------------
2926
2927       procedure Process_Extended_Import_Export_Internal_Arg
2928         (Arg_Internal : Node_Id := Empty)
2929       is
2930       begin
2931          if No (Arg_Internal) then
2932             Error_Pragma ("Internal parameter required for pragma%");
2933          end if;
2934
2935          if Nkind (Arg_Internal) = N_Identifier then
2936             null;
2937
2938          elsif Nkind (Arg_Internal) = N_Operator_Symbol
2939            and then (Prag_Id = Pragma_Import_Function
2940                        or else
2941                      Prag_Id = Pragma_Export_Function)
2942          then
2943             null;
2944
2945          else
2946             Error_Pragma_Arg
2947               ("wrong form for Internal parameter for pragma%", Arg_Internal);
2948          end if;
2949
2950          Check_Arg_Is_Local_Name (Arg_Internal);
2951       end Process_Extended_Import_Export_Internal_Arg;
2952
2953       --------------------------------------------------
2954       -- Process_Extended_Import_Export_Object_Pragma --
2955       --------------------------------------------------
2956
2957       procedure Process_Extended_Import_Export_Object_Pragma
2958         (Arg_Internal : Node_Id;
2959          Arg_External : Node_Id;
2960          Arg_Size     : Node_Id)
2961       is
2962          Def_Id : Entity_Id;
2963
2964       begin
2965          Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2966          Def_Id := Entity (Arg_Internal);
2967
2968          if not Ekind_In (Def_Id, E_Constant, E_Variable) then
2969             Error_Pragma_Arg
2970               ("pragma% must designate an object", Arg_Internal);
2971          end if;
2972
2973          if Has_Rep_Pragma (Def_Id, Name_Common_Object)
2974               or else
2975             Has_Rep_Pragma (Def_Id, Name_Psect_Object)
2976          then
2977             Error_Pragma_Arg
2978               ("previous Common/Psect_Object applies, pragma % not permitted",
2979                Arg_Internal);
2980          end if;
2981
2982          if Rep_Item_Too_Late (Def_Id, N) then
2983             raise Pragma_Exit;
2984          end if;
2985
2986          Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
2987
2988          if Present (Arg_Size) then
2989             Check_Arg_Is_External_Name (Arg_Size);
2990          end if;
2991
2992          --  Export_Object case
2993
2994          if Prag_Id = Pragma_Export_Object then
2995             if not Is_Library_Level_Entity (Def_Id) then
2996                Error_Pragma_Arg
2997                  ("argument for pragma% must be library level entity",
2998                   Arg_Internal);
2999             end if;
3000
3001             if Ekind (Current_Scope) = E_Generic_Package then
3002                Error_Pragma ("pragma& cannot appear in a generic unit");
3003             end if;
3004
3005             if not Size_Known_At_Compile_Time (Etype (Def_Id)) then
3006                Error_Pragma_Arg
3007                  ("exported object must have compile time known size",
3008                   Arg_Internal);
3009             end if;
3010
3011             if Warn_On_Export_Import and then Is_Exported (Def_Id) then
3012                Error_Msg_N ("?duplicate Export_Object pragma", N);
3013             else
3014                Set_Exported (Def_Id, Arg_Internal);
3015             end if;
3016
3017          --  Import_Object case
3018
3019          else
3020             if Is_Concurrent_Type (Etype (Def_Id)) then
3021                Error_Pragma_Arg
3022                  ("cannot use pragma% for task/protected object",
3023                   Arg_Internal);
3024             end if;
3025
3026             if Ekind (Def_Id) = E_Constant then
3027                Error_Pragma_Arg
3028                  ("cannot import a constant", Arg_Internal);
3029             end if;
3030
3031             if Warn_On_Export_Import
3032               and then Has_Discriminants (Etype (Def_Id))
3033             then
3034                Error_Msg_N
3035                  ("imported value must be initialized?", Arg_Internal);
3036             end if;
3037
3038             if Warn_On_Export_Import
3039               and then Is_Access_Type (Etype (Def_Id))
3040             then
3041                Error_Pragma_Arg
3042                  ("cannot import object of an access type?", Arg_Internal);
3043             end if;
3044
3045             if Warn_On_Export_Import
3046               and then Is_Imported (Def_Id)
3047             then
3048                Error_Msg_N
3049                  ("?duplicate Import_Object pragma", N);
3050
3051             --  Check for explicit initialization present. Note that an
3052             --  initialization generated by the code generator, e.g. for an
3053             --  access type, does not count here.
3054
3055             elsif Present (Expression (Parent (Def_Id)))
3056                and then
3057                  Comes_From_Source
3058                    (Original_Node (Expression (Parent (Def_Id))))
3059             then
3060                Error_Msg_Sloc := Sloc (Def_Id);
3061                Error_Pragma_Arg
3062                  ("imported entities cannot be initialized (RM B.1(24))",
3063                   "\no initialization allowed for & declared#", Arg1);
3064             else
3065                Set_Imported (Def_Id);
3066                Note_Possible_Modification (Arg_Internal, Sure => False);
3067             end if;
3068          end if;
3069       end Process_Extended_Import_Export_Object_Pragma;
3070
3071       ------------------------------------------------------
3072       -- Process_Extended_Import_Export_Subprogram_Pragma --
3073       ------------------------------------------------------
3074
3075       procedure Process_Extended_Import_Export_Subprogram_Pragma
3076         (Arg_Internal                 : Node_Id;
3077          Arg_External                 : Node_Id;
3078          Arg_Parameter_Types          : Node_Id;
3079          Arg_Result_Type              : Node_Id := Empty;
3080          Arg_Mechanism                : Node_Id;
3081          Arg_Result_Mechanism         : Node_Id := Empty;
3082          Arg_First_Optional_Parameter : Node_Id := Empty)
3083       is
3084          Ent       : Entity_Id;
3085          Def_Id    : Entity_Id;
3086          Hom_Id    : Entity_Id;
3087          Formal    : Entity_Id;
3088          Ambiguous : Boolean;
3089          Match     : Boolean;
3090          Dval      : Node_Id;
3091
3092          function Same_Base_Type
3093           (Ptype  : Node_Id;
3094            Formal : Entity_Id) return Boolean;
3095          --  Determines if Ptype references the type of Formal. Note that only
3096          --  the base types need to match according to the spec. Ptype here is
3097          --  the argument from the pragma, which is either a type name, or an
3098          --  access attribute.
3099
3100          --------------------
3101          -- Same_Base_Type --
3102          --------------------
3103
3104          function Same_Base_Type
3105            (Ptype  : Node_Id;
3106             Formal : Entity_Id) return Boolean
3107          is
3108             Ftyp : constant Entity_Id := Base_Type (Etype (Formal));
3109             Pref : Node_Id;
3110
3111          begin
3112             --  Case where pragma argument is typ'Access
3113
3114             if Nkind (Ptype) = N_Attribute_Reference
3115               and then Attribute_Name (Ptype) = Name_Access
3116             then
3117                Pref := Prefix (Ptype);
3118                Find_Type (Pref);
3119
3120                if not Is_Entity_Name (Pref)
3121                  or else Entity (Pref) = Any_Type
3122                then
3123                   raise Pragma_Exit;
3124                end if;
3125
3126                --  We have a match if the corresponding argument is of an
3127                --  anonymous access type, and its designated type matches the
3128                --  type of the prefix of the access attribute
3129
3130                return Ekind (Ftyp) = E_Anonymous_Access_Type
3131                  and then Base_Type (Entity (Pref)) =
3132                             Base_Type (Etype (Designated_Type (Ftyp)));
3133
3134             --  Case where pragma argument is a type name
3135
3136             else
3137                Find_Type (Ptype);
3138
3139                if not Is_Entity_Name (Ptype)
3140                  or else Entity (Ptype) = Any_Type
3141                then
3142                   raise Pragma_Exit;
3143                end if;
3144
3145                --  We have a match if the corresponding argument is of the type
3146                --  given in the pragma (comparing base types)
3147
3148                return Base_Type (Entity (Ptype)) = Ftyp;
3149             end if;
3150          end Same_Base_Type;
3151
3152       --  Start of processing for
3153       --  Process_Extended_Import_Export_Subprogram_Pragma
3154
3155       begin
3156          Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
3157          Ent := Empty;
3158          Ambiguous := False;
3159
3160          --  Loop through homonyms (overloadings) of the entity
3161
3162          Hom_Id := Entity (Arg_Internal);
3163          while Present (Hom_Id) loop
3164             Def_Id := Get_Base_Subprogram (Hom_Id);
3165
3166             --  We need a subprogram in the current scope
3167
3168             if not Is_Subprogram (Def_Id)
3169               or else Scope (Def_Id) /= Current_Scope
3170             then
3171                null;
3172
3173             else
3174                Match := True;
3175
3176                --  Pragma cannot apply to subprogram body
3177
3178                if Is_Subprogram (Def_Id)
3179                  and then Nkind (Parent (Declaration_Node (Def_Id))) =
3180                                                              N_Subprogram_Body
3181                then
3182                   Error_Pragma
3183                     ("pragma% requires separate spec"
3184                       & " and must come before body");
3185                end if;
3186
3187                --  Test result type if given, note that the result type
3188                --  parameter can only be present for the function cases.
3189
3190                if Present (Arg_Result_Type)
3191                  and then not Same_Base_Type (Arg_Result_Type, Def_Id)
3192                then
3193                   Match := False;
3194
3195                elsif Etype (Def_Id) /= Standard_Void_Type
3196                  and then
3197                    (Pname = Name_Export_Procedure
3198                       or else
3199                     Pname = Name_Import_Procedure)
3200                then
3201                   Match := False;
3202
3203                --  Test parameter types if given. Note that this parameter
3204                --  has not been analyzed (and must not be, since it is
3205                --  semantic nonsense), so we get it as the parser left it.
3206
3207                elsif Present (Arg_Parameter_Types) then
3208                   Check_Matching_Types : declare
3209                      Formal : Entity_Id;
3210                      Ptype  : Node_Id;
3211
3212                   begin
3213                      Formal := First_Formal (Def_Id);
3214
3215                      if Nkind (Arg_Parameter_Types) = N_Null then
3216                         if Present (Formal) then
3217                            Match := False;
3218                         end if;
3219
3220                      --  A list of one type, e.g. (List) is parsed as
3221                      --  a parenthesized expression.
3222
3223                      elsif Nkind (Arg_Parameter_Types) /= N_Aggregate
3224                        and then Paren_Count (Arg_Parameter_Types) = 1
3225                      then
3226                         if No (Formal)
3227                           or else Present (Next_Formal (Formal))
3228                         then
3229                            Match := False;
3230                         else
3231                            Match :=
3232                              Same_Base_Type (Arg_Parameter_Types, Formal);
3233                         end if;
3234
3235                      --  A list of more than one type is parsed as a aggregate
3236
3237                      elsif Nkind (Arg_Parameter_Types) = N_Aggregate
3238                        and then Paren_Count (Arg_Parameter_Types) = 0
3239                      then
3240                         Ptype := First (Expressions (Arg_Parameter_Types));
3241                         while Present (Ptype) or else Present (Formal) loop
3242                            if No (Ptype)
3243                              or else No (Formal)
3244                              or else not Same_Base_Type (Ptype, Formal)
3245                            then
3246                               Match := False;
3247                               exit;
3248                            else
3249                               Next_Formal (Formal);
3250                               Next (Ptype);
3251                            end if;
3252                         end loop;
3253
3254                      --  Anything else is of the wrong form
3255
3256                      else
3257                         Error_Pragma_Arg
3258                           ("wrong form for Parameter_Types parameter",
3259                            Arg_Parameter_Types);
3260                      end if;
3261                   end Check_Matching_Types;
3262                end if;
3263
3264                --  Match is now False if the entry we found did not match
3265                --  either a supplied Parameter_Types or Result_Types argument
3266
3267                if Match then
3268                   if No (Ent) then
3269                      Ent := Def_Id;
3270
3271                   --  Ambiguous case, the flag Ambiguous shows if we already
3272                   --  detected this and output the initial messages.
3273
3274                   else
3275                      if not Ambiguous then
3276                         Ambiguous := True;
3277                         Error_Msg_Name_1 := Pname;
3278                         Error_Msg_N
3279                           ("pragma% does not uniquely identify subprogram!",
3280                            N);
3281                         Error_Msg_Sloc := Sloc (Ent);
3282                         Error_Msg_N ("matching subprogram #!", N);
3283                         Ent := Empty;
3284                      end if;
3285
3286                      Error_Msg_Sloc := Sloc (Def_Id);
3287                      Error_Msg_N ("matching subprogram #!", N);
3288                   end if;
3289                end if;
3290             end if;
3291
3292             Hom_Id := Homonym (Hom_Id);
3293          end loop;
3294
3295          --  See if we found an entry
3296
3297          if No (Ent) then
3298             if not Ambiguous then
3299                if Is_Generic_Subprogram (Entity (Arg_Internal)) then
3300                   Error_Pragma
3301                     ("pragma% cannot be given for generic subprogram");
3302                else
3303                   Error_Pragma
3304                     ("pragma% does not identify local subprogram");
3305                end if;
3306             end if;
3307
3308             return;
3309          end if;
3310
3311          --  Import pragmas must be for imported entities
3312
3313          if Prag_Id = Pragma_Import_Function
3314               or else
3315             Prag_Id = Pragma_Import_Procedure
3316               or else
3317             Prag_Id = Pragma_Import_Valued_Procedure
3318          then
3319             if not Is_Imported (Ent) then
3320                Error_Pragma
3321                  ("pragma Import or Interface must precede pragma%");
3322             end if;
3323
3324          --  Here we have the Export case which can set the entity as exported
3325
3326          --  But does not do so if the specified external name is null, since
3327          --  that is taken as a signal in DEC Ada 83 (with which we want to be
3328          --  compatible) to request no external name.
3329
3330          elsif Nkind (Arg_External) = N_String_Literal
3331            and then String_Length (Strval (Arg_External)) = 0
3332          then
3333             null;
3334
3335          --  In all other cases, set entity as exported
3336
3337          else
3338             Set_Exported (Ent, Arg_Internal);
3339          end if;
3340
3341          --  Special processing for Valued_Procedure cases
3342
3343          if Prag_Id = Pragma_Import_Valued_Procedure
3344            or else
3345             Prag_Id = Pragma_Export_Valued_Procedure
3346          then
3347             Formal := First_Formal (Ent);
3348
3349             if No (Formal) then
3350                Error_Pragma ("at least one parameter required for pragma%");
3351
3352             elsif Ekind (Formal) /= E_Out_Parameter then
3353                Error_Pragma ("first parameter must have mode out for pragma%");
3354
3355             else
3356                Set_Is_Valued_Procedure (Ent);
3357             end if;
3358          end if;
3359
3360          Set_Extended_Import_Export_External_Name (Ent, Arg_External);
3361
3362          --  Process Result_Mechanism argument if present. We have already
3363          --  checked that this is only allowed for the function case.
3364
3365          if Present (Arg_Result_Mechanism) then
3366             Set_Mechanism_Value (Ent, Arg_Result_Mechanism);
3367          end if;
3368
3369          --  Process Mechanism parameter if present. Note that this parameter
3370          --  is not analyzed, and must not be analyzed since it is semantic
3371          --  nonsense, so we get it in exactly as the parser left it.
3372
3373          if Present (Arg_Mechanism) then
3374             declare
3375                Formal : Entity_Id;
3376                Massoc : Node_Id;
3377                Mname  : Node_Id;
3378                Choice : Node_Id;
3379
3380             begin
3381                --  A single mechanism association without a formal parameter
3382                --  name is parsed as a parenthesized expression. All other
3383                --  cases are parsed as aggregates, so we rewrite the single
3384                --  parameter case as an aggregate for consistency.
3385
3386                if Nkind (Arg_Mechanism) /= N_Aggregate
3387                  and then Paren_Count (Arg_Mechanism) = 1
3388                then
3389                   Rewrite (Arg_Mechanism,
3390                     Make_Aggregate (Sloc (Arg_Mechanism),
3391                       Expressions => New_List (
3392                         Relocate_Node (Arg_Mechanism))));
3393                end if;
3394
3395                --  Case of only mechanism name given, applies to all formals
3396
3397                if Nkind (Arg_Mechanism) /= N_Aggregate then
3398                   Formal := First_Formal (Ent);
3399                   while Present (Formal) loop
3400                      Set_Mechanism_Value (Formal, Arg_Mechanism);
3401                      Next_Formal (Formal);
3402                   end loop;
3403
3404                --  Case of list of mechanism associations given
3405
3406                else
3407                   if Null_Record_Present (Arg_Mechanism) then
3408                      Error_Pragma_Arg
3409                        ("inappropriate form for Mechanism parameter",
3410                         Arg_Mechanism);
3411                   end if;
3412
3413                   --  Deal with positional ones first
3414
3415                   Formal := First_Formal (Ent);
3416
3417                   if Present (Expressions (Arg_Mechanism)) then
3418                      Mname := First (Expressions (Arg_Mechanism));
3419                      while Present (Mname) loop
3420                         if No (Formal) then
3421                            Error_Pragma_Arg
3422                              ("too many mechanism associations", Mname);
3423                         end if;
3424
3425                         Set_Mechanism_Value (Formal, Mname);
3426                         Next_Formal (Formal);
3427                         Next (Mname);
3428                      end loop;
3429                   end if;
3430
3431                   --  Deal with named entries
3432
3433                   if Present (Component_Associations (Arg_Mechanism)) then
3434                      Massoc := First (Component_Associations (Arg_Mechanism));
3435                      while Present (Massoc) loop
3436                         Choice := First (Choices (Massoc));
3437
3438                         if Nkind (Choice) /= N_Identifier
3439                           or else Present (Next (Choice))
3440                         then
3441                            Error_Pragma_Arg
3442                              ("incorrect form for mechanism association",
3443                               Massoc);
3444                         end if;
3445
3446                         Formal := First_Formal (Ent);
3447                         loop
3448                            if No (Formal) then
3449                               Error_Pragma_Arg
3450                                 ("parameter name & not present", Choice);
3451                            end if;
3452
3453                            if Chars (Choice) = Chars (Formal) then
3454                               Set_Mechanism_Value
3455                                 (Formal, Expression (Massoc));
3456
3457                               --  Set entity on identifier for ASIS
3458
3459                               Set_Entity (Choice, Formal);
3460
3461                               exit;
3462                            end if;
3463
3464                            Next_Formal (Formal);
3465                         end loop;
3466
3467                         Next (Massoc);
3468                      end loop;
3469                   end if;
3470                end if;
3471             end;
3472          end if;
3473
3474          --  Process First_Optional_Parameter argument if present. We have
3475          --  already checked that this is only allowed for the Import case.
3476
3477          if Present (Arg_First_Optional_Parameter) then
3478             if Nkind (Arg_First_Optional_Parameter) /= N_Identifier then
3479                Error_Pragma_Arg
3480                  ("first optional parameter must be formal parameter name",
3481                   Arg_First_Optional_Parameter);
3482             end if;
3483
3484             Formal := First_Formal (Ent);
3485             loop
3486                if No (Formal) then
3487                   Error_Pragma_Arg
3488                     ("specified formal parameter& not found",
3489                      Arg_First_Optional_Parameter);
3490                end if;
3491
3492                exit when Chars (Formal) =
3493                          Chars (Arg_First_Optional_Parameter);
3494
3495                Next_Formal (Formal);
3496             end loop;
3497
3498             Set_First_Optional_Parameter (Ent, Formal);
3499
3500             --  Check specified and all remaining formals have right form
3501
3502             while Present (Formal) loop
3503                if Ekind (Formal) /= E_In_Parameter then
3504                   Error_Msg_NE
3505                     ("optional formal& is not of mode in!",
3506                      Arg_First_Optional_Parameter, Formal);
3507
3508                else
3509                   Dval := Default_Value (Formal);
3510
3511                   if No (Dval) then
3512                      Error_Msg_NE
3513                        ("optional formal& does not have default value!",
3514                         Arg_First_Optional_Parameter, Formal);
3515
3516                   elsif Compile_Time_Known_Value_Or_Aggr (Dval) then
3517                      null;
3518
3519                   else
3520                      Error_Msg_FE
3521                        ("default value for optional formal& is non-static!",
3522                         Arg_First_Optional_Parameter, Formal);
3523                   end if;
3524                end if;
3525
3526                Set_Is_Optional_Parameter (Formal);
3527                Next_Formal (Formal);
3528             end loop;
3529          end if;
3530       end Process_Extended_Import_Export_Subprogram_Pragma;
3531
3532       --------------------------
3533       -- Process_Generic_List --
3534       --------------------------
3535
3536       procedure Process_Generic_List is
3537          Arg : Node_Id;
3538          Exp : Node_Id;
3539
3540       begin
3541          Check_No_Identifiers;
3542          Check_At_Least_N_Arguments (1);
3543
3544          Arg := Arg1;
3545          while Present (Arg) loop
3546             Exp := Expression (Arg);
3547             Analyze (Exp);
3548
3549             if not Is_Entity_Name (Exp)
3550               or else
3551                 (not Is_Generic_Instance (Entity (Exp))
3552                   and then
3553                  not Is_Generic_Unit (Entity (Exp)))
3554             then
3555                Error_Pragma_Arg
3556                  ("pragma% argument must be name of generic unit/instance",
3557                   Arg);
3558             end if;
3559
3560             Next (Arg);
3561          end loop;
3562       end Process_Generic_List;
3563
3564       ---------------------------------
3565       -- Process_Import_Or_Interface --
3566       ---------------------------------
3567
3568       procedure Process_Import_Or_Interface is
3569          C      : Convention_Id;
3570          Def_Id : Entity_Id;
3571          Hom_Id : Entity_Id;
3572
3573       begin
3574          Process_Convention (C, Def_Id);
3575          Kill_Size_Check_Code (Def_Id);
3576          Note_Possible_Modification (Expression (Arg2), Sure => False);
3577
3578          if Ekind_In (Def_Id, E_Variable, E_Constant) then
3579
3580             --  We do not permit Import to apply to a renaming declaration
3581
3582             if Present (Renamed_Object (Def_Id)) then
3583                Error_Pragma_Arg
3584                  ("pragma% not allowed for object renaming", Arg2);
3585
3586             --  User initialization is not allowed for imported object, but
3587             --  the object declaration may contain a default initialization,
3588             --  that will be discarded. Note that an explicit initialization
3589             --  only counts if it comes from source, otherwise it is simply
3590             --  the code generator making an implicit initialization explicit.
3591
3592             elsif Present (Expression (Parent (Def_Id)))
3593               and then Comes_From_Source (Expression (Parent (Def_Id)))
3594             then
3595                Error_Msg_Sloc := Sloc (Def_Id);
3596                Error_Pragma_Arg
3597                  ("no initialization allowed for declaration of& #",
3598                   "\imported entities cannot be initialized (RM B.1(24))",
3599                   Arg2);
3600
3601             else
3602                Set_Imported (Def_Id);
3603                Process_Interface_Name (Def_Id, Arg3, Arg4);
3604
3605                --  Note that we do not set Is_Public here. That's because we
3606                --  only want to set it if there is no address clause, and we
3607                --  don't know that yet, so we delay that processing till
3608                --  freeze time.
3609
3610                --  pragma Import completes deferred constants
3611
3612                if Ekind (Def_Id) = E_Constant then
3613                   Set_Has_Completion (Def_Id);
3614                end if;
3615
3616                --  It is not possible to import a constant of an unconstrained
3617                --  array type (e.g. string) because there is no simple way to
3618                --  write a meaningful subtype for it.
3619
3620                if Is_Array_Type (Etype (Def_Id))
3621                  and then not Is_Constrained (Etype (Def_Id))
3622                then
3623                   Error_Msg_NE
3624                     ("imported constant& must have a constrained subtype",
3625                       N, Def_Id);
3626                end if;
3627             end if;
3628
3629          elsif Is_Subprogram (Def_Id)
3630            or else Is_Generic_Subprogram (Def_Id)
3631          then
3632             --  If the name is overloaded, pragma applies to all of the
3633             --  denoted entities in the same declarative part.
3634
3635             Hom_Id := Def_Id;
3636             while Present (Hom_Id) loop
3637                Def_Id := Get_Base_Subprogram (Hom_Id);
3638
3639                --  Ignore inherited subprograms because the pragma will
3640                --  apply to the parent operation, which is the one called.
3641
3642                if Is_Overloadable (Def_Id)
3643                  and then Present (Alias (Def_Id))
3644                then
3645                   null;
3646
3647                --  If it is not a subprogram, it must be in an outer scope and
3648                --  pragma does not apply.
3649
3650                elsif not Is_Subprogram (Def_Id)
3651                  and then not Is_Generic_Subprogram (Def_Id)
3652                then
3653                   null;
3654
3655                --  Verify that the homonym is in the same declarative part (not
3656                --  just the same scope).
3657
3658                elsif Parent (Unit_Declaration_Node (Def_Id)) /= Parent (N)
3659                  and then Nkind (Parent (N)) /= N_Compilation_Unit_Aux
3660                then
3661                   exit;
3662
3663                else
3664                   Set_Imported (Def_Id);
3665
3666                   --  Reject an Import applied to an abstract subprogram
3667
3668                   if Is_Subprogram (Def_Id)
3669                     and then Is_Abstract_Subprogram (Def_Id)
3670                   then
3671                      Error_Msg_Sloc := Sloc (Def_Id);
3672                      Error_Msg_NE
3673                        ("cannot import abstract subprogram& declared#",
3674                         Arg2, Def_Id);
3675                   end if;
3676
3677                   --  Special processing for Convention_Intrinsic
3678
3679                   if C = Convention_Intrinsic then
3680
3681                      --  Link_Name argument not allowed for intrinsic
3682
3683                      if Present (Arg3)
3684                        and then Chars (Arg3) = Name_Link_Name
3685                      then
3686                         Arg4 := Arg3;
3687                      end if;
3688
3689                      if Present (Arg4) then
3690                         Error_Pragma_Arg
3691                           ("Link_Name argument not allowed for " &
3692                            "Import Intrinsic",
3693                            Arg4);
3694                      end if;
3695
3696                      Set_Is_Intrinsic_Subprogram (Def_Id);
3697
3698                      --  If no external name is present, then check that this
3699                      --  is a valid intrinsic subprogram. If an external name
3700                      --  is present, then this is handled by the back end.
3701
3702                      if No (Arg3) then
3703                         Check_Intrinsic_Subprogram (Def_Id, Expression (Arg2));
3704                      end if;
3705                   end if;
3706
3707                   --  All interfaced procedures need an external symbol created
3708                   --  for them since they are always referenced from another
3709                   --  object file.
3710
3711                   Set_Is_Public (Def_Id);
3712
3713                   --  Verify that the subprogram does not have a completion
3714                   --  through a renaming declaration. For other completions the
3715                   --  pragma appears as a too late representation.
3716
3717                   declare
3718                      Decl : constant Node_Id := Unit_Declaration_Node (Def_Id);
3719
3720                   begin
3721                      if Present (Decl)
3722                        and then Nkind (Decl) = N_Subprogram_Declaration
3723                        and then Present (Corresponding_Body (Decl))
3724                        and then Nkind (Unit_Declaration_Node
3725                                         (Corresponding_Body (Decl))) =
3726                                              N_Subprogram_Renaming_Declaration
3727                      then
3728                         Error_Msg_Sloc := Sloc (Def_Id);
3729                         Error_Msg_NE
3730                           ("cannot import&, renaming already provided for " &
3731                            "declaration #", N, Def_Id);
3732                      end if;
3733                   end;
3734
3735                   Set_Has_Completion (Def_Id);
3736                   Process_Interface_Name (Def_Id, Arg3, Arg4);
3737                end if;
3738
3739                if Is_Compilation_Unit (Hom_Id) then
3740
3741                   --  Its possible homonyms are not affected by the pragma.
3742                   --  Such homonyms might be present in the context of other
3743                   --  units being compiled.
3744
3745                   exit;
3746
3747                else
3748                   Hom_Id := Homonym (Hom_Id);
3749                end if;
3750             end loop;
3751
3752          --  When the convention is Java or CIL, we also allow Import to be
3753          --  given for packages, generic packages, exceptions, record
3754          --  components, and access to subprograms.
3755
3756          elsif (C = Convention_Java or else C = Convention_CIL)
3757            and then
3758              (Is_Package_Or_Generic_Package (Def_Id)
3759                or else Ekind (Def_Id) = E_Exception
3760                or else Ekind (Def_Id) = E_Access_Subprogram_Type
3761                or else Nkind (Parent (Def_Id)) = N_Component_Declaration)
3762          then
3763             Set_Imported (Def_Id);
3764             Set_Is_Public (Def_Id);
3765             Process_Interface_Name (Def_Id, Arg3, Arg4);
3766
3767          --  Import a CPP class
3768
3769          elsif Is_Record_Type (Def_Id)
3770            and then C = Convention_CPP
3771          then
3772             --  Types treated as CPP classes are treated as limited, but we
3773             --  don't require them to be declared this way. A warning is
3774             --  issued to encourage the user to declare them as limited.
3775             --  This is not an error, for compatibility reasons, because
3776             --  these types have been supported this way for some time.
3777
3778             if not Is_Limited_Type (Def_Id) then
3779                Error_Msg_N
3780                  ("imported 'C'P'P type should be " &
3781                     "explicitly declared limited?",
3782                   Get_Pragma_Arg (Arg2));
3783                Error_Msg_N
3784                  ("\type will be considered limited",
3785                   Get_Pragma_Arg (Arg2));
3786             end if;
3787
3788             Set_Is_CPP_Class (Def_Id);
3789             Set_Is_Limited_Record (Def_Id);
3790
3791             --  Imported CPP types must not have discriminants (because C++
3792             --  classes do not have discriminants).
3793
3794             if Has_Discriminants (Def_Id) then
3795                Error_Msg_N
3796                  ("imported 'C'P'P type cannot have discriminants",
3797                   First (Discriminant_Specifications
3798                           (Declaration_Node (Def_Id))));
3799             end if;
3800
3801             --  Components of imported CPP types must not have default
3802             --  expressions because the constructor (if any) is on the
3803             --  C++ side.
3804
3805             declare
3806                Tdef  : constant Node_Id :=
3807                          Type_Definition (Declaration_Node (Def_Id));
3808                Clist : Node_Id;
3809                Comp  : Node_Id;
3810
3811             begin
3812                if Nkind (Tdef) = N_Record_Definition then
3813                   Clist := Component_List (Tdef);
3814
3815                else
3816                   pragma Assert (Nkind (Tdef) = N_Derived_Type_Definition);
3817                   Clist := Component_List (Record_Extension_Part (Tdef));
3818                end if;
3819
3820                if Present (Clist) then
3821                   Comp := First (Component_Items (Clist));
3822                   while Present (Comp) loop
3823                      if Present (Expression (Comp)) then
3824                         Error_Msg_N
3825                           ("component of imported 'C'P'P type cannot have" &
3826                            " default expression", Expression (Comp));
3827                      end if;
3828
3829                      Next (Comp);
3830                   end loop;
3831                end if;
3832             end;
3833
3834          else
3835             Error_Pragma_Arg
3836               ("second argument of pragma% must be object or subprogram",
3837                Arg2);
3838          end if;
3839
3840          --  If this pragma applies to a compilation unit, then the unit, which
3841          --  is a subprogram, does not require (or allow) a body. We also do
3842          --  not need to elaborate imported procedures.
3843
3844          if Nkind (Parent (N)) = N_Compilation_Unit_Aux then
3845             declare
3846                Cunit : constant Node_Id := Parent (Parent (N));
3847             begin
3848                Set_Body_Required (Cunit, False);
3849             end;
3850          end if;
3851       end Process_Import_Or_Interface;
3852
3853       --------------------
3854       -- Process_Inline --
3855       --------------------
3856
3857       procedure Process_Inline (Active : Boolean) is
3858          Assoc     : Node_Id;
3859          Decl      : Node_Id;
3860          Subp_Id   : Node_Id;
3861          Subp      : Entity_Id;
3862          Applies   : Boolean;
3863          Effective : Boolean := False;
3864
3865          procedure Make_Inline (Subp : Entity_Id);
3866          --  Subp is the defining unit name of the subprogram declaration. Set
3867          --  the flag, as well as the flag in the corresponding body, if there
3868          --  is one present.
3869
3870          procedure Set_Inline_Flags (Subp : Entity_Id);
3871          --  Sets Is_Inlined and Has_Pragma_Inline flags for Subp and also
3872          --  Has_Pragma_Inline_Always for the Inline_Always case.
3873
3874          function Inlining_Not_Possible (Subp : Entity_Id) return Boolean;
3875          --  Returns True if it can be determined at this stage that inlining
3876          --  is not possible, for example if the body is available and contains
3877          --  exception handlers, we prevent inlining, since otherwise we can
3878          --  get undefined symbols at link time. This function also emits a
3879          --  warning if front-end inlining is enabled and the pragma appears
3880          --  too late.
3881          --
3882          --  ??? is business with link symbols still valid, or does it relate
3883          --  to front end ZCX which is being phased out ???
3884
3885          ---------------------------
3886          -- Inlining_Not_Possible --
3887          ---------------------------
3888
3889          function Inlining_Not_Possible (Subp : Entity_Id) return Boolean is
3890             Decl  : constant Node_Id := Unit_Declaration_Node (Subp);
3891             Stats : Node_Id;
3892
3893          begin
3894             if Nkind (Decl) = N_Subprogram_Body then
3895                Stats := Handled_Statement_Sequence (Decl);
3896                return Present (Exception_Handlers (Stats))
3897                  or else Present (At_End_Proc (Stats));
3898
3899             elsif Nkind (Decl) = N_Subprogram_Declaration
3900               and then Present (Corresponding_Body (Decl))
3901             then
3902                if Front_End_Inlining
3903                  and then Analyzed (Corresponding_Body (Decl))
3904                then
3905                   Error_Msg_N ("pragma appears too late, ignored?", N);
3906                   return True;
3907
3908                --  If the subprogram is a renaming as body, the body is just a
3909                --  call to the renamed subprogram, and inlining is trivially
3910                --  possible.
3911
3912                elsif
3913                  Nkind (Unit_Declaration_Node (Corresponding_Body (Decl))) =
3914                                              N_Subprogram_Renaming_Declaration
3915                then
3916                   return False;
3917
3918                else
3919                   Stats :=
3920                     Handled_Statement_Sequence
3921                         (Unit_Declaration_Node (Corresponding_Body (Decl)));
3922
3923                   return
3924                     Present (Exception_Handlers (Stats))
3925                       or else Present (At_End_Proc (Stats));
3926                end if;
3927
3928             else
3929                --  If body is not available, assume the best, the check is
3930                --  performed again when compiling enclosing package bodies.
3931
3932                return False;
3933             end if;
3934          end Inlining_Not_Possible;
3935
3936          -----------------
3937          -- Make_Inline --
3938          -----------------
3939
3940          procedure Make_Inline (Subp : Entity_Id) is
3941             Kind       : constant Entity_Kind := Ekind (Subp);
3942             Inner_Subp : Entity_Id   := Subp;
3943
3944          begin
3945             --  Ignore if bad type, avoid cascaded error
3946
3947             if Etype (Subp) = Any_Type then
3948                Applies := True;
3949                return;
3950
3951             --  Ignore if all inlining is suppressed
3952
3953             elsif Suppress_All_Inlining then
3954                Applies := True;
3955                return;
3956
3957             --  If inlining is not possible, for now do not treat as an error
3958
3959             elsif Inlining_Not_Possible (Subp) then
3960                Applies := True;
3961                return;
3962
3963             --  Here we have a candidate for inlining, but we must exclude
3964             --  derived operations. Otherwise we would end up trying to inline
3965             --  a phantom declaration, and the result would be to drag in a
3966             --  body which has no direct inlining associated with it. That
3967             --  would not only be inefficient but would also result in the
3968             --  backend doing cross-unit inlining in cases where it was
3969             --  definitely inappropriate to do so.
3970
3971             --  However, a simple Comes_From_Source test is insufficient, since
3972             --  we do want to allow inlining of generic instances which also do
3973             --  not come from source. We also need to recognize specs generated
3974             --  by the front-end for bodies that carry the pragma. Finally,
3975             --  predefined operators do not come from source but are not
3976             --  inlineable either.
3977
3978             elsif Is_Generic_Instance (Subp)
3979               or else Nkind (Parent (Parent (Subp))) = N_Subprogram_Declaration
3980             then
3981                null;
3982
3983             elsif not Comes_From_Source (Subp)
3984               and then Scope (Subp) /= Standard_Standard
3985             then
3986                Applies := True;
3987                return;
3988             end if;
3989
3990             --  The referenced entity must either be the enclosing entity, or
3991             --  an entity declared within the current open scope.
3992
3993             if Present (Scope (Subp))
3994               and then Scope (Subp) /= Current_Scope
3995               and then Subp /= Current_Scope
3996             then
3997                Error_Pragma_Arg
3998                  ("argument of% must be entity in current scope", Assoc);
3999                return;
4000             end if;
4001
4002             --  Processing for procedure, operator or function. If subprogram
4003             --  is aliased (as for an instance) indicate that the renamed
4004             --  entity (if declared in the same unit) is inlined.
4005
4006             if Is_Subprogram (Subp) then
4007                Inner_Subp := Ultimate_Alias (Inner_Subp);
4008
4009                if In_Same_Source_Unit (Subp, Inner_Subp) then
4010                   Set_Inline_Flags (Inner_Subp);
4011
4012                   Decl := Parent (Parent (Inner_Subp));
4013
4014                   if Nkind (Decl) = N_Subprogram_Declaration
4015                     and then Present (Corresponding_Body (Decl))
4016                   then
4017                      Set_Inline_Flags (Corresponding_Body (Decl));
4018
4019                   elsif Is_Generic_Instance (Subp) then
4020
4021                      --  Indicate that the body needs to be created for
4022                      --  inlining subsequent calls. The instantiation node
4023                      --  follows the declaration of the wrapper package
4024                      --  created for it.
4025
4026                      if Scope (Subp) /= Standard_Standard
4027                        and then
4028                          Need_Subprogram_Instance_Body
4029                           (Next (Unit_Declaration_Node (Scope (Alias (Subp)))),
4030                               Subp)
4031                      then
4032                         null;
4033                      end if;
4034                   end if;
4035                end if;
4036
4037                Applies := True;
4038
4039             --  For a generic subprogram set flag as well, for use at the point
4040             --  of instantiation, to determine whether the body should be
4041             --  generated.
4042
4043             elsif Is_Generic_Subprogram (Subp) then
4044                Set_Inline_Flags (Subp);
4045                Applies := True;
4046
4047             --  Literals are by definition inlined
4048
4049             elsif Kind = E_Enumeration_Literal then
4050                null;
4051
4052             --  Anything else is an error
4053
4054             else
4055                Error_Pragma_Arg
4056                  ("expect subprogram name for pragma%", Assoc);
4057             end if;
4058          end Make_Inline;
4059
4060          ----------------------
4061          -- Set_Inline_Flags --
4062          ----------------------
4063
4064          procedure Set_Inline_Flags (Subp : Entity_Id) is
4065          begin
4066             if Active then
4067                Set_Is_Inlined (Subp, True);
4068             end if;
4069
4070             if not Has_Pragma_Inline (Subp) then
4071                Set_Has_Pragma_Inline (Subp);
4072                Effective := True;
4073             end if;
4074
4075             if Prag_Id = Pragma_Inline_Always then
4076                Set_Has_Pragma_Inline_Always (Subp);
4077             end if;
4078          end Set_Inline_Flags;
4079
4080       --  Start of processing for Process_Inline
4081
4082       begin
4083          Check_No_Identifiers;
4084          Check_At_Least_N_Arguments (1);
4085
4086          if Active then
4087             Inline_Processing_Required := True;
4088          end if;
4089
4090          Assoc := Arg1;
4091          while Present (Assoc) loop
4092             Subp_Id := Expression (Assoc);
4093             Analyze (Subp_Id);
4094             Applies := False;
4095
4096             if Is_Entity_Name (Subp_Id) then
4097                Subp := Entity (Subp_Id);
4098
4099                if Subp = Any_Id then
4100
4101                   --  If previous error, avoid cascaded errors
4102
4103                   Applies := True;
4104                   Effective := True;
4105
4106                else
4107                   Make_Inline (Subp);
4108
4109                   while Present (Homonym (Subp))
4110                     and then Scope (Homonym (Subp)) = Current_Scope
4111                   loop
4112                      Make_Inline (Homonym (Subp));
4113                      Subp := Homonym (Subp);
4114                   end loop;
4115                end if;
4116             end if;
4117
4118             if not Applies then
4119                Error_Pragma_Arg
4120                  ("inappropriate argument for pragma%", Assoc);
4121
4122             elsif not Effective
4123               and then Warn_On_Redundant_Constructs
4124               and then not Suppress_All_Inlining
4125             then
4126                if Inlining_Not_Possible (Subp) then
4127                   Error_Msg_NE
4128                     ("pragma Inline for& is ignored?", N, Entity (Subp_Id));
4129                else
4130                   Error_Msg_NE
4131                     ("pragma Inline for& is redundant?", N, Entity (Subp_Id));
4132                end if;
4133             end if;
4134
4135             Next (Assoc);
4136          end loop;
4137       end Process_Inline;
4138
4139       ----------------------------
4140       -- Process_Interface_Name --
4141       ----------------------------
4142
4143       procedure Process_Interface_Name
4144         (Subprogram_Def : Entity_Id;
4145          Ext_Arg        : Node_Id;
4146          Link_Arg       : Node_Id)
4147       is
4148          Ext_Nam    : Node_Id;
4149          Link_Nam   : Node_Id;
4150          String_Val : String_Id;
4151
4152          procedure Check_Form_Of_Interface_Name
4153            (SN            : Node_Id;
4154             Ext_Name_Case : Boolean);
4155          --  SN is a string literal node for an interface name. This routine
4156          --  performs some minimal checks that the name is reasonable. In
4157          --  particular that no spaces or other obviously incorrect characters
4158          --  appear. This is only a warning, since any characters are allowed.
4159          --  Ext_Name_Case is True for an External_Name, False for a Link_Name.
4160
4161          ----------------------------------
4162          -- Check_Form_Of_Interface_Name --
4163          ----------------------------------
4164
4165          procedure Check_Form_Of_Interface_Name
4166            (SN            : Node_Id;
4167             Ext_Name_Case : Boolean)
4168          is
4169             S  : constant String_Id := Strval (Expr_Value_S (SN));
4170             SL : constant Nat       := String_Length (S);
4171             C  : Char_Code;
4172
4173          begin
4174             if SL = 0 then
4175                Error_Msg_N ("interface name cannot be null string", SN);
4176             end if;
4177
4178             for J in 1 .. SL loop
4179                C := Get_String_Char (S, J);
4180
4181                --  Look for dubious character and issue unconditional warning.
4182                --  Definitely dubious if not in character range.
4183
4184                if not In_Character_Range (C)
4185
4186                   --  For all cases except CLI target,
4187                   --  commas, spaces and slashes are dubious (in CLI, we use
4188                   --  commas and backslashes in external names to specify
4189                   --  assembly version and public key, while slashes and spaces
4190                   --  can be used in names to mark nested classes and
4191                   --  valuetypes).
4192
4193                   or else ((not Ext_Name_Case or else VM_Target /= CLI_Target)
4194                              and then (Get_Character (C) = ','
4195                                          or else
4196                                        Get_Character (C) = '\'))
4197                  or else (VM_Target /= CLI_Target
4198                             and then (Get_Character (C) = ' '
4199                                         or else
4200                                       Get_Character (C) = '/'))
4201                then
4202                   Error_Msg
4203                     ("?interface name contains illegal character",
4204                      Sloc (SN) + Source_Ptr (J));
4205                end if;
4206             end loop;
4207          end Check_Form_Of_Interface_Name;
4208
4209       --  Start of processing for Process_Interface_Name
4210
4211       begin
4212          if No (Link_Arg) then
4213             if No (Ext_Arg) then
4214                if VM_Target = CLI_Target
4215                  and then Ekind (Subprogram_Def) = E_Package
4216                  and then Nkind (Parent (Subprogram_Def)) =
4217                                                  N_Package_Specification
4218                  and then Present (Generic_Parent (Parent (Subprogram_Def)))
4219                then
4220                   Set_Interface_Name
4221                      (Subprogram_Def,
4222                       Interface_Name
4223                         (Generic_Parent (Parent (Subprogram_Def))));
4224                end if;
4225
4226                return;
4227
4228             elsif Chars (Ext_Arg) = Name_Link_Name then
4229                Ext_Nam  := Empty;
4230                Link_Nam := Expression (Ext_Arg);
4231
4232             else
4233                Check_Optional_Identifier (Ext_Arg, Name_External_Name);
4234                Ext_Nam  := Expression (Ext_Arg);
4235                Link_Nam := Empty;
4236             end if;
4237
4238          else
4239             Check_Optional_Identifier (Ext_Arg,  Name_External_Name);
4240             Check_Optional_Identifier (Link_Arg, Name_Link_Name);
4241             Ext_Nam  := Expression (Ext_Arg);
4242             Link_Nam := Expression (Link_Arg);
4243          end if;
4244
4245          --  Check expressions for external name and link name are static
4246
4247          if Present (Ext_Nam) then
4248             Check_Arg_Is_Static_Expression (Ext_Nam, Standard_String);
4249             Check_Form_Of_Interface_Name (Ext_Nam, Ext_Name_Case => True);
4250
4251             --  Verify that external name is not the name of a local entity,
4252             --  which would hide the imported one and could lead to run-time
4253             --  surprises. The problem can only arise for entities declared in
4254             --  a package body (otherwise the external name is fully qualified
4255             --  and will not conflict).
4256
4257             declare
4258                Nam : Name_Id;
4259                E   : Entity_Id;
4260                Par : Node_Id;
4261
4262             begin
4263                if Prag_Id = Pragma_Import then
4264                   String_To_Name_Buffer (Strval (Expr_Value_S (Ext_Nam)));
4265                   Nam := Name_Find;
4266                   E   := Entity_Id (Get_Name_Table_Info (Nam));
4267
4268                   if Nam /= Chars (Subprogram_Def)
4269                     and then Present (E)
4270                     and then not Is_Overloadable (E)
4271                     and then Is_Immediately_Visible (E)
4272                     and then not Is_Imported (E)
4273                     and then Ekind (Scope (E)) = E_Package
4274                   then
4275                      Par := Parent (E);
4276                      while Present (Par) loop
4277                         if Nkind (Par) = N_Package_Body then
4278                            Error_Msg_Sloc := Sloc (E);
4279                            Error_Msg_NE
4280                              ("imported entity is hidden by & declared#",
4281                               Ext_Arg, E);
4282                            exit;
4283                         end if;
4284
4285                         Par := Parent (Par);
4286                      end loop;
4287                   end if;
4288                end if;
4289             end;
4290          end if;
4291
4292          if Present (Link_Nam) then
4293             Check_Arg_Is_Static_Expression (Link_Nam, Standard_String);
4294             Check_Form_Of_Interface_Name (Link_Nam, Ext_Name_Case => False);
4295          end if;
4296
4297          --  If there is no link name, just set the external name
4298
4299          if No (Link_Nam) then
4300             Link_Nam := Adjust_External_Name_Case (Expr_Value_S (Ext_Nam));
4301
4302          --  For the Link_Name case, the given literal is preceded by an
4303          --  asterisk, which indicates to GCC that the given name should be
4304          --  taken literally, and in particular that no prepending of
4305          --  underlines should occur, even in systems where this is the
4306          --  normal default.
4307
4308          else
4309             Start_String;
4310
4311             if VM_Target = No_VM then
4312                Store_String_Char (Get_Char_Code ('*'));
4313             end if;
4314
4315             String_Val := Strval (Expr_Value_S (Link_Nam));
4316             Store_String_Chars (String_Val);
4317             Link_Nam :=
4318               Make_String_Literal (Sloc (Link_Nam),
4319                 Strval => End_String);
4320          end if;
4321
4322          Set_Encoded_Interface_Name
4323            (Get_Base_Subprogram (Subprogram_Def), Link_Nam);
4324
4325          --  We allow duplicated export names in CIL, as they are always
4326          --  enclosed in a namespace that differentiates them, and overloaded
4327          --  entities are supported by the VM.
4328
4329          if Convention (Subprogram_Def) /= Convention_CIL then
4330             Check_Duplicated_Export_Name (Link_Nam);
4331          end if;
4332       end Process_Interface_Name;
4333
4334       -----------------------------------------
4335       -- Process_Interrupt_Or_Attach_Handler --
4336       -----------------------------------------
4337
4338       procedure Process_Interrupt_Or_Attach_Handler is
4339          Arg1_X       : constant Node_Id   := Expression (Arg1);
4340          Handler_Proc : constant Entity_Id := Entity (Arg1_X);
4341          Proc_Scope   : constant Entity_Id := Scope (Handler_Proc);
4342
4343       begin
4344          Set_Is_Interrupt_Handler (Handler_Proc);
4345
4346          --  If the pragma is not associated with a handler procedure within a
4347          --  protected type, then it must be for a nonprotected procedure for
4348          --  the AAMP target, in which case we don't associate a representation
4349          --  item with the procedure's scope.
4350
4351          if Ekind (Proc_Scope) = E_Protected_Type then
4352             if Prag_Id = Pragma_Interrupt_Handler
4353                  or else
4354                Prag_Id = Pragma_Attach_Handler
4355             then
4356                Record_Rep_Item (Proc_Scope, N);
4357             end if;
4358          end if;
4359       end Process_Interrupt_Or_Attach_Handler;
4360
4361       --------------------------------------------------
4362       -- Process_Restrictions_Or_Restriction_Warnings --
4363       --------------------------------------------------
4364
4365       --  Note: some of the simple identifier cases were handled in par-prag,
4366       --  but it is harmless (and more straightforward) to simply handle all
4367       --  cases here, even if it means we repeat a bit of work in some cases.
4368
4369       procedure Process_Restrictions_Or_Restriction_Warnings
4370         (Warn : Boolean)
4371       is
4372          Arg   : Node_Id;
4373          R_Id  : Restriction_Id;
4374          Id    : Name_Id;
4375          Expr  : Node_Id;
4376          Val   : Uint;
4377
4378          procedure Check_Unit_Name (N : Node_Id);
4379          --  Checks unit name parameter for No_Dependence. Returns if it has
4380          --  an appropriate form, otherwise raises pragma argument error.
4381
4382          ---------------------
4383          -- Check_Unit_Name --
4384          ---------------------
4385
4386          procedure Check_Unit_Name (N : Node_Id) is
4387          begin
4388             if Nkind (N) = N_Selected_Component then
4389                Check_Unit_Name (Prefix (N));
4390                Check_Unit_Name (Selector_Name (N));
4391
4392             elsif Nkind (N) = N_Identifier then
4393                return;
4394
4395             else
4396                Error_Pragma_Arg
4397                  ("wrong form for unit name for No_Dependence", N);
4398             end if;
4399          end Check_Unit_Name;
4400
4401       --  Start of processing for Process_Restrictions_Or_Restriction_Warnings
4402
4403       begin
4404          Check_Ada_83_Warning;
4405          Check_At_Least_N_Arguments (1);
4406          Check_Valid_Configuration_Pragma;
4407
4408          Arg := Arg1;
4409          while Present (Arg) loop
4410             Id := Chars (Arg);
4411             Expr := Expression (Arg);
4412
4413             --  Case of no restriction identifier present
4414
4415             if Id = No_Name then
4416                if Nkind (Expr) /= N_Identifier then
4417                   Error_Pragma_Arg
4418                     ("invalid form for restriction", Arg);
4419                end if;
4420
4421                R_Id :=
4422                  Get_Restriction_Id
4423                    (Process_Restriction_Synonyms (Expr));
4424
4425                if R_Id not in All_Boolean_Restrictions then
4426                   Error_Msg_Name_1 := Pname;
4427                   Error_Msg_N
4428                     ("invalid restriction identifier&", Get_Pragma_Arg (Arg));
4429
4430                   --  Check for possible misspelling
4431
4432                   for J in Restriction_Id loop
4433                      declare
4434                         Rnm : constant String := Restriction_Id'Image (J);
4435
4436                      begin
4437                         Name_Buffer (1 .. Rnm'Length) := Rnm;
4438                         Name_Len := Rnm'Length;
4439                         Set_Casing (All_Lower_Case);
4440
4441                         if Is_Bad_Spelling_Of (Chars (Expr), Name_Enter) then
4442                            Set_Casing
4443                              (Identifier_Casing (Current_Source_File));
4444                            Error_Msg_String (1 .. Rnm'Length) :=
4445                              Name_Buffer (1 .. Name_Len);
4446                            Error_Msg_Strlen := Rnm'Length;
4447                            Error_Msg_N -- CODEFIX
4448                              ("\possible misspelling of ""~""",
4449                               Get_Pragma_Arg (Arg));
4450                            exit;
4451                         end if;
4452                      end;
4453                   end loop;
4454
4455                   raise Pragma_Exit;
4456                end if;
4457
4458                if Implementation_Restriction (R_Id) then
4459                   Check_Restriction (No_Implementation_Restrictions, Arg);
4460                end if;
4461
4462                --  If this is a warning, then set the warning unless we already
4463                --  have a real restriction active (we never want a warning to
4464                --  override a real restriction).
4465
4466                if Warn then
4467                   if not Restriction_Active (R_Id) then
4468                      Set_Restriction (R_Id, N);
4469                      Restriction_Warnings (R_Id) := True;
4470                   end if;
4471
4472                --  If real restriction case, then set it and make sure that the
4473                --  restriction warning flag is off, since a real restriction
4474                --  always overrides a warning.
4475
4476                else
4477                   Set_Restriction (R_Id, N);
4478                   Restriction_Warnings (R_Id) := False;
4479                end if;
4480
4481                --  Check for obsolescent restrictions in Ada 2005 mode
4482
4483                if not Warn
4484                  and then Ada_Version >= Ada_2005
4485                  and then (R_Id = No_Asynchronous_Control
4486                             or else
4487                            R_Id = No_Unchecked_Deallocation
4488                             or else
4489                            R_Id = No_Unchecked_Conversion)
4490                then
4491                   Check_Restriction (No_Obsolescent_Features, N);
4492                end if;
4493
4494                --  A very special case that must be processed here: pragma
4495                --  Restrictions (No_Exceptions) turns off all run-time
4496                --  checking. This is a bit dubious in terms of the formal
4497                --  language definition, but it is what is intended by RM
4498                --  H.4(12). Restriction_Warnings never affects generated code
4499                --  so this is done only in the real restriction case.
4500
4501                if R_Id = No_Exceptions and then not Warn then
4502                   Scope_Suppress := (others => True);
4503                end if;
4504
4505             --  Case of No_Dependence => unit-name. Note that the parser
4506             --  already made the necessary entry in the No_Dependence table.
4507
4508             elsif Id = Name_No_Dependence then
4509                Check_Unit_Name (Expr);
4510
4511             --  All other cases of restriction identifier present
4512
4513             else
4514                R_Id := Get_Restriction_Id (Process_Restriction_Synonyms (Arg));
4515                Analyze_And_Resolve (Expr, Any_Integer);
4516
4517                if R_Id not in All_Parameter_Restrictions then
4518                   Error_Pragma_Arg
4519                     ("invalid restriction parameter identifier", Arg);
4520
4521                elsif not Is_OK_Static_Expression (Expr) then
4522                   Flag_Non_Static_Expr
4523                     ("value must be static expression!", Expr);
4524                   raise Pragma_Exit;
4525
4526                elsif not Is_Integer_Type (Etype (Expr))
4527                  or else Expr_Value (Expr) < 0
4528                then
4529                   Error_Pragma_Arg
4530                     ("value must be non-negative integer", Arg);
4531                end if;
4532
4533                --  Restriction pragma is active
4534
4535                Val := Expr_Value (Expr);
4536
4537                if not UI_Is_In_Int_Range (Val) then
4538                   Error_Pragma_Arg
4539                     ("pragma ignored, value too large?", Arg);
4540                end if;
4541
4542                --  Warning case. If the real restriction is active, then we
4543                --  ignore the request, since warning never overrides a real
4544                --  restriction. Otherwise we set the proper warning. Note that
4545                --  this circuit sets the warning again if it is already set,
4546                --  which is what we want, since the constant may have changed.
4547
4548                if Warn then
4549                   if not Restriction_Active (R_Id) then
4550                      Set_Restriction
4551                        (R_Id, N, Integer (UI_To_Int (Val)));
4552                      Restriction_Warnings (R_Id) := True;
4553                   end if;
4554
4555                --  Real restriction case, set restriction and make sure warning
4556                --  flag is off since real restriction always overrides warning.
4557
4558                else
4559                   Set_Restriction (R_Id, N, Integer (UI_To_Int (Val)));
4560                   Restriction_Warnings (R_Id) := False;
4561                end if;
4562             end if;
4563
4564             Next (Arg);
4565          end loop;
4566       end Process_Restrictions_Or_Restriction_Warnings;
4567
4568       ---------------------------------
4569       -- Process_Suppress_Unsuppress --
4570       ---------------------------------
4571
4572       --  Note: this procedure makes entries in the check suppress data
4573       --  structures managed by Sem. See spec of package Sem for full
4574       --  details on how we handle recording of check suppression.
4575
4576       procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean) is
4577          C    : Check_Id;
4578          E_Id : Node_Id;
4579          E    : Entity_Id;
4580
4581          In_Package_Spec : constant Boolean :=
4582                              Is_Package_Or_Generic_Package (Current_Scope)
4583                                and then not In_Package_Body (Current_Scope);
4584
4585          procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id);
4586          --  Used to suppress a single check on the given entity
4587
4588          --------------------------------
4589          -- Suppress_Unsuppress_Echeck --
4590          --------------------------------
4591
4592          procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id) is
4593          begin
4594             Set_Checks_May_Be_Suppressed (E);
4595
4596             if In_Package_Spec then
4597                Push_Global_Suppress_Stack_Entry
4598                  (Entity   => E,
4599                   Check    => C,
4600                   Suppress => Suppress_Case);
4601
4602             else
4603                Push_Local_Suppress_Stack_Entry
4604                  (Entity   => E,
4605                   Check    => C,
4606                   Suppress => Suppress_Case);
4607             end if;
4608
4609             --  If this is a first subtype, and the base type is distinct,
4610             --  then also set the suppress flags on the base type.
4611
4612             if Is_First_Subtype (E)
4613               and then Etype (E) /= E
4614             then
4615                Suppress_Unsuppress_Echeck (Etype (E), C);
4616             end if;
4617          end Suppress_Unsuppress_Echeck;
4618
4619       --  Start of processing for Process_Suppress_Unsuppress
4620
4621       begin
4622          --  Suppress/Unsuppress can appear as a configuration pragma, or in a
4623          --  declarative part or a package spec (RM 11.5(5)).
4624
4625          if not Is_Configuration_Pragma then
4626             Check_Is_In_Decl_Part_Or_Package_Spec;
4627          end if;
4628
4629          Check_At_Least_N_Arguments (1);
4630          Check_At_Most_N_Arguments (2);
4631          Check_No_Identifier (Arg1);
4632          Check_Arg_Is_Identifier (Arg1);
4633
4634          C := Get_Check_Id (Chars (Expression (Arg1)));
4635
4636          if C = No_Check_Id then
4637             Error_Pragma_Arg
4638               ("argument of pragma% is not valid check name", Arg1);
4639          end if;
4640
4641          if not Suppress_Case
4642            and then (C = All_Checks or else C = Overflow_Check)
4643          then
4644             Opt.Overflow_Checks_Unsuppressed := True;
4645          end if;
4646
4647          if Arg_Count = 1 then
4648
4649             --  Make an entry in the local scope suppress table. This is the
4650             --  table that directly shows the current value of the scope
4651             --  suppress check for any check id value.
4652
4653             if C = All_Checks then
4654
4655                --  For All_Checks, we set all specific predefined checks with
4656                --  the exception of Elaboration_Check, which is handled
4657                --  specially because of not wanting All_Checks to have the
4658                --  effect of deactivating static elaboration order processing.
4659
4660                for J in Scope_Suppress'Range loop
4661                   if J /= Elaboration_Check then
4662                      Scope_Suppress (J) := Suppress_Case;
4663                   end if;
4664                end loop;
4665
4666             --  If not All_Checks, and predefined check, then set appropriate
4667             --  scope entry. Note that we will set Elaboration_Check if this
4668             --  is explicitly specified.
4669
4670             elsif C in Predefined_Check_Id then
4671                Scope_Suppress (C) := Suppress_Case;
4672             end if;
4673
4674             --  Also make an entry in the Local_Entity_Suppress table
4675
4676             Push_Local_Suppress_Stack_Entry
4677               (Entity   => Empty,
4678                Check    => C,
4679                Suppress => Suppress_Case);
4680
4681          --  Case of two arguments present, where the check is suppressed for
4682          --  a specified entity (given as the second argument of the pragma)
4683
4684          else
4685             --  This is obsolescent in Ada 2005 mode
4686
4687             if Ada_Version >= Ada_2005 then
4688                Check_Restriction (No_Obsolescent_Features, Arg2);
4689             end if;
4690
4691             Check_Optional_Identifier (Arg2, Name_On);
4692             E_Id := Expression (Arg2);
4693             Analyze (E_Id);
4694
4695             if not Is_Entity_Name (E_Id) then
4696                Error_Pragma_Arg
4697                  ("second argument of pragma% must be entity name", Arg2);
4698             end if;
4699
4700             E := Entity (E_Id);
4701
4702             if E = Any_Id then
4703                return;
4704             end if;
4705
4706             --  Enforce RM 11.5(7) which requires that for a pragma that
4707             --  appears within a package spec, the named entity must be
4708             --  within the package spec. We allow the package name itself
4709             --  to be mentioned since that makes sense, although it is not
4710             --  strictly allowed by 11.5(7).
4711
4712             if In_Package_Spec
4713               and then E /= Current_Scope
4714               and then Scope (E) /= Current_Scope
4715             then
4716                Error_Pragma_Arg
4717                  ("entity in pragma% is not in package spec (RM 11.5(7))",
4718                   Arg2);
4719             end if;
4720
4721             --  Loop through homonyms. As noted below, in the case of a package
4722             --  spec, only homonyms within the package spec are considered.
4723
4724             loop
4725                Suppress_Unsuppress_Echeck (E, C);
4726
4727                if Is_Generic_Instance (E)
4728                  and then Is_Subprogram (E)
4729                  and then Present (Alias (E))
4730                then
4731                   Suppress_Unsuppress_Echeck (Alias (E), C);
4732                end if;
4733
4734                --  Move to next homonym
4735
4736                E := Homonym (E);
4737                exit when No (E);
4738
4739                --  If we are within a package specification, the pragma only
4740                --  applies to homonyms in the same scope.
4741
4742                exit when In_Package_Spec
4743                  and then Scope (E) /= Current_Scope;
4744             end loop;
4745          end if;
4746       end Process_Suppress_Unsuppress;
4747
4748       ------------------
4749       -- Set_Exported --
4750       ------------------
4751
4752       procedure Set_Exported (E : Entity_Id; Arg : Node_Id) is
4753       begin
4754          if Is_Imported (E) then
4755             Error_Pragma_Arg
4756               ("cannot export entity& that was previously imported", Arg);
4757
4758          elsif Present (Address_Clause (E)) then
4759             Error_Pragma_Arg
4760               ("cannot export entity& that has an address clause", Arg);
4761          end if;
4762
4763          Set_Is_Exported (E);
4764
4765          --  Generate a reference for entity explicitly, because the
4766          --  identifier may be overloaded and name resolution will not
4767          --  generate one.
4768
4769          Generate_Reference (E, Arg);
4770
4771          --  Deal with exporting non-library level entity
4772
4773          if not Is_Library_Level_Entity (E) then
4774
4775             --  Not allowed at all for subprograms
4776
4777             if Is_Subprogram (E) then
4778                Error_Pragma_Arg ("local subprogram& cannot be exported", Arg);
4779
4780             --  Otherwise set public and statically allocated
4781
4782             else
4783                Set_Is_Public (E);
4784                Set_Is_Statically_Allocated (E);
4785
4786                --  Warn if the corresponding W flag is set and the pragma comes
4787                --  from source. The latter may not be true e.g. on VMS where we
4788                --  expand export pragmas for exception codes associated with
4789                --  imported or exported exceptions. We do not want to generate
4790                --  a warning for something that the user did not write.
4791
4792                if Warn_On_Export_Import
4793                  and then Comes_From_Source (Arg)
4794                then
4795                   Error_Msg_NE
4796                     ("?& has been made static as a result of Export", Arg, E);
4797                   Error_Msg_N
4798                     ("\this usage is non-standard and non-portable", Arg);
4799                end if;
4800             end if;
4801          end if;
4802
4803          if Warn_On_Export_Import and then Is_Type (E) then
4804             Error_Msg_NE ("exporting a type has no effect?", Arg, E);
4805          end if;
4806
4807          if Warn_On_Export_Import and Inside_A_Generic then
4808             Error_Msg_NE
4809               ("all instances of& will have the same external name?", Arg, E);
4810          end if;
4811       end Set_Exported;
4812
4813       ----------------------------------------------
4814       -- Set_Extended_Import_Export_External_Name --
4815       ----------------------------------------------
4816
4817       procedure Set_Extended_Import_Export_External_Name
4818         (Internal_Ent : Entity_Id;
4819          Arg_External : Node_Id)
4820       is
4821          Old_Name : constant Node_Id := Interface_Name (Internal_Ent);
4822          New_Name : Node_Id;
4823
4824       begin
4825          if No (Arg_External) then
4826             return;
4827          end if;
4828
4829          Check_Arg_Is_External_Name (Arg_External);
4830
4831          if Nkind (Arg_External) = N_String_Literal then
4832             if String_Length (Strval (Arg_External)) = 0 then
4833                return;
4834             else
4835                New_Name := Adjust_External_Name_Case (Arg_External);
4836             end if;
4837
4838          elsif Nkind (Arg_External) = N_Identifier then
4839             New_Name := Get_Default_External_Name (Arg_External);
4840
4841          --  Check_Arg_Is_External_Name should let through only identifiers and
4842          --  string literals or static string expressions (which are folded to
4843          --  string literals).
4844
4845          else
4846             raise Program_Error;
4847          end if;
4848
4849          --  If we already have an external name set (by a prior normal Import
4850          --  or Export pragma), then the external names must match
4851
4852          if Present (Interface_Name (Internal_Ent)) then
4853             Check_Matching_Internal_Names : declare
4854                S1 : constant String_Id := Strval (Old_Name);
4855                S2 : constant String_Id := Strval (New_Name);
4856
4857                procedure Mismatch;
4858                --  Called if names do not match
4859
4860                --------------
4861                -- Mismatch --
4862                --------------
4863
4864                procedure Mismatch is
4865                begin
4866                   Error_Msg_Sloc := Sloc (Old_Name);
4867                   Error_Pragma_Arg
4868                     ("external name does not match that given #",
4869                      Arg_External);
4870                end Mismatch;
4871
4872             --  Start of processing for Check_Matching_Internal_Names
4873
4874             begin
4875                if String_Length (S1) /= String_Length (S2) then
4876                   Mismatch;
4877
4878                else
4879                   for J in 1 .. String_Length (S1) loop
4880                      if Get_String_Char (S1, J) /= Get_String_Char (S2, J) then
4881                         Mismatch;
4882                      end if;
4883                   end loop;
4884                end if;
4885             end Check_Matching_Internal_Names;
4886
4887          --  Otherwise set the given name
4888
4889          else
4890             Set_Encoded_Interface_Name (Internal_Ent, New_Name);
4891             Check_Duplicated_Export_Name (New_Name);
4892          end if;
4893       end Set_Extended_Import_Export_External_Name;
4894
4895       ------------------
4896       -- Set_Imported --
4897       ------------------
4898
4899       procedure Set_Imported (E : Entity_Id) is
4900       begin
4901          --  Error message if already imported or exported
4902
4903          if Is_Exported (E) or else Is_Imported (E) then
4904
4905             --  Error if being set Exported twice
4906
4907             if Is_Exported (E) then
4908                Error_Msg_NE ("entity& was previously exported", N, E);
4909
4910             --  OK if Import/Interface case
4911
4912             elsif Import_Interface_Present (N) then
4913                goto OK;
4914
4915             --  Error if being set Imported twice
4916
4917             else
4918                Error_Msg_NE ("entity& was previously imported", N, E);
4919             end if;
4920
4921             Error_Msg_Name_1 := Pname;
4922             Error_Msg_N
4923               ("\(pragma% applies to all previous entities)", N);
4924
4925             Error_Msg_Sloc  := Sloc (E);
4926             Error_Msg_NE ("\import not allowed for& declared#", N, E);
4927
4928          --  Here if not previously imported or exported, OK to import
4929
4930          else
4931             Set_Is_Imported (E);
4932
4933             --  If the entity is an object that is not at the library level,
4934             --  then it is statically allocated. We do not worry about objects
4935             --  with address clauses in this context since they are not really
4936             --  imported in the linker sense.
4937
4938             if Is_Object (E)
4939               and then not Is_Library_Level_Entity (E)
4940               and then No (Address_Clause (E))
4941             then
4942                Set_Is_Statically_Allocated (E);
4943             end if;
4944          end if;
4945
4946          <<OK>> null;
4947       end Set_Imported;
4948
4949       -------------------------
4950       -- Set_Mechanism_Value --
4951       -------------------------
4952
4953       --  Note: the mechanism name has not been analyzed (and cannot indeed be
4954       --  analyzed, since it is semantic nonsense), so we get it in the exact
4955       --  form created by the parser.
4956
4957       procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id) is
4958          Class        : Node_Id;
4959          Param        : Node_Id;
4960          Mech_Name_Id : Name_Id;
4961
4962          procedure Bad_Class;
4963          --  Signal bad descriptor class name
4964
4965          procedure Bad_Mechanism;
4966          --  Signal bad mechanism name
4967
4968          ---------------
4969          -- Bad_Class --
4970          ---------------
4971
4972          procedure Bad_Class is
4973          begin
4974             Error_Pragma_Arg ("unrecognized descriptor class name", Class);
4975          end Bad_Class;
4976
4977          -------------------------
4978          -- Bad_Mechanism_Value --
4979          -------------------------
4980
4981          procedure Bad_Mechanism is
4982          begin
4983             Error_Pragma_Arg ("unrecognized mechanism name", Mech_Name);
4984          end Bad_Mechanism;
4985
4986       --  Start of processing for Set_Mechanism_Value
4987
4988       begin
4989          if Mechanism (Ent) /= Default_Mechanism then
4990             Error_Msg_NE
4991               ("mechanism for & has already been set", Mech_Name, Ent);
4992          end if;
4993
4994          --  MECHANISM_NAME ::= value | reference | descriptor |
4995          --                     short_descriptor
4996
4997          if Nkind (Mech_Name) = N_Identifier then
4998             if Chars (Mech_Name) = Name_Value then
4999                Set_Mechanism (Ent, By_Copy);
5000                return;
5001
5002             elsif Chars (Mech_Name) = Name_Reference then
5003                Set_Mechanism (Ent, By_Reference);
5004                return;
5005
5006             elsif Chars (Mech_Name) = Name_Descriptor then
5007                Check_VMS (Mech_Name);
5008
5009                --  Descriptor => Short_Descriptor if pragma was given
5010
5011                if Short_Descriptors then
5012                   Set_Mechanism (Ent, By_Short_Descriptor);
5013                else
5014                   Set_Mechanism (Ent, By_Descriptor);
5015                end if;
5016
5017                return;
5018
5019             elsif Chars (Mech_Name) = Name_Short_Descriptor then
5020                Check_VMS (Mech_Name);
5021                Set_Mechanism (Ent, By_Short_Descriptor);
5022                return;
5023
5024             elsif Chars (Mech_Name) = Name_Copy then
5025                Error_Pragma_Arg
5026                  ("bad mechanism name, Value assumed", Mech_Name);
5027
5028             else
5029                Bad_Mechanism;
5030             end if;
5031
5032          --  MECHANISM_NAME ::= descriptor (CLASS_NAME) |
5033          --                     short_descriptor (CLASS_NAME)
5034          --  CLASS_NAME     ::= ubs | ubsb | uba | s | sb | a | nca
5035
5036          --  Note: this form is parsed as an indexed component
5037
5038          elsif Nkind (Mech_Name) = N_Indexed_Component then
5039             Class := First (Expressions (Mech_Name));
5040
5041             if Nkind (Prefix (Mech_Name)) /= N_Identifier
5042              or else not (Chars (Prefix (Mech_Name)) = Name_Descriptor or else
5043                           Chars (Prefix (Mech_Name)) = Name_Short_Descriptor)
5044              or else Present (Next (Class))
5045             then
5046                Bad_Mechanism;
5047             else
5048                Mech_Name_Id := Chars (Prefix (Mech_Name));
5049
5050                --  Change Descriptor => Short_Descriptor if pragma was given
5051
5052                if Mech_Name_Id = Name_Descriptor
5053                  and then Short_Descriptors
5054                then
5055                   Mech_Name_Id := Name_Short_Descriptor;
5056                end if;
5057             end if;
5058
5059          --  MECHANISM_NAME ::= descriptor (Class => CLASS_NAME) |
5060          --                     short_descriptor (Class => CLASS_NAME)
5061          --  CLASS_NAME     ::= ubs | ubsb | uba | s | sb | a | nca
5062
5063          --  Note: this form is parsed as a function call
5064
5065          elsif Nkind (Mech_Name) = N_Function_Call then
5066             Param := First (Parameter_Associations (Mech_Name));
5067
5068             if Nkind (Name (Mech_Name)) /= N_Identifier
5069               or else not (Chars (Name (Mech_Name)) = Name_Descriptor or else
5070                            Chars (Name (Mech_Name)) = Name_Short_Descriptor)
5071               or else Present (Next (Param))
5072               or else No (Selector_Name (Param))
5073               or else Chars (Selector_Name (Param)) /= Name_Class
5074             then
5075                Bad_Mechanism;
5076             else
5077                Class := Explicit_Actual_Parameter (Param);
5078                Mech_Name_Id := Chars (Name (Mech_Name));
5079             end if;
5080
5081          else
5082             Bad_Mechanism;
5083          end if;
5084
5085          --  Fall through here with Class set to descriptor class name
5086
5087          Check_VMS (Mech_Name);
5088
5089          if Nkind (Class) /= N_Identifier then
5090             Bad_Class;
5091
5092          elsif Mech_Name_Id = Name_Descriptor
5093            and then Chars (Class) = Name_UBS
5094          then
5095             Set_Mechanism (Ent, By_Descriptor_UBS);
5096
5097          elsif Mech_Name_Id = Name_Descriptor
5098            and then Chars (Class) = Name_UBSB
5099          then
5100             Set_Mechanism (Ent, By_Descriptor_UBSB);
5101
5102          elsif Mech_Name_Id = Name_Descriptor
5103            and then Chars (Class) = Name_UBA
5104          then
5105             Set_Mechanism (Ent, By_Descriptor_UBA);
5106
5107          elsif Mech_Name_Id = Name_Descriptor
5108            and then Chars (Class) = Name_S
5109          then
5110             Set_Mechanism (Ent, By_Descriptor_S);
5111
5112          elsif Mech_Name_Id = Name_Descriptor
5113            and then Chars (Class) = Name_SB
5114          then
5115             Set_Mechanism (Ent, By_Descriptor_SB);
5116
5117          elsif Mech_Name_Id = Name_Descriptor
5118            and then Chars (Class) = Name_A
5119          then
5120             Set_Mechanism (Ent, By_Descriptor_A);
5121
5122          elsif Mech_Name_Id = Name_Descriptor
5123            and then Chars (Class) = Name_NCA
5124          then
5125             Set_Mechanism (Ent, By_Descriptor_NCA);
5126
5127          elsif Mech_Name_Id = Name_Short_Descriptor
5128            and then Chars (Class) = Name_UBS
5129          then
5130             Set_Mechanism (Ent, By_Short_Descriptor_UBS);
5131
5132          elsif Mech_Name_Id = Name_Short_Descriptor
5133            and then Chars (Class) = Name_UBSB
5134          then
5135             Set_Mechanism (Ent, By_Short_Descriptor_UBSB);
5136
5137          elsif Mech_Name_Id = Name_Short_Descriptor
5138            and then Chars (Class) = Name_UBA
5139          then
5140             Set_Mechanism (Ent, By_Short_Descriptor_UBA);
5141
5142          elsif Mech_Name_Id = Name_Short_Descriptor
5143            and then Chars (Class) = Name_S
5144          then
5145             Set_Mechanism (Ent, By_Short_Descriptor_S);
5146
5147          elsif Mech_Name_Id = Name_Short_Descriptor
5148            and then Chars (Class) = Name_SB
5149          then
5150             Set_Mechanism (Ent, By_Short_Descriptor_SB);
5151
5152          elsif Mech_Name_Id = Name_Short_Descriptor
5153            and then Chars (Class) = Name_A
5154          then
5155             Set_Mechanism (Ent, By_Short_Descriptor_A);
5156
5157          elsif Mech_Name_Id = Name_Short_Descriptor
5158            and then Chars (Class) = Name_NCA
5159          then
5160             Set_Mechanism (Ent, By_Short_Descriptor_NCA);
5161
5162          else
5163             Bad_Class;
5164          end if;
5165       end Set_Mechanism_Value;
5166
5167       ---------------------------
5168       -- Set_Ravenscar_Profile --
5169       ---------------------------
5170
5171       --  The tasks to be done here are
5172
5173       --    Set required policies
5174
5175       --      pragma Task_Dispatching_Policy (FIFO_Within_Priorities)
5176       --      pragma Locking_Policy (Ceiling_Locking)
5177
5178       --    Set Detect_Blocking mode
5179
5180       --    Set required restrictions (see System.Rident for detailed list)
5181
5182       procedure Set_Ravenscar_Profile (N : Node_Id) is
5183       begin
5184          --  pragma Task_Dispatching_Policy (FIFO_Within_Priorities)
5185
5186          if Task_Dispatching_Policy /= ' '
5187            and then Task_Dispatching_Policy /= 'F'
5188          then
5189             Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
5190             Error_Pragma ("Profile (Ravenscar) incompatible with policy#");
5191
5192          --  Set the FIFO_Within_Priorities policy, but always preserve
5193          --  System_Location since we like the error message with the run time
5194          --  name.
5195
5196          else
5197             Task_Dispatching_Policy := 'F';
5198
5199             if Task_Dispatching_Policy_Sloc /= System_Location then
5200                Task_Dispatching_Policy_Sloc := Loc;
5201             end if;
5202          end if;
5203
5204          --  pragma Locking_Policy (Ceiling_Locking)
5205
5206          if Locking_Policy /= ' '
5207            and then Locking_Policy /= 'C'
5208          then
5209             Error_Msg_Sloc := Locking_Policy_Sloc;
5210             Error_Pragma ("Profile (Ravenscar) incompatible with policy#");
5211
5212          --  Set the Ceiling_Locking policy, but preserve System_Location since
5213          --  we like the error message with the run time name.
5214
5215          else
5216             Locking_Policy := 'C';
5217
5218             if Locking_Policy_Sloc /= System_Location then
5219                Locking_Policy_Sloc := Loc;
5220             end if;
5221          end if;
5222
5223          --  pragma Detect_Blocking
5224
5225          Detect_Blocking := True;
5226
5227          --  Set the corresponding restrictions
5228
5229          Set_Profile_Restrictions
5230            (Ravenscar, N, Warn => Treat_Restrictions_As_Warnings);
5231       end Set_Ravenscar_Profile;
5232
5233    --  Start of processing for Analyze_Pragma
5234
5235    begin
5236       --  Deal with unrecognized pragma
5237
5238       if not Is_Pragma_Name (Pname) then
5239          if Warn_On_Unrecognized_Pragma then
5240             Error_Msg_Name_1 := Pname;
5241             Error_Msg_N ("?unrecognized pragma%!", Pragma_Identifier (N));
5242
5243             for PN in First_Pragma_Name .. Last_Pragma_Name loop
5244                if Is_Bad_Spelling_Of (Pname, PN) then
5245                   Error_Msg_Name_1 := PN;
5246                   Error_Msg_N -- CODEFIX
5247                     ("\?possible misspelling of %!", Pragma_Identifier (N));
5248                   exit;
5249                end if;
5250             end loop;
5251          end if;
5252
5253          return;
5254       end if;
5255
5256       --  Here to start processing for recognized pragma
5257
5258       Prag_Id := Get_Pragma_Id (Pname);
5259
5260       --  Preset arguments
5261
5262       Arg1 := Empty;
5263       Arg2 := Empty;
5264       Arg3 := Empty;
5265       Arg4 := Empty;
5266
5267       if Present (Pragma_Argument_Associations (N)) then
5268          Arg1 := First (Pragma_Argument_Associations (N));
5269
5270          if Present (Arg1) then
5271             Arg2 := Next (Arg1);
5272
5273             if Present (Arg2) then
5274                Arg3 := Next (Arg2);
5275
5276                if Present (Arg3) then
5277                   Arg4 := Next (Arg3);
5278                end if;
5279             end if;
5280          end if;
5281       end if;
5282
5283       --  Count number of arguments
5284
5285       declare
5286          Arg_Node : Node_Id;
5287       begin
5288          Arg_Count := 0;
5289          Arg_Node := Arg1;
5290          while Present (Arg_Node) loop
5291             Arg_Count := Arg_Count + 1;
5292             Next (Arg_Node);
5293          end loop;
5294       end;
5295
5296       --  An enumeration type defines the pragmas that are supported by the
5297       --  implementation. Get_Pragma_Id (in package Prag) transforms a name
5298       --  into the corresponding enumeration value for the following case.
5299
5300       case Prag_Id is
5301
5302          -----------------
5303          -- Abort_Defer --
5304          -----------------
5305
5306          --  pragma Abort_Defer;
5307
5308          when Pragma_Abort_Defer =>
5309             GNAT_Pragma;
5310             Check_Arg_Count (0);
5311
5312             --  The only required semantic processing is to check the
5313             --  placement. This pragma must appear at the start of the
5314             --  statement sequence of a handled sequence of statements.
5315
5316             if Nkind (Parent (N)) /= N_Handled_Sequence_Of_Statements
5317               or else N /= First (Statements (Parent (N)))
5318             then
5319                Pragma_Misplaced;
5320             end if;
5321
5322          ------------
5323          -- Ada_83 --
5324          ------------
5325
5326          --  pragma Ada_83;
5327
5328          --  Note: this pragma also has some specific processing in Par.Prag
5329          --  because we want to set the Ada version mode during parsing.
5330
5331          when Pragma_Ada_83 =>
5332             GNAT_Pragma;
5333             Check_Arg_Count (0);
5334
5335             --  We really should check unconditionally for proper configuration
5336             --  pragma placement, since we really don't want mixed Ada modes
5337             --  within a single unit, and the GNAT reference manual has always
5338             --  said this was a configuration pragma, but we did not check and
5339             --  are hesitant to add the check now.
5340
5341             --  However, we really cannot tolerate mixing Ada 2005 or Ada 2012
5342             --  with Ada 83 or Ada 95, so we must check if we are in Ada 2005
5343             --  or Ada 2012 mode.
5344
5345             if Ada_Version >= Ada_05 then
5346                Check_Valid_Configuration_Pragma;
5347             end if;
5348
5349             --  Now set Ada 83 mode
5350
5351             Ada_Version := Ada_83;
5352             Ada_Version_Explicit := Ada_Version;
5353
5354          ------------
5355          -- Ada_95 --
5356          ------------
5357
5358          --  pragma Ada_95;
5359
5360          --  Note: this pragma also has some specific processing in Par.Prag
5361          --  because we want to set the Ada 83 version mode during parsing.
5362
5363          when Pragma_Ada_95 =>
5364             GNAT_Pragma;
5365             Check_Arg_Count (0);
5366
5367             --  We really should check unconditionally for proper configuration
5368             --  pragma placement, since we really don't want mixed Ada modes
5369             --  within a single unit, and the GNAT reference manual has always
5370             --  said this was a configuration pragma, but we did not check and
5371             --  are hesitant to add the check now.
5372
5373             --  However, we really cannot tolerate mixing Ada 2005 with Ada 83
5374             --  or Ada 95, so we must check if we are in Ada 2005 mode.
5375
5376             if Ada_Version >= Ada_05 then
5377                Check_Valid_Configuration_Pragma;
5378             end if;
5379
5380             --  Now set Ada 95 mode
5381
5382             Ada_Version := Ada_95;
5383             Ada_Version_Explicit := Ada_Version;
5384
5385          ---------------------
5386          -- Ada_05/Ada_2005 --
5387          ---------------------
5388
5389          --  pragma Ada_05;
5390          --  pragma Ada_05 (LOCAL_NAME);
5391
5392          --  pragma Ada_2005;
5393          --  pragma Ada_2005 (LOCAL_NAME):
5394
5395          --  Note: these pragmas also have some specific processing in Par.Prag
5396          --  because we want to set the Ada 2005 version mode during parsing.
5397
5398          when Pragma_Ada_05 | Pragma_Ada_2005 => declare
5399             E_Id : Node_Id;
5400
5401          begin
5402             GNAT_Pragma;
5403
5404             if Arg_Count = 1 then
5405                Check_Arg_Is_Local_Name (Arg1);
5406                E_Id := Expression (Arg1);
5407
5408                if Etype (E_Id) = Any_Type then
5409                   return;
5410                end if;
5411
5412                Set_Is_Ada_2005_Only (Entity (E_Id));
5413
5414             else
5415                Check_Arg_Count (0);
5416
5417                --  For Ada_2005 we unconditionally enforce the documented
5418                --  configuration pragma placement, since we do not want to
5419                --  tolerate mixed modes in a unit involving Ada 2005. That
5420                --  would cause real difficulties for those cases where there
5421                --  are incompatibilities between Ada 95 and Ada 2005.
5422
5423                Check_Valid_Configuration_Pragma;
5424
5425                --  Now set Ada 2005 mode
5426
5427                Ada_Version := Ada_05;
5428                Ada_Version_Explicit := Ada_05;
5429             end if;
5430          end;
5431
5432          ---------------------
5433          -- Ada_12/Ada_2012 --
5434          ---------------------
5435
5436          --  pragma Ada_12;
5437          --  pragma Ada_12 (LOCAL_NAME);
5438
5439          --  pragma Ada_2012;
5440          --  pragma Ada_2012 (LOCAL_NAME):
5441
5442          --  Note: these pragmas also have some specific processing in Par.Prag
5443          --  because we want to set the Ada 2012 version mode during parsing.
5444
5445          when Pragma_Ada_12 | Pragma_Ada_2012 => declare
5446             E_Id : Node_Id;
5447
5448          begin
5449             GNAT_Pragma;
5450
5451             if Arg_Count = 1 then
5452                Check_Arg_Is_Local_Name (Arg1);
5453                E_Id := Expression (Arg1);
5454
5455                if Etype (E_Id) = Any_Type then
5456                   return;
5457                end if;
5458
5459                Set_Is_Ada_2012_Only (Entity (E_Id));
5460
5461             else
5462                Check_Arg_Count (0);
5463
5464                --  For Ada_2012 we unconditionally enforce the documented
5465                --  configuration pragma placement, since we do not want to
5466                --  tolerate mixed modes in a unit involving Ada 2012. That
5467                --  would cause real difficulties for those cases where there
5468                --  are incompatibilities between Ada 95 and Ada 2012. We could
5469                --  allow mixing of Ada 2005 and Ada 2012 but it's not worth it.
5470
5471                Check_Valid_Configuration_Pragma;
5472
5473                --  Now set Ada 2012 mode
5474
5475                Ada_Version := Ada_12;
5476                Ada_Version_Explicit := Ada_12;
5477             end if;
5478          end;
5479
5480          ----------------------
5481          -- All_Calls_Remote --
5482          ----------------------
5483
5484          --  pragma All_Calls_Remote [(library_package_NAME)];
5485
5486          when Pragma_All_Calls_Remote => All_Calls_Remote : declare
5487             Lib_Entity : Entity_Id;
5488
5489          begin
5490             Check_Ada_83_Warning;
5491             Check_Valid_Library_Unit_Pragma;
5492
5493             if Nkind (N) = N_Null_Statement then
5494                return;
5495             end if;
5496
5497             Lib_Entity := Find_Lib_Unit_Name;
5498
5499             --  This pragma should only apply to a RCI unit (RM E.2.3(23))
5500
5501             if Present (Lib_Entity)
5502               and then not Debug_Flag_U
5503             then
5504                if not Is_Remote_Call_Interface (Lib_Entity) then
5505                   Error_Pragma ("pragma% only apply to rci unit");
5506
5507                --  Set flag for entity of the library unit
5508
5509                else
5510                   Set_Has_All_Calls_Remote (Lib_Entity);
5511                end if;
5512
5513             end if;
5514          end All_Calls_Remote;
5515
5516          --------------
5517          -- Annotate --
5518          --------------
5519
5520          --  pragma Annotate (IDENTIFIER [, IDENTIFIER {, ARG}]);
5521          --  ARG ::= NAME | EXPRESSION
5522
5523          --  The first two arguments are by convention intended to refer to an
5524          --  external tool and a tool-specific function. These arguments are
5525          --  not analyzed.
5526
5527          when Pragma_Annotate => Annotate : begin
5528             GNAT_Pragma;
5529             Check_At_Least_N_Arguments (1);
5530             Check_Arg_Is_Identifier (Arg1);
5531             Check_No_Identifiers;
5532             Store_Note (N);
5533
5534             declare
5535                Arg : Node_Id;
5536                Exp : Node_Id;
5537
5538             begin
5539                --  Second unanalyzed parameter is optional
5540
5541                if No (Arg2) then
5542                   null;
5543                else
5544                   Arg := Next (Arg2);
5545                   while Present (Arg) loop
5546                      Exp := Expression (Arg);
5547                      Analyze (Exp);
5548
5549                      if Is_Entity_Name (Exp) then
5550                         null;
5551
5552                      --  For string literals, we assume Standard_String as the
5553                      --  type, unless the string contains wide or wide_wide
5554                      --  characters.
5555
5556                      elsif Nkind (Exp) = N_String_Literal then
5557                         if Has_Wide_Wide_Character (Exp) then
5558                            Resolve (Exp, Standard_Wide_Wide_String);
5559                         elsif Has_Wide_Character (Exp) then
5560                            Resolve (Exp, Standard_Wide_String);
5561                         else
5562                            Resolve (Exp, Standard_String);
5563                         end if;
5564
5565                      elsif Is_Overloaded (Exp) then
5566                            Error_Pragma_Arg
5567                              ("ambiguous argument for pragma%", Exp);
5568
5569                      else
5570                         Resolve (Exp);
5571                      end if;
5572
5573                      Next (Arg);
5574                   end loop;
5575                end if;
5576             end;
5577          end Annotate;
5578
5579          ------------
5580          -- Assert --
5581          ------------
5582
5583          --  pragma Assert ([Check =>] Boolean_EXPRESSION
5584          --                 [, [Message =>] Static_String_EXPRESSION]);
5585
5586          when Pragma_Assert => Assert : declare
5587             Expr : Node_Id;
5588             Newa : List_Id;
5589
5590          begin
5591             Ada_2005_Pragma;
5592             Check_At_Least_N_Arguments (1);
5593             Check_At_Most_N_Arguments (2);
5594             Check_Arg_Order ((Name_Check, Name_Message));
5595             Check_Optional_Identifier (Arg1, Name_Check);
5596
5597             --  We treat pragma Assert as equivalent to:
5598
5599             --    pragma Check (Assertion, condition [, msg]);
5600
5601             --  So rewrite pragma in this manner, and analyze the result
5602
5603             Expr := Get_Pragma_Arg (Arg1);
5604             Newa := New_List (
5605               Make_Pragma_Argument_Association (Loc,
5606                 Expression =>
5607                   Make_Identifier (Loc,
5608                     Chars => Name_Assertion)),
5609
5610               Make_Pragma_Argument_Association (Sloc (Expr),
5611                 Expression => Expr));
5612
5613             if Arg_Count > 1 then
5614                Check_Optional_Identifier (Arg2, Name_Message);
5615                Analyze_And_Resolve (Get_Pragma_Arg (Arg2), Standard_String);
5616                Append_To (Newa, Relocate_Node (Arg2));
5617             end if;
5618
5619             Rewrite (N,
5620               Make_Pragma (Loc,
5621                 Chars => Name_Check,
5622                 Pragma_Argument_Associations => Newa));
5623             Analyze (N);
5624          end Assert;
5625
5626          ----------------------
5627          -- Assertion_Policy --
5628          ----------------------
5629
5630          --  pragma Assertion_Policy (Check | Ignore)
5631
5632          when Pragma_Assertion_Policy => Assertion_Policy : declare
5633             Policy : Node_Id;
5634
5635          begin
5636             Ada_2005_Pragma;
5637             Check_Valid_Configuration_Pragma;
5638             Check_Arg_Count (1);
5639             Check_No_Identifiers;
5640             Check_Arg_Is_One_Of (Arg1, Name_Check, Name_Ignore);
5641
5642             --  We treat pragma Assertion_Policy as equivalent to:
5643
5644             --    pragma Check_Policy (Assertion, policy)
5645
5646             --  So rewrite the pragma in that manner and link on to the chain
5647             --  of Check_Policy pragmas, marking the pragma as analyzed.
5648
5649             Policy := Get_Pragma_Arg (Arg1);
5650
5651             Rewrite (N,
5652               Make_Pragma (Loc,
5653                 Chars => Name_Check_Policy,
5654
5655                 Pragma_Argument_Associations => New_List (
5656                   Make_Pragma_Argument_Association (Loc,
5657                     Expression =>
5658                       Make_Identifier (Loc,
5659                         Chars => Name_Assertion)),
5660
5661                   Make_Pragma_Argument_Association (Loc,
5662                     Expression =>
5663                       Make_Identifier (Sloc (Policy),
5664                         Chars => Chars (Policy))))));
5665
5666             Set_Analyzed (N);
5667             Set_Next_Pragma (N, Opt.Check_Policy_List);
5668             Opt.Check_Policy_List := N;
5669          end Assertion_Policy;
5670
5671          ------------------------------
5672          -- Assume_No_Invalid_Values --
5673          ------------------------------
5674
5675          --  pragma Assume_No_Invalid_Values (On | Off);
5676
5677          when Pragma_Assume_No_Invalid_Values =>
5678             GNAT_Pragma;
5679             Check_Valid_Configuration_Pragma;
5680             Check_Arg_Count (1);
5681             Check_No_Identifiers;
5682             Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
5683
5684             if Chars (Expression (Arg1)) = Name_On then
5685                Assume_No_Invalid_Values := True;
5686             else
5687                Assume_No_Invalid_Values := False;
5688             end if;
5689
5690          ---------------
5691          -- AST_Entry --
5692          ---------------
5693
5694          --  pragma AST_Entry (entry_IDENTIFIER);
5695
5696          when Pragma_AST_Entry => AST_Entry : declare
5697             Ent : Node_Id;
5698
5699          begin
5700             GNAT_Pragma;
5701             Check_VMS (N);
5702             Check_Arg_Count (1);
5703             Check_No_Identifiers;
5704             Check_Arg_Is_Local_Name (Arg1);
5705             Ent := Entity (Expression (Arg1));
5706
5707             --  Note: the implementation of the AST_Entry pragma could handle
5708             --  the entry family case fine, but for now we are consistent with
5709             --  the DEC rules, and do not allow the pragma, which of course
5710             --  has the effect of also forbidding the attribute.
5711
5712             if Ekind (Ent) /= E_Entry then
5713                Error_Pragma_Arg
5714                  ("pragma% argument must be simple entry name", Arg1);
5715
5716             elsif Is_AST_Entry (Ent) then
5717                Error_Pragma_Arg
5718                  ("duplicate % pragma for entry", Arg1);
5719
5720             elsif Has_Homonym (Ent) then
5721                Error_Pragma_Arg
5722                  ("pragma% argument cannot specify overloaded entry", Arg1);
5723
5724             else
5725                declare
5726                   FF : constant Entity_Id := First_Formal (Ent);
5727
5728                begin
5729                   if Present (FF) then
5730                      if Present (Next_Formal (FF)) then
5731                         Error_Pragma_Arg
5732                           ("entry for pragma% can have only one argument",
5733                            Arg1);
5734
5735                      elsif Parameter_Mode (FF) /= E_In_Parameter then
5736                         Error_Pragma_Arg
5737                           ("entry parameter for pragma% must have mode IN",
5738                            Arg1);
5739                      end if;
5740                   end if;
5741                end;
5742
5743                Set_Is_AST_Entry (Ent);
5744             end if;
5745          end AST_Entry;
5746
5747          ------------------
5748          -- Asynchronous --
5749          ------------------
5750
5751          --  pragma Asynchronous (LOCAL_NAME);
5752
5753          when Pragma_Asynchronous => Asynchronous : declare
5754             Nm     : Entity_Id;
5755             C_Ent  : Entity_Id;
5756             L      : List_Id;
5757             S      : Node_Id;
5758             N      : Node_Id;
5759             Formal : Entity_Id;
5760
5761             procedure Process_Async_Pragma;
5762             --  Common processing for procedure and access-to-procedure case
5763
5764             --------------------------
5765             -- Process_Async_Pragma --
5766             --------------------------
5767
5768             procedure Process_Async_Pragma is
5769             begin
5770                if No (L) then
5771                   Set_Is_Asynchronous (Nm);
5772                   return;
5773                end if;
5774
5775                --  The formals should be of mode IN (RM E.4.1(6))
5776
5777                S := First (L);
5778                while Present (S) loop
5779                   Formal := Defining_Identifier (S);
5780
5781                   if Nkind (Formal) = N_Defining_Identifier
5782                     and then Ekind (Formal) /= E_In_Parameter
5783                   then
5784                      Error_Pragma_Arg
5785                        ("pragma% procedure can only have IN parameter",
5786                         Arg1);
5787                   end if;
5788
5789                   Next (S);
5790                end loop;
5791
5792                Set_Is_Asynchronous (Nm);
5793             end Process_Async_Pragma;
5794
5795          --  Start of processing for pragma Asynchronous
5796
5797          begin
5798             Check_Ada_83_Warning;
5799             Check_No_Identifiers;
5800             Check_Arg_Count (1);
5801             Check_Arg_Is_Local_Name (Arg1);
5802
5803             if Debug_Flag_U then
5804                return;
5805             end if;
5806
5807             C_Ent := Cunit_Entity (Current_Sem_Unit);
5808             Analyze (Expression (Arg1));
5809             Nm := Entity (Expression (Arg1));
5810
5811             if not Is_Remote_Call_Interface (C_Ent)
5812               and then not Is_Remote_Types (C_Ent)
5813             then
5814                --  This pragma should only appear in an RCI or Remote Types
5815                --  unit (RM E.4.1(4)).
5816
5817                Error_Pragma
5818                  ("pragma% not in Remote_Call_Interface or " &
5819                   "Remote_Types unit");
5820             end if;
5821
5822             if Ekind (Nm) = E_Procedure
5823               and then Nkind (Parent (Nm)) = N_Procedure_Specification
5824             then
5825                if not Is_Remote_Call_Interface (Nm) then
5826                   Error_Pragma_Arg
5827                     ("pragma% cannot be applied on non-remote procedure",
5828                      Arg1);
5829                end if;
5830
5831                L := Parameter_Specifications (Parent (Nm));
5832                Process_Async_Pragma;
5833                return;
5834
5835             elsif Ekind (Nm) = E_Function then
5836                Error_Pragma_Arg
5837                  ("pragma% cannot be applied to function", Arg1);
5838
5839             elsif Is_Remote_Access_To_Subprogram_Type (Nm) then
5840
5841                   if Is_Record_Type (Nm) then
5842
5843                   --  A record type that is the Equivalent_Type for a remote
5844                   --  access-to-subprogram type.
5845
5846                      N := Declaration_Node (Corresponding_Remote_Type (Nm));
5847
5848                   else
5849                      --  A non-expanded RAS type (distribution is not enabled)
5850
5851                      N := Declaration_Node (Nm);
5852                   end if;
5853
5854                if Nkind (N) = N_Full_Type_Declaration
5855                  and then Nkind (Type_Definition (N)) =
5856                                      N_Access_Procedure_Definition
5857                then
5858                   L := Parameter_Specifications (Type_Definition (N));
5859                   Process_Async_Pragma;
5860
5861                   if Is_Asynchronous (Nm)
5862                     and then Expander_Active
5863                     and then Get_PCS_Name /= Name_No_DSA
5864                   then
5865                      RACW_Type_Is_Asynchronous (Underlying_RACW_Type (Nm));
5866                   end if;
5867
5868                else
5869                   Error_Pragma_Arg
5870                     ("pragma% cannot reference access-to-function type",
5871                     Arg1);
5872                end if;
5873
5874             --  Only other possibility is Access-to-class-wide type
5875
5876             elsif Is_Access_Type (Nm)
5877               and then Is_Class_Wide_Type (Designated_Type (Nm))
5878             then
5879                Check_First_Subtype (Arg1);
5880                Set_Is_Asynchronous (Nm);
5881                if Expander_Active then
5882                   RACW_Type_Is_Asynchronous (Nm);
5883                end if;
5884
5885             else
5886                Error_Pragma_Arg ("inappropriate argument for pragma%", Arg1);
5887             end if;
5888          end Asynchronous;
5889
5890          ------------
5891          -- Atomic --
5892          ------------
5893
5894          --  pragma Atomic (LOCAL_NAME);
5895
5896          when Pragma_Atomic =>
5897             Process_Atomic_Shared_Volatile;
5898
5899          -----------------------
5900          -- Atomic_Components --
5901          -----------------------
5902
5903          --  pragma Atomic_Components (array_LOCAL_NAME);
5904
5905          --  This processing is shared by Volatile_Components
5906
5907          when Pragma_Atomic_Components   |
5908               Pragma_Volatile_Components =>
5909
5910          Atomic_Components : declare
5911             E_Id : Node_Id;
5912             E    : Entity_Id;
5913             D    : Node_Id;
5914             K    : Node_Kind;
5915
5916          begin
5917             Check_Ada_83_Warning;
5918             Check_No_Identifiers;
5919             Check_Arg_Count (1);
5920             Check_Arg_Is_Local_Name (Arg1);
5921             E_Id := Expression (Arg1);
5922
5923             if Etype (E_Id) = Any_Type then
5924                return;
5925             end if;
5926
5927             E := Entity (E_Id);
5928
5929             if Rep_Item_Too_Early (E, N)
5930                  or else
5931                Rep_Item_Too_Late (E, N)
5932             then
5933                return;
5934             end if;
5935
5936             D := Declaration_Node (E);
5937             K := Nkind (D);
5938
5939             if (K = N_Full_Type_Declaration and then Is_Array_Type (E))
5940               or else
5941                 ((Ekind (E) = E_Constant or else Ekind (E) = E_Variable)
5942                    and then Nkind (D) = N_Object_Declaration
5943                    and then Nkind (Object_Definition (D)) =
5944                                        N_Constrained_Array_Definition)
5945             then
5946                --  The flag is set on the object, or on the base type
5947
5948                if Nkind (D) /= N_Object_Declaration then
5949                   E := Base_Type (E);
5950                end if;
5951
5952                Set_Has_Volatile_Components (E);
5953
5954                if Prag_Id = Pragma_Atomic_Components then
5955                   Set_Has_Atomic_Components (E);
5956
5957                   if Is_Packed (E) then
5958                      Set_Is_Packed (E, False);
5959
5960                      Error_Pragma_Arg
5961                        ("?Pack canceled, cannot pack atomic components",
5962                         Arg1);
5963                   end if;
5964                end if;
5965
5966             else
5967                Error_Pragma_Arg ("inappropriate entity for pragma%", Arg1);
5968             end if;
5969          end Atomic_Components;
5970
5971          --------------------
5972          -- Attach_Handler --
5973          --------------------
5974
5975          --  pragma Attach_Handler (handler_NAME, EXPRESSION);
5976
5977          when Pragma_Attach_Handler =>
5978             Check_Ada_83_Warning;
5979             Check_No_Identifiers;
5980             Check_Arg_Count (2);
5981
5982             if No_Run_Time_Mode then
5983                Error_Msg_CRT ("Attach_Handler pragma", N);
5984             else
5985                Check_Interrupt_Or_Attach_Handler;
5986
5987                --  The expression that designates the attribute may
5988                --  depend on a discriminant, and is therefore a per-
5989                --  object expression, to be expanded in the init proc.
5990                --  If expansion is enabled, perform semantic checks
5991                --  on a copy only.
5992
5993                if Expander_Active then
5994                   declare
5995                      Temp : constant Node_Id :=
5996                               New_Copy_Tree (Expression (Arg2));
5997                   begin
5998                      Set_Parent (Temp, N);
5999                      Preanalyze_And_Resolve (Temp, RTE (RE_Interrupt_ID));
6000                   end;
6001
6002                else
6003                   Analyze (Expression (Arg2));
6004                   Resolve (Expression (Arg2), RTE (RE_Interrupt_ID));
6005                end if;
6006
6007                Process_Interrupt_Or_Attach_Handler;
6008             end if;
6009
6010          --------------------
6011          -- C_Pass_By_Copy --
6012          --------------------
6013
6014          --  pragma C_Pass_By_Copy ([Max_Size =>] static_integer_EXPRESSION);
6015
6016          when Pragma_C_Pass_By_Copy => C_Pass_By_Copy : declare
6017             Arg : Node_Id;
6018             Val : Uint;
6019
6020          begin
6021             GNAT_Pragma;
6022             Check_Valid_Configuration_Pragma;
6023             Check_Arg_Count (1);
6024             Check_Optional_Identifier (Arg1, "max_size");
6025
6026             Arg := Expression (Arg1);
6027             Check_Arg_Is_Static_Expression (Arg, Any_Integer);
6028
6029             Val := Expr_Value (Arg);
6030
6031             if Val <= 0 then
6032                Error_Pragma_Arg
6033                  ("maximum size for pragma% must be positive", Arg1);
6034
6035             elsif UI_Is_In_Int_Range (Val) then
6036                Default_C_Record_Mechanism := UI_To_Int (Val);
6037
6038             --  If a giant value is given, Int'Last will do well enough.
6039             --  If sometime someone complains that a record larger than
6040             --  two gigabytes is not copied, we will worry about it then!
6041
6042             else
6043                Default_C_Record_Mechanism := Mechanism_Type'Last;
6044             end if;
6045          end C_Pass_By_Copy;
6046
6047          -----------
6048          -- Check --
6049          -----------
6050
6051          --  pragma Check ([Name    =>] Identifier,
6052          --                [Check   =>] Boolean_Expression
6053          --              [,[Message =>] String_Expression]);
6054
6055          when Pragma_Check => Check : declare
6056             Expr : Node_Id;
6057             Eloc : Source_Ptr;
6058
6059             Check_On : Boolean;
6060             --  Set True if category of assertions referenced by Name enabled
6061
6062          begin
6063             GNAT_Pragma;
6064             Check_At_Least_N_Arguments (2);
6065             Check_At_Most_N_Arguments (3);
6066             Check_Optional_Identifier (Arg1, Name_Name);
6067             Check_Optional_Identifier (Arg2, Name_Check);
6068
6069             if Arg_Count = 3 then
6070                Check_Optional_Identifier (Arg3, Name_Message);
6071                Analyze_And_Resolve (Get_Pragma_Arg (Arg3), Standard_String);
6072             end if;
6073
6074             Check_Arg_Is_Identifier (Arg1);
6075
6076             --  Indicate if pragma is enabled. The Original_Node reference here
6077             --  is to deal with pragma Assert rewritten as a Check pragma.
6078
6079             Check_On := Check_Enabled (Chars (Get_Pragma_Arg (Arg1)));
6080
6081             if Check_On then
6082                Set_Pragma_Enabled (N);
6083                Set_Pragma_Enabled (Original_Node (N));
6084                Set_SCO_Pragma_Enabled (Loc);
6085             end if;
6086
6087             --  If expansion is active and the check is not enabled then we
6088             --  rewrite the Check as:
6089
6090             --    if False and then condition then
6091             --       null;
6092             --    end if;
6093
6094             --  The reason we do this rewriting during semantic analysis rather
6095             --  than as part of normal expansion is that we cannot analyze and
6096             --  expand the code for the boolean expression directly, or it may
6097             --  cause insertion of actions that would escape the attempt to
6098             --  suppress the check code.
6099
6100             --  Note that the Sloc for the if statement corresponds to the
6101             --  argument condition, not the pragma itself. The reason for this
6102             --  is that we may generate a warning if the condition is False at
6103             --  compile time, and we do not want to delete this warning when we
6104             --  delete the if statement.
6105
6106             Expr := Expression (Arg2);
6107
6108             if Expander_Active and then not Check_On then
6109                Eloc := Sloc (Expr);
6110
6111                Rewrite (N,
6112                  Make_If_Statement (Eloc,
6113                    Condition =>
6114                      Make_And_Then (Eloc,
6115                        Left_Opnd  => New_Occurrence_Of (Standard_False, Eloc),
6116                        Right_Opnd => Expr),
6117                    Then_Statements => New_List (
6118                      Make_Null_Statement (Eloc))));
6119
6120                Analyze (N);
6121
6122             --  Check is active
6123
6124             else
6125                Analyze_And_Resolve (Expr, Any_Boolean);
6126             end if;
6127          end Check;
6128
6129          ----------------
6130          -- Check_Name --
6131          ----------------
6132
6133          --  pragma Check_Name (check_IDENTIFIER);
6134
6135          when Pragma_Check_Name =>
6136             Check_No_Identifiers;
6137             GNAT_Pragma;
6138             Check_Valid_Configuration_Pragma;
6139             Check_Arg_Count (1);
6140             Check_Arg_Is_Identifier (Arg1);
6141
6142             declare
6143                Nam : constant Name_Id := Chars (Expression (Arg1));
6144
6145             begin
6146                for J in Check_Names.First .. Check_Names.Last loop
6147                   if Check_Names.Table (J) = Nam then
6148                      return;
6149                   end if;
6150                end loop;
6151
6152                Check_Names.Append (Nam);
6153             end;
6154
6155          ------------------
6156          -- Check_Policy --
6157          ------------------
6158
6159          --  pragma Check_Policy (
6160          --    [Name   =>] IDENTIFIER,
6161          --    [Policy =>] POLICY_IDENTIFIER);
6162
6163          --  POLICY_IDENTIFIER ::= ON | OFF | CHECK | IGNORE
6164
6165          --  Note: this is a configuration pragma, but it is allowed to appear
6166          --  anywhere else.
6167
6168          when Pragma_Check_Policy =>
6169             GNAT_Pragma;
6170             Check_Arg_Count (2);
6171             Check_Optional_Identifier (Arg1, Name_Name);
6172             Check_Optional_Identifier (Arg2, Name_Policy);
6173             Check_Arg_Is_One_Of
6174               (Arg2, Name_On, Name_Off, Name_Check, Name_Ignore);
6175
6176             --  A Check_Policy pragma can appear either as a configuration
6177             --  pragma, or in a declarative part or a package spec (see RM
6178             --  11.5(5) for rules for Suppress/Unsuppress which are also
6179             --  followed for Check_Policy).
6180
6181             if not Is_Configuration_Pragma then
6182                Check_Is_In_Decl_Part_Or_Package_Spec;
6183             end if;
6184
6185             Set_Next_Pragma (N, Opt.Check_Policy_List);
6186             Opt.Check_Policy_List := N;
6187
6188          ---------------------
6189          -- CIL_Constructor --
6190          ---------------------
6191
6192          --  pragma CIL_Constructor ([Entity =>] LOCAL_NAME);
6193
6194          --  Processing for this pragma is shared with Java_Constructor
6195
6196          -------------
6197          -- Comment --
6198          -------------
6199
6200          --  pragma Comment (static_string_EXPRESSION)
6201
6202          --  Processing for pragma Comment shares the circuitry for pragma
6203          --  Ident. The only differences are that Ident enforces a limit of 31
6204          --  characters on its argument, and also enforces limitations on
6205          --  placement for DEC compatibility. Pragma Comment shares neither of
6206          --  these restrictions.
6207
6208          -------------------
6209          -- Common_Object --
6210          -------------------
6211
6212          --  pragma Common_Object (
6213          --        [Internal =>] LOCAL_NAME
6214          --     [, [External =>] EXTERNAL_SYMBOL]
6215          --     [, [Size     =>] EXTERNAL_SYMBOL]);
6216
6217          --  Processing for this pragma is shared with Psect_Object
6218
6219          ------------------------
6220          -- Compile_Time_Error --
6221          ------------------------
6222
6223          --  pragma Compile_Time_Error
6224          --    (boolean_EXPRESSION, static_string_EXPRESSION);
6225
6226          when Pragma_Compile_Time_Error =>
6227             GNAT_Pragma;
6228             Process_Compile_Time_Warning_Or_Error;
6229
6230          --------------------------
6231          -- Compile_Time_Warning --
6232          --------------------------
6233
6234          --  pragma Compile_Time_Warning
6235          --    (boolean_EXPRESSION, static_string_EXPRESSION);
6236
6237          when Pragma_Compile_Time_Warning =>
6238             GNAT_Pragma;
6239             Process_Compile_Time_Warning_Or_Error;
6240
6241          -------------------
6242          -- Compiler_Unit --
6243          -------------------
6244
6245          when Pragma_Compiler_Unit =>
6246             GNAT_Pragma;
6247             Check_Arg_Count (0);
6248             Set_Is_Compiler_Unit (Get_Source_Unit (N));
6249
6250          -----------------------------
6251          -- Complete_Representation --
6252          -----------------------------
6253
6254          --  pragma Complete_Representation;
6255
6256          when Pragma_Complete_Representation =>
6257             GNAT_Pragma;
6258             Check_Arg_Count (0);
6259
6260             if Nkind (Parent (N)) /= N_Record_Representation_Clause then
6261                Error_Pragma
6262                  ("pragma & must appear within record representation clause");
6263             end if;
6264
6265          ----------------------------
6266          -- Complex_Representation --
6267          ----------------------------
6268
6269          --  pragma Complex_Representation ([Entity =>] LOCAL_NAME);
6270
6271          when Pragma_Complex_Representation => Complex_Representation : declare
6272             E_Id : Entity_Id;
6273             E    : Entity_Id;
6274             Ent  : Entity_Id;
6275
6276          begin
6277             GNAT_Pragma;
6278             Check_Arg_Count (1);
6279             Check_Optional_Identifier (Arg1, Name_Entity);
6280             Check_Arg_Is_Local_Name (Arg1);
6281             E_Id := Expression (Arg1);
6282
6283             if Etype (E_Id) = Any_Type then
6284                return;
6285             end if;
6286
6287             E := Entity (E_Id);
6288
6289             if not Is_Record_Type (E) then
6290                Error_Pragma_Arg
6291                  ("argument for pragma% must be record type", Arg1);
6292             end if;
6293
6294             Ent := First_Entity (E);
6295
6296             if No (Ent)
6297               or else No (Next_Entity (Ent))
6298               or else Present (Next_Entity (Next_Entity (Ent)))
6299               or else not Is_Floating_Point_Type (Etype (Ent))
6300               or else Etype (Ent) /= Etype (Next_Entity (Ent))
6301             then
6302                Error_Pragma_Arg
6303                  ("record for pragma% must have two fields of the same "
6304                   & "floating-point type", Arg1);
6305
6306             else
6307                Set_Has_Complex_Representation (Base_Type (E));
6308
6309                --  We need to treat the type has having a non-standard
6310                --  representation, for back-end purposes, even though in
6311                --  general a complex will have the default representation
6312                --  of a record with two real components.
6313
6314                Set_Has_Non_Standard_Rep (Base_Type (E));
6315             end if;
6316          end Complex_Representation;
6317
6318          -------------------------
6319          -- Component_Alignment --
6320          -------------------------
6321
6322          --  pragma Component_Alignment (
6323          --        [Form =>] ALIGNMENT_CHOICE
6324          --     [, [Name =>] type_LOCAL_NAME]);
6325          --
6326          --   ALIGNMENT_CHOICE ::=
6327          --     Component_Size
6328          --   | Component_Size_4
6329          --   | Storage_Unit
6330          --   | Default
6331
6332          when Pragma_Component_Alignment => Component_AlignmentP : declare
6333             Args  : Args_List (1 .. 2);
6334             Names : constant Name_List (1 .. 2) := (
6335                       Name_Form,
6336                       Name_Name);
6337
6338             Form  : Node_Id renames Args (1);
6339             Name  : Node_Id renames Args (2);
6340
6341             Atype : Component_Alignment_Kind;
6342             Typ   : Entity_Id;
6343
6344          begin
6345             GNAT_Pragma;
6346             Gather_Associations (Names, Args);
6347
6348             if No (Form) then
6349                Error_Pragma ("missing Form argument for pragma%");
6350             end if;
6351
6352             Check_Arg_Is_Identifier (Form);
6353
6354             --  Get proper alignment, note that Default = Component_Size on all
6355             --  machines we have so far, and we want to set this value rather
6356             --  than the default value to indicate that it has been explicitly
6357             --  set (and thus will not get overridden by the default component
6358             --  alignment for the current scope)
6359
6360             if Chars (Form) = Name_Component_Size then
6361                Atype := Calign_Component_Size;
6362
6363             elsif Chars (Form) = Name_Component_Size_4 then
6364                Atype := Calign_Component_Size_4;
6365
6366             elsif Chars (Form) = Name_Default then
6367                Atype := Calign_Component_Size;
6368
6369             elsif Chars (Form) = Name_Storage_Unit then
6370                Atype := Calign_Storage_Unit;
6371
6372             else
6373                Error_Pragma_Arg
6374                  ("invalid Form parameter for pragma%", Form);
6375             end if;
6376
6377             --  Case with no name, supplied, affects scope table entry
6378
6379             if No (Name) then
6380                Scope_Stack.Table
6381                  (Scope_Stack.Last).Component_Alignment_Default := Atype;
6382
6383             --  Case of name supplied
6384
6385             else
6386                Check_Arg_Is_Local_Name (Name);
6387                Find_Type (Name);
6388                Typ := Entity (Name);
6389
6390                if Typ = Any_Type
6391                  or else Rep_Item_Too_Early (Typ, N)
6392                then
6393                   return;
6394                else
6395                   Typ := Underlying_Type (Typ);
6396                end if;
6397
6398                if not Is_Record_Type (Typ)
6399                  and then not Is_Array_Type (Typ)
6400                then
6401                   Error_Pragma_Arg
6402                     ("Name parameter of pragma% must identify record or " &
6403                      "array type", Name);
6404                end if;
6405
6406                --  An explicit Component_Alignment pragma overrides an
6407                --  implicit pragma Pack, but not an explicit one.
6408
6409                if not Has_Pragma_Pack (Base_Type (Typ)) then
6410                   Set_Is_Packed (Base_Type (Typ), False);
6411                   Set_Component_Alignment (Base_Type (Typ), Atype);
6412                end if;
6413             end if;
6414          end Component_AlignmentP;
6415
6416          ----------------
6417          -- Controlled --
6418          ----------------
6419
6420          --  pragma Controlled (first_subtype_LOCAL_NAME);
6421
6422          when Pragma_Controlled => Controlled : declare
6423             Arg : Node_Id;
6424
6425          begin
6426             Check_No_Identifiers;
6427             Check_Arg_Count (1);
6428             Check_Arg_Is_Local_Name (Arg1);
6429             Arg := Expression (Arg1);
6430
6431             if not Is_Entity_Name (Arg)
6432               or else not Is_Access_Type (Entity (Arg))
6433             then
6434                Error_Pragma_Arg ("pragma% requires access type", Arg1);
6435             else
6436                Set_Has_Pragma_Controlled (Base_Type (Entity (Arg)));
6437             end if;
6438          end Controlled;
6439
6440          ----------------
6441          -- Convention --
6442          ----------------
6443
6444          --  pragma Convention ([Convention =>] convention_IDENTIFIER,
6445          --    [Entity =>] LOCAL_NAME);
6446
6447          when Pragma_Convention => Convention : declare
6448             C : Convention_Id;
6449             E : Entity_Id;
6450             pragma Warnings (Off, C);
6451             pragma Warnings (Off, E);
6452          begin
6453             Check_Arg_Order ((Name_Convention, Name_Entity));
6454             Check_Ada_83_Warning;
6455             Check_Arg_Count (2);
6456             Process_Convention (C, E);
6457          end Convention;
6458
6459          ---------------------------
6460          -- Convention_Identifier --
6461          ---------------------------
6462
6463          --  pragma Convention_Identifier ([Name =>] IDENTIFIER,
6464          --    [Convention =>] convention_IDENTIFIER);
6465
6466          when Pragma_Convention_Identifier => Convention_Identifier : declare
6467             Idnam : Name_Id;
6468             Cname : Name_Id;
6469
6470          begin
6471             GNAT_Pragma;
6472             Check_Arg_Order ((Name_Name, Name_Convention));
6473             Check_Arg_Count (2);
6474             Check_Optional_Identifier (Arg1, Name_Name);
6475             Check_Optional_Identifier (Arg2, Name_Convention);
6476             Check_Arg_Is_Identifier (Arg1);
6477             Check_Arg_Is_Identifier (Arg2);
6478             Idnam := Chars (Expression (Arg1));
6479             Cname := Chars (Expression (Arg2));
6480
6481             if Is_Convention_Name (Cname) then
6482                Record_Convention_Identifier
6483                  (Idnam, Get_Convention_Id (Cname));
6484             else
6485                Error_Pragma_Arg
6486                  ("second arg for % pragma must be convention", Arg2);
6487             end if;
6488          end Convention_Identifier;
6489
6490          ---------------
6491          -- CPP_Class --
6492          ---------------
6493
6494          --  pragma CPP_Class ([Entity =>] local_NAME)
6495
6496          when Pragma_CPP_Class => CPP_Class : declare
6497             Arg : Node_Id;
6498             Typ : Entity_Id;
6499
6500          begin
6501             if Warn_On_Obsolescent_Feature then
6502                Error_Msg_N
6503                  ("'G'N'A'T pragma cpp'_class is now obsolete; replace it" &
6504                   " by pragma import?", N);
6505             end if;
6506
6507             GNAT_Pragma;
6508             Check_Arg_Count (1);
6509             Check_Optional_Identifier (Arg1, Name_Entity);
6510             Check_Arg_Is_Local_Name (Arg1);
6511
6512             Arg := Expression (Arg1);
6513             Analyze (Arg);
6514
6515             if Etype (Arg) = Any_Type then
6516                return;
6517             end if;
6518
6519             if not Is_Entity_Name (Arg)
6520               or else not Is_Type (Entity (Arg))
6521             then
6522                Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
6523             end if;
6524
6525             Typ := Entity (Arg);
6526
6527             if not Is_Tagged_Type (Typ) then
6528                Error_Pragma_Arg ("pragma% applicable to tagged types ", Arg1);
6529             end if;
6530
6531             --  Types treated as CPP classes are treated as limited, but we
6532             --  don't require them to be declared this way. A warning is issued
6533             --  to encourage the user to declare them as limited. This is not
6534             --  an error, for compatibility reasons, because these types have
6535             --  been supported this way for some time.
6536
6537             if not Is_Limited_Type (Typ) then
6538                Error_Msg_N
6539                  ("imported 'C'P'P type should be " &
6540                     "explicitly declared limited?",
6541                   Get_Pragma_Arg (Arg1));
6542                Error_Msg_N
6543                  ("\type will be considered limited",
6544                   Get_Pragma_Arg (Arg1));
6545             end if;
6546
6547             Set_Is_CPP_Class      (Typ);
6548             Set_Is_Limited_Record (Typ);
6549             Set_Convention        (Typ, Convention_CPP);
6550
6551             --  Imported CPP types must not have discriminants (because C++
6552             --  classes do not have discriminants).
6553
6554             if Has_Discriminants (Typ) then
6555                Error_Msg_N
6556                  ("imported 'C'P'P type cannot have discriminants",
6557                   First (Discriminant_Specifications
6558                           (Declaration_Node (Typ))));
6559             end if;
6560
6561             --  Components of imported CPP types must not have default
6562             --  expressions because the constructor (if any) is in the
6563             --  C++ side.
6564
6565             if Is_Incomplete_Or_Private_Type (Typ)
6566               and then No (Underlying_Type (Typ))
6567             then
6568                --  It should be an error to apply pragma CPP to a private
6569                --  type if the underlying type is not visible (as it is
6570                --  for any representation item). For now, for backward
6571                --  compatibility we do nothing but we cannot check components
6572                --  because they are not available at this stage. All this code
6573                --  will be removed when we cleanup this obsolete GNAT pragma???
6574
6575                null;
6576
6577             else
6578                declare
6579                   Tdef  : constant Node_Id :=
6580                             Type_Definition (Declaration_Node (Typ));
6581                   Clist : Node_Id;
6582                   Comp  : Node_Id;
6583
6584                begin
6585                   if Nkind (Tdef) = N_Record_Definition then
6586                      Clist := Component_List (Tdef);
6587                   else
6588                      pragma Assert (Nkind (Tdef) = N_Derived_Type_Definition);
6589                      Clist := Component_List (Record_Extension_Part (Tdef));
6590                   end if;
6591
6592                   if Present (Clist) then
6593                      Comp := First (Component_Items (Clist));
6594                      while Present (Comp) loop
6595                         if Present (Expression (Comp)) then
6596                            Error_Msg_N
6597                              ("component of imported 'C'P'P type cannot have" &
6598                               " default expression", Expression (Comp));
6599                         end if;
6600
6601                         Next (Comp);
6602                      end loop;
6603                   end if;
6604                end;
6605             end if;
6606          end CPP_Class;
6607
6608          ---------------------
6609          -- CPP_Constructor --
6610          ---------------------
6611
6612          --  pragma CPP_Constructor ([Entity =>] LOCAL_NAME
6613          --    [, [External_Name =>] static_string_EXPRESSION ]
6614          --    [, [Link_Name     =>] static_string_EXPRESSION ]);
6615
6616          when Pragma_CPP_Constructor => CPP_Constructor : declare
6617             Elmt    : Elmt_Id;
6618             Id      : Entity_Id;
6619             Def_Id  : Entity_Id;
6620             Tag_Typ : Entity_Id;
6621
6622          begin
6623             GNAT_Pragma;
6624             Check_At_Least_N_Arguments (1);
6625             Check_At_Most_N_Arguments (3);
6626             Check_Optional_Identifier (Arg1, Name_Entity);
6627             Check_Arg_Is_Local_Name (Arg1);
6628
6629             Id := Expression (Arg1);
6630             Find_Program_Unit_Name (Id);
6631
6632             --  If we did not find the name, we are done
6633
6634             if Etype (Id) = Any_Type then
6635                return;
6636             end if;
6637
6638             Def_Id := Entity (Id);
6639
6640             --  Check if already defined as constructor
6641
6642             if Is_Constructor (Def_Id) then
6643                Error_Msg_N
6644                  ("?duplicate argument for pragma 'C'P'P_Constructor", Arg1);
6645                return;
6646             end if;
6647
6648             if Ekind (Def_Id) = E_Function
6649               and then (Is_CPP_Class (Etype (Def_Id))
6650                          or else (Is_Class_Wide_Type (Etype (Def_Id))
6651                                    and then
6652                                   Is_CPP_Class (Root_Type (Etype (Def_Id)))))
6653             then
6654                if Arg_Count >= 2 then
6655                   Set_Imported (Def_Id);
6656                   Set_Is_Public (Def_Id);
6657                   Process_Interface_Name (Def_Id, Arg2, Arg3);
6658                end if;
6659
6660                Set_Has_Completion (Def_Id);
6661                Set_Is_Constructor (Def_Id);
6662
6663                --  Imported C++ constructors are not dispatching primitives
6664                --  because in C++ they don't have a dispatch table slot.
6665                --  However, in Ada the constructor has the profile of a
6666                --  function that returns a tagged type and therefore it has
6667                --  been treated as a primitive operation during semantic
6668                --  analysis. We now remove it from the list of primitive
6669                --  operations of the type.
6670
6671                if Is_Tagged_Type (Etype (Def_Id))
6672                  and then not Is_Class_Wide_Type (Etype (Def_Id))
6673                then
6674                   pragma Assert (Is_Dispatching_Operation (Def_Id));
6675                   Tag_Typ := Etype (Def_Id);
6676
6677                   Elmt := First_Elmt (Primitive_Operations (Tag_Typ));
6678                   while Present (Elmt) and then Node (Elmt) /= Def_Id loop
6679                      Next_Elmt (Elmt);
6680                   end loop;
6681
6682                   Remove_Elmt (Primitive_Operations (Tag_Typ), Elmt);
6683                   Set_Is_Dispatching_Operation (Def_Id, False);
6684                end if;
6685
6686                --  For backward compatibility, if the constructor returns a
6687                --  class wide type, and we internally change the return type to
6688                --  the corresponding root type.
6689
6690                if Is_Class_Wide_Type (Etype (Def_Id)) then
6691                   Set_Etype (Def_Id, Root_Type (Etype (Def_Id)));
6692                end if;
6693             else
6694                Error_Pragma_Arg
6695                  ("pragma% requires function returning a 'C'P'P_Class type",
6696                    Arg1);
6697             end if;
6698          end CPP_Constructor;
6699
6700          -----------------
6701          -- CPP_Virtual --
6702          -----------------
6703
6704          when Pragma_CPP_Virtual => CPP_Virtual : declare
6705          begin
6706             GNAT_Pragma;
6707
6708             if Warn_On_Obsolescent_Feature then
6709                Error_Msg_N
6710                  ("'G'N'A'T pragma cpp'_virtual is now obsolete and has " &
6711                   "no effect?", N);
6712             end if;
6713          end CPP_Virtual;
6714
6715          ----------------
6716          -- CPP_Vtable --
6717          ----------------
6718
6719          when Pragma_CPP_Vtable => CPP_Vtable : declare
6720          begin
6721             GNAT_Pragma;
6722
6723             if Warn_On_Obsolescent_Feature then
6724                Error_Msg_N
6725                  ("'G'N'A'T pragma cpp'_vtable is now obsolete and has " &
6726                   "no effect?", N);
6727             end if;
6728          end CPP_Vtable;
6729
6730          -----------
6731          -- Debug --
6732          -----------
6733
6734          --  pragma Debug ([boolean_EXPRESSION,] PROCEDURE_CALL_STATEMENT);
6735
6736          when Pragma_Debug => Debug : declare
6737                Cond : Node_Id;
6738
6739          begin
6740             GNAT_Pragma;
6741
6742             Cond :=
6743               New_Occurrence_Of
6744                 (Boolean_Literals (Debug_Pragmas_Enabled and Expander_Active),
6745                  Loc);
6746
6747             if Arg_Count = 2 then
6748                Cond :=
6749                  Make_And_Then (Loc,
6750                    Left_Opnd   => Relocate_Node (Cond),
6751                    Right_Opnd  => Expression (Arg1));
6752             end if;
6753
6754             --  Rewrite into a conditional with an appropriate condition. We
6755             --  wrap the procedure call in a block so that overhead from e.g.
6756             --  use of the secondary stack does not generate execution overhead
6757             --  for suppressed conditions.
6758
6759             Rewrite (N, Make_Implicit_If_Statement (N,
6760               Condition => Cond,
6761                  Then_Statements => New_List (
6762                    Make_Block_Statement (Loc,
6763                      Handled_Statement_Sequence =>
6764                        Make_Handled_Sequence_Of_Statements (Loc,
6765                          Statements => New_List (
6766                            Relocate_Node (Debug_Statement (N))))))));
6767             Analyze (N);
6768          end Debug;
6769
6770          ------------------
6771          -- Debug_Policy --
6772          ------------------
6773
6774          --  pragma Debug_Policy (Check | Ignore)
6775
6776          when Pragma_Debug_Policy =>
6777             GNAT_Pragma;
6778             Check_Arg_Count (1);
6779             Check_Arg_Is_One_Of (Arg1, Name_Check, Name_Ignore);
6780             Debug_Pragmas_Enabled := Chars (Expression (Arg1)) = Name_Check;
6781
6782          ---------------------
6783          -- Detect_Blocking --
6784          ---------------------
6785
6786          --  pragma Detect_Blocking;
6787
6788          when Pragma_Detect_Blocking =>
6789             Ada_2005_Pragma;
6790             Check_Arg_Count (0);
6791             Check_Valid_Configuration_Pragma;
6792             Detect_Blocking := True;
6793
6794          ---------------
6795          -- Dimension --
6796          ---------------
6797
6798          when Pragma_Dimension =>
6799             GNAT_Pragma;
6800             Check_Arg_Count (4);
6801             Check_No_Identifiers;
6802             Check_Arg_Is_Local_Name (Arg1);
6803
6804             if not Is_Type (Arg1) then
6805                Error_Pragma ("first argument for pragma% must be subtype");
6806             end if;
6807
6808             Check_Arg_Is_Static_Expression (Arg2, Standard_Integer);
6809             Check_Arg_Is_Static_Expression (Arg3, Standard_Integer);
6810             Check_Arg_Is_Static_Expression (Arg4, Standard_Integer);
6811
6812          -------------------
6813          -- Discard_Names --
6814          -------------------
6815
6816          --  pragma Discard_Names [([On =>] LOCAL_NAME)];
6817
6818          when Pragma_Discard_Names => Discard_Names : declare
6819             E    : Entity_Id;
6820             E_Id : Entity_Id;
6821
6822          begin
6823             Check_Ada_83_Warning;
6824
6825             --  Deal with configuration pragma case
6826
6827             if Arg_Count = 0 and then Is_Configuration_Pragma then
6828                Global_Discard_Names := True;
6829                return;
6830
6831             --  Otherwise, check correct appropriate context
6832
6833             else
6834                Check_Is_In_Decl_Part_Or_Package_Spec;
6835
6836                if Arg_Count = 0 then
6837
6838                   --  If there is no parameter, then from now on this pragma
6839                   --  applies to any enumeration, exception or tagged type
6840                   --  defined in the current declarative part, and recursively
6841                   --  to any nested scope.
6842
6843                   Set_Discard_Names (Current_Scope);
6844                   return;
6845
6846                else
6847                   Check_Arg_Count (1);
6848                   Check_Optional_Identifier (Arg1, Name_On);
6849                   Check_Arg_Is_Local_Name (Arg1);
6850
6851                   E_Id := Expression (Arg1);
6852
6853                   if Etype (E_Id) = Any_Type then
6854                      return;
6855                   else
6856                      E := Entity (E_Id);
6857                   end if;
6858
6859                   if (Is_First_Subtype (E)
6860                       and then
6861                         (Is_Enumeration_Type (E) or else Is_Tagged_Type (E)))
6862                     or else Ekind (E) = E_Exception
6863                   then
6864                      Set_Discard_Names (E);
6865                   else
6866                      Error_Pragma_Arg
6867                        ("inappropriate entity for pragma%", Arg1);
6868                   end if;
6869
6870                end if;
6871             end if;
6872          end Discard_Names;
6873
6874          ---------------
6875          -- Elaborate --
6876          ---------------
6877
6878          --  pragma Elaborate (library_unit_NAME {, library_unit_NAME});
6879
6880          when Pragma_Elaborate => Elaborate : declare
6881             Arg   : Node_Id;
6882             Citem : Node_Id;
6883
6884          begin
6885             --  Pragma must be in context items list of a compilation unit
6886
6887             if not Is_In_Context_Clause then
6888                Pragma_Misplaced;
6889             end if;
6890
6891             --  Must be at least one argument
6892
6893             if Arg_Count = 0 then
6894                Error_Pragma ("pragma% requires at least one argument");
6895             end if;
6896
6897             --  In Ada 83 mode, there can be no items following it in the
6898             --  context list except other pragmas and implicit with clauses
6899             --  (e.g. those added by use of Rtsfind). In Ada 95 mode, this
6900             --  placement rule does not apply.
6901
6902             if Ada_Version = Ada_83 and then Comes_From_Source (N) then
6903                Citem := Next (N);
6904                while Present (Citem) loop
6905                   if Nkind (Citem) = N_Pragma
6906                     or else (Nkind (Citem) = N_With_Clause
6907                               and then Implicit_With (Citem))
6908                   then
6909                      null;
6910                   else
6911                      Error_Pragma
6912                        ("(Ada 83) pragma% must be at end of context clause");
6913                   end if;
6914
6915                   Next (Citem);
6916                end loop;
6917             end if;
6918
6919             --  Finally, the arguments must all be units mentioned in a with
6920             --  clause in the same context clause. Note we already checked (in
6921             --  Par.Prag) that the arguments are all identifiers or selected
6922             --  components.
6923
6924             Arg := Arg1;
6925             Outer : while Present (Arg) loop
6926                Citem := First (List_Containing (N));
6927                Inner : while Citem /= N loop
6928                   if Nkind (Citem) = N_With_Clause
6929                     and then Same_Name (Name (Citem), Expression (Arg))
6930                   then
6931                      Set_Elaborate_Present (Citem, True);
6932                      Set_Unit_Name (Expression (Arg), Name (Citem));
6933
6934                      --  With the pragma present, elaboration calls on
6935                      --  subprograms from the named unit need no further
6936                      --  checks, as long as the pragma appears in the current
6937                      --  compilation unit. If the pragma appears in some unit
6938                      --  in the context, there might still be a need for an
6939                      --  Elaborate_All_Desirable from the current compilation
6940                      --  to the named unit, so we keep the check enabled.
6941
6942                      if In_Extended_Main_Source_Unit (N) then
6943                         Set_Suppress_Elaboration_Warnings
6944                           (Entity (Name (Citem)));
6945                      end if;
6946
6947                      exit Inner;
6948                   end if;
6949
6950                   Next (Citem);
6951                end loop Inner;
6952
6953                if Citem = N then
6954                   Error_Pragma_Arg
6955                     ("argument of pragma% is not with'ed unit", Arg);
6956                end if;
6957
6958                Next (Arg);
6959             end loop Outer;
6960
6961             --  Give a warning if operating in static mode with -gnatwl
6962             --  (elaboration warnings enabled) switch set.
6963
6964             if Elab_Warnings and not Dynamic_Elaboration_Checks then
6965                Error_Msg_N
6966                  ("?use of pragma Elaborate may not be safe", N);
6967                Error_Msg_N
6968                  ("?use pragma Elaborate_All instead if possible", N);
6969             end if;
6970          end Elaborate;
6971
6972          -------------------
6973          -- Elaborate_All --
6974          -------------------
6975
6976          --  pragma Elaborate_All (library_unit_NAME {, library_unit_NAME});
6977
6978          when Pragma_Elaborate_All => Elaborate_All : declare
6979             Arg   : Node_Id;
6980             Citem : Node_Id;
6981
6982          begin
6983             Check_Ada_83_Warning;
6984
6985             --  Pragma must be in context items list of a compilation unit
6986
6987             if not Is_In_Context_Clause then
6988                Pragma_Misplaced;
6989             end if;
6990
6991             --  Must be at least one argument
6992
6993             if Arg_Count = 0 then
6994                Error_Pragma ("pragma% requires at least one argument");
6995             end if;
6996
6997             --  Note: unlike pragma Elaborate, pragma Elaborate_All does not
6998             --  have to appear at the end of the context clause, but may
6999             --  appear mixed in with other items, even in Ada 83 mode.
7000
7001             --  Final check: the arguments must all be units mentioned in
7002             --  a with clause in the same context clause. Note that we
7003             --  already checked (in Par.Prag) that all the arguments are
7004             --  either identifiers or selected components.
7005
7006             Arg := Arg1;
7007             Outr : while Present (Arg) loop
7008                Citem := First (List_Containing (N));
7009                Innr : while Citem /= N loop
7010                   if Nkind (Citem) = N_With_Clause
7011                     and then Same_Name (Name (Citem), Expression (Arg))
7012                   then
7013                      Set_Elaborate_All_Present (Citem, True);
7014                      Set_Unit_Name (Expression (Arg), Name (Citem));
7015
7016                      --  Suppress warnings and elaboration checks on the named
7017                      --  unit if the pragma is in the current compilation, as
7018                      --  for pragma Elaborate.
7019
7020                      if In_Extended_Main_Source_Unit (N) then
7021                         Set_Suppress_Elaboration_Warnings
7022                           (Entity (Name (Citem)));
7023                      end if;
7024                      exit Innr;
7025                   end if;
7026
7027                   Next (Citem);
7028                end loop Innr;
7029
7030                if Citem = N then
7031                   Set_Error_Posted (N);
7032                   Error_Pragma_Arg
7033                     ("argument of pragma% is not with'ed unit", Arg);
7034                end if;
7035
7036                Next (Arg);
7037             end loop Outr;
7038          end Elaborate_All;
7039
7040          --------------------
7041          -- Elaborate_Body --
7042          --------------------
7043
7044          --  pragma Elaborate_Body [( library_unit_NAME )];
7045
7046          when Pragma_Elaborate_Body => Elaborate_Body : declare
7047             Cunit_Node : Node_Id;
7048             Cunit_Ent  : Entity_Id;
7049
7050          begin
7051             Check_Ada_83_Warning;
7052             Check_Valid_Library_Unit_Pragma;
7053
7054             if Nkind (N) = N_Null_Statement then
7055                return;
7056             end if;
7057
7058             Cunit_Node := Cunit (Current_Sem_Unit);
7059             Cunit_Ent  := Cunit_Entity (Current_Sem_Unit);
7060
7061             if Nkind_In (Unit (Cunit_Node), N_Package_Body,
7062                                             N_Subprogram_Body)
7063             then
7064                Error_Pragma ("pragma% must refer to a spec, not a body");
7065             else
7066                Set_Body_Required (Cunit_Node, True);
7067                Set_Has_Pragma_Elaborate_Body (Cunit_Ent);
7068
7069                --  If we are in dynamic elaboration mode, then we suppress
7070                --  elaboration warnings for the unit, since it is definitely
7071                --  fine NOT to do dynamic checks at the first level (and such
7072                --  checks will be suppressed because no elaboration boolean
7073                --  is created for Elaborate_Body packages).
7074
7075                --  But in the static model of elaboration, Elaborate_Body is
7076                --  definitely NOT good enough to ensure elaboration safety on
7077                --  its own, since the body may WITH other units that are not
7078                --  safe from an elaboration point of view, so a client must
7079                --  still do an Elaborate_All on such units.
7080
7081                --  Debug flag -gnatdD restores the old behavior of 3.13, where
7082                --  Elaborate_Body always suppressed elab warnings.
7083
7084                if Dynamic_Elaboration_Checks or Debug_Flag_DD then
7085                   Set_Suppress_Elaboration_Warnings (Cunit_Ent);
7086                end if;
7087             end if;
7088          end Elaborate_Body;
7089
7090          ------------------------
7091          -- Elaboration_Checks --
7092          ------------------------
7093
7094          --  pragma Elaboration_Checks (Static | Dynamic);
7095
7096          when Pragma_Elaboration_Checks =>
7097             GNAT_Pragma;
7098             Check_Arg_Count (1);
7099             Check_Arg_Is_One_Of (Arg1, Name_Static, Name_Dynamic);
7100             Dynamic_Elaboration_Checks :=
7101               (Chars (Get_Pragma_Arg (Arg1)) = Name_Dynamic);
7102
7103          ---------------
7104          -- Eliminate --
7105          ---------------
7106
7107          --  pragma Eliminate (
7108          --      [Unit_Name  =>] IDENTIFIER | SELECTED_COMPONENT,
7109          --    [,[Entity     =>] IDENTIFIER |
7110          --                      SELECTED_COMPONENT |
7111          --                      STRING_LITERAL]
7112          --    [,                OVERLOADING_RESOLUTION]);
7113
7114          --  OVERLOADING_RESOLUTION ::= PARAMETER_AND_RESULT_TYPE_PROFILE |
7115          --                             SOURCE_LOCATION
7116
7117          --  PARAMETER_AND_RESULT_TYPE_PROFILE ::= PROCEDURE_PROFILE |
7118          --                                        FUNCTION_PROFILE
7119
7120          --  PROCEDURE_PROFILE ::= Parameter_Types => PARAMETER_TYPES
7121
7122          --  FUNCTION_PROFILE ::= [Parameter_Types => PARAMETER_TYPES,]
7123          --                       Result_Type => result_SUBTYPE_NAME]
7124
7125          --  PARAMETER_TYPES ::= (SUBTYPE_NAME {, SUBTYPE_NAME})
7126          --  SUBTYPE_NAME    ::= STRING_LITERAL
7127
7128          --  SOURCE_LOCATION ::= Source_Location => SOURCE_TRACE
7129          --  SOURCE_TRACE    ::= STRING_LITERAL
7130
7131          when Pragma_Eliminate => Eliminate : declare
7132             Args  : Args_List (1 .. 5);
7133             Names : constant Name_List (1 .. 5) := (
7134                       Name_Unit_Name,
7135                       Name_Entity,
7136                       Name_Parameter_Types,
7137                       Name_Result_Type,
7138                       Name_Source_Location);
7139
7140             Unit_Name       : Node_Id renames Args (1);
7141             Entity          : Node_Id renames Args (2);
7142             Parameter_Types : Node_Id renames Args (3);
7143             Result_Type     : Node_Id renames Args (4);
7144             Source_Location : Node_Id renames Args (5);
7145
7146          begin
7147             GNAT_Pragma;
7148             Check_Valid_Configuration_Pragma;
7149             Gather_Associations (Names, Args);
7150
7151             if No (Unit_Name) then
7152                Error_Pragma ("missing Unit_Name argument for pragma%");
7153             end if;
7154
7155             if No (Entity)
7156               and then (Present (Parameter_Types)
7157                           or else
7158                         Present (Result_Type)
7159                           or else
7160                         Present (Source_Location))
7161             then
7162                Error_Pragma ("missing Entity argument for pragma%");
7163             end if;
7164
7165             if (Present (Parameter_Types)
7166                        or else
7167                 Present (Result_Type))
7168               and then
7169                 Present (Source_Location)
7170             then
7171                Error_Pragma
7172                  ("parameter profile and source location cannot " &
7173                   "be used together in pragma%");
7174             end if;
7175
7176             Process_Eliminate_Pragma
7177               (N,
7178                Unit_Name,
7179                Entity,
7180                Parameter_Types,
7181                Result_Type,
7182                Source_Location);
7183          end Eliminate;
7184
7185          ------------
7186          -- Export --
7187          ------------
7188
7189          --  pragma Export (
7190          --    [   Convention    =>] convention_IDENTIFIER,
7191          --    [   Entity        =>] local_NAME
7192          --    [, [External_Name =>] static_string_EXPRESSION ]
7193          --    [, [Link_Name     =>] static_string_EXPRESSION ]);
7194
7195          when Pragma_Export => Export : declare
7196             C      : Convention_Id;
7197             Def_Id : Entity_Id;
7198
7199             pragma Warnings (Off, C);
7200
7201          begin
7202             Check_Ada_83_Warning;
7203             Check_Arg_Order
7204               ((Name_Convention,
7205                 Name_Entity,
7206                 Name_External_Name,
7207                 Name_Link_Name));
7208             Check_At_Least_N_Arguments (2);
7209             Check_At_Most_N_Arguments  (4);
7210             Process_Convention (C, Def_Id);
7211
7212             if Ekind (Def_Id) /= E_Constant then
7213                Note_Possible_Modification (Expression (Arg2), Sure => False);
7214             end if;
7215
7216             Process_Interface_Name (Def_Id, Arg3, Arg4);
7217             Set_Exported (Def_Id, Arg2);
7218
7219             --  If the entity is a deferred constant, propagate the information
7220             --  to the full view, because gigi elaborates the full view only.
7221
7222             if Ekind (Def_Id) = E_Constant
7223               and then Present (Full_View (Def_Id))
7224             then
7225                declare
7226                   Id2 : constant Entity_Id := Full_View (Def_Id);
7227                begin
7228                   Set_Is_Exported    (Id2, Is_Exported          (Def_Id));
7229                   Set_First_Rep_Item (Id2, First_Rep_Item       (Def_Id));
7230                   Set_Interface_Name (Id2, Einfo.Interface_Name (Def_Id));
7231                end;
7232             end if;
7233          end Export;
7234
7235          ----------------------
7236          -- Export_Exception --
7237          ----------------------
7238
7239          --  pragma Export_Exception (
7240          --        [Internal         =>] LOCAL_NAME
7241          --     [, [External         =>] EXTERNAL_SYMBOL]
7242          --     [, [Form     =>] Ada | VMS]
7243          --     [, [Code     =>] static_integer_EXPRESSION]);
7244
7245          when Pragma_Export_Exception => Export_Exception : declare
7246             Args  : Args_List (1 .. 4);
7247             Names : constant Name_List (1 .. 4) := (
7248                       Name_Internal,
7249                       Name_External,
7250                       Name_Form,
7251                       Name_Code);
7252
7253             Internal : Node_Id renames Args (1);
7254             External : Node_Id renames Args (2);
7255             Form     : Node_Id renames Args (3);
7256             Code     : Node_Id renames Args (4);
7257
7258          begin
7259             GNAT_Pragma;
7260
7261             if Inside_A_Generic then
7262                Error_Pragma ("pragma% cannot be used for generic entities");
7263             end if;
7264
7265             Gather_Associations (Names, Args);
7266             Process_Extended_Import_Export_Exception_Pragma (
7267               Arg_Internal => Internal,
7268               Arg_External => External,
7269               Arg_Form     => Form,
7270               Arg_Code     => Code);
7271
7272             if not Is_VMS_Exception (Entity (Internal)) then
7273                Set_Exported (Entity (Internal), Internal);
7274             end if;
7275          end Export_Exception;
7276
7277          ---------------------
7278          -- Export_Function --
7279          ---------------------
7280
7281          --  pragma Export_Function (
7282          --        [Internal         =>] LOCAL_NAME
7283          --     [, [External         =>] EXTERNAL_SYMBOL]
7284          --     [, [Parameter_Types  =>] (PARAMETER_TYPES)]
7285          --     [, [Result_Type      =>] TYPE_DESIGNATOR]
7286          --     [, [Mechanism        =>] MECHANISM]
7287          --     [, [Result_Mechanism =>] MECHANISM_NAME]);
7288
7289          --  EXTERNAL_SYMBOL ::=
7290          --    IDENTIFIER
7291          --  | static_string_EXPRESSION
7292
7293          --  PARAMETER_TYPES ::=
7294          --    null
7295          --  | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7296
7297          --  TYPE_DESIGNATOR ::=
7298          --    subtype_NAME
7299          --  | subtype_Name ' Access
7300
7301          --  MECHANISM ::=
7302          --    MECHANISM_NAME
7303          --  | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7304
7305          --  MECHANISM_ASSOCIATION ::=
7306          --    [formal_parameter_NAME =>] MECHANISM_NAME
7307
7308          --  MECHANISM_NAME ::=
7309          --    Value
7310          --  | Reference
7311          --  | Descriptor [([Class =>] CLASS_NAME)]
7312
7313          --  CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7314
7315          when Pragma_Export_Function => Export_Function : declare
7316             Args  : Args_List (1 .. 6);
7317             Names : constant Name_List (1 .. 6) := (
7318                       Name_Internal,
7319                       Name_External,
7320                       Name_Parameter_Types,
7321                       Name_Result_Type,
7322                       Name_Mechanism,
7323                       Name_Result_Mechanism);
7324
7325             Internal         : Node_Id renames Args (1);
7326             External         : Node_Id renames Args (2);
7327             Parameter_Types  : Node_Id renames Args (3);
7328             Result_Type      : Node_Id renames Args (4);
7329             Mechanism        : Node_Id renames Args (5);
7330             Result_Mechanism : Node_Id renames Args (6);
7331
7332          begin
7333             GNAT_Pragma;
7334             Gather_Associations (Names, Args);
7335             Process_Extended_Import_Export_Subprogram_Pragma (
7336               Arg_Internal         => Internal,
7337               Arg_External         => External,
7338               Arg_Parameter_Types  => Parameter_Types,
7339               Arg_Result_Type      => Result_Type,
7340               Arg_Mechanism        => Mechanism,
7341               Arg_Result_Mechanism => Result_Mechanism);
7342          end Export_Function;
7343
7344          -------------------
7345          -- Export_Object --
7346          -------------------
7347
7348          --  pragma Export_Object (
7349          --        [Internal =>] LOCAL_NAME
7350          --     [, [External =>] EXTERNAL_SYMBOL]
7351          --     [, [Size     =>] EXTERNAL_SYMBOL]);
7352
7353          --  EXTERNAL_SYMBOL ::=
7354          --    IDENTIFIER
7355          --  | static_string_EXPRESSION
7356
7357          --  PARAMETER_TYPES ::=
7358          --    null
7359          --  | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7360
7361          --  TYPE_DESIGNATOR ::=
7362          --    subtype_NAME
7363          --  | subtype_Name ' Access
7364
7365          --  MECHANISM ::=
7366          --    MECHANISM_NAME
7367          --  | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7368
7369          --  MECHANISM_ASSOCIATION ::=
7370          --    [formal_parameter_NAME =>] MECHANISM_NAME
7371
7372          --  MECHANISM_NAME ::=
7373          --    Value
7374          --  | Reference
7375          --  | Descriptor [([Class =>] CLASS_NAME)]
7376
7377          --  CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7378
7379          when Pragma_Export_Object => Export_Object : declare
7380             Args  : Args_List (1 .. 3);
7381             Names : constant Name_List (1 .. 3) := (
7382                       Name_Internal,
7383                       Name_External,
7384                       Name_Size);
7385
7386             Internal : Node_Id renames Args (1);
7387             External : Node_Id renames Args (2);
7388             Size     : Node_Id renames Args (3);
7389
7390          begin
7391             GNAT_Pragma;
7392             Gather_Associations (Names, Args);
7393             Process_Extended_Import_Export_Object_Pragma (
7394               Arg_Internal => Internal,
7395               Arg_External => External,
7396               Arg_Size     => Size);
7397          end Export_Object;
7398
7399          ----------------------
7400          -- Export_Procedure --
7401          ----------------------
7402
7403          --  pragma Export_Procedure (
7404          --        [Internal         =>] LOCAL_NAME
7405          --     [, [External         =>] EXTERNAL_SYMBOL]
7406          --     [, [Parameter_Types  =>] (PARAMETER_TYPES)]
7407          --     [, [Mechanism        =>] MECHANISM]);
7408
7409          --  EXTERNAL_SYMBOL ::=
7410          --    IDENTIFIER
7411          --  | static_string_EXPRESSION
7412
7413          --  PARAMETER_TYPES ::=
7414          --    null
7415          --  | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7416
7417          --  TYPE_DESIGNATOR ::=
7418          --    subtype_NAME
7419          --  | subtype_Name ' Access
7420
7421          --  MECHANISM ::=
7422          --    MECHANISM_NAME
7423          --  | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7424
7425          --  MECHANISM_ASSOCIATION ::=
7426          --    [formal_parameter_NAME =>] MECHANISM_NAME
7427
7428          --  MECHANISM_NAME ::=
7429          --    Value
7430          --  | Reference
7431          --  | Descriptor [([Class =>] CLASS_NAME)]
7432
7433          --  CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7434
7435          when Pragma_Export_Procedure => Export_Procedure : declare
7436             Args  : Args_List (1 .. 4);
7437             Names : constant Name_List (1 .. 4) := (
7438                       Name_Internal,
7439                       Name_External,
7440                       Name_Parameter_Types,
7441                       Name_Mechanism);
7442
7443             Internal        : Node_Id renames Args (1);
7444             External        : Node_Id renames Args (2);
7445             Parameter_Types : Node_Id renames Args (3);
7446             Mechanism       : Node_Id renames Args (4);
7447
7448          begin
7449             GNAT_Pragma;
7450             Gather_Associations (Names, Args);
7451             Process_Extended_Import_Export_Subprogram_Pragma (
7452               Arg_Internal        => Internal,
7453               Arg_External        => External,
7454               Arg_Parameter_Types => Parameter_Types,
7455               Arg_Mechanism       => Mechanism);
7456          end Export_Procedure;
7457
7458          ------------------
7459          -- Export_Value --
7460          ------------------
7461
7462          --  pragma Export_Value (
7463          --     [Value     =>] static_integer_EXPRESSION,
7464          --     [Link_Name =>] static_string_EXPRESSION);
7465
7466          when Pragma_Export_Value =>
7467             GNAT_Pragma;
7468             Check_Arg_Order ((Name_Value, Name_Link_Name));
7469             Check_Arg_Count (2);
7470
7471             Check_Optional_Identifier (Arg1, Name_Value);
7472             Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
7473
7474             Check_Optional_Identifier (Arg2, Name_Link_Name);
7475             Check_Arg_Is_Static_Expression (Arg2, Standard_String);
7476
7477          -----------------------------
7478          -- Export_Valued_Procedure --
7479          -----------------------------
7480
7481          --  pragma Export_Valued_Procedure (
7482          --        [Internal         =>] LOCAL_NAME
7483          --     [, [External         =>] EXTERNAL_SYMBOL,]
7484          --     [, [Parameter_Types  =>] (PARAMETER_TYPES)]
7485          --     [, [Mechanism        =>] MECHANISM]);
7486
7487          --  EXTERNAL_SYMBOL ::=
7488          --    IDENTIFIER
7489          --  | static_string_EXPRESSION
7490
7491          --  PARAMETER_TYPES ::=
7492          --    null
7493          --  | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7494
7495          --  TYPE_DESIGNATOR ::=
7496          --    subtype_NAME
7497          --  | subtype_Name ' Access
7498
7499          --  MECHANISM ::=
7500          --    MECHANISM_NAME
7501          --  | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7502
7503          --  MECHANISM_ASSOCIATION ::=
7504          --    [formal_parameter_NAME =>] MECHANISM_NAME
7505
7506          --  MECHANISM_NAME ::=
7507          --    Value
7508          --  | Reference
7509          --  | Descriptor [([Class =>] CLASS_NAME)]
7510
7511          --  CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7512
7513          when Pragma_Export_Valued_Procedure =>
7514          Export_Valued_Procedure : declare
7515             Args  : Args_List (1 .. 4);
7516             Names : constant Name_List (1 .. 4) := (
7517                       Name_Internal,
7518                       Name_External,
7519                       Name_Parameter_Types,
7520                       Name_Mechanism);
7521
7522             Internal        : Node_Id renames Args (1);
7523             External        : Node_Id renames Args (2);
7524             Parameter_Types : Node_Id renames Args (3);
7525             Mechanism       : Node_Id renames Args (4);
7526
7527          begin
7528             GNAT_Pragma;
7529             Gather_Associations (Names, Args);
7530             Process_Extended_Import_Export_Subprogram_Pragma (
7531               Arg_Internal        => Internal,
7532               Arg_External        => External,
7533               Arg_Parameter_Types => Parameter_Types,
7534               Arg_Mechanism       => Mechanism);
7535          end Export_Valued_Procedure;
7536
7537          -------------------
7538          -- Extend_System --
7539          -------------------
7540
7541          --  pragma Extend_System ([Name =>] Identifier);
7542
7543          when Pragma_Extend_System => Extend_System : declare
7544          begin
7545             GNAT_Pragma;
7546             Check_Valid_Configuration_Pragma;
7547             Check_Arg_Count (1);
7548             Check_Optional_Identifier (Arg1, Name_Name);
7549             Check_Arg_Is_Identifier (Arg1);
7550
7551             Get_Name_String (Chars (Expression (Arg1)));
7552
7553             if Name_Len > 4
7554               and then Name_Buffer (1 .. 4) = "aux_"
7555             then
7556                if Present (System_Extend_Pragma_Arg) then
7557                   if Chars (Expression (Arg1)) =
7558                      Chars (Expression (System_Extend_Pragma_Arg))
7559                   then
7560                      null;
7561                   else
7562                      Error_Msg_Sloc := Sloc (System_Extend_Pragma_Arg);
7563                      Error_Pragma ("pragma% conflicts with that #");
7564                   end if;
7565
7566                else
7567                   System_Extend_Pragma_Arg := Arg1;
7568
7569                   if not GNAT_Mode then
7570                      System_Extend_Unit := Arg1;
7571                   end if;
7572                end if;
7573             else
7574                Error_Pragma ("incorrect name for pragma%, must be Aux_xxx");
7575             end if;
7576          end Extend_System;
7577
7578          ------------------------
7579          -- Extensions_Allowed --
7580          ------------------------
7581
7582          --  pragma Extensions_Allowed (ON | OFF);
7583
7584          when Pragma_Extensions_Allowed =>
7585             GNAT_Pragma;
7586             Check_Arg_Count (1);
7587             Check_No_Identifiers;
7588             Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
7589
7590             if Chars (Expression (Arg1)) = Name_On then
7591                Extensions_Allowed := True;
7592                Ada_Version := Ada_Version_Type'Last;
7593
7594             else
7595                Extensions_Allowed := False;
7596                Ada_Version := Ada_Version_Explicit;
7597             end if;
7598
7599          --------------
7600          -- External --
7601          --------------
7602
7603          --  pragma External (
7604          --    [   Convention    =>] convention_IDENTIFIER,
7605          --    [   Entity        =>] local_NAME
7606          --    [, [External_Name =>] static_string_EXPRESSION ]
7607          --    [, [Link_Name     =>] static_string_EXPRESSION ]);
7608
7609          when Pragma_External => External : declare
7610                Def_Id : Entity_Id;
7611
7612                C : Convention_Id;
7613                pragma Warnings (Off, C);
7614
7615          begin
7616             GNAT_Pragma;
7617             Check_Arg_Order
7618               ((Name_Convention,
7619                 Name_Entity,
7620                 Name_External_Name,
7621                 Name_Link_Name));
7622             Check_At_Least_N_Arguments (2);
7623             Check_At_Most_N_Arguments  (4);
7624             Process_Convention (C, Def_Id);
7625             Note_Possible_Modification (Expression (Arg2), Sure => False);
7626             Process_Interface_Name (Def_Id, Arg3, Arg4);
7627             Set_Exported (Def_Id, Arg2);
7628          end External;
7629
7630          --------------------------
7631          -- External_Name_Casing --
7632          --------------------------
7633
7634          --  pragma External_Name_Casing (
7635          --    UPPERCASE | LOWERCASE
7636          --    [, AS_IS | UPPERCASE | LOWERCASE]);
7637
7638          when Pragma_External_Name_Casing => External_Name_Casing : declare
7639          begin
7640             GNAT_Pragma;
7641             Check_No_Identifiers;
7642
7643             if Arg_Count = 2 then
7644                Check_Arg_Is_One_Of
7645                  (Arg2, Name_As_Is, Name_Uppercase, Name_Lowercase);
7646
7647                case Chars (Get_Pragma_Arg (Arg2)) is
7648                   when Name_As_Is     =>
7649                      Opt.External_Name_Exp_Casing := As_Is;
7650
7651                   when Name_Uppercase =>
7652                      Opt.External_Name_Exp_Casing := Uppercase;
7653
7654                   when Name_Lowercase =>
7655                      Opt.External_Name_Exp_Casing := Lowercase;
7656
7657                   when others =>
7658                      null;
7659                end case;
7660
7661             else
7662                Check_Arg_Count (1);
7663             end if;
7664
7665             Check_Arg_Is_One_Of (Arg1, Name_Uppercase, Name_Lowercase);
7666
7667             case Chars (Get_Pragma_Arg (Arg1)) is
7668                when Name_Uppercase =>
7669                   Opt.External_Name_Imp_Casing := Uppercase;
7670
7671                when Name_Lowercase =>
7672                   Opt.External_Name_Imp_Casing := Lowercase;
7673
7674                when others =>
7675                   null;
7676             end case;
7677          end External_Name_Casing;
7678
7679          --------------------------
7680          -- Favor_Top_Level --
7681          --------------------------
7682
7683          --  pragma Favor_Top_Level (type_NAME);
7684
7685          when Pragma_Favor_Top_Level => Favor_Top_Level : declare
7686                Named_Entity : Entity_Id;
7687
7688          begin
7689             GNAT_Pragma;
7690             Check_No_Identifiers;
7691             Check_Arg_Count (1);
7692             Check_Arg_Is_Local_Name (Arg1);
7693             Named_Entity := Entity (Expression (Arg1));
7694
7695             --  If it's an access-to-subprogram type (in particular, not a
7696             --  subtype), set the flag on that type.
7697
7698             if Is_Access_Subprogram_Type (Named_Entity) then
7699                Set_Can_Use_Internal_Rep (Named_Entity, False);
7700
7701             --  Otherwise it's an error (name denotes the wrong sort of entity)
7702
7703             else
7704                Error_Pragma_Arg
7705                  ("access-to-subprogram type expected", Expression (Arg1));
7706             end if;
7707          end Favor_Top_Level;
7708
7709          ---------------
7710          -- Fast_Math --
7711          ---------------
7712
7713          --  pragma Fast_Math;
7714
7715          when Pragma_Fast_Math =>
7716             GNAT_Pragma;
7717             Check_No_Identifiers;
7718             Check_Valid_Configuration_Pragma;
7719             Fast_Math := True;
7720
7721          ---------------------------
7722          -- Finalize_Storage_Only --
7723          ---------------------------
7724
7725          --  pragma Finalize_Storage_Only (first_subtype_LOCAL_NAME);
7726
7727          when Pragma_Finalize_Storage_Only => Finalize_Storage : declare
7728             Assoc   : constant Node_Id := Arg1;
7729             Type_Id : constant Node_Id := Expression (Assoc);
7730             Typ     : Entity_Id;
7731
7732          begin
7733             GNAT_Pragma;
7734             Check_No_Identifiers;
7735             Check_Arg_Count (1);
7736             Check_Arg_Is_Local_Name (Arg1);
7737
7738             Find_Type (Type_Id);
7739             Typ := Entity (Type_Id);
7740
7741             if Typ = Any_Type
7742               or else Rep_Item_Too_Early (Typ, N)
7743             then
7744                return;
7745             else
7746                Typ := Underlying_Type (Typ);
7747             end if;
7748
7749             if not Is_Controlled (Typ) then
7750                Error_Pragma ("pragma% must specify controlled type");
7751             end if;
7752
7753             Check_First_Subtype (Arg1);
7754
7755             if Finalize_Storage_Only (Typ) then
7756                Error_Pragma ("duplicate pragma%, only one allowed");
7757
7758             elsif not Rep_Item_Too_Late (Typ, N) then
7759                Set_Finalize_Storage_Only (Base_Type (Typ), True);
7760             end if;
7761          end Finalize_Storage;
7762
7763          --------------------------
7764          -- Float_Representation --
7765          --------------------------
7766
7767          --  pragma Float_Representation (FLOAT_REP[, float_type_LOCAL_NAME]);
7768
7769          --  FLOAT_REP ::= VAX_Float | IEEE_Float
7770
7771          when Pragma_Float_Representation => Float_Representation : declare
7772             Argx : Node_Id;
7773             Digs : Nat;
7774             Ent  : Entity_Id;
7775
7776          begin
7777             GNAT_Pragma;
7778
7779             if Arg_Count = 1 then
7780                Check_Valid_Configuration_Pragma;
7781             else
7782                Check_Arg_Count (2);
7783                Check_Optional_Identifier (Arg2, Name_Entity);
7784                Check_Arg_Is_Local_Name (Arg2);
7785             end if;
7786
7787             Check_No_Identifier (Arg1);
7788             Check_Arg_Is_One_Of (Arg1, Name_VAX_Float, Name_IEEE_Float);
7789
7790             if not OpenVMS_On_Target then
7791                if Chars (Expression (Arg1)) = Name_VAX_Float then
7792                   Error_Pragma
7793                     ("?pragma% ignored (applies only to Open'V'M'S)");
7794                end if;
7795
7796                return;
7797             end if;
7798
7799             --  One argument case
7800
7801             if Arg_Count = 1 then
7802                if Chars (Expression (Arg1)) = Name_VAX_Float then
7803                   if Opt.Float_Format = 'I' then
7804                      Error_Pragma ("'I'E'E'E format previously specified");
7805                   end if;
7806
7807                   Opt.Float_Format := 'V';
7808
7809                else
7810                   if Opt.Float_Format = 'V' then
7811                      Error_Pragma ("'V'A'X format previously specified");
7812                   end if;
7813
7814                   Opt.Float_Format := 'I';
7815                end if;
7816
7817                Set_Standard_Fpt_Formats;
7818
7819             --  Two argument case
7820
7821             else
7822                Argx := Get_Pragma_Arg (Arg2);
7823
7824                if not Is_Entity_Name (Argx)
7825                  or else not Is_Floating_Point_Type (Entity (Argx))
7826                then
7827                   Error_Pragma_Arg
7828                     ("second argument of% pragma must be floating-point type",
7829                      Arg2);
7830                end if;
7831
7832                Ent  := Entity (Argx);
7833                Digs := UI_To_Int (Digits_Value (Ent));
7834
7835                --  Two arguments, VAX_Float case
7836
7837                if Chars (Expression (Arg1)) = Name_VAX_Float then
7838                   case Digs is
7839                      when  6 => Set_F_Float (Ent);
7840                      when  9 => Set_D_Float (Ent);
7841                      when 15 => Set_G_Float (Ent);
7842
7843                      when others =>
7844                         Error_Pragma_Arg
7845                           ("wrong digits value, must be 6,9 or 15", Arg2);
7846                   end case;
7847
7848                --  Two arguments, IEEE_Float case
7849
7850                else
7851                   case Digs is
7852                      when  6 => Set_IEEE_Short (Ent);
7853                      when 15 => Set_IEEE_Long  (Ent);
7854
7855                      when others =>
7856                         Error_Pragma_Arg
7857                           ("wrong digits value, must be 6 or 15", Arg2);
7858                   end case;
7859                end if;
7860             end if;
7861          end Float_Representation;
7862
7863          -----------
7864          -- Ident --
7865          -----------
7866
7867          --  pragma Ident (static_string_EXPRESSION)
7868
7869          --  Note: pragma Comment shares this processing. Pragma Comment is
7870          --  identical to Ident, except that the restriction of the argument to
7871          --  31 characters and the placement restrictions are not enforced for
7872          --  pragma Comment.
7873
7874          when Pragma_Ident | Pragma_Comment => Ident : declare
7875             Str : Node_Id;
7876
7877          begin
7878             GNAT_Pragma;
7879             Check_Arg_Count (1);
7880             Check_No_Identifiers;
7881             Check_Arg_Is_Static_Expression (Arg1, Standard_String);
7882             Store_Note (N);
7883
7884             --  For pragma Ident, preserve DEC compatibility by requiring the
7885             --  pragma to appear in a declarative part or package spec.
7886
7887             if Prag_Id = Pragma_Ident then
7888                Check_Is_In_Decl_Part_Or_Package_Spec;
7889             end if;
7890
7891             Str := Expr_Value_S (Expression (Arg1));
7892
7893             declare
7894                CS : Node_Id;
7895                GP : Node_Id;
7896
7897             begin
7898                GP := Parent (Parent (N));
7899
7900                if Nkind_In (GP, N_Package_Declaration,
7901                                 N_Generic_Package_Declaration)
7902                then
7903                   GP := Parent (GP);
7904                end if;
7905
7906                --  If we have a compilation unit, then record the ident value,
7907                --  checking for improper duplication.
7908
7909                if Nkind (GP) = N_Compilation_Unit then
7910                   CS := Ident_String (Current_Sem_Unit);
7911
7912                   if Present (CS) then
7913
7914                      --  For Ident, we do not permit multiple instances
7915
7916                      if Prag_Id = Pragma_Ident then
7917                         Error_Pragma ("duplicate% pragma not permitted");
7918
7919                      --  For Comment, we concatenate the string, unless we want
7920                      --  to preserve the tree structure for ASIS.
7921
7922                      elsif not ASIS_Mode then
7923                         Start_String (Strval (CS));
7924                         Store_String_Char (' ');
7925                         Store_String_Chars (Strval (Str));
7926                         Set_Strval (CS, End_String);
7927                      end if;
7928
7929                   else
7930                      --  In VMS, the effect of IDENT is achieved by passing
7931                      --  --identification=name as a --for-linker switch.
7932
7933                      if OpenVMS_On_Target then
7934                         Start_String;
7935                         Store_String_Chars
7936                           ("--for-linker=--identification=");
7937                         String_To_Name_Buffer (Strval (Str));
7938                         Store_String_Chars (Name_Buffer (1 .. Name_Len));
7939
7940                         --  Only the last processed IDENT is saved. The main
7941                         --  purpose is so an IDENT associated with a main
7942                         --  procedure will be used in preference to an IDENT
7943                         --  associated with a with'd package.
7944
7945                         Replace_Linker_Option_String
7946                           (End_String, "--for-linker=--identification=");
7947                      end if;
7948
7949                      Set_Ident_String (Current_Sem_Unit, Str);
7950                   end if;
7951
7952                --  For subunits, we just ignore the Ident, since in GNAT these
7953                --  are not separate object files, and hence not separate units
7954                --  in the unit table.
7955
7956                elsif Nkind (GP) = N_Subunit then
7957                   null;
7958
7959                --  Otherwise we have a misplaced pragma Ident, but we ignore
7960                --  this if we are in an instantiation, since it comes from
7961                --  a generic, and has no relevance to the instantiation.
7962
7963                elsif Prag_Id = Pragma_Ident then
7964                   if Instantiation_Location (Loc) = No_Location then
7965                      Error_Pragma ("pragma% only allowed at outer level");
7966                   end if;
7967                end if;
7968             end;
7969          end Ident;
7970
7971          --------------------------
7972          -- Implemented_By_Entry --
7973          --------------------------
7974
7975          --  pragma Implemented_By_Entry (DIRECT_NAME);
7976
7977          when Pragma_Implemented_By_Entry => Implemented_By_Entry : declare
7978             Ent : Entity_Id;
7979
7980          begin
7981             Ada_2005_Pragma;
7982             Check_Arg_Count (1);
7983             Check_No_Identifiers;
7984             Check_Arg_Is_Identifier (Arg1);
7985             Check_Arg_Is_Local_Name (Arg1);
7986             Ent := Entity (Expression (Arg1));
7987
7988             --  Pragma Implemented_By_Entry must be applied only to protected
7989             --  synchronized or task interface primitives.
7990
7991             if (Ekind (Ent) /= E_Function
7992                   and then Ekind (Ent) /= E_Procedure)
7993                or else not Present (First_Formal (Ent))
7994                or else not Is_Concurrent_Interface (Etype (First_Formal (Ent)))
7995             then
7996                Error_Pragma_Arg
7997                  ("pragma % must be applied to a concurrent interface " &
7998                   "primitive", Arg1);
7999
8000             else
8001                if Einfo.Implemented_By_Entry (Ent)
8002                  and then Warn_On_Redundant_Constructs
8003                then
8004                   Error_Pragma ("?duplicate pragma%!");
8005                else
8006                   Set_Implemented_By_Entry (Ent);
8007                end if;
8008             end if;
8009          end Implemented_By_Entry;
8010
8011          -----------------------
8012          -- Implicit_Packing --
8013          -----------------------
8014
8015          --  pragma Implicit_Packing;
8016
8017          when Pragma_Implicit_Packing =>
8018             GNAT_Pragma;
8019             Check_Arg_Count (0);
8020             Implicit_Packing := True;
8021
8022          ------------
8023          -- Import --
8024          ------------
8025
8026          --  pragma Import (
8027          --       [Convention    =>] convention_IDENTIFIER,
8028          --       [Entity        =>] local_NAME
8029          --    [, [External_Name =>] static_string_EXPRESSION ]
8030          --    [, [Link_Name     =>] static_string_EXPRESSION ]);
8031
8032          when Pragma_Import =>
8033             Check_Ada_83_Warning;
8034             Check_Arg_Order
8035               ((Name_Convention,
8036                 Name_Entity,
8037                 Name_External_Name,
8038                 Name_Link_Name));
8039             Check_At_Least_N_Arguments (2);
8040             Check_At_Most_N_Arguments  (4);
8041             Process_Import_Or_Interface;
8042
8043          ----------------------
8044          -- Import_Exception --
8045          ----------------------
8046
8047          --  pragma Import_Exception (
8048          --        [Internal         =>] LOCAL_NAME
8049          --     [, [External         =>] EXTERNAL_SYMBOL]
8050          --     [, [Form     =>] Ada | VMS]
8051          --     [, [Code     =>] static_integer_EXPRESSION]);
8052
8053          when Pragma_Import_Exception => Import_Exception : declare
8054             Args  : Args_List (1 .. 4);
8055             Names : constant Name_List (1 .. 4) := (
8056                       Name_Internal,
8057                       Name_External,
8058                       Name_Form,
8059                       Name_Code);
8060
8061             Internal : Node_Id renames Args (1);
8062             External : Node_Id renames Args (2);
8063             Form     : Node_Id renames Args (3);
8064             Code     : Node_Id renames Args (4);
8065
8066          begin
8067             GNAT_Pragma;
8068             Gather_Associations (Names, Args);
8069
8070             if Present (External) and then Present (Code) then
8071                Error_Pragma
8072                  ("cannot give both External and Code options for pragma%");
8073             end if;
8074
8075             Process_Extended_Import_Export_Exception_Pragma (
8076               Arg_Internal => Internal,
8077               Arg_External => External,
8078               Arg_Form     => Form,
8079               Arg_Code     => Code);
8080
8081             if not Is_VMS_Exception (Entity (Internal)) then
8082                Set_Imported (Entity (Internal));
8083             end if;
8084          end Import_Exception;
8085
8086          ---------------------
8087          -- Import_Function --
8088          ---------------------
8089
8090          --  pragma Import_Function (
8091          --        [Internal                 =>] LOCAL_NAME,
8092          --     [, [External                 =>] EXTERNAL_SYMBOL]
8093          --     [, [Parameter_Types          =>] (PARAMETER_TYPES)]
8094          --     [, [Result_Type              =>] SUBTYPE_MARK]
8095          --     [, [Mechanism                =>] MECHANISM]
8096          --     [, [Result_Mechanism         =>] MECHANISM_NAME]
8097          --     [, [First_Optional_Parameter =>] IDENTIFIER]);
8098
8099          --  EXTERNAL_SYMBOL ::=
8100          --    IDENTIFIER
8101          --  | static_string_EXPRESSION
8102
8103          --  PARAMETER_TYPES ::=
8104          --    null
8105          --  | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
8106
8107          --  TYPE_DESIGNATOR ::=
8108          --    subtype_NAME
8109          --  | subtype_Name ' Access
8110
8111          --  MECHANISM ::=
8112          --    MECHANISM_NAME
8113          --  | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
8114
8115          --  MECHANISM_ASSOCIATION ::=
8116          --    [formal_parameter_NAME =>] MECHANISM_NAME
8117
8118          --  MECHANISM_NAME ::=
8119          --    Value
8120          --  | Reference
8121          --  | Descriptor [([Class =>] CLASS_NAME)]
8122
8123          --  CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
8124
8125          when Pragma_Import_Function => Import_Function : declare
8126             Args  : Args_List (1 .. 7);
8127             Names : constant Name_List (1 .. 7) := (
8128                       Name_Internal,
8129                       Name_External,
8130                       Name_Parameter_Types,
8131                       Name_Result_Type,
8132                       Name_Mechanism,
8133                       Name_Result_Mechanism,
8134                       Name_First_Optional_Parameter);
8135
8136             Internal                 : Node_Id renames Args (1);
8137             External                 : Node_Id renames Args (2);
8138             Parameter_Types          : Node_Id renames Args (3);
8139             Result_Type              : Node_Id renames Args (4);
8140             Mechanism                : Node_Id renames Args (5);
8141             Result_Mechanism         : Node_Id renames Args (6);
8142             First_Optional_Parameter : Node_Id renames Args (7);
8143
8144          begin
8145             GNAT_Pragma;
8146             Gather_Associations (Names, Args);
8147             Process_Extended_Import_Export_Subprogram_Pragma (
8148               Arg_Internal                 => Internal,
8149               Arg_External                 => External,
8150               Arg_Parameter_Types          => Parameter_Types,
8151               Arg_Result_Type              => Result_Type,
8152               Arg_Mechanism                => Mechanism,
8153               Arg_Result_Mechanism         => Result_Mechanism,
8154               Arg_First_Optional_Parameter => First_Optional_Parameter);
8155          end Import_Function;
8156
8157          -------------------
8158          -- Import_Object --
8159          -------------------
8160
8161          --  pragma Import_Object (
8162          --        [Internal =>] LOCAL_NAME
8163          --     [, [External =>] EXTERNAL_SYMBOL]
8164          --     [, [Size     =>] EXTERNAL_SYMBOL]);
8165
8166          --  EXTERNAL_SYMBOL ::=
8167          --    IDENTIFIER
8168          --  | static_string_EXPRESSION
8169
8170          when Pragma_Import_Object => Import_Object : declare
8171             Args  : Args_List (1 .. 3);
8172             Names : constant Name_List (1 .. 3) := (
8173                       Name_Internal,
8174                       Name_External,
8175                       Name_Size);
8176
8177             Internal : Node_Id renames Args (1);
8178             External : Node_Id renames Args (2);
8179             Size     : Node_Id renames Args (3);
8180
8181          begin
8182             GNAT_Pragma;
8183             Gather_Associations (Names, Args);
8184             Process_Extended_Import_Export_Object_Pragma (
8185               Arg_Internal => Internal,
8186               Arg_External => External,
8187               Arg_Size     => Size);
8188          end Import_Object;
8189
8190          ----------------------
8191          -- Import_Procedure --
8192          ----------------------
8193
8194          --  pragma Import_Procedure (
8195          --        [Internal                 =>] LOCAL_NAME
8196          --     [, [External                 =>] EXTERNAL_SYMBOL]
8197          --     [, [Parameter_Types          =>] (PARAMETER_TYPES)]
8198          --     [, [Mechanism                =>] MECHANISM]
8199          --     [, [First_Optional_Parameter =>] IDENTIFIER]);
8200
8201          --  EXTERNAL_SYMBOL ::=
8202          --    IDENTIFIER
8203          --  | static_string_EXPRESSION
8204
8205          --  PARAMETER_TYPES ::=
8206          --    null
8207          --  | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
8208
8209          --  TYPE_DESIGNATOR ::=
8210          --    subtype_NAME
8211          --  | subtype_Name ' Access
8212
8213          --  MECHANISM ::=
8214          --    MECHANISM_NAME
8215          --  | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
8216
8217          --  MECHANISM_ASSOCIATION ::=
8218          --    [formal_parameter_NAME =>] MECHANISM_NAME
8219
8220          --  MECHANISM_NAME ::=
8221          --    Value
8222          --  | Reference
8223          --  | Descriptor [([Class =>] CLASS_NAME)]
8224
8225          --  CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
8226
8227          when Pragma_Import_Procedure => Import_Procedure : declare
8228             Args  : Args_List (1 .. 5);
8229             Names : constant Name_List (1 .. 5) := (
8230                       Name_Internal,
8231                       Name_External,
8232                       Name_Parameter_Types,
8233                       Name_Mechanism,
8234                       Name_First_Optional_Parameter);
8235
8236             Internal                 : Node_Id renames Args (1);
8237             External                 : Node_Id renames Args (2);
8238             Parameter_Types          : Node_Id renames Args (3);
8239             Mechanism                : Node_Id renames Args (4);
8240             First_Optional_Parameter : Node_Id renames Args (5);
8241
8242          begin
8243             GNAT_Pragma;
8244             Gather_Associations (Names, Args);
8245             Process_Extended_Import_Export_Subprogram_Pragma (
8246               Arg_Internal                 => Internal,
8247               Arg_External                 => External,
8248               Arg_Parameter_Types          => Parameter_Types,
8249               Arg_Mechanism                => Mechanism,
8250               Arg_First_Optional_Parameter => First_Optional_Parameter);
8251          end Import_Procedure;
8252
8253          -----------------------------
8254          -- Import_Valued_Procedure --
8255          -----------------------------
8256
8257          --  pragma Import_Valued_Procedure (
8258          --        [Internal                 =>] LOCAL_NAME
8259          --     [, [External                 =>] EXTERNAL_SYMBOL]
8260          --     [, [Parameter_Types          =>] (PARAMETER_TYPES)]
8261          --     [, [Mechanism                =>] MECHANISM]
8262          --     [, [First_Optional_Parameter =>] IDENTIFIER]);
8263
8264          --  EXTERNAL_SYMBOL ::=
8265          --    IDENTIFIER
8266          --  | static_string_EXPRESSION
8267
8268          --  PARAMETER_TYPES ::=
8269          --    null
8270          --  | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
8271
8272          --  TYPE_DESIGNATOR ::=
8273          --    subtype_NAME
8274          --  | subtype_Name ' Access
8275
8276          --  MECHANISM ::=
8277          --    MECHANISM_NAME
8278          --  | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
8279
8280          --  MECHANISM_ASSOCIATION ::=
8281          --    [formal_parameter_NAME =>] MECHANISM_NAME
8282
8283          --  MECHANISM_NAME ::=
8284          --    Value
8285          --  | Reference
8286          --  | Descriptor [([Class =>] CLASS_NAME)]
8287
8288          --  CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
8289
8290          when Pragma_Import_Valued_Procedure =>
8291          Import_Valued_Procedure : declare
8292             Args  : Args_List (1 .. 5);
8293             Names : constant Name_List (1 .. 5) := (
8294                       Name_Internal,
8295                       Name_External,
8296                       Name_Parameter_Types,
8297                       Name_Mechanism,
8298                       Name_First_Optional_Parameter);
8299
8300             Internal                 : Node_Id renames Args (1);
8301             External                 : Node_Id renames Args (2);
8302             Parameter_Types          : Node_Id renames Args (3);
8303             Mechanism                : Node_Id renames Args (4);
8304             First_Optional_Parameter : Node_Id renames Args (5);
8305
8306          begin
8307             GNAT_Pragma;
8308             Gather_Associations (Names, Args);
8309             Process_Extended_Import_Export_Subprogram_Pragma (
8310               Arg_Internal                 => Internal,
8311               Arg_External                 => External,
8312               Arg_Parameter_Types          => Parameter_Types,
8313               Arg_Mechanism                => Mechanism,
8314               Arg_First_Optional_Parameter => First_Optional_Parameter);
8315          end Import_Valued_Procedure;
8316
8317          ------------------------
8318          -- Initialize_Scalars --
8319          ------------------------
8320
8321          --  pragma Initialize_Scalars;
8322
8323          when Pragma_Initialize_Scalars =>
8324             GNAT_Pragma;
8325             Check_Arg_Count (0);
8326             Check_Valid_Configuration_Pragma;
8327             Check_Restriction (No_Initialize_Scalars, N);
8328
8329             --  Initialize_Scalars creates false positives in CodePeer,
8330             --  so ignore this pragma in this mode.
8331
8332             if not Restriction_Active (No_Initialize_Scalars)
8333               and then not CodePeer_Mode
8334             then
8335                Init_Or_Norm_Scalars := True;
8336                Initialize_Scalars := True;
8337             end if;
8338
8339          ------------
8340          -- Inline --
8341          ------------
8342
8343          --  pragma Inline ( NAME {, NAME} );
8344
8345          when Pragma_Inline =>
8346
8347             --  Pragma is active if inlining option is active
8348
8349             Process_Inline (Inline_Active);
8350
8351          -------------------
8352          -- Inline_Always --
8353          -------------------
8354
8355          --  pragma Inline_Always ( NAME {, NAME} );
8356
8357          when Pragma_Inline_Always =>
8358             GNAT_Pragma;
8359
8360             --  Pragma always active unless in CodePeer mode, since this causes
8361             --  walk order issues.
8362
8363             if not CodePeer_Mode then
8364                Process_Inline (True);
8365             end if;
8366
8367          --------------------
8368          -- Inline_Generic --
8369          --------------------
8370
8371          --  pragma Inline_Generic (NAME {, NAME});
8372
8373          when Pragma_Inline_Generic =>
8374             GNAT_Pragma;
8375             Process_Generic_List;
8376
8377          ----------------------
8378          -- Inspection_Point --
8379          ----------------------
8380
8381          --  pragma Inspection_Point [(object_NAME {, object_NAME})];
8382
8383          when Pragma_Inspection_Point => Inspection_Point : declare
8384             Arg : Node_Id;
8385             Exp : Node_Id;
8386
8387          begin
8388             if Arg_Count > 0 then
8389                Arg := Arg1;
8390                loop
8391                   Exp := Expression (Arg);
8392                   Analyze (Exp);
8393
8394                   if not Is_Entity_Name (Exp)
8395                     or else not Is_Object (Entity (Exp))
8396                   then
8397                      Error_Pragma_Arg ("object name required", Arg);
8398                   end if;
8399
8400                   Next (Arg);
8401                   exit when No (Arg);
8402                end loop;
8403             end if;
8404          end Inspection_Point;
8405
8406          ---------------
8407          -- Interface --
8408          ---------------
8409
8410          --  pragma Interface (
8411          --    [   Convention    =>] convention_IDENTIFIER,
8412          --    [   Entity        =>] local_NAME
8413          --    [, [External_Name =>] static_string_EXPRESSION ]
8414          --    [, [Link_Name     =>] static_string_EXPRESSION ]);
8415
8416          when Pragma_Interface =>
8417             GNAT_Pragma;
8418             Check_Arg_Order
8419               ((Name_Convention,
8420                 Name_Entity,
8421                 Name_External_Name,
8422                 Name_Link_Name));
8423             Check_At_Least_N_Arguments (2);
8424             Check_At_Most_N_Arguments  (4);
8425             Process_Import_Or_Interface;
8426
8427             --  In Ada 2005, the permission to use Interface (a reserved word)
8428             --  as a pragma name is considered an obsolescent feature.
8429
8430             if Ada_Version >= Ada_2005 then
8431                Check_Restriction
8432                  (No_Obsolescent_Features, Pragma_Identifier (N));
8433             end if;
8434
8435          --------------------
8436          -- Interface_Name --
8437          --------------------
8438
8439          --  pragma Interface_Name (
8440          --    [  Entity        =>] local_NAME
8441          --    [,[External_Name =>] static_string_EXPRESSION ]
8442          --    [,[Link_Name     =>] static_string_EXPRESSION ]);
8443
8444          when Pragma_Interface_Name => Interface_Name : declare
8445             Id     : Node_Id;
8446             Def_Id : Entity_Id;
8447             Hom_Id : Entity_Id;
8448             Found  : Boolean;
8449
8450          begin
8451             GNAT_Pragma;
8452             Check_Arg_Order
8453               ((Name_Entity, Name_External_Name, Name_Link_Name));
8454             Check_At_Least_N_Arguments (2);
8455             Check_At_Most_N_Arguments  (3);
8456             Id := Expression (Arg1);
8457             Analyze (Id);
8458
8459             if not Is_Entity_Name (Id) then
8460                Error_Pragma_Arg
8461                  ("first argument for pragma% must be entity name", Arg1);
8462             elsif Etype (Id) = Any_Type then
8463                return;
8464             else
8465                Def_Id := Entity (Id);
8466             end if;
8467
8468             --  Special DEC-compatible processing for the object case, forces
8469             --  object to be imported.
8470
8471             if Ekind (Def_Id) = E_Variable then
8472                Kill_Size_Check_Code (Def_Id);
8473                Note_Possible_Modification (Id, Sure => False);
8474
8475                --  Initialization is not allowed for imported variable
8476
8477                if Present (Expression (Parent (Def_Id)))
8478                  and then Comes_From_Source (Expression (Parent (Def_Id)))
8479                then
8480                   Error_Msg_Sloc := Sloc (Def_Id);
8481                   Error_Pragma_Arg
8482                     ("no initialization allowed for declaration of& #",
8483                      Arg2);
8484
8485                else
8486                   --  For compatibility, support VADS usage of providing both
8487                   --  pragmas Interface and Interface_Name to obtain the effect
8488                   --  of a single Import pragma.
8489
8490                   if Is_Imported (Def_Id)
8491                     and then Present (First_Rep_Item (Def_Id))
8492                     and then Nkind (First_Rep_Item (Def_Id)) = N_Pragma
8493                     and then
8494                       Pragma_Name (First_Rep_Item (Def_Id)) = Name_Interface
8495                   then
8496                      null;
8497                   else
8498                      Set_Imported (Def_Id);
8499                   end if;
8500
8501                   Set_Is_Public (Def_Id);
8502                   Process_Interface_Name (Def_Id, Arg2, Arg3);
8503                end if;
8504
8505             --  Otherwise must be subprogram
8506
8507             elsif not Is_Subprogram (Def_Id) then
8508                Error_Pragma_Arg
8509                  ("argument of pragma% is not subprogram", Arg1);
8510
8511             else
8512                Check_At_Most_N_Arguments (3);
8513                Hom_Id := Def_Id;
8514                Found := False;
8515
8516                --  Loop through homonyms
8517
8518                loop
8519                   Def_Id := Get_Base_Subprogram (Hom_Id);
8520
8521                   if Is_Imported (Def_Id) then
8522                      Process_Interface_Name (Def_Id, Arg2, Arg3);
8523                      Found := True;
8524                   end if;
8525
8526                   Hom_Id := Homonym (Hom_Id);
8527
8528                   exit when No (Hom_Id)
8529                     or else Scope (Hom_Id) /= Current_Scope;
8530                end loop;
8531
8532                if not Found then
8533                   Error_Pragma_Arg
8534                     ("argument of pragma% is not imported subprogram",
8535                      Arg1);
8536                end if;
8537             end if;
8538          end Interface_Name;
8539
8540          -----------------------
8541          -- Interrupt_Handler --
8542          -----------------------
8543
8544          --  pragma Interrupt_Handler (handler_NAME);
8545
8546          when Pragma_Interrupt_Handler =>
8547             Check_Ada_83_Warning;
8548             Check_Arg_Count (1);
8549             Check_No_Identifiers;
8550
8551             if No_Run_Time_Mode then
8552                Error_Msg_CRT ("Interrupt_Handler pragma", N);
8553             else
8554                Check_Interrupt_Or_Attach_Handler;
8555                Process_Interrupt_Or_Attach_Handler;
8556             end if;
8557
8558          ------------------------
8559          -- Interrupt_Priority --
8560          ------------------------
8561
8562          --  pragma Interrupt_Priority [(EXPRESSION)];
8563
8564          when Pragma_Interrupt_Priority => Interrupt_Priority : declare
8565             P   : constant Node_Id := Parent (N);
8566             Arg : Node_Id;
8567
8568          begin
8569             Check_Ada_83_Warning;
8570
8571             if Arg_Count /= 0 then
8572                Arg := Expression (Arg1);
8573                Check_Arg_Count (1);
8574                Check_No_Identifiers;
8575
8576                --  The expression must be analyzed in the special manner
8577                --  described in "Handling of Default and Per-Object
8578                --  Expressions" in sem.ads.
8579
8580                Preanalyze_Spec_Expression (Arg, RTE (RE_Interrupt_Priority));
8581             end if;
8582
8583             if not Nkind_In (P, N_Task_Definition, N_Protected_Definition) then
8584                Pragma_Misplaced;
8585                return;
8586
8587             elsif Has_Priority_Pragma (P) then
8588                Error_Pragma ("duplicate pragma% not allowed");
8589
8590             else
8591                Set_Has_Priority_Pragma (P, True);
8592                Record_Rep_Item (Defining_Identifier (Parent (P)), N);
8593             end if;
8594          end Interrupt_Priority;
8595
8596          ---------------------
8597          -- Interrupt_State --
8598          ---------------------
8599
8600          --  pragma Interrupt_State (
8601          --    [Name  =>] INTERRUPT_ID,
8602          --    [State =>] INTERRUPT_STATE);
8603
8604          --  INTERRUPT_ID => IDENTIFIER | static_integer_EXPRESSION
8605          --  INTERRUPT_STATE => System | Runtime | User
8606
8607          --  Note: if the interrupt id is given as an identifier, then it must
8608          --  be one of the identifiers in Ada.Interrupts.Names. Otherwise it is
8609          --  given as a static integer expression which must be in the range of
8610          --  Ada.Interrupts.Interrupt_ID.
8611
8612          when Pragma_Interrupt_State => Interrupt_State : declare
8613
8614             Int_Id : constant Entity_Id := RTE (RE_Interrupt_ID);
8615             --  This is the entity Ada.Interrupts.Interrupt_ID;
8616
8617             State_Type : Character;
8618             --  Set to 's'/'r'/'u' for System/Runtime/User
8619
8620             IST_Num : Pos;
8621             --  Index to entry in Interrupt_States table
8622
8623             Int_Val : Uint;
8624             --  Value of interrupt
8625
8626             Arg1X : constant Node_Id := Get_Pragma_Arg (Arg1);
8627             --  The first argument to the pragma
8628
8629             Int_Ent : Entity_Id;
8630             --  Interrupt entity in Ada.Interrupts.Names
8631
8632          begin
8633             GNAT_Pragma;
8634             Check_Arg_Order ((Name_Name, Name_State));
8635             Check_Arg_Count (2);
8636
8637             Check_Optional_Identifier (Arg1, Name_Name);
8638             Check_Optional_Identifier (Arg2, Name_State);
8639             Check_Arg_Is_Identifier (Arg2);
8640
8641             --  First argument is identifier
8642
8643             if Nkind (Arg1X) = N_Identifier then
8644
8645                --  Search list of names in Ada.Interrupts.Names
8646
8647                Int_Ent := First_Entity (RTE (RE_Names));
8648                loop
8649                   if No (Int_Ent) then
8650                      Error_Pragma_Arg ("invalid interrupt name", Arg1);
8651
8652                   elsif Chars (Int_Ent) = Chars (Arg1X) then
8653                      Int_Val := Expr_Value (Constant_Value (Int_Ent));
8654                      exit;
8655                   end if;
8656
8657                   Next_Entity (Int_Ent);
8658                end loop;
8659
8660             --  First argument is not an identifier, so it must be a static
8661             --  expression of type Ada.Interrupts.Interrupt_ID.
8662
8663             else
8664                Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
8665                Int_Val := Expr_Value (Arg1X);
8666
8667                if Int_Val < Expr_Value (Type_Low_Bound (Int_Id))
8668                     or else
8669                   Int_Val > Expr_Value (Type_High_Bound (Int_Id))
8670                then
8671                   Error_Pragma_Arg
8672                     ("value not in range of type " &
8673                      """Ada.Interrupts.Interrupt_'I'D""", Arg1);
8674                end if;
8675             end if;
8676
8677             --  Check OK state
8678
8679             case Chars (Get_Pragma_Arg (Arg2)) is
8680                when Name_Runtime => State_Type := 'r';
8681                when Name_System  => State_Type := 's';
8682                when Name_User    => State_Type := 'u';
8683
8684                when others =>
8685                   Error_Pragma_Arg ("invalid interrupt state", Arg2);
8686             end case;
8687
8688             --  Check if entry is already stored
8689
8690             IST_Num := Interrupt_States.First;
8691             loop
8692                --  If entry not found, add it
8693
8694                if IST_Num > Interrupt_States.Last then
8695                   Interrupt_States.Append
8696                     ((Interrupt_Number => UI_To_Int (Int_Val),
8697                       Interrupt_State  => State_Type,
8698                       Pragma_Loc       => Loc));
8699                   exit;
8700
8701                --  Case of entry for the same entry
8702
8703                elsif Int_Val = Interrupt_States.Table (IST_Num).
8704                                                            Interrupt_Number
8705                then
8706                   --  If state matches, done, no need to make redundant entry
8707
8708                   exit when
8709                     State_Type = Interrupt_States.Table (IST_Num).
8710                                                            Interrupt_State;
8711
8712                   --  Otherwise if state does not match, error
8713
8714                   Error_Msg_Sloc :=
8715                     Interrupt_States.Table (IST_Num).Pragma_Loc;
8716                   Error_Pragma_Arg
8717                     ("state conflicts with that given #", Arg2);
8718                   exit;
8719                end if;
8720
8721                IST_Num := IST_Num + 1;
8722             end loop;
8723          end Interrupt_State;
8724
8725          ----------------------
8726          -- Java_Constructor --
8727          ----------------------
8728
8729          --  pragma Java_Constructor ([Entity =>] LOCAL_NAME);
8730
8731          --  Also handles pragma CIL_Constructor
8732
8733          when Pragma_CIL_Constructor | Pragma_Java_Constructor =>
8734          Java_Constructor : declare
8735             Id         : Entity_Id;
8736             Def_Id     : Entity_Id;
8737             Hom_Id     : Entity_Id;
8738             Convention : Convention_Id;
8739
8740          begin
8741             GNAT_Pragma;
8742             Check_Arg_Count (1);
8743             Check_Optional_Identifier (Arg1, Name_Entity);
8744             Check_Arg_Is_Local_Name (Arg1);
8745
8746             Id := Expression (Arg1);
8747             Find_Program_Unit_Name (Id);
8748
8749             --  If we did not find the name, we are done
8750
8751             if Etype (Id) = Any_Type then
8752                return;
8753             end if;
8754
8755             case Prag_Id is
8756                when Pragma_CIL_Constructor  => Convention := Convention_CIL;
8757                when Pragma_Java_Constructor => Convention := Convention_Java;
8758                when others                  => null;
8759             end case;
8760
8761             Hom_Id := Entity (Id);
8762
8763             --  Loop through homonyms
8764
8765             loop
8766                Def_Id := Get_Base_Subprogram (Hom_Id);
8767
8768                --  The constructor is required to be a function returning an
8769                --  access type whose designated type has convention Java/CIL.
8770
8771                if Ekind (Def_Id) = E_Function
8772                  and then
8773                    (Is_Value_Type (Etype (Def_Id))
8774                      or else
8775                        (Ekind (Etype (Def_Id)) = E_Access_Subprogram_Type
8776                          and then
8777                           Atree.Convention (Etype (Def_Id)) = Convention)
8778                      or else
8779                        (Ekind (Etype (Def_Id)) in Access_Kind
8780                          and then
8781                           (Atree.Convention
8782                              (Designated_Type (Etype (Def_Id))) = Convention
8783                             or else
8784                               Atree.Convention
8785                                (Root_Type (Designated_Type (Etype (Def_Id)))) =
8786                                                                  Convention)))
8787                then
8788                   Set_Is_Constructor (Def_Id);
8789                   Set_Convention     (Def_Id, Convention);
8790                   Set_Is_Imported    (Def_Id);
8791
8792                else
8793                   if Convention = Convention_Java then
8794                      Error_Pragma_Arg
8795                        ("pragma% requires function returning a " &
8796                         "'Java access type", Arg1);
8797                   else
8798                      pragma Assert (Convention = Convention_CIL);
8799                      Error_Pragma_Arg
8800                        ("pragma% requires function returning a " &
8801                         "'C'I'L access type", Arg1);
8802                   end if;
8803                end if;
8804
8805                Hom_Id := Homonym (Hom_Id);
8806
8807                exit when No (Hom_Id) or else Scope (Hom_Id) /= Current_Scope;
8808             end loop;
8809          end Java_Constructor;
8810
8811          ----------------------
8812          -- Java_Interface --
8813          ----------------------
8814
8815          --  pragma Java_Interface ([Entity =>] LOCAL_NAME);
8816
8817          when Pragma_Java_Interface => Java_Interface : declare
8818             Arg : Node_Id;
8819             Typ : Entity_Id;
8820
8821          begin
8822             GNAT_Pragma;
8823             Check_Arg_Count (1);
8824             Check_Optional_Identifier (Arg1, Name_Entity);
8825             Check_Arg_Is_Local_Name (Arg1);
8826
8827             Arg := Expression (Arg1);
8828             Analyze (Arg);
8829
8830             if Etype (Arg) = Any_Type then
8831                return;
8832             end if;
8833
8834             if not Is_Entity_Name (Arg)
8835               or else not Is_Type (Entity (Arg))
8836             then
8837                Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
8838             end if;
8839
8840             Typ := Underlying_Type (Entity (Arg));
8841
8842             --  For now simply check some of the semantic constraints on the
8843             --  type. This currently leaves out some restrictions on interface
8844             --  types, namely that the parent type must be java.lang.Object.Typ
8845             --  and that all primitives of the type should be declared
8846             --  abstract. ???
8847
8848             if not Is_Tagged_Type (Typ) or else not Is_Abstract_Type (Typ) then
8849                Error_Pragma_Arg ("pragma% requires an abstract "
8850                  & "tagged type", Arg1);
8851
8852             elsif not Has_Discriminants (Typ)
8853               or else Ekind (Etype (First_Discriminant (Typ)))
8854                         /= E_Anonymous_Access_Type
8855               or else
8856                 not Is_Class_Wide_Type
8857                       (Designated_Type (Etype (First_Discriminant (Typ))))
8858             then
8859                Error_Pragma_Arg
8860                  ("type must have a class-wide access discriminant", Arg1);
8861             end if;
8862          end Java_Interface;
8863
8864          ----------------
8865          -- Keep_Names --
8866          ----------------
8867
8868          --  pragma Keep_Names ([On => ] local_NAME);
8869
8870          when Pragma_Keep_Names => Keep_Names : declare
8871             Arg : Node_Id;
8872
8873          begin
8874             GNAT_Pragma;
8875             Check_Arg_Count (1);
8876             Check_Optional_Identifier (Arg1, Name_On);
8877             Check_Arg_Is_Local_Name (Arg1);
8878
8879             Arg := Expression (Arg1);
8880             Analyze (Arg);
8881
8882             if Etype (Arg) = Any_Type then
8883                return;
8884             end if;
8885
8886             if not Is_Entity_Name (Arg)
8887               or else Ekind (Entity (Arg)) /= E_Enumeration_Type
8888             then
8889                Error_Pragma_Arg
8890                  ("pragma% requires a local enumeration type", Arg1);
8891             end if;
8892
8893             Set_Discard_Names (Entity (Arg), False);
8894          end Keep_Names;
8895
8896          -------------
8897          -- License --
8898          -------------
8899
8900          --  pragma License (RESTRICTED | UNRESTRICTED | GPL | MODIFIED_GPL);
8901
8902          when Pragma_License =>
8903             GNAT_Pragma;
8904             Check_Arg_Count (1);
8905             Check_No_Identifiers;
8906             Check_Valid_Configuration_Pragma;
8907             Check_Arg_Is_Identifier (Arg1);
8908
8909             declare
8910                Sind : constant Source_File_Index :=
8911                         Source_Index (Current_Sem_Unit);
8912
8913             begin
8914                case Chars (Get_Pragma_Arg (Arg1)) is
8915                   when Name_GPL =>
8916                      Set_License (Sind, GPL);
8917
8918                   when Name_Modified_GPL =>
8919                      Set_License (Sind, Modified_GPL);
8920
8921                   when Name_Restricted =>
8922                      Set_License (Sind, Restricted);
8923
8924                   when Name_Unrestricted =>
8925                      Set_License (Sind, Unrestricted);
8926
8927                   when others =>
8928                      Error_Pragma_Arg ("invalid license name", Arg1);
8929                end case;
8930             end;
8931
8932          ---------------
8933          -- Link_With --
8934          ---------------
8935
8936          --  pragma Link_With (string_EXPRESSION {, string_EXPRESSION});
8937
8938          when Pragma_Link_With => Link_With : declare
8939             Arg : Node_Id;
8940
8941          begin
8942             GNAT_Pragma;
8943
8944             if Operating_Mode = Generate_Code
8945               and then In_Extended_Main_Source_Unit (N)
8946             then
8947                Check_At_Least_N_Arguments (1);
8948                Check_No_Identifiers;
8949                Check_Is_In_Decl_Part_Or_Package_Spec;
8950                Check_Arg_Is_Static_Expression (Arg1, Standard_String);
8951                Start_String;
8952
8953                Arg := Arg1;
8954                while Present (Arg) loop
8955                   Check_Arg_Is_Static_Expression (Arg, Standard_String);
8956
8957                   --  Store argument, converting sequences of spaces to a
8958                   --  single null character (this is one of the differences
8959                   --  in processing between Link_With and Linker_Options).
8960
8961                   Arg_Store : declare
8962                      C : constant Char_Code := Get_Char_Code (' ');
8963                      S : constant String_Id :=
8964                            Strval (Expr_Value_S (Expression (Arg)));
8965                      L : constant Nat := String_Length (S);
8966                      F : Nat := 1;
8967
8968                      procedure Skip_Spaces;
8969                      --  Advance F past any spaces
8970
8971                      -----------------
8972                      -- Skip_Spaces --
8973                      -----------------
8974
8975                      procedure Skip_Spaces is
8976                      begin
8977                         while F <= L and then Get_String_Char (S, F) = C loop
8978                            F := F + 1;
8979                         end loop;
8980                      end Skip_Spaces;
8981
8982                   --  Start of processing for Arg_Store
8983
8984                   begin
8985                      Skip_Spaces; -- skip leading spaces
8986
8987                      --  Loop through characters, changing any embedded
8988                      --  sequence of spaces to a single null character (this
8989                      --  is how Link_With/Linker_Options differ)
8990
8991                      while F <= L loop
8992                         if Get_String_Char (S, F) = C then
8993                            Skip_Spaces;
8994                            exit when F > L;
8995                            Store_String_Char (ASCII.NUL);
8996
8997                         else
8998                            Store_String_Char (Get_String_Char (S, F));
8999                            F := F + 1;
9000                         end if;
9001                      end loop;
9002                   end Arg_Store;
9003
9004                   Arg := Next (Arg);
9005
9006                   if Present (Arg) then
9007                      Store_String_Char (ASCII.NUL);
9008                   end if;
9009                end loop;
9010
9011                Store_Linker_Option_String (End_String);
9012             end if;
9013          end Link_With;
9014
9015          ------------------
9016          -- Linker_Alias --
9017          ------------------
9018
9019          --  pragma Linker_Alias (
9020          --      [Entity =>]  LOCAL_NAME
9021          --      [Target =>]  static_string_EXPRESSION);
9022
9023          when Pragma_Linker_Alias =>
9024             GNAT_Pragma;
9025             Check_Arg_Order ((Name_Entity, Name_Target));
9026             Check_Arg_Count (2);
9027             Check_Optional_Identifier (Arg1, Name_Entity);
9028             Check_Optional_Identifier (Arg2, Name_Target);
9029             Check_Arg_Is_Library_Level_Local_Name (Arg1);
9030             Check_Arg_Is_Static_Expression (Arg2, Standard_String);
9031
9032             --  The only processing required is to link this item on to the
9033             --  list of rep items for the given entity. This is accomplished
9034             --  by the call to Rep_Item_Too_Late (when no error is detected
9035             --  and False is returned).
9036
9037             if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
9038                return;
9039             else
9040                Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
9041             end if;
9042
9043          ------------------------
9044          -- Linker_Constructor --
9045          ------------------------
9046
9047          --  pragma Linker_Constructor (procedure_LOCAL_NAME);
9048
9049          --  Code is shared with Linker_Destructor
9050
9051          -----------------------
9052          -- Linker_Destructor --
9053          -----------------------
9054
9055          --  pragma Linker_Destructor (procedure_LOCAL_NAME);
9056
9057          when Pragma_Linker_Constructor |
9058               Pragma_Linker_Destructor =>
9059          Linker_Constructor : declare
9060             Arg1_X : Node_Id;
9061             Proc   : Entity_Id;
9062
9063          begin
9064             GNAT_Pragma;
9065             Check_Arg_Count (1);
9066             Check_No_Identifiers;
9067             Check_Arg_Is_Local_Name (Arg1);
9068             Arg1_X := Expression (Arg1);
9069             Analyze (Arg1_X);
9070             Proc := Find_Unique_Parameterless_Procedure (Arg1_X, Arg1);
9071
9072             if not Is_Library_Level_Entity (Proc) then
9073                Error_Pragma_Arg
9074                 ("argument for pragma% must be library level entity", Arg1);
9075             end if;
9076
9077             --  The only processing required is to link this item on to the
9078             --  list of rep items for the given entity. This is accomplished
9079             --  by the call to Rep_Item_Too_Late (when no error is detected
9080             --  and False is returned).
9081
9082             if Rep_Item_Too_Late (Proc, N) then
9083                return;
9084             else
9085                Set_Has_Gigi_Rep_Item (Proc);
9086             end if;
9087          end Linker_Constructor;
9088
9089          --------------------
9090          -- Linker_Options --
9091          --------------------
9092
9093          --  pragma Linker_Options (string_EXPRESSION {, string_EXPRESSION});
9094
9095          when Pragma_Linker_Options => Linker_Options : declare
9096             Arg : Node_Id;
9097
9098          begin
9099             Check_Ada_83_Warning;
9100             Check_No_Identifiers;
9101             Check_Arg_Count (1);
9102             Check_Is_In_Decl_Part_Or_Package_Spec;
9103             Check_Arg_Is_Static_Expression (Arg1, Standard_String);
9104             Start_String (Strval (Expr_Value_S (Expression (Arg1))));
9105
9106             Arg := Arg2;
9107             while Present (Arg) loop
9108                Check_Arg_Is_Static_Expression (Arg, Standard_String);
9109                Store_String_Char (ASCII.NUL);
9110                Store_String_Chars (Strval (Expr_Value_S (Expression (Arg))));
9111                Arg := Next (Arg);
9112             end loop;
9113
9114             if Operating_Mode = Generate_Code
9115               and then In_Extended_Main_Source_Unit (N)
9116             then
9117                Store_Linker_Option_String (End_String);
9118             end if;
9119          end Linker_Options;
9120
9121          --------------------
9122          -- Linker_Section --
9123          --------------------
9124
9125          --  pragma Linker_Section (
9126          --      [Entity  =>]  LOCAL_NAME
9127          --      [Section =>]  static_string_EXPRESSION);
9128
9129          when Pragma_Linker_Section =>
9130             GNAT_Pragma;
9131             Check_Arg_Order ((Name_Entity, Name_Section));
9132             Check_Arg_Count (2);
9133             Check_Optional_Identifier (Arg1, Name_Entity);
9134             Check_Optional_Identifier (Arg2, Name_Section);
9135             Check_Arg_Is_Library_Level_Local_Name (Arg1);
9136             Check_Arg_Is_Static_Expression (Arg2, Standard_String);
9137
9138             --  This pragma applies only to objects
9139
9140             if not Is_Object (Entity (Expression (Arg1))) then
9141                Error_Pragma_Arg ("pragma% applies only to objects", Arg1);
9142             end if;
9143
9144             --  The only processing required is to link this item on to the
9145             --  list of rep items for the given entity. This is accomplished
9146             --  by the call to Rep_Item_Too_Late (when no error is detected
9147             --  and False is returned).
9148
9149             if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
9150                return;
9151             else
9152                Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
9153             end if;
9154
9155          ----------
9156          -- List --
9157          ----------
9158
9159          --  pragma List (On | Off)
9160
9161          --  There is nothing to do here, since we did all the processing for
9162          --  this pragma in Par.Prag (so that it works properly even in syntax
9163          --  only mode).
9164
9165          when Pragma_List =>
9166             null;
9167
9168          --------------------
9169          -- Locking_Policy --
9170          --------------------
9171
9172          --  pragma Locking_Policy (policy_IDENTIFIER);
9173
9174          when Pragma_Locking_Policy => declare
9175             LP : Character;
9176
9177          begin
9178             Check_Ada_83_Warning;
9179             Check_Arg_Count (1);
9180             Check_No_Identifiers;
9181             Check_Arg_Is_Locking_Policy (Arg1);
9182             Check_Valid_Configuration_Pragma;
9183             Get_Name_String (Chars (Expression (Arg1)));
9184             LP := Fold_Upper (Name_Buffer (1));
9185
9186             if Locking_Policy /= ' '
9187               and then Locking_Policy /= LP
9188             then
9189                Error_Msg_Sloc := Locking_Policy_Sloc;
9190                Error_Pragma ("locking policy incompatible with policy#");
9191
9192             --  Set new policy, but always preserve System_Location since we
9193             --  like the error message with the run time name.
9194
9195             else
9196                Locking_Policy := LP;
9197
9198                if Locking_Policy_Sloc /= System_Location then
9199                   Locking_Policy_Sloc := Loc;
9200                end if;
9201             end if;
9202          end;
9203
9204          ----------------
9205          -- Long_Float --
9206          ----------------
9207
9208          --  pragma Long_Float (D_Float | G_Float);
9209
9210          when Pragma_Long_Float =>
9211             GNAT_Pragma;
9212             Check_Valid_Configuration_Pragma;
9213             Check_Arg_Count (1);
9214             Check_No_Identifier (Arg1);
9215             Check_Arg_Is_One_Of (Arg1, Name_D_Float, Name_G_Float);
9216
9217             if not OpenVMS_On_Target then
9218                Error_Pragma ("?pragma% ignored (applies only to Open'V'M'S)");
9219             end if;
9220
9221             --  D_Float case
9222
9223             if Chars (Expression (Arg1)) = Name_D_Float then
9224                if Opt.Float_Format_Long = 'G' then
9225                   Error_Pragma ("G_Float previously specified");
9226                end if;
9227
9228                Opt.Float_Format_Long := 'D';
9229
9230             --  G_Float case (this is the default, does not need overriding)
9231
9232             else
9233                if Opt.Float_Format_Long = 'D' then
9234                   Error_Pragma ("D_Float previously specified");
9235                end if;
9236
9237                Opt.Float_Format_Long := 'G';
9238             end if;
9239
9240             Set_Standard_Fpt_Formats;
9241
9242          -----------------------
9243          -- Machine_Attribute --
9244          -----------------------
9245
9246          --  pragma Machine_Attribute (
9247          --       [Entity         =>] LOCAL_NAME,
9248          --       [Attribute_Name =>] static_string_EXPRESSION
9249          --    [, [Info           =>] static_EXPRESSION] );
9250
9251          when Pragma_Machine_Attribute => Machine_Attribute : declare
9252             Def_Id : Entity_Id;
9253
9254          begin
9255             GNAT_Pragma;
9256             Check_Arg_Order ((Name_Entity, Name_Attribute_Name, Name_Info));
9257
9258             if Arg_Count = 3 then
9259                Check_Optional_Identifier (Arg3, Name_Info);
9260                Check_Arg_Is_Static_Expression (Arg3);
9261             else
9262                Check_Arg_Count (2);
9263             end if;
9264
9265             Check_Optional_Identifier (Arg1, Name_Entity);
9266             Check_Optional_Identifier (Arg2, Name_Attribute_Name);
9267             Check_Arg_Is_Local_Name (Arg1);
9268             Check_Arg_Is_Static_Expression (Arg2, Standard_String);
9269             Def_Id := Entity (Expression (Arg1));
9270
9271             if Is_Access_Type (Def_Id) then
9272                Def_Id := Designated_Type (Def_Id);
9273             end if;
9274
9275             if Rep_Item_Too_Early (Def_Id, N) then
9276                return;
9277             end if;
9278
9279             Def_Id := Underlying_Type (Def_Id);
9280
9281             --  The only processing required is to link this item on to the
9282             --  list of rep items for the given entity. This is accomplished
9283             --  by the call to Rep_Item_Too_Late (when no error is detected
9284             --  and False is returned).
9285
9286             if Rep_Item_Too_Late (Def_Id, N) then
9287                return;
9288             else
9289                Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
9290             end if;
9291          end Machine_Attribute;
9292
9293          ----------
9294          -- Main --
9295          ----------
9296
9297          --  pragma Main
9298          --   (MAIN_OPTION [, MAIN_OPTION]);
9299
9300          --  MAIN_OPTION ::=
9301          --    [STACK_SIZE              =>] static_integer_EXPRESSION
9302          --  | [TASK_STACK_SIZE_DEFAULT =>] static_integer_EXPRESSION
9303          --  | [TIME_SLICING_ENABLED    =>] static_boolean_EXPRESSION
9304
9305          when Pragma_Main => Main : declare
9306             Args  : Args_List (1 .. 3);
9307             Names : constant Name_List (1 .. 3) := (
9308                       Name_Stack_Size,
9309                       Name_Task_Stack_Size_Default,
9310                       Name_Time_Slicing_Enabled);
9311
9312             Nod : Node_Id;
9313
9314          begin
9315             GNAT_Pragma;
9316             Gather_Associations (Names, Args);
9317
9318             for J in 1 .. 2 loop
9319                if Present (Args (J)) then
9320                   Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
9321                end if;
9322             end loop;
9323
9324             if Present (Args (3)) then
9325                Check_Arg_Is_Static_Expression (Args (3), Standard_Boolean);
9326             end if;
9327
9328             Nod := Next (N);
9329             while Present (Nod) loop
9330                if Nkind (Nod) = N_Pragma
9331                  and then Pragma_Name (Nod) = Name_Main
9332                then
9333                   Error_Msg_Name_1 := Pname;
9334                   Error_Msg_N ("duplicate pragma% not permitted", Nod);
9335                end if;
9336
9337                Next (Nod);
9338             end loop;
9339          end Main;
9340
9341          ------------------
9342          -- Main_Storage --
9343          ------------------
9344
9345          --  pragma Main_Storage
9346          --   (MAIN_STORAGE_OPTION [, MAIN_STORAGE_OPTION]);
9347
9348          --  MAIN_STORAGE_OPTION ::=
9349          --    [WORKING_STORAGE =>] static_SIMPLE_EXPRESSION
9350          --  | [TOP_GUARD =>] static_SIMPLE_EXPRESSION
9351
9352          when Pragma_Main_Storage => Main_Storage : declare
9353             Args  : Args_List (1 .. 2);
9354             Names : constant Name_List (1 .. 2) := (
9355                       Name_Working_Storage,
9356                       Name_Top_Guard);
9357
9358             Nod : Node_Id;
9359
9360          begin
9361             GNAT_Pragma;
9362             Gather_Associations (Names, Args);
9363
9364             for J in 1 .. 2 loop
9365                if Present (Args (J)) then
9366                   Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
9367                end if;
9368             end loop;
9369
9370             Check_In_Main_Program;
9371
9372             Nod := Next (N);
9373             while Present (Nod) loop
9374                if Nkind (Nod) = N_Pragma
9375                  and then Pragma_Name (Nod) = Name_Main_Storage
9376                then
9377                   Error_Msg_Name_1 := Pname;
9378                   Error_Msg_N ("duplicate pragma% not permitted", Nod);
9379                end if;
9380
9381                Next (Nod);
9382             end loop;
9383          end Main_Storage;
9384
9385          -----------------
9386          -- Memory_Size --
9387          -----------------
9388
9389          --  pragma Memory_Size (NUMERIC_LITERAL)
9390
9391          when Pragma_Memory_Size =>
9392             GNAT_Pragma;
9393
9394             --  Memory size is simply ignored
9395
9396             Check_No_Identifiers;
9397             Check_Arg_Count (1);
9398             Check_Arg_Is_Integer_Literal (Arg1);
9399
9400          -------------
9401          -- No_Body --
9402          -------------
9403
9404          --  pragma No_Body;
9405
9406          --  The only correct use of this pragma is on its own in a file, in
9407          --  which case it is specially processed (see Gnat1drv.Check_Bad_Body
9408          --  and Frontend, which use Sinput.L.Source_File_Is_Pragma_No_Body to
9409          --  check for a file containing nothing but a No_Body pragma). If we
9410          --  attempt to process it during normal semantics processing, it means
9411          --  it was misplaced.
9412
9413          when Pragma_No_Body =>
9414             GNAT_Pragma;
9415             Pragma_Misplaced;
9416
9417          ---------------
9418          -- No_Return --
9419          ---------------
9420
9421          --  pragma No_Return (procedure_LOCAL_NAME {, procedure_Local_Name});
9422
9423          when Pragma_No_Return => No_Return : declare
9424             Id    : Node_Id;
9425             E     : Entity_Id;
9426             Found : Boolean;
9427             Arg   : Node_Id;
9428
9429          begin
9430             Ada_2005_Pragma;
9431             Check_At_Least_N_Arguments (1);
9432
9433             --  Loop through arguments of pragma
9434
9435             Arg := Arg1;
9436             while Present (Arg) loop
9437                Check_Arg_Is_Local_Name (Arg);
9438                Id := Expression (Arg);
9439                Analyze (Id);
9440
9441                if not Is_Entity_Name (Id) then
9442                   Error_Pragma_Arg ("entity name required", Arg);
9443                end if;
9444
9445                if Etype (Id) = Any_Type then
9446                   raise Pragma_Exit;
9447                end if;
9448
9449                --  Loop to find matching procedures
9450
9451                E := Entity (Id);
9452                Found := False;
9453                while Present (E)
9454                  and then Scope (E) = Current_Scope
9455                loop
9456                   if Ekind_In (E, E_Procedure, E_Generic_Procedure) then
9457                      Set_No_Return (E);
9458
9459                      --  Set flag on any alias as well
9460
9461                      if Is_Overloadable (E) and then Present (Alias (E)) then
9462                         Set_No_Return (Alias (E));
9463                      end if;
9464
9465                      Found := True;
9466                   end if;
9467
9468                   E := Homonym (E);
9469                end loop;
9470
9471                if not Found then
9472                   Error_Pragma_Arg ("no procedure & found for pragma%", Arg);
9473                end if;
9474
9475                Next (Arg);
9476             end loop;
9477          end No_Return;
9478
9479          -----------------
9480          -- No_Run_Time --
9481          -----------------
9482
9483          --  pragma No_Run_Time;
9484
9485          --  Note: this pragma is retained for backwards compatibility. See
9486          --  body of Rtsfind for full details on its handling.
9487
9488          when Pragma_No_Run_Time =>
9489             GNAT_Pragma;
9490             Check_Valid_Configuration_Pragma;
9491             Check_Arg_Count (0);
9492
9493             No_Run_Time_Mode           := True;
9494             Configurable_Run_Time_Mode := True;
9495
9496             --  Set Duration to 32 bits if word size is 32
9497
9498             if Ttypes.System_Word_Size = 32 then
9499                Duration_32_Bits_On_Target := True;
9500             end if;
9501
9502             --  Set appropriate restrictions
9503
9504             Set_Restriction (No_Finalization, N);
9505             Set_Restriction (No_Exception_Handlers, N);
9506             Set_Restriction (Max_Tasks, N, 0);
9507             Set_Restriction (No_Tasking, N);
9508
9509          ------------------------
9510          -- No_Strict_Aliasing --
9511          ------------------------
9512
9513          --  pragma No_Strict_Aliasing [([Entity =>] type_LOCAL_NAME)];
9514
9515          when Pragma_No_Strict_Aliasing => No_Strict_Aliasing : declare
9516             E_Id : Entity_Id;
9517
9518          begin
9519             GNAT_Pragma;
9520             Check_At_Most_N_Arguments (1);
9521
9522             if Arg_Count = 0 then
9523                Check_Valid_Configuration_Pragma;
9524                Opt.No_Strict_Aliasing := True;
9525
9526             else
9527                Check_Optional_Identifier (Arg2, Name_Entity);
9528                Check_Arg_Is_Local_Name (Arg1);
9529                E_Id := Entity (Expression (Arg1));
9530
9531                if E_Id = Any_Type then
9532                   return;
9533                elsif No (E_Id) or else not Is_Access_Type (E_Id) then
9534                   Error_Pragma_Arg ("pragma% requires access type", Arg1);
9535                end if;
9536
9537                Set_No_Strict_Aliasing (Implementation_Base_Type (E_Id));
9538             end if;
9539          end No_Strict_Aliasing;
9540
9541          -----------------------
9542          -- Normalize_Scalars --
9543          -----------------------
9544
9545          --  pragma Normalize_Scalars;
9546
9547          when Pragma_Normalize_Scalars =>
9548             Check_Ada_83_Warning;
9549             Check_Arg_Count (0);
9550             Check_Valid_Configuration_Pragma;
9551
9552             --  Normalize_Scalars creates false positives in CodePeer, so
9553             --  ignore this pragma in this mode.
9554
9555             if not CodePeer_Mode then
9556                Normalize_Scalars := True;
9557                Init_Or_Norm_Scalars := True;
9558             end if;
9559
9560          -----------------
9561          -- Obsolescent --
9562          -----------------
9563
9564          --  pragma Obsolescent;
9565
9566          --  pragma Obsolescent (
9567          --    [Message =>] static_string_EXPRESSION
9568          --  [,[Version =>] Ada_05]]);
9569
9570          --  pragma Obsolescent (
9571          --    [Entity  =>] NAME
9572          --  [,[Message =>] static_string_EXPRESSION
9573          --  [,[Version =>] Ada_05]] );
9574
9575          when Pragma_Obsolescent => Obsolescent : declare
9576             Ename : Node_Id;
9577             Decl  : Node_Id;
9578
9579             procedure Set_Obsolescent (E : Entity_Id);
9580             --  Given an entity Ent, mark it as obsolescent if appropriate
9581
9582             ---------------------
9583             -- Set_Obsolescent --
9584             ---------------------
9585
9586             procedure Set_Obsolescent (E : Entity_Id) is
9587                Active : Boolean;
9588                Ent    : Entity_Id;
9589                S      : String_Id;
9590
9591             begin
9592                Active := True;
9593                Ent    := E;
9594
9595                --  Entity name was given
9596
9597                if Present (Ename) then
9598
9599                   --  If entity name matches, we are fine. Save entity in
9600                   --  pragma argument, for ASIS use.
9601
9602                   if Chars (Ename) = Chars (Ent) then
9603                      Set_Entity (Ename, Ent);
9604                      Generate_Reference (Ent, Ename);
9605
9606                   --  If entity name does not match, only possibility is an
9607                   --  enumeration literal from an enumeration type declaration.
9608
9609                   elsif Ekind (Ent) /= E_Enumeration_Type then
9610                      Error_Pragma
9611                        ("pragma % entity name does not match declaration");
9612
9613                   else
9614                      Ent := First_Literal (E);
9615                      loop
9616                         if No (Ent) then
9617                            Error_Pragma
9618                              ("pragma % entity name does not match any " &
9619                               "enumeration literal");
9620
9621                         elsif Chars (Ent) = Chars (Ename) then
9622                            Set_Entity (Ename, Ent);
9623                            Generate_Reference (Ent, Ename);
9624                            exit;
9625
9626                         else
9627                            Ent := Next_Literal (Ent);
9628                         end if;
9629                      end loop;
9630                   end if;
9631                end if;
9632
9633                --  Ent points to entity to be marked
9634
9635                if Arg_Count >= 1 then
9636
9637                   --  Deal with static string argument
9638
9639                   Check_Arg_Is_Static_Expression (Arg1, Standard_String);
9640                   S := Strval (Expression (Arg1));
9641
9642                   for J in 1 .. String_Length (S) loop
9643                      if not In_Character_Range (Get_String_Char (S, J)) then
9644                         Error_Pragma_Arg
9645                           ("pragma% argument does not allow wide characters",
9646                            Arg1);
9647                      end if;
9648                   end loop;
9649
9650                   Obsolescent_Warnings.Append
9651                     ((Ent => Ent, Msg => Strval (Expression (Arg1))));
9652
9653                   --  Check for Ada_05 parameter
9654
9655                   if Arg_Count /= 1 then
9656                      Check_Arg_Count (2);
9657
9658                      declare
9659                         Argx : constant Node_Id := Get_Pragma_Arg (Arg2);
9660
9661                      begin
9662                         Check_Arg_Is_Identifier (Argx);
9663
9664                         if Chars (Argx) /= Name_Ada_05 then
9665                            Error_Msg_Name_2 := Name_Ada_05;
9666                            Error_Pragma_Arg
9667                              ("only allowed argument for pragma% is %", Argx);
9668                         end if;
9669
9670                         if Ada_Version_Explicit < Ada_05
9671                           or else not Warn_On_Ada_2005_Compatibility
9672                         then
9673                            Active := False;
9674                         end if;
9675                      end;
9676                   end if;
9677                end if;
9678
9679                --  Set flag if pragma active
9680
9681                if Active then
9682                   Set_Is_Obsolescent (Ent);
9683                end if;
9684
9685                return;
9686             end Set_Obsolescent;
9687
9688          --  Start of processing for pragma Obsolescent
9689
9690          begin
9691             GNAT_Pragma;
9692
9693             Check_At_Most_N_Arguments (3);
9694
9695             --  See if first argument specifies an entity name
9696
9697             if Arg_Count >= 1
9698               and then
9699                 (Chars (Arg1) = Name_Entity
9700                    or else
9701                      Nkind_In (Get_Pragma_Arg (Arg1), N_Character_Literal,
9702                                                       N_Identifier,
9703                                                       N_Operator_Symbol))
9704             then
9705                Ename := Get_Pragma_Arg (Arg1);
9706
9707                --  Eliminate first argument, so we can share processing
9708
9709                Arg1 := Arg2;
9710                Arg2 := Arg3;
9711                Arg_Count := Arg_Count - 1;
9712
9713             --  No Entity name argument given
9714
9715             else
9716                Ename := Empty;
9717             end if;
9718
9719             if Arg_Count >= 1 then
9720                Check_Optional_Identifier (Arg1, Name_Message);
9721
9722                if Arg_Count = 2 then
9723                   Check_Optional_Identifier (Arg2, Name_Version);
9724                end if;
9725             end if;
9726
9727             --  Get immediately preceding declaration
9728
9729             Decl := Prev (N);
9730             while Present (Decl) and then Nkind (Decl) = N_Pragma loop
9731                Prev (Decl);
9732             end loop;
9733
9734             --  Cases where we do not follow anything other than another pragma
9735
9736             if No (Decl) then
9737
9738                --  First case: library level compilation unit declaration with
9739                --  the pragma immediately following the declaration.
9740
9741                if Nkind (Parent (N)) = N_Compilation_Unit_Aux then
9742                   Set_Obsolescent
9743                     (Defining_Entity (Unit (Parent (Parent (N)))));
9744                   return;
9745
9746                --  Case 2: library unit placement for package
9747
9748                else
9749                   declare
9750                      Ent : constant Entity_Id := Find_Lib_Unit_Name;
9751                   begin
9752                      if Is_Package_Or_Generic_Package (Ent) then
9753                         Set_Obsolescent (Ent);
9754                         return;
9755                      end if;
9756                   end;
9757                end if;
9758
9759             --  Cases where we must follow a declaration
9760
9761             else
9762                if         Nkind (Decl) not in N_Declaration
9763                  and then Nkind (Decl) not in N_Later_Decl_Item
9764                  and then Nkind (Decl) not in N_Generic_Declaration
9765                  and then Nkind (Decl) not in N_Renaming_Declaration
9766                then
9767                   Error_Pragma
9768                     ("pragma% misplaced, "
9769                      & "must immediately follow a declaration");
9770
9771                else
9772                   Set_Obsolescent (Defining_Entity (Decl));
9773                   return;
9774                end if;
9775             end if;
9776          end Obsolescent;
9777
9778          --------------
9779          -- Optimize --
9780          --------------
9781
9782          --  pragma Optimize (Time | Space | Off);
9783
9784          --  The actual check for optimize is done in Gigi. Note that this
9785          --  pragma does not actually change the optimization setting, it
9786          --  simply checks that it is consistent with the pragma.
9787
9788          when Pragma_Optimize =>
9789             Check_No_Identifiers;
9790             Check_Arg_Count (1);
9791             Check_Arg_Is_One_Of (Arg1, Name_Time, Name_Space, Name_Off);
9792
9793          ------------------------
9794          -- Optimize_Alignment --
9795          ------------------------
9796
9797          --  pragma Optimize_Alignment (Time | Space | Off);
9798
9799          when Pragma_Optimize_Alignment => Optimize_Alignment : begin
9800             GNAT_Pragma;
9801             Check_No_Identifiers;
9802             Check_Arg_Count (1);
9803             Check_Valid_Configuration_Pragma;
9804
9805             declare
9806                Nam : constant Name_Id := Chars (Get_Pragma_Arg (Arg1));
9807             begin
9808                case Nam is
9809                   when Name_Time =>
9810                      Opt.Optimize_Alignment := 'T';
9811                   when Name_Space =>
9812                      Opt.Optimize_Alignment := 'S';
9813                   when Name_Off =>
9814                      Opt.Optimize_Alignment := 'O';
9815                   when others =>
9816                      Error_Pragma_Arg ("invalid argument for pragma%", Arg1);
9817                end case;
9818             end;
9819
9820             --  Set indication that mode is set locally. If we are in fact in a
9821             --  configuration pragma file, this setting is harmless since the
9822             --  switch will get reset anyway at the start of each unit.
9823
9824             Optimize_Alignment_Local := True;
9825          end Optimize_Alignment;
9826
9827          -------------
9828          -- Ordered --
9829          -------------
9830
9831          --  pragma Ordered (first_enumeration_subtype_LOCAL_NAME);
9832
9833          when Pragma_Ordered => Ordered : declare
9834             Assoc   : constant Node_Id := Arg1;
9835             Type_Id : Node_Id;
9836             Typ     : Entity_Id;
9837
9838          begin
9839             GNAT_Pragma;
9840             Check_No_Identifiers;
9841             Check_Arg_Count (1);
9842             Check_Arg_Is_Local_Name (Arg1);
9843
9844             Type_Id := Expression (Assoc);
9845             Find_Type (Type_Id);
9846             Typ := Entity (Type_Id);
9847
9848             if Typ = Any_Type then
9849                return;
9850             else
9851                Typ := Underlying_Type (Typ);
9852             end if;
9853
9854             if not Is_Enumeration_Type (Typ) then
9855                Error_Pragma ("pragma% must specify enumeration type");
9856             end if;
9857
9858             Check_First_Subtype (Arg1);
9859             Set_Has_Pragma_Ordered (Base_Type (Typ));
9860          end Ordered;
9861
9862          ----------
9863          -- Pack --
9864          ----------
9865
9866          --  pragma Pack (first_subtype_LOCAL_NAME);
9867
9868          when Pragma_Pack => Pack : declare
9869             Assoc   : constant Node_Id := Arg1;
9870             Type_Id : Node_Id;
9871             Typ     : Entity_Id;
9872
9873          begin
9874             Check_No_Identifiers;
9875             Check_Arg_Count (1);
9876             Check_Arg_Is_Local_Name (Arg1);
9877
9878             Type_Id := Expression (Assoc);
9879             Find_Type (Type_Id);
9880             Typ := Entity (Type_Id);
9881
9882             if Typ = Any_Type
9883               or else Rep_Item_Too_Early (Typ, N)
9884             then
9885                return;
9886             else
9887                Typ := Underlying_Type (Typ);
9888             end if;
9889
9890             if not Is_Array_Type (Typ) and then not Is_Record_Type (Typ) then
9891                Error_Pragma ("pragma% must specify array or record type");
9892             end if;
9893
9894             Check_First_Subtype (Arg1);
9895
9896             if Has_Pragma_Pack (Typ) then
9897                Error_Pragma ("duplicate pragma%, only one allowed");
9898
9899             --  Array type
9900
9901             elsif Is_Array_Type (Typ) then
9902
9903                --  Pack not allowed for aliased or atomic components
9904
9905                if Has_Aliased_Components (Base_Type (Typ)) then
9906                   Error_Pragma
9907                     ("pragma% ignored, cannot pack aliased components?");
9908
9909                elsif Has_Atomic_Components (Typ)
9910                  or else Is_Atomic (Component_Type (Typ))
9911                then
9912                   Error_Pragma
9913                     ("?pragma% ignored, cannot pack atomic components");
9914                end if;
9915
9916                --  If we had an explicit component size given, then we do not
9917                --  let Pack override this given size. We also give a warning
9918                --  that Pack is being ignored unless we can tell for sure that
9919                --  the Pack would not have had any effect anyway.
9920
9921                if Has_Component_Size_Clause (Typ) then
9922                   if Known_Static_RM_Size (Component_Type (Typ))
9923                     and then
9924                       RM_Size (Component_Type (Typ)) = Component_Size (Typ)
9925                   then
9926                      null;
9927                   else
9928                      Error_Pragma
9929                        ("?pragma% ignored, explicit component size given");
9930                   end if;
9931
9932                --  If no prior array component size given, Pack is effective
9933
9934                else
9935                   if not Rep_Item_Too_Late (Typ, N) then
9936
9937                      --  In the context of static code analysis, we do not need
9938                      --  complex front-end expansions related to pragma Pack,
9939                      --  so disable handling of pragma Pack in this case.
9940
9941                      if CodePeer_Mode then
9942                         null;
9943
9944                      --  For normal non-VM target, do the packing
9945
9946                      elsif VM_Target = No_VM then
9947                         Set_Is_Packed            (Base_Type (Typ));
9948                         Set_Has_Pragma_Pack      (Base_Type (Typ));
9949                         Set_Has_Non_Standard_Rep (Base_Type (Typ));
9950
9951                      --  If we ignore the pack, then warn about this, except
9952                      --  that we suppress the warning in GNAT mode.
9953
9954                      elsif not GNAT_Mode then
9955                         Error_Pragma
9956                           ("?pragma% ignored in this configuration");
9957                      end if;
9958                   end if;
9959                end if;
9960
9961             --  For record types, the pack is always effective
9962
9963             else pragma Assert (Is_Record_Type (Typ));
9964                if not Rep_Item_Too_Late (Typ, N) then
9965                   if VM_Target = No_VM then
9966                      Set_Is_Packed            (Base_Type (Typ));
9967                      Set_Has_Pragma_Pack      (Base_Type (Typ));
9968                      Set_Has_Non_Standard_Rep (Base_Type (Typ));
9969
9970                   elsif not GNAT_Mode then
9971                      Error_Pragma ("?pragma% ignored in this configuration");
9972                   end if;
9973                end if;
9974             end if;
9975          end Pack;
9976
9977          ----------
9978          -- Page --
9979          ----------
9980
9981          --  pragma Page;
9982
9983          --  There is nothing to do here, since we did all the processing for
9984          --  this pragma in Par.Prag (so that it works properly even in syntax
9985          --  only mode).
9986
9987          when Pragma_Page =>
9988             null;
9989
9990          -------------
9991          -- Passive --
9992          -------------
9993
9994          --  pragma Passive [(PASSIVE_FORM)];
9995
9996          --   PASSIVE_FORM ::= Semaphore | No
9997
9998          when Pragma_Passive =>
9999             GNAT_Pragma;
10000
10001             if Nkind (Parent (N)) /= N_Task_Definition then
10002                Error_Pragma ("pragma% must be within task definition");
10003             end if;
10004
10005             if Arg_Count /= 0 then
10006                Check_Arg_Count (1);
10007                Check_Arg_Is_One_Of (Arg1, Name_Semaphore, Name_No);
10008             end if;
10009
10010          ----------------------------------
10011          -- Preelaborable_Initialization --
10012          ----------------------------------
10013
10014          --  pragma Preelaborable_Initialization (DIRECT_NAME);
10015
10016          when Pragma_Preelaborable_Initialization => Preelab_Init : declare
10017             Ent : Entity_Id;
10018
10019          begin
10020             Ada_2005_Pragma;
10021             Check_Arg_Count (1);
10022             Check_No_Identifiers;
10023             Check_Arg_Is_Identifier (Arg1);
10024             Check_Arg_Is_Local_Name (Arg1);
10025             Check_First_Subtype (Arg1);
10026             Ent := Entity (Expression (Arg1));
10027
10028             if not Is_Private_Type (Ent)
10029               and then not Is_Protected_Type (Ent)
10030             then
10031                Error_Pragma_Arg
10032                  ("pragma % can only be applied to private or protected type",
10033                   Arg1);
10034             end if;
10035
10036             --  Give an error if the pragma is applied to a protected type that
10037             --  does not qualify (due to having entries, or due to components
10038             --  that do not qualify).
10039
10040             if Is_Protected_Type (Ent)
10041               and then not Has_Preelaborable_Initialization (Ent)
10042             then
10043                Error_Msg_N
10044                  ("protected type & does not have preelaborable " &
10045                   "initialization", Ent);
10046
10047             --  Otherwise mark the type as definitely having preelaborable
10048             --  initialization.
10049
10050             else
10051                Set_Known_To_Have_Preelab_Init (Ent);
10052             end if;
10053
10054             if Has_Pragma_Preelab_Init (Ent)
10055               and then Warn_On_Redundant_Constructs
10056             then
10057                Error_Pragma ("?duplicate pragma%!");
10058             else
10059                Set_Has_Pragma_Preelab_Init (Ent);
10060             end if;
10061          end Preelab_Init;
10062
10063          --------------------
10064          -- Persistent_BSS --
10065          --------------------
10066
10067          when Pragma_Persistent_BSS => Persistent_BSS :  declare
10068             Decl : Node_Id;
10069             Ent  : Entity_Id;
10070             Prag : Node_Id;
10071
10072          begin
10073             GNAT_Pragma;
10074             Check_At_Most_N_Arguments (1);
10075
10076             --  Case of application to specific object (one argument)
10077
10078             if Arg_Count = 1 then
10079                Check_Arg_Is_Library_Level_Local_Name (Arg1);
10080
10081                if not Is_Entity_Name (Expression (Arg1))
10082                  or else
10083                   (Ekind (Entity (Expression (Arg1))) /= E_Variable
10084                     and then Ekind (Entity (Expression (Arg1))) /= E_Constant)
10085                then
10086                   Error_Pragma_Arg ("pragma% only applies to objects", Arg1);
10087                end if;
10088
10089                Ent := Entity (Expression (Arg1));
10090                Decl := Parent (Ent);
10091
10092                if Rep_Item_Too_Late (Ent, N) then
10093                   return;
10094                end if;
10095
10096                if Present (Expression (Decl)) then
10097                   Error_Pragma_Arg
10098                     ("object for pragma% cannot have initialization", Arg1);
10099                end if;
10100
10101                if not Is_Potentially_Persistent_Type (Etype (Ent)) then
10102                   Error_Pragma_Arg
10103                     ("object type for pragma% is not potentially persistent",
10104                      Arg1);
10105                end if;
10106
10107                Prag :=
10108                  Make_Linker_Section_Pragma
10109                    (Ent, Sloc (N), ".persistent.bss");
10110                Insert_After (N, Prag);
10111                Analyze (Prag);
10112
10113             --  Case of use as configuration pragma with no arguments
10114
10115             else
10116                Check_Valid_Configuration_Pragma;
10117                Persistent_BSS_Mode := True;
10118             end if;
10119          end Persistent_BSS;
10120
10121          -------------
10122          -- Polling --
10123          -------------
10124
10125          --  pragma Polling (ON | OFF);
10126
10127          when Pragma_Polling =>
10128             GNAT_Pragma;
10129             Check_Arg_Count (1);
10130             Check_No_Identifiers;
10131             Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
10132             Polling_Required := (Chars (Expression (Arg1)) = Name_On);
10133
10134          -------------------
10135          -- Postcondition --
10136          -------------------
10137
10138          --  pragma Postcondition ([Check   =>] Boolean_Expression
10139          --                      [,[Message =>] String_Expression]);
10140
10141          when Pragma_Postcondition => Postcondition : declare
10142             In_Body : Boolean;
10143             pragma Warnings (Off, In_Body);
10144
10145          begin
10146             GNAT_Pragma;
10147             Check_At_Least_N_Arguments (1);
10148             Check_At_Most_N_Arguments (2);
10149             Check_Optional_Identifier (Arg1, Name_Check);
10150
10151             --  All we need to do here is call the common check procedure,
10152             --  the remainder of the processing is found in Sem_Ch6/Sem_Ch7.
10153
10154             Check_Precondition_Postcondition (In_Body);
10155          end Postcondition;
10156
10157          ------------------
10158          -- Precondition --
10159          ------------------
10160
10161          --  pragma Precondition ([Check   =>] Boolean_Expression
10162          --                     [,[Message =>] String_Expression]);
10163
10164          when Pragma_Precondition => Precondition : declare
10165             In_Body : Boolean;
10166
10167          begin
10168             GNAT_Pragma;
10169             Check_At_Least_N_Arguments (1);
10170             Check_At_Most_N_Arguments (2);
10171             Check_Optional_Identifier (Arg1, Name_Check);
10172
10173             Check_Precondition_Postcondition (In_Body);
10174
10175             --  If in spec, nothing more to do. If in body, then we convert the
10176             --  pragma to pragma Check (Precondition, cond [, msg]). Note we do
10177             --  this whether or not precondition checks are enabled. That works
10178             --  fine since pragma Check will do this check, and will also
10179             --  analyze the condition itself in the proper context.
10180
10181             if In_Body then
10182                if Arg_Count = 2 then
10183                   Check_Optional_Identifier (Arg3, Name_Message);
10184                   Analyze_And_Resolve (Get_Pragma_Arg (Arg2), Standard_String);
10185                end if;
10186
10187                Rewrite (N,
10188                  Make_Pragma (Loc,
10189                    Chars => Name_Check,
10190                    Pragma_Argument_Associations => New_List (
10191                      Make_Pragma_Argument_Association (Loc,
10192                        Expression =>
10193                          Make_Identifier (Loc,
10194                            Chars => Name_Precondition)),
10195
10196                      Make_Pragma_Argument_Association (Sloc (Arg1),
10197                        Expression => Relocate_Node (Get_Pragma_Arg (Arg1))))));
10198
10199                if Arg_Count = 2 then
10200                   Append_To (Pragma_Argument_Associations (N),
10201                     Make_Pragma_Argument_Association (Sloc (Arg2),
10202                       Expression => Relocate_Node (Get_Pragma_Arg (Arg2))));
10203                end if;
10204
10205                Analyze (N);
10206             end if;
10207          end Precondition;
10208
10209          ------------------
10210          -- Preelaborate --
10211          ------------------
10212
10213          --  pragma Preelaborate [(library_unit_NAME)];
10214
10215          --  Set the flag Is_Preelaborated of program unit name entity
10216
10217          when Pragma_Preelaborate => Preelaborate : declare
10218             Pa  : constant Node_Id   := Parent (N);
10219             Pk  : constant Node_Kind := Nkind (Pa);
10220             Ent : Entity_Id;
10221
10222          begin
10223             Check_Ada_83_Warning;
10224             Check_Valid_Library_Unit_Pragma;
10225
10226             if Nkind (N) = N_Null_Statement then
10227                return;
10228             end if;
10229
10230             Ent := Find_Lib_Unit_Name;
10231
10232             --  This filters out pragmas inside generic parent then
10233             --  show up inside instantiation
10234
10235             if Present (Ent)
10236               and then not (Pk = N_Package_Specification
10237                               and then Present (Generic_Parent (Pa)))
10238             then
10239                if not Debug_Flag_U then
10240                   Set_Is_Preelaborated (Ent);
10241                   Set_Suppress_Elaboration_Warnings (Ent);
10242                end if;
10243             end if;
10244          end Preelaborate;
10245
10246          ---------------------
10247          -- Preelaborate_05 --
10248          ---------------------
10249
10250          --  pragma Preelaborate_05 [(library_unit_NAME)];
10251
10252          --  This pragma is useable only in GNAT_Mode, where it is used like
10253          --  pragma Preelaborate but it is only effective in Ada 2005 mode
10254          --  (otherwise it is ignored). This is used to implement AI-362 which
10255          --  recategorizes some run-time packages in Ada 2005 mode.
10256
10257          when Pragma_Preelaborate_05 => Preelaborate_05 : declare
10258             Ent : Entity_Id;
10259
10260          begin
10261             GNAT_Pragma;
10262             Check_Valid_Library_Unit_Pragma;
10263
10264             if not GNAT_Mode then
10265                Error_Pragma ("pragma% only available in GNAT mode");
10266             end if;
10267
10268             if Nkind (N) = N_Null_Statement then
10269                return;
10270             end if;
10271
10272             --  This is one of the few cases where we need to test the value of
10273             --  Ada_Version_Explicit rather than Ada_Version (which is always
10274             --  set to Ada_12 in a predefined unit), we need to know the
10275             --  explicit version set to know if this pragma is active.
10276
10277             if Ada_Version_Explicit >= Ada_05 then
10278                Ent := Find_Lib_Unit_Name;
10279                Set_Is_Preelaborated (Ent);
10280                Set_Suppress_Elaboration_Warnings (Ent);
10281             end if;
10282          end Preelaborate_05;
10283
10284          --------------
10285          -- Priority --
10286          --------------
10287
10288          --  pragma Priority (EXPRESSION);
10289
10290          when Pragma_Priority => Priority : declare
10291             P   : constant Node_Id := Parent (N);
10292             Arg : Node_Id;
10293
10294          begin
10295             Check_No_Identifiers;
10296             Check_Arg_Count (1);
10297
10298             --  Subprogram case
10299
10300             if Nkind (P) = N_Subprogram_Body then
10301                Check_In_Main_Program;
10302
10303                Arg := Expression (Arg1);
10304                Analyze_And_Resolve (Arg, Standard_Integer);
10305
10306                --  Must be static
10307
10308                if not Is_Static_Expression (Arg) then
10309                   Flag_Non_Static_Expr
10310                     ("main subprogram priority is not static!", Arg);
10311                   raise Pragma_Exit;
10312
10313                --  If constraint error, then we already signalled an error
10314
10315                elsif Raises_Constraint_Error (Arg) then
10316                   null;
10317
10318                --  Otherwise check in range
10319
10320                else
10321                   declare
10322                      Val : constant Uint := Expr_Value (Arg);
10323
10324                   begin
10325                      if Val < 0
10326                        or else Val > Expr_Value (Expression
10327                                        (Parent (RTE (RE_Max_Priority))))
10328                      then
10329                         Error_Pragma_Arg
10330                           ("main subprogram priority is out of range", Arg1);
10331                      end if;
10332                   end;
10333                end if;
10334
10335                Set_Main_Priority
10336                     (Current_Sem_Unit, UI_To_Int (Expr_Value (Arg)));
10337
10338                --  Load an arbitrary entity from System.Tasking to make sure
10339                --  this package is implicitly with'ed, since we need to have
10340                --  the tasking run-time active for the pragma Priority to have
10341                --  any effect.
10342
10343                declare
10344                   Discard : Entity_Id;
10345                   pragma Warnings (Off, Discard);
10346                begin
10347                   Discard := RTE (RE_Task_List);
10348                end;
10349
10350             --  Task or Protected, must be of type Integer
10351
10352             elsif Nkind_In (P, N_Protected_Definition, N_Task_Definition) then
10353                Arg := Expression (Arg1);
10354
10355                --  The expression must be analyzed in the special manner
10356                --  described in "Handling of Default and Per-Object
10357                --  Expressions" in sem.ads.
10358
10359                Preanalyze_Spec_Expression (Arg, Standard_Integer);
10360
10361                if not Is_Static_Expression (Arg) then
10362                   Check_Restriction (Static_Priorities, Arg);
10363                end if;
10364
10365             --  Anything else is incorrect
10366
10367             else
10368                Pragma_Misplaced;
10369             end if;
10370
10371             if Has_Priority_Pragma (P) then
10372                Error_Pragma ("duplicate pragma% not allowed");
10373             else
10374                Set_Has_Priority_Pragma (P, True);
10375
10376                if Nkind_In (P, N_Protected_Definition, N_Task_Definition) then
10377                   Record_Rep_Item (Defining_Identifier (Parent (P)), N);
10378                   --  exp_ch9 should use this ???
10379                end if;
10380             end if;
10381          end Priority;
10382
10383          -----------------------------------
10384          -- Priority_Specific_Dispatching --
10385          -----------------------------------
10386
10387          --  pragma Priority_Specific_Dispatching (
10388          --    policy_IDENTIFIER,
10389          --    first_priority_EXPRESSION,
10390          --    last_priority_EXPRESSION);
10391
10392          when Pragma_Priority_Specific_Dispatching =>
10393          Priority_Specific_Dispatching : declare
10394             Prio_Id : constant Entity_Id := RTE (RE_Any_Priority);
10395             --  This is the entity System.Any_Priority;
10396
10397             DP          : Character;
10398             Lower_Bound : Node_Id;
10399             Upper_Bound : Node_Id;
10400             Lower_Val   : Uint;
10401             Upper_Val   : Uint;
10402
10403          begin
10404             Ada_2005_Pragma;
10405             Check_Arg_Count (3);
10406             Check_No_Identifiers;
10407             Check_Arg_Is_Task_Dispatching_Policy (Arg1);
10408             Check_Valid_Configuration_Pragma;
10409             Get_Name_String (Chars (Expression (Arg1)));
10410             DP := Fold_Upper (Name_Buffer (1));
10411
10412             Lower_Bound := Expression (Arg2);
10413             Check_Arg_Is_Static_Expression (Lower_Bound, Standard_Integer);
10414             Lower_Val := Expr_Value (Lower_Bound);
10415
10416             Upper_Bound := Expression (Arg3);
10417             Check_Arg_Is_Static_Expression (Upper_Bound, Standard_Integer);
10418             Upper_Val := Expr_Value (Upper_Bound);
10419
10420             --  It is not allowed to use Task_Dispatching_Policy and
10421             --  Priority_Specific_Dispatching in the same partition.
10422
10423             if Task_Dispatching_Policy /= ' ' then
10424                Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
10425                Error_Pragma
10426                  ("pragma% incompatible with Task_Dispatching_Policy#");
10427
10428             --  Check lower bound in range
10429
10430             elsif Lower_Val < Expr_Value (Type_Low_Bound (Prio_Id))
10431                     or else
10432                   Lower_Val > Expr_Value (Type_High_Bound (Prio_Id))
10433             then
10434                Error_Pragma_Arg
10435                  ("first_priority is out of range", Arg2);
10436
10437             --  Check upper bound in range
10438
10439             elsif Upper_Val < Expr_Value (Type_Low_Bound (Prio_Id))
10440                     or else
10441                   Upper_Val > Expr_Value (Type_High_Bound (Prio_Id))
10442             then
10443                Error_Pragma_Arg
10444                  ("last_priority is out of range", Arg3);
10445
10446             --  Check that the priority range is valid
10447
10448             elsif Lower_Val > Upper_Val then
10449                Error_Pragma
10450                  ("last_priority_expression must be greater than" &
10451                   " or equal to first_priority_expression");
10452
10453             --  Store the new policy, but always preserve System_Location since
10454             --  we like the error message with the run-time name.
10455
10456             else
10457                --  Check overlapping in the priority ranges specified in other
10458                --  Priority_Specific_Dispatching pragmas within the same
10459                --  partition. We can only check those we know about!
10460
10461                for J in
10462                   Specific_Dispatching.First .. Specific_Dispatching.Last
10463                loop
10464                   if Specific_Dispatching.Table (J).First_Priority in
10465                     UI_To_Int (Lower_Val) .. UI_To_Int (Upper_Val)
10466                   or else Specific_Dispatching.Table (J).Last_Priority in
10467                     UI_To_Int (Lower_Val) .. UI_To_Int (Upper_Val)
10468                   then
10469                      Error_Msg_Sloc :=
10470                        Specific_Dispatching.Table (J).Pragma_Loc;
10471                         Error_Pragma
10472                           ("priority range overlaps with "
10473                            & "Priority_Specific_Dispatching#");
10474                   end if;
10475                end loop;
10476
10477                --  The use of Priority_Specific_Dispatching is incompatible
10478                --  with Task_Dispatching_Policy.
10479
10480                if Task_Dispatching_Policy /= ' ' then
10481                   Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
10482                      Error_Pragma
10483                        ("Priority_Specific_Dispatching incompatible "
10484                         & "with Task_Dispatching_Policy#");
10485                end if;
10486
10487                --  The use of Priority_Specific_Dispatching forces ceiling
10488                --  locking policy.
10489
10490                if Locking_Policy /= ' ' and then Locking_Policy /= 'C' then
10491                   Error_Msg_Sloc := Locking_Policy_Sloc;
10492                      Error_Pragma
10493                        ("Priority_Specific_Dispatching incompatible "
10494                         & "with Locking_Policy#");
10495
10496                --  Set the Ceiling_Locking policy, but preserve System_Location
10497                --  since we like the error message with the run time name.
10498
10499                else
10500                   Locking_Policy := 'C';
10501
10502                   if Locking_Policy_Sloc /= System_Location then
10503                      Locking_Policy_Sloc := Loc;
10504                   end if;
10505                end if;
10506
10507                --  Add entry in the table
10508
10509                Specific_Dispatching.Append
10510                     ((Dispatching_Policy => DP,
10511                       First_Priority     => UI_To_Int (Lower_Val),
10512                       Last_Priority      => UI_To_Int (Upper_Val),
10513                       Pragma_Loc         => Loc));
10514             end if;
10515          end Priority_Specific_Dispatching;
10516
10517          -------------
10518          -- Profile --
10519          -------------
10520
10521          --  pragma Profile (profile_IDENTIFIER);
10522
10523          --  profile_IDENTIFIER => Restricted | Ravenscar
10524
10525          when Pragma_Profile =>
10526             Ada_2005_Pragma;
10527             Check_Arg_Count (1);
10528             Check_Valid_Configuration_Pragma;
10529             Check_No_Identifiers;
10530
10531             declare
10532                Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
10533             begin
10534                if Chars (Argx) = Name_Ravenscar then
10535                   Set_Ravenscar_Profile (N);
10536                elsif Chars (Argx) = Name_Restricted then
10537                   Set_Profile_Restrictions
10538                     (Restricted, N, Warn => Treat_Restrictions_As_Warnings);
10539                else
10540                   Error_Pragma_Arg ("& is not a valid profile", Argx);
10541                end if;
10542             end;
10543
10544          ----------------------
10545          -- Profile_Warnings --
10546          ----------------------
10547
10548          --  pragma Profile_Warnings (profile_IDENTIFIER);
10549
10550          --  profile_IDENTIFIER => Restricted | Ravenscar
10551
10552          when Pragma_Profile_Warnings =>
10553             GNAT_Pragma;
10554             Check_Arg_Count (1);
10555             Check_Valid_Configuration_Pragma;
10556             Check_No_Identifiers;
10557
10558             declare
10559                Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
10560             begin
10561                if Chars (Argx) = Name_Ravenscar then
10562                   Set_Profile_Restrictions (Ravenscar, N, Warn => True);
10563                elsif Chars (Argx) = Name_Restricted then
10564                   Set_Profile_Restrictions (Restricted, N, Warn => True);
10565                else
10566                   Error_Pragma_Arg ("& is not a valid profile", Argx);
10567                end if;
10568             end;
10569
10570          --------------------------
10571          -- Propagate_Exceptions --
10572          --------------------------
10573
10574          --  pragma Propagate_Exceptions;
10575
10576          --  Note: this pragma is obsolete and has no effect
10577
10578          when Pragma_Propagate_Exceptions =>
10579             GNAT_Pragma;
10580             Check_Arg_Count (0);
10581
10582             if In_Extended_Main_Source_Unit (N) then
10583                Propagate_Exceptions := True;
10584             end if;
10585
10586          ------------------
10587          -- Psect_Object --
10588          ------------------
10589
10590          --  pragma Psect_Object (
10591          --        [Internal =>] LOCAL_NAME,
10592          --     [, [External =>] EXTERNAL_SYMBOL]
10593          --     [, [Size     =>] EXTERNAL_SYMBOL]);
10594
10595          when Pragma_Psect_Object | Pragma_Common_Object =>
10596          Psect_Object : declare
10597             Args  : Args_List (1 .. 3);
10598             Names : constant Name_List (1 .. 3) := (
10599                       Name_Internal,
10600                       Name_External,
10601                       Name_Size);
10602
10603             Internal : Node_Id renames Args (1);
10604             External : Node_Id renames Args (2);
10605             Size     : Node_Id renames Args (3);
10606
10607             Def_Id : Entity_Id;
10608
10609             procedure Check_Too_Long (Arg : Node_Id);
10610             --  Posts message if the argument is an identifier with more
10611             --  than 31 characters, or a string literal with more than
10612             --  31 characters, and we are operating under VMS
10613
10614             --------------------
10615             -- Check_Too_Long --
10616             --------------------
10617
10618             procedure Check_Too_Long (Arg : Node_Id) is
10619                X : constant Node_Id := Original_Node (Arg);
10620
10621             begin
10622                if not Nkind_In (X, N_String_Literal, N_Identifier) then
10623                   Error_Pragma_Arg
10624                     ("inappropriate argument for pragma %", Arg);
10625                end if;
10626
10627                if OpenVMS_On_Target then
10628                   if (Nkind (X) = N_String_Literal
10629                        and then String_Length (Strval (X)) > 31)
10630                     or else
10631                      (Nkind (X) = N_Identifier
10632                        and then Length_Of_Name (Chars (X)) > 31)
10633                   then
10634                      Error_Pragma_Arg
10635                        ("argument for pragma % is longer than 31 characters",
10636                         Arg);
10637                   end if;
10638                end if;
10639             end Check_Too_Long;
10640
10641          --  Start of processing for Common_Object/Psect_Object
10642
10643          begin
10644             GNAT_Pragma;
10645             Gather_Associations (Names, Args);
10646             Process_Extended_Import_Export_Internal_Arg (Internal);
10647
10648             Def_Id := Entity (Internal);
10649
10650             if not Ekind_In (Def_Id, E_Constant, E_Variable) then
10651                Error_Pragma_Arg
10652                  ("pragma% must designate an object", Internal);
10653             end if;
10654
10655             Check_Too_Long (Internal);
10656
10657             if Is_Imported (Def_Id) or else Is_Exported (Def_Id) then
10658                Error_Pragma_Arg
10659                  ("cannot use pragma% for imported/exported object",
10660                   Internal);
10661             end if;
10662
10663             if Is_Concurrent_Type (Etype (Internal)) then
10664                Error_Pragma_Arg
10665                  ("cannot specify pragma % for task/protected object",
10666                   Internal);
10667             end if;
10668
10669             if Has_Rep_Pragma (Def_Id, Name_Common_Object)
10670                  or else
10671                Has_Rep_Pragma (Def_Id, Name_Psect_Object)
10672             then
10673                Error_Msg_N ("?duplicate Common/Psect_Object pragma", N);
10674             end if;
10675
10676             if Ekind (Def_Id) = E_Constant then
10677                Error_Pragma_Arg
10678                  ("cannot specify pragma % for a constant", Internal);
10679             end if;
10680
10681             if Is_Record_Type (Etype (Internal)) then
10682                declare
10683                   Ent  : Entity_Id;
10684                   Decl : Entity_Id;
10685
10686                begin
10687                   Ent := First_Entity (Etype (Internal));
10688                   while Present (Ent) loop
10689                      Decl := Declaration_Node (Ent);
10690
10691                      if Ekind (Ent) = E_Component
10692                        and then Nkind (Decl) = N_Component_Declaration
10693                        and then Present (Expression (Decl))
10694                        and then Warn_On_Export_Import
10695                      then
10696                         Error_Msg_N
10697                           ("?object for pragma % has defaults", Internal);
10698                         exit;
10699
10700                      else
10701                         Next_Entity (Ent);
10702                      end if;
10703                   end loop;
10704                end;
10705             end if;
10706
10707             if Present (Size) then
10708                Check_Too_Long (Size);
10709             end if;
10710
10711             if Present (External) then
10712                Check_Arg_Is_External_Name (External);
10713                Check_Too_Long (External);
10714             end if;
10715
10716             --  If all error tests pass, link pragma on to the rep item chain
10717
10718             Record_Rep_Item (Def_Id, N);
10719          end Psect_Object;
10720
10721          ----------
10722          -- Pure --
10723          ----------
10724
10725          --  pragma Pure [(library_unit_NAME)];
10726
10727          when Pragma_Pure => Pure : declare
10728             Ent : Entity_Id;
10729
10730          begin
10731             Check_Ada_83_Warning;
10732             Check_Valid_Library_Unit_Pragma;
10733
10734             if Nkind (N) = N_Null_Statement then
10735                return;
10736             end if;
10737
10738             Ent := Find_Lib_Unit_Name;
10739             Set_Is_Pure (Ent);
10740             Set_Has_Pragma_Pure (Ent);
10741             Set_Suppress_Elaboration_Warnings (Ent);
10742          end Pure;
10743
10744          -------------
10745          -- Pure_05 --
10746          -------------
10747
10748          --  pragma Pure_05 [(library_unit_NAME)];
10749
10750          --  This pragma is useable only in GNAT_Mode, where it is used like
10751          --  pragma Pure but it is only effective in Ada 2005 mode (otherwise
10752          --  it is ignored). It may be used after a pragma Preelaborate, in
10753          --  which case it overrides the effect of the pragma Preelaborate.
10754          --  This is used to implement AI-362 which recategorizes some run-time
10755          --  packages in Ada 2005 mode.
10756
10757          when Pragma_Pure_05 => Pure_05 : declare
10758             Ent : Entity_Id;
10759
10760          begin
10761             GNAT_Pragma;
10762             Check_Valid_Library_Unit_Pragma;
10763
10764             if not GNAT_Mode then
10765                Error_Pragma ("pragma% only available in GNAT mode");
10766             end if;
10767
10768             if Nkind (N) = N_Null_Statement then
10769                return;
10770             end if;
10771
10772             --  This is one of the few cases where we need to test the value of
10773             --  Ada_Version_Explicit rather than Ada_Version (which is always
10774             --  set to Ada_12 in a predefined unit), we need to know the
10775             --  explicit version set to know if this pragma is active.
10776
10777             if Ada_Version_Explicit >= Ada_05 then
10778                Ent := Find_Lib_Unit_Name;
10779                Set_Is_Preelaborated (Ent, False);
10780                Set_Is_Pure (Ent);
10781                Set_Suppress_Elaboration_Warnings (Ent);
10782             end if;
10783          end Pure_05;
10784
10785          -------------------
10786          -- Pure_Function --
10787          -------------------
10788
10789          --  pragma Pure_Function ([Entity =>] function_LOCAL_NAME);
10790
10791          when Pragma_Pure_Function => Pure_Function : declare
10792             E_Id      : Node_Id;
10793             E         : Entity_Id;
10794             Def_Id    : Entity_Id;
10795             Effective : Boolean := False;
10796
10797          begin
10798             GNAT_Pragma;
10799             Check_Arg_Count (1);
10800             Check_Optional_Identifier (Arg1, Name_Entity);
10801             Check_Arg_Is_Local_Name (Arg1);
10802             E_Id := Expression (Arg1);
10803
10804             if Error_Posted (E_Id) then
10805                return;
10806             end if;
10807
10808             --  Loop through homonyms (overloadings) of referenced entity
10809
10810             E := Entity (E_Id);
10811
10812             if Present (E) then
10813                loop
10814                   Def_Id := Get_Base_Subprogram (E);
10815
10816                   if not Ekind_In (Def_Id, E_Function,
10817                                            E_Generic_Function,
10818                                            E_Operator)
10819                   then
10820                      Error_Pragma_Arg
10821                        ("pragma% requires a function name", Arg1);
10822                   end if;
10823
10824                   Set_Is_Pure (Def_Id);
10825
10826                   if not Has_Pragma_Pure_Function (Def_Id) then
10827                      Set_Has_Pragma_Pure_Function (Def_Id);
10828                      Effective := True;
10829                   end if;
10830
10831                   E := Homonym (E);
10832                   exit when No (E) or else Scope (E) /= Current_Scope;
10833                end loop;
10834
10835                if not Effective
10836                  and then Warn_On_Redundant_Constructs
10837                then
10838                   Error_Msg_NE
10839                     ("pragma Pure_Function on& is redundant?",
10840                      N, Entity (E_Id));
10841                end if;
10842             end if;
10843          end Pure_Function;
10844
10845          --------------------
10846          -- Queuing_Policy --
10847          --------------------
10848
10849          --  pragma Queuing_Policy (policy_IDENTIFIER);
10850
10851          when Pragma_Queuing_Policy => declare
10852             QP : Character;
10853
10854          begin
10855             Check_Ada_83_Warning;
10856             Check_Arg_Count (1);
10857             Check_No_Identifiers;
10858             Check_Arg_Is_Queuing_Policy (Arg1);
10859             Check_Valid_Configuration_Pragma;
10860             Get_Name_String (Chars (Expression (Arg1)));
10861             QP := Fold_Upper (Name_Buffer (1));
10862
10863             if Queuing_Policy /= ' '
10864               and then Queuing_Policy /= QP
10865             then
10866                Error_Msg_Sloc := Queuing_Policy_Sloc;
10867                Error_Pragma ("queuing policy incompatible with policy#");
10868
10869             --  Set new policy, but always preserve System_Location since we
10870             --  like the error message with the run time name.
10871
10872             else
10873                Queuing_Policy := QP;
10874
10875                if Queuing_Policy_Sloc /= System_Location then
10876                   Queuing_Policy_Sloc := Loc;
10877                end if;
10878             end if;
10879          end;
10880
10881          -----------------------
10882          -- Relative_Deadline --
10883          -----------------------
10884
10885          --  pragma Relative_Deadline (time_span_EXPRESSION);
10886
10887          when Pragma_Relative_Deadline => Relative_Deadline : declare
10888             P   : constant Node_Id := Parent (N);
10889             Arg : Node_Id;
10890
10891          begin
10892             Ada_2005_Pragma;
10893             Check_No_Identifiers;
10894             Check_Arg_Count (1);
10895
10896             Arg := Expression (Arg1);
10897
10898             --  The expression must be analyzed in the special manner described
10899             --  in "Handling of Default and Per-Object Expressions" in sem.ads.
10900
10901             Preanalyze_Spec_Expression (Arg, RTE (RE_Time_Span));
10902
10903             --  Subprogram case
10904
10905             if Nkind (P) = N_Subprogram_Body then
10906                Check_In_Main_Program;
10907
10908             --  Tasks
10909
10910             elsif Nkind (P) = N_Task_Definition then
10911                null;
10912
10913             --  Anything else is incorrect
10914
10915             else
10916                Pragma_Misplaced;
10917             end if;
10918
10919             if Has_Relative_Deadline_Pragma (P) then
10920                Error_Pragma ("duplicate pragma% not allowed");
10921             else
10922                Set_Has_Relative_Deadline_Pragma (P, True);
10923
10924                if Nkind (P) = N_Task_Definition then
10925                   Record_Rep_Item (Defining_Identifier (Parent (P)), N);
10926                end if;
10927             end if;
10928          end Relative_Deadline;
10929
10930          ---------------------------
10931          -- Remote_Call_Interface --
10932          ---------------------------
10933
10934          --  pragma Remote_Call_Interface [(library_unit_NAME)];
10935
10936          when Pragma_Remote_Call_Interface => Remote_Call_Interface : declare
10937             Cunit_Node : Node_Id;
10938             Cunit_Ent  : Entity_Id;
10939             K          : Node_Kind;
10940
10941          begin
10942             Check_Ada_83_Warning;
10943             Check_Valid_Library_Unit_Pragma;
10944
10945             if Nkind (N) = N_Null_Statement then
10946                return;
10947             end if;
10948
10949             Cunit_Node := Cunit (Current_Sem_Unit);
10950             K          := Nkind (Unit (Cunit_Node));
10951             Cunit_Ent  := Cunit_Entity (Current_Sem_Unit);
10952
10953             if K = N_Package_Declaration
10954               or else K = N_Generic_Package_Declaration
10955               or else K = N_Subprogram_Declaration
10956               or else K = N_Generic_Subprogram_Declaration
10957               or else (K = N_Subprogram_Body
10958                          and then Acts_As_Spec (Unit (Cunit_Node)))
10959             then
10960                null;
10961             else
10962                Error_Pragma (
10963                  "pragma% must apply to package or subprogram declaration");
10964             end if;
10965
10966             Set_Is_Remote_Call_Interface (Cunit_Ent);
10967          end Remote_Call_Interface;
10968
10969          ------------------
10970          -- Remote_Types --
10971          ------------------
10972
10973          --  pragma Remote_Types [(library_unit_NAME)];
10974
10975          when Pragma_Remote_Types => Remote_Types : declare
10976             Cunit_Node : Node_Id;
10977             Cunit_Ent  : Entity_Id;
10978
10979          begin
10980             Check_Ada_83_Warning;
10981             Check_Valid_Library_Unit_Pragma;
10982
10983             if Nkind (N) = N_Null_Statement then
10984                return;
10985             end if;
10986
10987             Cunit_Node := Cunit (Current_Sem_Unit);
10988             Cunit_Ent  := Cunit_Entity (Current_Sem_Unit);
10989
10990             if not Nkind_In (Unit (Cunit_Node), N_Package_Declaration,
10991                                                 N_Generic_Package_Declaration)
10992             then
10993                Error_Pragma
10994                  ("pragma% can only apply to a package declaration");
10995             end if;
10996
10997             Set_Is_Remote_Types (Cunit_Ent);
10998          end Remote_Types;
10999
11000          ---------------
11001          -- Ravenscar --
11002          ---------------
11003
11004          --  pragma Ravenscar;
11005
11006          when Pragma_Ravenscar =>
11007             GNAT_Pragma;
11008             Check_Arg_Count (0);
11009             Check_Valid_Configuration_Pragma;
11010             Set_Ravenscar_Profile (N);
11011
11012             if Warn_On_Obsolescent_Feature then
11013                Error_Msg_N ("pragma Ravenscar is an obsolescent feature?", N);
11014                Error_Msg_N ("|use pragma Profile (Ravenscar) instead", N);
11015             end if;
11016
11017          -------------------------
11018          -- Restricted_Run_Time --
11019          -------------------------
11020
11021          --  pragma Restricted_Run_Time;
11022
11023          when Pragma_Restricted_Run_Time =>
11024             GNAT_Pragma;
11025             Check_Arg_Count (0);
11026             Check_Valid_Configuration_Pragma;
11027             Set_Profile_Restrictions
11028               (Restricted, N, Warn => Treat_Restrictions_As_Warnings);
11029
11030             if Warn_On_Obsolescent_Feature then
11031                Error_Msg_N
11032                  ("pragma Restricted_Run_Time is an obsolescent feature?", N);
11033                Error_Msg_N ("|use pragma Profile (Restricted) instead", N);
11034             end if;
11035
11036          ------------------
11037          -- Restrictions --
11038          ------------------
11039
11040          --  pragma Restrictions (RESTRICTION {, RESTRICTION});
11041
11042          --  RESTRICTION ::=
11043          --    restriction_IDENTIFIER
11044          --  | restriction_parameter_IDENTIFIER => EXPRESSION
11045
11046          when Pragma_Restrictions =>
11047             Process_Restrictions_Or_Restriction_Warnings
11048               (Warn => Treat_Restrictions_As_Warnings);
11049
11050          --------------------------
11051          -- Restriction_Warnings --
11052          --------------------------
11053
11054          --  pragma Restriction_Warnings (RESTRICTION {, RESTRICTION});
11055
11056          --  RESTRICTION ::=
11057          --    restriction_IDENTIFIER
11058          --  | restriction_parameter_IDENTIFIER => EXPRESSION
11059
11060          when Pragma_Restriction_Warnings =>
11061             GNAT_Pragma;
11062             Process_Restrictions_Or_Restriction_Warnings (Warn => True);
11063
11064          ----------------
11065          -- Reviewable --
11066          ----------------
11067
11068          --  pragma Reviewable;
11069
11070          when Pragma_Reviewable =>
11071             Check_Ada_83_Warning;
11072             Check_Arg_Count (0);
11073
11074             --  Call dummy debugging function rv. This is done to assist front
11075             --  end debugging. By placing a Reviewable pragma in the source
11076             --  program, a breakpoint on rv catches this place in the source,
11077             --  allowing convenient stepping to the point of interest.
11078
11079             rv;
11080
11081          --------------------------
11082          -- Short_Circuit_And_Or --
11083          --------------------------
11084
11085          when Pragma_Short_Circuit_And_Or =>
11086             GNAT_Pragma;
11087             Check_Arg_Count (0);
11088             Check_Valid_Configuration_Pragma;
11089             Short_Circuit_And_Or := True;
11090
11091          -------------------
11092          -- Share_Generic --
11093          -------------------
11094
11095          --  pragma Share_Generic (NAME {, NAME});
11096
11097          when Pragma_Share_Generic =>
11098             GNAT_Pragma;
11099             Process_Generic_List;
11100
11101          ------------
11102          -- Shared --
11103          ------------
11104
11105          --  pragma Shared (LOCAL_NAME);
11106
11107          when Pragma_Shared =>
11108             GNAT_Pragma;
11109             Process_Atomic_Shared_Volatile;
11110
11111          --------------------
11112          -- Shared_Passive --
11113          --------------------
11114
11115          --  pragma Shared_Passive [(library_unit_NAME)];
11116
11117          --  Set the flag Is_Shared_Passive of program unit name entity
11118
11119          when Pragma_Shared_Passive => Shared_Passive : declare
11120             Cunit_Node : Node_Id;
11121             Cunit_Ent  : Entity_Id;
11122
11123          begin
11124             Check_Ada_83_Warning;
11125             Check_Valid_Library_Unit_Pragma;
11126
11127             if Nkind (N) = N_Null_Statement then
11128                return;
11129             end if;
11130
11131             Cunit_Node := Cunit (Current_Sem_Unit);
11132             Cunit_Ent  := Cunit_Entity (Current_Sem_Unit);
11133
11134             if not Nkind_In (Unit (Cunit_Node), N_Package_Declaration,
11135                                                 N_Generic_Package_Declaration)
11136             then
11137                Error_Pragma
11138                  ("pragma% can only apply to a package declaration");
11139             end if;
11140
11141             Set_Is_Shared_Passive (Cunit_Ent);
11142          end Shared_Passive;
11143
11144          -----------------------
11145          -- Short_Descriptors --
11146          -----------------------
11147
11148          --  pragma Short_Descriptors;
11149
11150          when Pragma_Short_Descriptors =>
11151             GNAT_Pragma;
11152             Check_Arg_Count (0);
11153             Check_Valid_Configuration_Pragma;
11154             Short_Descriptors := True;
11155
11156          ----------------------
11157          -- Source_File_Name --
11158          ----------------------
11159
11160          --  There are five forms for this pragma:
11161
11162          --  pragma Source_File_Name (
11163          --    [UNIT_NAME      =>] unit_NAME,
11164          --     BODY_FILE_NAME =>  STRING_LITERAL
11165          --    [, [INDEX =>] INTEGER_LITERAL]);
11166
11167          --  pragma Source_File_Name (
11168          --    [UNIT_NAME      =>] unit_NAME,
11169          --     SPEC_FILE_NAME =>  STRING_LITERAL
11170          --    [, [INDEX =>] INTEGER_LITERAL]);
11171
11172          --  pragma Source_File_Name (
11173          --     BODY_FILE_NAME  => STRING_LITERAL
11174          --  [, DOT_REPLACEMENT => STRING_LITERAL]
11175          --  [, CASING          => CASING_SPEC]);
11176
11177          --  pragma Source_File_Name (
11178          --     SPEC_FILE_NAME  => STRING_LITERAL
11179          --  [, DOT_REPLACEMENT => STRING_LITERAL]
11180          --  [, CASING          => CASING_SPEC]);
11181
11182          --  pragma Source_File_Name (
11183          --     SUBUNIT_FILE_NAME  => STRING_LITERAL
11184          --  [, DOT_REPLACEMENT    => STRING_LITERAL]
11185          --  [, CASING             => CASING_SPEC]);
11186
11187          --  CASING_SPEC ::= Uppercase | Lowercase | Mixedcase
11188
11189          --  Pragma Source_File_Name_Project (SFNP) is equivalent to pragma
11190          --  Source_File_Name (SFN), however their usage is exclusive: SFN can
11191          --  only be used when no project file is used, while SFNP can only be
11192          --  used when a project file is used.
11193
11194          --  No processing here. Processing was completed during parsing, since
11195          --  we need to have file names set as early as possible. Units are
11196          --  loaded well before semantic processing starts.
11197
11198          --  The only processing we defer to this point is the check for
11199          --  correct placement.
11200
11201          when Pragma_Source_File_Name =>
11202             GNAT_Pragma;
11203             Check_Valid_Configuration_Pragma;
11204
11205          ------------------------------
11206          -- Source_File_Name_Project --
11207          ------------------------------
11208
11209          --  See Source_File_Name for syntax
11210
11211          --  No processing here. Processing was completed during parsing, since
11212          --  we need to have file names set as early as possible. Units are
11213          --  loaded well before semantic processing starts.
11214
11215          --  The only processing we defer to this point is the check for
11216          --  correct placement.
11217
11218          when Pragma_Source_File_Name_Project =>
11219             GNAT_Pragma;
11220             Check_Valid_Configuration_Pragma;
11221
11222             --  Check that a pragma Source_File_Name_Project is used only in a
11223             --  configuration pragmas file.
11224
11225             --  Pragmas Source_File_Name_Project should only be generated by
11226             --  the Project Manager in configuration pragmas files.
11227
11228             --  This is really an ugly test. It seems to depend on some
11229             --  accidental and undocumented property. At the very least it
11230             --  needs to be documented, but it would be better to have a
11231             --  clean way of testing if we are in a configuration file???
11232
11233             if Present (Parent (N)) then
11234                Error_Pragma
11235                  ("pragma% can only appear in a configuration pragmas file");
11236             end if;
11237
11238          ----------------------
11239          -- Source_Reference --
11240          ----------------------
11241
11242          --  pragma Source_Reference (INTEGER_LITERAL [, STRING_LITERAL]);
11243
11244          --  Nothing to do, all processing completed in Par.Prag, since we need
11245          --  the information for possible parser messages that are output.
11246
11247          when Pragma_Source_Reference =>
11248             GNAT_Pragma;
11249
11250          --------------------------------
11251          -- Static_Elaboration_Desired --
11252          --------------------------------
11253
11254          --  pragma Static_Elaboration_Desired (DIRECT_NAME);
11255
11256          when Pragma_Static_Elaboration_Desired =>
11257             GNAT_Pragma;
11258             Check_At_Most_N_Arguments (1);
11259
11260             if Is_Compilation_Unit (Current_Scope)
11261               and then Ekind (Current_Scope) = E_Package
11262             then
11263                Set_Static_Elaboration_Desired (Current_Scope, True);
11264             else
11265                Error_Pragma ("pragma% must apply to a library-level package");
11266             end if;
11267
11268          ------------------
11269          -- Storage_Size --
11270          ------------------
11271
11272          --  pragma Storage_Size (EXPRESSION);
11273
11274          when Pragma_Storage_Size => Storage_Size : declare
11275             P   : constant Node_Id := Parent (N);
11276             Arg : Node_Id;
11277
11278          begin
11279             Check_No_Identifiers;
11280             Check_Arg_Count (1);
11281
11282             --  The expression must be analyzed in the special manner described
11283             --  in "Handling of Default Expressions" in sem.ads.
11284
11285             Arg := Expression (Arg1);
11286             Preanalyze_Spec_Expression (Arg, Any_Integer);
11287
11288             if not Is_Static_Expression (Arg) then
11289                Check_Restriction (Static_Storage_Size, Arg);
11290             end if;
11291
11292             if Nkind (P) /= N_Task_Definition then
11293                Pragma_Misplaced;
11294                return;
11295
11296             else
11297                if Has_Storage_Size_Pragma (P) then
11298                   Error_Pragma ("duplicate pragma% not allowed");
11299                else
11300                   Set_Has_Storage_Size_Pragma (P, True);
11301                end if;
11302
11303                Record_Rep_Item (Defining_Identifier (Parent (P)), N);
11304                --  ???  exp_ch9 should use this!
11305             end if;
11306          end Storage_Size;
11307
11308          ------------------
11309          -- Storage_Unit --
11310          ------------------
11311
11312          --  pragma Storage_Unit (NUMERIC_LITERAL);
11313
11314          --  Only permitted argument is System'Storage_Unit value
11315
11316          when Pragma_Storage_Unit =>
11317             Check_No_Identifiers;
11318             Check_Arg_Count (1);
11319             Check_Arg_Is_Integer_Literal (Arg1);
11320
11321             if Intval (Expression (Arg1)) /=
11322               UI_From_Int (Ttypes.System_Storage_Unit)
11323             then
11324                Error_Msg_Uint_1 := UI_From_Int (Ttypes.System_Storage_Unit);
11325                Error_Pragma_Arg
11326                  ("the only allowed argument for pragma% is ^", Arg1);
11327             end if;
11328
11329          --------------------
11330          -- Stream_Convert --
11331          --------------------
11332
11333          --  pragma Stream_Convert (
11334          --    [Entity =>] type_LOCAL_NAME,
11335          --    [Read   =>] function_NAME,
11336          --    [Write  =>] function NAME);
11337
11338          when Pragma_Stream_Convert => Stream_Convert : declare
11339
11340             procedure Check_OK_Stream_Convert_Function (Arg : Node_Id);
11341             --  Check that the given argument is the name of a local function
11342             --  of one argument that is not overloaded earlier in the current
11343             --  local scope. A check is also made that the argument is a
11344             --  function with one parameter.
11345
11346             --------------------------------------
11347             -- Check_OK_Stream_Convert_Function --
11348             --------------------------------------
11349
11350             procedure Check_OK_Stream_Convert_Function (Arg : Node_Id) is
11351                Ent : Entity_Id;
11352
11353             begin
11354                Check_Arg_Is_Local_Name (Arg);
11355                Ent := Entity (Expression (Arg));
11356
11357                if Has_Homonym (Ent) then
11358                   Error_Pragma_Arg
11359                     ("argument for pragma% may not be overloaded", Arg);
11360                end if;
11361
11362                if Ekind (Ent) /= E_Function
11363                  or else No (First_Formal (Ent))
11364                  or else Present (Next_Formal (First_Formal (Ent)))
11365                then
11366                   Error_Pragma_Arg
11367                     ("argument for pragma% must be" &
11368                      " function of one argument", Arg);
11369                end if;
11370             end Check_OK_Stream_Convert_Function;
11371
11372          --  Start of processing for Stream_Convert
11373
11374          begin
11375             GNAT_Pragma;
11376             Check_Arg_Order ((Name_Entity, Name_Read, Name_Write));
11377             Check_Arg_Count (3);
11378             Check_Optional_Identifier (Arg1, Name_Entity);
11379             Check_Optional_Identifier (Arg2, Name_Read);
11380             Check_Optional_Identifier (Arg3, Name_Write);
11381             Check_Arg_Is_Local_Name (Arg1);
11382             Check_OK_Stream_Convert_Function (Arg2);
11383             Check_OK_Stream_Convert_Function (Arg3);
11384
11385             declare
11386                Typ   : constant Entity_Id :=
11387                          Underlying_Type (Entity (Expression (Arg1)));
11388                Read  : constant Entity_Id := Entity (Expression (Arg2));
11389                Write : constant Entity_Id := Entity (Expression (Arg3));
11390
11391             begin
11392                Check_First_Subtype (Arg1);
11393
11394                --  Check for too early or too late. Note that we don't enforce
11395                --  the rule about primitive operations in this case, since, as
11396                --  is the case for explicit stream attributes themselves, these
11397                --  restrictions are not appropriate. Note that the chaining of
11398                --  the pragma by Rep_Item_Too_Late is actually the critical
11399                --  processing done for this pragma.
11400
11401                if Rep_Item_Too_Early (Typ, N)
11402                     or else
11403                   Rep_Item_Too_Late (Typ, N, FOnly => True)
11404                then
11405                   return;
11406                end if;
11407
11408                --  Return if previous error
11409
11410                if Etype (Typ) = Any_Type
11411                     or else
11412                   Etype (Read) = Any_Type
11413                     or else
11414                   Etype (Write) = Any_Type
11415                then
11416                   return;
11417                end if;
11418
11419                --  Error checks
11420
11421                if Underlying_Type (Etype (Read)) /= Typ then
11422                   Error_Pragma_Arg
11423                     ("incorrect return type for function&", Arg2);
11424                end if;
11425
11426                if Underlying_Type (Etype (First_Formal (Write))) /= Typ then
11427                   Error_Pragma_Arg
11428                     ("incorrect parameter type for function&", Arg3);
11429                end if;
11430
11431                if Underlying_Type (Etype (First_Formal (Read))) /=
11432                   Underlying_Type (Etype (Write))
11433                then
11434                   Error_Pragma_Arg
11435                     ("result type of & does not match Read parameter type",
11436                      Arg3);
11437                end if;
11438             end;
11439          end Stream_Convert;
11440
11441          -------------------------
11442          -- Style_Checks (GNAT) --
11443          -------------------------
11444
11445          --  pragma Style_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
11446
11447          --  This is processed by the parser since some of the style checks
11448          --  take place during source scanning and parsing. This means that
11449          --  we don't need to issue error messages here.
11450
11451          when Pragma_Style_Checks => Style_Checks : declare
11452             A  : constant Node_Id   := Expression (Arg1);
11453             S  : String_Id;
11454             C  : Char_Code;
11455
11456          begin
11457             GNAT_Pragma;
11458             Check_No_Identifiers;
11459
11460             --  Two argument form
11461
11462             if Arg_Count = 2 then
11463                Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
11464
11465                declare
11466                   E_Id : Node_Id;
11467                   E    : Entity_Id;
11468
11469                begin
11470                   E_Id := Expression (Arg2);
11471                   Analyze (E_Id);
11472
11473                   if not Is_Entity_Name (E_Id) then
11474                      Error_Pragma_Arg
11475                        ("second argument of pragma% must be entity name",
11476                         Arg2);
11477                   end if;
11478
11479                   E := Entity (E_Id);
11480
11481                   if E = Any_Id then
11482                      return;
11483                   else
11484                      loop
11485                         Set_Suppress_Style_Checks (E,
11486                           (Chars (Expression (Arg1)) = Name_Off));
11487                         exit when No (Homonym (E));
11488                         E := Homonym (E);
11489                      end loop;
11490                   end if;
11491                end;
11492
11493             --  One argument form
11494
11495             else
11496                Check_Arg_Count (1);
11497
11498                if Nkind (A) = N_String_Literal then
11499                   S   := Strval (A);
11500
11501                   declare
11502                      Slen    : constant Natural := Natural (String_Length (S));
11503                      Options : String (1 .. Slen);
11504                      J       : Natural;
11505
11506                   begin
11507                      J := 1;
11508                      loop
11509                         C := Get_String_Char (S, Int (J));
11510                         exit when not In_Character_Range (C);
11511                         Options (J) := Get_Character (C);
11512
11513                         --  If at end of string, set options. As per discussion
11514                         --  above, no need to check for errors, since we issued
11515                         --  them in the parser.
11516
11517                         if J = Slen then
11518                            Set_Style_Check_Options (Options);
11519                            exit;
11520                         end if;
11521
11522                         J := J + 1;
11523                      end loop;
11524                   end;
11525
11526                elsif Nkind (A) = N_Identifier then
11527                   if Chars (A) = Name_All_Checks then
11528                      if GNAT_Mode then
11529                         Set_GNAT_Style_Check_Options;
11530                      else
11531                         Set_Default_Style_Check_Options;
11532                      end if;
11533
11534                   elsif Chars (A) = Name_On then
11535                      Style_Check := True;
11536
11537                   elsif Chars (A) = Name_Off then
11538                      Style_Check := False;
11539                   end if;
11540                end if;
11541             end if;
11542          end Style_Checks;
11543
11544          --------------
11545          -- Subtitle --
11546          --------------
11547
11548          --  pragma Subtitle ([Subtitle =>] STRING_LITERAL);
11549
11550          when Pragma_Subtitle =>
11551             GNAT_Pragma;
11552             Check_Arg_Count (1);
11553             Check_Optional_Identifier (Arg1, Name_Subtitle);
11554             Check_Arg_Is_Static_Expression (Arg1, Standard_String);
11555             Store_Note (N);
11556
11557          --------------
11558          -- Suppress --
11559          --------------
11560
11561          --  pragma Suppress (IDENTIFIER [, [On =>] NAME]);
11562
11563          when Pragma_Suppress =>
11564             Process_Suppress_Unsuppress (True);
11565
11566          ------------------
11567          -- Suppress_All --
11568          ------------------
11569
11570          --  pragma Suppress_All;
11571
11572          --  The only check made here is that the pragma appears in the proper
11573          --  place, i.e. following a compilation unit. If indeed it appears in
11574          --  this context, then the parser has already inserted an equivalent
11575          --  pragma Suppress (All_Checks) to get the required effect.
11576
11577          when Pragma_Suppress_All =>
11578             GNAT_Pragma;
11579             Check_Arg_Count (0);
11580
11581             if Nkind (Parent (N)) /= N_Compilation_Unit_Aux
11582               or else not Is_List_Member (N)
11583               or else List_Containing (N) /= Pragmas_After (Parent (N))
11584             then
11585                Error_Pragma
11586                  ("misplaced pragma%, must follow compilation unit");
11587             end if;
11588
11589          -------------------------
11590          -- Suppress_Debug_Info --
11591          -------------------------
11592
11593          --  pragma Suppress_Debug_Info ([Entity =>] LOCAL_NAME);
11594
11595          when Pragma_Suppress_Debug_Info =>
11596             GNAT_Pragma;
11597             Check_Arg_Count (1);
11598             Check_Optional_Identifier (Arg1, Name_Entity);
11599             Check_Arg_Is_Local_Name (Arg1);
11600             Set_Debug_Info_Off (Entity (Get_Pragma_Arg (Arg1)));
11601
11602          ----------------------------------
11603          -- Suppress_Exception_Locations --
11604          ----------------------------------
11605
11606          --  pragma Suppress_Exception_Locations;
11607
11608          when Pragma_Suppress_Exception_Locations =>
11609             GNAT_Pragma;
11610             Check_Arg_Count (0);
11611             Check_Valid_Configuration_Pragma;
11612             Exception_Locations_Suppressed := True;
11613
11614          -----------------------------
11615          -- Suppress_Initialization --
11616          -----------------------------
11617
11618          --  pragma Suppress_Initialization ([Entity =>] type_Name);
11619
11620          when Pragma_Suppress_Initialization => Suppress_Init : declare
11621             E_Id : Node_Id;
11622             E    : Entity_Id;
11623
11624          begin
11625             GNAT_Pragma;
11626             Check_Arg_Count (1);
11627             Check_Optional_Identifier (Arg1, Name_Entity);
11628             Check_Arg_Is_Local_Name (Arg1);
11629
11630             E_Id := Expression (Arg1);
11631
11632             if Etype (E_Id) = Any_Type then
11633                return;
11634             end if;
11635
11636             E := Entity (E_Id);
11637
11638             if Is_Type (E) then
11639                if Is_Incomplete_Or_Private_Type (E) then
11640                   if No (Full_View (Base_Type (E))) then
11641                      Error_Pragma_Arg
11642                        ("argument of pragma% cannot be an incomplete type",
11643                          Arg1);
11644                   else
11645                      Set_Suppress_Init_Proc (Full_View (Base_Type (E)));
11646                   end if;
11647                else
11648                   Set_Suppress_Init_Proc (Base_Type (E));
11649                end if;
11650
11651             else
11652                Error_Pragma_Arg
11653                  ("pragma% requires argument that is a type name", Arg1);
11654             end if;
11655          end Suppress_Init;
11656
11657          -----------------
11658          -- System_Name --
11659          -----------------
11660
11661          --  pragma System_Name (DIRECT_NAME);
11662
11663          --  Syntax check: one argument, which must be the identifier GNAT or
11664          --  the identifier GCC, no other identifiers are acceptable.
11665
11666          when Pragma_System_Name =>
11667             GNAT_Pragma;
11668             Check_No_Identifiers;
11669             Check_Arg_Count (1);
11670             Check_Arg_Is_One_Of (Arg1, Name_Gcc, Name_Gnat);
11671
11672          -----------------------------
11673          -- Task_Dispatching_Policy --
11674          -----------------------------
11675
11676          --  pragma Task_Dispatching_Policy (policy_IDENTIFIER);
11677
11678          when Pragma_Task_Dispatching_Policy => declare
11679             DP : Character;
11680
11681          begin
11682             Check_Ada_83_Warning;
11683             Check_Arg_Count (1);
11684             Check_No_Identifiers;
11685             Check_Arg_Is_Task_Dispatching_Policy (Arg1);
11686             Check_Valid_Configuration_Pragma;
11687             Get_Name_String (Chars (Expression (Arg1)));
11688             DP := Fold_Upper (Name_Buffer (1));
11689
11690             if Task_Dispatching_Policy /= ' '
11691               and then Task_Dispatching_Policy /= DP
11692             then
11693                Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
11694                Error_Pragma
11695                  ("task dispatching policy incompatible with policy#");
11696
11697             --  Set new policy, but always preserve System_Location since we
11698             --  like the error message with the run time name.
11699
11700             else
11701                Task_Dispatching_Policy := DP;
11702
11703                if Task_Dispatching_Policy_Sloc /= System_Location then
11704                   Task_Dispatching_Policy_Sloc := Loc;
11705                end if;
11706             end if;
11707          end;
11708
11709          --------------
11710          -- Task_Info --
11711          --------------
11712
11713          --  pragma Task_Info (EXPRESSION);
11714
11715          when Pragma_Task_Info => Task_Info : declare
11716             P : constant Node_Id := Parent (N);
11717
11718          begin
11719             GNAT_Pragma;
11720
11721             if Nkind (P) /= N_Task_Definition then
11722                Error_Pragma ("pragma% must appear in task definition");
11723             end if;
11724
11725             Check_No_Identifiers;
11726             Check_Arg_Count (1);
11727
11728             Analyze_And_Resolve (Expression (Arg1), RTE (RE_Task_Info_Type));
11729
11730             if Etype (Expression (Arg1)) = Any_Type then
11731                return;
11732             end if;
11733
11734             if Has_Task_Info_Pragma (P) then
11735                Error_Pragma ("duplicate pragma% not allowed");
11736             else
11737                Set_Has_Task_Info_Pragma (P, True);
11738             end if;
11739          end Task_Info;
11740
11741          ---------------
11742          -- Task_Name --
11743          ---------------
11744
11745          --  pragma Task_Name (string_EXPRESSION);
11746
11747          when Pragma_Task_Name => Task_Name : declare
11748             P   : constant Node_Id := Parent (N);
11749             Arg : Node_Id;
11750
11751          begin
11752             Check_No_Identifiers;
11753             Check_Arg_Count (1);
11754
11755             Arg := Expression (Arg1);
11756
11757             --  The expression is used in the call to Create_Task, and must be
11758             --  expanded there, not in the context of the current spec. It must
11759             --  however be analyzed to capture global references, in case it
11760             --  appears in a generic context.
11761
11762             Preanalyze_And_Resolve (Arg, Standard_String);
11763
11764             if Nkind (P) /= N_Task_Definition then
11765                Pragma_Misplaced;
11766             end if;
11767
11768             if Has_Task_Name_Pragma (P) then
11769                Error_Pragma ("duplicate pragma% not allowed");
11770             else
11771                Set_Has_Task_Name_Pragma (P, True);
11772                Record_Rep_Item (Defining_Identifier (Parent (P)), N);
11773             end if;
11774          end Task_Name;
11775
11776          ------------------
11777          -- Task_Storage --
11778          ------------------
11779
11780          --  pragma Task_Storage (
11781          --     [Task_Type =>] LOCAL_NAME,
11782          --     [Top_Guard =>] static_integer_EXPRESSION);
11783
11784          when Pragma_Task_Storage => Task_Storage : declare
11785             Args  : Args_List (1 .. 2);
11786             Names : constant Name_List (1 .. 2) := (
11787                       Name_Task_Type,
11788                       Name_Top_Guard);
11789
11790             Task_Type : Node_Id renames Args (1);
11791             Top_Guard : Node_Id renames Args (2);
11792
11793             Ent : Entity_Id;
11794
11795          begin
11796             GNAT_Pragma;
11797             Gather_Associations (Names, Args);
11798
11799             if No (Task_Type) then
11800                Error_Pragma
11801                  ("missing task_type argument for pragma%");
11802             end if;
11803
11804             Check_Arg_Is_Local_Name (Task_Type);
11805
11806             Ent := Entity (Task_Type);
11807
11808             if not Is_Task_Type (Ent) then
11809                Error_Pragma_Arg
11810                  ("argument for pragma% must be task type", Task_Type);
11811             end if;
11812
11813             if No (Top_Guard) then
11814                Error_Pragma_Arg
11815                  ("pragma% takes two arguments", Task_Type);
11816             else
11817                Check_Arg_Is_Static_Expression (Top_Guard, Any_Integer);
11818             end if;
11819
11820             Check_First_Subtype (Task_Type);
11821
11822             if Rep_Item_Too_Late (Ent, N) then
11823                raise Pragma_Exit;
11824             end if;
11825          end Task_Storage;
11826
11827          --------------------------
11828          -- Thread_Local_Storage --
11829          --------------------------
11830
11831          --  pragma Thread_Local_Storage ([Entity =>] LOCAL_NAME);
11832
11833          when Pragma_Thread_Local_Storage => Thread_Local_Storage : declare
11834             Id : Node_Id;
11835             E  : Entity_Id;
11836
11837          begin
11838             GNAT_Pragma;
11839             Check_Arg_Count (1);
11840             Check_Optional_Identifier (Arg1, Name_Entity);
11841             Check_Arg_Is_Library_Level_Local_Name (Arg1);
11842
11843             Id := Expression (Arg1);
11844             Analyze (Id);
11845
11846             if not Is_Entity_Name (Id)
11847               or else Ekind (Entity (Id)) /= E_Variable
11848             then
11849                Error_Pragma_Arg ("local variable name required", Arg1);
11850             end if;
11851
11852             E := Entity (Id);
11853
11854             if Rep_Item_Too_Early (E, N)
11855               or else Rep_Item_Too_Late (E, N)
11856             then
11857                raise Pragma_Exit;
11858             end if;
11859
11860             Set_Has_Pragma_Thread_Local_Storage (E);
11861             Set_Has_Gigi_Rep_Item (E);
11862          end Thread_Local_Storage;
11863
11864          ----------------
11865          -- Time_Slice --
11866          ----------------
11867
11868          --  pragma Time_Slice (static_duration_EXPRESSION);
11869
11870          when Pragma_Time_Slice => Time_Slice : declare
11871             Val : Ureal;
11872             Nod : Node_Id;
11873
11874          begin
11875             GNAT_Pragma;
11876             Check_Arg_Count (1);
11877             Check_No_Identifiers;
11878             Check_In_Main_Program;
11879             Check_Arg_Is_Static_Expression (Arg1, Standard_Duration);
11880
11881             if not Error_Posted (Arg1) then
11882                Nod := Next (N);
11883                while Present (Nod) loop
11884                   if Nkind (Nod) = N_Pragma
11885                     and then Pragma_Name (Nod) = Name_Time_Slice
11886                   then
11887                      Error_Msg_Name_1 := Pname;
11888                      Error_Msg_N ("duplicate pragma% not permitted", Nod);
11889                   end if;
11890
11891                   Next (Nod);
11892                end loop;
11893             end if;
11894
11895             --  Process only if in main unit
11896
11897             if Get_Source_Unit (Loc) = Main_Unit then
11898                Opt.Time_Slice_Set := True;
11899                Val := Expr_Value_R (Expression (Arg1));
11900
11901                if Val <= Ureal_0 then
11902                   Opt.Time_Slice_Value := 0;
11903
11904                elsif Val > UR_From_Uint (UI_From_Int (1000)) then
11905                   Opt.Time_Slice_Value := 1_000_000_000;
11906
11907                else
11908                   Opt.Time_Slice_Value :=
11909                     UI_To_Int (UR_To_Uint (Val * UI_From_Int (1_000_000)));
11910                end if;
11911             end if;
11912          end Time_Slice;
11913
11914          -----------
11915          -- Title --
11916          -----------
11917
11918          --  pragma Title (TITLING_OPTION [, TITLING OPTION]);
11919
11920          --   TITLING_OPTION ::=
11921          --     [Title =>] STRING_LITERAL
11922          --   | [Subtitle =>] STRING_LITERAL
11923
11924          when Pragma_Title => Title : declare
11925             Args  : Args_List (1 .. 2);
11926             Names : constant Name_List (1 .. 2) := (
11927                       Name_Title,
11928                       Name_Subtitle);
11929
11930          begin
11931             GNAT_Pragma;
11932             Gather_Associations (Names, Args);
11933             Store_Note (N);
11934
11935             for J in 1 .. 2 loop
11936                if Present (Args (J)) then
11937                   Check_Arg_Is_Static_Expression (Args (J), Standard_String);
11938                end if;
11939             end loop;
11940          end Title;
11941
11942          ---------------------
11943          -- Unchecked_Union --
11944          ---------------------
11945
11946          --  pragma Unchecked_Union (first_subtype_LOCAL_NAME)
11947
11948          when Pragma_Unchecked_Union => Unchecked_Union : declare
11949             Assoc   : constant Node_Id := Arg1;
11950             Type_Id : constant Node_Id := Expression (Assoc);
11951             Typ     : Entity_Id;
11952             Discr   : Entity_Id;
11953             Tdef    : Node_Id;
11954             Clist   : Node_Id;
11955             Vpart   : Node_Id;
11956             Comp    : Node_Id;
11957             Variant : Node_Id;
11958
11959          begin
11960             Ada_2005_Pragma;
11961             Check_No_Identifiers;
11962             Check_Arg_Count (1);
11963             Check_Arg_Is_Local_Name (Arg1);
11964
11965             Find_Type (Type_Id);
11966             Typ := Entity (Type_Id);
11967
11968             if Typ = Any_Type
11969               or else Rep_Item_Too_Early (Typ, N)
11970             then
11971                return;
11972             else
11973                Typ := Underlying_Type (Typ);
11974             end if;
11975
11976             if Rep_Item_Too_Late (Typ, N) then
11977                return;
11978             end if;
11979
11980             Check_First_Subtype (Arg1);
11981
11982             --  Note remaining cases are references to a type in the current
11983             --  declarative part. If we find an error, we post the error on
11984             --  the relevant type declaration at an appropriate point.
11985
11986             if not Is_Record_Type (Typ) then
11987                Error_Msg_N ("Unchecked_Union must be record type", Typ);
11988                return;
11989
11990             elsif Is_Tagged_Type (Typ) then
11991                Error_Msg_N ("Unchecked_Union must not be tagged", Typ);
11992                return;
11993
11994             elsif Is_Limited_Type (Typ) then
11995                Error_Msg_N
11996                  ("Unchecked_Union must not be limited record type", Typ);
11997                Explain_Limited_Type (Typ, Typ);
11998                return;
11999
12000             else
12001                if not Has_Discriminants (Typ) then
12002                   Error_Msg_N
12003                     ("Unchecked_Union must have one discriminant", Typ);
12004                   return;
12005                end if;
12006
12007                Discr := First_Discriminant (Typ);
12008                while Present (Discr) loop
12009                   if No (Discriminant_Default_Value (Discr)) then
12010                      Error_Msg_N
12011                        ("Unchecked_Union discriminant must have default value",
12012                         Discr);
12013                   end if;
12014                   Next_Discriminant (Discr);
12015                end loop;
12016
12017                Tdef  := Type_Definition (Declaration_Node (Typ));
12018                Clist := Component_List (Tdef);
12019
12020                Comp := First (Component_Items (Clist));
12021                while Present (Comp) loop
12022                   Check_Component (Comp, Typ);
12023                   Next (Comp);
12024                end loop;
12025
12026                if No (Clist) or else No (Variant_Part (Clist)) then
12027                   Error_Msg_N
12028                     ("Unchecked_Union must have variant part",
12029                      Tdef);
12030                   return;
12031                end if;
12032
12033                Vpart := Variant_Part (Clist);
12034
12035                Variant := First (Variants (Vpart));
12036                while Present (Variant) loop
12037                   Check_Variant (Variant, Typ);
12038                   Next (Variant);
12039                end loop;
12040             end if;
12041
12042             Set_Is_Unchecked_Union  (Typ, True);
12043             Set_Convention          (Typ, Convention_C);
12044
12045             Set_Has_Unchecked_Union (Base_Type (Typ), True);
12046             Set_Is_Unchecked_Union  (Base_Type (Typ), True);
12047          end Unchecked_Union;
12048
12049          ------------------------
12050          -- Unimplemented_Unit --
12051          ------------------------
12052
12053          --  pragma Unimplemented_Unit;
12054
12055          --  Note: this only gives an error if we are generating code, or if
12056          --  we are in a generic library unit (where the pragma appears in the
12057          --  body, not in the spec).
12058
12059          when Pragma_Unimplemented_Unit => Unimplemented_Unit : declare
12060             Cunitent : constant Entity_Id :=
12061                          Cunit_Entity (Get_Source_Unit (Loc));
12062             Ent_Kind : constant Entity_Kind :=
12063                          Ekind (Cunitent);
12064
12065          begin
12066             GNAT_Pragma;
12067             Check_Arg_Count (0);
12068
12069             if Operating_Mode = Generate_Code
12070               or else Ent_Kind = E_Generic_Function
12071               or else Ent_Kind = E_Generic_Procedure
12072               or else Ent_Kind = E_Generic_Package
12073             then
12074                Get_Name_String (Chars (Cunitent));
12075                Set_Casing (Mixed_Case);
12076                Write_Str (Name_Buffer (1 .. Name_Len));
12077                Write_Str (" is not supported in this configuration");
12078                Write_Eol;
12079                raise Unrecoverable_Error;
12080             end if;
12081          end Unimplemented_Unit;
12082
12083          ------------------------
12084          -- Universal_Aliasing --
12085          ------------------------
12086
12087          --  pragma Universal_Aliasing [([Entity =>] type_LOCAL_NAME)];
12088
12089          when Pragma_Universal_Aliasing => Universal_Alias : declare
12090             E_Id : Entity_Id;
12091
12092          begin
12093             GNAT_Pragma;
12094             Check_Arg_Count (1);
12095             Check_Optional_Identifier (Arg2, Name_Entity);
12096             Check_Arg_Is_Local_Name (Arg1);
12097             E_Id := Entity (Expression (Arg1));
12098
12099             if E_Id = Any_Type then
12100                return;
12101             elsif No (E_Id) or else not Is_Type (E_Id) then
12102                Error_Pragma_Arg ("pragma% requires type", Arg1);
12103             end if;
12104
12105             Set_Universal_Aliasing (Implementation_Base_Type (E_Id));
12106          end Universal_Alias;
12107
12108          --------------------
12109          -- Universal_Data --
12110          --------------------
12111
12112          --  pragma Universal_Data [(library_unit_NAME)];
12113
12114          when Pragma_Universal_Data =>
12115             GNAT_Pragma;
12116
12117             --  If this is a configuration pragma, then set the universal
12118             --  addressing option, otherwise confirm that the pragma satisfies
12119             --  the requirements of library unit pragma placement and leave it
12120             --  to the GNAAMP back end to detect the pragma (avoids transitive
12121             --  setting of the option due to withed units).
12122
12123             if Is_Configuration_Pragma then
12124                Universal_Addressing_On_AAMP := True;
12125             else
12126                Check_Valid_Library_Unit_Pragma;
12127             end if;
12128
12129             if not AAMP_On_Target then
12130                Error_Pragma ("?pragma% ignored (applies only to AAMP)");
12131             end if;
12132
12133          ----------------
12134          -- Unmodified --
12135          ----------------
12136
12137          --  pragma Unmodified (local_Name {, local_Name});
12138
12139          when Pragma_Unmodified => Unmodified : declare
12140             Arg_Node : Node_Id;
12141             Arg_Expr : Node_Id;
12142             Arg_Ent  : Entity_Id;
12143
12144          begin
12145             GNAT_Pragma;
12146             Check_At_Least_N_Arguments (1);
12147
12148             --  Loop through arguments
12149
12150             Arg_Node := Arg1;
12151             while Present (Arg_Node) loop
12152                Check_No_Identifier (Arg_Node);
12153
12154                --  Note: the analyze call done by Check_Arg_Is_Local_Name will
12155                --  in fact generate reference, so that the entity will have a
12156                --  reference, which will inhibit any warnings about it not
12157                --  being referenced, and also properly show up in the ali file
12158                --  as a reference. But this reference is recorded before the
12159                --  Has_Pragma_Unreferenced flag is set, so that no warning is
12160                --  generated for this reference.
12161
12162                Check_Arg_Is_Local_Name (Arg_Node);
12163                Arg_Expr := Get_Pragma_Arg (Arg_Node);
12164
12165                if Is_Entity_Name (Arg_Expr) then
12166                   Arg_Ent := Entity (Arg_Expr);
12167
12168                   if not Is_Assignable (Arg_Ent) then
12169                      Error_Pragma_Arg
12170                        ("pragma% can only be applied to a variable",
12171                         Arg_Expr);
12172                   else
12173                      Set_Has_Pragma_Unmodified (Arg_Ent);
12174                   end if;
12175                end if;
12176
12177                Next (Arg_Node);
12178             end loop;
12179          end Unmodified;
12180
12181          ------------------
12182          -- Unreferenced --
12183          ------------------
12184
12185          --  pragma Unreferenced (local_Name {, local_Name});
12186
12187          --    or when used in a context clause:
12188
12189          --  pragma Unreferenced (library_unit_NAME {, library_unit_NAME}
12190
12191          when Pragma_Unreferenced => Unreferenced : declare
12192             Arg_Node : Node_Id;
12193             Arg_Expr : Node_Id;
12194             Arg_Ent  : Entity_Id;
12195             Citem    : Node_Id;
12196
12197          begin
12198             GNAT_Pragma;
12199             Check_At_Least_N_Arguments (1);
12200
12201             --  Check case of appearing within context clause
12202
12203             if Is_In_Context_Clause then
12204
12205                --  The arguments must all be units mentioned in a with clause
12206                --  in the same context clause. Note we already checked (in
12207                --  Par.Prag) that the arguments are either identifiers or
12208                --  selected components.
12209
12210                Arg_Node := Arg1;
12211                while Present (Arg_Node) loop
12212                   Citem := First (List_Containing (N));
12213                   while Citem /= N loop
12214                      if Nkind (Citem) = N_With_Clause
12215                        and then Same_Name (Name (Citem), Expression (Arg_Node))
12216                      then
12217                         Set_Has_Pragma_Unreferenced
12218                           (Cunit_Entity
12219                              (Get_Source_Unit
12220                                 (Library_Unit (Citem))));
12221                         Set_Unit_Name (Expression (Arg_Node), Name (Citem));
12222                         exit;
12223                      end if;
12224
12225                      Next (Citem);
12226                   end loop;
12227
12228                   if Citem = N then
12229                      Error_Pragma_Arg
12230                        ("argument of pragma% is not with'ed unit", Arg_Node);
12231                   end if;
12232
12233                   Next (Arg_Node);
12234                end loop;
12235
12236             --  Case of not in list of context items
12237
12238             else
12239                Arg_Node := Arg1;
12240                while Present (Arg_Node) loop
12241                   Check_No_Identifier (Arg_Node);
12242
12243                   --  Note: the analyze call done by Check_Arg_Is_Local_Name
12244                   --  will in fact generate reference, so that the entity will
12245                   --  have a reference, which will inhibit any warnings about
12246                   --  it not being referenced, and also properly show up in the
12247                   --  ali file as a reference. But this reference is recorded
12248                   --  before the Has_Pragma_Unreferenced flag is set, so that
12249                   --  no warning is generated for this reference.
12250
12251                   Check_Arg_Is_Local_Name (Arg_Node);
12252                   Arg_Expr := Get_Pragma_Arg (Arg_Node);
12253
12254                   if Is_Entity_Name (Arg_Expr) then
12255                      Arg_Ent := Entity (Arg_Expr);
12256
12257                      --  If the entity is overloaded, the pragma applies to the
12258                      --  most recent overloading, as documented. In this case,
12259                      --  name resolution does not generate a reference, so it
12260                      --  must be done here explicitly.
12261
12262                      if Is_Overloaded (Arg_Expr) then
12263                         Generate_Reference (Arg_Ent, N);
12264                      end if;
12265
12266                      Set_Has_Pragma_Unreferenced (Arg_Ent);
12267                   end if;
12268
12269                   Next (Arg_Node);
12270                end loop;
12271             end if;
12272          end Unreferenced;
12273
12274          --------------------------
12275          -- Unreferenced_Objects --
12276          --------------------------
12277
12278          --  pragma Unreferenced_Objects (local_Name {, local_Name});
12279
12280          when Pragma_Unreferenced_Objects => Unreferenced_Objects : declare
12281             Arg_Node : Node_Id;
12282             Arg_Expr : Node_Id;
12283
12284          begin
12285             GNAT_Pragma;
12286             Check_At_Least_N_Arguments (1);
12287
12288             Arg_Node := Arg1;
12289             while Present (Arg_Node) loop
12290                Check_No_Identifier (Arg_Node);
12291                Check_Arg_Is_Local_Name (Arg_Node);
12292                Arg_Expr := Get_Pragma_Arg (Arg_Node);
12293
12294                if not Is_Entity_Name (Arg_Expr)
12295                  or else not Is_Type (Entity (Arg_Expr))
12296                then
12297                   Error_Pragma_Arg
12298                     ("argument for pragma% must be type or subtype", Arg_Node);
12299                end if;
12300
12301                Set_Has_Pragma_Unreferenced_Objects (Entity (Arg_Expr));
12302                Next (Arg_Node);
12303             end loop;
12304          end Unreferenced_Objects;
12305
12306          ------------------------------
12307          -- Unreserve_All_Interrupts --
12308          ------------------------------
12309
12310          --  pragma Unreserve_All_Interrupts;
12311
12312          when Pragma_Unreserve_All_Interrupts =>
12313             GNAT_Pragma;
12314             Check_Arg_Count (0);
12315
12316             if In_Extended_Main_Code_Unit (Main_Unit_Entity) then
12317                Unreserve_All_Interrupts := True;
12318             end if;
12319
12320          ----------------
12321          -- Unsuppress --
12322          ----------------
12323
12324          --  pragma Unsuppress (IDENTIFIER [, [On =>] NAME]);
12325
12326          when Pragma_Unsuppress =>
12327             Ada_2005_Pragma;
12328             Process_Suppress_Unsuppress (False);
12329
12330          -------------------
12331          -- Use_VADS_Size --
12332          -------------------
12333
12334          --  pragma Use_VADS_Size;
12335
12336          when Pragma_Use_VADS_Size =>
12337             GNAT_Pragma;
12338             Check_Arg_Count (0);
12339             Check_Valid_Configuration_Pragma;
12340             Use_VADS_Size := True;
12341
12342          ---------------------
12343          -- Validity_Checks --
12344          ---------------------
12345
12346          --  pragma Validity_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
12347
12348          when Pragma_Validity_Checks => Validity_Checks : declare
12349             A  : constant Node_Id   := Expression (Arg1);
12350             S  : String_Id;
12351             C  : Char_Code;
12352
12353          begin
12354             GNAT_Pragma;
12355             Check_Arg_Count (1);
12356             Check_No_Identifiers;
12357
12358             if Nkind (A) = N_String_Literal then
12359                S   := Strval (A);
12360
12361                declare
12362                   Slen    : constant Natural := Natural (String_Length (S));
12363                   Options : String (1 .. Slen);
12364                   J       : Natural;
12365
12366                begin
12367                   J := 1;
12368                   loop
12369                      C := Get_String_Char (S, Int (J));
12370                      exit when not In_Character_Range (C);
12371                      Options (J) := Get_Character (C);
12372
12373                      if J = Slen then
12374                         Set_Validity_Check_Options (Options);
12375                         exit;
12376                      else
12377                         J := J + 1;
12378                      end if;
12379                   end loop;
12380                end;
12381
12382             elsif Nkind (A) = N_Identifier then
12383
12384                if Chars (A) = Name_All_Checks then
12385                   Set_Validity_Check_Options ("a");
12386
12387                elsif Chars (A) = Name_On then
12388                   Validity_Checks_On := True;
12389
12390                elsif Chars (A) = Name_Off then
12391                   Validity_Checks_On := False;
12392
12393                end if;
12394             end if;
12395          end Validity_Checks;
12396
12397          --------------
12398          -- Volatile --
12399          --------------
12400
12401          --  pragma Volatile (LOCAL_NAME);
12402
12403          when Pragma_Volatile =>
12404             Process_Atomic_Shared_Volatile;
12405
12406          -------------------------
12407          -- Volatile_Components --
12408          -------------------------
12409
12410          --  pragma Volatile_Components (array_LOCAL_NAME);
12411
12412          --  Volatile is handled by the same circuit as Atomic_Components
12413
12414          --------------
12415          -- Warnings --
12416          --------------
12417
12418          --  pragma Warnings (On | Off);
12419          --  pragma Warnings (On | Off, LOCAL_NAME);
12420          --  pragma Warnings (static_string_EXPRESSION);
12421          --  pragma Warnings (On | Off, STRING_LITERAL);
12422
12423          when Pragma_Warnings => Warnings : begin
12424             GNAT_Pragma;
12425             Check_At_Least_N_Arguments (1);
12426             Check_No_Identifiers;
12427
12428             --  If debug flag -gnatd.i is set, pragma is ignored
12429
12430             if Debug_Flag_Dot_I then
12431                return;
12432             end if;
12433
12434             --  Process various forms of the pragma
12435
12436             declare
12437                Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
12438
12439             begin
12440                --  One argument case
12441
12442                if Arg_Count = 1 then
12443
12444                   --  On/Off one argument case was processed by parser
12445
12446                   if Nkind (Argx) = N_Identifier
12447                     and then
12448                       (Chars (Argx) = Name_On
12449                          or else
12450                        Chars (Argx) = Name_Off)
12451                   then
12452                      null;
12453
12454                   --  One argument case must be ON/OFF or static string expr
12455
12456                   elsif not Is_Static_String_Expression (Arg1) then
12457                      Error_Pragma_Arg
12458                        ("argument of pragma% must be On/Off or " &
12459                         "static string expression", Arg1);
12460
12461                   --  One argument string expression case
12462
12463                   else
12464                      declare
12465                         Lit : constant Node_Id   := Expr_Value_S (Argx);
12466                         Str : constant String_Id := Strval (Lit);
12467                         Len : constant Nat       := String_Length (Str);
12468                         C   : Char_Code;
12469                         J   : Nat;
12470                         OK  : Boolean;
12471                         Chr : Character;
12472
12473                      begin
12474                         J := 1;
12475                         while J <= Len loop
12476                            C := Get_String_Char (Str, J);
12477                            OK := In_Character_Range (C);
12478
12479                            if OK then
12480                               Chr := Get_Character (C);
12481
12482                               --  Dot case
12483
12484                               if J < Len and then Chr = '.' then
12485                                  J := J + 1;
12486                                  C := Get_String_Char (Str, J);
12487                                  Chr := Get_Character (C);
12488
12489                                  if not Set_Dot_Warning_Switch (Chr) then
12490                                     Error_Pragma_Arg
12491                                       ("invalid warning switch character " &
12492                                        '.' & Chr, Arg1);
12493                                  end if;
12494
12495                               --  Non-Dot case
12496
12497                               else
12498                                  OK := Set_Warning_Switch (Chr);
12499                               end if;
12500                            end if;
12501
12502                            if not OK then
12503                               Error_Pragma_Arg
12504                                 ("invalid warning switch character " & Chr,
12505                                  Arg1);
12506                            end if;
12507
12508                            J := J + 1;
12509                         end loop;
12510                      end;
12511                   end if;
12512
12513                   --  Two or more arguments (must be two)
12514
12515                else
12516                   Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
12517                   Check_At_Most_N_Arguments (2);
12518
12519                   declare
12520                      E_Id : Node_Id;
12521                      E    : Entity_Id;
12522                      Err  : Boolean;
12523
12524                   begin
12525                      E_Id := Expression (Arg2);
12526                      Analyze (E_Id);
12527
12528                      --  In the expansion of an inlined body, a reference to
12529                      --  the formal may be wrapped in a conversion if the
12530                      --  actual is a conversion. Retrieve the real entity name.
12531
12532                      if (In_Instance_Body
12533                          or else In_Inlined_Body)
12534                        and then Nkind (E_Id) = N_Unchecked_Type_Conversion
12535                      then
12536                         E_Id := Expression (E_Id);
12537                      end if;
12538
12539                      --  Entity name case
12540
12541                      if Is_Entity_Name (E_Id) then
12542                         E := Entity (E_Id);
12543
12544                         if E = Any_Id then
12545                            return;
12546                         else
12547                            loop
12548                               Set_Warnings_Off
12549                                 (E, (Chars (Expression (Arg1)) = Name_Off));
12550
12551                               if Chars (Expression (Arg1)) = Name_Off
12552                                 and then Warn_On_Warnings_Off
12553                               then
12554                                  Warnings_Off_Pragmas.Append ((N, E));
12555                               end if;
12556
12557                               if Is_Enumeration_Type (E) then
12558                                  declare
12559                                     Lit : Entity_Id;
12560                                  begin
12561                                     Lit := First_Literal (E);
12562                                     while Present (Lit) loop
12563                                        Set_Warnings_Off (Lit);
12564                                        Next_Literal (Lit);
12565                                     end loop;
12566                                  end;
12567                               end if;
12568
12569                               exit when No (Homonym (E));
12570                               E := Homonym (E);
12571                            end loop;
12572                         end if;
12573
12574                      --  Error if not entity or static string literal case
12575
12576                      elsif not Is_Static_String_Expression (Arg2) then
12577                         Error_Pragma_Arg
12578                           ("second argument of pragma% must be entity " &
12579                            "name or static string expression", Arg2);
12580
12581                      --  String literal case
12582
12583                      else
12584                         String_To_Name_Buffer
12585                           (Strval (Expr_Value_S (Expression (Arg2))));
12586
12587                         --  Note on configuration pragma case: If this is a
12588                         --  configuration pragma, then for an OFF pragma, we
12589                         --  just set Config True in the call, which is all
12590                         --  that needs to be done. For the case of ON, this
12591                         --  is normally an error, unless it is canceling the
12592                         --  effect of a previous OFF pragma in the same file.
12593                         --  In any other case, an error will be signalled (ON
12594                         --  with no matching OFF).
12595
12596                         if Chars (Argx) = Name_Off then
12597                            Set_Specific_Warning_Off
12598                              (Loc, Name_Buffer (1 .. Name_Len),
12599                               Config => Is_Configuration_Pragma);
12600
12601                         elsif Chars (Argx) = Name_On then
12602                            Set_Specific_Warning_On
12603                              (Loc, Name_Buffer (1 .. Name_Len), Err);
12604
12605                            if Err then
12606                               Error_Msg
12607                                 ("?pragma Warnings On with no " &
12608                                  "matching Warnings Off",
12609                                  Loc);
12610                            end if;
12611                         end if;
12612                      end if;
12613                   end;
12614                end if;
12615             end;
12616          end Warnings;
12617
12618          -------------------
12619          -- Weak_External --
12620          -------------------
12621
12622          --  pragma Weak_External ([Entity =>] LOCAL_NAME);
12623
12624          when Pragma_Weak_External => Weak_External : declare
12625             Ent : Entity_Id;
12626
12627          begin
12628             GNAT_Pragma;
12629             Check_Arg_Count (1);
12630             Check_Optional_Identifier (Arg1, Name_Entity);
12631             Check_Arg_Is_Library_Level_Local_Name (Arg1);
12632             Ent := Entity (Expression (Arg1));
12633
12634             if Rep_Item_Too_Early (Ent, N) then
12635                return;
12636             else
12637                Ent := Underlying_Type (Ent);
12638             end if;
12639
12640             --  The only processing required is to link this item on to the
12641             --  list of rep items for the given entity. This is accomplished
12642             --  by the call to Rep_Item_Too_Late (when no error is detected
12643             --  and False is returned).
12644
12645             if Rep_Item_Too_Late (Ent, N) then
12646                return;
12647             else
12648                Set_Has_Gigi_Rep_Item (Ent);
12649             end if;
12650          end Weak_External;
12651
12652          -----------------------------
12653          -- Wide_Character_Encoding --
12654          -----------------------------
12655
12656          --  pragma Wide_Character_Encoding (IDENTIFIER);
12657
12658          when Pragma_Wide_Character_Encoding =>
12659             GNAT_Pragma;
12660
12661             --  Nothing to do, handled in parser. Note that we do not enforce
12662             --  configuration pragma placement, this pragma can appear at any
12663             --  place in the source, allowing mixed encodings within a single
12664             --  source program.
12665
12666             null;
12667
12668          --------------------
12669          -- Unknown_Pragma --
12670          --------------------
12671
12672          --  Should be impossible, since the case of an unknown pragma is
12673          --  separately processed before the case statement is entered.
12674
12675          when Unknown_Pragma =>
12676             raise Program_Error;
12677       end case;
12678
12679       --  AI05-0144: detect dangerous order dependence. Disabled for now,
12680       --  until AI is formally approved.
12681
12682       --  Check_Order_Dependence;
12683
12684    exception
12685       when Pragma_Exit => null;
12686    end Analyze_Pragma;
12687
12688    -------------------
12689    -- Check_Enabled --
12690    -------------------
12691
12692    function Check_Enabled (Nam : Name_Id) return Boolean is
12693       PP : Node_Id;
12694
12695    begin
12696       PP := Opt.Check_Policy_List;
12697       loop
12698          if No (PP) then
12699             return Assertions_Enabled;
12700
12701          elsif
12702            Nam = Chars (Expression (First (Pragma_Argument_Associations (PP))))
12703          then
12704             case
12705               Chars (Expression (Last (Pragma_Argument_Associations (PP))))
12706             is
12707             when Name_On | Name_Check =>
12708                return True;
12709             when Name_Off | Name_Ignore =>
12710                return False;
12711             when others =>
12712                raise Program_Error;
12713             end case;
12714
12715          else
12716             PP := Next_Pragma (PP);
12717          end if;
12718       end loop;
12719    end Check_Enabled;
12720
12721    ---------------------------------
12722    -- Delay_Config_Pragma_Analyze --
12723    ---------------------------------
12724
12725    function Delay_Config_Pragma_Analyze (N : Node_Id) return Boolean is
12726    begin
12727       return Pragma_Name (N) = Name_Interrupt_State
12728                or else
12729              Pragma_Name (N) = Name_Priority_Specific_Dispatching;
12730    end Delay_Config_Pragma_Analyze;
12731
12732    -------------------------
12733    -- Get_Base_Subprogram --
12734    -------------------------
12735
12736    function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id is
12737       Result : Entity_Id;
12738
12739    begin
12740       --  Follow subprogram renaming chain
12741
12742       Result := Def_Id;
12743       while Is_Subprogram (Result)
12744         and then
12745           (Is_Generic_Instance (Result)
12746             or else Nkind (Parent (Declaration_Node (Result))) =
12747                                          N_Subprogram_Renaming_Declaration)
12748         and then Present (Alias (Result))
12749       loop
12750          Result := Alias (Result);
12751       end loop;
12752
12753       return Result;
12754    end Get_Base_Subprogram;
12755
12756    --------------------
12757    -- Get_Pragma_Arg --
12758    --------------------
12759
12760    function Get_Pragma_Arg (Arg : Node_Id) return Node_Id is
12761    begin
12762       if Nkind (Arg) = N_Pragma_Argument_Association then
12763          return Expression (Arg);
12764       else
12765          return Arg;
12766       end if;
12767    end Get_Pragma_Arg;
12768
12769    ----------------
12770    -- Initialize --
12771    ----------------
12772
12773    procedure Initialize is
12774    begin
12775       Externals.Init;
12776    end Initialize;
12777
12778    -----------------------------
12779    -- Is_Config_Static_String --
12780    -----------------------------
12781
12782    function Is_Config_Static_String (Arg : Node_Id) return Boolean is
12783
12784       function Add_Config_Static_String (Arg : Node_Id) return Boolean;
12785       --  This is an internal recursive function that is just like the outer
12786       --  function except that it adds the string to the name buffer rather
12787       --  than placing the string in the name buffer.
12788
12789       ------------------------------
12790       -- Add_Config_Static_String --
12791       ------------------------------
12792
12793       function Add_Config_Static_String (Arg : Node_Id) return Boolean is
12794          N : Node_Id;
12795          C : Char_Code;
12796
12797       begin
12798          N := Arg;
12799
12800          if Nkind (N) = N_Op_Concat then
12801             if Add_Config_Static_String (Left_Opnd (N)) then
12802                N := Right_Opnd (N);
12803             else
12804                return False;
12805             end if;
12806          end if;
12807
12808          if Nkind (N) /= N_String_Literal then
12809             Error_Msg_N ("string literal expected for pragma argument", N);
12810             return False;
12811
12812          else
12813             for J in 1 .. String_Length (Strval (N)) loop
12814                C := Get_String_Char (Strval (N), J);
12815
12816                if not In_Character_Range (C) then
12817                   Error_Msg
12818                     ("string literal contains invalid wide character",
12819                      Sloc (N) + 1 + Source_Ptr (J));
12820                   return False;
12821                end if;
12822
12823                Add_Char_To_Name_Buffer (Get_Character (C));
12824             end loop;
12825          end if;
12826
12827          return True;
12828       end Add_Config_Static_String;
12829
12830    --  Start of processing for Is_Config_Static_String
12831
12832    begin
12833
12834       Name_Len := 0;
12835       return Add_Config_Static_String (Arg);
12836    end Is_Config_Static_String;
12837
12838    -----------------------------------------
12839    -- Is_Non_Significant_Pragma_Reference --
12840    -----------------------------------------
12841
12842    --  This function makes use of the following static table which indicates
12843    --  whether a given pragma is significant.
12844
12845    --  -1  indicates that references in any argument position are significant
12846    --  0   indicates that appearence in any argument is not significant
12847    --  +n  indicates that appearence as argument n is significant, but all
12848    --      other arguments are not significant
12849    --  99  special processing required (e.g. for pragma Check)
12850
12851    Sig_Flags : constant array (Pragma_Id) of Int :=
12852      (Pragma_AST_Entry                     => -1,
12853       Pragma_Abort_Defer                   => -1,
12854       Pragma_Ada_83                        => -1,
12855       Pragma_Ada_95                        => -1,
12856       Pragma_Ada_05                        => -1,
12857       Pragma_Ada_2005                      => -1,
12858       Pragma_Ada_12                        => -1,
12859       Pragma_Ada_2012                      => -1,
12860       Pragma_All_Calls_Remote              => -1,
12861       Pragma_Annotate                      => -1,
12862       Pragma_Assert                        => -1,
12863       Pragma_Assertion_Policy              =>  0,
12864       Pragma_Assume_No_Invalid_Values      =>  0,
12865       Pragma_Asynchronous                  => -1,
12866       Pragma_Atomic                        =>  0,
12867       Pragma_Atomic_Components             =>  0,
12868       Pragma_Attach_Handler                => -1,
12869       Pragma_Check                         => 99,
12870       Pragma_Check_Name                    =>  0,
12871       Pragma_Check_Policy                  =>  0,
12872       Pragma_CIL_Constructor               => -1,
12873       Pragma_CPP_Class                     =>  0,
12874       Pragma_CPP_Constructor               =>  0,
12875       Pragma_CPP_Virtual                   =>  0,
12876       Pragma_CPP_Vtable                    =>  0,
12877       Pragma_C_Pass_By_Copy                =>  0,
12878       Pragma_Comment                       =>  0,
12879       Pragma_Common_Object                 => -1,
12880       Pragma_Compile_Time_Error            => -1,
12881       Pragma_Compile_Time_Warning          => -1,
12882       Pragma_Compiler_Unit                 =>  0,
12883       Pragma_Complete_Representation       =>  0,
12884       Pragma_Complex_Representation        =>  0,
12885       Pragma_Component_Alignment           => -1,
12886       Pragma_Controlled                    =>  0,
12887       Pragma_Convention                    =>  0,
12888       Pragma_Convention_Identifier         =>  0,
12889       Pragma_Debug                         => -1,
12890       Pragma_Debug_Policy                  =>  0,
12891       Pragma_Detect_Blocking               => -1,
12892       Pragma_Dimension                     => -1,
12893       Pragma_Discard_Names                 =>  0,
12894       Pragma_Elaborate                     => -1,
12895       Pragma_Elaborate_All                 => -1,
12896       Pragma_Elaborate_Body                => -1,
12897       Pragma_Elaboration_Checks            => -1,
12898       Pragma_Eliminate                     => -1,
12899       Pragma_Export                        => -1,
12900       Pragma_Export_Exception              => -1,
12901       Pragma_Export_Function               => -1,
12902       Pragma_Export_Object                 => -1,
12903       Pragma_Export_Procedure              => -1,
12904       Pragma_Export_Value                  => -1,
12905       Pragma_Export_Valued_Procedure       => -1,
12906       Pragma_Extend_System                 => -1,
12907       Pragma_Extensions_Allowed            => -1,
12908       Pragma_External                      => -1,
12909       Pragma_Favor_Top_Level               => -1,
12910       Pragma_External_Name_Casing          => -1,
12911       Pragma_Fast_Math                     => -1,
12912       Pragma_Finalize_Storage_Only         =>  0,
12913       Pragma_Float_Representation          =>  0,
12914       Pragma_Ident                         => -1,
12915       Pragma_Implemented_By_Entry          => -1,
12916       Pragma_Implicit_Packing              =>  0,
12917       Pragma_Import                        => +2,
12918       Pragma_Import_Exception              =>  0,
12919       Pragma_Import_Function               =>  0,
12920       Pragma_Import_Object                 =>  0,
12921       Pragma_Import_Procedure              =>  0,
12922       Pragma_Import_Valued_Procedure       =>  0,
12923       Pragma_Initialize_Scalars            => -1,
12924       Pragma_Inline                        =>  0,
12925       Pragma_Inline_Always                 =>  0,
12926       Pragma_Inline_Generic                =>  0,
12927       Pragma_Inspection_Point              => -1,
12928       Pragma_Interface                     => +2,
12929       Pragma_Interface_Name                => +2,
12930       Pragma_Interrupt_Handler             => -1,
12931       Pragma_Interrupt_Priority            => -1,
12932       Pragma_Interrupt_State               => -1,
12933       Pragma_Java_Constructor              => -1,
12934       Pragma_Java_Interface                => -1,
12935       Pragma_Keep_Names                    =>  0,
12936       Pragma_License                       => -1,
12937       Pragma_Link_With                     => -1,
12938       Pragma_Linker_Alias                  => -1,
12939       Pragma_Linker_Constructor            => -1,
12940       Pragma_Linker_Destructor             => -1,
12941       Pragma_Linker_Options                => -1,
12942       Pragma_Linker_Section                => -1,
12943       Pragma_List                          => -1,
12944       Pragma_Locking_Policy                => -1,
12945       Pragma_Long_Float                    => -1,
12946       Pragma_Machine_Attribute             => -1,
12947       Pragma_Main                          => -1,
12948       Pragma_Main_Storage                  => -1,
12949       Pragma_Memory_Size                   => -1,
12950       Pragma_No_Return                     =>  0,
12951       Pragma_No_Body                       =>  0,
12952       Pragma_No_Run_Time                   => -1,
12953       Pragma_No_Strict_Aliasing            => -1,
12954       Pragma_Normalize_Scalars             => -1,
12955       Pragma_Obsolescent                   =>  0,
12956       Pragma_Optimize                      => -1,
12957       Pragma_Optimize_Alignment            => -1,
12958       Pragma_Ordered                       =>  0,
12959       Pragma_Pack                          =>  0,
12960       Pragma_Page                          => -1,
12961       Pragma_Passive                       => -1,
12962       Pragma_Preelaborable_Initialization  => -1,
12963       Pragma_Polling                       => -1,
12964       Pragma_Persistent_BSS                =>  0,
12965       Pragma_Postcondition                 => -1,
12966       Pragma_Precondition                  => -1,
12967       Pragma_Preelaborate                  => -1,
12968       Pragma_Preelaborate_05               => -1,
12969       Pragma_Priority                      => -1,
12970       Pragma_Priority_Specific_Dispatching => -1,
12971       Pragma_Profile                       =>  0,
12972       Pragma_Profile_Warnings              =>  0,
12973       Pragma_Propagate_Exceptions          => -1,
12974       Pragma_Psect_Object                  => -1,
12975       Pragma_Pure                          => -1,
12976       Pragma_Pure_05                       => -1,
12977       Pragma_Pure_Function                 => -1,
12978       Pragma_Queuing_Policy                => -1,
12979       Pragma_Ravenscar                     => -1,
12980       Pragma_Relative_Deadline             => -1,
12981       Pragma_Remote_Call_Interface         => -1,
12982       Pragma_Remote_Types                  => -1,
12983       Pragma_Restricted_Run_Time           => -1,
12984       Pragma_Restriction_Warnings          => -1,
12985       Pragma_Restrictions                  => -1,
12986       Pragma_Reviewable                    => -1,
12987       Pragma_Short_Circuit_And_Or          => -1,
12988       Pragma_Share_Generic                 => -1,
12989       Pragma_Shared                        => -1,
12990       Pragma_Shared_Passive                => -1,
12991       Pragma_Short_Descriptors             =>  0,
12992       Pragma_Source_File_Name              => -1,
12993       Pragma_Source_File_Name_Project      => -1,
12994       Pragma_Source_Reference              => -1,
12995       Pragma_Storage_Size                  => -1,
12996       Pragma_Storage_Unit                  => -1,
12997       Pragma_Static_Elaboration_Desired    => -1,
12998       Pragma_Stream_Convert                => -1,
12999       Pragma_Style_Checks                  => -1,
13000       Pragma_Subtitle                      => -1,
13001       Pragma_Suppress                      =>  0,
13002       Pragma_Suppress_Exception_Locations  =>  0,
13003       Pragma_Suppress_All                  => -1,
13004       Pragma_Suppress_Debug_Info           =>  0,
13005       Pragma_Suppress_Initialization       =>  0,
13006       Pragma_System_Name                   => -1,
13007       Pragma_Task_Dispatching_Policy       => -1,
13008       Pragma_Task_Info                     => -1,
13009       Pragma_Task_Name                     => -1,
13010       Pragma_Task_Storage                  =>  0,
13011       Pragma_Thread_Local_Storage          =>  0,
13012       Pragma_Time_Slice                    => -1,
13013       Pragma_Title                         => -1,
13014       Pragma_Unchecked_Union               =>  0,
13015       Pragma_Unimplemented_Unit            => -1,
13016       Pragma_Universal_Aliasing            => -1,
13017       Pragma_Universal_Data                => -1,
13018       Pragma_Unmodified                    => -1,
13019       Pragma_Unreferenced                  => -1,
13020       Pragma_Unreferenced_Objects          => -1,
13021       Pragma_Unreserve_All_Interrupts      => -1,
13022       Pragma_Unsuppress                    =>  0,
13023       Pragma_Use_VADS_Size                 => -1,
13024       Pragma_Validity_Checks               => -1,
13025       Pragma_Volatile                      =>  0,
13026       Pragma_Volatile_Components           =>  0,
13027       Pragma_Warnings                      => -1,
13028       Pragma_Weak_External                 => -1,
13029       Pragma_Wide_Character_Encoding       =>  0,
13030       Unknown_Pragma                       =>  0);
13031
13032    function Is_Non_Significant_Pragma_Reference (N : Node_Id) return Boolean is
13033       Id : Pragma_Id;
13034       P  : Node_Id;
13035       C  : Int;
13036       A  : Node_Id;
13037
13038    begin
13039       P := Parent (N);
13040
13041       if Nkind (P) /= N_Pragma_Argument_Association then
13042          return False;
13043
13044       else
13045          Id := Get_Pragma_Id (Parent (P));
13046          C := Sig_Flags (Id);
13047
13048          case C is
13049             when -1 =>
13050                return False;
13051
13052             when 0 =>
13053                return True;
13054
13055             when 99 =>
13056                case Id is
13057
13058                   --  For pragma Check, the first argument is not significant,
13059                   --  the second and the third (if present) arguments are
13060                   --  significant.
13061
13062                   when Pragma_Check =>
13063                      return
13064                        P = First (Pragma_Argument_Associations (Parent (P)));
13065
13066                   when others =>
13067                      raise Program_Error;
13068                end case;
13069
13070             when others =>
13071                A := First (Pragma_Argument_Associations (Parent (P)));
13072                for J in 1 .. C - 1 loop
13073                   if No (A) then
13074                      return False;
13075                   end if;
13076
13077                   Next (A);
13078                end loop;
13079
13080                return A = P; -- is this wrong way round ???
13081          end case;
13082       end if;
13083    end Is_Non_Significant_Pragma_Reference;
13084
13085    ------------------------------
13086    -- Is_Pragma_String_Literal --
13087    ------------------------------
13088
13089    --  This function returns true if the corresponding pragma argument is a
13090    --  static string expression. These are the only cases in which string
13091    --  literals can appear as pragma arguments. We also allow a string literal
13092    --  as the first argument to pragma Assert (although it will of course
13093    --  always generate a type error).
13094
13095    function Is_Pragma_String_Literal (Par : Node_Id) return Boolean is
13096       Pragn : constant Node_Id := Parent (Par);
13097       Assoc : constant List_Id := Pragma_Argument_Associations (Pragn);
13098       Pname : constant Name_Id := Pragma_Name (Pragn);
13099       Argn  : Natural;
13100       N     : Node_Id;
13101
13102    begin
13103       Argn := 1;
13104       N := First (Assoc);
13105       loop
13106          exit when N = Par;
13107          Argn := Argn + 1;
13108          Next (N);
13109       end loop;
13110
13111       if Pname = Name_Assert then
13112          return True;
13113
13114       elsif Pname = Name_Export then
13115          return Argn > 2;
13116
13117       elsif Pname = Name_Ident then
13118          return Argn = 1;
13119
13120       elsif Pname = Name_Import then
13121          return Argn > 2;
13122
13123       elsif Pname = Name_Interface_Name then
13124          return Argn > 1;
13125
13126       elsif Pname = Name_Linker_Alias then
13127          return Argn = 2;
13128
13129       elsif Pname = Name_Linker_Section then
13130          return Argn = 2;
13131
13132       elsif Pname = Name_Machine_Attribute then
13133          return Argn = 2;
13134
13135       elsif Pname = Name_Source_File_Name then
13136          return True;
13137
13138       elsif Pname = Name_Source_Reference then
13139          return Argn = 2;
13140
13141       elsif Pname = Name_Title then
13142          return True;
13143
13144       elsif Pname = Name_Subtitle then
13145          return True;
13146
13147       else
13148          return False;
13149       end if;
13150    end Is_Pragma_String_Literal;
13151
13152    --------------------------------------
13153    -- Process_Compilation_Unit_Pragmas --
13154    --------------------------------------
13155
13156    procedure Process_Compilation_Unit_Pragmas (N : Node_Id) is
13157    begin
13158       --  A special check for pragma Suppress_All, a very strange DEC pragma,
13159       --  strange because it comes at the end of the unit. If we have a pragma
13160       --  Suppress_All in the Pragmas_After of the current unit, then we insert
13161       --  a pragma Suppress (All_Checks) at the start of the context clause to
13162       --  ensure the correct processing.
13163
13164       declare
13165          PA : constant List_Id := Pragmas_After (Aux_Decls_Node (N));
13166          P  : Node_Id;
13167
13168       begin
13169          if Present (PA) then
13170             P := First (PA);
13171             while Present (P) loop
13172                if Pragma_Name (P) = Name_Suppress_All then
13173                   Prepend_To (Context_Items (N),
13174                     Make_Pragma (Sloc (P),
13175                       Chars => Name_Suppress,
13176                       Pragma_Argument_Associations => New_List (
13177                         Make_Pragma_Argument_Association (Sloc (P),
13178                           Expression =>
13179                             Make_Identifier (Sloc (P),
13180                               Chars => Name_All_Checks)))));
13181                   exit;
13182                end if;
13183
13184                Next (P);
13185             end loop;
13186          end if;
13187       end;
13188    end Process_Compilation_Unit_Pragmas;
13189
13190    --------
13191    -- rv --
13192    --------
13193
13194    procedure rv is
13195    begin
13196       null;
13197    end rv;
13198
13199    --------------------------------
13200    -- Set_Encoded_Interface_Name --
13201    --------------------------------
13202
13203    procedure Set_Encoded_Interface_Name (E : Entity_Id; S : Node_Id) is
13204       Str : constant String_Id := Strval (S);
13205       Len : constant Int       := String_Length (Str);
13206       CC  : Char_Code;
13207       C   : Character;
13208       J   : Int;
13209
13210       Hex : constant array (0 .. 15) of Character := "0123456789abcdef";
13211
13212       procedure Encode;
13213       --  Stores encoded value of character code CC. The encoding we use an
13214       --  underscore followed by four lower case hex digits.
13215
13216       ------------
13217       -- Encode --
13218       ------------
13219
13220       procedure Encode is
13221       begin
13222          Store_String_Char (Get_Char_Code ('_'));
13223          Store_String_Char
13224            (Get_Char_Code (Hex (Integer (CC / 2 ** 12))));
13225          Store_String_Char
13226            (Get_Char_Code (Hex (Integer (CC / 2 ** 8 and 16#0F#))));
13227          Store_String_Char
13228            (Get_Char_Code (Hex (Integer (CC / 2 ** 4 and 16#0F#))));
13229          Store_String_Char
13230            (Get_Char_Code (Hex (Integer (CC and 16#0F#))));
13231       end Encode;
13232
13233    --  Start of processing for Set_Encoded_Interface_Name
13234
13235    begin
13236       --  If first character is asterisk, this is a link name, and we leave it
13237       --  completely unmodified. We also ignore null strings (the latter case
13238       --  happens only in error cases) and no encoding should occur for Java or
13239       --  AAMP interface names.
13240
13241       if Len = 0
13242         or else Get_String_Char (Str, 1) = Get_Char_Code ('*')
13243         or else VM_Target /= No_VM
13244         or else AAMP_On_Target
13245       then
13246          Set_Interface_Name (E, S);
13247
13248       else
13249          J := 1;
13250          loop
13251             CC := Get_String_Char (Str, J);
13252
13253             exit when not In_Character_Range (CC);
13254
13255             C := Get_Character (CC);
13256
13257             exit when C /= '_' and then C /= '$'
13258               and then C not in '0' .. '9'
13259               and then C not in 'a' .. 'z'
13260               and then C not in 'A' .. 'Z';
13261
13262             if J = Len then
13263                Set_Interface_Name (E, S);
13264                return;
13265
13266             else
13267                J := J + 1;
13268             end if;
13269          end loop;
13270
13271          --  Here we need to encode. The encoding we use as follows:
13272          --     three underscores  + four hex digits (lower case)
13273
13274          Start_String;
13275
13276          for J in 1 .. String_Length (Str) loop
13277             CC := Get_String_Char (Str, J);
13278
13279             if not In_Character_Range (CC) then
13280                Encode;
13281             else
13282                C := Get_Character (CC);
13283
13284                if C = '_' or else C = '$'
13285                  or else C in '0' .. '9'
13286                  or else C in 'a' .. 'z'
13287                  or else C in 'A' .. 'Z'
13288                then
13289                   Store_String_Char (CC);
13290                else
13291                   Encode;
13292                end if;
13293             end if;
13294          end loop;
13295
13296          Set_Interface_Name (E,
13297            Make_String_Literal (Sloc (S),
13298              Strval => End_String));
13299       end if;
13300    end Set_Encoded_Interface_Name;
13301
13302    -------------------
13303    -- Set_Unit_Name --
13304    -------------------
13305
13306    procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id) is
13307       Pref : Node_Id;
13308       Scop : Entity_Id;
13309
13310    begin
13311       if Nkind (N) = N_Identifier
13312         and then Nkind (With_Item) = N_Identifier
13313       then
13314          Set_Entity (N, Entity (With_Item));
13315
13316       elsif Nkind (N) = N_Selected_Component then
13317          Change_Selected_Component_To_Expanded_Name (N);
13318          Set_Entity (N, Entity (With_Item));
13319          Set_Entity (Selector_Name (N), Entity (N));
13320
13321          Pref := Prefix (N);
13322          Scop := Scope (Entity (N));
13323          while Nkind (Pref) = N_Selected_Component loop
13324             Change_Selected_Component_To_Expanded_Name (Pref);
13325             Set_Entity (Selector_Name (Pref), Scop);
13326             Set_Entity (Pref, Scop);
13327             Pref := Prefix (Pref);
13328             Scop := Scope (Scop);
13329          end loop;
13330
13331          Set_Entity (Pref, Scop);
13332       end if;
13333    end Set_Unit_Name;
13334
13335 end Sem_Prag;