OSDN Git Service

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