+++ /dev/null
-------------------------------------------------------------------------------
--- --
--- GNAT COMPILER COMPONENTS --
--- --
--- D E B U G --
--- --
--- B o d y --
--- --
--- $Revision: 1.2.10.1 $
--- --
--- Copyright (C) 1992-2001 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- --
--- ware Foundation; either version 2, or (at your option) any later ver- --
--- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
--- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
--- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
--- for more details. You should have received a copy of the GNU General --
--- Public License distributed with GNAT; see file COPYING. If not, write --
--- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
--- MA 02111-1307, USA. --
--- --
--- As a special exception, if other files instantiate generics from this --
--- unit, or you link this unit with other files to produce an executable, --
--- this unit does not by itself cause the resulting executable to be --
--- covered by the GNU General Public License. This exception does not --
--- however invalidate any other reasons why the executable file might be --
--- covered by the GNU Public License. --
--- --
--- GNAT was originally developed by the GNAT team at New York University. --
--- Extensive contributions were provided by Ada Core Technologies Inc. --
--- --
-------------------------------------------------------------------------------
-
-package body Debug is
-
- ---------------------------------
- -- Summary of Debug Flag Usage --
- ---------------------------------
-
- -- Debug flags for compiler (GNAT1 and GNATF)
-
- -- da Generate messages tracking semantic analyzer progress
- -- db Show encoding of type names for debug output
- -- dc List names of units as they are compiled
- -- dd Dynamic allocation of tables messages generated
- -- de List the entity table
- -- df Full tree/source print (includes withed units)
- -- dg Print source from tree (generated code only)
- -- dh Generate listing showing loading of name table hash chains
- -- di Generate messages for visibility linking/delinking
- -- dj Suppress "junk null check" for access parameter values
- -- dk Generate GNATBUG message on abort, even if previous errors
- -- dl Generate unit load trace messages
- -- dm Allow VMS features even if not OpenVMS version
- -- dn Generate messages for node/list allocation
- -- do Print source from tree (original code only)
- -- dp Generate messages for parser scope stack push/pops
- -- dq
- -- dr Generate parser resynchronization messages
- -- ds Print source from tree (including original and generated stuff)
- -- dt Print full tree
- -- du Uncheck categorization pragmas
- -- dv Output trace of overload resolution
- -- dw Print trace of semantic scope stack
- -- dx Force expansion on, even if no code being generated
- -- dy Print tree of package Standard
- -- dz Print source of package Standard
-
- -- dA All entities included in representation information output
- -- dB Output debug encoding of type names and variants
- -- dC
- -- dD Delete elaboration checks in inner level routines
- -- dE Apply elaboration checks to predefined units
- -- dF Front end data layout enabled.
- -- dG Generate input showing file creating info for debug file
- -- dH Hold (kill) call to gigi
- -- dI Inhibit internal name numbering in gnatG listing
- -- dJ Output debugging trace info for JGNAT (Java VM version of GNAT)
- -- dK Kill all error messages
- -- dL Output trace information on elaboration checking
- -- dM Modified ali file output
- -- dN Do not generate file/line exception messages
- -- dO Output immediate error messages
- -- dP Do not check for controlled objects in preelaborable packages
- -- dQ
- -- dR Bypass check for correct version of s-rpc
- -- dS Never convert numbers to machine numbers in Sem_Eval
- -- dT Convert to machine numbers only for constant declarations
- -- dU Enable garbage collection of unreachable entities
- -- dV Enable viewing of all symbols in debugger
- -- dW
- -- dX Enable Frontend ZCX even when it is not supported
- -- dY
- -- dZ
-
- -- d1 Error msgs have node numbers where possible
- -- d2 Eliminate error flags in verbose form error messages
- -- d3 Dump bad node in Comperr on an abort
- -- d4 Inhibit automatic krunch of predefined library unit files
- -- d5 Debug output for tree read/write
- -- d6 Default access unconstrained to thin pointers
- -- d7 Do not output version & file time stamp in -gnatv or -gnatl mode
- -- d8 Force opposite endianness in packed stuff
- -- d9
-
- -- Debug flags for binder (GNATBIND)
-
- -- da
- -- db
- -- dc List units as they are chosen
- -- dd
- -- de Elaboration dependencies including system units
- -- df
- -- dg
- -- dh
- -- di
- -- dj
- -- dk
- -- dl
- -- dm
- -- dn List details of manipulation of Num_Pred values
- -- do
- -- dp
- -- dq
- -- dr List additional restrictions that may be specified
- -- ds
- -- dt
- -- du List units as they are acquired
- -- dv
- -- dw
- -- dx
- -- dy
- -- dz
-
- -- d1
- -- d2
- -- d3
- -- d4
- -- d5
- -- d6
- -- d7
- -- d8
- -- d9
-
- -- Debug flags used in package Make and its clients (e.g. GNATMAKE)
-
- -- da
- -- db
- -- dc
- -- dd
- -- de
- -- df
- -- dg
- -- dh
- -- di
- -- dj
- -- dk
- -- dl
- -- dm
- -- dn
- -- do
- -- dp Prints the contents of the Q used by Make.Compile_Sources
- -- dq Prints source files as they are enqueued and dequeued
- -- dr
- -- ds
- -- dt
- -- du
- -- dv
- -- dw Prints the list of units withed by the unit currently explored
- -- dx
- -- dy
- -- dz
-
- -- d1
- -- d2
- -- d3
- -- d4
- -- d5
- -- d6
- -- d7
- -- d8
- -- d9
-
- --------------------------------------------
- -- Documentation for Compiler Debug Flags --
- --------------------------------------------
-
- -- da Generate messages tracking semantic analyzer progress. A message
- -- is output showing each node as it gets analyzed, expanded,
- -- resolved, or evaluated. This option is useful for finding out
- -- exactly where a bomb during semantic analysis is occurring.
-
- -- db In Exp_Dbug, certain type names are encoded to include debugging
- -- information. This debug switch causes lines to be output showing
- -- the encodings used.
-
- -- dc List names of units as they are compiled. One line of output will
- -- be generated at the start of compiling each unit (package or
- -- subprogram).
-
- -- dd Dynamic allocation of tables messages generated. Each time a
- -- table is reallocated, a line is output indicating the expansion.
-
- -- dD Delete new elaboration checks. This flag causes GNAT to return
- -- to the 3.13a elaboration semantics, and to suppress the fixing
- -- of two bugs. The first is in the context of inner routines in
- -- dynamic elaboration mode, when the subprogram we are in was
- -- called at elaboration time by a unit that was also compiled with
- -- dynamic elaboration checks. In this case, if A calls B calls C,
- -- and all are in different units, we need an elaboration check at
- -- each call. These nested checks were only put in recently (see
- -- version 1.80 of Sem_Elab) and we provide this debug flag to
- -- revert to the previous behavior in case of regressions. The
- -- other behavior reverted by this flag is the treatment of the
- -- Elaborate_Body pragma in static elaboration mode. This used to
- -- be treated as not needing elaboration checking, but in fact in
- -- general Elaborate_All is still required because of nested calls.
-
- -- de List the entity table
-
- -- df Full tree/source print (includes withed units). Normally the tree
- -- output (dt) or recreated source output (dg,do,ds) includes only
- -- the main unit. If df is set, then the output in either case
- -- includes all compiled units (see also dg,do,ds,dt). Note that to
- -- be effective, this swich must be used in combination with one or
- -- more of dt, dg, do or ds.
-
- -- dF Front end data layout enabled. Normally front end data layout
- -- is only enabled if the target parameter Backend_Layout is False.
- -- This debugging switch enables it unconditionally.
-
- -- dg Print the source recreated from the generated tree. In the case
- -- where the tree has been rewritten this output includes only the
- -- generated code, not the original code (see also df,do,ds,dz).
- -- This flag differs from -gnatG in that the output also includes
- -- non-source generated null statements, and freeze nodes, which
- -- are normally omitted in -gnatG mode.
-
- -- dG Print trace information showing calls to Create_Debug_Source and
- -- Write_Debug_Line. Used for debugging -gnatD operation problems.
-
- -- dh Generates a table at the end of a compilation showing how the hash
- -- table chains built by the Namet package are loaded. This is useful
- -- in ensuring that the hashing algorithm (in Namet.Hash) is working
- -- effectively with typical sets of program identifiers.
-
- -- dH Inhibit call to gigi. This is useful for testing front end data
- -- layout, and may be useful in other debugging situations where
- -- you do not want gigi to intefere with the testing.
-
- -- di Generate messages for visibility linking/delinking
-
- -- dj Suppress "junk null check" for access parameters. This flag permits
- -- Ada programs to pass null parameters to access parameters, and to
- -- explicitly check such access values against the null literal.
- -- Neither of these is valid Ada, but both were allowed in versions of
- -- GNAT before 3.10, so this switch can ease the transition process.
-
- -- dJ Generate debugging trace output for the JGNAT back end. This
- -- consists of symbolic Java Byte Code sequences for all generated
- -- classes plus additional information to indicate local variables
- -- and methods.
-
- -- dk Immediate kill on abort. Normally on an abort (i.e. a call to
- -- Comperr.Compiler_Abort), the GNATBUG message is not given if
- -- there is a previous error. This debug switch bypasses this test
- -- and gives the message unconditionally (useful for debugging).
-
- -- dK Kill all error messages. This debug flag suppresses the output
- -- of all error messages. It is used in regression tests where the
- -- error messages are target dependent and irrelevant.
-
- -- dl Generate unit load trace messages. A line of traceback output is
- -- generated each time a request is made to the library manager to
- -- load a new unit.
-
- -- dm Some features are permitted only in OpenVMS ports of GNAT (e.g.
- -- the specification of passing by descriptor). Normally any use
- -- of these features will be flagged as an error, but this debug
- -- flag allows acceptance of these features in non OpenVMS ports.
- -- Of course they may not have any useful effect, and in particular
- -- attempting to generate code with this flag set may blow up.
- -- The flag also forces the use of 64-bits for Long_Integer.
-
- -- dM Generate modified ALI output. Several ALI extensions are being
- -- developed for version 3.15w, and this switch is used to enable
- -- these extensions. This switch will disappear when this work is
- -- completed.
-
- -- dn Generate messages for node/list allocation. Each time a node or
- -- list header is allocated, a line of output is generated. Certain
- -- other basic tree operations also cause a line of output to be
- -- generated. This option is useful in seeing where the parser is
- -- blowing up.;
-
- -- dN Do not generate file/line exception messages. Normally we do the
- -- explicit generation of these messages, but since these can only
- -- be disabled using pragma Discard_Names, this switch may be useful.
-
- -- do Print the source recreated from the generated tree. In the case
- -- where the tree has been rewritten, this output includes only the
- -- original code, not the generated code (see also df,dg,ds,dz).
-
- -- dp Generate messages for parser scope stack push/pops. A line of
- -- output by the parser each time the parser scope stack is either
- -- pushed or popped. Useful in debugging situations where the
- -- parser scope stack ends up incorrectly synchronized
-
- -- dr Generate parser resynchronization messages. Normally the parser
- -- resynchronizes quietly. With this debug option, two messages
- -- are generated, one when the parser starts a resynchronization
- -- skip, and another when it resumes parsing. Useful in debugging
- -- inadequate error recovery situations.
-
- -- ds Print the source recreated from the generated tree. In the case
- -- where the tree has been rewritten this output includes both the
- -- generated code and the original code with the generated code
- -- being enlosed in curly brackets (see also df,do,ds,dz)
-
- -- dt Print full tree. The generated tree is output (see also df,dy)
-
- -- du Uncheck categorization pragmas. This debug switch causes the
- -- categorization pragmas (Pure, Preelaborate etc) to be ignored
- -- so that normal checks are not made (this is particularly useful
- -- for adding temporary debugging code to units that have pragmas
- -- that are inconsistent with the debugging code added.
-
- -- dw Write semantic scope stack messages. Each time a scope is created
- -- or removed, a message is output (see the Sem_Ch8.New_Scope and
- -- Sem_Ch8.Pop_Scope subprograms).
-
- -- dx Force expansion on, even if no code being generated. Normally the
- -- expander is inhibited if no code is generated. This switch forces
- -- expansion to proceed normally even if the backend is not being
- -- called. This is particularly useful for debugging purposes when
- -- using the front-end only version of the compiler (which normally
- -- would never do any expansion).
-
- -- dy Print tree of package Standard. Normally the tree print out does
- -- not include package Standard, even if the -df switch is set. This
- -- switch forces output of the internal tree built for Standard.
-
- -- dz Print source of package Standard. Normally the source print out
- -- does not include package Standard, even if the -df switch is set.
- -- This switch forces output of the source recreated from the internal
- -- tree built for Standard.
-
- -- dA Forces output of representation information, including full
- -- information for all internal type and object entities, as well
- -- as all user defined type and object entities.
-
- -- dB Output debug encodings for types and variants. See Exp_Dbug for
- -- exact form of the generated output.
-
- -- dE Apply compile time elaboration checking for with relations between
- -- predefined units. Normally no checks are made (it seems that at
- -- least on the SGI, such checks run into trouble).
-
- -- dI Inhibit internal name numbering in gnatDG listing. For internal
- -- names of the form <uppercase-letters><digits><suffix>, the output
- -- will be modified to <uppercase-letters>...<suffix>. This is used
- -- in the fixed bugs run to minimize system and version dependency
- -- in filed -gnatDG output.
-
- -- dL Output trace information on elaboration checking. This debug
- -- switch causes output to be generated showing each call or
- -- instantiation as it is checked, and the progress of the recursive
- -- trace through calls at elaboration time.
-
- -- dO Output immediate error messages. This causes error messages to
- -- be output as soon as they are generated (disconnecting several
- -- circuits for improvement of messages, deletion of duplicate
- -- messages etc). Useful to diagnose compiler bombs caused by
- -- erroneous handling of error situations
-
- -- dP Do not check for controlled objects in preelaborable packages.
- -- RM 10.2.1(9) forbids the use of library level controlled objects
- -- in preelaborable packages, but this restriction is a huge pain,
- -- especially in the predefined library units.
-
- -- dR Bypass the check for a proper version of s-rpc being present
- -- to use the -gnatz? switch. This allows debugging of the use
- -- of stubs generation without needing to have GLADE (or some
- -- other PCS installed).
-
- -- dS Omit conversion of fpt numbers to exact machine numbers in
- -- non-static evaluation contexts (see Check_Non_Static_Context).
- -- This is intended for testing out timing problems with this
- -- conversion circuit.
-
- -- dT Similar to dS, but omits the conversions only in the case where
- -- the parent is not a constant declaration.
-
- -- dU Enable garbage collection of unreachable entities. This enables
- -- both the reachability analysis and changing the Is_Public and
- -- Is_Eliminated flags.
-
- -- dV Enable viewing of all symbols in debugger. Causes debug information
- -- to be generated for all symbols, including internal symbols. This
- -- is enabled by default for -gnatD, but this switch allows this to
- -- be enabled without generating modified source files. Note that the
- -- use of -gnatdV ensures in the dwarf/elf case that all symbols that
- -- are present in the elf tables are also in the dwarf tables (which
- -- seems to be required by some tools).
-
- -- dX Enable frontend ZCX even when it is not supported. Equivalent to
- -- -gnatZ but without verifying that System.Front_End_ZCX_Support
- -- is set. This causes the front end to generate suitable tables
- -- for ZCX handling even when the runtime cannot handle ZCX. This
- -- is used for testing the front end for correct ZCX operation, and
- -- in particular is useful for multi-target testing.
-
- -- d1 Error msgs have node numbers where possible. Normally error
- -- messages have only source locations. This option is useful when
- -- debugging errors caused by expanded code, where the source location
- -- does not give enough information.
-
- -- d2 Suppress output of the error position flags for verbose form error
- -- messages. The messages are still interspersed in the listing, but
- -- without any error flags or extra blank lines. Also causes an extra
- -- <<< to be output at the right margin. This is intended to be the
- -- easiest format for checking conformance of ACVC B tests.
-
- -- d3 Causes Comperr to dump the contents of the node for which an abort
- -- was detected (normally only the Node_Id of the node is output).
-
- -- d4 Inhibits automatic krunching of predefined library unit file names.
- -- Normally, as described in the spec of package Krunch, such files
- -- are automatically krunched to 8 characters, with special treatment
- -- of the prefixes Ada, System, and Interfaces. Setting this debug
- -- switch disables this special treatment.
-
- -- d6 Normally access-to-unconstrained-array types are represented
- -- using fat (double) pointers. Using this debug flag causes them
- -- to default to thin. This can be used to test the performance
- -- implications of using thin pointers, and also to test that the
- -- compiler functions correctly with this choice.
-
- -- d7 Normally a -gnatl or -gnatv listing includes the time stamp
- -- of the source file. This debug flag suppresses this output,
- -- and also suppresses the message with the version number.
- -- This is useful in certain regression tests.
-
- -- d8 This forces the packed stuff to generate code assuming the
- -- opposite endianness from the actual correct value. Useful in
- -- testing out code generation from the packed routines.
-
- ------------------------------------------
- -- Documentation for Binder Debug Flags --
- ------------------------------------------
-
- -- dc List units as they are chosen. As units are selected for addition to
- -- the elaboration order, a line of output is generated showing which
- -- unit has been selected.
-
- -- de Similar to the effect of -e (output complete list of elaboration
- -- dependencies) except that internal units are included in the
- -- listing.
-
- -- dn List details of manipulation of Num_Pred values during execution of
- -- the algorithm used to determine a correct order of elaboration. This
- -- is useful in diagnosing any problems in its behavior.
-
- -- dr List restrictions which have not been specified, but could have
- -- been without causing bind errors.
-
- -- du List unit name and file name for each unit as it is read in
-
- ------------------------------------------------------------
- -- Documentation for the Debug Flags used in package Make --
- ------------------------------------------------------------
-
- -- Please note that such flags apply to all of Make clients,
- -- such as gnatmake.
-
- -- dp Prints the Q used by routine Make.Compile_Sources every time
- -- we go around the main compile loop of Make.Compile_Sources
-
- -- dq Prints source files as they are enqueued and dequeued in the Q
- -- used by routine Make.Compile_Sources. Useful to figure out the
- -- order in which sources are recompiled.
-
- -- dw Prints the list of units withed by the unit currently explored
- -- during the main loop of Make.Compile_Sources.
-
- ----------------------
- -- Get_Debug_Flag_K --
- ----------------------
-
- function Get_Debug_Flag_K return Boolean is
- begin
- return Debug_Flag_K;
- end Get_Debug_Flag_K;
-
- --------------------
- -- Set_Debug_Flag --
- --------------------
-
- procedure Set_Debug_Flag (C : Character; Val : Boolean := True) is
- subtype Dig is Character range '1' .. '9';
- subtype LLet is Character range 'a' .. 'z';
- subtype ULet is Character range 'A' .. 'Z';
-
- begin
- if C in Dig then
- case Dig (C) is
- when '1' => Debug_Flag_1 := Val;
- when '2' => Debug_Flag_2 := Val;
- when '3' => Debug_Flag_3 := Val;
- when '4' => Debug_Flag_4 := Val;
- when '5' => Debug_Flag_5 := Val;
- when '6' => Debug_Flag_6 := Val;
- when '7' => Debug_Flag_7 := Val;
- when '8' => Debug_Flag_8 := Val;
- when '9' => Debug_Flag_9 := Val;
- end case;
-
- elsif C in ULet then
- case ULet (C) is
- when 'A' => Debug_Flag_AA := Val;
- when 'B' => Debug_Flag_BB := Val;
- when 'C' => Debug_Flag_CC := Val;
- when 'D' => Debug_Flag_DD := Val;
- when 'E' => Debug_Flag_EE := Val;
- when 'F' => Debug_Flag_FF := Val;
- when 'G' => Debug_Flag_GG := Val;
- when 'H' => Debug_Flag_HH := Val;
- when 'I' => Debug_Flag_II := Val;
- when 'J' => Debug_Flag_JJ := Val;
- when 'K' => Debug_Flag_KK := Val;
- when 'L' => Debug_Flag_LL := Val;
- when 'M' => Debug_Flag_MM := Val;
- when 'N' => Debug_Flag_NN := Val;
- when 'O' => Debug_Flag_OO := Val;
- when 'P' => Debug_Flag_PP := Val;
- when 'Q' => Debug_Flag_QQ := Val;
- when 'R' => Debug_Flag_RR := Val;
- when 'S' => Debug_Flag_SS := Val;
- when 'T' => Debug_Flag_TT := Val;
- when 'U' => Debug_Flag_UU := Val;
- when 'V' => Debug_Flag_VV := Val;
- when 'W' => Debug_Flag_WW := Val;
- when 'X' => Debug_Flag_XX := Val;
- when 'Y' => Debug_Flag_YY := Val;
- when 'Z' => Debug_Flag_ZZ := Val;
- end case;
-
- else
- case LLet (C) is
- when 'a' => Debug_Flag_A := Val;
- when 'b' => Debug_Flag_B := Val;
- when 'c' => Debug_Flag_C := Val;
- when 'd' => Debug_Flag_D := Val;
- when 'e' => Debug_Flag_E := Val;
- when 'f' => Debug_Flag_F := Val;
- when 'g' => Debug_Flag_G := Val;
- when 'h' => Debug_Flag_H := Val;
- when 'i' => Debug_Flag_I := Val;
- when 'j' => Debug_Flag_J := Val;
- when 'k' => Debug_Flag_K := Val;
- when 'l' => Debug_Flag_L := Val;
- when 'm' => Debug_Flag_M := Val;
- when 'n' => Debug_Flag_N := Val;
- when 'o' => Debug_Flag_O := Val;
- when 'p' => Debug_Flag_P := Val;
- when 'q' => Debug_Flag_Q := Val;
- when 'r' => Debug_Flag_R := Val;
- when 's' => Debug_Flag_S := Val;
- when 't' => Debug_Flag_T := Val;
- when 'u' => Debug_Flag_U := Val;
- when 'v' => Debug_Flag_V := Val;
- when 'w' => Debug_Flag_W := Val;
- when 'x' => Debug_Flag_X := Val;
- when 'y' => Debug_Flag_Y := Val;
- when 'z' => Debug_Flag_Z := Val;
- end case;
- end if;
- end Set_Debug_Flag;
-
-end Debug;
projects / msp430-gcc.git / blobdiff