X-Git-Url: http://git.sourceforge.jp/view?a=blobdiff_plain;f=gcc%2Fada%2Fopt.ads;h=555283c62780434556c62915fc5eaa5860d38e39;hb=4c97a37dc04bd1838ea3d099bebf2900e10322dd;hp=d35195df99f7ba92945b49e562571fd69497af4e;hpb=49260fa57f719c6d0c779e62abe0e05a0cf2e09b;p=pf3gnuchains%2Fgcc-fork.git diff --git a/gcc/ada/opt.ads b/gcc/ada/opt.ads index d35195df99f..555283c6278 100644 --- a/gcc/ada/opt.ads +++ b/gcc/ada/opt.ads @@ -6,7 +6,7 @@ -- -- -- S p e c -- -- -- --- Copyright (C) 1992-2009, Free Software Foundation, Inc. -- +-- Copyright (C) 1992-2011, Free Software Foundation, Inc. -- -- -- -- GNAT is free software; you can redistribute it and/or modify it under -- -- terms of the GNU General Public License as published by the Free Soft- -- @@ -38,15 +38,69 @@ -- use the Project Manager. These tools include gnatmake, gnatname, the gnat -- driver, gnatclean, gprbuild and gprclean. -with Debug; with Hostparm; use Hostparm; with Types; use Types; +pragma Warnings (Off); +-- This package is used also by gnatcoll with System.Strings; use System.Strings; with System.WCh_Con; use System.WCh_Con; +pragma Warnings (On); package Opt is + ---------------------- + -- Checksum Control -- + ---------------------- + + -- Checksums are computed for sources to check for sources being the same + -- from a compilation point of view (e.g. spelling of identifiers and + -- white space layout do not count in this computation). + + -- The way the checksum is computed has evolved across the various versions + -- of GNAT. When gprbuild is called with -m, the checksums must be computed + -- the same way in gprbuild as it was in the GNAT version of the compiler. + -- The different ways are + + -- Version 6.4 and later: + + -- The Accumulate_Token_Checksum procedure is called after each numeric + -- literal and each identifier/keyword. For keywords, Tok_Identifier is + -- used in the call to Accumulate_Token_Checksum. + + -- Versions 5.04 to 6.3: + + -- For keywords, the token value were used in the call to procedure + -- Accumulate_Token_Checksum. Type Token_Type did not include Tok_Some. + + -- Versions 5.03: + + -- For keywords, the token value were used in the call to + -- Accumulate_Token_Checksum. Type Token_Type did not include + -- Tok_Interface, Tok_Overriding, Tok_Synchronized and Tok_Some. + + -- Versions 5.02 and before: + + -- No calls to procedure Accumulate_Token_Checksum (the checksum + -- mechanism was introduced in version 5.03). + + -- To signal to the scanner whether Accumulate_Token_Checksum needs to be + -- called and what versions to call, the following Boolean flags are used: + + Checksum_Accumulate_Token_Checksum : Boolean := True; + -- GPRBUILD + -- Set to False by gprbuild when the version of GNAT is 5.02 or before. If + -- this switch is False, then we do not call Accumulate_Token_Checksum, so + -- the setting of the following two flags is irrelevant. + + Checksum_GNAT_6_3 : Boolean := False; + -- GPRBUILD + -- Set to True by gprbuild when the version of GNAT is 6.3 or before. + + Checksum_GNAT_5_03 : Boolean := False; + -- GPRBUILD + -- Set to True by gprbuild when the version of GNAT is 5.03 or before. + ---------------------------------------------- -- Settings of Modes for Current Processing -- ---------------------------------------------- @@ -58,21 +112,21 @@ package Opt is -- case of some binder variables, Gnatbind.Scan_Bind_Arg may modify -- the default values. - Ada_Bind_File : Boolean := True; - -- GNATBIND, GNATLINK - -- Set True if binder file to be generated in Ada rather than C - - type Ada_Version_Type is (Ada_83, Ada_95, Ada_05); - pragma Warnings (Off, Ada_Version_Type); + type Ada_Version_Type is (Ada_83, Ada_95, Ada_2005, Ada_2012); + pragma Ordered (Ada_Version_Type); -- Versions of Ada for Ada_Version below. Note that these are ordered, -- so that tests like Ada_Version >= Ada_95 are legitimate and useful. - -- The Warnings_Off pragma stops warnings for Ada_Version >= Ada_05, - -- which we want to allow, so that things work OK when Ada_15 is added! - -- This warning is now removed, so this pragma can be removed some time??? + -- Think twice before using "="; Ada_Version >= Ada_2012 is more likely + -- what you want, because it will apply to future versions of the language. - Ada_Version_Default : Ada_Version_Type := Ada_05; + Ada_Version_Default : constant Ada_Version_Type := Ada_2005; + pragma Warnings (Off, Ada_Version_Default); -- GNAT - -- Default Ada version if no switch given + -- Default Ada version if no switch given. The Warnings off is to kill + -- constant condition warnings. + -- + -- WARNING: some scripts rely on the format of this line of code. Any + -- change must be coordinated with the scripts requirements. Ada_Version : Ada_Version_Type := Ada_Version_Default; -- GNAT @@ -86,10 +140,10 @@ package Opt is -- or internal units, so it reflects the Ada version explicitly set -- using configuration pragmas or compiler switches (or if neither -- appears, it remains set to Ada_Version_Default). This is used in - -- the rare cases (notably for pragmas Preelaborate_05 and Pure_05) + -- the rare cases (notably for pragmas Preelaborate_05 and Pure_05/12) -- where in the run-time we want the explicit version set. - Ada_Version_Runtime : Ada_Version_Type := Ada_05; + Ada_Version_Runtime : Ada_Version_Type := Ada_2012; -- GNAT -- Ada version used to compile the runtime. Used to set Ada_Version (but -- not Ada_Version_Explicit) when compiling predefined or internal units. @@ -173,6 +227,15 @@ package Opt is -- also set true if certain Unchecked_Conversion instantiations require -- checking based on annotated values. + Back_End_Handles_Limited_Types : Boolean; + -- This flag is set true if the back end can properly handle limited or + -- other by reference types, and avoid copies. If this flag is False, then + -- the front end does special expansion for conditional expressions to make + -- sure that no copy occurs. If the flag is True, then the expansion for + -- conditional expressions relies on the back end properly handling things. + -- Currently the default is False for all cases (set in gnat1drv). The + -- default can be modified using -gnatd.L (sets the flag True). + Bind_Alternate_Main_Name : Boolean := False; -- GNATBIND -- True if main should be called Alternate_Main_Name.all. @@ -184,8 +247,8 @@ package Opt is Bind_For_Library : Boolean := False; -- GNATBIND - -- Set to True if the binder needs to generate a file designed for - -- building a library. May be set to True by Gnatbind.Scan_Bind_Arg. + -- Set to True if the binder needs to generate a file designed for building + -- a library. May be set to True by Gnatbind.Scan_Bind_Arg. Bind_Only : Boolean := False; -- GNATMAKE, GPRMAKE, GPRBUILD @@ -225,7 +288,10 @@ package Opt is -- GNAT -- This points to the list of N_Pragma nodes for Check_Policy pragmas -- that are linked through the Next_Pragma fields, with the list being - -- terminated by Empty. The order is most recently processed first. + -- terminated by Empty. The order is most recently processed first. Note + -- that Push_Scope and Pop_Scope in Sem_Ch8 save and restore the value + -- of this variable, implementing the required scope control for pragmas + -- appearing a declarative part. Check_Readonly_Files : Boolean := False; -- GNATMAKE @@ -257,6 +323,11 @@ package Opt is -- Set to True to enable checking for unused withs, and also the case -- of withing a package and using none of the entities in the package. + CodePeer_Mode : Boolean := False; + -- GNAT, GNATBIND + -- Enable full CodePeer mode (SCIL generation, disable switches that + -- interact badly with it, etc...). + Commands_To_Stdout : Boolean := False; -- GNATMAKE -- True if echoed commands to be written to stdout instead of stderr @@ -303,6 +374,10 @@ package Opt is -- GNAT -- Enable debug statements from pragma Debug + Debug_Pragmas_Disabled : Boolean := False; + -- GNAT + -- Debug pragmas completely disabled (no semantic checking) + subtype Debug_Level_Value is Nat range 0 .. 3; Debugger_Level : Debug_Level_Value := 0; -- GNATBIND @@ -336,6 +411,16 @@ package Opt is -- default was set by the binder, and that the default should be the -- initial value of System.Secondary_Stack.Default_Secondary_Stack_Size. + Default_Pool : Node_Id := Empty; + -- GNAT + -- Used to record the storage pool name (or null literal) that is the + -- argument of an applicable pragma Default_Storage_Pool. + -- Empty: No pragma Default_Storage_Pool applies. + -- N_Null node: "pragma Default_Storage_Pool (null);" applies. + -- otherwise: "pragma Default_Storage_Pool (X);" applies, and + -- this points to the name X. + -- Push_Scope and Pop_Scope in Sem_Ch8 save and restore this value. + Detect_Blocking : Boolean := False; -- GNAT -- Set True to force the run time to raise Program_Error if calls to @@ -421,10 +506,16 @@ package Opt is -- It is used to set Warn_On_Exception_Propagation True if the restriction -- No_Exception_Propagation is set. + Exception_Extra_Info : Boolean := False; + -- GNAT + -- True when switch -gnateE is used. When True, generate extra information + -- associated with exception messages (in particular range and index + -- checks). + Exception_Locations_Suppressed : Boolean := False; -- GNAT - -- This flag is set True if a Suppress_Exception_Locations configuration - -- pragma is currently active. + -- Set to True if a Suppress_Exception_Locations configuration pragma is + -- currently active. type Exception_Mechanism_Type is -- Determines the handling of exceptions. See Exp_Ch11 for details @@ -446,8 +537,8 @@ package Opt is Front_End_Setjmp_Longjmp_Exceptions; -- GNAT -- Set to the appropriate value depending on the default as given in - -- system.ads (ZCX_By_Default, GCC_ZCX_Support). - -- The C convention is there to make this variable accessible to gigi. + -- system.ads (ZCX_By_Default). The C convention is there to make this + -- variable accessible to gigi. Exception_Tracebacks : Boolean := False; -- GNATBIND @@ -515,6 +606,10 @@ package Opt is -- Force generation of ALI file even if errors are encountered. -- Also forces generation of tree file if -gnatt is also set. + Disable_ALI_File : Boolean := False; + -- GNAT + -- Disable generation of ALI file + Force_Checking_Of_Elaboration_Flags : Boolean := False; -- GNATBIND -- True if binding with forced checking of the elaboration flags @@ -546,6 +641,12 @@ package Opt is -- True when switch -gnateG is used. When True, create in a file -- .prep, if the source is preprocessed. + Generate_SCO : Boolean := False; + -- GNAT + -- True when switch -gnateS is used. When True, Source Coverage Obligation + -- (SCO) information is generated and output in the ALI file. See unit + -- Par_SCO for full details. + Generating_Code : Boolean := False; -- GNAT -- True if the frontend finished its work and has called the backend to @@ -560,6 +661,11 @@ package Opt is -- GNAT -- True if compiling in GNAT system mode (-gnatg switch) + Heap_Size : Nat := 0; + -- GNATBIND + -- Heap size for memory allocations. Valid values are 32 and 64. Only + -- available on VMS. + HLO_Active : Boolean := False; -- GNAT -- True if High Level Optimizer is activated (-gnatH switch) @@ -637,12 +743,9 @@ package Opt is -- then elaboration flag checks are to be generated in the binder -- generated file. - Inspector_Mode : Boolean renames Debug.Debug_Flag_Dot_II; + Generate_SCIL : Boolean := False; -- GNAT - -- True if compiling in inspector mode (-gnatd.I switch). - -- Only relevant when VM_Target /= None. The compiler will attempt to - -- generate code even in case of unsupported construct, so that the byte - -- code can be used by static analysis tools. + -- Set True to activate SCIL code generation. Invalid_Value_Used : Boolean := False; -- GNAT @@ -650,17 +753,17 @@ package Opt is Follow_Links_For_Files : Boolean := False; -- PROJECT MANAGER - -- Set to True (-eL) to process the project files in trusted mode - -- If Follow_Links is False, it is assumed that the project doesn't contain + -- Set to True (-eL) to process the project files in trusted mode. If + -- Follow_Links is False, it is assumed that the project doesn't contain -- any file duplicated through symbolic links (although the latter are -- still valid if they point to a file which is outside of the project), -- and that no directory has a name which is a valid source name. - Follow_Links_For_Dirs : Boolean := True; + Follow_Links_For_Dirs : Boolean := False; -- PROJECT MANAGER - -- Whether directories can be links in this project, and therefore - -- additional system calls should be performed to ensure we always see the - -- same full name for each directory. + -- Set to True if directories can be links in this project, and therefore + -- additional system calls must be performed to ensure that we always see + -- the same full name for each directory. Front_End_Inlining : Boolean := False; -- GNAT @@ -668,9 +771,9 @@ package Opt is Inline_Processing_Required : Boolean := False; -- GNAT - -- Set True if inline processing is required. Inline processing is - -- required if an active Inline pragma is processed. The flag is set - -- for a pragma Inline or Inline_Always that is actually active. + -- Set True if inline processing is required. Inline processing is required + -- if an active Inline pragma is processed. The flag is set for a pragma + -- Inline or Inline_Always that is actually active. In_Place_Mode : Boolean := False; -- GNATMAKE @@ -680,8 +783,8 @@ package Opt is Keep_Going : Boolean := False; -- GNATMAKE, GPRMAKE, GPRBUILD - -- When True signals to ignore compilation errors and keep - -- processing sources until there is no more work. + -- When True signals to ignore compilation errors and keep processing + -- sources until there is no more work. Keep_Temporary_Files : Boolean := False; -- GNATCMD @@ -695,8 +798,15 @@ package Opt is Link_Only : Boolean := False; -- GNATMAKE, GPRMAKE, GPRBUILD - -- Set to True to skip compile and bind steps - -- (except when Bind_Only is set to True). + -- Set to True to skip compile and bind steps (except when Bind_Only is + -- set to True). + + List_Inherited_Aspects : Boolean := False; + -- GNAT + -- List inherited invariants, preconditions, and postconditions from + -- Invariant'Class, Pre'Class, and Post'Class aspects. Also list inherited + -- subtype predicates. Set True by use of -gnatw.l and False by use of + -- -gnatw.L. List_Restrictions : Boolean := False; -- GNATBIND @@ -729,21 +839,21 @@ package Opt is List_Representation_Info_To_File : Boolean := False; -- GNAT - -- Set true by -gnatRs switch. Causes information from -gnatR/1/2/3 - -- to be written to file.rep (where file is the name of the source - -- file) instead of stdout. For example, if file x.adb is compiled - -- using -gnatR2s then representation info is written to x.adb.ref. + -- Set true by -gnatRs switch. Causes information from -gnatR/1/2/3 to be + -- written to file.rep (where file is the name of the source file) instead + -- of stdout. For example, if file x.adb is compiled using -gnatR2s then + -- representation info is written to x.adb.ref. List_Representation_Info_Mechanisms : Boolean := False; -- GNAT - -- Set true by -gnatRm switch. Causes information on mechanisms to - -- be included in the representation output information. + -- Set true by -gnatRm switch. Causes information on mechanisms to be + -- included in the representation output information. List_Preprocessing_Symbols : Boolean := False; -- GNAT, GNATPREP -- Set to True if symbols for preprocessing a source are to be listed - -- before preprocessing occurs. Set to True by switch -s of gnatprep - -- or -s in preprocessing data file for the compiler. + -- before preprocessing occurs. Set to True by switch -s of gnatprep or + -- -s in preprocessing data file for the compiler. type Create_Repinfo_File_Proc is access procedure (Src : String); type Write_Repinfo_Line_Proc is access procedure (Info : String); @@ -754,12 +864,11 @@ package Opt is Write_Repinfo_Line_Access : Write_Repinfo_Line_Proc := null; Close_Repinfo_File_Access : Close_Repinfo_File_Proc := null; -- GNAT - -- These three locations are left null when operating in non-compiler - -- (e.g. ASIS mode), but when operating in compiler mode, they are - -- set to point to the three corresponding procedures in Osint-C. The - -- reason for this slightly strange interface is to prevent Repinfo - -- from dragging in Osint in ASIS mode, which would include a lot of - -- unwanted units in the ASIS build. + -- These three locations are left null when operating in non-compiler (e.g. + -- ASIS mode), but when operating in compiler mode, they are set to point + -- to the three corresponding procedures in Osint-C. The reason for this + -- slightly strange interface is to stop Repinfo from dragging in Osint in + -- ASIS mode, which would include lots of unwanted units in the ASIS build. type Create_List_File_Proc is access procedure (S : String); type Write_List_Info_Proc is access procedure (S : String); @@ -775,25 +884,25 @@ package Opt is -- set to point to the three corresponding procedures in Osint-C. The -- reason for this slightly strange interface is to prevent Repinfo -- from dragging in Osint-C in the binder, which would include unwanted - -- units in the binder. + -- units in the binder. Locking_Policy : Character := ' '; -- GNAT, GNATBIND - -- Set to ' ' for the default case (no locking policy specified). - -- Reset to first character (uppercase) of locking policy name if a - -- valid pragma Locking_Policy is encountered. + -- Set to ' ' for the default case (no locking policy specified). Reset to + -- first character (uppercase) of locking policy name if a valid pragma + -- Locking_Policy is encountered. Locking_Policy_Sloc : Source_Ptr := No_Location; -- GNAT, GNATBIND - -- Remember location of previous Locking_Policy pragma. This is used - -- for inconsistency error messages. A value of System_Location is - -- used if the policy is set in package System. + -- Remember location of previous Locking_Policy pragma. This is used for + -- inconsistency error messages. A value of System_Location is used if the + -- policy is set in package System. Look_In_Primary_Dir : Boolean := True; -- GNAT, GNATBIND, GNATMAKE, GNATCLEAN - -- Set to False if a -I- was present on the command line. - -- When True we are allowed to look in the primary directory to locate - -- other source or library files. + -- Set to False if a -I- was present on the command line. When True we are + -- allowed to look in the primary directory to locate other source or + -- library files. Make_Steps : Boolean := False; -- GNATMAKE @@ -855,6 +964,12 @@ package Opt is -- This flag is set True if a No_Run_Time pragma is encountered. See -- spec of Rtsfind for a full description of handling of this pragma. + No_Split_Units : Boolean := False; + -- GPRBUILD + -- Set to True with switch --no-split-units. When True, unit sources, spec, + -- body and subunits, must all be in the same project.This is checked after + -- each compilation. + No_Stdinc : Boolean := False; -- GNAT, GNATBIND, GNATMAKE, GNATFIND, GNATXREF -- Set to True if no default source search dirs added to search list @@ -876,6 +991,12 @@ package Opt is -- GNATMAKE -- Set to True when an object directory is specified with option -D + One_Compilation_Per_Obj_Dir : Boolean := False; + -- GNATMAKE, GPRBUILD + -- Set to True with switch --single-compile-per-obj-dir. When True, there + -- cannot be simultaneous compilations with the object files in the same + -- object directory, if project files are used. + type Operating_Mode_Type is (Check_Syntax, Check_Semantics, Generate_Code); Operating_Mode : Operating_Mode_Type := Generate_Code; -- GNAT @@ -901,32 +1022,47 @@ package Opt is Original_Operating_Mode : Operating_Mode_Type := Generate_Code; -- GNAT - -- Indicates the original operating mode of the compiler as set by - -- compiler options. This is identical to Operating_Mode except that - -- this is not affected by errors. + -- Indicates the original operating mode of the compiler as set by compiler + -- options. This is identical to Operating_Mode except that this is not + -- affected by errors. Optimization_Level : Int; pragma Import (C, Optimization_Level, "optimize"); -- Constant reflecting the optimization level (0,1,2,3 for -O0,-O1,-O2,-O3) + -- See jmissing.c and aamissing.c for definitions for dotnet/jgnat and + -- GNAAMP back ends. + + Optimize_Size : Int; + pragma Import (C, Optimize_Size, "optimize_size"); + -- Constant reflecting setting of -Os (optimize for size). Set to nonzero + -- in -Os mode and set to zero otherwise. See jmissing.c and aamissing.c + -- for definitions of "optimize_size" for dotnet/jgnat and GNAAMP backends Output_File_Name_Present : Boolean := False; -- GNATBIND, GNAT, GNATMAKE, GPRMAKE - -- Set to True when the output C file name is given with option -o - -- for GNATBIND, when the object file name is given with option - -- -gnatO for GNAT or when the executable is given with option -o - -- for GNATMAKE or GPRMAKE. + -- Set to True when the output C file name is given with option -o for + -- GNATBIND, when the object file name is given with option -gnatO for GNAT + -- or when the executable is given with option -o for GNATMAKE or GPRMAKE. Output_Linker_Option_List : Boolean := False; -- GNATBIND -- True if output of list of linker options is requested (-K switch set) - Output_Object_List : Boolean := False; + Output_ALI_List : Boolean := False; + ALI_List_Filename : String_Ptr; -- GNATBIND - -- True if output of list of objects is requested (-O switch set) + -- True if output of list of ALIs is requested (-A switch set). List is + -- output under the given filename, or standard output if not specified. + + Output_Object_List : Boolean := False; + Object_List_Filename : String_Ptr; + -- GNATBIND + -- True if output of list of objects is requested (-O switch set). List is + -- output under the given filename, or standard output if not specified. Overflow_Checks_Unsuppressed : Boolean := False; -- GNAT - -- Set to True if at least one pragma Unsuppress + -- Set to True if at least one occurrence of pragma Unsuppress -- (All_Checks|Overflow_Checks) has been processed. Persistent_BSS_Mode : Boolean := False; @@ -947,6 +1083,15 @@ package Opt is -- GNAT -- Set by switch -gnatep=. The file name of the preprocessing data file. + Preprocessing_Symbol_Defs : String_List_Access := new String_List (1 .. 4); + -- An extensible array to temporarily stores symbol definitions specified + -- on the command line with -gnateD switches. + -- What is this magic constant 4 ??? + -- What is extensible about this fixed length array ??? + + Preprocessing_Symbol_Last : Natural := 0; + -- Index of last symbol definition in array Symbol_Definitions + Print_Generated_Code : Boolean := False; -- GNAT -- Set to True to enable output of generated code in source form. This @@ -966,20 +1111,20 @@ package Opt is type Usage is (Unknown, Not_In_Use, In_Use); Project_File_In_Use : Usage := Unknown; -- GNAT - -- Indicates if a project file is used or not. - -- Set to In_Use by the first SFNP pragma. + -- Indicates if a project file is used or not. Set to In_Use by the first + -- SFNP pragma. Queuing_Policy : Character := ' '; -- GNAT, GNATBIND - -- Set to ' ' for the default case (no queuing policy specified). - -- Reset to first character (uppercase) of locking policy name if a valid + -- Set to ' ' for the default case (no queuing policy specified). Reset to + -- first character (uppercase) of locking policy name if a valid -- Queuing_Policy pragma is encountered. Queuing_Policy_Sloc : Source_Ptr := No_Location; -- GNAT, GNATBIND - -- Remember location of previous Queuing_Policy pragma. This is used - -- for inconsistency error messages. A value of System_Location is - -- used if the policy is set in package System. + -- Remember location of previous Queuing_Policy pragma. This is used for + -- inconsistency error messages. A value of System_Location is used if the + -- policy is set in package System. Quiet_Output : Boolean := False; -- GNATMAKE, GNATCLEAN, GPRMAKE, GPRBUILD, GPRCLEAN @@ -1006,17 +1151,17 @@ package Opt is Search_Directory_Present : Boolean := False; -- GNAT - -- Set to True when argument is -I. Reset to False when next argument, - -- a search directory path is taken into account. Note that this is - -- quite different from other switches in this section in that it is - -- only set in a transitory manner as a result of scanning a -I switch - -- with no file name, and if set, is an indication that the next argument - -- is to be treated as a file name. + -- Set to True when argument is -I. Reset to False when next argument, a + -- search directory path is taken into account. Note that this is quite + -- different from other switches in this section in that it is only set in + -- a transitory manner as a result of scanning a -I switch with no file + -- name, and if set, is an indication that the next argument is to be + -- treated as a file name. Sec_Stack_Used : Boolean := False; -- GNAT, GBATBIND - -- Set True if generated code uses the System.Secondary_Stack package. - -- For the binder, set if any unit uses the secondary stack package. + -- Set True if generated code uses the System.Secondary_Stack package. For + -- the binder, set if any unit uses the secondary stack package. Setup_Projects : Boolean := False; -- GNAT DRIVER @@ -1025,11 +1170,20 @@ package Opt is Shared_Libgnat : Boolean; -- GNATBIND - -- Set to True if a shared libgnat is requested by using the -shared - -- option for GNATBIND and to False when using the -static option. The - -- value of this flag is set by Gnatbind.Scan_Bind_Arg. + -- Set to True if a shared libgnat is requested by using the -shared option + -- for GNATBIND and to False when using the -static option. The value of + -- this flag is set by Gnatbind.Scan_Bind_Arg. + + Short_Circuit_And_Or : Boolean := False; + -- GNAT + -- Set True if a pragma Short_Circuit_And_Or applies to the current unit. + + Short_Descriptors : Boolean := False; + -- GNAT + -- Set True if a pragma Short_Descriptors applies to the current unit. Sprint_Line_Limit : Nat := 72; + -- GNAT -- Limit values for chopping long lines in Sprint output, can be reset -- by use of NNN parameter with -gnatG or -gnatD switches. @@ -1044,15 +1198,20 @@ package Opt is Style_Check : Boolean := False; -- GNAT - -- Set True to perform style checks. Activates checks carried out - -- in package Style (see body of this package for details of checks) - -- This flag is set True by either the -gnatg or -gnaty switches. + -- Set True to perform style checks. Activates checks carried out in + -- package Style (see body of this package for details of checks). This + -- flag is set True by either the -gnatg or -gnaty switches. Suppress_All_Inlining : Boolean := False; -- GNAT -- Set by -fno-inline. Suppresses all inlining, both front end and back end -- regardless of any other switches that are set. + Suppress_Control_Flow_Optimizations : Boolean := False; + -- GNAT + -- Set by -fpreserve-control-flow. Suppresses control flow optimizations + -- that interfere with coverage analysis based on the object code. + System_Extend_Pragma_Arg : Node_Id := Empty; -- GNAT -- Set non-empty if and only if a correct Extend_System pragma was present @@ -1097,6 +1256,13 @@ package Opt is -- multiplied by the factor given here. The default value is used if no -- -gnatT switch appears. + Tagged_Type_Expansion : Boolean := True; + -- GNAT + -- Set True if tagged types and interfaces should be expanded by the + -- front-end. If False, the original tree is left unexpanded for tagged + -- types and dispatching calls, assuming the underlying target supports + -- it (e.g. in the JVM case). + Task_Dispatching_Policy : Character := ' '; -- GNAT, GNATBIND -- Set to ' ' for the default case (no task dispatching policy specified). @@ -1131,6 +1297,11 @@ package Opt is -- Tolerate time stamp and other consistency errors. If this flag is set to -- True (-t), then inconsistencies result in warnings rather than errors. + Treat_Categorization_Errors_As_Warnings : Boolean := False; + -- Normally categorization errors are true illegalities. If this switch + -- is set, then such errors result in warning messages rather than error + -- messages. Set True by -gnateP (P for Pure/Preelaborate). + Treat_Restrictions_As_Warnings : Boolean := False; -- GNAT -- Set True to treat pragma Restrictions as Restriction_Warnings. Set by @@ -1153,6 +1324,12 @@ package Opt is -- the other hand, most such blowups will be caught cleanly and simply -- say compilation abandoned. This flag is set to True by -gnatq or -gnatQ. + Unchecked_Shared_Lib_Imports : Boolean := False; + -- GPRBUILD + -- Set to True when shared library projects are allowed to import projects + -- that are not shared library projects. Set by switch + -- --unchecked-shared-lib-imports. + Undefined_Symbols_Are_False : Boolean := False; -- GNAT, GNATPREP -- Set to True by switch -u of gnatprep or -u in the preprocessing data @@ -1185,11 +1362,23 @@ package Opt is -- set True, and upper half characters in the source indicate the start of -- a wide character sequence. Set by -gnatW or -W switches. + Use_Include_Path_File : Boolean := False; + -- GNATMAKE, GPRBUILD + -- When True, create a source search path file, even when a mapping file + -- is used. + Usage_Requested : Boolean := False; -- GNAT, GNATBIND, GNATMAKE -- Set to True if -h (-gnath for the compiler) switch encountered -- requesting usage information + Use_Expression_With_Actions : Boolean; + -- The N_Expression_With_Actions node has been introduced relatively + -- recently, and not all back ends are prepared to handle it yet. So + -- we use this flag to suppress its use during a transitional period. + -- Currently the default is False for all cases (set in gnat1drv). + -- The default can be modified using -gnatd.X/-gnatd.Y. + Use_Pragma_Linker_Constructor : Boolean := False; -- GNATBIND -- True if pragma Linker_Constructor applies to adainit @@ -1216,6 +1405,7 @@ package Opt is -- information sent to standard output, also header, copyright and summary) type Verbosity_Level_Type is (None, Low, Medium, High); + pragma Ordered (Verbosity_Level_Type); Verbosity_Level : Verbosity_Level_Type := High; -- GNATMAKE, GPRMAKE -- Modified by gnatmake or gprmake switches -v, -vl, -vm, -vh. Indicates @@ -1236,11 +1426,18 @@ package Opt is -- including warnings on Ada 2005 obsolescent features used in Ada 2005 -- mode. Set False by -gnatwY. - Warn_On_Parameter_Order : Boolean := False; + Warn_On_Ada_2012_Compatibility : Boolean := True; -- GNAT - -- Set to True to generate warnings for cases where the argument list for - -- a call is a sequence of identifiers that match the formal identifiers, - -- but are in the wrong order. + -- Set to True to generate all warnings on Ada 2012 compatibility issues, + -- including warnings on Ada 2012 obsolescent features used in Ada 2012 + -- mode. Set False by -gnatwY. + + Warn_On_All_Unread_Out_Parameters : Boolean := False; + -- GNAT + -- Set to True to generate warnings in all cases where a variable is + -- modified by being passed as to an OUT formal, but the resulting value is + -- never read. The default is that this warning is suppressed, except in + -- the case of Warn_On_Assertion_Failure : Boolean := True; -- GNAT @@ -1253,6 +1450,11 @@ package Opt is -- with literals or S'Length, presumably assuming a lower bound of one. Set -- False by -gnatwW. + Warn_On_Atomic_Synchronization : Boolean := False; + -- GNAT + -- Set to True to generate information messages for atomic synchronization. + -- Set True by use of -gnatw.n. + Warn_On_Bad_Fixed_Value : Boolean := False; -- GNAT -- Set to True to generate warnings for static fixed-point expression @@ -1297,13 +1499,6 @@ package Opt is -- but only if there is only one out parameter for the procedure involved. -- The default is that this warning is suppressed. - Warn_On_All_Unread_Out_Parameters : Boolean := False; - -- GNAT - -- Set to True to generate warnings in all cases where a variable is - -- modified by being passed as to an OUT formal, but the resulting value is - -- never read. The default is that this warning is suppressed, except in - -- the case of - Warn_On_No_Value_Assigned : Boolean := True; -- GNAT -- Set to True to generate warnings if no value is ever assigned to a @@ -1325,38 +1520,67 @@ package Opt is -- use this to avoid turning it on by default when No_Exception_Propagation -- restriction is set and an exception handler is present. + Warn_On_Object_Renames_Function : Boolean := False; + -- GNAT + -- Set to True to generate warnings when a function result is renamed as + -- an object. The default is that this warning is disabled. + Warn_On_Obsolescent_Feature : Boolean := False; -- GNAT -- Set to True to generate warnings on use of any feature in Annex or if a -- subprogram is called for which a pragma Obsolescent applies. + Warn_On_Overlap : Boolean := False; + -- GNAT + -- Set to True to generate warnings when a writable actual which is not + -- a by-copy type overlaps with another actual in a subprogram call. + Warn_On_Questionable_Missing_Parens : Boolean := True; -- GNAT -- Set to True to generate warnings for cases where parentheses are missing -- and the usage is questionable, because the intent is unclear. + Warn_On_Parameter_Order : Boolean := False; + -- GNAT + -- Set to True to generate warnings for cases where the argument list for + -- a call is a sequence of identifiers that match the formal identifiers, + -- but are in the wrong order. + Warn_On_Redundant_Constructs : Boolean := False; -- GNAT -- Set to True to generate warnings for redundant constructs (e.g. useless -- assignments/conversions). The default is that this warning is disabled. - Warn_On_Object_Renames_Function : Boolean := False; - -- GNAT - -- Set to True to generate warnings when a function result is renamed as - -- an object. The default is that this warning is disabled. - Warn_On_Reverse_Bit_Order : Boolean := True; -- GNAT -- Set to True to generate warning (informational) messages for component -- clauses that are affected by non-standard bit-order. The default is -- that this warning is enabled. + Warn_On_Suspicious_Contract : Boolean := False; + -- GNAT + -- Set to True to generate warnings for suspicious contracts expressed as + -- pragmas or aspects precondition and postcondition. The default is that + -- this warning is disabled. + + Warn_On_Suspicious_Modulus_Value : Boolean := True; + -- GNAT + -- Set to True to generate warnings for suspicious modulus values. The + -- default is that this warning is enabled. + Warn_On_Unchecked_Conversion : Boolean := True; -- GNAT -- Set to True to generate warnings for unchecked conversions that may have -- non-portable semantics (e.g. because sizes of types differ). The default -- is that this warning is enabled. + Warn_On_Unordered_Enumeration_Type : Boolean := False; + -- GNAT + -- Set to True to generate warnings for inappropriate uses (comparisons + -- and explicit ranges) on unordered enumeration types (which includes + -- all enumeration types for which pragma Ordered is not given). The + -- default is that this warning is disabled. + Warn_On_Unrecognized_Pragma : Boolean := True; -- GNAT -- Set to True to generate warnings for unrecognized pragmas. The default @@ -1421,11 +1645,11 @@ package Opt is -- GNAT -- This is the value of the configuration switch for the Ada 83 mode, as -- set by the command line switches -gnat83/95/05, and possibly modified by - -- the use of configuration pragmas Ada_83/Ada95/Ada05. This switch is used - -- to set the initial value for Ada_Version mode at the start of analysis - -- of a unit. Note however, that the setting of this flag is ignored for - -- internal and predefined units (which are always compiled in the most up - -- to date version of Ada). + -- the use of configuration pragmas Ada_*. This switch is used to set the + -- initial value for Ada_Version mode at the start of analysis of a unit. + -- Note however that the setting of this flag is ignored for internal and + -- predefined units (which are always compiled in the most up to date + -- version of Ada). Ada_Version_Explicit_Config : Ada_Version_Type; -- GNAT @@ -1454,12 +1678,22 @@ package Opt is -- terminated by Empty. The order is most recently processed first. This -- list includes only those pragmas in configuration pragma files. + Debug_Pragmas_Disabled_Config : Boolean; + -- GNAT + -- This is the value of the configuration switch for debug pragmas disabled + -- mode, as possibly set by use of the configuration pragma Debug_Policy. + Debug_Pragmas_Enabled_Config : Boolean; -- GNAT -- This is the value of the configuration switch for debug pragmas enabled -- mode, as possibly set by the command line switch -gnata and possibly -- modified by the use of the configuration pragma Debug_Policy. + Default_Pool_Config : Node_Id := Empty; + -- GNAT + -- Same as Default_Pool above, except this is only for Default_Storage_Pool + -- pragmas that are configuration pragmas. + Dynamic_Elaboration_Checks_Config : Boolean := False; -- GNAT -- Set True for dynamic elaboration checking mode, as set by the -gnatE @@ -1506,6 +1740,13 @@ package Opt is -- used to set the initial value of Fast_Math at the start of each new -- compilation unit. + Initialize_Scalars_Config : Boolean; + -- GNAT + -- This is the value of the configuration switch that is set by the + -- pragma Initialize_Scalars when it appears in the gnat.adc file. + -- This switch is not set when the pragma appears ahead of a given + -- unit, so it does not affect the compilation of other units. + Optimize_Alignment_Config : Character; -- GNAT -- This is the value of the configuration switch that controls the @@ -1531,6 +1772,14 @@ package Opt is -- flag is used to set the initial value for Polling_Required at the start -- of analyzing each unit. + Short_Descriptors_Config : Boolean; + -- GNAT + -- This is the value of the configuration switch that controls the use of + -- Short_Descriptors for setting descriptor default sizes. It can be set + -- True by the use of the pragma Short_Descriptors in the gnat.adc file. + -- This flag is used to set the initial value for Short_Descriptors at the + -- start of analyzing each unit. + Use_VADS_Size_Config : Boolean; -- GNAT -- This is the value of the configuration switch that controls the use of @@ -1583,6 +1832,9 @@ package Opt is -- this flag, see package Expander. Indeed this flag might more logically -- be in the spec of Expander, but it is referenced by Errout, and it -- really seems wrong for Errout to depend on Expander. + -- + -- Note: for many purposes, it is more appropriate to test the flag + -- Full_Expander_Active, which also checks that Alfa mode is not active. Static_Dispatch_Tables : Boolean := True; -- This flag indicates if the backend supports generation of statically @@ -1632,6 +1884,29 @@ package Opt is -- Used to store the ASIS version number read from a tree file to check if -- it is the same as stored in the ASIS version number in Tree_IO. + ----------------------------------- + -- Modes for Formal Verification -- + ----------------------------------- + + Alfa_Mode : Boolean := False; + -- Specific compiling mode targeting formal verification through the + -- generation of Why code for those parts of the input code that belong to + -- the Alfa subset of Ada. Set by debug flag -gnatd.F. + + Strict_Alfa_Mode : Boolean := False; + -- Interpret compiler permissions as strictly as possible. E.g. base ranges + -- for integers are limited to the strict minimum with this option. Set by + -- debug flag -gnatd.D. + + function Full_Expander_Active return Boolean; + pragma Inline (Full_Expander_Active); + -- Returns the value of (Expander_Active and not Alfa_Mode). This "flag" + -- indicates that expansion is fully active, that is, not in the reduced + -- mode for Alfa (True) or that expansion is either deactivated, or active + -- in the reduced mode for Alfa (False). For more information on full + -- expansion, see package Expander. For more information on reduced + -- Alfa expansion, see package Exp_Alfa. + private -- The following type is used to save and restore settings of switches in @@ -1647,17 +1922,22 @@ private Assertions_Enabled : Boolean; Assume_No_Invalid_Values : Boolean; Check_Policy_List : Node_Id; + Debug_Pragmas_Disabled : Boolean; Debug_Pragmas_Enabled : Boolean; + Default_Pool : Node_Id; Dynamic_Elaboration_Checks : Boolean; Exception_Locations_Suppressed : Boolean; Extensions_Allowed : Boolean; External_Name_Exp_Casing : External_Casing_Type; External_Name_Imp_Casing : External_Casing_Type; Fast_Math : Boolean; + Initialize_Scalars : Boolean; + Normalize_Scalars : Boolean; Optimize_Alignment : Character; Optimize_Alignment_Local : Boolean; Persistent_BSS_Mode : Boolean; Polling_Required : Boolean; + Short_Descriptors : Boolean; Use_VADS_Size : Boolean; end record;